# SRT-Edit-Review-Workbench

**Repository Path**: smallcatcake/srt-edit-review-workbench

## Basic Information

- **Project Name**: SRT-Edit-Review-Workbench
- **Description**: 剪辑课程视频
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SRT 剪辑审查工作台

一个基于 Electron + Python 的桌面工具，用于课堂/会议视频的字幕转录、字幕编辑、AI 审查结果导入、删除片段确认、视频剪辑、结果复核和字幕烧录。

## 功能概览

- 转录字幕：使用 VideoCaptioner 将视频转成 SRT 字幕。
- 编辑字幕：边看带字幕的视频边修改 SRT，并直接写回文件。
- 剪掉首尾：标记第一句和最后一句，剪辑时自动删除片头/片尾多余内容。
- 编辑删除：导入 AI 审查稿后逐条核对、修改 delete_range、预览要删除的片段。
- 开始剪辑：根据审查稿、首尾标记同步剪辑视频和 SRT。
- 结果复核：查看成片切口，标记是否连贯，并写回处理清单 Excel。
- 烧录字幕：将 SRT 字幕烧录进视频画面。

## 前置条件

### 1. Node.js

建议安装 Node.js 18 或更高版本。

检查：

```bash
node -v
npm -v
```

### 2. Python

建议安装 Python 3.10 或更高版本，并确保命令行可以运行：

```bash
python --version
```

### 3. Python 包

至少需要：

```bash
pip install openpyxl videocaptioner
```

说明：

- `openpyxl`：用于生成和更新删除处理清单 Excel。
- `videocaptioner`：用于“转录字幕”功能。

### 4. FFmpeg / FFprobe

需要安装 FFmpeg，并确保 `ffmpeg` 和 `ffprobe` 可以在命令行运行：

```bash
ffmpeg -version
ffprobe -version
```

如果没有加入 PATH，程序内也支持手动选择 `ffmpeg` / `ffprobe` 可执行文件路径。

## 安装与运行

克隆仓库后进入项目目录：

```bash
npm install
npm start
```

Windows 下也可以使用项目里的安装脚本：

```bash
npm run setup:windows
npm start
```

macOS 下推荐：

```bash
brew install ffmpeg
python3 -m pip install openpyxl videocaptioner
npm install
npm start
```

## 基本使用流程

1. 选择原视频。
2. 如还没有字幕，在“转录字幕”页点击“开始转录”生成 SRT。
3. 在“编辑字幕”页检查并修改字幕。
4. 复制审查 Prompt 到网页 AI，拿到 JSON 审查结果。
5. 导入 AI 结果生成审查稿。
6. 在“剪掉首尾”页标记第一句和最后一句。
7. 在“编辑删除”页逐条核对 delete_range。
8. 在“开始剪辑”页执行剪辑。
9. 在“结果复核”页检查切口是否连贯。
10. 在“烧录字幕”页生成带硬字幕的视频。

## 输出文件

默认输出目录是：

```text
原视频所在文件夹/outputs
```
建议不修改。
常见输出：

- `*_review.md`：审查稿。
- `*_cut.mp4`：剪辑后视频。
- `*_cut.srt`：同步剪辑后的字幕。
- `*_删除处理清单.xlsx`：删除处理清单和结果复核记录。
- `edit_log.txt`：剪辑日志。
- `*_cut_burned.mp4`：烧录字幕后的视频。

## 项目结构

```text
.
├─ electron/
│  ├─ main.js                 # Electron 主进程，负责文件选择、配置、调用 Python/FFmpeg
│  ├─ preload.js              # 暴露安全的桌面 API 给前端
│  └─ renderer/
│     ├─ index.html           # 应用界面结构
│     ├─ renderer.js          # 前端交互逻辑
│     └─ styles.css           # 界面样式
├─ apply_delete_ranges.py     # 根据审查稿 delete_range 更新 >>> 标记
├─ cut_video_and_srt.py       # 核心剪辑脚本，同步处理视频和 SRT
├─ generate_delete_checklist.py # 根据剪辑日志生成处理清单 Excel
├─ review_cut_checklist.py    # 读取/更新结果复核清单
├─ package.json               # Electron 项目配置
└─ package-lock.json          # npm 锁定文件
```

## 跨平台说明

当前程序已做基础跨平台兼容，Windows 和 macOS 都可以按依赖安装后运行。

兼容处理：

- Python 会自动优先尝试 `python`，失败后尝试 `python3`。
- FFmpeg/FFprobe 默认走 PATH，也可以在程序里手动选择可执行文件。
- VideoCaptioner 会优先尝试 `videocaptioner` 命令，失败后尝试 `python/python3 -m videocaptioner`。
- Windows 专用的 `setup:windows` 脚本不适用于 macOS，macOS 直接使用 `npm install`。

macOS 注意事项：

- 推荐用 Homebrew 安装 FFmpeg：`brew install ffmpeg`。
- 如果 `python3 -m pip install ...` 因权限或环境失败，建议先创建虚拟环境。
- VideoCaptioner 的模型或底层依赖可能会按系统环境下载，首次转录可能较慢。

## 常见问题

### 顶部显示 VideoCaptioner 不可用

运行：

```bash
pip install videocaptioner
```

然后重启程序或点击工具检测。

### 顶部显示 FFmpeg/FFprobe 不可用

安装 FFmpeg，并把 `ffmpeg` / `ffprobe` 加入 PATH。也可以在程序里手动选择可执行文件路径。

### 转录字幕不够准确

程序内转录是基础版本。如果错误较多，建议使用逐字稿文件让 AI 校准，或进一步用 AI 优化字幕。

### 剪辑速度慢

剪辑会尽量使用可用编码器。硬字幕烧录和复杂剪辑通常需要重新编码视频，因此速度会受 CPU/GPU 和 FFmpeg 编码器影响。