@optima-chat/optima-agent 0.9.3 → 0.9.5

package/.claude/skills/video-gen/templates/multi-point-apparel.md

@@ -0,0 +1,185 @@
+---
+name: multi-point-apparel
+type: multi-point
+category: apparel
+duration_sweet_spot: 20-30s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: 多卖点快剪型（服装 / 配饰）
+
+> **第一性原理**：本模板每个字段对应一个具体的失败模式。
+> **适合**：连衣裙 / 外套 / 运动鞋 / 包袋 / 帽子，客单价 ¥100–800
+> **高风险镜头**：#3 #5 #7（三个卖点特写）· #9（CTA）
+
+---
+
+# A · 项目卡
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{product_type}`（连衣裙/T 恤/鞋/包）| | 拍摄视角选错 |
+| `{price}` / `{original_price}` | | CTA 写不出 |
+| `{three_points}`（3 个卖点短语） | | 骨架无法展开 |
+| `{target_user}`（通勤女性/大学生/潮酷）| | Hook 调性错 |
+| `{model_demographics}` | | 人物选型错（肤色/身型）|
+| `{season}`（春/夏/秋/冬） | | 环境光和搭配错 |
+
+---
+
+# B · 五段骨架（Hook-P1-P2-P3-CTA）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| HOOK | 0-3s | 产品亮相 + 数字承诺（"3 个理由收藏"）|
+| POINT 1 | 3-10s | 卖点 1：如 "面料透气" → 画面动作（拉扯/透光展示）|
+| POINT 2 | 10-17s | 卖点 2：如 "一衣三穿" → 多穿搭快切 |
+| POINT 3 | 17-24s | 卖点 3（**最强**）：如 "显瘦 10 斤" → CU + 全身对比 |
+| CTA | 24-30s | 限时 + 尺码提示 + 购物车指示 |
+
+**服装类铁律**：三个卖点**必须递进**（不能三个都是颜色 / 都是材质），POINT 3 放最强。
+
+---
+
+# C · 镜头表（11 镜 · 30s · ASL ~2.7s）
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-2s | `{model_hero}` 模特身着产品正面全景 | `{hook_line}`（"3 个理由") | 缓推 + 自然光 | **★ full** | **`refs/product_front.jpg`** | **no color distortion, no texture loss** |
+| 2 | 2-3s | 全屏大字 "1." | 1 | — | — | — | — |
+| **3** | **3-7s** | **`{point_1_visual}`** 卖点 1 可视化 | `{point_1_label}` | **CU 或 MS** | **★ same** | **`refs/point_1_detail.jpg`** | **no fabric error** |
+| 4 | 7-10s | `{point_1_benefit}` 效果 / 对比 | "{benefit_word}" | 跟手 / 对比 | — | — | — |
+| 5 | 10-11s | 全屏大字 "2." | 2 | — | — | — | — |
+| **6** | **11-16s** | **`{point_2_visual}`** 卖点 2 | `{point_2_label}` | **多机位快切** | **★ same** | `refs/point_2_detail.jpg` | **no color flip between angles** |
+| 7 | 16-17s | 全屏大字 "3." | 3 | — | — | — | — |
+| **8** | **17-23s** | **`{point_3_visual}`** 卖点 3（最强）| `{point_3_label}` | **CU + 慢镜** | **★ same** | `refs/point_3_detail.jpg` | **no body distortion, no proportion issue** |
+| 9 | 23-26s | `{model_full_walk}` 全身走秀 | `{season_label}` | 跟拍 + 侧光 | **★ same** | `refs/product_walk.jpg` | no stiff posture |
+| **10** | **26-29s** | **`{product_flat_lay}` + 价格 + 尺码表 + 购物车** | `{cta_line}` | **静止 + 叠加** | **★ hero** | **`refs/product_flat.jpg`** | **no burned subtitle** |
+| 11 | 29-30s | 品牌 logo + "{brand_line}" | `{brand_tagline}` | 静止 | — | `refs/logo.jpg` | — |
+
+---
+
+# D · PRODUCT_LOCK 规范
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - color_palette: "{e.g. 雾霾蓝 with 米白拼接}"
+    - fabric_texture: "{e.g. 细纹涤纶 / 磨毛棉 / 光泽缎面}"
+    - silhouette: "{e.g. A 字裙 · 过膝长度 · 收腰}"
+    - detail_elements: "{e.g. 纽扣材质 / 拉链位置 / logo 绣花}"
+    - brand_label: "{位置 + 字体}"
+  consistency_method:
+    primary: "same seed across all product shots #1/#3/#6/#8/#9/#10"
+    backup: "image-to-video chain #3 → #4 (卖点 1 的前后)"
+    reference_image: "refs/product_front.jpg + 细节 ×3"
+```
+
+---
+
+# E · 参考图清单
+
+| 文件 | 用途 | 必须 |
+|---|---|---|
+| `refs/product_front.jpg` | 产品正面模特照 | ✅ |
+| `refs/point_1_detail.jpg` | 卖点 1 细节特写 | ✅ |
+| `refs/point_2_detail.jpg` | 卖点 2 细节特写 | ✅ |
+| `refs/point_3_detail.jpg` | 卖点 3 细节特写 | ✅ |
+| `refs/product_flat.jpg` | 产品平铺图（用于 CTA）| ✅ |
+| `refs/product_walk.jpg` | 动态走秀参考 | ⚠️ 推荐 |
+| `refs/logo.jpg` | 品牌标志 | ⚠️ 推荐 |
+
+**服装类铁律**：**每个卖点必须有独立参考图**，否则 AI 生成时会"把三个卖点融成一个模糊画面"。
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "9:16"
+total_duration: 30
+pacing: fast
+asl: 2.7
+bgm:
+  douyin: "商家原声讲解（亲切）"
+  tiktok: "fashion electronic / original sound"
+  xhs: "轻快爵士 / 氛围感"
+hook_template: "{season} 必收！{product_type} 3 个理由"
+cta_template: "{price} · 运费险 · {size_range}"
+```
+
+---
+
+# G · 平台 Delta
+
+| | 抖音小店 | TikTok Shop | 小红书 |
+|---|---|---|---|
+| 字幕 | 中文 + 尺码信息 | 英文大写 + sizing | 中文 + 穿搭场景 |
+| 时长 | 30s | 25s（砍 #4 或 #9） | 35s（加 OOTD 场景） |
+| 模特 | 亚洲人 | 多元化 | 生活感博主 |
+| BGM | 商家原声 | fashion beat | 氛围轻音乐 |
+| CTA 话术 | "小黄车 · 不合适包退" | "$XX · free returns" | "评论区穿搭链接" |
+| Hashtag | `#春日穿搭 #显瘦连衣裙` | `#ootd #fashionhaul #styletips` | `#穿搭 #显瘦 #通勤` |
+| 封面帧 | #1 模特正面 | #8 卖点 3 特写 | #9 全身走秀 |
+
+---
+
+# H · 失败模式 Checklist
+
+## H.1 生成前
+
+- [ ] 三个卖点**互不重叠**（不能都是"颜色 / 面料 / 舒适"这种相似维度）
+- [ ] 每个卖点有独立 REF_IMG
+- [ ] `PRODUCT_LOCK.brand_label` 包含品牌文字**完整描述**（服装标签易乱码）
+- [ ] NEGATIVE 含 `no body distortion, no proportion issue`（服装类身型扭曲是高发点）
+
+## H.2 导出前
+
+- [ ] 产品在 #1/#3/#6/#8/#9/#10 外观一致（颜色 · 纹理 · 剪裁）
+- [ ] 模特**身型比例正常**（AI 易生成过长腿 / 扭曲肢体）
+- [ ] 每个卖点字幕是否**真实可查**（"100% 纯棉" 要能兑现）
+- [ ] #9 走秀姿势自然（不是僵硬机器人步）
+
+## H.3 发布前
+
+- [ ] 静音能看懂 3 个卖点（字幕编号 1 2 3 清晰）？
+- [ ] 2× 播放能跟上？
+- [ ] 卖点承诺合规（不说"瘦身""减肥"等医疗词）？
+- [ ] 尺码信息完整（否则退货率高）？
+
+---
+
+# I · 成本预估
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: "模特 + 细节图多"
+  human_review: "30 min"
+  editing_subtitle: "1.5 hours（大字幕 1-2-3 制作）"
+  per_platform_delta: "20 min × 3 = 1 hour"
+  total: "$7.7 + 3 hours"
+
+breakeven_math:
+  margin_typical: "50-70%（服装高毛利）"
+  conversion_rate: "1.5-3%（服装冲动消费高）"
+  realistic_range_per_platform: "30K-200K views"
+  typical_return_rate: "15-30%（服装退货高，必须算进 ROI）"
+```
+
+---
+
+# J · 复用边界
+
+**✅ 直接套用**：
+连衣裙 · T 恤 · 外套 · 运动鞋 · 休闲鞋 · 帽子 · 包袋 · 围巾 · 腰带
+
+**❌ 不适合**：
+- 配饰珠宝 → 多用 PDP 360 型
+- 内衣 / 泳装 → 需要特殊镜头规则
+- 高定 / 礼服 → KOL 试穿型更合适
+- 童装 → 需要亲子场景模板（未来版本）

package/.claude/skills/video-gen/templates/pain-solution-home.md

@@ -0,0 +1,184 @@
+---
+name: pain-solution-home
+type: pain-solution
+category: home
+duration_sweet_spot: 18-22s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: 痛点-解决型（家居 / 日用）
+
+> **第一性原理**：本模板的每个字段都是为了阻止一个具体的失败模式。没有装饰字段。
+> **适合**：家居 / 日用 / 清洁 / 收纳，客单价 ¥50–300
+> **高风险镜头**：#4（产品首次出现）· #9（商品 CTA）—— 字段密度最高
+
+---
+
+# A · 项目卡（**对抗"类型选错 / 决策基础不全"**）
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{product_category}` | | 判断不了是否属于本模板 |
+| `{price}` / `{original_price}` | | CTA 写不出 |
+| `{price_point}`（低/中/高客单）| | 客单 >¥300 应切 KOL 模板 |
+| `{target_user}` | | Hook 找不到切入语气 |
+| `{core_pain_noun}`（如"脏水"/"油污"）| | HOOK 模板无法填充 |
+
+---
+
+# B · 五段骨架（**对抗"电商结构不全，漏 PROOF 则转化崩"**）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| HOOK | 0-2s | 痛点反问的**一句话**（≤15 字）|
+| PAIN | 2-5s | 旧方案要暴露哪**两个**缺陷 |
+| SOLUTION | 5-12s | 核心动作名（如"一脚踩→自动拧"）|
+| PROOF | 12-18s | **拿什么证据**：销量数字 / 评论截图 / 对比图（必须指定）|
+| CTA | 18-22s | 紧迫感 + 位置指示（"左下角 ¥99 限时"）|
+
+---
+
+# C · 镜头表（**字段密度按风险不对称**）
+
+**低风险镜头**（#1-#3 痛点场景）只需要 4 列；
+**高风险镜头**（#4-#6 产品演示 · #9 CTA）增加 PRODUCT_LOCK + REFERENCE_IMG + NEGATIVE 三列。
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-2s | `{pain_CU}` 痛点 CU | `{hook_line}` | CU + 手持微抖 | — | `refs/pain_context.jpg`(可选) | no text overlay |
+| 2 | 2-3.5s | `{old_method_pain}` | "痛点关键词" | 跟手 | — | — | — |
+| 3 | 3.5-5s | `{pain_consequence}` | "三大问题" | 特写 | — | — | — |
+| **4** | **5-8s** | **`{product}` 出场 + 核心动作** | `{core_action}` | **CU + 静止** | **★ full** | **`refs/product.jpg`** | **no variations, no morphing** |
+| **5** | **8-11s** | **`{product_demo}` 效果** | "自动/一键" | **跟手** | **★ same as #4** | **`refs/product.jpg`** | **no color shift, no flip** |
+| **6** | **11-14s** | **全景 `{clean_result}`** | "省时 80%" | **中景** | **★ same** | — | **no warping** |
+| 7 | 14-17s | `{sales_screenshot}` | "热卖 {sales_number}" | 屏录 | — | `refs/sales_page.png` | no fake data, no blur |
+| 8 | 17-19s | `{reviews_rollup}` | "4.9 分好评" | 屏录 | — | `refs/reviews.png` | no text distortion |
+| **9** | **19-22s** | **`{product_CU}` + 价格 + 购物车箭头** | `{cta_line}` | **CU + 轻推** | **★ hero shot** | **`refs/product.jpg`** | **no burned-in subtitle, no extra arrows** |
+
+---
+
+# D · PRODUCT_LOCK 规范（**对抗"AI 生成时产品每段都变形"**）
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - color_palette: "{e.g. matte white + silver accents + blue ring}"
+    - material_finish: "{e.g. ABS plastic + brushed aluminum}"
+    - logo_position: "{e.g. top front, 5mm height}"
+    - silhouette: "{e.g. cylindrical head + 30cm pole + pedal base}"
+  consistency_method:
+    primary: "same seed across shots #4/#5/#6/#9"
+    backup: "image-to-video chain #4 → #5 → #6 (use last frame as next input)"
+    reference_image: "refs/product.jpg (800x800 white background, 3+ angles)"
+```
+
+---
+
+# E · 参考图清单（**对抗"缺视觉锚点 / 照着空气生成"**）
+
+| 文件 | 用途 | 必须有 |
+|---|---|---|
+| `refs/product.jpg` | 产品主图（白底 · ≥800x800） | ✅ |
+| `refs/product_detail.jpg` | 细节特写（logo / 材质） | ✅ |
+| `refs/pain_context.jpg` | 痛点场景参考（可选，增强 #1-#3 真实感） | ⚠️ 推荐 |
+| `refs/sales_page.png` | 销量截图（用于 #7） | ✅ |
+| `refs/reviews.png` | 评论滚动截图（用于 #8） | ✅ |
+
+**缺任何一张 ✅ 标的 → storyboard 未完成，不能进生成**。
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "9:16"
+total_duration: 22
+pacing: moderate-fast
+asl: 2.4  # 平均镜头长度（秒）
+bgm:
+  douyin: "商家原声讲解"
+  tiktok: "original sound"
+  xhs: "轻音乐 + ASMR"
+hook_template: "你家的 {core_pain_noun} 还是这样吗？"
+cta_template: "左下角 {price}（原价 {original_price}）限时"
+```
+
+---
+
+# G · 平台 Delta（**对抗"一版三投，数据必有两个差"**）
+
+| | 抖音小店 | TikTok Shop | 小红书 |
+|---|---|---|---|
+| 字幕 | 中文 | 英文大写 + 🤯 | 中文 + 表情 |
+| 时长 | 22s（master）| 17s（砍 #2 #6）| 28s（加场景化前置）|
+| BGM | 商家原声 | original sound | 轻音乐 + ASMR |
+| CTA 话术 | "左下角小黄车" | "Yellow basket 👇" | "评论区拿链接" |
+| Hashtag | `#家居好物 #懒人神器` | `#tiktokmademebuyit #cleantok` | `#家居种草 #懒人必备` |
+| 封面帧 | #4 动作感 | #5 前后对比 | #6 治愈感 |
+
+---
+
+# H · 失败模式 Checklist（**发布前必过**）
+
+## H.1 生成前（**对抗"生成就翻车"**）
+
+- [ ] `refs/product.jpg` 存在且清晰度 ≥ 1080×1080
+- [ ] `PRODUCT_LOCK` 的 4 项 must_specify 全部填写
+- [ ] 镜头 #4 #5 #6 #9 使用同一个 seed 和同一张 reference
+- [ ] `NEGATIVE` 字段包含 5 要素（no distorted hands / no text / no variations / no morphing / no watermark）
+
+## H.2 导出前（**对抗"生成完了才发现错"**）
+
+- [ ] 产品在 #4/#5/#6/#9 四个镜头里外观一致（目检）
+- [ ] 没有手指畸形 / 产品文字被 AI 错误生成
+- [ ] 字幕是后期叠加，不是被生成到画面里
+- [ ] 9 个镜头拼接后总时长 = 22s ± 0.5s
+- [ ] BGM 节拍对齐 Shot #4 的动作点
+
+## H.3 发布前（**对抗"发了没人看"**）
+
+- [ ] 静音测试：关声音能看懂卖点？
+- [ ] 2× 播放能跟上节奏？
+- [ ] Scroll Stop：朋友看首 3 秒会划走吗？
+- [ ] 价格 / 库存 / CTA 信息当下有效？
+- [ ] 各平台 Delta 已按 G 表改完？
+
+**三段 checklist 全过才发。**
+
+---
+
+# I · 成本预估（**对抗"商家盲投"**）
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: ""
+  human_review: "30 min"
+  editing_subtitle_bgm: "1 hour"
+  per_platform_delta: "15 min × 3 = 45 min"
+  total: "$4.5 + 2.5 hours"
+
+breakeven_math:
+  if_product_margin: "{margin}"
+  conversion_rate_assumption: "2%"
+  views_to_breakeven: "total_cost / (price × margin × conversion_rate)"
+  realistic_range_per_platform: "10K-100K views (based on 15-item viral sample)"
+```
+
+---
+
+# J · 复用边界（**对抗"模板套错产品"**）
+
+**✅ 直接套用**（仅改 `{product}` / `{pain}` / `{sales}` 字段）：
+洗衣球 · 洗鞋机 · 油烟净 · 厨房收纳 · 切菜神器 · 马桶刷 · 地板清洁剂
+
+**❌ 不适合**（切换到其他模板）：
+- 美妆 → `before-after-beauty.md`
+- 数码 / 3C → `scene-digital.md`
+- 服装 → `multi-point-apparel.md`
+- 食品 → `kol-reaction-food.md`
+- 客单价 ≥¥500 → KOL 信任型模板

package/.claude/skills/video-gen/templates/pdp-360-showcase.md

@@ -1,17 +1,189 @@
-# Template: PDP 360 度展示
-
-适合：产品详情页主视频，强调产品外观
-
-## 镜头表
-| 段 | 时长 | 内容 | 运镜 |
-|---|---|---|---|
-| 1 | 0-5s | {product} 正面 → 缓慢旋转一圈 | 环绕 |
-| 2 | 5-10s | {product} 细节特写（材质/按钮/接口）| 推近 |
-| 3 | 10-{duration}s | {product} 全景 + 尺寸参照 | 拉远 |
-
-## 默认值
-- Hook: 干净的产品正面
-- CTA: 产品名（无侵入式 CTA）
-- Pacing: slow, steady
-- Duration: 15-25s
-- Aspect: 1:1 或 16:9
+---
+name: pdp-360-showcase
+type: pdp-360
+category: product-detail-page
+duration_sweet_spot: 15-25s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: 产品 360 度展示（PDP / 详情页）
+
+> **第一性原理**：本模板每个字段对应一个具体的失败模式。
+> **适合**：详情页主视频 · 重视觉外观的产品（家居 / 数码 / 服装 / 配饰 / 玩具）
+> **高风险镜头**：#2（旋转中的产品一致性）· #4-#6（细节特写）
+> **核心挑战**：旋转过程中产品**每一帧都必须是同一件产品**
+
+---
+
+# A · 项目卡
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{aspect_ratio}`（1:1 / 16:9 / 9:16）| | PDP 默认 1:1 或 16:9，与社媒不同 |
+| `{rotation_direction}`（顺 / 逆）| | 旋转方向必须前后一致 |
+| `{detail_highlights}`（3 个细节）| | #4 #5 #6 拍什么空 |
+| `{size_reference}`（手 / 硬币 / 尺）| | 用户无法判断大小 |
+| `{brand_line}` | | 片尾无 branding |
+
+---
+
+# B · 五段骨架（PDP 专用 · 非电商 5 段）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| ESTABLISH | 0-3s | 产品干净全景（白底）|
+| ROTATE | 3-10s | 360° 旋转（5-7 秒完成一圈）|
+| DETAILS | 10-17s | 3 个关键细节 CU |
+| SCALE | 17-20s | 尺寸参照（vs 手 / 硬币）|
+| CLOSE | 20-22s | 品牌 + logo 定格 |
+
+**PDP 铁律**：不加 CTA / 不加价格 / 不加 hashtag —— PDP 视频是"产品档案"，不是广告。
+
+---
+
+# C · 镜头表（9 镜 · 22s · ASL ~2.4s）
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-3s | `{product_front}` 产品正面静止 | `{product_name}` | 静止 + 干净白底 | **★ full** | **`refs/product_front.jpg`** | **no background clutter, no shadows** |
+| **2** | **3-10s** | **`{product_rotate_360}` 360° 环绕** | — | **环绕 + 匀速** | **★ continuous lock** | **`refs/product_front.jpg` + side + back** | **no color shift mid-rotation, no model swap** |
+| 3 | 10-12s | `{product_top_view}` 俯视 | — | 俯拍 | **★ same** | `refs/product_top.jpg` | no perspective distortion |
+| **4** | **12-14s** | **`{detail_1_CU}` 细节 1** | `{detail_1_label}`（材质 / 按钮 / 接口）| **微距 + 静止** | **★ same** | **`refs/detail_1.jpg`** | **no material fakery** |
+| 5 | 14-16s | `{detail_2_CU}` 细节 2 | `{detail_2_label}` | 微距 | **★ same** | `refs/detail_2.jpg` | — |
+| 6 | 16-17s | `{detail_3_CU}` 细节 3 | `{detail_3_label}` | 微距 | **★ same** | `refs/detail_3.jpg` | — |
+| **7** | **17-20s** | **`{size_reference}` 尺寸对比** | `{size_label}`（"长 15cm"）| **MS + 手持** | **★ same** | **`refs/size_compare.jpg`** | **no unnatural scale** |
+| 8 | 20-21s | `{product_full_clean}` 回到干净全景 | — | 拉远 | **★ same** | `refs/product_front.jpg` | — |
+| 9 | 21-22s | 品牌 logo + 留白 | `{brand_line}` | 静止 | — | `refs/logo.jpg` | — |
+
+---
+
+# D · PRODUCT_LOCK 规范（**PDP 最严**）
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - exact_dimensions: "{长 × 宽 × 高 + 重量}"
+    - exact_colors: "{Pantone / RGB / hex 具体值}"
+    - material_finish: "{哑光 / 光泽 / 磨砂 + 具体材料名}"
+    - every_visible_detail: "{logo 位置 + 字体 + 接缝 + 按钮 + 接口}"
+    - manufacturing_marks: "{模具分型线 / 品牌铭牌}"
+  consistency_method:
+    primary: "旋转段必须用 image-to-video 链（非 text-to-video）"
+    backup: "每 0.5s 一帧的人工关键帧介入"
+    reference_image: "refs/product_front.jpg + side + back + top 共 4-6 张"
+  warning: "PDP 对产品一致性要求最严 —— 任何帧的变化都会被详情页用户放大看到。"
+```
+
+---
+
+# E · 参考图清单
+
+| 文件 | 用途 | 必须 |
+|---|---|---|
+| `refs/product_front.jpg` | 正面 | ✅ |
+| `refs/product_side.jpg` | 侧面 | ✅ |
+| `refs/product_back.jpg` | 背面 | ✅ |
+| `refs/product_top.jpg` | 俯视 | ✅ |
+| `refs/detail_1.jpg` | 细节 1（通常是 logo / 按钮 / 接口）| ✅ |
+| `refs/detail_2.jpg` | 细节 2 | ✅ |
+| `refs/detail_3.jpg` | 细节 3 | ⚠️ 推荐 |
+| `refs/size_compare.jpg` | 尺寸参照 | ✅ |
+| `refs/logo.jpg` | 品牌 logo | ⚠️ 推荐 |
+
+**PDP 铁律**：**至少 4 张产品角度图 + 3 张细节图 = 7 张参考**，否则 AI 360 旋转会"编造"不存在的角度。
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "1:1"  # PDP 默认方形；若视频详情页用 16:9
+total_duration: 22
+pacing: slow(匀速，不追求戏剧节奏)
+asl: 2.4
+bgm:
+  pdp: "无（或极轻环境音）"  # PDP 视频通常静音播放
+  social_crossover: "轻音乐（若同时用作社媒）"
+# PDP 不需要 hook / CTA / hashtag 字段
+```
+
+---
+
+# G · 平台 Delta（PDP 特殊 · 不分社媒平台）
+
+| 用途 | 配置 |
+|---|---|
+| **淘宝 / 天猫详情页** | 1:1 或 16:9，静音播放兼容 |
+| **亚马逊 A+ 页面** | 16:9，无字幕（英文市场）|
+| **京东详情页** | 1:1，可加字幕 |
+| **独立站** | 16:9，含 CTA 按钮 overlay |
+| **跨境 Shopify** | 16:9 或 9:16（mobile-first）|
+| **作为社媒素材复用时** | 改 9:16 + 加字幕 + 加 CTA（实际上切到 scene-digital 模板）|
+
+---
+
+# H · 失败模式 Checklist
+
+## H.1 生成前
+
+- [ ] 至少 4 张产品角度图就位（正 / 侧 / 背 / 顶）
+- [ ] 每个角度图**光线一致**（否则 AI 旋转时会跳光）
+- [ ] `PRODUCT_LOCK.exact_dimensions` 精确到毫米（防 AI 随便缩放）
+- [ ] NEGATIVE 含 `no color shift, no material fakery, no manufacturing mark change`
+
+## H.2 导出前
+
+- [ ] 旋转段（#2）**每一帧都是同一件产品**（最严格检查点）
+- [ ] 细节 CU 的材质和主镜一致（#4/#5/#6 vs #1）
+- [ ] 尺寸参照合理（手大小 / 硬币尺寸对应真实）
+- [ ] 背景干净（白底无阴影无杂物）
+- [ ] **没有 CTA / 价格 / 紧迫感** 元素（PDP 铁律）
+
+## H.3 发布前
+
+- [ ] 静音播放时画面仍然信息充分？（PDP 常静音）
+- [ ] 旋转速度匀速不卡顿？
+- [ ] 比例符合目标详情页（1:1 vs 16:9 vs 9:16）？
+- [ ] 时长不超过 30s（PDP 用户耐心短）？
+
+---
+
+# I · 成本预估
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: "360 旋转 prompt 复杂度高"
+  human_review: "45 min（质检严格）"
+  editing: "1 hour（主要是拼接和调色匹配）"
+  total: "$7.2 + 2 hours"
+  note: "PDP 一次做好多年使用（产品不改则视频不改），ROI 极高"
+
+breakeven_math:
+  pdp_value_model: "提升详情页转化率（+2-5%）"
+  typical_uplift: "按店铺日单量 100 · 每单 ¥200 · 毛利 40% → 提升 2% 转化 = +¥160/日"
+  pdp_video_payback: "~50 天（按 $7.2 成本）"
+```
+
+---
+
+# J · 复用边界
+
+**✅ 直接套用**：
+任何需要展示产品外观的实物商品 —— 家居 · 数码 · 配饰 · 玩具 · 工具 · 厨具
+
+**❌ 不适合**：
+- 软性产品（护肤品 / 食品）→ 没"外观"可 360
+- 虚拟商品（软件 / 课程）→ 完全不适用
+- 高度标准化无差异产品（如纸巾 / 纯色 T 恤）→ PDP 360 没看点
+- 需要演示使用的产品 → `pdp-feature-highlight.md`
+
+---
+
+# 相关
+
+- 姊妹模板：`pdp-feature-highlight.md`（功能展示型 PDP）