Seedance 分镜脚本器
Overview
把一段短剧/剧情类文案，转化为可直接送进 Seedance 系列视频模型生成的分镜交付物：每个镜头配一条按 Seedance 提示词公式写就的提示词、一套人物三视图定妆参考（供 I2V 首帧复用）、以及 Markdown 分镜表 + JSON + Excel 三格式产物。核心目标是「提示词最匹配 Seedance」——遵循其镜头语言强响应、单镜头单运动、anchor phrase 一致性、显式 Motion 清单、防变形约束等特性。
何时使用
- 用户给一段文案/剧本，要求「拆分镜」「做分镜表」「出 Seedance 提示词」。
- 用户做短剧二创、剧情短片，需要角色跨镜头一致性方案与定妆参考。
- 用户需要把分镜导出为 JSON 接入生成流水线，同时保留可读的分镜表。
工作流
严格按以下顺序执行：
1. 解析文案与戏剧结构
- 识别文案类型（本 skill 面向短剧/剧情类）。
- 提取戏剧节拍：钩子 → 铺垫 → 冲突 → 反转 → 高潮 → 结局。
- 估算总时长与目标节奏；确定画幅（默认 9:16 竖屏）、分辨率（默认 1080p）。
2. 拆分分镜
- 按戏剧节拍拆成镜头；单镜头时长建议 5–10s，Seedance 单条上限约 12s（部分版本到 15s），超长需切镜或首尾帧衔接。
- 为每个镜头标注：镜号、时长、时间码、节拍、画面描述。
3. 为每个分镜写 Seedance 提示词
套用公式（详见 references/seedance_prompt_guide.md）：
主体(anchor phrase) + 动作(Motion 清单) + 场景 + 镜头语言 + 光线氛围 + 风格 + 质量/防变形约束
关键规则：
- 主体用固定 anchor phrase，且逐镜逐字复用同一措辞（见一致性）。
- 动作写成可见动词 + 显式
Motion:清单（如Motion: subtle handheld drift, hair shifts, fingers fidget）。 - 镜头语言：单镜头只选一种运动（push-in / pull-back / pan / orbit / tracking / crane / handheld / static），配标准景别（extreme wide → extreme close-up）。
- 避免抽象形容词堆砌（"stunning, cinematic, 8K masterpiece" 无效），每个词都要指向可见/可听内容。
- 不加负向提示词（"no blurry hands" 无效），改描述想要的样子。
- 末尾加质量与防变形约束：
4K, face clearly visible, no deformation, stable framing, no flicker。
4. 运镜与转场 / 衔接
- 多镜头用转场标记：Pro 用
lens switch，Lite 用cut to。 - 衔接处：把上一镜尾帧作为下一镜首帧（I2V），并在该分镜标注
ivf_first_frame来源；衔接点避免运动模糊/快速形变。 - 一条提示词只描述一个连续时刻；场景切换 = 分开生成。
5. 生成人物三视图定妆参考
- 为核心角色各出正面/侧面/背面三视图定妆图提示词（Seedance 文生图/图生图），锁定：服装颜色、发型、核心道具、肤色、体型、年龄感。
- 三视图提示词写入
characters[].three_view，并在角色出场/关键分镜的ivf_first_frame中引用对应视图，保证跨镜头一致性。 - 定妆提示词模板见
references/seedance_prompt_guide.md的「三视图定妆」。
6. 产出三格式
- 先写出 spec JSON（见
references/storyboard_schema.md的字段定义与示例）。 - 运行脚本一次性生成 Markdown 分镜表 + 规范化 JSON + Excel 分镜表：
bash
python scripts/build_storyboard.py --input <spec.json> --out-dir <dir>
- Excel 含三张 sheet：总览 / 人物定妆 / 分镜表，表头带样式、自动换行、冻结首行、可筛选，便于直接在表格里审阅与批量填字。
- 若无需 Excel，加
--no-excel跳过；脚本会自动安装openpyxl（缺失时）。 - 若脚本校验报错，按提示修正 spec 后重跑。
7. 自检清单（交付前必过）
- [ ] 每个角色的 anchor phrase 在所有分镜中逐字一致（近义词也会触发重新生成）。
- [ ] 单镜头仅一种镜头运动；多镜头有转场标记。
- [ ] 无抽象形容词堆砌、无负向提示词、无矛盾要求（如「超高速 + 极致稳定」）。
- [ ] 时长分配合理，单镜 ≤ 12s。
- [ ] 含人物三视图定妆；关键分镜标注了 I2V 首帧来源。
- [ ] 音频/对白栏已填，且跨镜衔接处无打断角色对白的剪辑点（用户强关注项）。
- [ ] 每镜含成本/备注提示。
资源
references/seedance_prompt_guide.md— Seedance 提示词公式、镜头词汇表、景别、Motion 清单、anchor phrase、防变形、多镜头转场、I2V、三视图定妆模板。references/storyboard_schema.md— spec JSON 字段定义 + 完整示例（可直接改写的模板）。scripts/build_storyboard.py— 由 spec JSON 生成 Markdown 分镜表、规范化 JSON 与 Excel 分镜表（依赖openpyxl，缺失时自动安装）。
