@optima-chat/gen-cli 1.0.9 → 1.2.0

package/.claude/skills/video-gen/templates/INDEX.md

@@ -0,0 +1,78 @@
+---
+name: templates-index
+purpose: "路由表 · 在读任何模板前先读这份，决定选哪个"
+design_principle: "三问内定位到唯一模板；不能定位的走兜底"
+---
+
+# Templates Index
+
+> **用法**：Agent 在「形成 Storyboard」第 1 步读这份，决定下一步读哪一个具体模板文件。**不要先把 8 个模板全读一遍**——那会白烧 context 而且更容易选错。
+
+---
+
+## 三问路由
+
+### 问 1：放哪里投？
+
+| 投放目的 | 跳到 |
+|---|---|
+| 详情页 / PDP / 产品档案（不带 CTA）| **问 2a** |
+| 社媒（抖音 / TikTok / 小红书 / IG）| **问 2b** |
+| 两者都要 | 先按社媒选，发布时按 `G · 平台 delta` 裁切成 PDP 版本 |
+
+### 问 2a：PDP 重外观还是重卖点？
+
+| 产品特征 | 模板 | 时长 |
+|---|---|---|
+| 重外观 / 造型导向（家居 · 服装 · 配饰 · 玩具 · 礼盒） | `pdp-360-showcase.md` | 15-25s |
+| 重功能 / 参数导向（数码 · 小家电 · 工具 · 办公设备） | `pdp-feature-highlight.md` | 20-30s |
+
+### 问 2b：按产品品类选
+
+| 产品品类 | 模板 | 形态 | 客单带 | 时长 |
+|---|---|---|---|---|
+| 家居 / 日用 / 清洁 / 收纳 | `pain-solution-home.md` | 痛点-解决 | ¥50–300 | 18-22s |
+| 美妆 / 护肤 / 洗护 / 清洁工具 | `before-after-beauty.md` | 效果对比 | ¥80–500 | 20-25s |
+| 数码 / 3C / 智能硬件 | `scene-digital.md` | 场景化 | — | 25-35s |
+| 服装 / 鞋帽 / 配饰 | `multi-point-apparel.md` | 多卖点 | — | 20-30s |
+| 食品 / 饮料 / 零食（重口味体验）| `kol-reaction-food.md` | KOL 反应 | — | 30-45s |
+| 快消 / 咖啡 / 功能饮料 / 办公零食 | `drama-fmcg.md` | 剧情植入 | ¥20–100 | 25-35s |
+
+---
+
+## 疑难消歧（两个看似都能套时）
+
+| 冲突 | 选择规则 |
+|---|---|
+| 家居痛点类 vs 美妆效果类（如清洁美容工具） | 看"证据类型"：销量/评论驱动 → `pain-solution-home`；视觉前后对比 → `before-after-beauty` |
+| 数码场景 vs 家居痛点（如智能清洁机器人） | 看"核心卖点语言"：功能参数主导 → `scene-digital`；解决具体痛点主导 → `pain-solution-home` |
+| 食品 KOL 反应 vs FMCG 剧情（如新品咖啡） | 看"客单 × 使用频次"：¥20-100 高频日饮 → `drama-fmcg`；≥¥50 单次体验性 → `kol-reaction-food` |
+| 服装多卖点 vs PDP 功能 | 看"投放位置"：社媒 → `multi-point-apparel`；详情页 → `pdp-feature-highlight` |
+
+---
+
+## 兜底（现有 8 个模板都不合适时）
+
+先检查是否属于下列**已知不适合**的场景，再决定如何处理：
+
+| 场景 | 推荐做法 |
+|---|---|
+| 客单价 ≥ ¥500 的信任型购买（美容仪 · 高端数码 · 奢品） | 跳过模板，按 KOL 信任型自由 storyboard（长讲解 + 深度测评，现有模板都偏短 + 偏转化） |
+| 香水 / 酒类等**不可视化**品类 | 走 `kol-reaction-food` 的 KOL 反应骨架，但主镜头替换为品牌叙事 |
+| 工业 B2B / 服务类（非实物商品） | 现有模板均不适用，回到零构建 |
+| 品类在表里但形态诉求不符（如美妆做剧情植入） | 优先按品类选，再从 `drama-fmcg.md` 的 B 段骨架**借"剧情结构"** |
+| 多品类组合套装 | 选主品类模板 + 每镜 PRODUCT_LOCK 列出所有 SKU |
+
+**什么时候应该跳过模板**：
+- 复刻场景，源视频形态不在上表覆盖内（按 `analysis.md` 的结构自由构建）
+- 用户显式说"别用模板 / 按我这个参考做"
+- 迭代场景（`再试` / `改 X`），沿用旧 storyboard 即可，不用重新路由
+
+---
+
+## Agent 交互规则
+
+1. **展示选择结果**：选完模板，告诉用户一句话"我准备用 `<模板名>`（<形态描述>）给你做 storyboard，合适吗？"，用户否认才换。
+2. **不展示路由过程**：用户看不到 INDEX 推理过程，只看结论。
+3. **写入 history**：最终用的模板名写进 `history.md` 的 `template` 列，方便迭代时追溯。
+4. **模板冲突优先级**：用户明示 > 品类匹配 > 形态匹配 > 时长匹配。

