| 特性 | 说明 |
|---|---|
| 🤖 多引擎 OCR | PaddleOCR（默认）、EasyOCR、Tesseract 可切换；ONNX Runtime 推理，GPU 加速，256 帧 LRU 缓存 |
| ⚡ 五阶段后处理管道 | 标准化 → 去噪 → 合并分裂 → 相似度融合 → 时间校准 |
| 📦 9 种导出格式 | SRT · VTT · ASS · SSA · JSON · CSV · TXT · LRC · SBV |
| 🎬 智能场景检测 | FFmpeg select filter + Rust 原生实现，减少 60% 无效 OCR |
| 🔧 纯 Rust 后端 | Tokio 异步 I/O，无 Python 依赖，模型预热启动 |
| 🛡️ 置信度校准引擎 | CJK n-gram 分析、竖线检测、标点规范化，可视化质量信号 |
| 📐 ROI 预设 | 底部 · 顶部 · 左侧 · 右侧 · 中间 · 自定义 — 一键切换 |
| 📹 广泛视频格式 | MP4 · MKV · AVI · MOV · WebM · M4V · WMV · FLV · 3GP |
| 🎨 暗色/亮色主题 | 跟随系统或手动切换，设置持久化到 localStorage |
当前版本：v3.6.0
| 平台 | 下载链接 |
|---|---|
| Windows x64 | captionfab-v3.6.0-x64-setup.exe |
| macOS (Intel) | captionfab-v3.6.0-x64.dmg |
| macOS (Apple Silicon) | captionfab-v3.6.0-aarch64.dmg |
| Linux (Debian/Ubuntu) | captionfab-v3.6.0-amd64.deb |
# 前置依赖：Node.js 18+ · pnpm · Rust 1.82+ · FFmpeg
git clone https://github.com/Agions/caption-fab.git
cd CaptionFab
pnpm install
pnpm tauri dev # 开发模式（热重载）
pnpm tauri build # 生产构建导入视频 → 选择 ROI 区域 → 选择 OCR 引擎 → 开始提取 → 导出字幕
↓ ↓ ↓ ↓ ↓
拖拽/点击 底部字幕区 PaddleOCR 自动处理 SRT/VTT/ASS
| 层级 | 技术 | 版本 |
|---|---|---|
| 桌面框架 | Tauri | 2.x |
| 前端框架 | Vue 3 + TypeScript 5.9 + Vite 5 | Vue 3.5 |
| 状态管理 | Pinia | 2.x |
| 路由 | GoRouter (Tauri 侧) | — |
| 后端语言 | Rust + Tokio | 2021 edition |
| OCR 引擎 | PaddleOCR / EasyOCR / Tesseract | ONNX Runtime / WASM |
| 测试框架 | Vitest + cargo test | 398 个测试 |
| 构建工具 | Vite + pnpm | 5.x / 9.x |
CaptionFab/
├── src/ # 前端源码
│ ├── components/ # Vue 组件
│ │ ├── common/ # 通用组件 (Button, Modal, Toast...)
│ │ ├── layout/ # 布局组件 (Panel, Toolbar, VideoPreview...)
│ │ ├── subtitle/ # 字幕组件 (List, Card, SubExport...)
│ │ └── video/ # 视频组件 (Timeline, ROISelector...)
│ ├── composables/ # Vue 组合式函数
│ ├── core/ # 核心业务逻辑 (Pipeline, Calibrator, Exporter)
│ ├── stores/ # Pinia 状态管理
│ ├── utils/ # 工具函数
│ │ ├── image.ts # 图像处理 (灰度/对比度/模糊/缩放)
│ │ ├── image-deskew.ts # 文字倾斜矫正
│ │ ├── image-morph.ts # 形态学操作
│ │ ├── text.ts # CJK 检测 + 标点规范化
│ │ ├── lru-cache.ts # 泛型 LRU 缓存
│ │ └── detection.ts # 帧分析 + 空帧检测
│ └── types/ # TypeScript 类型定义
├── src-tauri/ # Rust 后端
│ ├── src/commands/ # Tauri 命令模块
│ └── Cargo.toml
└── package.json
| 检查项 | 标准 | 状态 |
|---|---|---|
| 前端类型检查 | vue-tsc --noEmit 零错误 |
✅ |
| 代码规范 | eslint src --ext .vue,.ts,.tsx 零错误 |
✅ |
| 单元测试 | vitest run 全部通过 |
✅ 372 passed |
| 后端编译 | cargo check 零警告 |
✅ |
| 生产构建 | pnpm run build |
✅ ~4.3s |
pnpm test # 运行前端测试 (372 个)
cargo test # 运行 Rust 测试
pnpm lint # ESLint 检查
pnpm type-check # vue-tsc 类型检查
pnpm tauri dev # 开发模式
pnpm tauri build # 生产构建欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'feat: add amazing feature' - 推送分支：
git push origin feature/amazing-feature - 创建 Pull Request
PR 要求：
- 通过
pnpm lint - 通过
pnpm type-check - 通过
pnpm test - 新增功能附带测试
- PR 标题遵循 Conventional Commits
- timeline hover 优化：
timeline-controller.vuerAF 节流 + 直接写 tooltip DOM，绕过 Vue 响应式 - video-preview hover 优化：
video-preview.vuetimeline hover 直接写 DOM - roi-selector 优化：拖拽时 rAF 直接写 DOM，删除
selectioncomputed - Vite 构建回归修复：消除
src/types/video.ts静态+动态混合导入警告 - 依赖清理：移除未使用的
@vueuse/core、@vue/language-server、@vue/theme - 死代码清理：移除
Exporter.ts未使用的exportBilingualSRT/VTT - 调试日志清理：移除
useExtractor.ts/settings.ts残留 console 语句
- 项目更名：SubLens → CaptionFab，全项目 97 处引用更新
- Rust 模块拆分：
utils.rs拆分为shared/shared_core/mod，净减 101 行 - OCR 引擎重构：5 模块拆分（session / cache / preprocess / postprocess / mod）
- 薄抽象层消除：
ocr+export合并为ocr_export - 错误字符串统一：新增
errors.rs - FFmpeg 调用统一：
run_command_with_timeout单入口 - Vue 组件命名：50 组件统一 kebab-case
- 死代码扫描：批量删除未使用导出和 barrel 模块
本项目采用 MIT License 开源。
| 项目 | 用途 |
|---|---|
| Tauri | 轻量级桌面应用框架 |
| Vue.js | 响应式前端框架 |
| PaddleOCR | 多语言 OCR 引擎 |
| EasyOCR | 深度学习 OCR 引擎 |
| Tesseract | 传统 OCR 引擎 |
| ONNX Runtime | 模型推理运行时 |
| FFmpeg | 视频处理 |
| Pinia | Vue 状态管理 |
Made with ❤️ by Agions