/byted-util-video-editor

name: byted-util-video-editor
description: 视频编辑器，在需要视频后期制作、多个视频文件合成、视频添加音频轨道、合并多个音频文件、视频生成并烧录字幕场景时，使用该技能。
version: 1.0.0
license: Apache-2.0

Video Editor - 视频编辑器

适用场景

当需要进行视频后期处理时使用此技能，包括：

• **合并多个视频**：将多个分镜视频合成一个完整视频
• **添加音频**：为视频添加旁白、背景音乐等音频轨道
• **合并音频**：将多个音频文件按时间轴合并成一个完整音频
• **生成字幕**：生成 SRT 格式的字幕文件
• **烧录字幕**：将字幕硬编码到视频中
• **视频制作**：短视频、宣传片、教学视频的后期合成

功能特性

1. 合并多个视频

• 支持 2+ 个视频文件拼接
• 自动处理视频编码和格式转换
• 保持原始视频质量
• **自动保留原始视频的背景音乐**

2. 添加音频轨道

• 支持添加旁白配音
• 支持添加背景音乐
• 可调节音频音量（0.0-2.0 倍）
• 可调节原始视频背景音乐音量（0.0-2.0 倍）
• 背景音乐和对白音频自动混合

3. 合并多个音频

• 支持将多个音频文件按时间轴合并成一个完整音频
• 每个音频可以指定自己的开始时间（秒）
• 使用 amix 滤镜平滑混合音频

4. 生成字幕

• 支持生成标准 SRT 格式字幕文件
• 支持多段字幕，每段有独立的开始/结束时间
• UTF-8 编码，支持中文字幕

5. 烧录字幕

• 将 SRT 字幕硬编码到视频中
• 需要 ffmpeg 编译时包含 libass（subtitles 滤镜）支持
• 如当前环境不支持，可使用其他视频编辑工具（如剪映等）烧录字幕

6. 灵活的操作模式

• **merge 模式**：合并多个视频（可同时添加音频）
• **add-audio 模式**：为现有视频添加音频
• **merge-audios 模式**：合并多个音频文件
• **generate-srt 模式**：生成 SRT 字幕文件
• **burn-subtitles 模式**：烧录字幕到视频

系统要求

安装 ffmpeg

**Ubuntu/Debian：**

sudo apt install ffmpeg

**macOS：**

brew install ffmpeg

**验证安装：**

ffmpeg -version

使用步骤

模式 1：合并多个视频

**基本用法：**

python scripts/video_editor.py output.mp4 --videos video1.mp4 video2.mp4 video3.mp4

**带音频合并：**

python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 v3.mp4 --audio narration.mp3

**调整音频音量：**

# 对白音频音量为 0.8 倍（降低 20%）
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 0.8

# 对白音频音量为 1.5 倍（提高 50%）
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 1.5

# 同时调整背景音乐音量为 0.5 倍
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 0.8 --bg-volume 0.5

模式 2：为现有视频添加音频

**基本用法：**

python scripts/video_editor.py output.mp4 --video input.mp4 --audio narration.mp3 --mode add-audio

**调节音量：**

python scripts/video_editor.py output.mp4 --video input.mp4 --audio background.mp3 --volume 0.5 --mode add-audio

模式 3：合并多个音频文件

**基本用法：**

python scripts/video_editor.py output.mp3 --audios audio1.mp3,audio2.mp3 --start-times 0,5 --mode merge-audios

**参数说明：**

• `--audios`：要合并的音频文件列表，用逗号分隔
• `--start-times`：每个音频的开始时间（秒），用逗号分隔
• 两个列表的长度必须相同

模式 4：生成 SRT 字幕文件

**基本用法：**

python scripts/video_editor.py output.srt --subtitles '[{"text":"你好","start_time":0,"end_time":2},{"text":"世界","start_time":2.5,"end_time":5}]' --mode generate-srt

**参数说明：**

• `--subtitles`：JSON 格式的字幕数据，每个字幕包含：
• `text`：字幕文字
• `start_time`：开始时间（秒）
• `end_time`：结束时间（秒）

模式 5：烧录字幕到视频

**基本用法：**

python scripts/video_editor.py output_with_subs.mp4 --video input.mp4 --subtitle subs.srt --mode burn-subtitles

**注意：**

• 字幕样式参数已预留，但实际效果取决于 ffmpeg 的 subtitles 滤镜配置
• 如当前环境不支持 subtitles 滤镜，建议：

1. 使用专业视频编辑软件（Final Cut Pro、Premiere、剪映等） 2. 使用在线视频工具（如 Kapwing、Clideo 等）

参数说明

| 参数 | 说明 | 示例 | | ----------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | | `output` | 输出文件路径 | `final_video.mp4` | | `--videos` | 要合并的视频文件列表（2+ 个） | `--videos v1.mp4 v2.mp4 v3.mp4` | | `--video` | 单个视频文件（add-audio 或 burn-subtitles 模式） | `--video input.mp4` | | `--audio` | 单个音频文件（旁白、对白等） | `--audio narration.mp3` | | `--audios` | 要合并的音频文件列表（逗号分隔） | `--audios a1.mp3,a2.mp3` | | `--start-times` | 每个音频的开始时间（逗号分隔，秒） | `--start-times 0,5` | | `--volume` | 对白音频音量（0.0-2.0，默认 1.0） | `--volume 0.8` | | `--bg-volume` | 背景音乐音量（0.0-2.0，默认 1.0） | `--bg-volume 0.5` | | `--subtitles` | 字幕数据（JSON 格式，generate-srt 模式） | `--subtitles '[{\"text\":\"你好\",\"start_time\":0,\"end_time\":2}]'` | | `--subtitle` | SRT 字幕文件路径（burn-subtitles 模式） | `--subtitle subs.srt` | | `--font-name` | 字幕字体名称 | `--font-name "Arial"` | | `--font-size` | 字幕字体大小 | `--font-size 24` | | `--font-color` | 字幕字体颜色 | `--font-color "&H00FFFFFF"` | | `--outline-color` | 字幕边框颜色 | `--outline-color "&H00000000"` | | `--outline` | 字幕边框宽度 | `--outline 2` | | `--shadow` | 字幕阴影深度 | `--shadow 0` | | `--alignment` | 字幕对齐方式 | `--alignment 2`