划词朗读翻译

一个运行在 Windows 上的 AutoHotkey v2 工具：选中文本后，可以朗读、翻译、单词解析、截图 OCR、跟读和维护生词本。

功能

• 选中文本后右键朗读或翻译
• Kimi 翻译与单词解析
• Azure Speech 朗读；未配置 Azure 时可回退到 Edge TTS
• 百度 OCR 截图识别
• 原文、译文和生词本管理
• 坚果云 WebDAV 同步词库
• 朗读缓存、翻译历史和跟读模式

运行环境

• Windows 10/11
• AutoHotkey v2
• Python 3.13
• Python 依赖见 requirements.txt

翻译至少需要 Kimi API Key；Azure Speech、百度 OCR 和坚果云同步是可选功能。

安装

1. 安装 AutoHotkey v2 和 Python 3.13。

2. 在项目目录安装 Python 依赖：

   py -3 -m pip install -r requirements.txt

3. 复制配置模板：

   Copy-Item tts_translate.example.ini tts_translate.ini

4. 编辑本地 tts_translate.ini，至少填写 [Kimi] 下的 ApiKey。

5. 双击 划词朗读翻译.ahk 启动。

tts_translate.ini 只用于本机，已被 .gitignore 排除，不能提交到 Git 或上传到 GitHub。

常用操作

操作	快捷键
朗读选中文本	Ctrl+Alt+S
翻译并解析选中文本	Ctrl+Alt+F
停止朗读	Ctrl+Alt+X
暂停/继续	Ctrl+Alt+P
下一句 / 上一句	Ctrl+Alt+N / Ctrl+Alt+B
截图 OCR	Ctrl+Alt+O
调快 / 调慢语速	Ctrl+Alt+↑ / Ctrl+Alt+↓
右键菜单	选中文本后右键
强制显示菜单	Ctrl + 右键

右键菜单和托盘菜单还提供生词本、翻译历史、坚果云同步、设置和使用说明。

配置说明

配置段	用途	必填
[Kimi]	翻译和单词解析	ApiKey
[TTS]	Azure/Edge 朗读和语速	否
[BaiduOCR]	截图 OCR	使用 OCR 时必填
[Nutstore]	坚果云 WebDAV 同步	使用同步时必填
[Hotkey]	是否启用普通右键菜单	否

也可以通过环境变量提供部分凭据；具体行为以脚本和模板为准。不要把凭据写入源码、文档、Issue、日志或提交历史。

隐私说明

根据启用的功能，选中文本或截图可能会发送到 Kimi、Microsoft Azure、Edge TTS 或百度等第三方服务。翻译历史、生词本、缓存和 OCR 中间文件默认保存在本机；坚果云同步开启后，词库及删除标记会上传到配置的 WebDAV 服务。

请不要把密码、身份证号、内部资料或其他敏感信息发送给未评估的第三方服务。使用前请阅读相关服务的隐私政策和计费规则。

开发与验证

python -m py_compile tts_helper.py
python tts_helper.py selftest
python tts_helper.py deps

selftest 不需要真实 API Key。完整功能还需要在 Windows + AutoHotkey v2 环境中手动验证翻译、朗读、OCR、取消、缓存和双端同步。

已知限制

• 翻译、OCR 和部分朗读功能依赖网络及第三方服务。
• 当前项目不是服务端应用，不提供集中式账号、权限和密钥托管。
• 第三方服务的可用性、价格、接口和地区限制可能变化。

贡献与安全

请先阅读 CONTRIBUTING.md 和 SECURITY.md。发现凭据泄露时不要创建公开 Issue，应立即吊销凭据并通过私下渠道联系维护者。

许可证

本项目以 MIT License 发布，详见 LICENSE。