Communitygithub.com

動態預檢品質保證

針對動態圖像、AI 生成影片(HyperFrames、Remotion、HTML/GSAP)和短影音社交廣告(Instagram Reels、TikTok、YouTube Shorts、LinkedIn)進行自動化的渲染前與渲染後品質保證。審查編解碼器、像素格式 (yuv420p)、faststart 串流標誌、EBU R128 音量 (-14 LUFS / -1 dBTP)、死黑片段,生成 6 幀平台安全區 QA 對照表,並產出可供交付的母版 MP4。

動態預檢品質保證 是什麼?

Motion Preflight QA 是一個確定性的廣播與社交平台品質閘道,專門用於程式碼渲染的動態圖像與短影音廣告。它透過一個八道關卡的技術審查,自動檢測常見的渲染問題,如錯誤的編解碼器、不支援的像素格式(會導致 QuickTime 或 Instagram 黑畫面)、缺少 faststart 標誌(造成行動裝置延遲)、音量不符標準以及意外的黑片段。該工具支援 Instagram Reels、TikTok、YouTube Shorts、LinkedIn 等主流平台,並提供平台專屬的安全區域疊層,確保標題和 CTA 不會被 UI 元素遮擋。如果審查發現問題,它還能執行自動修復,包括修正像素格式、添加 faststart、進行 EBU R128 音量正規化以及位元率最佳化,最終產出可交付的母版檔案。整個工作流程只需 Python 3.9+ 標準函式庫與 FFmpeg/FFprobe,無需第三方套件,適合整合進 CI/CD 或自動化渲染管線。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shk2005/motion-preflight-qa/tree/HEAD

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

動態預檢品質保證 是做什麼的?

針對程式碼渲染的動態圖像與短影音廣告的確定性廣播與社交平台品質閘道。旨在消除盲目重新渲染、裁切字幕、靜音/壓縮音訊以及 iOS/QuickTime 播放錯誤。

先決條件

  • Python 3.9+(僅使用標準函式庫 — 無需第三方 Python 套件)
  • FFmpeg 與 FFprobe 需位於 PATH 環境變數中

標準品質保證工作流程(每次交付前執行)

步驟 1:審查渲染完成的影片

針對目標平台(reels、tiktok、shorts、youtube、linkedin、square 或 auto)執行八道關卡的技術審查:

python3 scripts/audit_video.py path/to/video.mp4 --platform reels

若需串接自動化管線,請使用 --json 取得機器可讀的輸出。

審查項目:

  1. 容器與編解碼器: H.264 (libx264) 或 HEVC MP4 相容性。
  2. 像素格式 (yuv420p): 捕捉 yuv444p / 10-bit 輸出,這類輸出會在 QuickTime、Safari 和 Instagram iOS 上顯示為黑畫面。
  3. Web Faststart (moov 在 mdat 之前): 驗證是否可實現即時漸進式行動播放,無緩衝延遲。
  4. 長寬比與解析度: 檢查是否符合目標平台尺寸(例如 9:16 直式為 1080x1920)。
  5. 影格率一致性: 驗證為乾淨的標準 FPS(24、30、60 或 120),並標記非標準的可變影格率。
  6. 開頭片段完整性(黑畫面掃描): 標記任何死黑開場(開頭 > 0.25 秒)或影片中途的意外黑畫面。
  7. 音量 (EBU R128): 測量整合音量(I,單位 LUFS)與真實峰值(TP,單位 dBTP),對照社交平台標準 -14 LUFS / -1.0 dBTP。
  8. 檔案大小與位元率預算: 標記過大的底片顆粒輸出,這類輸出會觸發平台積極的重壓縮。

步驟 2:生成安全區對照表

生成一張 6 幀的視覺證明表,以半透明紅色標記像素精準的平台 HUD 危險區域,並以綠色線條勾勒出標題安全區:

python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png

檢查 qa_contact_sheet.png(以視覺或圖片讀取工具):

  • 紅色區域 = UI 危險區域(頂部頁首、右側按讚/留言/分享列、底部字幕/音訊抽屜)。
  • 綠色框線 = 標題安全區域。 任何觸及紅色區域的標題、數據、產品標語或 CTA,都必須在交付前重新定位。
  • 若要檢視單一問題時間點的完整解析度畫面,請加上參數 --at <秒數> --out proof_frame.png。

步驟 3:自動產出交付母版(若任何技術檢查出現警告或失敗)

修正像素格式、注入 +faststart、套用兩次 EBU R128 音量正規化(-14 LUFS、-1.0 dBTP),並乾淨地最佳化位元率:

python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20

對於重底片顆粒或雜亂背景,請使用 --crf 23 以縮小檔案大小,同時保持字體清晰。然後在母版檔案上重新執行步驟 1,以確認達到 100/100 通過。

參考文件

  • references/platform-safe-zones.md — 2026 年精確的 Instagram Reels、TikTok、YouTube Shorts、LinkedIn 及 16:9 寬螢幕安全區座標與像素邊距。
  • references/delivery-specs.md — 編解碼器、色彩空間、音量、位元率及常見的程式碼轉影片故障排除方法。

相關技能