/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— 新系列初始化模板