Files

T

seaislee1209andClaude Opus 4.8 6464001f84 feat(core): AI 生成 Agent 化 — 多模型流式脚本 agent + 可插拔 Provider + gpt-image-2 参考图 + 模特库

- 后端·可插拔 Provider 层:通用 OpenAICompatibleProvider(tokenssr 等中转站,base_url+api_key,零改代码换站)+ ModelProvider.api_key
- 后端·脚本 agent:结构化 ScriptDraft 契约 + 加载电商 skill + 出稿/改稿一体对话 agent(3模式/多模型)+ 流式 SSE 端点(DRF SSE renderer)
- 后端·图像:gpt-image-2 参考图出图 + 故事板 @图1@图2@图3 多锚点合成(锁脸锁商品);Seedance 打开 generate_audio
- 后端·模特库:gpt-image-2 生成器(9:16氛围图→16:9白底三视图)+ seed_demo_models 管理命令
- DB·迁移:tokenssr 中转站 + 多模型 seed(豆包/GPT-5.5/Gemini + gpt-image-2);ScriptSegment 结构化字段
- 前端·脚本趴:接真 SSE(工具卡 + 思考流)+ 模型下拉 + 3模式 + 改稿;agentScriptStream
- skills/ecommerce-video-script 电商脚本技能(运行时依赖)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-17 03:12:03 +08:00

5.5 KiB

Raw Blame History

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

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

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

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

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

铁原则：

首镜永远是钩子——3 秒内必须抛出钩子，否则用户划走。
末镜永远收 CTA——可以是独立 CTA 镜，也可以是末镜旁白末尾收一句行动指令。
卖点必须挂在痛点上——不是罗列参数，是"这个痛点 → 商品这样解决"。

二、档位 × 黄金结构映射（关键）

时长由输入给定（15/30/60/90 四档），每 15 秒一镜，segment_count = total_duration / 15。镜数变了，四个功能要压缩或扩展，按下表分配 role：

档位	镜数	role 序列（index 0→N）	压缩/扩展说明
15s	1	`[钩子]`	一镜到底：开头 3 秒钩子 → 中段一句卖点 → 末尾一句 CTA，全压进这 15 秒旁白里
30s	2	`[钩子, 卖点]`	镜0 钩子里带出痛点；镜1 讲卖点并在旁白末尾收一句 CTA
60s	4	`[钩子, 痛点, 卖点, CTA]`	标准黄金结构，一镜一功能
90s	6	`[钩子, 痛点, 卖点, 卖点, 卖点, CTA]`	痛点后给 3 个卖点镜：核心卖点 / 场景化演示 / 信任背书(口碑·数据)；末镜 CTA

说明：

role 字段只能取 钩子|痛点|卖点|CTA 四个枚举值。"信任背书""场景演示"等都归入 卖点。
短档位（15/30s）靠旁白内压缩多功能达成"留人+转化"，不要因为镜少就丢掉 CTA。
90s 的 3 个卖点镜要各有侧重、不重复（核心功效 / 真实使用场景 / 别人为什么买）。

三、entity 一致性原则

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

一个角色/场景/商品 = 一个 entity = 一份 visual_prompt。多镜复用同一 id，绝不为同一对象写两份 visual_prompt（会导致下游生图人脸/包装漂移）。
visual_prompt 由你自动生成（小白不打字）：写清外观特征（角色：性别/年龄段/发型/穿着/气质；场景：地点/光线/风格；商品：品类/包装/颜色/摆放），用于直接喂图模型。
type 三选一：character(人) / scene(环境) / product(商品)。一份脚本通常至少 1 个 product。
ref_index 是该 entity 在图集里的参考序号（从 1 递增，供下游三视图/参考图对齐）。
voice_ref（二期，可选）：角色音色参考，用于锁音色；无则 null。
每个声明的 entity 至少被一个 segment 的 entity_refs 引用，不留孤儿。
segments[].speaker 指向某 character 的 id 表示该镜由角色开口说；null = 画外旁白。

四、商品露出规范（`product_exposure`）

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

role	推荐露出	说明
钩子	可弱露出或不露	钩子先抓人，商品可作悬念，第 1 镜末尾闪一下也行
痛点	不露 / 反面对照	展示"没有它"的糟糕状态，商品先按住
卖点	特写 / 使用中	商品成为主角：成分特写、质地特写、上脸/上手使用中
CTA	手持 / 包装正面	手持商品对镜头，包装正面清晰，配合行动指令

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

五、旁白红线（硬规则，违反即不合格）

口语化：像真人对着镜头唠嗑，不准书面腔 / 不准 AI 腔（"综上所述""不仅…而且""值得一提的是"全禁）。
每镜 narration ≤ 55 字：Seedance 在 15 秒内直接发声，55 字是可懂语速硬上限。 写作目标 ≤ 50 字，留 5 字缓冲——宁可短、不要卡满；短档位（15/30s）一镜要装多功能时尤其要狠删，先保 CTA 不被砍。
不浮夸、不空喊：卖点要给具体理由，不堆形容词。
违规词禁令（电商广告法红线，一律不写）：
- 医疗功效类：治疗 / 根治 / 疗效 / 抗癌 / 消炎 / 杀菌(无证) / 排毒 / 速效 / 抑制 ××病 …
- 绝对化用语：最 / 第一 / 顶级 / 唯一 / 100% / 国家级 / 世界级 / 永久 / 绝对 / 史上 …
- 虚假承诺：包治 / 三天见效 / 立刻变白 / 永不反弹 …
- 替换策略：用"帮助""更""不少人反馈""上脸清爽"等柔性、主观化表达替代。

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

5.5 KiB Raw Blame History Unescape Escape