Media
ffmpeg, TTS and video rendering pitfalls.
ffmpeg -shortest 會把輸出截到「較短」那條軌，不是「對齊」
hyperframes 影片 render 完後用 ffmpeg 做 grading + 換音軌，成品時長比原始 render 短了好幾秒，結尾卡片（ending-screen 淡入的「CASE CLOSED」畫面）整段消失，觀眾完全看不到。拿掉 -shortest。
ffmpeg -loop 1 的預設輸入幀率是 25，zoompan 的 fps 救不回來
用 ffmpeg 把一組靜照剪成 30fps 的直式短影片，每一顆鏡頭指定停留秒數（hold），十二顆接起來應該是 30.0 秒。這又是同一個形狀：失敗的樣子跟成功的樣子一模一樣。
hyperframes render 多 worker 會在 worker 邊界掉幀
用 npx hyperframes render（預設 4 workers）渲染一支 109 秒的直式影片，成品在 27.3s 與 81.8s 各出現約 0.3 秒的黑閃——背景圖整片消失，但疊在上面的 HUD、對話框、角色立繪都還在。沒有 worker 邊界就沒有這個問題。
edge-tts 連續呼叫偶爾回傳空音檔（NoAudioReceived），要加重試機制
用 edge-tts 套件在同一支腳本裡連續生成多段 TTS（例如逐句念旁白、要合併成一支完整音檔）時，導致整個批次中斷。單獨把出錯的那段文字抽出來測試（同樣的 voice/rate/pitch），完全正常生成，證明不是文字內容或參數的問題。