源码系统概览
文章正文
妙幕 SmartSub 是一款免费开源的一站式桌面字幕工具，源码基于 Electron 与 Next.js（nextron）构建。它把视频转字幕、字幕翻译、AI 配音与声音克隆、字幕烧录等环节整合进同一个桌面应用，主打本地离线、隐私友好与全平台 GPU 加速。项目在 GitHub 收获数千 Star，是字幕处理领域较完整的开源实现之一。
源码简介
SmartSub 采用 Electron + Next.js（nextron）框架，主进程与渲染进程职责清晰，TypeScript 贯穿全栈。语音转文字基于本地模型，集成 whisper.cpp、sherpa-onnx 与 faster-whisper（CTranslate2），可在本机离线完成转写，文件不出本机。字幕翻译支持二十余种翻译服务，含免费接口与主流大模型；AI 配音与声音克隆支持本地 Kokoro / VITS / ZipVoice 与云端 Edge TTS 等多种引擎。项目采用 MIT 许可证，附带完整的文档站（Docusaurus）与多语言界面，社区活跃、可维护性强。
适用场景
视频创作者需要为作品批量生成与翻译字幕，并烧录成硬字幕或软封装。需要把外语视频本地化、做双语字幕或 AI 配音的内容团队。关注隐私、希望转写与翻译流水线完全离线运行的个人与小团队。
功能亮点
本地离线转写：基于 Whisper / FunASR 等模型，支持 CUDA、Vulkan、Core ML 等多种硬件加速。多引擎翻译：内置二十余种翻译服务，可混合免费与 AI 大模型方案。AI 配音与声音克隆：本地 Kokoro / VITS / ZipVoice，云端 Edge TTS，支持声音克隆。字幕烧录与下载：支持硬字幕烧录与软封装，并内置 B 站 / YouTube 等在线视频下载能力。批量与多语言：支持批量任务处理，界面提供中文、英文、日文等多语言包。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：Next.js（React）+ TypeScript + Tailwind CSS
后端：Electron |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 开发环境使用 yarn 安装依赖，主进程与渲染进程分离调试； | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 本地离线转写：基于 Whisper / FunASR 等模型，支持 CUDA、Vulkan、Core ML 等多种硬件加 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：Next.js（React）+ TypeScript + Tailwind CSS
后端：Electron 主进程（Node.js），负责本地模型调用与系统交互
数据库：本地配置与任务状态以文件/存储管理，无独立数据库服务
运行环境：Windows / macOS / Linux；需 Node.js 与本地推理运行时（whisper.cpp / sherpa-onnx）
其他依赖：ffmpeg（内置）、electron-builder 打包、yarn 包管理、flash-attn（部分模型）
安装与部署提示
开发环境使用 yarn 安装依赖，主进程与渲染进程分离调试；打包通过 electron-builder 与 GitHub Actions 完成跨平台构建。首次使用需下载对应的语音识别与配音模型，可在设置中切换 GPU 后端（CUDA / Vulkan / Core ML）以获得加速。字幕翻译与云端配音需要配置对应的 API 密钥，本地模型路径可在设置中自定义。
截图与演示说明
应用主界面集中展示导入视频、转写进度与字幕编辑区，操作直观。合并与校对页面支持原文与译文对照、人工润色与术语表管理。设置页提供翻译服务、GPU 后端与模型下载路径等配置项，便于按机器环境调优。
常见问题
问：转写是否必须联网？
答：本地模型转写完全离线，仅使用云端翻译或云端配音时才需要联网并配置密钥。
问：支持哪些平台？
答：支持 Windows、macOS 与 Linux，并可通过 electron-builder 打包为各平台安装包。
安全风险提示
源码会调用本地子进程拉起 whisper.cpp、ffmpeg、Python 运行时等完成转写与合成，属于桌面工具的正常行为。特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。使用云端翻译或配音服务时，请遵守对应平台的服务条款并妥善保管自己的 API 密钥，避免泄露。
GitHub项目开源地址：https://github.com/buxuku/SmartSub