Etsy 商品视频计划生成

适用场景

当 Etsy 商品已有预览图或商品照片，但剪辑人员需要明确视频槽位、展示目的、图片顺序和时长时使用。

输入与输出

• - 输入：脱敏 listing 标识、一个或两个视频用途、图片文件标签、可选尺寸和每条视频的总时长。
• 输出：etsy_listing_video_plan.json，包含稳定排序的时间轴、静音标记、Etsy 约束和 publish_ready=false。

执行

运行 python scripts/build_plan.py examples/input.json --output etsy_listing_video_plan.json。输入图片按文件名排序；总时长必须在 3 到 15 秒之间，视频槽位最多 2 个。

安装与恢复

只需 Python 3.9+ 标准库。输入格式错误时修正 JSON 后重跑；输出文件可安全覆盖，因为脚本不修改输入图片。

权限与隐私

脚本只读取 JSON 元数据，不读取图片内容、不登录 Etsy、不上传、不编辑商品，也不处理客户数据。买家应确认素材拥有或获得使用授权。

验收

使用示例运行后检查输出含 2 个视频槽位、每个槽位含 audio=false、时间轴首尾覆盖总时长，并且 publish_ready 固定为 false。