用途:当目标主视频渲染完成后,操作者常感觉“不如参考视频但说不清原因”。本技能把这一判断结构化:抽取时间轴对齐的画面、计算可比较的指标,并按 7 个维度逐项评审,最终产出按优先级排序的 P0/P1/P2 修复清单,可交由 auto-fix-from-review-notes 消费。适用于任意视频形态(音乐视频广告、旁白漫画、UGC、口播),参考视频作为该形态的“北极星”。
主要能力:一是抽帧,使用 watch 技能的脚本或 ffmpeg(ffmpeg -i <video> -vf "fps=<fps>,scale=512:-1" <out>/frames/frame_%03d.jpg)分别处理参考与目标,存到 ref-frames/ 与 target-frames/。二是指标计算,写入 metrics.json,包含时长、画幅、总剪辑数、每分钟剪辑数、平均与标准差剪辑间隔、平均与 P90 运动量、主色前五、平均亮度、字幕框估算(可选,需 tesseract)。三是生成 grid.html:顶部指标对照表(目标/参考/差值),中部按对齐时间点左右并排成对帧并附时间戳与备注框,底部为 7 维度检查清单。四是 LLM 定性评审 7 个维度:角色取景、字幕处理、镜头运动、剪辑节奏、色彩与光线、背景复杂度、能量与连贯性,每条发现需标注严重级别。五是写出 report.md,含 frontmatter(status、reviewer、reference、target、metrics_delta)、TL;DR、P0/P1/P2 列表(每条引用帧路径与时间戳,并给出 auto-fix 原子命令或注明需人工重掷)、至少 3 个 pass 的重建计划表与建议。六是若目标项目存在 storyboard.html,在其主视频面板上方追加“Review · target vs reference”区块。
使用方式:命令示例 python3 skills/atoms/review/compare-with-reference-video/scripts/compare.py --reference <参考视频> --target <目标主视频> --output-dir <输出目录> --fps 2 --max-frames 80,随后由 LLM 读取两个帧目录并按 7 维度写报告。参数包括 --reference、--target(必填,本地 mp4/mov)、--output-dir(默认 <target_folder>/review-notes/vs-reference-<ts>/)、--fps(默认 2)、--max-frames(默认 60)、--align(auto/relative/absolute,默认 auto:时长差 10% 内用绝对时间戳,否则按比例对齐)。
适用与限制:适合在 video-orchestrator 的 State 8、重掷后复核,或任何“感觉与参考不符”时使用。无参考视频、时长相差超过 2 倍、或格式根本不同(如 30 秒广告对 4 秒循环)时应跳过。已知指标偏差:运动量含切点处像素差,硬切多会虚高;剪辑检测依赖 ffmpeg 场景阈值 0.4,相似色调可能漏检;平均亮度仅每 20 帧采样,极端明暗转场可能失真。参考视频为占位或不相关、目标本身损坏、参考无法访问时应报错退出;字幕框 OCR 不可用时跳过该自动测量,仅凭目视评审。本技能只写审查笔记,不自动触发修复。官方未提供价格与平台信息。