btcson66-rgb/ecommerce-video-pipeline-skill

精品短影音自动化制片标准作业流程 (SOP) — 多品牌通用旗舰版

⚠️ 【铁律：绝对禁止偷懒与拼凑】

1. 每部成片必须且只能由 3 段截然不同的真实 AI 视频组成：
   • S1（Gemini App）：生活实穿动态（欧风街拍、商务走廊、网球场漫步）。
   • S2（Gemini / Flow）：精品休憩置放与平滑推镜特写（咖啡座木桌、场边长椅）。
   • S3（Google Flow 3D 转盘）：360° 旋转展示特写（最短 5 秒省点数 + Asset Chips 真品标签）。
2. 严禁纯静态图片运镜（Ken Burns / Zoompan）冒充主片！
3. 严禁只做 1 段或 2 段就草率结案，S3 转盘特写镜头绝不可缺席！

---

一、标准 3 段式镜头分工与纯广告规范

1. 标准 3 段式镜头分工架构（S1 + S2 + S3）

• S1（Gemini App 实穿动态，8 秒 9:16）：
  • 包款：都会街头漫步、商务走廊步入，展示肩背/手提自然摆动（只拍外观穿搭，绝不拍零钱包内部掀盖或拉链微距结构）。
  • 运动墨镜：阳光网球场、运动赛道漫步与单手扶镜特写。
  • 复古墨镜：海滨棕榈大道漫步、阳光街头穿搭。
• S2（Gemini / Flow 特写推轨，5～8 秒 9:16）：
  • 包款：露天咖啡座木桌置放，阳光洒落皮革纹理与五金细节。
  • 墨镜：精品露天咖啡座木桌搭配冰咖啡，平滑推镜特写手工金属镜框与 G-15 镜片；或场边长椅搭配球拍特写。
• S3（Google Flow 3D 转盘旋转，5 秒 9:16 最短秒数省点数）：
  • 在展示台上 360° 旋转展示，搭配多色切换介绍或单色完整环绕。

2. 纯商品官方广告模式（预设「去虾皮化」Pure Brand Commercial）

• 除非使用者特别要求标注虾皮，否则一律采用纯品牌官方形象广告模式。
• 顶部胶囊、底部字幕卡、导购 CTA 按钮、旁白配音与 caption.txt 严禁出现任何「虾皮」字样，统一标注「官方旗舰限定 / 现货」、「点击下方探索 / 选购」。

---

二、Step 1：真品图片抓取、AI 友善预处理与双重验证

1. 抓取高画质真品原图与核对特征：
   • 记录真实品牌（FANTINI、ESPNER 等）、型号、价格、现货色系与细节特征。
2. 预先整理 AI 友善识别参考图（Pre-processing Reference Image）：
   • 使用 scripts/preprocess_ai_ref.py 将商品主图去除促销文字边框，置中并输出为干净纯背景的 1024×1024 RGB 图像（*_gemini_studio.jpg 或 *_gemini_hero.jpg），防止 AI 辨识尺寸失真。
3. 双重验证（防错配 + 防黑屏）：
   • 必须使用 read_file 亲眼检视参考图，确认 100% 吻合真实商品。
   • 执行 scripts/validate_assets.py 确认图片为 RGB 模式（严禁直接使用 RGBA 透明去背图）。

---

三、Step 2：Gemini (Veo) 与 Google Flow (Omni 1.1 Flash) 双引擎生成规范

1. 防范 Gemini 多轮对话缓存污染（Session Isolation 铁律）

• 更换商品时，在 Gemini App 必须开启全新对话（New Chat），防止后端缓存误用前一款商品的图片。
• 视频下载后，必须立即使用 ffmpeg 抽取影格并以 read_file 亲眼查验。若款式被旧对话污染或细节不符，立即改用 Google Flow 重新生成。

2. Google Flow 最短秒数省点数 + Asset Chips 精准控制

• S3 片尾 3D 转盘 360° 旋转展示（必用 Google Flow）：
  • 上传真品图后，必须在输入框下方点击「在提示词输入框新增素材」，勾选真品图插入为条件标签（Asset Chips）。
  • 设定最短秒数（5 秒） 以节省点数消耗，后期通过 FFmpeg setpts 平滑慢动作延展至配音所需长度。
• Gemini 额度用尽或需精准特写时无缝接力：
  • 若 Gemini 达每轮 3 部上限（冷却 5 小时），S1 / S2 直接由 Google Flow 接力生成，无须空等。

---

四、Step 3：沉稳男声配音与 FFmpeg「零截断、零定格」双版本压制

标准自动化压制脚本：scripts/render_video_template.py

1. 配音标准（语音零截断）：
   • 统一使用 edge-tts 正式沉稳台湾男声：zh-TW-YunJheNeural（rate="-1%", pitch="-2Hz"）。
   • 完全解除 24 秒硬性限制：段落长度由完整句长动态决定（target_dur = audio_dur + 0.8s，含 adelay=350|350 与句尾呼吸留白），严禁使用 atrim 截断配音。
2. 画面平滑延伸（绝不定格 Zero Freeze Frame）：
   • 严禁使用 tpad=stop_mode=clone 尾帧定格！
   • 当原始视频秒数（如 5s 或 8s）短于段落目标秒数时，一律采用 setpts=(seg_dur/v_dur)*PTS 平滑动态慢动作延伸，或搭配平滑推镜放大，确保镜头全程动态运镜。
   • 强制输出规格：1080x1920、-r 30（30.0 fps CFR 恒定帧率）、libx264、yuv420p。
3. 双版本同步产出（多色版 + 单色 360° 旋转版）：
   • final.mp4：S1 + S2 + S3（多色款式切换图卡）。
   • final_single_color.mp4：S1 + S2 + S3（单一主打色 360° 旋转展示图卡）。
4. 成片视觉抽检：
   • 抽取 final_check_s1.jpg、final_check_s2.jpg、final_check_s3.jpg，使用 read_file 亲眼查验。

---

五、Step 4：Google Drive 云端硬盘 7 件组白名单交付

1. 标准 7 件组清单：
   • final.mp4（多色介绍版）
   • final_single_color.mp4（单色 360° 旋转版）
   • cover.jpg（1080×1920 高质感封面）
   • caption.txt（官方社群文案与 Hashtags，去虾皮化）
   • title.txt（SEO 标题）
   • product_url.txt（商品网址）
   • qa.json（品质检验通过纪录）
2. 白名单上传流程：
   • 复制 7 个文件至 C:\Users\User\AppData\Local\Temp\<Product_ID>\。
   • 于 Google Drive 02_手机待发布 建立子文件夹（<编号>_<品牌>_<商品简称>）并完成上传。