Reference Video Replica QC 是一个面向视频复刻与质量校验的技能,核心目标是把参考视频的复刻过程转化为可验证的红/绿证据闭环,并在需要时将已对齐的运动捕获为可复用的 HyperFrames 或 Remotion 组件。
用途 该技能用于分析、复刻、对齐和验证参考视频的运动。当用户要求复刻、复制、匹配、对齐、像素对齐或比较视频时适用。在命名或承诺保真度之前,必须先阅读 replica-levels.md,因为源流复制、精确无损渲染帧、编码后帧对齐 MP4、视觉重建和风格参考是不同层级的声明。
主要能力 技能提供三种操作模式:仅分析模式(检查并报告,不修改实现代码)、复刻循环模式(修复候选直到声明的证据门通过)、组件捕获模式(将已验证的运动模式连同输入和限制注册为组件)。工作流包括:声明契约、锁定时间基准、选择架构、分析与修复、通过三道证据门、扩展与拼接、捕获组件、做出决定。
使用方式 技能附带多个脚本:extract_halfsec_frames.py 用于发现采样和联系表;extract_frame_range.py 用于精确包含帧范围提取;build_frame_sprite_rows.py 和 verify_frame_sprite_rows.py 用于无损精灵行构建与往返证明;verify_timeline_playback.cjs 用于真实时间线捕获;verify_frame_sequence.py 用于全帧比较;compare_videos.py 用于交付视频比较和解码帧门。帧和精灵验证需要带 Pillow 的 Python 运行时,时间线捕获需要 Node 运行时中的 Playwright。
适用场景 适用于需要精确复刻参考视频运动、进行像素级对齐验证、比较参考视频与候选视频、将运动模式捕获为可复用组件的视频制作与质量校验场景。对于内容创作项目,最终视频复制到 成片/ 目录,紧凑的质检证据复制到同级的 质检/ 目录。
限制 技能明确区分精确回放与参数化运动,不得将精确回放纹理层呈现为参数化 AI 组件。采样只能定位问题,不能批准像素或帧对齐交付。成功的渲染日志不是交付证据。三道证据门必须全部为绿色,报告需说明每个指标证明的是哪一层。若某道门为红色,应说明未对齐,指出第一个失败的帧或时间戳,并继续复刻循环。