@optima-chat/gen-cli 2.5.0 → 2.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist/commands/task.d.ts.map +1 -1
  2. package/dist/commands/task.js +12 -3
  3. package/dist/commands/task.js.map +1 -1
  4. package/dist/commands/video.d.ts.map +1 -1
  5. package/dist/commands/video.js +26 -2
  6. package/dist/commands/video.js.map +1 -1
  7. package/package.json +1 -2
  8. package/.claude/skills/digital-human/SKILL.md +0 -309
  9. package/.claude/skills/digital-human/references/avatar-catalog.md +0 -47
  10. package/.claude/skills/digital-human/references/edit.md +0 -219
  11. package/.claude/skills/digital-human/references/generate.md +0 -378
  12. package/.claude/skills/digital-human/references/manage.md +0 -137
  13. package/.claude/skills/digital-human/references/train.md +0 -276
  14. package/.claude/skills/gen/SKILL.md +0 -366
  15. package/.claude/skills/motion-control/SKILL.md +0 -68
  16. package/.claude/skills/multigrid-poster/SKILL.md +0 -194
  17. package/.claude/skills/multigrid-poster/layouts/2x2.json +0 -34
  18. package/.claude/skills/multigrid-poster/layouts/3x3.json +0 -43
  19. package/.claude/skills/multigrid-poster/scripts/compose.py +0 -116
  20. package/.claude/skills/multigrid-poster/scripts/placeholder.png +0 -0
  21. package/.claude/skills/multigrid-poster/shared/fonts/MaShanZheng-Regular.ttf +0 -0
  22. package/.claude/skills/video-compose/SKILL.md +0 -144
  23. package/.claude/skills/video-compose/scripts/video_compose.py +0 -290
  24. package/.claude/skills/video-edit/SKILL.md +0 -332
  25. package/.claude/skills/video-gen/SKILL.md +0 -662
  26. package/.claude/skills/video-gen/references/cinematic-language.md +0 -158
  27. package/.claude/skills/video-gen/references/confirm-card.md +0 -49
  28. package/.claude/skills/video-gen/references/prompt-craft.md +0 -72
  29. package/.claude/skills/video-gen/templates/INDEX.md +0 -78
  30. package/.claude/skills/video-gen/templates/before-after-beauty.md +0 -183
  31. package/.claude/skills/video-gen/templates/drama-fmcg.md +0 -183
  32. package/.claude/skills/video-gen/templates/kol-reaction-food.md +0 -193
  33. package/.claude/skills/video-gen/templates/multi-point-apparel.md +0 -185
  34. package/.claude/skills/video-gen/templates/pain-solution-home.md +0 -184
  35. package/.claude/skills/video-gen/templates/pdp-360-showcase.md +0 -189
  36. package/.claude/skills/video-gen/templates/pdp-feature-highlight.md +0 -182
  37. package/.claude/skills/video-gen/templates/scene-digital.md +0 -183
  38. package/.claude/skills/video-translate/SKILL.md +0 -547
