1. 快速入门
WANGTranslate 是一款免费、开源的 Windows 桌面应用，将 AI 翻译与本地 OCR 文字识别相结合。它兼容任意 OpenAI 格式的 API 端点，让你完全掌控使用哪个 AI 服务。
系统要求
- 操作系统：Windows 10 或 Windows 11（64 位）
- 磁盘空间：约 200 MB（含 OCR 语言数据缓存）
- 网络：使用 AI 翻译时需要网络（使用 Ollama 或 LM Studio 等本地端点则不需要）
- API：需要 OpenAI 兼容服务的 API Key，或本地运行的大模型服务
三步上手
- 下载并运行安装程序，或使用便携版
- 启动 WANGTranslate——它会最小化到系统托盘
- 右键托盘图标，打开设置
- 进入 API 选项卡，添加你的 API 端点和 Key
- 在快捷键选项卡中配置你习惯的组合键
- 开始翻译！
2. 安装方式
WANGTranslate 提供两种分发方式：
安装版（NSIS 安装程序）
WANGTranslate Setup 1.0.0.exe（约 89 MB）
- 标准 Windows 安装向导
- 可自选安装目录
- 创建桌面快捷方式和开始菜单项
- 支持通过 Windows 设置卸载
便携版
WANGTranslate-portable.exe（约 88 MB）
- 无需安装，双击即用
- 所有文件自包含
- 用户数据保存在
%APPDATA%/WANGTranslate/ - 适合放在 U 盘或临时使用
从源码构建
如果你想从源码自行构建：
# 环境要求：Node.js v22+，npm v11+
npm install
npm start # 开发模式
npx electron-builder --win --publish=never # 构建分发版本3. API 设置
WANGTranslate 兼容任意 OpenAI 格式的 Chat Completions API。你提供端点 URL 和 API Key——软件本身不含任何内置翻译服务。
常见预设端点
| 服务 | URL | 说明 |
|---|---|---|
| OpenAI | https://api.openai.com/v1 | 需要 API Key |
| LM Studio | http://localhost:1234/v1 | 本地运行，免费 |
| Ollama | http://localhost:11434/v1 | 本地运行，免费 |
| 自定义 | 你自己的 URL | 任何 OpenAI 兼容端点 |
API 请求格式
POST {baseUrl}/v1/chat/completions
System Prompt（系统提示词）：
"You are a professional translator..."
（要求只输出译文，不输出原文、解释等额外内容）
User Message（用户消息）：
"Translate the following text from {源语言} to {目标语言}.
Output only the translation without any additional text:
---
{用户文字}
---"
请求参数：
temperature=0.3, max_tokens=4096智能 URL 处理
- 如果 URL 已包含
/v1/，直接使用 - 如果不含
/v1，自动追加/v1/ - 请求失败时尝试替代路径（去掉或添加
/v1） - 全部失败后弹出错误通知
多 API 端点并发
你可以配置多个 API 端点并同时启用它们。翻译时，WANGTranslate 会并发调用所有已启用的端点，将结果并排显示——非常适合对比不同模型的翻译质量。
4. 翻译模式
划词翻译
- 在任意应用中选择文字
- 按下你配置的快捷键
- WANGTranslate 会模拟 Ctrl+C 读取剪贴板，并在 800ms 内恢复剪贴板原内容
- 翻译结果以圆角悬浮窗展示
输入翻译
通过托盘菜单或快捷键打开输入翻译窗口，键入或粘贴任意文字，获取所有已启用 API 的并排翻译结果。
支持的翻译语言
自动检测、简体中文、繁体中文、英文、日文、韩文、法文、德文、西班牙文、俄文、葡萄牙文、意大利文、阿拉伯文、泰文、越南文、印尼文、荷兰文、波兰文、土耳其文、乌克兰文——共 20 种语言。
5. OCR 指南
WANGTranslate 使用 tesseract.js——一款纯 JavaScript 的 OCR 引擎，通过 WebAssembly 在本地离线运行。不需要安装任何外部 OCR 软件。
OCR 模式
| 模式 | 工作方式 |
|---|---|
| 截图 OCR | 按下快捷键 → 框选屏幕区域 → OCR 提取文字 → 复制或发送到翻译 |
| 静默 OCR | 同上，但结果直接复制到剪贴板，不弹出窗口 |
| 选图 OCR | 选择本地图片文件进行文字识别 |
支持的 OCR 语言
| 代码 | 语言 |
|---|---|
eng | 英文 (English) |
chi_sim | 简体中文 |
chi_tra | 繁体中文 |
jpn | 日文 (Japanese) |
kor | 韩文 (Korean) |
fra | 法文 (French) |
deu | 德文 (German) |
spa | 西班牙文 (Spanish) |
rus | 俄文 (Russian) |
OCR 设置项
- PSM（页面分割模式）：默认为 6（均匀文本块），可在设置中调整
- 连续识别：保持 OCR 窗口打开，可连续多次截图
- 自动复制：识别结果自动复制到剪贴板
- 智能分段：智能合并文字为自然段落
注意：首次使用时，tesseract.js 会下载所需的语言数据文件（约 10–15 MB / 每种语言）并缓存到本地。仅初次下载需要网络。
6. 快捷键配置
所有快捷键默认为未绑定状态。你需要在设置 → 快捷键选项卡中自行分配。
可配置的操作
| 操作 | 说明 |
|---|---|
| 翻译选中文字 | 翻译当前选中/高亮的文字 |
| 截图 OCR | 框选屏幕区域进行 OCR 识别 |
| 静默 OCR | 框选区域 OCR 并将结果静默复制到剪贴板 |
| 图片 OCR | 打开文件对话框选择图片进行 OCR |
| 输入翻译 | 打开文字输入翻译窗口 |
| 显示/隐藏窗口 | 切换主程序窗口的显示 |
支持的修饰键
Ctrl、Alt、Shift、Win——可与任意字母、数字或功能键组合。
7. 语音朗读
WANGTranslate 使用 Web Speech API 调用系统内置 TTS（文字转语音）引擎朗读翻译结果。
- 可朗读原文或译文
- 语速、音调、音量均可调节
- 使用 Windows 系统已安装的语音包
- 无需网络——完全本地处理
8. 历史记录与收藏
WANGTranslate 自动保存以下记录：
- 翻译历史：原文、译文、语言选择、时间戳
- OCR 历史：识别文字、语言、时间戳
功能特色：
- 支持搜索历史记录
- 支持星标/收藏重要内容
- 可按收藏筛选
- 所有数据均本地存储——不发送到任何地方
9. 数据存储
所有用户数据通过 electron-store 保存在：
%APPDATA%/Roaming/WANGTranslate/config.json| 数据项 | 键名 | 类型 |
|---|---|---|
| 翻译源语言 | sourceLanguage | string |
| 翻译目标语言 | targetLanguage | string |
| API 配置列表 | apiConfigs | array |
| 已启用 API 索引 | enabledApiIndices | array |
| 快捷键绑定 | hotkeyConfigs | object |
| OCR 语言列表 | ocrLanguages | string |
| OCR 设置 | ocrPsm、ocrContinuous、ocrAutoCopy、ocrSmartParagraph | 多种 |
| TTS 设置 | ttsRate、ttsPitch、ttsVolume | number |
| 界面语言 | appLanguage | string（"zh" 或 "en"） |
| 开机自启 | autoLaunch | boolean |
| 翻译历史 | translateHistory | array |
| OCR 历史 | ocrHistory | array |
10. 常见问题
使用 WANGTranslate 需要 API Key 吗？
是的。WANGTranslate 本身是一个翻译客户端，不是翻译服务。你需要将它连接到 AI API 端点（OpenAI、Ollama、LM Studio 等任意兼容服务）。软件本身不含翻译能力——它只是把你的文本发送到你配置的 API。
我的数据除了发到 API 端点，还会发到其他地方吗？
不会。WANGTranslate 将你的翻译文本仅发送到你配置的 API 端点。OCR 完全在你的设备上运行。该软件没有任何分析统计、遥测或第三方追踪。你的 API Key 和配置都存储在本地，绝不出你电脑。
可以完全离线使用吗？
OCR 在初次下载语言数据后可完全离线运行。翻译方面，你可以在本机运行本地大模型服务（如 Ollama 或 LM Studio）——这样所有数据都保持在离线状态。
OCR 能识别手写文字吗？
tesseract.js 对手写文字的识别能力有限，对印刷文字效果最好。手写文字的识别效果视清晰度而定。
安装版和便携版有什么区别？
安装版与 Windows 系统集成（开始菜单、桌面快捷方式、卸载程序）。便携版是单个 .exe 文件，可放在任何地方直接运行——无需安装、不写注册表、不创建开始菜单项。两者的用户数据存放位置相同。
为什么选择 Electron 框架？
相比 Flutter（约 5 GB SDK + 需要开发者模式）等方案，Electron 的工具链更轻量。只需要 Node.js v22+ 和简单的 npm install 即可构建和运行。打包后约 88 MB，对于带有内嵌浏览器运行时的桌面应用来说体量合理。