README｜短劇流水線 - 文檔閱讀規範
用途：所有 Agent／Worker 開啟新任務時，優先讀取本 README，理解整套三層文檔架構、讀取順序、優先級、載入限制，再往下讀對應文件。
整體架構簡介
整套系統分成三份核心文件＋一份任務模板，分工明確：
- ✅ 把強制硬規則壓縮精簡，保證模型能完整讀懂、遵從
- ✅ 大量經驗、坑點、技巧放到知識庫，按需檢索，不常駐上下文，避免長上下文注意力衰減
- ✅ 每個獨立工作任務使用專屬 task 子交接卡，定義本次任務目標、素材、參數、步驟
| 文件 | 存放位置 | 性質 | 是否常駐上下文 | 內容範圍 |
|---|
| README.md | 根目錄 | 閱讀導讀（本文） | ✅ 每次任務必載入 | 本表＋標準讀取流程＋載入限制 |
| START_HERE.md | 根目錄 | 全局硬性合約（最高優先級） | ✅ 每次任務必載入 | 系統架構、資源排程、命名、VRAM、額度、交付等不可違反規則。<br>❌ 不寫案例、技巧、踩坑經驗 |
| task_xxxx.md | tasks/ 資料夾 | 單任務子交接卡 | ✅ 每次任務必載入 | 本次任務目標、素材路徑、指定模型、執行步驟、驗收標準、失敗處理。僅屬當前任務，各自獨立 |
| knowledge_base.md | 根目錄 | 共用知識庫（最低優先級） | ❌ 不一次性全部載入 | 模型特性、踩坑避坑、有效技巧、提示詞範例、過往測試經驗。只有用到對應場景，才提取對應章節片段 |
新任務啟動 標準讀取流程（強制）
- 第一步：讀取
README.md，確認文檔架構規則 - 第二步：讀取
START_HERE.md（全局硬規則，最高優先，不可違反） - 第三步：讀取本次任務
task_xxxx.md（子交接卡，本任務專屬設定） - 第四步：判斷需要哪些知識 → 按需檢索／載入
knowledge_base.md 對應章節；不相關章節直接跳過，不載入。
載入順序不可調換；規則衝突判定：START_HERE > task 子交接卡 > knowledge_base.md。知識庫僅供參考，不能覆蓋硬性規則。
上下文載入限制（核心防護，避免長文健忘）
- START_HERE.md 嚴格維持 ≤2500 繁體字
- 單份 task 子交接卡嚴格維持 ≤1500 繁體字，過長就拆分任務
- 一次載入總文字安全上限 5000 token，警戒線 8000 token；預估超過必須拆分工序／任務
- knowledge_base.md 無總字數上限，但禁止全文載入到對話上下文，只能片段按需提取
文檔更新維護規則
- 修改 START_HERE.md：只有系統架構、硬體資源、全局流程發生重大變更才更新；新增技巧／踩坑一律寫入 knowledge_base，不要塞進 START_HERE。
- 新增經驗、踩坑、模型測試心得：統一歸類寫入 knowledge_base.md，標註適用模型與場景；過時內容標註【已過時】保留記錄，不要直接刪除。
- task 子交接卡：一個任務對應一份，任務結束後歸檔保留，不覆蓋舊 task 檔；新任務複製模板建立新 task 檔。
- VERSIONS.md：維持全局唯一流水號，管控所有輸出成品與工作流版本命名。
資源與任務排程簡要摘要（快速回憶用，細節看 START_HERE）
- ComfyUI：單一常駐實例，port 8188，Worker 不可隨意開關重啟。所有影片任務先送中央佇列，排程器控制送入 Comfy。
- 提示詞擴寫：在 Worker 前置完成，禁止 Comfy 內掛 LLM 擴寫節點，避免 VRAM 衝突。分三層模型策略：本地 Ollama／DeepSeek Flash／Claude Sonnet。
- VRAM：閒置超過 10 分鐘自動釋放；同模型連續批次保留模型，跨大模型切換時卸載釋放顯存。
- 額度：API 消耗預估 >0.5%，必須先請示同意再執行。
成品交付簡要規範
影片輸出：繁體 SRT 字幕 + OHIYOYO 浮水印；成品上傳 Cloudflare R2，生成手機可直接預覽的 HTML Gallery，附清單表格（編號｜名稱｜模型｜播放連結）。