@@ -1,184 +0,0 @@
1
- ---
2
- name: pain-solution-home
3
- type: pain-solution
4
- category: home
5
- duration_sweet_spot: 18-22s
6
- design_principle: "每个字段对应一个可预见的失败模式;字段密度按镜头风险不对称"
7
- ---
8
-
9
- # Template: 痛点-解决型(家居 / 日用)
10
-
11
- > **第一性原理**:本模板的每个字段都是为了阻止一个具体的失败模式。没有装饰字段。
12
- > **适合**:家居 / 日用 / 清洁 / 收纳,客单价 ¥50–300
13
- > **高风险镜头**:#4(产品首次出现)· #9(商品 CTA)—— 字段密度最高
14
-
15
- ---
16
-
17
- # A · 项目卡(**对抗"类型选错 / 决策基础不全"**)
18
-
19
- | 字段 | 填写 | 不填的后果 |
20
- |---|---|---|
21
- | `{product_name}` | | PRODUCT_LOCK 无锚点 |
22
- | `{product_category}` | | 判断不了是否属于本模板 |
23
- | `{price}` / `{original_price}` | | CTA 写不出 |
24
- | `{price_point}`(低/中/高客单)| | 客单 >¥300 应切 KOL 模板 |
25
- | `{target_user}` | | Hook 找不到切入语气 |
26
- | `{core_pain_noun}`(如"脏水"/"油污")| | HOOK 模板无法填充 |
27
-
28
- ---
29
-
30
- # B · 五段骨架(**对抗"电商结构不全,漏 PROOF 则转化崩"**)
31
-
32
- | 段 | 时长 | 必须决定的事 |
33
- |---|---|---|
34
- | HOOK | 0-2s | 痛点反问的**一句话**(≤15 字)|
35
- | PAIN | 2-5s | 旧方案要暴露哪**两个**缺陷 |
36
- | SOLUTION | 5-12s | 核心动作名(如"一脚踩→自动拧")|
37
- | PROOF | 12-18s | **拿什么证据**:销量数字 / 评论截图 / 对比图(必须指定)|
38
- | CTA | 18-22s | 紧迫感 + 位置指示("左下角 ¥99 限时")|
39
-
40
- ---
41
-
42
- # C · 镜头表(**字段密度按风险不对称**)
43
-
44
- **低风险镜头**(#1-#3 痛点场景)只需要 4 列;
45
- **高风险镜头**(#4-#6 产品演示 · #9 CTA)增加 PRODUCT_LOCK + REFERENCE_IMG + NEGATIVE 三列。
46
-
47
- | # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
48
- |---|---|---|---|---|---|---|---|
49
- | 1 | 0-2s | `{pain_CU}` 痛点 CU | `{hook_line}` | CU + 手持微抖 | — | `refs/pain_context.jpg`(可选) | no text overlay |
50
- | 2 | 2-3.5s | `{old_method_pain}` | "痛点关键词" | 跟手 | — | — | — |
51
- | 3 | 3.5-5s | `{pain_consequence}` | "三大问题" | 特写 | — | — | — |
52
- | **4** | **5-8s** | **`{product}` 出场 + 核心动作** | `{core_action}` | **CU + 静止** | **★ full** | **`refs/product.jpg`** | **no variations, no morphing** |
53
- | **5** | **8-11s** | **`{product_demo}` 效果** | "自动/一键" | **跟手** | **★ same as #4** | **`refs/product.jpg`** | **no color shift, no flip** |
54
- | **6** | **11-14s** | **全景 `{clean_result}`** | "省时 80%" | **中景** | **★ same** | — | **no warping** |
55
- | 7 | 14-17s | `{sales_screenshot}` | "热卖 {sales_number}" | 屏录 | — | `refs/sales_page.png` | no fake data, no blur |
56
- | 8 | 17-19s | `{reviews_rollup}` | "4.9 分好评" | 屏录 | — | `refs/reviews.png` | no text distortion |
57
- | **9** | **19-22s** | **`{product_CU}` + 价格 + 购物车箭头** | `{cta_line}` | **CU + 轻推** | **★ hero shot** | **`refs/product.jpg`** | **no burned-in subtitle, no extra arrows** |
58
-
59
- ---
60
-
61
- # D · PRODUCT_LOCK 规范(**对抗"AI 生成时产品每段都变形"**)
62
-
63
- ```yaml
64
- product_lock:
65
- name: "{product_name}"
66
- must_specify:
67
- - color_palette: "{e.g. matte white + silver accents + blue ring}"
68
- - material_finish: "{e.g. ABS plastic + brushed aluminum}"
69
- - logo_position: "{e.g. top front, 5mm height}"
70
- - silhouette: "{e.g. cylindrical head + 30cm pole + pedal base}"
71
- consistency_method:
72
- primary: "same seed across shots #4/#5/#6/#9"
73
- backup: "image-to-video chain #4 → #5 → #6 (use last frame as next input)"
74
- reference_image: "refs/product.jpg (800x800 white background, 3+ angles)"
75
- ```
76
-
77
- ---
78
-
79
- # E · 参考图清单(**对抗"缺视觉锚点 / 照着空气生成"**)
80
-
81
- | 文件 | 用途 | 必须有 |
82
- |---|---|---|
83
- | `refs/product.jpg` | 产品主图(白底 · ≥800x800) | ✅ |
84
- | `refs/product_detail.jpg` | 细节特写(logo / 材质) | ✅ |
85
- | `refs/pain_context.jpg` | 痛点场景参考(可选,增强 #1-#3 真实感) | ⚠️ 推荐 |
86
- | `refs/sales_page.png` | 销量截图(用于 #7) | ✅ |
87
- | `refs/reviews.png` | 评论滚动截图(用于 #8) | ✅ |
88
-
89
- **缺任何一张 ✅ 标的 → storyboard 未完成,不能进生成**。
90
-
91
- ---
92
-
93
- # F · 通用默认值
94
-
95
- ```yaml
96
- aspect: "9:16"
97
- total_duration: 22
98
- pacing: moderate-fast
99
- asl: 2.4 # 平均镜头长度(秒)
100
- bgm:
101
- douyin: "商家原声讲解"
102
- tiktok: "original sound"
103
- xhs: "轻音乐 + ASMR"
104
- hook_template: "你家的 {core_pain_noun} 还是这样吗?"
105
- cta_template: "左下角 {price}(原价 {original_price})限时"
106
- ```
107
-
108
- ---
109
-
110
- # G · 平台 Delta(**对抗"一版三投,数据必有两个差"**)
111
-
112
- | | 抖音小店 | TikTok Shop | 小红书 |
113
- |---|---|---|---|
114
- | 字幕 | 中文 | 英文大写 + 🤯 | 中文 + 表情 |
115
- | 时长 | 22s(master)| 17s(砍 #2 #6)| 28s(加场景化前置)|
116
- | BGM | 商家原声 | original sound | 轻音乐 + ASMR |
117
- | CTA 话术 | "左下角小黄车" | "Yellow basket 👇" | "评论区拿链接" |
118
- | Hashtag | `#家居好物 #懒人神器` | `#tiktokmademebuyit #cleantok` | `#家居种草 #懒人必备` |
119
- | 封面帧 | #4 动作感 | #5 前后对比 | #6 治愈感 |
120
-
121
- ---
122
-
123
- # H · 失败模式 Checklist(**发布前必过**)
124
-
125
- ## H.1 生成前(**对抗"生成就翻车"**)
126
-
127
- - [ ] `refs/product.jpg` 存在且清晰度 ≥ 1080×1080
128
- - [ ] `PRODUCT_LOCK` 的 4 项 must_specify 全部填写
129
- - [ ] 镜头 #4 #5 #6 #9 使用同一个 seed 和同一张 reference
130
- - [ ] `NEGATIVE` 字段包含 5 要素(no distorted hands / no text / no variations / no morphing / no watermark)
131
-
132
- ## H.2 导出前(**对抗"生成完了才发现错"**)
133
-
134
- - [ ] 产品在 #4/#5/#6/#9 四个镜头里外观一致(目检)
135
- - [ ] 没有手指畸形 / 产品文字被 AI 错误生成
136
- - [ ] 字幕是后期叠加,不是被生成到画面里
137
- - [ ] 9 个镜头拼接后总时长 = 22s ± 0.5s
138
- - [ ] BGM 节拍对齐 Shot #4 的动作点
139
-
140
- ## H.3 发布前(**对抗"发了没人看"**)
141
-
142
- - [ ] 静音测试:关声音能看懂卖点?
143
- - [ ] 2× 播放能跟上节奏?
144
- - [ ] Scroll Stop:朋友看首 3 秒会划走吗?
145
- - [ ] 价格 / 库存 / CTA 信息当下有效?
146
- - [ ] 各平台 Delta 已按 G 表改完?
147
-
148
- **三段 checklist 全过才发。**
149
-
150
- ---
151
-
152
- # I · 成本预估(**对抗"商家盲投"**)
153
-
154
- ```yaml
155
- production_cost:
156
- per_second_rate_usd:
157
- standard: TBD # 填自 Optima credits 换算表
158
- hifi: TBD # 填自 Optima credits 换算表
159
- complexity_note: ""
160
- human_review: "30 min"
161
- editing_subtitle_bgm: "1 hour"
162
- per_platform_delta: "15 min × 3 = 45 min"
163
- total: "$4.5 + 2.5 hours"
164
-
165
- breakeven_math:
166
- if_product_margin: "{margin}"
167
- conversion_rate_assumption: "2%"
168
- views_to_breakeven: "total_cost / (price × margin × conversion_rate)"
169
- realistic_range_per_platform: "10K-100K views (based on 15-item viral sample)"
170
- ```
171
-
172
- ---
173
-
174
- # J · 复用边界(**对抗"模板套错产品"**)
175
-
176
- **✅ 直接套用**(仅改 `{product}` / `{pain}` / `{sales}` 字段):
177
- 洗衣球 · 洗鞋机 · 油烟净 · 厨房收纳 · 切菜神器 · 马桶刷 · 地板清洁剂
178
-
179
- **❌ 不适合**(切换到其他模板):
180
- - 美妆 → `before-after-beauty.md`
181
- - 数码 / 3C → `scene-digital.md`
182
- - 服装 → `multi-point-apparel.md`
183
- - 食品 → `kol-reaction-food.md`
184
- - 客单价 ≥¥500 → KOL 信任型模板
@@ -1,189 +0,0 @@
1
- ---
2
- name: pdp-360-showcase
3
- type: pdp-360
4
- category: product-detail-page
5
- duration_sweet_spot: 15-25s
6
- design_principle: "每个字段对应一个可预见的失败模式;字段密度按镜头风险不对称"
7
- ---
8
-
9
- # Template: 产品 360 度展示(PDP / 详情页)
10
-
11
- > **第一性原理**:本模板每个字段对应一个具体的失败模式。
12
- > **适合**:详情页主视频 · 重视觉外观的产品(家居 / 数码 / 服装 / 配饰 / 玩具)
13
- > **高风险镜头**:#2(旋转中的产品一致性)· #4-#6(细节特写)
14
- > **核心挑战**:旋转过程中产品**每一帧都必须是同一件产品**
15
-
16
- ---
17
-
18
- # A · 项目卡
19
-
20
- | 字段 | 填写 | 不填的后果 |
21
- |---|---|---|
22
- | `{product_name}` | | PRODUCT_LOCK 无锚点 |
23
- | `{aspect_ratio}`(1:1 / 16:9 / 9:16)| | PDP 默认 1:1 或 16:9,与社媒不同 |
24
- | `{rotation_direction}`(顺 / 逆)| | 旋转方向必须前后一致 |
25
- | `{detail_highlights}`(3 个细节)| | #4 #5 #6 拍什么空 |
26
- | `{size_reference}`(手 / 硬币 / 尺)| | 用户无法判断大小 |
27
- | `{brand_line}` | | 片尾无 branding |
28
-
29
- ---
30
-
31
- # B · 五段骨架(PDP 专用 · 非电商 5 段)
32
-
33
- | 段 | 时长 | 必须决定的事 |
34
- |---|---|---|
35
- | ESTABLISH | 0-3s | 产品干净全景(白底)|
36
- | ROTATE | 3-10s | 360° 旋转(5-7 秒完成一圈)|
37
- | DETAILS | 10-17s | 3 个关键细节 CU |
38
- | SCALE | 17-20s | 尺寸参照(vs 手 / 硬币)|
39
- | CLOSE | 20-22s | 品牌 + logo 定格 |
40
-
41
- **PDP 铁律**:不加 CTA / 不加价格 / 不加 hashtag —— PDP 视频是"产品档案",不是广告。
42
-
43
- ---
44
-
45
- # C · 镜头表(9 镜 · 22s · ASL ~2.4s)
46
-
47
- | # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
48
- |---|---|---|---|---|---|---|---|
49
- | 1 | 0-3s | `{product_front}` 产品正面静止 | `{product_name}` | 静止 + 干净白底 | **★ full** | **`refs/product_front.jpg`** | **no background clutter, no shadows** |
50
- | **2** | **3-10s** | **`{product_rotate_360}` 360° 环绕** | — | **环绕 + 匀速** | **★ continuous lock** | **`refs/product_front.jpg` + side + back** | **no color shift mid-rotation, no model swap** |
51
- | 3 | 10-12s | `{product_top_view}` 俯视 | — | 俯拍 | **★ same** | `refs/product_top.jpg` | no perspective distortion |
52
- | **4** | **12-14s** | **`{detail_1_CU}` 细节 1** | `{detail_1_label}`(材质 / 按钮 / 接口)| **微距 + 静止** | **★ same** | **`refs/detail_1.jpg`** | **no material fakery** |
53
- | 5 | 14-16s | `{detail_2_CU}` 细节 2 | `{detail_2_label}` | 微距 | **★ same** | `refs/detail_2.jpg` | — |
54
- | 6 | 16-17s | `{detail_3_CU}` 细节 3 | `{detail_3_label}` | 微距 | **★ same** | `refs/detail_3.jpg` | — |
55
- | **7** | **17-20s** | **`{size_reference}` 尺寸对比** | `{size_label}`("长 15cm")| **MS + 手持** | **★ same** | **`refs/size_compare.jpg`** | **no unnatural scale** |
56
- | 8 | 20-21s | `{product_full_clean}` 回到干净全景 | — | 拉远 | **★ same** | `refs/product_front.jpg` | — |
57
- | 9 | 21-22s | 品牌 logo + 留白 | `{brand_line}` | 静止 | — | `refs/logo.jpg` | — |
58
-
59
- ---
60
-
61
- # D · PRODUCT_LOCK 规范(**PDP 最严**)
62
-
63
- ```yaml
64
- product_lock:
65
- name: "{product_name}"
66
- must_specify:
67
- - exact_dimensions: "{长 × 宽 × 高 + 重量}"
68
- - exact_colors: "{Pantone / RGB / hex 具体值}"
69
- - material_finish: "{哑光 / 光泽 / 磨砂 + 具体材料名}"
70
- - every_visible_detail: "{logo 位置 + 字体 + 接缝 + 按钮 + 接口}"
71
- - manufacturing_marks: "{模具分型线 / 品牌铭牌}"
72
- consistency_method:
73
- primary: "旋转段必须用 image-to-video 链(非 text-to-video)"
74
- backup: "每 0.5s 一帧的人工关键帧介入"
75
- reference_image: "refs/product_front.jpg + side + back + top 共 4-6 张"
76
- warning: "PDP 对产品一致性要求最严 —— 任何帧的变化都会被详情页用户放大看到。"
77
- ```
78
-
79
- ---
80
-
81
- # E · 参考图清单
82
-
83
- | 文件 | 用途 | 必须 |
84
- |---|---|---|
85
- | `refs/product_front.jpg` | 正面 | ✅ |
86
- | `refs/product_side.jpg` | 侧面 | ✅ |
87
- | `refs/product_back.jpg` | 背面 | ✅ |
88
- | `refs/product_top.jpg` | 俯视 | ✅ |
89
- | `refs/detail_1.jpg` | 细节 1(通常是 logo / 按钮 / 接口)| ✅ |
90
- | `refs/detail_2.jpg` | 细节 2 | ✅ |
91
- | `refs/detail_3.jpg` | 细节 3 | ⚠️ 推荐 |
92
- | `refs/size_compare.jpg` | 尺寸参照 | ✅ |
93
- | `refs/logo.jpg` | 品牌 logo | ⚠️ 推荐 |
94
-
95
- **PDP 铁律**:**至少 4 张产品角度图 + 3 张细节图 = 7 张参考**,否则 AI 360 旋转会"编造"不存在的角度。
96
-
97
- ---
98
-
99
- # F · 通用默认值
100
-
101
- ```yaml
102
- aspect: "1:1" # PDP 默认方形;若视频详情页用 16:9
103
- total_duration: 22
104
- pacing: slow(匀速,不追求戏剧节奏)
105
- asl: 2.4
106
- bgm:
107
- pdp: "无(或极轻环境音)" # PDP 视频通常静音播放
108
- social_crossover: "轻音乐(若同时用作社媒)"
109
- # PDP 不需要 hook / CTA / hashtag 字段
110
- ```
111
-
112
- ---
113
-
114
- # G · 平台 Delta(PDP 特殊 · 不分社媒平台)
115
-
116
- | 用途 | 配置 |
117
- |---|---|
118
- | **淘宝 / 天猫详情页** | 1:1 或 16:9,静音播放兼容 |
119
- | **亚马逊 A+ 页面** | 16:9,无字幕(英文市场)|
120
- | **京东详情页** | 1:1,可加字幕 |
121
- | **独立站** | 16:9,含 CTA 按钮 overlay |
122
- | **跨境 Shopify** | 16:9 或 9:16(mobile-first)|
123
- | **作为社媒素材复用时** | 改 9:16 + 加字幕 + 加 CTA(实际上切到 scene-digital 模板)|
124
-
125
- ---
126
-
127
- # H · 失败模式 Checklist
128
-
129
- ## H.1 生成前
130
-
131
- - [ ] 至少 4 张产品角度图就位(正 / 侧 / 背 / 顶)
132
- - [ ] 每个角度图**光线一致**(否则 AI 旋转时会跳光)
133
- - [ ] `PRODUCT_LOCK.exact_dimensions` 精确到毫米(防 AI 随便缩放)
134
- - [ ] NEGATIVE 含 `no color shift, no material fakery, no manufacturing mark change`
135
-
136
- ## H.2 导出前
137
-
138
- - [ ] 旋转段(#2)**每一帧都是同一件产品**(最严格检查点)
139
- - [ ] 细节 CU 的材质和主镜一致(#4/#5/#6 vs #1)
140
- - [ ] 尺寸参照合理(手大小 / 硬币尺寸对应真实)
141
- - [ ] 背景干净(白底无阴影无杂物)
142
- - [ ] **没有 CTA / 价格 / 紧迫感** 元素(PDP 铁律)
143
-
144
- ## H.3 发布前
145
-
146
- - [ ] 静音播放时画面仍然信息充分?(PDP 常静音)
147
- - [ ] 旋转速度匀速不卡顿?
148
- - [ ] 比例符合目标详情页(1:1 vs 16:9 vs 9:16)?
149
- - [ ] 时长不超过 30s(PDP 用户耐心短)?
150
-
151
- ---
152
-
153
- # I · 成本预估
154
-
155
- ```yaml
156
- production_cost:
157
- per_second_rate_usd:
158
- standard: TBD # 填自 Optima credits 换算表
159
- hifi: TBD # 填自 Optima credits 换算表
160
- complexity_note: "360 旋转 prompt 复杂度高"
161
- human_review: "45 min(质检严格)"
162
- editing: "1 hour(主要是拼接和调色匹配)"
163
- total: "$7.2 + 2 hours"
164
- note: "PDP 一次做好多年使用(产品不改则视频不改),ROI 极高"
165
-
166
- breakeven_math:
167
- pdp_value_model: "提升详情页转化率(+2-5%)"
168
- typical_uplift: "按店铺日单量 100 · 每单 ¥200 · 毛利 40% → 提升 2% 转化 = +¥160/日"
169
- pdp_video_payback: "~50 天(按 $7.2 成本)"
170
- ```
171
-
172
- ---
173
-
174
- # J · 复用边界
175
-
176
- **✅ 直接套用**:
177
- 任何需要展示产品外观的实物商品 —— 家居 · 数码 · 配饰 · 玩具 · 工具 · 厨具
178
-
179
- **❌ 不适合**:
180
- - 软性产品(护肤品 / 食品)→ 没"外观"可 360
181
- - 虚拟商品(软件 / 课程)→ 完全不适用
182
- - 高度标准化无差异产品(如纸巾 / 纯色 T 恤)→ PDP 360 没看点
183
- - 需要演示使用的产品 → `pdp-feature-highlight.md`
184
-
185
- ---
186
-
187
- # 相关
188
-
189
- - 姊妹模板:`pdp-feature-highlight.md`(功能展示型 PDP)
@@ -1,182 +0,0 @@
1
- ---
2
- name: pdp-feature-highlight
3
- type: pdp-feature
4
- category: product-detail-page
5
- duration_sweet_spot: 20-30s
6
- design_principle: "每个字段对应一个可预见的失败模式;字段密度按镜头风险不对称"
7
- ---
8
-
9
- # Template: 功能亮点型(PDP / 详情页 · 数码家电)
10
-
11
- > **第一性原理**:本模板每个字段对应一个具体的失败模式。
12
- > **适合**:数码 / 家电 / 工具 / 办公设备 · 需要演示**多个功能点**的详情页视频
13
- > **高风险镜头**:#1(产品整体)· #3/#5/#7(每个功能演示)· #9(规格叠加)
14
- > **核心挑战**:每个功能点的演示**必须可兑现**(不能说的做不到)
15
-
16
- ---
17
-
18
- # A · 项目卡
19
-
20
- | 字段 | 填写 | 不填的后果 |
21
- |---|---|---|
22
- | `{product_name}` | | PRODUCT_LOCK 无锚点 |
23
- | `{feature_count}`(通常 3-5 个)| | 镜头数量定不了 |
24
- | `{feature_1}` / `{feature_2}` / `{feature_3}` | | 骨架空 |
25
- | `{spec_sheet}`(关键参数)| | 末尾叠加不完整 |
26
- | `{aspect_ratio}`(PDP 默认 1:1 或 16:9)| | 与社媒尺寸混淆 |
27
- | `{technical_depth}`(小白向 / 专业向)| | 字幕用词错层 |
28
-
29
- ---
30
-
31
- # B · 骨架(Product-Feature1-Feature2-Feature3-Spec)
32
-
33
- | 段 | 时长 | 必须决定的事 |
34
- |---|---|---|
35
- | PRODUCT | 0-4s | 产品整体静止呈现 |
36
- | FEATURE 1 | 4-10s | 功能 1 演示(命名 + 动作 + 效果)|
37
- | FEATURE 2 | 10-16s | 功能 2 演示 |
38
- | FEATURE 3 | 16-22s | 功能 3 演示(最强,放最后)|
39
- | SPEC | 22-27s | 关键参数叠加 + 品牌 |
40
-
41
- **PDP 功能型铁律**:每个功能**必须有"动作"** —— 光看图片不算功能演示。
42
-
43
- ---
44
-
45
- # C · 镜头表(10 镜 · 27s · ASL ~2.7s)
46
-
47
- | # | 时长 | 画面 | 字幕 | 运镜 | PRODUCT_LOCK | REF_IMG | NEGATIVE |
48
- |---|---|---|---|---|---|---|---|
49
- | **1** | **0-4s** | **`{product_hero}` 产品全景 + 轻转** | `{product_name}` | **静止 + 轻推** | **★ full** | **`refs/product.jpg`** | **no perspective glitch** |
50
- | 2 | 4-5s | 全屏图标 "01" | 01 | — | — | — | — |
51
- | **3** | **5-10s** | **`{feature_1_demo}`** 功能 1 操作 | `{feature_1_name}` | **CU + 特效标注** | **★ same** | **`refs/feature_1.jpg`** | **no UI garble, no fake reading** |
52
- | 4 | 10-11s | 全屏图标 "02" | 02 | — | — | — | — |
53
- | **5** | **11-16s** | **`{feature_2_demo}`** 功能 2 操作 | `{feature_2_name}` | **CU + 特效** | **★ same** | `refs/feature_2.jpg` | — |
54
- | 6 | 16-17s | 全屏图标 "03" | 03 | — | — | — | — |
55
- | **7** | **17-22s** | **`{feature_3_demo}`** 功能 3(最强)| `{feature_3_name}` | **CU + 慢镜** | **★ same** | `refs/feature_3.jpg` | **no spec fakery** |
56
- | 8 | 22-23s | 全屏 "SPECS" 标题 | SPECS | — | — | — | — |
57
- | **9** | **23-26s** | **`{spec_overlay}` 参数列表 + 产品底图** | `{spec_list}` | **静止 + 字幕动画** | **★ same** | **`refs/product.jpg`** | **no fake params, no wrong units** |
58
- | 10 | 26-27s | 品牌 logo + 留白 | `{brand_line}` | 静止 | — | `refs/logo.jpg` | — |
59
-
60
- ---
61
-
62
- # D · PRODUCT_LOCK 规范
63
-
64
- ```yaml
65
- product_lock:
66
- name: "{product_name}"
67
- must_specify:
68
- - physical_form: "{外观 + 尺寸}"
69
- - color_finish: "{颜色 + 材质}"
70
- - every_ui_element: "{屏幕 / 按钮 / LED 指示灯的位置和状态}"
71
- - technical_spec_sheet: "{真实参数,不能编造}"
72
- consistency_method:
73
- primary: "same seed #1/#3/#5/#7/#9"
74
- backup: "功能演示镜头可以真机拍摄 + AI 后期整合"
75
- reference_image: "refs/product.jpg + 每个功能特写"
76
- ```
77
-
78
- ---
79
-
80
- # E · 参考图清单
81
-
82
- | 文件 | 用途 | 必须 |
83
- |---|---|---|
84
- | `refs/product.jpg` | 产品全景 | ✅ |
85
- | `refs/feature_1.jpg` | 功能 1 演示参考(含 UI 界面 / 动作)| ✅ |
86
- | `refs/feature_2.jpg` | 功能 2 | ✅ |
87
- | `refs/feature_3.jpg` | 功能 3 | ✅ |
88
- | `refs/spec_sheet.png` | 参数表设计稿 | ⚠️ 推荐 |
89
- | `refs/logo.jpg` | 品牌 | ⚠️ 推荐 |
90
-
91
- ---
92
-
93
- # F · 通用默认值
94
-
95
- ```yaml
96
- aspect: "16:9" # PDP 功能型默认横屏(匹配详情页)
97
- total_duration: 27
98
- pacing: moderate(每个功能 5-6s)
99
- asl: 2.7
100
- bgm:
101
- pdp: "tech / corporate BGM"
102
- social_crossover: "节奏感 electronic"
103
- # PDP 功能型不加 CTA;社媒版本加 CTA 应切到 scene-digital 模板
104
- ```
105
-
106
- ---
107
-
108
- # G · 平台 Delta(PDP 为主,兼顾社媒复用)
109
-
110
- | 用途 | 配置 |
111
- |---|---|
112
- | **京东 / 淘宝详情页** | 16:9 · 中文规格 · 静音兼容 |
113
- | **天猫国际** | 16:9 · 中英双字幕 |
114
- | **亚马逊 A+** | 16:9 · 英文规格 · 无 CTA |
115
- | **独立站 / Shopify** | 16:9 · 可叠加 "Add to Cart" overlay |
116
- | **社媒复用(非推荐)** | 改 9:16 + 加 CTA + 加 hashtag(实际应该用 scene-digital)|
117
-
118
- ---
119
-
120
- # H · 失败模式 Checklist
121
-
122
- ## H.1 生成前
123
-
124
- - [ ] 每个功能对应**真实可验证的参数**(规格表不能编)
125
- - [ ] 每个功能有独立 REF_IMG(含 UI 界面清晰的参考)
126
- - [ ] `PRODUCT_LOCK.every_ui_element` 填完(屏幕显示不能乱)
127
- - [ ] NEGATIVE 含 `no UI garble, no fake reading, no wrong spec units`
128
-
129
- ## H.2 导出前
130
-
131
- - [ ] 产品外观在 #1/#3/#5/#7/#9 完全一致
132
- - [ ] 功能演示**真实可兑现**("5 秒快充" 要能在真机测得出来)
133
- - [ ] 规格参数**单位正确**(mm / cm / g / kg / W / mAh / MHz 不混)
134
- - [ ] UI 界面**字体清晰**(AI 常生成模糊假 UI)
135
- - [ ] **无 CTA / 无价格**(PDP 铁律)
136
-
137
- ## H.3 发布前
138
-
139
- - [ ] 静音播放时功能演示依然清晰?
140
- - [ ] 技术术语准确(不用泛词如 "AI 智能")?
141
- - [ ] 参数宣传**可交付**(做不到的不写)?
142
- - [ ] 比例符合目标详情页?
143
-
144
- ---
145
-
146
- # I · 成本预估
147
-
148
- ```yaml
149
- production_cost:
150
- per_second_rate_usd:
151
- standard: TBD # 填自 Optima credits 换算表
152
- hifi: TBD # 填自 Optima credits 换算表
153
- complexity_note: "UI / 特效标注多"
154
- human_review: "45 min(技术参数审查)"
155
- editing_fx: "2 hours(数字叠加 + 图标 + 参数动画)"
156
- total: "$8 + 3 hours"
157
- note: "PDP 一次做好长期用,产品不改则不重做 → 长期 ROI 极高"
158
-
159
- breakeven_math:
160
- pdp_value_model: "详情页转化率 +2-5%"
161
- typical_uplift: "中高客单数码产品 +1% 转化 = +¥500/日(按日单 50 · 单 ¥500 · 毛利 20%)"
162
- pdp_video_payback: "~2 周"
163
- ```
164
-
165
- ---
166
-
167
- # J · 复用边界
168
-
169
- **✅ 直接套用**:
170
- 手机 · 平板 · 耳机 · 音箱 · 相机 · 电动工具 · 家电 · 智能穿戴 · 游戏设备
171
-
172
- **❌ 不适合**:
173
- - 纯外观型产品(无功能)→ `pdp-360-showcase.md`
174
- - 需要场景代入(而非技术参数)→ `scene-digital.md`
175
- - 功能点只有 1-2 个(不值得 27s)→ 简化版 PDP
176
- - 功能无法可视化(软件功能)→ 屏录教程型
177
-
178
- ---
179
-
180
- # 相关
181
-
182
- - 姊妹模板:`pdp-360-showcase.md`(外观展示型 PDP)