视频编辑对比

渲染单通道 V1 对比模式：original-vs-final-source-time。

左侧面板连续播放原始素材；右侧面板将实际最终交付帧（final-delivery pixels）按原始素材的时间轴（source clock）进行反向映射。被剪除的时间段在右侧显示为黑色，保留的最终片段则按其在原始素材中的时长进行拉伸；音频直接复制自原始素材，不作时间重映射。

依赖项

要求系统 PATH 中可调用 ffmpeg/ffprobe，且 Python 环境已安装 Pillow。处理媒体前请先确认这些依赖可用。

输入文件

• work/timeline.json：标准的、按时间顺序排列的源素材到成片（program）的映射关系
• input/original-video.mp4：原始源素材
• final/final-video.mp4：完成全部选定编辑后的实际交付成片

请勿将成片与剪辑方案（cut plan）或中间渲染结果进行对比。必须使用最终像素输出，以确保审核涵盖调色（grade）与字幕/图形卡（cards）等内容。

渲染命令

python scripts/make_compare.py TIMELINE.json SOURCE.mp4 FINAL.mp4 OUT.mp4 [--filter-only]

项目示例：

python skills/video-edit-compare/scripts/make_compare.py `
  work/timeline.json `
  input/original-video.mp4 `
  final/final-video.mp4 `
  review/04-edit-compare/original-vs-final-source-time.mp4

该脚本始终会写入持久化文件 work/edit-compare/compare-plan.json；同时将 PIL 生成的标签图像及构建的 filtergraph 写入临时缓存目录 work/cache/。--filter-only 参数仅生成计划文件和可检查的缓存文件，不执行视频渲染。

映射规则

• 源片段（source clips）须保持时间顺序、互不重叠，且每个片段仅来自单一源。
• 从最终成片中裁取各片段的 program_range。
• 按该片段的速度系数（clip speed）对其进行拉伸，还原其在源素材中的 source_range 时长。
• 对所有源时间轴上的空隙（source-time gap）插入黑色画面。
• 原始音频不做时间重映射，直接映射。
• 每个片段的起始与结束帧均依据其绝对源时间边界（absolute source-time boundaries）推导得出；随后据此帧数精确裁切，并按时间线设定的有理数帧率（rational FPS）重建 PTS（Presentation Timestamp）。切勿对各片段时长单独四舍五入；累积拼接（cumulative concat）过程中的独立舍入会导致源时间漂移（source-time drift）。

V1 版本不支持重新排序、重复、重叠、非线性变速或跨多源的时间线，此类情况将导致校验失败。

验证

渲染完成后，脚本将自动校验完整输出结果：

• 输出总时长与 source_duration_s 的误差不超过一帧；
• 输出宽度为源素材宽度的两倍；
• 右侧画面对应所有被剪除时间段的采样点均为纯黑；
• 右侧画面中保留时间段的采样点与对应最终成片（final program frames）完全一致；
• 原始音频保持连续，且严格对齐源时间轴（source clock）。

校验通过后，脚本将写入 review/04-edit-compare/comparison-summary.md，其中包含“通过”的验证结果。若存在 work/project.json，还将自动添加或刷新 original-vs-final-source-time 审核节点，在 based_on 字段中记录当前生效操作的确切修订版本（exact active operation revisions），并同步更新 START-HERE.md。请勿另行创建独立的校验清单（checks manifest）。

该对比视频属于审核交付物（review deliverable），而非默认预览。请在最终成片渲染完成后再生成此对比视频。