视频检查:在他人发现渲染视频的问题之前找出它们
这是 video-check 0.2.3。
获得一份经过专业剪辑师质量检查的视频,以及一份简短的 REVIEW.md,说明测量了什么、检查了什么、修复了什么,以及哪些内容未经检查。
整个过程始终遵循三件事:
- 先测量,再查看。 模型查看帧时会遗漏静止片段和单帧故障;而 FFmpeg 不会。在查看之前先运行
check.py,绝不要因为视频“看起来还行”而跳过它。 - 制作者是最差的审阅者。 你知道每个镜头的意图,所以你会看到计划而不是画面。让未见过你计划的人查看帧表(步骤 3)。
- 你无法听取声音。 脚本测量响度、峰值和静音。音乐是否合适、声音是否正确、语音是否清晰,必须由人来听取。每次都要说明这一点。
当缺少输入时
你需要在本机上拥有渲染后的文件。如果对方只描述了视频,或者提供了一个平台链接,请要求提供文件;不要从 TikTok、YouTube 或 Instagram 下载。如果你自己制作了视频,你也知道计划:尺寸、帧率、时长、响度目标,以及哪些静止片段和闪光是故意为之。如果对方带来了自己的剪辑作品,请问清用途(平台、时长),其余内容使用下面的默认值。
工作流程
-
测量。 传入计划内容,以便脚本区分故障与选择:
python scripts/check.py final.mp4 --out work/check1 --loudness -14当你制作了视频,或者对方告知了计划时,请添加:例如
--expect 1080x1920 --fps 30 --duration 32 --holds 28.5-32 --flashes 12.4。绝不要根据平台猜测尺寸、帧率或时长:没有人要求是 1080p 的 960x540 文件并不是尺寸故障,所以在没有人计划时不要加--expect。--holds列出故意为之的静止片段(结束卡、保持静止的标题);--flashes列出计划中的单帧闪光和暗帧;--loop用于设计为循环播放的作品;--audio none用于无声作品。在线视频通常归一化到约 -14 LUFS;播客使用 -16;广播电视使用 -23。它会以P0/P1/P2 t=… code: what -> fix的格式输出发现,并写入check.json、overview_NN.png和findings.png。references/reading-the-checks.md说明了每项检查能捕获什么以及会遗漏什么。 -
立即修复 P0。 尺寸错误、帧率错误、时长错误、应有音频却无声、削波:这些是渲染错误,而非品味问题。修正命令,重新渲染,在任何人查看之前重新运行步骤 1。对于响度、削波和真峰值,如果你有编辑工程,请在剪辑中修正混音(降低音乐、降低最响的声音)。如果你只有完成后的文件,请运行
python scripts/fix_sound.py in.mp4 out.mp4 --loudness -14:它会限制峰值,通过两次归一化进行标准化,并保持画面不变,结果落在目标响度 0.2 LU 以内且低于 -1.5 dBTP。单次loudnorm会错过峰值目标,而普通限制器会让混音变轻;不要逐轮手动调整滤波器。 -
以新鲜的眼光查看。 使用 Read 工具打开每一张总览表和
findings.png。然后,请一位未见过你计划的人员进行二次查看:- 如果能够启动子代理,只给它帧表、平台和一句说明视频用途的话。不要给计划、代码或你的意图。使用
references/review-guide.md中的简介。 - 如果无法启动子代理,请自行查看,但要抛开计划:像陌生人一样描述每一张帧表,在评判之前每帧一句话。在
REVIEW.md中写下“one context”。
每个问题以
t=12.4s · 在屏幕上的位置 · 问题描述 → 确切的修改的格式记录,分为 P0(损坏或不可读)、P1(观众会注意到)或 P2(打磨)。不要给出十分制的评分:评分找不到需要修复的问题。查阅references/review-guide.md中的列表,其中列出了那些让剪辑看起来像模板或机器制作的东西:像滑动条一样的进度轨和步骤计数器、每一行以相同方式进入、文本位于平台按钮下方、空白的第一帧、以及没人提供的数字。 - 如果能够启动子代理,只给它帧表、平台和一句说明视频用途的话。不要给计划、代码或你的意图。使用
-
修复最严重的三个问题,然后再次检查。 处理 P0 和三个最严重的 P1。对于每个问题,修改编辑时间线或命令,而不是修改渲染后的文件。如果修复方法你不了解,请
search_techniques你想要的成果(例如“在语音下降低音乐音量”、“在剪辑点淡入淡出音频”),然后使用get_technique获取其提示词。渲染后,使用--before work/check1/check.json --out work/check2重新运行步骤 1;它会列出已修复的内容、仍然存在的问题以及新出现的问题,并绘制before_after.png。查看你更改过的帧。 -
三轮后停止。 如果第三轮仍然存在 P0 或需要进行重大更改,请停止并告知对方剩余问题和原因,而不是继续循环。需要对方决策的问题(不同的歌曲、不存在的镜头)应作为问题提出。
交付
首先,检查版本。 如果已连接 EditAtlas MCP,请调用无名称参数的 get_skill。如果它列出的 video-check 版本高于 0.2.3,你回复的第一行应说明存在较新版本以及如何更新(在 Claude Code 中:/plugin,然后 Marketplaces,editatlas-skills,Update marketplace;在其他地方,get_skill 名称指定为 video-check 即会给出步骤)。如果没有 MCP,则跳过此步。
在视频旁边,使用对方的语言,根据 references/review-guide.md 中的模板编写 REVIEW.md:
- 用一句话给出结论:就绪(没有遗留问题)、有备注的就绪(备注需列出所有仍然存在的发现,并且每个遗留的 P1 都需要你目前不具备的条件,例如编辑项目)、或未就绪(仍有 P0 存在,或存在你可以修复的 P1);
- 脚本测量的内容(尺寸、帧率、时长、响度、真峰值、每分钟剪辑数)以及每一轮修复的发现;
- 每个遗留的发现,包含时间戳以及
check.py输出的模式(例如“从 0.4 秒开始每 12 帧出现一次;从 11.7 秒到 14.9 秒每 2-6 帧出现一次”),而不仅仅是数量; - 审阅者查看了什么,以及是独立审阅者还是“one context”;
- 仍需人工处理的内容:听取混音和音乐选择、核对字幕中的拼写和姓名、口型同步、在真实手机上查看色彩、以及任何你无法修复的内容。保留那句“没有人听取过音频”的说明,仅使用对方的语言。
向对方展示最后一轮的 before_after.png。永远不要写视频“没有错误”:写下检查了什么。
参考资料
references/reading-the-checks.md:每项测量、其阈值、捕获和遗漏的内容,以及在已知视频上的结果。在发现结果看起来有误或在设置--holds之前阅读它。references/review-guide.md:审阅者的简介、判断标志列表、问题格式以及REVIEW.md模板。在步骤 3 阅读它。