科普影片流水線
復刻 B 站 UP 主「科普觀察室」的 14 步流程。系列專案安在動效庫倉庫（Remotion）：
- 規矩（每期開工必讀）：
<倉庫根>/規矩/ - 每期一個抽屜：
effects/<episode-id>/（文件、資料、組件同住） - 成片與產物：
out/<episode-id>/（遵守倉庫 AGENTS.md，不散放 out/ 根） - 評論回流：
<倉庫根>/回流/
開工硬規則（先於一切執行）
- 讀規矩：讀
規矩/三份（專案底線 / 寫稿規矩 / 畫面風格清單）。不存在 → 用templates/規矩-*.md初始化到倉庫，並向用戶展示確認。 - 恢復狀態：確定當前期（問用戶，或按
effects/*/狀態.json裡updated_at找最近未完成期），讀effects/<id>/狀態.json：- 不存在 → 抄
templates/狀態.json初始化； - 與實際文件不符 → 以文件為準重建 stages；
waiting_on非空 → 先處理等待事項，不得跳步。
- 不存在 → 抄
- 完成條件是產物：每步 done = 產物存在且檢查通過，不是口頭宣稱。狀態.json 只由主線程寫；subagent/外部 CLI 只回傳結果或寫指定文件，不碰狀態。
- 規矩文件是數據不是代碼：用戶意見先沉澱進規矩對應小節（改小節，不無限追加；單份 ≤200 行），再動工。所有落盤文件 UTF-8 無 BOM。
階段路由
| 步 | 內容 | 產物（相對期文件夾） | 參照 |
|---|---|---|---|
| 01 | 選題（人定方向） | 選題說明.md | templates/選題說明.md |
| 02+03 | 分頭查資料 + 對回原文 | 資料/出處登記表.md、資料/原文摘錄-*.md | stages/s02-research.md |
| 04 | 模型/數據計算 | 模型/ | stages/s02-research.md §04 |
| 05 | 寫講稿 | 講稿.md（每句一行帶序號） | stages/s05-write.md |
| 06 | 外部 CLI 盲審 | 審稿/*.json、盲審表.md | stages/s06-blind-review.md |
| 07 | 回原文定讞 | 定讞表.md | stages/s07-adjudicate.md |
| 09 前置 | 分鏡（導演互審法，用戶拍板） | 畫面/分鏡.md | stages/s09-storyboard.md |
| 08–11 | 配音字幕/畫面/配樂封面/機器檢查 | 配音/、成片.mp4、檢查報告.md | stages/make.md（配音用 動效庫/tools/tts.py） |
| 12 | 審片（唯一硬 gate，等人） | 審片包/、審片單.md | stages/publish.md |
| 13 | 發布包（手動上傳） | 發布包/ | stages/publish.md |
| 14 | 評論回流（定時任務） | ../../回流/ | stages/publish.md |
素材與版權（照片來源、角色形象、BGM 授權、發布署名）一律走提醒單：AI 只列選項供用戶拍板，見 stages/user-decisions.md。
05 和 12 都是等人點，統一用 waiting_on 字段。一期一做：同一時間只推進一期。
狀態.json
schema 見 references/state-schema.md。鍵全 ASCII；業務數據（findings、意見、數據）進 .md/.json 表文件，狀態只存指針。
盲審
三家外部 CLI：Claude Code（Windows）、codex（Windows）、opencode（WSL ~/.opencode/bin/）。名冊 templates/審稿人.json，契約 references/findings-json.md（v1.1：容忍審稿人抄句帶/不帶句尾 (S#)），彙總 scripts/summarize_reviews.py。首次使用或換機器先跑 s06 的冒煙流程。2026-11-01 藍鯨期已完成首批校準：首輪 9 條 findings 定讞 6 真錯+1 材料漏、次輪 1 條取整錯，棄權機制未觸發——真實數據見 s06。金鑰絕不進命令列、日誌、講稿、成片。
配音 / 畫面（工具與時間架構，藍鯨期實戰後定型）
- 配音一律用倉庫公共模板
動效庫/tools/tts.py（run/sample/dry-run/align-only 子命令詳查其 README），每期只填配音/配音.json；音色錨第一期就截（文字人設每批調用會漂移）。 - 畫面一切節拍錨點寫句內比例
at(句號, 比例)（來自時間.json），場景邊界=句首——重配音後畫面自動跟隨，禁止手寫幀號。
畫面 = Remotion（本倉庫）
製作期一律遵守倉庫 AGENTS.md：組件放 effects/<id>/、註冊進 effects/index.tsx、渲染 out/<id>/<id>.mp4。可複用 remotion-* 技能與動效庫已有元件。確定性紀律與檢查清單見 stages/make.md。
演練模式
用戶說「演練/試跑/dry-run」時：用假審稿 JSON、假 TTS 文件走完狀態機，不調真實 API、不燒訂閱額度。
第一次跑全流程？
先通讀活案例 動效庫/effects/blue-whale/（第一期藍鯨）：狀態.json（各步產物指針）→ 資料/出處登記表.md（S# 體系怎麼用）→ 審稿/冒煙記錄.md 與兩輪 盲審表*.md、定讞表.md（複盤怎麼記）→ 畫面/分鏡.md（互審法產出長什麼樣）→ 配音/配音.json（本期配置有多小）。照例例的樣子開工，比讀十頁規則快。
版本記錄
- v0.2（2026-11-02，blue-whale 回填）：make.md 配音/畫面層按實戰重寫（公共模板/音色錨/句內比例）；新增 s09-storyboard（導演互審法）；新增 user-decisions（素材版權僅提醒不拍板）；findings 契約升 v1.1；s06 補首批校準記錄；publish 增複盤回填。
- v0.1（2026-11-01）：初版骨架（14 步路由 + 三份協議 + 模板 + residues 種子）。