Communitygithub.com

終檢:成片發出前逐項品檢

影片發布前的檢查:格式、黑格或凍格、響度、真峰值,再產出一張影格縮圖讓你過目。提交任何動態分鏡或終版之前都用它。

終檢:成片發出前逐項品檢 是什麼?

發表影片配方第 3 步(交付檢查),來自 GTKottman/mortiflix-oss(2026-10-05 發布)。qc.mjs 依需求核對尺寸、影格率與長度(誤差 5% 內),檢查響度(網頁預設 -14 LUFS)與真峰值(-1 dBTP),黑格或凍格段直接判定失敗,除非是刻意設計的停留(--end-hold、--allow-black)。輸出 JSON 報告和約每秒一格的縮圖表。接著是人工那一半:掃過縮圖、在最繁忙的三個時刻看全尺寸畫面、完整聽一遍。另附兩階段 ffmpeg loudnorm 修正響度的做法。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GTKottman/mortiflix-oss/tree/HEAD/pipelines/_shared/skills/final-pass

在你喜歡的 AI 中提問

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

說明文件

Final pass

分為兩個部分,兩者皆為必要:腳本檢查機器能檢查的項目,而您則查看機器無法檢查的部分。

1. 執行檢查

node .claude/skills/final-pass/qc.mjs out/final.mp4 --size 1920x1080 --fps 30 --duration 60
  • --size、--fps、--duration 來自需求簡報(形狀、長度)。持續時間允許 5% 的誤差。
  • 響度:--lufs -14(網路預設值)和 --true-peak -1。僅在需求簡報指定了具有其他目標的平台時才更改這些值。
  • --end-hold 用於影片設計為以靜止畫面結束的情況(例如一個會定格的標誌):該片段將被判定為通過,並會回報其長度。任何其他位置的凍結片段仍會判定為失敗。
  • --allow-black 僅在影片中段設計為黑屏時使用(例如章節之間的淡黑)。請在檢查備註中說明原因。
  • 它會寫入 checks/qc-<name>.json 和 checks/<name>-sheet.png,並在有任何 FAIL 時以狀態碼 1 退出。

請修正所有 FAIL 並重新執行。凍結片段可能是一個設計好的停留畫面:如果是,則判定為通過,並且檢查的備註會說明是哪個停留畫面。

2. 視覺檢查

  1. 幀圖。 查看 checks/<name>-sheet.png(大約每秒一幀)。每一幀都必須在視覺上合理:沒有半載入的內容、沒有佔位文字、沒有元素卡在錯誤位置、沒有被邊緣截斷的部分。
  2. 三個全尺寸幀,選取在最繁忙的時刻:ffmpeg -ss 12.5 -i out/final.mp4 -frames:v 1 checks/f-12.5.png。閱讀上面的每一個字。
  3. 聆聽一遍波形圖上最大聲和最安靜的部分:沒有咔嗒聲、爆音、失真,或任何被音樂掩蓋的台詞。

3. 報告

將結果對應到步驟的錯誤檢查(mfx checks <step>):frame-sheet 和 format 來自腳本及您的視覺檢查,loudness 來自音訊分析。將 JSON 檔案和幀圖保留在 checks/ 目錄中。提交最終版本時,請附上幀圖作為第二個項目:所有權人可以在一秒內掃視完成。

修正響度

對混音進行雙遍 loudnorm 處理,但絕對不要在已經標準化的檔案上進行:

ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1.5:LRA=11:print_format=json -f null -       # 讀取測量值
ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1.5:LRA=11:measured_I=..:measured_TP=..:measured_LRA=..:measured_thresh=..:offset=..:linear=true mix-14.wav

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能