錯題集索引（症狀 → 修法位置）
規則：每條坑修復並經人眼驗收後立案。修法有專業 skill 歸屬的寫進該 skill、此處只留指針；無專屬歸屬的（工程工作流/渲染管線類）允許行記憶體短修法（查坑時一眼到修法，免二跳），但超過五行須落到專業文件再改回指針。本文件不超 150 行，超了先把最長的行內修法搬家。
同族導航（先定家族再查條目，防在近親條目間來回跳）：
- 渲染卡死/掛起/消失族：先跑
render-service.cjs起跑自檢（2026-07-24 起自動攔 #37 public 體積、#38 簽名掛死、chrome 打不開自動兜底系統 Chrome）；自檢過了還掛 → 按 #23 並發死鎖 → #25 dataless → #26 harness 回收 → #24 npm 壞包排查。 - QC 假陽族：#29 幽靈盒（null 門控）/ #31 冷啟動字體虛胖（qcAllow 豁免）/ #32 Place 盒撐高（目視判假放行）；QC 報「零違規」先看覆蓋率（#35）。
| # | 類別 | 症狀 | 修法位置 |
|---|---|---|---|
| 01 | 畫面渲染 | 中文靜默變宋體 / 時好時壞 | remotion-design-system §6 #01（fonts.ts + FontGuard） |
| 02 | 工程工作流 | remotion still 輸出 ○，改代碼後圖不變 | remotion-design-system §6 #02 |
| 03 | 工程工作流 | 縮略對比圖誤判字體細節 | remotion-design-system §6 #03 |
| 04 | 畫面渲染 | JSX 屬性裡 \uXXXX 按字面顯示（如 icon="✅"） | remotion-design-system §6 #04 |
| 05 | 設計語言 | 組件自繪佔位復刻「感覺差不少」 | remotion-design-system §0 鐵律 4（真素材為主體） |
| 06 | 畫面渲染 | backgroundClip:text 漸變字出圖發暗 | remotion-design-system §6 #06（純色+textShadow） |
| 07 | 設計語言 | 純平色塊/純平黑底/假 logo 顯廉價 | remotion-design-system references/texture.md（果凍塊+glow+暗角+真 logo） |
| 08 | 導出 | 成片 MG 文字邊緣暈影/塗抹，「加了 MG 畫質變差」 | remotion-design-system §6 #08（jpeg100+crf15 固化 config） |
| 34 | 設計審美 | 用戶說「不高級 / 粗糙 / 像失誤 / 不自然 / 不連貫 / 不絲滑」 | design-system references/motion.md「絲滑感五律」——歸因表：①預鋪骨架（未講到的結構提前顯形）②為避讓把連續物切碎③邊界穿過或懸空留縫（>2px 即斷開）④等速運動無減速停靠⑤狀態瞬時整體突變。逐條對號入座，禁憑感覺調參數；改一條注意別踩另一條（0722-01 修「線不穿圓」時踩了「切碎」+「露骨架」，返工兩輪） |
| 09 | 工程工作流 | 長渲染中途消失 / mp4 殘片 / pgrep 誤判進程還活著 | remotion-design-system §6 #09（nohup 脫離 + 認日誌 + 行） |
| 10 | 長片裝配 | 畫面裸奔/長時間靜止、MG 全縮左區沒氣勢 | remotion-design-system references/layout.md（takeover/主角時刻）+ remotion-assembly references/rhythm.md（密度審計） |
| 11 | 音效 | 全片無聲效 / 音效被埋聽不見 / 響度不達標 | remotion-assembly references/audio.md（音量規範+母帶 loudnorm） |
| 12 | 長片裝配 | 元素進場後一動不動顯死板 / 章節一幀硬切消失 | remotion-design-system references/motion.md（Breathe + useExit 退場紀律） |
| 13 | 設計語言 | 亮背景上文字發灰不可讀（裸字壓白板） | remotion-design-system §0 鐵律 5 + references/texture.md |
| 14 | 長片裝配 | 左上角標頭/眉線疊字 | remotion-design-system references/layout.md（標頭互斥佔位） |
| 15 | 字幕 | 字幕詞內斷裂 / 英文碎片 / 無底襯 | remotion-assembly references/subtitle.md（語義斷句+底襯箱+校驗腳本） |
| 16 | 素材抓取 | 手繪復刻產品畫面「怎麼調都差很遠」 | remotion-assembly references/broll.md §0 總綱（合成器不是繪圖板；素材四級+採集剪輯管線） |
| 17 | 長片裝配 | AI 自查說很像、用戶一看差很遠（靜幀盲區/目測縮水） | remotion-assembly SKILL §2.5 分段工坊（先測量後寫碼+用戶動態終審） |
| 18 | 素材抓取 | 素材段像「貼片」融不進正片 | remotion-assembly references/broll.md 管線第 5 步（調色統一層） |
| 19 | 動畫時序 | 全片入場拖沓像 PPT / 動效時長與設計不符 | remotion-design-system references/motion.md §0（幀數按 60fps 口徑寫而合成是 30fps，先秒後幀換算） |
| 20 | 設計語言 | 裝配尺寸「怎麼調都比參考小」 | remotion-design-system references/specs.md（先查規格表再寫碼，禁止目測） |
| 21 | 音效 | 音效廉價感/發虛，合成與參考片採樣兩路全被否 | remotion-assembly references/audio.md 規則 8（正解=專業音效庫：剪映緩存盤庫→@remotion/sfx→Mixkit→CC0→商用包；質感必須用戶過試聽板挑編號，AI 只能篩頻譜硬傷） |
| 22 | 工程工作流 | 試聽板/拼接視頻越往後音畫對不上 | remotion-sfx SKILL §2 拼接鐵律（禁 -c copy 拼接與 -shortest：段長微差累積成漂移，必須鎖死等長+整條重編碼） |
| 23 | 工程工作流 | 渲染莫名掛起/逾時，反覆重試反覆掛 | 同項目渲染禁並發（預警雷區「並發崩」實錘）：多會話/孤兒進程互撞死鎖。診斷=ps -o etime,pcpu（etime 超預期數倍+持續 0% CPU=僵死，殺）；工具逾時只殺 bash 會留孤兒 node 連環撞，渲染必須 nohup 真後台+認日誌 + 行（錯題 #09 同族）；起渲前先查場，但查場模式必須防自匹配：`pgrep -f "remotion render |
| 24 | 工程工作流 | 渲染報 Named export not found/plugin is not a function 等包內部錯 | npm 並發安裝可致包損壞（多會話同時 npm i / 進程互殺中斷寫盤）：症狀=require 返回空導出、依賴樹內部 TypeError；修法=壞包 rm -rf node_modules/<包>+npm cache clean --force+重裝，多處腐壞直接 rm -rf node_modules && npm ci（先把 node_modules/.remotion 瀏覽器二進制挪出保住再刪）；紀律=同項目同時只允許一個會話動 npm |
| 25 | 工程工作流 | 渲染永久卡在 Bundling 固定百分比、進程樹全 0% CPU、換 Node/重裝依賴都無效 | 素材文件被同步盤驅逐成 dataless 空殼（2026-07-16 血案：第三方同步 App 卸載時把 747MB 主素材驅逐，bundle 複製 public/ 讀文件永久阻塞，全晚渲染連環掛）。診斷=ls -lO public/** 看 dataless 標誌；修復=從原件/下載源恢復實體（brctl 對已卸載 provider 無效）；預防=素材入庫驗真加查 dataless（broll.md 2b）、項目不放同步盤管理目錄。變體（2026-07-28，iCloud 驅逐 node_modules）：CLI/Studio 啟動即 0% CPU 靜默掛死、連版本號都打不出（「優化 Mac 存儲」驅逐依賴文件，@remotion 包內近萬 dataless，require 逐文件等雲端下載）；修法=依賴重裝進 node_modules.nosync/ 實體目錄+同名軟鏈（*.nosync 命名 iCloud 不同步，根治復發）；舊目錄必須移出項目樹（進 ../.trash/）——改名留在項目內會被 Studio watcher 遞歸掃描、二次掛死 |
| 26 | 工程工作流 | 渲染進程隨子代理/agent 回合結束「憑空消失」，既非並發死鎖（#23）也非長渲染中途斷（#09） | 子代理回合一結束，harness 會回收它在前台或未完全脫離的子進程鏈→渲染半途被殺留殘片。修法屬 #09 族：起渲必須完全脫離父 shell（nohup + run_in_background/setsid、重定向所有 fd），判完成只認日誌 +/尾行不認 agent 是否還活著；子代理內起長渲染尤其致命（回合邊界＝進程死期），必要時拆「本回合起渲脫離 → 下回合認日誌」兩步 |
| 27 | 工程工作流 | 渲染服務 .mjs/ESM 入口 import '@remotion/renderer' 報 does not provide an export named 'Fragment' | package.json 無 type:module 時用 ESM 入口加載 renderer 會觸發其 ESM 構建的 react/jsx-runtime 互操作斷裂（Node 24 實錘）；修法=服務腳本改 .cjs + require 走 CommonJS 構建繞開（證據：scripts/render-service.cjs 頂注） |
| 28 | 工程工作流 | <Sequence layout="none" premountFor={N}> 過 tsc 報 premountFor 不存在/類型不匹配 | Remotion SequenceProps 是判別聯合：premountFor 只在預設/layout:"absolute-fill" 分支（AbsoluteFillLayout）合法，{layout:"none"} 分支無此屬性（類型見 node_modules/remotion Sequence.d.ts 的 LayoutAndStyle）。修法=要 premount 的媒體必須包在默認佈局 Sequence 裡（不寫 layout 或寫 absolute-fill）；需 layout="none" 定位時把該媒體單獨嵌一層默認佈局 Sequence 承接預掛載。承官方雷區 ③（premountFor）實操衍生 |
| 29 | 工程工作流 | QC 探針報「幽靈重疊」假陽：當幀該元素肉眼根本看不見 | QC 探針（src/design/qc.tsx）逐幀對 [data-qc] 取 getBoundingClientRect 判重疊；元素不可見期若仍掛在 DOM（非標準隱藏或全不透明但視覺已讓位），rect 照樣在→報假重疊（seg05 S5Appear 命中）。探針側只過濾 opacity<0.15 與 w/h<3，佔位型幽靈擋不住。修法=元素不可見期組件直接 return null（null 門控法），無節點即無 rect；防重疊佔位規則詳見 remotion-design-system references/layout.md §10.5。另一變體（Place 盒撐高）已單列 #32，修法以 #32 為準 |
| 30 | 工程工作流 | Bash 寫的文件「命令成功」但轉眼消失 / Read 看不見剛生成的文件 / 渲完的成片 ls 不存在 | 新會話默認沙箱執行：未授權的 Bash 寫入落在沙箱臨時副本、命令結束即蒸發（0719-01 測試實錘：字幕數據、18 個 Scene、590MB 成片全部蒸發，只有 Write 工具寫的 3 個文件存活）；經 /tmp 軟鏈路徑寫項目會加劇重定向。修法=開工前必過 assembly SKILL §0.5 第 0 步環境自檢，不過即停、讓用戶授權 Bash/編輯權限後再開工；禁止軟鏈繞中路徑（路徑整體加雙引號即可）、禁止 dangerouslyDisableSandbox 自救、禁止把項目複製到 /tmp 幹活；文件產物一律優先用 Write 工具寫 |
| 31 | 工程工作流 | QC 僅在段首幾幀報重疊、目視無疊（常見 sub-zh × 卡框） | 冷啟動首幾幀字體未加載、文字盒按回退字體測量虛胖上撐，rect 相交屬測量假陽（0715-01 seg03 與 0715-02 S04 兩次實錘，#29 幽靈家族變體）。修法=目視核清後 qcAllow 白名單豁免該元素對（其餘斷言保留），勿為幾幀假陽改佈局 |
| 32 | 工程工作流 | 全片 QC 報大批 place@72,* 左區盒重疊、渲幀目視元素並不疊 | 分頁式/編組左區 Place 盒 bounding 高於視覺內容（容器撐高），盒相交≠視覺相交（0715-02 全片 QC 15 類違規抽查全為此類）。修法=渲幀目視判假後放行；根治=Place 盒高度貼實際內容或該組掛 qcAllow；sub-clearance 越淨空線另判真偽，不在此列 |
| 33 | 畫面渲染/導出 | 成片某段人物/視頻凍成靜幀、原片同段在動（4K 鋪底多發）；肉眼看是「人物不動」，但 md5/mpdecimate 查不出 | 4K 鋪底 OffthreadVideo 渲染時解碼卡頓吐重複幀（疊加複雜 SVG 動畫段更易觸發）→ 轉 1080p H264 鋪底源（合成本就 1080p，4K 純浪費還拖垮解碼），主組件改引 1080p 源重渲即解。診斷必用 ffmpeg -vf freezedetect=n=-50dB:d=0.3——md5 全不同 ≠ 畫面在動（靜止幀的壓縮噪聲也讓每幀 md5 不同，會騙人）、mpdecimate 同樣被噪聲干擾不可靠，只有 freezedetect 有噪聲容差才準；素材接管段（人物退場、素材卡本身靜止）報 freeze 屬正常、非 bug（0721-01 實錘：63-69s 人物段凍幀，4K→1080p 源後 freezedetect 零凍結）。附：交付編碼建議 -bf 0 -g 30 -movflags +faststart 提升播放器兼容（Remotion 默認大量 B 幀，部分播放器 seek 時解碼卡頓） |
| 34 | 畫面渲染 | 素材段成片卡內大面積純黑/死黑條/空玻璃、只剩邊緣一條豎條；佔位與真素材都會中招；渲後自審還容易漏（抽幀點沒落在素材在場窗口） | OffthreadVideo「超大盒 style width + objectFit/translate」裁切寫法渲染端 width 不生效→內容按卡寬渲染再被位移截斷（0721-01 六段實錘：S02/S06/S07/S10/S13/S16，唯一正確的 S14 用「video 100% 鋪卡 + transform scale 過沖」）。修法與渲後驗收閘＝remotion-assembly references/broll.md 規則 12 |
| 35 | 工程工作流 | 集成員/QC 報「全片零違規」但實際有大量重疊——假過閘 | QC 探針（src/design/qc.tsx）掛在每個 Scene 內、只在該段幀範圍跑；Scene 漏掛 <QcProbe/>（只聲明 qc?:boolean 卻不消費）→ 該段無任何斷言→ summary 乾淨屬假過閘（0722-01 血案：20 段僅 1 段掛探針，報零違規實則 8 類真違規）。修法已固化：探針每幀發覆蓋心跳 QC{hb:1,n}，render-service.cjs qc 核「覆蓋幀數/渲染幀數」，<90% 或全程 0 元素 → 判 [FAIL] 覆蓋不足 而非「零違規」。紀律：「零違規」必須能區分「測了沒問題」與「根本沒測」；生產模式集成階段先跑一小段 qc 確認覆蓋率達標再全片。補（2026-07-24 審查發現）：探針必須根掛載（裝配根 {qc ? <QcProbe/> : null}，如 Koubo072101/072201）——Scene 內掛載時 useCurrentFrame 經 Sequence 返回局部幀（0 起算），心跳幀號與全局幀範圍錯位：全片/跨段 QC 覆蓋率會假 FAIL（各段局部幀互相重疊、去重後 ≪ 總幀數），單段漏掛也可能被鄰段局部幀掩成假 PASS；render-service 已加幀號範圍過濾，但全局覆蓋只有根掛載能保證。單段 QC 短跑測不出這個坑——驗護欄要用會觸發失敗的场景測（跨段範圍/故意摘一個探針），別只測正常段 |
| 36 | 設計語言 | 左區信息 MG 文字糊在亮背景上近乎不可讀，scrim 像沒生效 | InfoScrim（src/design/InfoScrim.tsx）漸變默認從左透明→右壓暗，只壓右側；信息 MG 放左側的片（用戶裁定左信息）→ 左區 MG 全程裸露在最亮區（白櫃/亮牆）無襯底（0722-01 實錘；0715-02 曾撞同坑但只在單段就地打補丁、底座缺口未補）。修法=InfoScrim 加 side 參數（默認 'right' 兼容舊片），信息在左的片傳 side="left"。教訓：底座缺陷補底座或立案，禁只在單段打補丁——就地補丁＝把坑留給下一片 |
| 37 | 工程工作流 | 渲染卡在 Bundling 出不來，copyfile ... ETIMEDOUT，進程活著但無輸出 | public/footage/ 堆多片舊素材（0722-01 時 2GB/6 片），Remotion bundle 每次把整個 public/ 複製進臨時目錄→copyfile 逾時（與 #25 dataless 區分：這是體積/複製耗時，文件本身實體存在）。修法=只保留當前片素材在 public/footage/，其餘移到 ../footage-hold/（2GB→466MB，bundle 從卡死→1.8s）。紀律：修復措施交付後別無腦回滾——回滾前問「這片還要再渲嗎」（0722-01 同坑因交付後移回素材踩了兩次） |
| 38 | 工程工作流 | 任何碰文件的進程永久掛起、kill -9 無效、UE 殭屍越堆越多；重裝依賴/換 Node 全無效 | macOS 代碼簽名校驗守護進程（amfid/syspolicyd）掛死→需簽名校驗的二進制無法 exec（與 #25 dataless、#37 體積、#23 死鎖均不同，是系統級）。診斷法：ffprobe -version（系統）正常但 node_modules/@remotion/compositor-darwin-arm64/ffprobe -version 永久掛住 = 簽名卡死；`ps -axo pid,stat,comm |
| 39 | 素材抓取 | Grok 圖生視頻三類翻車：默認低分辨率 736×400 放大糊 / 元素自己變形增生(morph) / 特定構圖被強行「填補」 | ① 分辨率：不顯式提就走默認 736×400（2.6x 放大糊掉 halftone/裁切邊）——指令必寫死 720p(1280×720)，實測 4/4 命中；CLI resolution_name 只有 480p/720p 兩檔、請求 1080p 會回退（2026-07-24 實測），1080p 須走 xAI API（grok-imagine-video-1.5）或換工具。② morph 增生：齒輪長大/日曆多格/圓環碎裂——prompt 末尾追加針對該條易崩元素的鎖定約束（「保持單個原尺寸禁增生」「格數顏色不變」「圓環連續不斷線」）。③ 硬性補全：「稀疏元素+大片空背景+空心人形+露臉碎片」觸發模型填滿空地、填實空洞、長出完整人臉（14 號跑 6 版全崩）——不要繼續加禁令，去改觸發它的輸入構圖（碎片鋪滿/負空間用描邊界定/去掉露臉碎片，改完一次跑通）。gbro headless 調用還需 --always-approve --permission-mode bypassPermissions --max-turns 10 才觸發視頻工具。詳見 remotion-broll SKILL「AI 生成拼貼 B-roll」節 |
| 40 | 畫面渲染 | 名牌小圓頭像看著歪、金環內露背景楔形，CSS 調角度越調越歪 | 禁在小圓裁窗內用 CSS rotate+偏移修頭像歪——旋轉繞 img 中心、可視窗又偏離中心，兩者疊加放大歪感且旋出露邊（0724-01 兩輪才修對）。正解=離線烘圖：PIL 把形象照回正（±幾度）後裁「臉居中的正方形」存資產，NamePlate avatarImgStyle 用 100%/left:0/top:0 滿窗直貼；全局資產 public/assets/author-avatar.png 已備，直接引用 |
| 41 | 工程工作流 | render-service segment 全片渲報 frame range 0-N is not inbetween 0-(N-1) | segment/splice 的起止參數是含界幀號：全片＝0 (durationInFrames-1)（1355 幀合成傳 0 1354），照抄 durationInFrames 必報錯 |
| 42 | 設計語言 | 用戶說字幕「不夠好看」但說不出哪裡不對 | 先查英文行是不是用中文字體渲的——中文字體的拉丁字形只是補齊用，字寬字距全錯，是「說不出哪裡怪」的頭號來源（BilingualSub 舊版 en 行用 FONT.zh 渲染，2026-07-26 實錘）。修法＝英文行必須用比例西文字體 FONT.subEn（Inter）；順帶查中文行字重，字幕層用 FONT.subZh（PingFang SC）400 細體，別用包裝層的 700。判斷字體質感必須 1:1 裁局部看，縮略圖看不出來（同 #03）；改版前先出多檔同幀對照讓用戶挑，別自己賭一檔 |
| 43 | 長片裝配 | qc-master 零 FAIL 零 WARN，用戶卻說「質感差特別多 / 動效越來越醜 / 字幕跟 skill 說的不一樣」 | 技術驗收查「片子有沒有壞」，不查「片子有沒有用上底座」——兩件事，別拿前者的綠燈當後者的證明。0727-01 實錘：25 段自建 324 行 _kit.tsx 重造卡片、動效只有 quad 淡入位移 0、design/motion 零引用、25 段只有 8 段做了退場，字幕 77 條 en 全空退化成單行中文；qc-master 全 PASS 照放。修法＝裝配 ⓪ 閘 node scripts/check-scenes.mjs src/koubo/scenes-<片名>（motion 零引用 / 零退場件即 FAIL）+ check-subs.mjs 的 en 缺失檢查，兩道都在寫碼後起渲前跑。診斷順序：先查缺了什麼手法，再查參數對不對——check-scenes 一條命令能看出是不是在重造輪子，但它只覆蓋「底座沒用上」這一種醜法；配色/節奏/字體/構圖各有各的真源（typography/rhythm/#42/layout），別把單條路徑當萬能診斷。⚠️ 附帶教訓：當時 check-subs 命令參數傳錯（傳片名而非文件路徑）報了 ENOENT，看到報錯直接往下走，於是行首懸掛單字、超寬 16.5 字兩條也一起漏了——校驗腳本報錯 ≠ 校驗通過，跑不起來就是沒跑 |
分類參考（按基準片體系預留）：畫面渲染 / 動畫時序 / Studio 本地運行 / 導出 / 音效 / 素材抓取 / 長片裝配 / 設計語言 / 工程工作流。
預警雷區（錯題目錄 44 條，2026-07-16 用戶提供截圖）
規矩：這裡是雷區地圖不是錯題——只有症狀名、無修法、我們多數未踩。命中任何一條後：修復+人眼驗收，再升級為上表正式編號。已與我們既有錯題對上號的，直接標了歸屬。
| 類別 | 的坑（原文） | 我們的狀態 |
|---|---|---|
| 畫面渲染 | LOGO 頻閃 / 視頻靜幀 / 透明 ProRes 黑邊 / 動效鎖死左上 / 圖片拉伸 / 網頁 chrome / 人臉遮擋 / 撞字幕 / Emoji / Logo 黑吃黑 | 已有對應：撞字幕=#14 疊字；Emoji=#04+圖標規範（lucide 真圖標）；人臉遮擋=三區人物禁入（layout.md）；Logo 黑吃黑=logo dark/light 雙版本規範（texture.md）。其餘 6 條未踩，警惕：視頻靜幀（OffthreadVideo 卡幀）、圖片拉伸（objectFit）、網頁 chrome（截圖帶瀏覽器邊框上卡） |
| 動畫/時序 | Phase 索引漏 break / 動效對不上口播 / spring overshoot | 已有對應：動效對不上口播=§2.5 詞級對齊+主視覺對 SRT；spring overshoot=motion.md §11 禁止項。Phase 索引漏 break 未踩（switch 分支漏寫類問題） |
| Studio/本地運行 | Studio 秒退（SIGPIPE）/ EMFILE 句柄爆 / staticBase hash 過期 / HEVC 黑屏 / id 下劃線 / Studio+still 並發崩 | 全部未踩。警惕兩條高概率：HEVC 黑屏（iPhone 錄屏素材是 HEVC，入庫先轉 H.264）、Studio+still 並發崩（開著 Studio 時跑 still/render 可能撞車——我們工作流常並發，中招了別先懷疑代碼） |
| 導出 | C 盤爆盤 / OOM / 畫質糊 / 渲染慢 / Encoded 誤判 | 已有對應：畫質糊=#08（jpeg100+crf15）；Encoded 誤判=#09 完成判據只認日誌 + 行（同類：日誌字樣≠成功）。OOM/渲染慢未踩（長片 4K 時警惕並發幀數） |
| 音效 | impact-heavy 滿全片 / 群組各配 whoosh / 音在前動在後 | 已有對應：impact-heavy 滿全片=audio.md 重錘 SFX 全片 ≤2 處（用戶否決開場 whoosh 同源教訓）；群組各配 whoosh=連擊應逐 item 輕 pop 而非每組一記重音。「音在前動在後」未踩，存疑待核（疑指 SFX 幀與動效幀錯位的時序規矩，命中時再定義） |
| 素材抓取 | yt-dlp 403 / fetch 不走代理 / Wikimedia GFW / Firefox cookie / PNG 實是 HTML | 部分已有：yt-dlp 採集管線在 broll.md（我們下載 Lovable 未遇 403，遇到時先加 cookie/UA/代理三件套）。「PNG 實是 HTML」典型坑：下載的"圖片"其實是防盜鏈返回的 HTML 頁——入庫前 file 命令驗真，這條直接採納為素材管線固定步驟 |
| 長片裝配 | 章節沒呼吸口 / Host 卡↔Chip 撞 | 已有對應：章節沒呼吸口=motion.md §1/§2 章間淨屏；Host 卡↔Chip 撞=layout.md 規則 9 互斥佔位（同類疊壓） |
| 設計語言 | 不復刻 House Style / kicker overclaim / 長寬比沒算 / 字幕復讀 | 不復刻 House Style=我們整個 design-system 的存在理由。kicker overclaim（kicker 文案誇大到口播沒說的程度）、長寬比沒算（素材變形）、字幕復讀（字幕與 MG 文字重複念同句）三條未踩——字幕復讀警惕：我們判詞 chip 與 Stamp 不重複的裁決是同一原理 |
| 官方雷區（remotion-dev/skills 明文，2026-07-16 對照產出，詳見 docs/官方skills對照.md） | ① CSS transition/animation/Tailwind 動畫類=渲染必壞（官方 FORBIDDEN，派 codex 寫碼最易混入）② ffmpeg 裁剪不重編碼=片頭凍幀（基準片「視頻靜幀」成因之一，-c copy 裁剪禁用）③ 含媒體的 Sequence 不加 premountFor=首幀卡頓/黑幀 ④ @remotion/transitions 吃總時長（兩景交疊，SRT 硬對齊體系會全片錯位）⑤ fetch 外部數據不包 delayRender=渲出空幀 | ①②④⑤未踩，寫碼前置檢查項；③ premountFor 已按規採用（Scene06 防首幀黑）→ 實操衍生新坑 #28（premountFor 與 layout='none' 類型互斥） |
| 工程工作流 | 修改範圍擴大 / 字號<48px / 自動跑 4K render | 修改範圍擴大=分段工坊「只渲該段/只改該段」紀律的反面教材；字號<48px（1080p 下小於 48px 的正文觀眾讀不到，與 specs.md 最小說明字 20-22px 需區分場景：他指的應是信息主體）；自動跑 4K render（未經確認自動起大渲染燒機器）——這條直接採納為紀律：渲染只按用戶/方案確認的範圍起 |