最终检查
分两个部分,两者都必需:脚本检查机器能做的事,你检查机器不能做的事。
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. 查看
- 帧预览图。 查看
checks/<名称>-sheet.png(大约每秒一帧)。每一帧在视觉上都必须是合理的:没有半加载的内容,没有占位符文本,没有元素卡在错误的位置,没有任何内容被边缘裁切。 - 三张全尺寸帧,取自最繁忙的时刻:
ffmpeg -ss 12.5 -i out/final.mp4 -frames:v 1 checks/f-12.5.png。仔细阅读上面的每一个字。 - 听一遍,重点听波形中最大声和最安静的部分:没有咔哒声、爆音、失真,也没有被音乐掩盖的词语。
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