Video Pipeline Bundle — Video 流水线 Bundle

Video 流水线 Bundle

视频一站式工作流技能包，整合剪辑、转写、烧录、拼接全流程。

文件结构 video-流水线-bundle/ ├── 技能.md └── scripts/ ├── 流水线.py # 工作流编排 ├── video_命令行工具p.py # 视频剪辑（去静音） ├── video_to_text.py # 语音转字幕 ├── burn_subtitle.py # 烧录字幕 └── ffmpeg_工具s.py # FFmpeg 工具箱

依赖 ffmpeg + ffprobe Python 3.8+ auto-editor（视频剪辑） faster-whisper + 请求s（语音转写） MiniMax API Key（LLM 纠错） 安装与配置

• 自动安装依赖

首次使用时，脚本会自动检测并安装所需依赖：

# 自动检测并安装 python3 技能s/video-流水线-bundle/scripts/流水线.py --安装-deps

自动安装的内容：

pip3 安装 auto-editor --break-系统-packages pip3 安装 faster-whisper 请求s

• 配置 MiniMax API Key

方式一：环境变量（推荐）

导出 MINIMAX_API_KEY="your-API-key-here"

方式二：运行时传入

python3 技能s/video-流水线-bundle/scripts/流水线.py \ --all \ --输入 "/path/to/videos" \ --API-key "your-API-key-here"

获取 API Key：

访问 MiniMax 开放平台 注册账号并创建 API Key 充值或获取免费额度

• 依赖检查脚本

如果不确定环境是否满足要求，可以运行：

python3 技能s/video-流水线-bundle/scripts/流水线.py --检查-deps

输出示例：

✅ ffmpeg: 已安装 (6.1.1) ❌ auto-editor: 未安装 ❌ faster-whisper: 未安装 ❌ MINIMAX_API_KEY: 未设置

请运行: python3 技能s/video-流水线-bundle/scripts/流水线.py --安装-deps

如果有存在未安装的，就自动检测用户系统并帮用户安装。

核心功能

• 视频剪辑 (video_命令行工具p.py)

去除视频中的静音片段，保留有效内容。

python3 技能s/video-流水线-bundle/scripts/video_命令行工具p.py \ --输入 "/path/to/输入.mp4" \ --输出 "/path/to/输出.mp4" \ --threshold -40

• 语音转写 (video_to_text.py)

用 Faster Whisper 识别语音，生成 SRT 字幕，然后用 MiniMax LLM 词级别纠错。

python3 技能s/video-流水线-bundle/scripts/video_to_text.py \ --输入 "/path/to/video.mp4" \ --输出 "/path/to/subtitle.srt" \ --模型 small \ --API-key "your-API-key"

参数：

参数 说明 默认 --模型 Whisper 模型 (tiny/small/base) small --margin 静音片段缓冲秒数 0.5 --API-key MiniMax API Key 环境变量 MINIMAX_API_KEY

模型选择：

模型 内存 速度 tiny ~1GB 最快 small ~2GB 较快 base ~3GB 中等

• 烧录字幕 (burn_subtitle.py)

将 SRT 字幕烧录进视频。

python3 技能s/video-流水线-bundle/scripts/burn_subtitle.py \ --输入 "/path/to/video.mp4" \ --subtitle "/path/to/subtitle.srt" \ --输出 "/path/to/输出.mp4"

• FFmpeg 工具箱 (ffmpeg_工具s.py)

支持拼接、格式转换等操作。

# 拼接视频 python3 技能s/video-流水线-bundle/scripts/ffmpeg_工具s.py concat \ --输入s "1.mp4" "2.mp4" \ --输出 "merged.mp4"

# 格式转换 python3 技能s/video-流水线-bundle/scripts/ffmpeg_工具s.py convert \ --输入 "video.mov" \ --输出 "video.mp4"

# 查看视频信息 python3 技能s/video-流水线-bundle/scripts/ffmpeg_工具s.py 信息 \ --输入 "/path/to/videos"

• 完整工作流 (流水线.py)

一站式处理，支持分步执行。

# 检查依赖 python3 技能s/video-流水线-bundle/scripts/流水线.py --检查-deps

# 安装依赖 python3 技能s/video-流水线-bundle/scripts/流水线.py --安装-deps

# 扫描目录 python3 技能s/video-流水线-bundle/scripts/流水线.py \ --列出 \ --输入 "/path/to/videos"

# 执行单步 python3 技能s/video-流水线-bundle/scripts/流水线.py \ --step 1 \ --输入 "/path/to/videos" \ --输出 "/path/to/输出"

# 执行全量 python3 技能s/video-流水线-bundle/scripts/流水线.py \ --all \ --输入 "/path/to/videos" \ --输出 "/path/to/输出" \ --subtitle "/path/to/subtitles" \ --API-key "your-API-key"

# 带确认模式 python3 技能s/video-流水线-bundle/scripts/流水线.py \ --all \ --输入 "/path/to/videos" \ --输出 "/path/to/输出" \ --confirm

步骤说明 步骤 功能 输入 输出 1 剪辑（去静音） 原始视频 已剪辑视频 2 转写（生成字幕） 已剪辑视频 SRT 字幕 3 烧录 已剪辑视频 + 字幕 已烧录视频 4 拼接 多个视频 合并视频 输出目录结构 输入目录/ ├── 文字稿/ # 字幕文件 ├── 项目名/ # 处理后的视频 │ ├── 1_已剪辑.mp4 │ └── 2_已剪辑.mp4 └── 项目名_成品/ # 最终成品 └── 合并视频.mp4

⚠️ 安全注意事项

• 消息通知（可选，默认关闭）

脚本支持发送进度通知到 Feishu，但：

默认不发送消息（--通知 false 即可禁用） 如需启用，请设置 OpenClaw_TAR获取 环境变量为可信目标 通知内容会包含文件名，请注意信息安全 # 禁用通知（推荐） python3 ... --通知 false

# 启用通知（仅可信目标） 导出 OpenClaw_TAR获取="your-safe-tar获取"

• 自动安装（默认仅提示）

--安装-deps 选项会检测缺失的依赖并提供安装命令，但：

不会自动执行 sudo/apt-获取/brew 仅显示需要手动执行的命令 建议在虚拟环境或容器中安装

• API Key 安全

使用环境变量 MINIMAX_API_KEY 而非硬编码 或使用 --API-key 参数（注意命令历史） 建议使用受限权限的 API Key

• 建议的测试方式

# 1. 先检查依赖 python3 技能s/video-流水线-bundle/scripts/流水线.py --检查-deps

# 2. 手动安装缺失的依赖（不要用 --安装-deps 自动安装系统包）

# 3. 在隔离环境测试 python3 技能s/video-流水线-bundle/scripts/流水线.py \ --列出 \ --输入 "/path/to/test/videos" \ --通知 false

常见问题

Q: 提示 "auto-editor 未安装" A: 运行 python3 技能s/video-流水线-bundle/scripts/流水线.py --安装-deps

Q: 提示 "MINIMAX_API_KEY 未设置" A: 设置环境变量 导出 MINIMAX_API_KEY="your-key"，或使用 --API-key 参数

Q: 显存不够怎么办？ A: 使用 --模型 tiny 参数，tiny 模型只需要 ~1GB 内存

Q: ffmpeg 未安装？ A: Ubuntu/Debian: sudo apt 安装 ffmpeg | macOS: brew 安装 ffmpeg | Windows: 下载 ffmpeg.exe