Shopify商品视频媒体交接预检

场景与前置条件

用于 Shopify 商品媒体上传和主题显示前的人工交接复核。需要第1步角度矩阵、脱敏媒体候选和商品 SKU；不需要 Shopify 登录、API 或网络。

输入与输出

输入为上游 shopify_video_angles.json 与 media_candidates 数组，包含文件格式、公开访问、商品 SKU、缩略图、alt text、主题支持和敏感信息排除登记。输出 JSON 与 Markdown 复核表，包含逐媒体 findings、人工责任和 publish_ready=false。

安装或导入

先运行第1步并取得角度矩阵，再运行 python scripts/audit_shopify_media.py --angles ../shopify-video-angle-matrix/shopify_video_angles.json --input examples/input.json --output shopify_media_pack.json --markdown shopify_media_pack.md。

执行步骤

1. 1. 读取创意角度矩阵和脱敏媒体登记。
2. 核对 MP4/MOV 或平台允许的外部视频登记、公开访问责任、SKU 一致性、缩略图、约 125 字符以内的 alt text、主题支持和敏感信息排除。
3. 输出媒体交接包；运营人员在 Shopify 后台人工预览后再上传或关联，结果不会自动改变店铺。

错误恢复

角度文件不存在、JSON 无效或没有媒体候选时返回非零退出码；补齐脱敏登记后重跑。缺少公开访问、SKU、缩略图、alt text 或主题支持时进入 review。

权限与隐私边界

只处理买家提供的媒体元数据和创意引用，不读取 Shopify 账号、客户信息、订单或私密文件，不调用上传接口。买家负责确认文件可公开访问、版权授权、商品事实、主题兼容性和页面展示。

验收

示例运行应输出每个媒体候选的 findings、责任人和 publish_ready=false；敏感文件、SKU 不一致或缺少人工预览时不得输出可发布状态。