START_HERE.md｜全局主交接合約【強制優先讀取】

一、三層文檔體系

1. START_HERE.md：全局硬性規則，常駐讀取，所有任務必須遵守。不存放試錯經驗、技巧、坑點。
2. task_xxxx.md（放 tasks/）：單任務子交接卡。每一獨立任務一份；只寫本次目標、素材、參數、輸出規格、專屬步驟。
3. knowledge_base.md：共用知識庫。存放所有模型經驗、有效技巧、踩坑清單、提示詞範本。不一次性全部載入；僅按需載入對應章節片段，屬參考，優先級最低。

二、上下文載入規則（防止遺忘，最重要）

• 固定讀取順序：① START_HERE → ② 本次 task_xxxx → ③ 按需檢索 knowledge_base 對應章節。
• 單次載入總 token：安全線 5000、警戒線 8000；預估超過必須拆任務。
• START_HERE ≤ 2500 繁體字；task 子卡 ≤ 1500 繁體字，超長即拆分任務。
• 知識庫可無限累積，但禁止全文載入上下文。
• 衝突判定：START_HERE > task 子卡 > knowledge_base（知識庫僅參考，不覆蓋硬規則）。

三、任務拆分判斷

• 可放同一 task 子卡（多子工序）：共用同一組核心設定、單一最終成品、工序前後有依賴。
• 必須拆獨立任務（各自 task 卡）：成品不同、使用不同模型/管線、成果可獨立交付、可單獨重試失敗步驟。
• 長任務執行中，階段性歸檔已完成步驟日誌、清理舊對話，避免上下文持續膨脹。

四、Worker／ComfyUI 資源排程（硬性）

1. 僅維持單一常駐 ComfyUI 實例，固定 port 8188。Worker 禁止任何開啟／關閉／重啟指令；除非人工維護，Comfy 全程常駐。目的：消除 CUDA 殘留程序、VRAM 殘留佔用、多實例資源搶占卡死。
2. Worker 不可直接呼叫 Comfy API 提交 prompt。全部影片生成任務提交至中央外部排程佇列。
3. 中央排程器持續監控 Comfy queue／GPU/VRAM 狀態；僅 Comfy 空閒才取出下一筆送入。Comfy 內建 Queue 一次執行一項 GPU 任務；H3／Wan2.2／LTX 工作流可混排 FIFO，支援任務優先級。
4. VRAM 管理：連續同模型批次→模型保留在 VRAM 不卸載，省載入時間；跨大模型切換（H3↔Wan2.2）→當前任務跑完主動卸載再載入下一模型。Comfy 啟動保留 --reserve-vram 預留防 OOM。
5. Worker 職責邊界：只做前置（讀交接卡、提示詞擴寫、備工作流 JSON、備參考圖）＋後處理（影片拼接、SRT、浮水印、R2 上傳、HTML Gallery）；GPU 生成全交由中央排程器派送。

五、提示詞擴寫流水線規則（前置於 Comfy，Worker 層執行）

禁止在 Comfy 工作流內掛 LLM 擴寫節點，避免與影片模型搶 VRAM。

1. 擴寫在 Worker 階段：任務送進佇列之前完成提示詞優化。
2. 多模型分層：普通 B-roll 空鏡→本地 Ollama Z-Image-Engineer-V6；多數普通鏡頭→DeepSeek V4 Flash（兩階段：擴寫→自檢校驗），temperature 固定 0.2~0.3；高優先鎖臉特寫／關鍵主鏡→Claude Sonnet（兩階段擴寫+校驗）。
3. 擴寫強制約束：原始人物長相、臉部特徵、服裝、場景、動作禁止修改；僅補鏡頭、光影、材質、動態細節；禁止新增原需求沒有的角色與劇情；輸出連續敘事文字，不用大量 tag；每 3–5 秒鏡段落輸出 ≥600 字描述。
4. 兩階段流程：階段 1 將鏡頭構想擴寫為符合 H3 規格長提示詞；階段 2 審稿校驗，檢查擅自改人物設定、新增角色，有違規則修正，無違規直接原文輸出。
5. System Prompt 放入成功成品 few-shot 範例，引導固定寫作風格。

六、檔案存放與命名、版本規則

1. 路徑：D:\短劇流水線\。START_HERE、README、knowledge_base 放根目錄；task 子卡放 tasks\task_xxxx.md。
2. 版本命名：軟體_特色_4位全局連續流水號；流水號唯一來源 VERSIONS.md。
3. 成品與工作流分別存入對應版本資料夾；媒體檔優先存 D 槽，避免 C 槽耗盡。臨時一次性檔用完即刪；可重複利用、低頻素材搬 D 槽歸檔。
4. 交付：媒體成果上傳 Cloudflare R2，製作手機可直接點擊播放的靜態 HTML Gallery，附表格清單（編號｜名稱｜模型｜播放連結）。

七、VRAM 自動釋放規則

ComfyUI／IndexTTS 等佔 VRAM 服務，任務閒置超過 10 分鐘未使用 GPU/VRAM 即自動釋放顯存；任務執行中則常駐保留。

八、額度管控規則

任何消耗平台 API 額度 >0.5% 的生成，必須先回報預估消耗比例與數量，取得同意後才執行；低於 0.5% 可直接執行。

九、字幕與浮水印規則

輸出影片需生成繁體 SRT 字幕；影片加上 OHIYOYO 浮水印。

十、本文件維護規則

START_HERE 只修改底層硬體、架構、強制流程規則。新增技巧、踩坑經驗一律寫入 knowledge_base，不新增到主交接卡。產線接續斷點由對應 task 子卡與 VERSIONS.md 管理；歷史交接內容備份於 D:\任務交接備份_20261018\。