快速上手：三步开始看无字幕视频

准备

Tontrans 采用「Chrome 扩展（擷取与显示）+ 本机 Python 后端（AI 大脑）」的双轨架构。开始前确保：

• Windows 或 macOS 电脑
• Chrome / Edge 等 Chromium 内核浏览器
• （可选）NVIDIA GPU，用于 Ollama 本地翻译加速

第一步：启动后端服务

后端负责 VAD 断句、语音识别与翻译。下载离线整合包后双击 START_Tontrans_Server.bat；或从源码运行：

cd backend
pip install -r requirements.txt
python download_models.py
python main.py

当终端出现 Uvicorn running on http://127.0.0.1:8000 即启动成功，请保持窗口开启。

第二步：载入 Chrome 扩展

1. 浏览器打开 chrome://extensions/
2. 开启右上角「开发者模式」
3. 点「加载已解压的扩展程序」，选择 extension-next 目录

工具栏出现 Tontrans 图标即安装完成。若想使用账号体系，可在插件面板「注册」入口用邮箱验证码注册并登录。

第三步：打开视频，开启字幕

1. 前往 YouTube 或任意视频网站播放影片
2. 点 Tontrans 图标，翻译服务按需选择（默认用后端配置）
3. 点「启动实时字幕」

页面底部即浮现毛玻璃双语字幕。识别约在句级 100–300ms 内回显，几乎「随说随翻」。

桌面端（整机声音）

需要给非浏览器软件（会议、播放器）加字幕时，运行桌面客户端 TontransDesktop.exe：它捕获整机默认播放设备的声音，复用同一后端输出桌面悬浮字幕。