剪映审片验收(jianying-review)
一句话定位:对"改前 / 改后"两版做多维度对照检查,每条结论都带数字 + 证据边界, 并给出最小返修范围。★ 审片本身不授权改草稿或发布。
★ 我们和官方的差别
剪映官方的 editing-review 只有 47 行,且原文明确写着:
「这里列出的是检查方法,不是已实现或已运行的检测器」。
⇒ 官方告诉你该查什么;我们有真正能跑的检测器和数字(像素差 / 画质 / 响度 / 时间线 / sha)。
但纪律要跟官方一致(这是我们从它身上学的):
- 源素材分析只能证明源素材内容;草稿结构只能证明编排事实;渲染成片的音画证据才支持"实际呈现"的结论
- 不要把"上游成功"当成"审片通过"(草稿应用成功 ≠ 画面对了)
- 只对工具真正覆盖的维度和范围下结论;采样不能证明"全片没有闪帧"
- 区分四类结论:证据支持通过 / 已确认问题 / 证据不足 / 与本次范围无关
- 没有足够证据的必查项要保留为"待确认",不能因为"没发现问题"就给完整通过
检查维度(verify_diff 的 checks)
| 维度 | 查什么 | 需要的证据 | 不达标时 |
|---|---|---|---|
visibility |
改动在画面上看得见吗 | 改前/改后帧目录 + 噪声基线 | max MAD ≤ 判据线 ⇒ FAIL |
picture |
画质:均值漂移 / 新增高光削波 / 新增暗部死黑 | 同上 | 新增削波 >2% / 死黑 >10% ⇒ FAIL |
audio |
响度 LUFS / true peak | 改前/改后 mp4 | 偏离 −14 LUFS ⇒ 提示 |
timeline |
段数 / 轨道 / 时长 / 逐段字段差 | 改前/改后草稿 JSON | 给了 expect 就按期望断言;没给且什么都没动 ⇒ 改动可能没落盘 |
draft_integrity |
真草稿有没有被误改 | 真草稿目录 | 落盘时已做逐字节断言 |
★ 判据用增量不用绝对值:片子里本来就有的纯白/纯黑不算削波/死黑,只有被改动新推上去/压下去的才算缺陷。
★★★ 审片前必须知道的一件事:官方渲染器有噪声底
同一份草稿渲染两次,帧就已经不一样(实测 1417/108 帧不同,最差 MAD **48123**)。
⇒ 裸 MAD 阈值(0.5)没有任何判别力;"max MAD=123.5 ⇒ 改动可见"这类结论不成立。
⇒ 审片必须先量噪声底(noiseDir = 同一状态再渲染一次的帧目录):
node ${PLUGIN_ROOT}/scripts/run-verb.mjs verify_diff '{
"beforeDir": "<before>/frames", "afterDir": "<after>/frames",
"noiseDir": "<before>/frames-again",
"checks": ["visibility","picture","timeline"]
}'
★
noiseDir= 同一状态再渲染一次的帧目录。 ★ JSON 里不能写行内注释(#或//都不行)⇒ 照抄会被run-verb.mjs拒成"参数不是合法 JSON"。 要注释就写在 JSON 外面(像这样)。
- 给了
noiseDir⇒ 判据线 =max(threshold, noiseMad × 1.5),输出里有noiseMad/madOverNoise; - 没给 ⇒ 输出里
calibrated:false+ note ⇒ 这时"可见"只能当参考,不能当结论。
★ 结构性改动请用语义判据(不依赖像素、完全确定):
timeline 维度会给出逐段字段差(segmentDiffs:段 id + 变了哪些字段 + 改前改后值),
★
beforeDraft/afterDraft要指裸草稿 JSON(顶层就有tracks)——draft_read的响应外面包了一层draft,直接存响应会被读成tracks: 0(判据静默失效)。 配合expect直接断言:
node ${PLUGIN_ROOT}/scripts/run-verb.mjs verify_diff '{
"checks": ["timeline"],
"beforeDraft": "<改前的明文草稿.json>", "afterDraft": "<改后的明文草稿.json>",
"expect": { "segmentFieldChanged": "volume", "segmentsDelta": 0 }
}'
审片报告里必须写清"这条结论是语义的还是像素的" —— 两者可信度差一个数量级。
主工作流
# ① 渲染改前 / 改后(官方渲染器)
node ${PLUGIN_ROOT}/scripts/run-verb.mjs render_frames '{"draft":"<copy>","outDir":"<outdir>"}'
# ② 多维度审片
node ${PLUGIN_ROOT}/scripts/run-verb.mjs verify_diff '{
"beforeDir": "<before>/frames", "afterDir": "<after>/frames",
"checks": ["visibility","picture","audio","timeline","draft_integrity"],
"beforeVideo": "<before>.mp4", "afterVideo": "<after>.mp4",
"beforeDraft": "<before draft_content.json>", "afterDraft": "<after draft_content.json>",
"realDraft": "<草稿库>\\<草稿名>"
}'
输出结构:
{ "verdict": "PASS" | "FAIL",
"checks": { "visibility": {...}, "picture": {...}, "audio": {...}, "timeline": {...}, "draft_integrity": {...} },
"problems": ["高光削波【新增】3.21%(>2%)", ...] }
★★ 单版审片("审一下这版":没有改前可比)
用户只给一版时也能审 —— 但能判什么、不能判什么必须写清。
verify_diff现在支持只给改后(afterDir/afterVideo/afterDraft):
| 维度 | 单版 | 为什么 |
|---|---|---|
visibility |
判不了(报 skipped) |
没有改前就没有"改动"可比 ⇒ 但会给出噪声底(同一状态渲两遍的差异) |
picture |
只给绝对值、不判失败 | 片子里本来就有的纯白/纯黑不算缺陷 ⇒ 绝对值不能当判据(要判"新增"必须有改前帧) |
audio |
能判 | 这一版的 LUFS / true peak(绝对目标 −14 LUFS) |
timeline |
只给这一版的结构 | 段数 / 轨道 / 时长("改了什么"要改前草稿) |
draft_integrity |
能判 | 真草稿的 sha |
⇒ ★ 结果里有 undetermined 字段(列出没判的维度与原因)+ verdictNote:
"有 1 个维度【未判定】(visibility) ⇒ 这不是"完整通过";未测的维度要写成"待确认",不能写成"正常""
⇒ ★ 单版审片的一条现成路线:run_pipeline {profile: "review-only"}
(开副本 → 渲两遍量噪声底 → 出片 → 单版审片;只读不改)。
⇒ ★ 两版对照(改前/改后)也有一条现成路线:
run_pipeline {profile: "review-compare", draft: <改前>, draftAfter: <改后>}
(两份草稿各开副本 → 各渲一遍 + 改后再渲一遍量噪声底 → 各出一支成片 → 一次全维度对照;
只读不改)。它同时回答:画面变没变 · 画质新增削波/死黑 · 响度两版各是多少 ·
时间线改了什么 · 真草稿有没有被误改。
★ 审片请求不授权修改:这两条路线都只开副本做体检,不改草稿、不落盘。
结论怎么写(照官方那套分类)
| 类别 | 什么时候用 | 写法 |
|---|---|---|
| 证据支持通过 | 该维度有检测器覆盖且达标 | "画面变化可见:max MAD 123.5 @frame74(22/108 帧有差异)" |
| 已确认问题 | 有数字支撑的缺陷 | "实际 vs 预期 → 定位 → 影响 → 最小返修 + 返修后用什么证据确认" |
| 证据不足 | 该维度没有检测器覆盖 | "响度未测(未提供 mp4)——待确认,不写成'响度正常'" |
| 与本次范围无关 | 用户没要求这个维度 | 不展开、不泛化罗列风险 |
★ 最小返修原则
- 只修有证据的问题,范围最小
- 说明应该保持什么(避免修 A 破坏 B)
- 给出返修后用什么证据确认(不是"再优化一下"这种无法执行的建议)
- 审片请求不授权修改:用户授权修复时,才把问题与最小返修范围交给执行入口(
jianying-draft-edit)
★ 边界(不做什么 / 为什么 / 替代)
| 不做 | 为什么 | 替代 |
|---|---|---|
| 改草稿 / 落盘 | 审片请求不授权修改;越权改草稿会动到用户资产 | 用户授权后,把问题与最小返修范围交给 jianying-draft-edit |
| 发布 / 导出成片 | 发布侧已有独立 skill 体系 | daily-platforms-export · lvchuanjiao-daily-upload |
| "全片没有闪帧"这类全片结论 | 采样不能证明"全片没有闪帧"(官方原话)⇒ 只能写"证据不足/待确认" | 缩小范围重测,或在结论里标注覆盖范围 |
| 拿官方渲染器的裸像素差当结论 | 同态重渲染噪声底就有 MAD 48~123 ⇒ 裸 MAD 分不出"改动"与"噪声" | 语义判据(timeline 逐段字段差)为主 · 像素必须带 noiseDir 校准 |
| 结构化调色(曲线/HSL/色轮)的写回与判定 | 草稿侧字段名尚未确证 | jianying-cut 走我们自己的链出片 |
参考
- 判据纪律(必读):
skills/jianying-verify/SKILL.md·references/verify-discipline.md - 踩坑清单:
references/pitfalls.md - 官方
editing-review原文对照:%ProgramFiles%\JianyingPro\<版本>\Resources\canvas_agent\skills\editing-review\SKILL.md