视频剪辑自动化处理

技能文档

---
name: video-auto-editor-skill
title: 视频剪辑自动化处理
category: 内容创作
description: 基于 FFmpeg 与 Whisper 的视频剪辑自动化工具，支持片段截取、语音识别生成字幕并嵌入、视频拼接、格式转换缩放、水印叠加、音频提取替换、直播回放切片与 JSON 工作流批量处理。当用户需要本地视频剪辑、批量切片、生成字幕、直播回放处理、格式转换等场景时触发。
---

# 视频剪辑自动化处理

## 前置条件

### 必要依赖

1. **FFmpeg** — 核心视频处理引擎
   - Windows: 下载后加入 `PATH`
   - 验证: `ffmpeg -version`
   - 本技能默认查找的系统 `PATH` 中的 `ffmpeg`

2. **Python 3.8+** 及以下包:
   ```bash
   pip install openai-whisper moviepy pillow
   ```

### 可选依赖
   - `openpyxl` — 如需写入Excel格式报告

## 技能工作流

### 命令行方式

```bash
# 环境检查
python scripts/video_auto_editor.py check

# 查看视频信息
python scripts/video_auto_editor.py info input.mp4

# 截取片段
python scripts/video_auto_editor.py trim input.mp4 -s 00:05:00 -e 00:10:00 -o clip.mp4

# 生成字幕(Whisper)
python scripts/video_auto_editor.py subtitle input.mp4 --model base

# 嵌入字幕
python scripts/video_auto_editor.py burn input.mp4 -s input.srt -o output.mp4

# 拼接视频
python scripts/video_auto_editor.py concat "video1.mp4,video2.mp4" -o merged.mp4

# 格式转换
python scripts/video_auto_editor.py convert input.mp4 -o output.mp4 -r 1920x1080

# 添加水印
python scripts/video_auto_editor.py watermark input.mp4 logo.png -o output.mp4

# 提取音频
python scripts/video_auto_editor.py audio input.mp4 -f mp3

# 替换音频
python scripts/video_auto_editor.py replace-audio video.mp4 audio.mp3 -o output.mp4 --mix

# 直播切片(每5分钟一段)
python scripts/video_auto_editor.py slice input.mp4 -d 300 -o ./clips/

# JSON工作流(批量执行多步骤)
python scripts/video_auto_editor.py workflow config.json
```

### Python API 方式

```python
from scripts.video_auto_editor import (
    check_ffmpeg, get_video_info,
    trim_video, generate_subtitles, burn_subtitles,
    concat_videos, convert_video,
    add_watermark, add_intro_outro,
    extract_audio, replace_audio,
    live_slice, live_slice_by_markers,
    run_from_json
)

# 查看信息
info = get_video_info("input.mp4")
print(info)

# 截取
trim_video("input.mp4", "clip.mp4", start_time="00:05:00", end_time="00:10:00")

# 字幕生成+嵌入
generate_subtitles("input.mp4", model_size="base")
burn_subtitles("input.mp4", "output.mp4", "input.srt")
```

## 工作流配置 (JSON)

通过 `workflow` 命令可批量执行多步骤流水线:

```json
{
  "input": "input_video.mp4",
  "output": "output/final.mp4",
  "work_dir": "output",
  "steps": [
    {"action": "trim", "params": {"start": "00:05:00", "end": "00:10:00"}},
    {"action": "subtitle", "params": {"model": "base"}},
    {"action": "burn_subtitle", "params": {"font_size": 28}},
    {"action": "convert", "params": {"resolution": "1920x1080", "bitrate": "5M"}},
    {"action": "watermark", "params": {"image": "logo.png", "position": "top-right"}},
    {"action": "extract_audio", "params": {"format": "mp3"}}
  ]
}
```

## 安全说明

- 本工具仅操作**本地视频文件**，不联网、不上传数据
- Whisper 语音识别为本地模型，音频数据不出本机
- 所有 FFmpeg 命令仅作用于用户指定的文件路径，不涉及系统级操作
- 请确保输入文件来源可信，避免处理恶意构造的媒体文件

使用说明

# 视频剪辑自动化处理

一句话：基于 FFmpeg 与 Whisper 的本地视频自动化剪辑工具，一条命令完成截取、字幕、拼接、水印与批量工作流。

## 使用

```bash
python scripts/video_auto_editor.py check                    # 环境检查
python scripts/video_auto_editor.py trim input.mp4 -s 00:05:00 -e 00:10:00 -o clip.mp4
python scripts/video_auto_editor.py subtitle input.mp4 --model base
```

也可以直接对话：「把这段视频的 5 到 10 分钟剪出来并加上字幕」。

## 工作原理

技能封装 FFmpeg 命令与 Whisper 语音识别，提供截取、字幕生成与硬字幕嵌入、拼接、转码缩放、水印、音频处理、直播切片等子命令，并支持用 JSON 配置编排多步骤批量执行。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。