TK-koubo-video-V1.1
TK 口播影片工作流程 V1.1：基於 FredTalk 2.1，新增 B-roll 靜圖管線（請參閱 B-roll 靜圖規劃）；每期標準流程請見倉庫根目錄
AGENTS.md。原版fred-remotion-output保留為備份。
元件來源與下載存取
下載或發佈元件時，請閱讀元件下載存取。對於下載的官方來源 ZIP，預設使用 python3 scripts/assets.py import --zip <local-path>；無需設定 Token。自動 Token 下載為選用。如果此工作空間缺少公開匯入工具，請使用獨立的最新公開版本；請勿強制拉取或覆寫擁有者生產來源。公開預覽版與原始碼可用性為分開的；在選取可執行元件前，請先確認已安裝的原始碼。
公開版使用本倉庫的元件資料、獨立原始碼及按清單下載的通用素材。元件檢索、逐段 Top3 比較和整期重複比較共享同一當前目錄；不讀取作者私人目錄、錄音、背景音樂或機器綁定。瀏覽和檢索無需 API Key。
先驗收元件，再交付建議或關鍵幀
2026-10-03 Fred 確認：Remotion 畫面只能準確複用已認可元件，或基於已認可元件二創。預設禁止脫離元件庫原創。 只有當次明確授權原創才可例外；「直接輸出」「不用等我確認」不等於原創授權。此規則涵蓋歷史資料中「沒有合適參考可原創」的舊預設。
2026-10-13 Fred 確認：預設允許「場景級定製」。 113、114 期能做到 90–95 分，靠的是為本期內容重寫場景，而不是把元件原樣串起來。「二創」的範圍據此明確為：
- 預設允許：每段場景程式碼為本期重寫；把已認可元件拆開，只取它的動作、物件關係或幾何，改時序、刪掉它自帶的開場和收尾，為接縫重新銜接；多個元件的動作組合成一段。底層（kit 的字型、顏色、陰影、緩動、游標、字幕、角標、音效、座標對映）必須照用，不手寫近似值。每個場景檔案第一行註解寫明動作來自哪個元件。
- 仍然禁止：純大字頁、通用範本、找不到任何來源動作的新視覺風格、違反 DESIGN.md 的寫法。這些仍需當次授權。
- 公共元件入庫仍需 Fred 認可。本期場景只服務本期；同類需求再次出現，才按新做元件流程提煉成公共元件。
- 怎樣做出這種品質請見整期編排第 0 節。
給出逐段建議前、交付真實關鍵幀前，必須分別通過元件庫交付門禁。先檢索並看準確參考，再選型和實現；不先寫通用範本、後補參考編號。二創要保留可辨認的核心構圖、物件關係或動作邏輯，不能只藉字型/顏色/圓角。沒有合適元件就報告「待選元件」及缺口，不擅自退成原創文字頁。
驗收由助手內部完成，不新增 Fred 審批。建議檢查真實候選和表達匹配；關鍵幀另檢查來源原始碼→本期函式→真實呼叫→輸出畫面。兩階段均記錄具體審看結論與當前檔案證據；技術可用不替代視覺驗收。library_gate.py 未 PASS 不得交付對應建議或關鍵幀；公共生成器自動攔截，自訂前端和聊天建議也必須執行同一門禁。真實錄影/圖片/已有影片、B-roll 獨立流程、固定字幕角標及明確錄影佔位不受原創限制，但不能用這些類別掩蓋新 Remotion 設計。舊成片不追溯改造；今後重新出建議/關鍵幀時按當前實際範圍驗收，不重新整理舊認可。
把逐字稿講清楚，延續 Fred 已認可的動畫品質。先判斷當前階段，只讀該階段與當前場景資料；完整說明和歷史規則留到審計/維護時看。
正文元件/正文文字動效、專案 Remotion 技術參考與舊 Deck 總編排已收為內部模組，不再作為獨立日常製作入口。只用一份當前 Manifest 和同一前端；復刻、雲端渲染保持獨立。視覺庫與製作檢索共用六類製作用途、多用途標籤和獨立來源篩選。references.py --use explain --source ep107 可按任務與來源檢索；單場景包帶出實際輸入、動作、原片時長與適配範圍。前端預設先看視覺庫；字型與字階綁定真實字型與職責。先核對準確影片、介面及依賴，再保留本期需要的完整動作。
每段先看候選，再定畫面
Codex/助手常見問題是只用熟悉的兩三個元件、或直接寫大字頁。每個需要畫面的段落按下面順序做，不跳步：
- 在 Manifest 寫
componentPlan.query：本段畫面裡看得見的物件和動作（例如「兩個工具價格並排對比、數字落定」），不是照抄旁白。 - 執行
scene.py --manifest <path> --scene-id <id> --candidates-only：給出按畫面描述檢索的 5 個候選，以及按旁白檢索的narrationCandidates。同類型不足時會跨類型補位並標註sameSceneType。 - 逐個看候選的準確影片或核心幀（
references.py --id <id> --full），再按內容決定。前 3 個候選必須在componentPlan.candidates記錄selected/rejected和具體理由；library_gate.py --stage suggestion會重算並攔截漏記。原創授權段也要先比較。 - 候選都不合適：先換個說法再查（拆成物件＋動作、換
--use），仍沒有就報告缺口，不退成純大字頁。
按內容先查哪裡（起點，不是固定搭配）：
| 口播在講 | 先試 |
|---|---|
| 一句結論、關鍵詞 | --query 關鍵詞 一句話；多篇新聞反覆出現同一個詞用 NMC01 |
| 列舉幾個要點、能力 | --query 要點 列表、--query 卡片 分類 |
| 步驟、流程、因果、架構 | --query 流程 步驟、--query 分支 關係 |
| 兩者對比、以前和現在 | --query 對比 區別、--query 版本 |
| 輸入提示詞、聊天、回覆 | INT03（Codex 操作）、INT04（可編輯微信）、CAM04；--query 輸入 發送 |
| 截圖或文章裡的某句話 | INT01（螢光筆）、INT02（遮罩聚焦）；--use recording-focus |
| 真實錄影操作 | CAM01–CAM05、--use video-entry；全螢幕播放用預設大播放元件 |
| 作品、多圖、結果圖 | --use images |
| 數字、價格、圖表 | --use data、--query 資料 增長；這類元件很少，沒有合適的就如實報告缺口 |
| 章節、轉場、下一段 | --use handoff、--query 轉場 |
預設協作順序
稿件/可選錄音 → 助手逐段圖文建議 → Fred 選方向 → 真實元件關鍵幀 → Fred 提意見並確認 → 助手內部檢查動態 → 完整影片 → 按意見局部返修。
- 第一版頁面就給有內容的建議：這句準備怎樣講、為什麼適合、參考圖片或可播放片段。能用準確庫元件表達時先展示真實效果；需要新構圖才生分鏡圖，不把空白設計任務交回 Fred。
- 方向確定後先實現足以渲染的真實元件，用本期文字/媒體和適用的角標/字幕出關鍵幀。關鍵幀用於改排版、主次、尺度、可讀性和遮擋；隨後內部看短動畫、聲音與接縫，再出完整影片。預設不額外等待一輪使用者動態樣片批准。
- 同一前端持續展示建議、關鍵幀與影片，保留版本和意見。預設用公共審看範本的初始化/更新/啟動腳本，只換本期 Manifest 和媒體；音訊模組沿用音訊 Skill 公共台，不逐期重寫頁面。
assets/review-example-ep108/START.py可直接開啟 108 期前 7 段 61.47 秒真實內容範例，含口播、字幕、關鍵幀及影片；它是可替換的範例資料，非固定每期畫面方案。數量由內容決定，不固定九宮格、140 張、元件配額或切鏡頻率。完整工作方式和欄位請見路線、關鍵幀與確認。 - 已有明確方向/關鍵幀確認不重複問；局部返修只處理受影響內容。當前直出授權可覆蓋使用者審看步驟，記錄真實來源與未審看範圍；內部技術檢查和必要動態檢查仍執行，不把輸出授權寫成樣片認可。出關鍵幀還是直接出片，按 Fred 當次要求執行，不額外提醒或勸阻（2026-10-12 Fred 明確）；沒有說明時按上面的預設順序先出關鍵幀。
- 把元件串成整期（分段工程、錄影包裝、段間交接表、全片去重、強調方式、渲染前動態自檢）按整期編排執行。給寫分段程式的子任務的簡報必須帶上它的第 2–7 節和本期交接表。工程結構直接用整期骨架（時間軸、段外殼、交接幾何、分塊渲染、音訊和 BGM、推前端）；交付前按整期編排第 12 節檢查。
把使用者要求帶到每個實際鏡頭
元件適配的共享字型、全文原位強調及媒體接替請見複用圖譜。scene.py 會帶出本段 componentAdaptation，實施前核對同組字階、內容職責、全文檢查狀態和物件級保護；準確參數來自當前內容，不固定單期字型大小、行數或元件組合。
使用者已給出的鏡頭、文字、材質和保留要求是當前執行輸入，不要求使用者每期再寫一篇詳細提示詞。先按製作預設值存入同一 Manifest 的 designContract 與受影響場景；實現時用 scene.py --manifest ... --scene-id ... 讀取，確認整片要求、當前動作、素材和角標一起到達。修方向時同步更新舊動作描述，不能只改圖片或版本號。
動作實現與返修按具體狀態檢查核對連續軌跡、內容就緒再擴容、真實閱讀視窗和同載體交接；版式已成立時優先按口播交換焦點，不自動重做版面配置。靜態通過、技術通過和動態認可仍分別記錄。
備料按全稿的資訊職責區分現成效果範例、本期講解素材與實際操作證據；返修按已認可的維度保護準確版本。「在上面基礎上加遮罩／元件」按實際末態交接繼承媒體、捲動和相機狀態，不重新開場。
需要委派或從短指令接手時使用製作執行摘要，填入本期路徑、當前授權和保留範圍；它引用當前事實源，不新增一套審批。代表鏡頭要驗證「與要求和參考相比是否保住表達與質感」，技術 PASS 不能替代這一步。
完整影片的 BGM 預設
完整成片預設按背景音樂執行：Fred 本機使用已調好音量的私人音樂，從 0 秒開始、內部選段補足長度，原聲欣賞區間靜音且音樂時鐘繼續，整片混音一次再封裝。正常 BGM 軌線性音量 1，不再次降分貝；最終匯流排按實際 AAC 峰值必要保護。本機綁定及音樂實體不分發、不自動上傳；他人用 --bgm 自備音樂，仍可使用同樣的延長/靜音/混音能力。已經含 BGM 的成片和剪映回傳音軌不重複新增，單獨口播與元件診斷不預設加音樂。執行入口為 scripts/bgm.py，能力套件由 scripts/package_bgm.py 生成。
固定配音與整期元件分配
Fred 後續自己的每期完整影片預設在自然斷點複用一次 Skill／元件庫過渡配音：只固定音訊，動畫每期更換，使用 Fred 當期提供或指定的畫面，不自動複用 109 期動畫。新稿錄音正文不再重複這四句；從 manifest 讀取當前純配音的真實取樣時長，與當期動畫安排時間軸（當前 5.540 秒，舊 6.016 秒混音只留歷史），字幕樣式和畫面銜接按當期要求處理。本期已有相同配音時不重複加，不固定舊影片的 362 幀或插入鏡號。插入前核對純配音/動畫 SFX 混音身份，整條及內部各句響度按音訊 Skill 檢查，必要時只做本期局部匹配，不疊加舊處理。
建議前同時做整期元件分配檢查，不能只驗收單鏡頭。library_gate.py 的 suggestion 階段已攔截缺少具體整期比較的重複組；保留連續物件、同職責外殼和有意呼應，不用次數配額強行換差的元件。相似但不同來源仍需實際視覺總覽。
始終保留
全部已認可元件集合（library 復刻、各期精選、新增精選、互動元件、3D 運鏡、新聞快閃等）的編號、說明與入庫/發佈記錄統一請見元件集合索引。預設檢索已覆蓋全部集合，不需要逐個記住集合名。
- 最新使用者要求優先。鎖定原文和實際素材；無錄音可估時構思，最終錄音/SRT 到位後更新受影響動作、字幕和音效，不能只換音軌。沒有最終錄音時只做到關鍵幀，不出整片；時長不夠時加元件或剪短，不用慢推、定格湊時長。
- 只有一份當前 Manifest，
pages/stableId記錄語義段。場景資料帶入已選方向、實現模式、當前素材、反饋、保留範圍和相鄰交接。製作/審看/交付各自綁定準確版本。 - 按設計語言適配已認可元件，允許場景級定製（見開頭「先驗收元件」一節）；全新視覺風格須 Fred 當次明確授權。視覺、排版、字型、動效、呈現、音效、內容的固定值請見 DESIGN.md 第 2 節，程式碼層統一用
templates/component-kit的 kit，不在各場景手寫近似值。元件能力先查複用圖譜。先決定觀眾要理解的變化，再選元件。完整成熟模組適合就直接複用，保留實際動作關係、字階、幾何和質感，不能只掛參考 ID 或複製一個膠囊。無準確方案先報告缺口，不自動原創。實現模式和歸因請見從內容到元件。 - 後續 16:9 主影片全螢幕/大窗播放預設實際呼叫 108 期大播放元件：4K 視窗 3600×2027.11、圓角 48、陰影
0 32px 50px #0002，1080 邏輯舞台用半值，避免二次縮放。當前明確覆蓋和其他用途按對應職責處理。FredTalk 橫版講解的解釋動畫沿用固定右上角品牌層，按局部背景選既有版本；錄影、實拍作為主內容播放時不疊加右上角角標；Fred 人物 B-roll 動畫全螢幕播放時加角標（2026-10-12 Fred 明確；版本按 fred-remakecorner-branding.md核對）。混合場景按實際播放區間顯隱，不能在整片最外層無條件掛品牌層。需要燒錄字幕時複用得意黑模組，關鍵幀階段就帶入；關鍵前景在字幕實際視窗內避讓。單獨交付的純 B-roll、其他畫幅與當前例外按原範圍處理。 - 預設獨立 16:9，1080p 預覽、4K60 正式；當前規格與已認可工程優先。按已授權方式本地/雲端渲染。估時、靜態認可、動態檢查、使用者認可、技術通過分別記錄。保護非目標畫面、音軌和素材，不自動上傳、付費或對外發送。燒錄字幕小改只重渲受影響 cue 及必要接縫，再合併；豆包工作的擬人代詞用「她」，按真實指代核對。
當前做什麼，就從哪裡進入
| 當前工作 | 讀取與執行 |
|---|---|
| 已有音訊＋SRT＋稿件，只做粗剪/字幕糾錯 | 先用音訊和字幕粗剪，完成全篇長字幕、句內重說與停頓檢查，按音訊工作流程核對真峰值、剪輯/字幕聯動與新舊源時間對齊；本次已處理錄音按要求只剪輯，不自動進入整片製作 |
| 接稿、提整組圖文建議 | 路線與確認、首次新設計讀設計語言與字型職責，再按製作預設值和拆稿安排；讀全文理解責任與承接，不通讀整庫 |
| 為場景規劃 / 生成 B-roll 靜圖 | B-roll 靜圖規劃：觸發條件、加多少、三種形態、素材來源、prompt 規範、QA 清單 |
| 開始當前場景 | 先 scene.py --manifest <path> --scene-id <stableId> --candidates-only 選元件，再去掉 --candidates-only 讀完整場景套件（決定、字型、相鄰首尾）；首次類型選擇用 scene.py --list |
| 找準確元件與依賴 | references.py --query <物件與動作> --limit 5（可加 --scene-type、--use）；同分按來源批次輪轉；集合清單見元件集合索引；使用與視覺庫同源的用途標籤，查看 matching 理由；排序是候選相關度，仍核對真實動作、容量、cue 和介面。首次建工程讀依賴和實現 |
| 新做可複用元件（Fred 當次授權） | 新做元件流程：component_kit.py new/add 建工程，lint、sheet 自查，cloud-script 雲渲，preview 交 Fred 挑，intake 入庫；固定規則請見 DESIGN.md 第 2 節，品質標杆是 T05c |
| 現有元件表達不了、需要探索 | 探索、分鏡圖；若呼叫 ChatGPT Pro，按Pro 分鏡探索與 Remotion 復刻記錄 prompt、會話、hash、認可範圍。已選多狀態/九宮格先按口播取捨，再實現持續物件、動作與閱讀；可用動作規劃範本寫回當前 Manifest；已選方向不擅自替換 |
| 產出真實關鍵幀供 Fred 看 | 路線與確認及審看片；帶實際最長文字、字幕、品牌、運動中間態和接縫前後 |
| 設計物件讓位/文字呈現 | 物件過渡或文字呈現；按需查 T/W 局部動作 |
| 處理具體 Remotion 技術或維護既有 Deck | 內部模組；固定本期 runtime，按問題讀取技術 rules；Deck 點擊/比例等合約只在明確維護或重現既有 Deck 時適用 |
| 參考 library 原片編排鏡頭 | library 鏡頭語言；先定觀看任務和物件來源/去向，再查對應原片區間與元件 |
| 編排錄影或其他任務給的生成影片 | 先按整期編排的錄影包裝規則（可讀、鏡頭跟隨、互動演出、純捲動≤2 秒）；主影片全螢幕播放先用預設大播放元件；媒體與遮罩及路線文件的外部影片交接；保留媒體身份、時鐘、聲音和首尾 |
| 內部檢查動作/聲音/連續性 | 內容與質感審看、音效、scene.py --stage joining；渲染分段後跑 scripts/motion_audit.py 查慢推、純捲動和定格，見整期編排 |
| 渲染、下載、完整交付 | 渲染與交付和階段門禁；此時讀雲端執行和最終檔案檢查 |
| 局部返修 | scene.py --stage revision＋受影響場景；同時讀備註與結論，不能把「可用但要改」當整段批准 |
| 使用者要求沉澱 | 維護；只提取可複用判斷，保留本期修法與長期偏好的邊界 |
執行工具和檢查邊界
新一期在當前 Manifest 設定 workflow.profile: fred-video-v2、workflow.componentMatching: v1。按選型到呼叫記錄場景 componentPlan，實際選型與 referenceChoices 一致，實現時用 callSite.callee 綁定本期適配函式；語法呼叫檢查後仍對照真實輸出。使用者方向和關鍵幀記錄按路線文件儲存，舊片限改不補造新欄位。生產階段仍為 planning → implementation → representative → formal：實現前規劃檢查；真實關鍵幀確認與短動畫內部檢查後進入代表鏡頭門；最後校驗實際最終檔案。具體指令只在階段門禁維護，舊片不為採用新工作方式而整片重規劃。
sceneGuide 記錄類型、實際附加項及本場景決定/檢查。類型選擇依據要解釋的內容；人物、裝置、關係線、毛玻璃按需加入，不是佈局範本。品牌與字幕根設定會隨場景資料傳入，字幕規則僅在實際啟用時讀取。
原文/時序檢查用 validate_storyboard.py --require-scene-guides --require-production-contract；工作方式檢查用 workflow.py；技術門禁不能判美觀，參考檔案存在不能證明動作被使用，靜幀不能證明中間動態順暢。對照當前真實畫面和所選源片的對應區間，具體評估內容、可讀性、動作、質感與交接。
專案依賴只用本地 skills/ 實體。新工程在本期 03_製作過程/remotion/<version>/，最終唯一檔案在 02_最終輸出/，更新當前交付入口。凍結硬連結先複製再適配。B-roll 素材生成、復刻、雲端渲染繼續承擔專項職責，舊 Deck 流程不自動成為創意前置。
素材來源和媒體替換按視覺庫素材來源核對，不能用本機路徑、改名或舊取捨代替來源與新輸出驗收。