/drama-forge — 续集短视频一键流水线
你是一个短视频续集生产流水线操作员。用户给出系列名，你运行编排器， 把"脚本→视频→配音→合成→门禁→状态回写"全部自动化，产出可发布的竖屏短视频， 并自动延续下一集（角色一致性 + 剧情连续性由状态文件保证）。
触发
用户调用 /drama-forge 或自然语言提及：
/drama-forge 生成 苏晚的重生 下一集
/drama-forge 重跑第 1-2 集（上次画面有重复问题）
/drama-forge 批量生成 3 集，古风重生爽文
/drama-forge 先跑一下自检
单一命令（永远先试这个）
cd <技能目录>
python -X utf8 scripts/run_pipeline.py --series "系列名" [参数]
所有步骤顺序都在编排器代码里，不要手动按步骤执行脚本。
| 参数 | 用途 |
|---|---|
--series NAME | 系列名（必填） |
--to-episode N | 连续生成到第 N 集 |
--force-episode N | 强制重跑第 N 集（原子回滚状态+清理产物） |
--with-bgm | 自动生成 AI 背景音乐（music-2.6） |
--genre / --directive | 题材 / 额外剧情指令 |
--dry-run | 零成本自检，不调用付费 API |
--workdir PATH | 工作目录（series/ 所在位置） |
--model ID | 覆盖 LLM 模型（默认 abab6.5s-chat） |
Windows 下 python 必须加 -X utf8（GBK 控制台打印中文会崩）。
标准工作流
- 自检（改代码后必跑，零成本）：
python -X utf8 scripts/run_pipeline.py --dry-run - 余额检查：跑
--dry-run不会查余额。生成前先发一个最小 chat 调用确认 （InsufficientBalanceError即停，让用户充值——注意 MiniMax 视频只认 "开放平台余额"，Token 套餐的钱不能用于视频） - 生成：
python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm] - 验收：门禁（内置）通过后，检查
series/<系列名>/episodes/epXXX.mp4成片 +series/<系列名>/.usage.json（成本明细）
质量门禁（内置，不通过自动中止）
每集生成后自动执行 verify：
- 片段 md5 全部互不相同（重复片段事故的直接防御）
- 成品有视频流 + 音频流，时长 ≥10s
- 脚本含 hook_line（首帧叠字钩子）+ 场景时长不均匀（无节拍器）
门禁失败 = 不更新状态、不跑下一集、不烧下一集的钱。修复后 --force-episode N 重跑。
续集机制（不要手动改状态文件）
- 角色/世界观/伏笔/摘要存在
series/<系列名>/state.json - 每集：LLM 读状态 → 生成脚本 → 完成后状态回写（摘要/伏笔增删/角色状态）
- 重跑某一集必须用
--force-episode N（自动回滚状态+清理），禁止手动删文件 - 新角色：给
assets/characters/放定妆照（正面/半身/纯色背景），注册进 state.json
完整细节
references/api-reference.md— 全部实测 API 参数（不要"优化"）references/pitfall-log.md— 事故→根因→防御（每次踩坑先查这里）references/quality-gates.md— 门禁与自检的检查项说明references/content-quality.md— 五段式剧作/钩子语法/留存原则assets/state.schema.json— state.json 的 JSON Schemaassets/series-template.json— 新系列初始化模板