用途:把一部已完成的成片拆成下次制作可参考的方法与数值,属按需参考分析,非生产阶段或质检,不调用模型、不改其他产物、不打分或拦截。
输入:成片(.mp4/.mov/.mkv/.webm),可选搭配理解产物目录 U(asr_result.json、asr_timing_evidence.json、background_research.json、understanding_index.json 等)。无理解产物也能运行,但旁白语速为空、泄漏扫描范围缩小。
用法(命令相对技能目录): python3 scripts/reference.py measure <成片> --work-dir U python3 scripts/reference.py frames <成片> --work-dir U --review(或 --longest 5) python3 scripts/reference.py check --work-dir U [--json] python3 scripts/reference.py export --work-dir U --out <下次运行的 work_dir>/production_reference.json
measure 用一次 ffmpeg 得到切点与响度并缓存;切点基于 scdet 分数,运动、闪光、暗场硬切等会进入待复核窗口,需看图用 cut_fixes 增删。标注写 reference_breakdown.json 的 labels(音轨归属、段落、字幕形态、依据)。事实(source_facts)与方法(methods)分开,方法只引用测量路径,数值由 export 填入,禁止手写。check 零 error 才可 export,导出后再做泄漏扫描。
交付:production_reference.json 含时长画布、cut_detection、节奏 profile、结构、字幕形态、methods 与 skipped_dimensions;复制进下次制作 work_dir 作为参考,不构成配额。
限制:慢叠化、相近切点、临界分数与运动后暗场硬切可能测不到;旁白占比与语速为标注精度,非逐词对齐;泄漏扫描为字面匹配,仍需自查是否复述剧情;U 内 breakdown 与帧图含原片事实,只留本地。