视频剪辑自动化处理技能 (video-auto-editor)
前置条件
必要依赖
-
FFmpeg — 核心视频处理引擎
- Windows: 下载后加入PATH，或放在~/.workbuddy/binaries/ffmpeg/bin/
- 验证:ffmpeg -version
- 本技能默认查找的系统PATH中的ffmpeg -
Python 3.8+ 及以下包:
bash pip install openai-whisper moviepy pillow
可选依赖
openpyxl— 如需写入Excel格式报告
用法
命令行方式
# 环境检查
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 方式
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 命令可批量执行多步骤流水线:
{
"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 命令仅作用于用户指定的文件路径，不涉及系统级操作
- 请确保输入文件来源可信，避免处理恶意构造的媒体文件
