Shopify商品视频媒体审计

场景与前置条件

用于 Shopify 商品页视频上线前的本地媒体清单审计。需要 Python 3.9+ 和脱敏的产品/媒体元数据；不需要 Shopify 登录、API 或网络。

输入与输出

输入 JSON：产品句柄、SKU、媒体类型、视频文件信息、海报图、字幕/音频、场景标签和展示位置。输出 media_audit.json，逐条列出 pass、review、block、缺失字段和稳定 audit hash。

安装与导入

将本目录导入智能体环境；运行 python scripts/audit_product_video.py --input examples/input.json --output media_audit.json。

执行步骤

1. 1. 读取产品与视频媒体登记，确认产品句柄、SKU 和媒体类型。
2. 检查视频文件、海报图、字幕/音频和首帧信息是否齐全。
3. 检查视频展示位置与商品场景是否一致，输出可进入第二步的审计 JSON。

错误恢复

输入不是 JSON、缺少 product 或 media 对象时返回非零退出码并指出字段；修复媒体登记后重跑。不会修改视频或 Shopify 数据。

权限与隐私边界

只处理脱敏文件名、媒体参数、字幕和场景标签，不上传视频、不登录 Shopify、不改主题、不修改产品。买家需自行确认媒体授权和页面展示效果。

验收

示例运行应输出至少 9 项 findings，并对没有海报图、缺少字幕语言、媒体 SKU 不匹配或文件过大给出 review 或 block。