电商带货脚本 · 核心方法论

每次生成都读。本文件是脚本的"骨架 + 红线"，钩子句式见 hook-library.md。

一、黄金结构：钩子 → 痛点 → 卖点 → CTA

带货短视频的灵魂是前 3 秒留人 + 结尾促转化。四个功能镜各司其职：

role	功能	它要做的事	旁白要点
钩子	3 秒留人	第一句话/第一帧就让人停下不划走	用 `hook-library.md` 的公式，制造痛点共鸣或反差冲击
痛点	共鸣	把用户"对，我就这样"的处境讲出来	具体场景化，不抽象，让人对号入座
卖点	商品解决	商品如何恰好解决上面的痛点	卖点落到痛点上，给"凭什么信"的理由（成分/效果/对比/口碑）
CTA	转化行动	临门一脚，告诉用户现在做什么	明确动作 + 紧迫感（点下方小黄车 / 主页领券 / 限时）

铁原则：

镜数不是算出来的，是按表现形式的节奏定的。先取该形式的推荐单镜时长，再用总时长去除：

segment_count ≈ total_duration / 推荐单镜时长，向最接近的整数取整，然后必须落在 ceil(total_duration/15) 到 floor(total_duration/4) 这个区间内。

例：口播 30 秒 → 30/12 ≈ 2.5 → 3 镜（如 12+10+8）。　　短剧 45 秒 → 45/8 ≈ 5.6 → 6 镜（如 8+7+9+7+8+6）。　　Vlog 30 秒 → 30/6.5 ≈ 4.6 → 5 镜（如 6+6+7+6+5）。

说明：

entities 是全脚本共享的角色 / 场景 / 商品池，保证多镜同一角色是同一张脸、同一商品是同一个包装。

一个角色/场景/商品 = 一个 entity = 一份 visual_prompt。多镜复用同一 id，绝不为同一对象写两份 visual_prompt（会导致下游生图人脸/包装漂移）。
visual_prompt 由你自动生成（小白不打字）：写清外观特征（角色：性别/年龄段/发型/穿着/气质；场景：地点/光线/风格；商品：品类/包装/颜色/摆放），用于直接喂图模型。
type 三选一：character(人) / scene(环境) / product(商品)。一份脚本通常至少 1 个 product、至少 1 个 scene。
场景与镜头一一对应（可复用）：每个 segment 的 entity_refs 必须恰好引用一个 scene——它就是这一镜画面所处的环境。多镜同环境就复用同一个 scene id（如全程宿舍 → 只一个「宿舍书桌」scene，4 镜都引用它）；真正换了地点才新建另一个 scene。纯产品特写镜也要绑它所处环境的 scene（无明确环境则复用主场景）。这样下游「场景」基础资产能成图、且同环境背景一致。
ref_index 是该 entity 在图集里的参考序号（从 1 递增，供下游三视图/参考图对齐）。
voice_ref（二期，可选）：角色音色参考，用于锁音色；无则 null。
每个声明的 entity 至少被一个 segment 的 entity_refs 引用，不留孤儿。
segments[].speaker 指向某 character 的 id 表示该镜由角色开口说；null = 画外旁白。

每镜都要规划商品怎么自然出现，避免生硬插入。按 role 给推荐露出方式：

露出方式词汇统一用：手持 / 特写 / 使用中 / 包装正面 / 场景摆放 / 对比展示（可组合，如"手持+特写"）。

narration 字数按这一镜的秒数算：出片模型在镜内直接发声，可懂语速上限约 3.5 字 / 秒。 每镜 narration ≤ duration × 3.5 字，且任何情况下不超过 55 字。 对照表（写作目标再留 10% 缓冲，宁可短不要卡满）：

短镜不要硬塞长句 —— 装不下就把这句拆到下一镜，或者干脆让这镜没有旁白（纯画面）。总时长很短、一镜要装多功能时尤其要狠删，先保 CTA 不被砍。

不浮夸、不空喊：卖点要给具体理由，不堆形容词。
违规词禁令（电商广告法红线，一律不写）：
- 医疗功效类：治疗 / 根治 / 疗效 / 抗癌 / 消炎 / 杀菌(无证) / 排毒 / 速效 / 抑制 ××病 …
- 绝对化用语：最 / 第一 / 顶级 / 唯一 / 100% / 国家级 / 世界级 / 永久 / 绝对 / 史上 …
- 虚假承诺：包治 / 三天见效 / 立刻变白 / 永不反弹 …
- 替换策略：用"帮助""更""不少人反馈""上脸清爽"等柔性、主观化表达替代。

自检阶段必须逐镜扫一遍违规词，命中即改写。详见 checklist.md。