SuperAPI AI 工具集

video-edit-compare

设计与创作

查看项目

更新于 10-16 02:29

技能介绍

用途:在 cut-as-code 交付完成后,对最终成片与原始素材做严格并排审查,覆盖剪切、变速、调色与图形。它渲染单一 V1 对比模式 original-vs-final-source-time:左面板连续播放原片,右面板把最终交付像素投影回原始源时钟,被删区间为黑色,保留区间拉伸回其源时长,音频直接复制原片。

依赖:需 PATH 中有 ffmpeg/ffprobe,以及带 Pillow 的 Python,处理媒体前先检查。

输入:work/timeline.json(规范的时间顺序源到节目映射)、input/original-video.mp4(原始源)、final/final-video.mp4(所有选定编辑后的实际交付)。不要与剪辑计划或中间渲染对比,必须用最终像素,以便审查包含调色和卡片。

渲染命令: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 只生成计划和可检查缓存文件,不渲染视频。

映射规则:源片段保持时间顺序、不重叠、单一来源;从最终视频裁剪每个片段的 program_range,按片段速度拉伸以恢复 source_range 时长;为每个源时间空隙插入黑色;原音频不重定时直接映射;每部分的起止帧由绝对源时间边界推导,再按帧数裁剪并以时间轴有理 FPS 重建 PTS,不能独立四舍五入每段时长,否则累积拼接舍入会导致源时间漂移。V1 不支持重排、重复、重叠、非线性速度或多源时间轴,必须验证失败。

验证:渲染后自动检查完整输出——时长在单帧内等于 source_duration_s;输出宽度为源宽度两倍;每个被删区间采样在右侧为黑;保留区间采样匹配对应最终节目帧;原音频连续且处于源时钟。成功后写入 review/04-edit-compare/comparison-summary.md 并附通过结果;若存在 work/project.json,还会添加或刷新 original-vs-final-source-time 审查节点,在 based_on 记录精确的活动操作修订,并刷新 START-HERE.md。不要创建单独的检查清单。此对比是审查交付物,不是默认预览,应在最终渲染存在后生成。