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 的新对话。

文档

最终检查

分两个部分,两者都必需:脚本检查机器能做的事,你检查机器不能做的事。

1. 运行检查

node .claude/skills/final-pass/qc.mjs out/final.mp4 --size 1920x1080 --fps 30 --duration 60
  • --size、--fps、--duration 来自需求文档(画面尺寸、长度)。时长允许 5% 以内的偏差。
  • 响度:--lufs -14(Web 默认值)和 --true-peak -1。仅当需求文档中指定了具有其他目标的平台时才更改这些值。
  • --end-hold:当视频设计为以静止画面结束(例如停留的 Logo)时:该段落将被判定为通过,并报告其长度。其他位置的静止画面仍将被判定为失败。
  • --allow-black:仅当视频中间故意设计为黑屏(例如章节之间的黑场过渡)时使用。请在检查备注中说明。
  • 它会生成 checks/qc-<名称>.json 和 checks/<名称>-sheet.png,并在有任何 FAIL 时以退出码 1 结束。

修复每一个 FAIL 并重新运行。静止画面可以是设计好的停顿:这样它就算通过,检查备注中会说明是哪个停顿。

2. 查看

  1. 帧预览图。 查看 checks/<名称>-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.

相关技能