package/.claude/skills/video-gen/templates/before-after-beauty.md

@@ -0,0 +1,183 @@
+---
+name: before-after-beauty
+type: before-after
+category: beauty
+duration_sweet_spot: 20-25s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: 效果对比型（美妆 / 护肤 / 清洁）
+
+> **第一性原理**：本模板每个字段对应一个具体的失败模式。
+> **适合**：美妆 / 护肤 / 洗护 / 家居清洁，客单价 ¥80–500
+> **高风险镜头**：#4（产品应用 CU）· #7（after 特写）· #9（CTA）
+
+---
+
+# A · 项目卡（**对抗"决策基础不全"**）
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{product_type}`（面膜/粉底/洁面/...) | | 影响镜头动作（涂抹/按压/清洁）|
+| `{effect_claim}`（"提亮两个度"）| | Hook 无承诺点 |
+| `{price}` / `{original_price}` | | CTA 写不出 |
+| `{target_skin}`（油皮/干皮/敏感）| | 受众不清，参考图用错 |
+| `{before_condition}`（暗黄/干燥/痘痘）| | #1 #2 拍不出可视化痛点 |
+| `{after_state}`（透亮/水润/净透）| | #6 #7 拍不出 reveal |
+
+---
+
+# B · 五段骨架（Before-Apply-After-Proof-CTA）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| BEFORE | 0-4s | 展示**哪种皮肤问题**？（暗黄/出油/细纹）|
+| APPLY | 4-10s | 展示**产品使用动作**（涂抹/按压/停留多久）|
+| AFTER | 10-15s | 以**什么机位**展示效果（同角度对比 / 时间流逝）|
+| PROOF | 15-20s | 拿什么证据：**成分 / 销量 / 评论 / KOL 背书**（四选一）|
+| CTA | 20-25s | 限时 + 赠品 + 位置指示 |
+
+**效果对比类铁律**：BEFORE 和 AFTER **必须同角度同光线**，否则"对比"失效。
+
+---
+
+# C · 镜头表（字段密度按风险不对称）
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-2s | `{before_CU}` 面部痛点特写 | `{pain_label}`（"暗黄"/"出油"） | CU 正脸 + 环形光 | — | `refs/before.jpg` | no skin distortion |
+| 2 | 2-4s | `{pain_multi_angle}` 多角度痛点 | 痛点词 ×3 | 侧脸 / 仰角 | — | — | — |
+| 3 | 4-6s | `{product}` 开瓶 / 挤出 | `{product_name}` | CU + 静止 | **★ full** | **`refs/product.jpg`** | **no label distortion, no color shift** |
+| **4** | **6-10s** | **`{apply_motion}`** 涂抹 / 按压 | `{apply_verb}`（"轻拍"/"按摩"）| **MS 跟手 + 45° 侧光** | **★ same** | **`refs/product.jpg`** | **no extra fingers, no smudge on product** |
+| 5 | 10-13s | `{time_lapse}` 变化过程 | "5 分钟后" | 定格 + 淡入淡出 | — | — | — |
+| **6** | **13-15s** | **`{after_CU}` 效果特写** | `{after_word}`（"透亮"/"水润"）| **CU 同机位对比** | — | **`refs/after.jpg`** | **no over-smoothed skin, no unrealistic glow** |
+| 7 | 15-17s | `{side_by_side}` 对比拼图 | "before / after" | 静止 | — | `refs/compare.jpg` | no mirror flip |
+| 8 | 17-20s | `{proof_evidence}` 成分/销量/评论 | "{proof_label}" | 屏录 | — | `refs/proof.png` | no fake data |
+| **9** | **20-25s** | **`{product_hero}` + 价格 + 购物车箭头** | `{cta_line}` | **CU + 轻推** | **★ hero** | **`refs/product.jpg`** | **no burned-in subtitle** |
+
+---
+
+# D · PRODUCT_LOCK 规范
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - bottle_shape: "{e.g. pump / dropper / squeeze tube}"
+    - color_palette: "{e.g. nude pink + white + gold accent}"
+    - label_text: "{e.g. 中文品牌 + 英文 product line + 容量}"
+    - cap_style: "{e.g. screw-top / flip-top / pump head}"
+  consistency_method:
+    primary: "same seed across #3/#4/#9"
+    backup: "image-to-video chain #3 → #4 (apply motion 续接)"
+    reference_image: "refs/product.jpg (≥1200x1200 白底 + 3 角度)"
+```
+
+---
+
+# E · 参考图清单
+
+| 文件 | 用途 | 必须 |
+|---|---|---|
+| `refs/product.jpg` | 产品主图（白底 · ≥1200x1200）| ✅ |
+| `refs/before.jpg` | before 皮肤状态参考 | ✅ |
+| `refs/after.jpg` | after 效果参考（同角度同光线）| ✅ |
+| `refs/compare.jpg` | 对比拼图参考 | ⚠️ 推荐 |
+| `refs/proof.png` | 成分 / 销量 / 评论截图 | ✅ |
+
+**对比类铁律**：`refs/before.jpg` 和 `refs/after.jpg` **必须同机位同光线**，否则 AI 生成时会出现角度不一致。
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "9:16"
+total_duration: 25
+pacing: slow-moderate
+asl: 2.8
+bgm:
+  douyin: "商家原声（轻柔）"
+  tiktok: "original sound / satisfying ASMR"
+  xhs: "治愈钢琴 / 纯音乐"
+hook_template: "{target_skin} 姐妹还在 {pain_noun} 吗？"
+cta_template: "{price}（原价 {original_price}）送 {gift}"
+```
+
+---
+
+# G · 平台 Delta
+
+| | 抖音小店 | TikTok Shop | 小红书 |
+|---|---|---|---|
+| 字幕 | 中文 | 英文 + "GLOW UP ✨" | 中文 + 表情 + 成分党术语 |
+| 时长 | 25s（master）| 22s | 30s（加前置"成分解读"）|
+| BGM | 商家原声 | original sound (ASMR) | 纯音乐 |
+| CTA 话术 | "小黄车 送同品牌面膜" | "Linked in bio ✨" | "评论区扣 1 发链接" |
+| Hashtag | `#美妆护肤 #护肤心得` | `#skincaretiktok #glowup #beforeafter` | `#护肤 #成分党 #抗老` |
+| 封面帧 | #6 after CU | #7 side-by-side 对比 | #4 涂抹动作 |
+
+---
+
+# H · 失败模式 Checklist
+
+## H.1 生成前
+
+- [ ] `refs/before.jpg` 和 `refs/after.jpg` **同机位同光线**
+- [ ] `refs/product.jpg` ≥ 1200x1200 且**标签文字清晰**
+- [ ] `PRODUCT_LOCK.label_text` 填写完整（AI 易生成乱码 label）
+- [ ] NEGATIVE 含 `no label distortion / no text garble`
+
+## H.2 导出前
+
+- [ ] 产品在 #3/#4/#9 外观一致（特别检查**瓶身标签**是否乱码）
+- [ ] BEFORE vs AFTER 是否同角度（对比类视频死穴）
+- [ ] 皮肤过度美化？（`no over-smoothed skin` 触发）
+- [ ] AFTER 特写里**没有产品**（产品只在应用段出现）
+
+## H.3 发布前
+
+- [ ] 静音能看懂"前后对比"逻辑？
+- [ ] 2× 播放节奏跟得上？
+- [ ] 效果承诺是否违反广告法（医美词 / 神奇 / 最好）？← **美妆额外红线**
+- [ ] 各平台 Delta 改完？
+
+---
+
+# I · 成本预估
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: "美妆特写 prompt 更复杂"
+  human_review: "45 min（广告法审查额外）"
+  editing: "1.5 hour"
+  per_platform_delta: "20 min × 3 = 1 hour"
+  total: "$5.4 + 3.5 hours"
+
+breakeven_math:
+  if_product_margin: "{margin} (美妆毛利通常 60-70%)"
+  conversion_rate_assumption: "1.5%"
+  realistic_range_per_platform: "20K-200K views (美妆赛道高)"
+```
+
+---
+
+# J · 复用边界
+
+**✅ 直接套用**：
+面膜 · 精华 · 粉底 · 眼霜 · 洗面奶 · 身体乳 · 清洁工具（如洁面仪）
+
+**❌ 不适合**：
+- 香水（不可视化 → 换 kol-reaction-food 类模板）
+- 美容仪 ≥¥500 → KOL 信任型
+- 家居清洁 → `pain-solution-home.md`（痛点驱动而非美学驱动）
+
+---
+
+# 相关
+
+- 美妆广告法红线参考：国标 GB/T 2716（不含医美宣称）

package/.claude/skills/video-gen/templates/drama-fmcg.md

@@ -0,0 +1,183 @@
+---
+name: drama-fmcg
+type: drama
+category: fmcg
+duration_sweet_spot: 25-35s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: 剧情植入型（快消 / 咖啡 / 饮料 / 办公零食）
+
+> **第一性原理**：本模板每个字段对应一个具体的失败模式。
+> **适合**：办公咖啡 / 功能饮料 / 便携零食 / 即饮茶 / 助眠食品，客单价 ¥20–100
+> **高风险镜头**：#5（产品植入瞬间）· #8（使用后转变）· #10（CTA）
+> **核心挑战**：产品不能生硬，必须"长在剧情里"
+
+---
+
+# A · 项目卡
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{product_use_moment}`（提神/解压/加餐）| | 剧情场景选不对 |
+| `{price}` | | CTA 写不出 |
+| `{story_protagonist}`（打工人/学生/宝妈）| | 剧情无主角 |
+| `{story_conflict}`（下午 3 点昏昏欲睡）| | Tension 段空 |
+| `{resolution_moment}`（喝一口精神百倍）| | Resolve 段空 |
+| `{brand_tone}`（治愈/逗趣/热血）| | 整体风格错乱 |
+
+---
+
+# B · 五段骨架（Setup-Tension-Product-Resolve-CTA）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| SETUP | 0-5s | 建立场景 + 主角（不露品）|
+| TENSION | 5-12s | 冲突升级（可视化痛点达到顶点）|
+| PRODUCT | 12-18s | 产品**自然出现**（不是硬广） |
+| RESOLVE | 18-28s | 使用后转变（情绪反转）|
+| CTA | 28-33s | 价格 + 同款购买引导 |
+
+**剧情类铁律**：产品必须**在故事的"功能性转折点"出现**，不是"突然硬塞"。
+
+---
+
+# C · 镜头表（12 镜 · 33s · ASL ~2.8s）
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-2s | `{scene_establish}` 场景定位 | `{time_label}`（"周一下午 3:00"）| 广角 + 自然光 | — | `refs/scene.jpg` | no stock-look |
+| 2 | 2-4s | `{protagonist_intro}` 主角出场 | `{protagonist_state}`（"已经 crash 了"）| MS + 自然 | — | — | no exaggerated acting |
+| 3 | 4-7s | `{struggling_closeup}` 挣扎细节（打哈欠/揉眼）| `{struggle_detail}` | CU | — | — | no fake gestures |
+| 4 | 7-12s | `{tension_peak}` 冲突顶点（眼看要误事）| `{tension_word}` | 节奏加快 + 紧张 BGM | — | — | no cliché over-drama |
+| **5** | **12-15s** | **`{product_entry}` 产品自然入镜** | — | **CU 产品 + 主角手伸向** | **★ full** | **`refs/product.jpg`** | **no jump cut, no obvious insertion** |
+| 6 | 15-18s | `{product_detail}` 产品近景 | `{product_name}` | 微推 | **★ same** | `refs/product.jpg` | — |
+| 7 | 18-22s | `{usage_moment}` 使用瞬间（喝/吃/打开）| `{usage_verb}` | CU + 音效 | **★ same** | — | no mouth distortion |
+| **8** | **22-26s** | **`{resolution_shift}`** 情绪反转 | `{resolve_word}`（"瞬间复活"）| **MS 表情特写** | — | **`refs/protagonist_happy.jpg`** | **no over-acted joy** |
+| 9 | 26-28s | `{story_continue}` 主角继续行动 | `{action_verb}` | 跟拍 | — | — | — |
+| **10** | **28-31s** | **`{product_CU}` + 价格 + 购物车标** | `{cta_line}` | **CU + 字幕** | **★ hero** | **`refs/product.jpg`** | **no burned subtitle** |
+| 11 | 31-32s | 品牌 slogan | `{brand_slogan}` | 静止 | — | `refs/logo.jpg` | — |
+| 12 | 32-33s | 留白 + 品牌色 | — | 静止 | — | — | — |
+
+---
+
+# D · PRODUCT_LOCK 规范
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - package_type: "{瓶 / 罐 / 袋 / 盒}"
+    - color_accent: "{产品主色}"
+    - logo_position: "{瓶身 / 盖 / 标签}"
+    - size_cue: "{手持对比比例}"
+  consistency_method:
+    primary: "same seed #5/#6/#7/#10"
+    backup: "产品镜头独立拍摄（真品+白底）再合成到剧情"
+    reference_image: "refs/product.jpg（≥1200x1200 白底 + 持握示意图）"
+```
+
+---
+
+# E · 参考图清单
+
+| 文件 | 用途 | 必须 |
+|---|---|---|
+| `refs/product.jpg` | 产品白底主图 | ✅ |
+| `refs/scene.jpg` | 剧情场景参考（办公室 / 咖啡厅 / 教室）| ✅ |
+| `refs/protagonist.jpg` | 主角人设（若用 AI 生成）| **仅 AI 生成时必须** |
+| `refs/protagonist_happy.jpg` | 主角反转后情绪 | ⚠️ 推荐 |
+| `refs/logo.jpg` | 品牌 logo | ⚠️ 推荐 |
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "9:16"
+total_duration: 33
+pacing: moderate(前慢后快)
+asl: 2.8
+bgm:
+  douyin: "商家原声 + 环境音"
+  tiktok: "cinematic / narrative BGM"
+  xhs: "治愈电影感"
+hook_template: "{story_protagonist} 的 {scene_label} 是不是这样..."
+cta_template: "{price} 同款 · {offer}"
+```
+
+---
+
+# G · 平台 Delta
+
+| | 抖音小店 | TikTok Shop | 小红书 |
+|---|---|---|---|
+| 字幕 | 中文剧情化 | 英文 + POV 句式 | 中文 + 情绪感叹 |
+| 时长 | 33s | 28s（砍 #4 或 #9）| 40s（加背景故事）|
+| 剧情调性 | 共鸣型（贴近打工人）| POV 高能 | 治愈系 |
+| BGM | 商家原声 | cinematic beat | 治愈 |
+| CTA 话术 | "看完还不买吗？左下角" | "POV: you found it 👇" | "评论区问同款" |
+| Hashtag | `#职场日常 #打工人自救` | `#POV #workdayvibes #lifehack` | `#治愈瞬间 #打工人日常 #种草` |
+| 封面帧 | #4 tension 顶点 | #8 反转瞬间 | #9 故事延续 |
+
+---
+
+# H · 失败模式 Checklist
+
+## H.1 生成前
+
+- [ ] 剧情**逻辑自洽**（主角为什么会用这个产品？）
+- [ ] 产品植入**不生硬**（RESOLVE 必须对应 TENSION 的 pain）
+- [ ] NEGATIVE 含 `no jump cut, no obvious insertion, no over-drama`
+- [ ] 主角演出**自然**（AI 易生成过度表情）
+
+## H.2 导出前
+
+- [ ] 产品在 #5/#6/#7/#10 外观一致
+- [ ] 主角**面部 / 情绪连贯**（#2/#3/#8 应为同一人）
+- [ ] 剧情因果链成立（场景 → 冲突 → 产品 → 反转）
+- [ ] 产品**不抢戏**（占画面 ≤25% 时间）
+- [ ] CTA 不破坏剧情结尾氛围
+
+## H.3 发布前
+
+- [ ] 静音能看懂剧情？（剧情类对字幕要求更高）
+- [ ] 反转效果**够明显**（让观众"哈"一声）
+- [ ] 产品功效宣称**合规**（不是药品 / 不是神奇效果）
+- [ ] 各平台 Delta 改完？
+
+---
+
+# I · 成本预估
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: "人物表演 + 场景丰富"
+  human_review: "30 min"
+  editing_narrative: "2.5 hours（剧情节奏 + 情绪 BGM）"
+  per_platform_delta: "25 min × 3 = 75 min"
+  total: "$8.4 + 4.5 hours"
+
+breakeven_math:
+  margin_typical: "40-60%（快消中高毛利）"
+  conversion_rate: "1-2%（剧情类情感转化中等）"
+  realistic_range_per_platform: "30K-300K views"
+  brand_value_beyond_sales: "剧情类的品牌记忆度高，长尾效应比痛点-解决型强"
+```
+
+---
+
+# J · 复用边界
+
+**✅ 直接套用**：
+办公咖啡 · 功能饮料 · 便携零食 · 即饮茶 · 助眠食品 · 提神糖果 · 速食汤包
+
+**❌ 不适合**：
+- 需要详细说明的产品（如新品类教育）→ KOL 试用
+- 视觉美学驱动（如美妆）→ 效果对比
+- 纯功能展示（如数码）→ 场景化使用
+- 高客单价（剧情投入产出比低）

package/.claude/skills/video-gen/templates/kol-reaction-food.md

@@ -0,0 +1,193 @@
+---
+name: kol-reaction-food
+type: kol-reaction
+category: food
+duration_sweet_spot: 30-45s
+design_principle: "每个字段对应一个可预见的失败模式；字段密度按镜头风险不对称"
+---
+
+# Template: KOL 真实反应型（食品 / 饮料 / 预制菜）
+
+> **第一性原理**：本模板每个字段对应一个具体的失败模式。
+> **适合**：零食 / 饮料 / 预制菜 / 生鲜 / 调味品，客单价 ¥30–200
+> **高风险镜头**：#3（开箱）· #5（入口瞬间 / 味觉反应）· #8（CTA）
+> **信任核心**：#5 的**真实反应 CU** — 伪造反应 = 内容即死
+
+---
+
+# A · 项目卡
+
+| 字段 | 填写 | 不填的后果 |
+|---|---|---|
+| `{product_name}` | | PRODUCT_LOCK 无锚点 |
+| `{product_category}`（零食/饮料/主食） | | 入口镜头拍摄方式不同 |
+| `{price}` | | CTA 写不出 |
+| `{target_user}`（打工人/学生/宝妈）| | Hook 找不到切入 |
+| `{kol_type}`（头部美食 / 素人开箱 / 主持专业）| | 镜头语言全盘变 |
+| `{taste_descriptor}`（甜咸/酥脆/麻辣）| | 味觉反应无法指导 |
+| `{product_highlights}`（3 个卖点：新鲜度 / 口感 / 份量）| | PROOF 空 |
+
+---
+
+# B · 五段骨架（Intro-Unbox-Taste-Reaction-CTA）
+
+| 段 | 时长 | 必须决定的事 |
+|---|---|---|
+| INTRO | 0-5s | KOL 登场 + 产品预告（"今天试{product}"）|
+| UNBOX | 5-12s | 包装展示 + 产地 / 规格介绍 |
+| TASTE | 12-20s | **入口瞬间**（CU 核心，不可替代）|
+| REACTION | 20-35s | 真实口头 + 表情 + 特征描述 |
+| CTA | 35-42s | 评分 + 价格 + 限时优惠 |
+
+**食品类铁律**：#5 TASTE 段必须是**真实 KOL 或真人演员**拍摄，AI 生成易出现"假笑 / 嘴型不对 / 咀嚼违和"。
+
+---
+
+# C · 镜头表（12 镜 · 42s · ASL ~3.5s · 慢于其他类型）
+
+| # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
+|---|---|---|---|---|---|---|---|
+| 1 | 0-2.5s | `{kol_hero_shot}` KOL 本人 CU | `{kol_intro}`（"今天吃{product}"） | CU | — | `refs/kol.jpg` | **no deepfake**, no facial distortion |
+| 2 | 2.5-5s | `{product_in_hand}` KOL 举产品 | `{product_name}` | MS | **★ partial** | `refs/product.jpg` | no product warp |
+| **3** | **5-9s** | **`{unboxing_sequence}` 开箱过程** | `{unboxing_detail}`（"真空包装/锁鲜膜"）| **跟手 + CU** | **★ full** | **`refs/product_packaging.jpg`** | **no label garble, no brand confusion** |
+| 4 | 9-12s | `{product_close_up}` 食物本体特写 | `{visual_label}`（"芝士爆浆"）| 微距 + 自然光 | — | `refs/food_close.jpg` | no unappetizing color |
+| **5** | **12-16s** | **`{taste_moment}` 入口 CU** | `{taste_onomatope}`（"咔嚓"）| **CU 正脸 + 咀嚼 ASMR** | — | **`refs/kol.jpg`** | **no fake chewing, no mouth distortion** |
+| 6 | 16-20s | `{reaction_freeze}` 吃到瞬间定格 | `{exclaim_word}` | 定格 + 字幕爆出 | — | — | no over-acted reaction |
+| 7 | 20-25s | `{taste_description}` KOL 语言描述 | `{descriptor_1}`（"外酥里嫩"）| MS | — | — | — |
+| 8 | 25-30s | `{comparison_analogy}` 类比描述 | `{descriptor_2}`（"像...但更..."）| MS + B-roll | — | — | — |
+| 9 | 30-33s | `{product_multi_flavor}` 其他口味展示 | `{flavors_list}` | 快切 | **★ same** | `refs/product_variants.jpg` | no color shift |
+| 10 | 33-37s | `{rating_graphic}` 评分字幕卡 | `{rating}`（"★★★★☆"）| 静止 + 图形叠加 | — | — | — |
+| **11** | **37-41s** | **`{product_CU}` + 价格 + 小黄车箭头** | `{cta_line}` | **CU + 轻推** | **★ hero** | **`refs/product.jpg`** | **no burned subtitle** |
+| 12 | 41-42s | KOL 挥手 / 品牌 | `{sign_off}` | MS | — | — | — |
+
+---
+
+# D · PRODUCT_LOCK 规范
+
+```yaml
+product_lock:
+  name: "{product_name}"
+  must_specify:
+    - package_shape: "{e.g. 立式袋装 / 罐装 / 盒装}"
+    - label_colors: "{主色 + 副色}"
+    - label_text: "{中英文品牌 + 口味名 + 净含量}"
+    - food_appearance: "{颜色 + 形状 + 表面纹理}"
+  consistency_method:
+    primary: "same seed #3/#4/#9/#11"
+    backup: "单独拍真实 KOL + AI 生成产品镜头拼接"
+    reference_image: "refs/product.jpg + refs/food_close.jpg + refs/kol.jpg"
+```
+
+**特别警告**：食品包装的**条码 / 生产日期 / 配料表**是 AI 的灾难区。NEGATIVE 必加 `no barcode distortion, no fake date, no ingredient garble`。
+
+---
+
+# E · 参考图清单
+
+| 文件 | 用途 | 必须 |
+|---|---|---|
+| `refs/product.jpg` | 产品整体（带包装）| ✅ |
+| `refs/product_packaging.jpg` | 包装细节 | ✅ |
+| `refs/food_close.jpg` | 食物本体特写 | ✅ |
+| `refs/kol.jpg` | KOL 本人参考（若用真人拍摄则可跳过）| **仅 AI 生成 KOL 时必须** |
+| `refs/product_variants.jpg` | 多口味合影 | ⚠️ 推荐 |
+
+**食品类铁律**：#5 TASTE 段**优先用真人拍摄再合成**，AI 生成的吃相难以过审。
+
+---
+
+# F · 通用默认值
+
+```yaml
+aspect: "9:16"
+total_duration: 42
+pacing: slow-moderate
+asl: 3.5
+bgm:
+  douyin: "商家原声 / KOL 本人声"
+  tiktok: "original sound with chewing ASMR"
+  xhs: "治愈轻音乐 + 环境音"
+hook_template: "{target_user} 的 {category} 清单加上这个"
+cta_template: "{price}（原价 {original_price}）{limited_offer}"
+```
+
+---
+
+# G · 平台 Delta
+
+| | 抖音小店 | TikTok Shop | 小红书 |
+|---|---|---|---|
+| 字幕 | 中文 + 口味描述 | 英文 + foodie terms | 中文 + 配料表解读 |
+| 时长 | 42s（master）| 35s | 50s（加背景故事）|
+| KOL 风格 | 真实 / 口音亲切 | 高能 / 戏剧 | 精致 / 氛围 |
+| BGM | KOL 原声 + ASMR | original sound | 轻音乐 |
+| CTA 话术 | "小黄车 ¥29.9 抢" | "Link below! $4.99 🔥" | "评论区扣 1 拿链接" |
+| Hashtag | `#好吃到哭 #零食推荐` | `#foodreview #snacksoftiktok #tasty` | `#美食 #宝藏零食 #种草` |
+| 封面帧 | #6 反应定格 | #5 入口瞬间 | #4 食物特写 |
+
+---
+
+# H · 失败模式 Checklist
+
+## H.1 生成前
+
+- [ ] 决定 #5 TASTE 段用**真人拍摄**还是 AI 生成（真人更稳）
+- [ ] `refs/product_packaging.jpg` 含完整包装信息（条码 / 生产日期可不清晰但要存在）
+- [ ] NEGATIVE 含 `no barcode distortion, no fake date, no ingredient garble, no unappetizing color`
+- [ ] 口味描述避免医疗词（"增强免疫力""改善睡眠"等）
+
+## H.2 导出前
+
+- [ ] KOL 面部一致性（若 AI 生成，严防 deepfake 风险）
+- [ ] 食物颜色**诱人真实**（不要过度饱和成假色）
+- [ ] 包装文字可读（品牌名可见，不是乱码）
+- [ ] 口味描述**可兑现**（说"爆浆"真的有爆浆画面）
+
+## H.3 发布前
+
+- [ ] 静音能看懂"KOL 在吃什么" + "评分几分"？
+- [ ] 2× 能跟上节奏？
+- [ ] 是否符合广告法（食品不可有"最""第一""治愈""功效"等）？← 食品红线
+- [ ] 保质期 / 过敏原信息是否需要补字幕？
+- [ ] 各平台 Delta 改完？
+
+---
+
+# I · 成本预估
+
+```yaml
+production_cost:
+  per_second_rate_usd:
+    standard: TBD  # 填自 Optima credits 换算表
+    hifi: TBD      # 填自 Optima credits 换算表
+  complexity_note: "混合真人 + AI"
+  real_kol_filming: "$0-$500（自己拍 OR 雇 KOL）"
+  human_review: "45 min（食品广告法审查重）"
+  editing_asmr: "2 hours（ASMR 音效 + 字幕爆出）"
+  per_platform_delta: "20 min × 3 = 1 hour"
+  total: "$6 + $0-500 + 4 hours"
+
+breakeven_math:
+  margin_typical: "30-50%（食品毛利中等）"
+  conversion_rate: "2-4%（食品冲动消费高）"
+  realistic_range_per_platform: "20K-500K views"
+```
+
+---
+
+# J · 复用边界
+
+**✅ 直接套用**：
+零食 · 饮料 · 预制菜 · 调味品 · 乳制品 · 茶叶 · 咖啡豆
+
+**❌ 不适合**：
+- 生鲜（需要产地溯源型，非 KOL 反应型）
+- 保健品 → 严格广告法限制，需专门模板
+- 婴幼儿食品 → 需专家背书型模板
+- 高客单名贵食材（松露 / 鱼子酱）→ 奢侈品型模板
+
+---
+
+# 相关
+
+- 食品广告法参考：国标 GB 7718 / GB 13432