Videocut

智能口播视频剪辑工具 - 自动识别口误，一键生成精剪视频

功能特点

• 智能转录 - 自动将视频语音转为文字，带精确时间戳
• AI 文案重组 - 分析转录内容，生成精简方案（可选）
• 口误识别 - 自动识别口误、语气词、长静音
• 一键剪辑 - 确认后自动剪辑，输出成品视频
• 多种输出 - 支持本地烧录字幕或推送剪映草稿箱

安装

pip install videocut

系统要求

• Python 3.10+
• FFmpeg（视频处理）
• 约 2GB 磁盘空间（语音识别模型）

安装 FFmpeg

# macOS
brew install ffmpeg

# Windows (使用 Chocolatey)
choco install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

快速开始

1. 首次配置

videocut init

按提示完成：

1. 输入 License Key
2. 配置 AI 服务（OpenAI/Claude/兼容服务）
3. 选择默认输出方式（本地/剪映）

2. 剪辑视频

videocut cut 口播视频.mp4

工具会自动：

1. 转录视频内容（首次运行会下载模型）
2. AI 分析生成重组方案（可选）
3. 识别口误、语气词、静音
4. 显示删除任务，等待确认
5. 执行剪辑，输出成品

3. 查看状态

videocut status

显示 License 有效期和当前配置。

命令参考

videocut cut

剪辑视频的主命令。

videocut cut <video> [OPTIONS]

Options:
  -o, --output [local|jianying]  输出方式
                                 local: 本地输出（可烧录字幕）
                                 jianying: 推送到剪映草稿箱
  --skip-ai                      跳过 AI 文案重组
  --help                         显示帮助

示例：

# 基础用法
videocut cut video.mp4

# 跳过 AI 分析（更快）
videocut cut video.mp4 --skip-ai

# 输出到剪映
videocut cut video.mp4 -o jianying

videocut init

首次配置向导。

videocut status

查看 License 和配置状态。

videocut config

修改现有配置。

识别能力

| 类型 | 说明 | 示例 | |------|------|------| | 重复型口误 | 连续重复的短语 | "这是这是一个" | | 卡顿型口误 | 连续重复的字 | "我是是测试" | | 语气词 | 无意义的填充词 | "嗯"、"啊"、"呃" | | 长静音 | 超过1秒的停顿 | 句间超长停顿 |

输出文件

本地输出时，会生成以下文件：

原视频.mp4
├── 原视频_cut.mp4      # 剪辑后的视频
├── 原视频_cut.srt      # SRT 字幕文件
└── 原视频_final.mp4    # 烧录字幕后的最终视频

配置文件

配置存储在 ~/.videocut/config.json：

{
  "license_key": "VC-XXXX-XXXX-XXXX",
  "output_mode": "local",
  "llm": {
    "provider": "openai",
    "model": "gpt-4o"
  }
}

常见问题

Q: 首次运行很慢？

A: 首次运行会下载语音识别模型（约1GB），后续会使用缓存。

Q: 如何跳过 AI 分析？

A: 使用 --skip-ai 参数：videocut cut video.mp4 --skip-ai

Q: 支持哪些视频格式？

A: 支持 FFmpeg 能处理的所有格式，包括 MP4、MOV、AVI、MKV 等。

Q: 剪映输出失败？

A: 确保剪映已安装并至少打开过一次，让它创建草稿目录。

Q: API Key 安全吗？

A: API Key 使用设备特定密钥加密存储，不会明文保存。

效率数据

• 手动剪辑: 约 30-60 分钟/视频
• 使用 Videocut: 约 3-5 分钟/视频
• 时间节省: 约 90%

License

MIT License

---

Made with Claude Code