video-merger — 视频合并器

视频拼接工具（video-merger）是一种可以自动将分镜头/分段短视频按顺序拼接为长视频的OpenClaw技能，支持工程化批量处理。其功能特性包括： ✅ 严格按文件名数字序号排序，保证剧情顺序正确 ✅ 自动统一分辨率、帧率、编码，保证播放流畅 ✅ 支持淡入淡出转场效果（整体/片段间可选） ✅ 自动同步音轨，完整保留原音频 ✅ 支持两种输出模式：分块输出（每段1分钟左右）、完整长视频输出 ✅ 支持保持原始分辨率或自定义输出参数

依赖要求：

• ffmpeg (>= 5.0)
• Python 3.8+

安装： # 自动安装依赖 ./install.sh

使用方法：

• 拼接为完整长视频（默认保持原始分辨率）

python3 scripts/merge.py --input /path/to/segments --output ./full_video.mp4

• 自定义输出分辨率

python3 scripts/merge.py --input /path/to/segments --output ./full_video.mp4 --resolution 1080x1920

• 自定义转场时长

python3 scripts/merge.py --input /path/to/segments --output ./full_video.mp4 --transition 1.0

• 分块输出模式（每块60秒）

python3 scripts/merge.py --mode chunk --input /path/to/segments --output ./output_chunks/

• 自定义分块时长

python3 scripts/merge.py --mode chunk --chunk-duration 120 --input /path/to/segments --output ./output_chunks/

参数说明：

• 参数：--input，说明：分镜头视频所在目录，默认值：必填
• 参数：--output，说明：输出文件/目录，默认值：必填
• 参数：--transition，说明：转场时长（秒），默认值：0.5
• 参数：--chunk-duration，说明：分块模式每段目标时长（秒），默认值：60
• 参数：--resolution，说明：自定义输出分辨率，如 864x480，默认值：保持原始

适用场景：

• AI生成短剧分镜头批量拼接
• 录制的分段视频自动合并
• 短视频批量处理生产