Video Stitcher

---

name: video-stitcher description: 视频片段拼接和后期处理。输入视频片段列表，输出完整视频。支持转场效果、背景音乐、字幕叠加。底层使用 FFmpeg 或 Remotion。触发词：拼接视频、合并视频、视频剪辑、video stitch、concatenate videos、add transitions。

---

视频拼接

功能

1. 拼接：多个视频片段 → 完整视频 2. 转场：添加片段间过渡效果 3. 音频：背景音乐、音量调整 4. 字幕：叠加字幕/文字 5. 导出：多种格式和分辨率

工具选择

| 工具 | 适用场景 | |------|----------| | FFmpeg | 简单拼接、快速处理、命令行 | | Remotion | 复杂动效、React 组件、品牌化 |

默认使用 FFmpeg。复杂需求用 Remotion。

输入参数

| 参数 | 必填 | 说明 | |------|------|------| | clips | ✓ | 视频片段列表（路径或URL）| | output | ✓ | 输出路径 | | transition | - | 转场类型 | | transition_duration | - | 转场时长（默认0.5s）| | bgm | - | 背景音乐路径 | | bgm_volume | - | BGM音量（0-1，默认0.3）| | subtitles | - | 字幕文件（SRT/ASS）| | resolution | - | 输出分辨率 | | fps | - | 帧率（默认30）| | format | - | 输出格式（mp4/mov/webm）|

输入格式

clips:
  - path: "scene_01.mp4"
    trim_start: 0        # 可选：裁剪起点
    trim_end: 5          # 可选：裁剪终点
    
  - path: "scene_02.mp4"
    transition: "fade"   # 到下一个片段的转场
    
  - path: "scene_03.mp4"
output: "final_video.mp4"
transition: "fade"           # 全局默认转场
transition_duration: 0.5
bgm: "background_music.mp3"
bgm_volume: 0.2
fade_bgm: true              # BGM 渐入渐出
subtitles: "captions.srt"
resolution: "1080x1920"     # 竖屏
fps: 30
format: "mp4"

转场类型

FFmpeg 支持

| 转场 | 效果 | 命令 | |------|------|------| | fade | 淡入淡出 | xfade=fade | | dissolve | 溶解 | xfade=dissolve | | wipeleft | 左擦除 | xfade=wipeleft | | wiperight | 右擦除 | xfade=wiperight | | slideup | 上滑 | xfade=slideup | | slidedown | 下滑 | xfade=slidedown | | none | 无转场 | 硬切 |

Remotion 额外支持

自定义 React 动画

品牌化转场

复杂遮罩效果

FFmpeg 命令示例

简单拼接（无转场）

# 创建文件列表
cat > list.txt << EOF
file 'scene_01.mp4'
file 'scene_02.mp4'
file 'scene_03.mp4'
EOF
拼接
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4

带转场拼接

ffmpeg -i scene_01.mp4 -i scene_02.mp4 \
  -filter_complex "[0:v][1:v]xfade=transition=fade:duration=0.5:offset=4.5[v]" \
  -map "[v]" output.mp4

添加背景音乐

ffmpeg -i video.mp4 -i bgm.mp3 \
  -filter_complex "[1:a]volume=0.3[bgm];[0:a][bgm]amix=inputs=2:duration=first[a]" \
  -map 0:v -map "[a]" output.mp4

添加字幕

ffmpeg -i video.mp4 -vf subtitles=captions.srt output.mp4

详见已有的 ffmpeg-video-editor skill。

工作流程

输入: clips[] + 配置
  ↓
验证所有片段可访问
  ↓
统一格式/分辨率（如需要）
  ↓
计算转场 offset
  ↓
生成 FFmpeg 命令 / Remotion 项目
  ↓
执行渲染
  ↓
输出: 完整视频

与上下游对接

上游输入：

scene-video-generator 的视频片段

digital-avatar 的口播视频

Demo 视频片段

Pipeline 集成示例：

# 从 video-script-generator 输出
scenes:
  - id: 1
    video: "hook.mp4"      # scene-video-generator 输出
    duration: 3s
    
  - id: 2
    video: "talking.mp4"   # digital-avatar 输出
    duration: 5s
    
  - id: 3
    video: "demo.mp4"      # demo skill 输出
    duration: 10s
    
  - id: 4
    video: "cta.mp4"       # scene-video-generator 输出
    duration: 3s
自动拼接
output: "final_promo.mp4"
transition: "fade"
bgm: "upbeat_music.mp3"

输出格式建议

| 平台 | 分辨率 | 比例 | 格式 | |------|--------|------|------| | 抖音/快手 | 1080x1920 | 9:16 | mp4 | | 小红书 | 1080x1440 | 3:4 | mp4 | | YouTube Shorts | 1080x1920 | 9:16 | mp4 | | B站/YouTube | 1920x1080 | 16:9 | mp4 | | 微信视频号 | 1080x1920 | 9:16 | mp4 |

注意事项

1. 输入片段分辨率不一致时，会自动缩放（可能影响质量） 2. 转场会减少总时长（每个转场减少 transition_duration） 3. BGM 时长不够会循环，太长会裁剪 4. 大量片段时建议分批处理 5. 4K 视频渲染较慢，考虑先用 1080p 预览