Skip to content

About

轻量、快速的 Windows 划词 AI 翻译工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

QuickTranslator · 划词翻译

Windows 桌面 AI 翻译工具,支持科研术语、Qwen-MT 翻译记忆、流式输出和系统托盘常驻。

下载与安装

从 Releases 下载便携 ZIP,完整解压后运行 QuickTranslator.exe。便携版自带运行库,无须安装 Python,不能只取出 EXE 使用。

运行 install.bat 可安装到 %LOCALAPPDATA%\Programs\QuickTranslator,并创建开始菜单及 当前用户的开机启动入口。需要固定到开始菜单时,搜索 QuickTranslator 并选择“固定到开始屏幕”。

升级时运行新版本中的 install.bat。安装器校验文件并自检,保留上一版,启动失败时自动回滚。 用户设置和翻译记忆保存在 AppData 中,升级不会覆盖。卸载脚本为 uninstall.ps1。 覆盖升级、备份、验证和回滚操作详见 升级说明,也可将该说明交给目标电脑上的助手执行。

首次配置

未配置密钥时,程序自动打开设置。填写“专业 Qwen-MT”或“通用 AI 服务”中的 API Key 后保存。 服务商预设自动填写地址和模型,仍可按服务商控制台实际可用情况修改。

支持阿里云 Qwen-MT、智谱 GLM、DeepSeek、Kimi / Moonshot、硅基流动、OpenAI,以及自定义 OpenAI Chat Completions 兼容接口。API 服务的收费、额度和模型可用性由对应服务商决定。

填写百炼密钥后优先使用 Qwen-MT:精准模式使用 qwen-mt-plus,极速模式使用 qwen-mt-turbo。 未填写百炼密钥或请求失败时,使用配置的通用 AI 服务。

使用方法

按住 Ctrl,在 0.5 秒内按下、松开 C 两次,随后松开 Ctrl。

  • 新选中文字:复制选区并翻译,在光标附近显示流式译文。
  • 没有新复制的文本:显示当前会话中的上次翻译,不重新调用 API。
  • 再次复制相同原文:找回现有译文;上次请求失败时允许重试。
  • Esc 或关闭按钮:隐藏窗口。托盘菜单也可显示窗口、打开设置或退出。

译文窗口默认保持置顶,切换或关闭其他窗口不会自动隐藏译文。底栏“已置顶”按钮可切换为普通 窗口层级,选择保存在本机。普通层级下,译文可能被其他窗口遮住,快捷键可重新找回。

单次 Ctrl+C 保持普通复制;双击 Ctrl、双击 Shift 均不触发翻译窗口。 程序观察用户执行的复制,不额外模拟按键,也不自动清空、备份或恢复剪贴板。 成功复制选区仍会按 Windows 的正常行为覆盖原剪贴板。

译文窗口随流式内容平滑扩大。鼠标靠近四边、四角或右下角时可拖动调整尺寸,手动调整后当前 任务保持该尺寸。“复制译文”会将译文写入剪贴板。

拖动窗口期间暂停自动扩高,松开鼠标后继续根据内容调整高度,并保持拖动后的位置。 窗口下方空间不足时使用滚动条;自动排版不会将窗口移回旧位置。手动缩放优先于当前任务的自动尺寸。

科研翻译

在设置中填写研究领域和术语表。示例:

cell culture=细胞培养; power=统计功效

Qwen-MT 可自动识别中英翻译方向,并接收领域、术语表和相关翻译记忆。 译文可编辑,修订后点击“确认译文”存入本地记忆,后续相似内容选取相关的历史译文作为参考。 阅读论文时建议选取完整句子或段落,以提供充分语境。

隐私

密钥和设置保存在 %APPDATA%\QuickTranslator\config.json,该文件包含明文密钥,请勿公开。 翻译记忆保存在同目录的 translation_memory.json。源码仓库与发布包均不包含用户配置。 原文、领域提示、术语及匹配的翻译记忆会发送给所配置的模型服务;备用通道启用时可能切换服务商。

在程序自身设置窗口中复制密钥不会触发翻译。包含当前已配置密钥的文本也会被拦截。 这不是通用的密码检测工具,敏感文字仍需谨慎选择。

从源码运行

需要 Windows 和 Python 3.10 或更高版本:

git clone https://github.com/chyThor/QuickTranslator.git
cd QuickTranslator
python -m pip install -r requirements.txt
python app.py

也可使用 run.bat。测试命令为 python -m unittest -v test_app.py。

构建

安装 PyInstaller:python -m pip install pyinstaller,随后运行 build_portable.bat。 脚本生成 dist\QuickTranslator、版本号便携 ZIP 和文件完整性清单。 正式版本的源码标签和便携包在 GitHub Releases 中发布。

已知限制与常见问题

  • 仅支持 Windows,读取文字依赖目标应用正确响应 Ctrl+C。
  • 为区分“没有选区却复制整行”的编辑器,程序在后台只读检查选区是否存在;翻译文本仍来自 剪贴板。应用不提供选区接口或接口超时时,退回剪贴板变化判断。在这些软件中,无选区复制整行 仍可能被视为新文本。
  • 部分应用复制相同文字不会更新剪贴板序列号,此时找回原译文。
  • 快捷键适用于普通权限应用;高权限应用、安全桌面及自定义复制快捷键可能不兼容。
  • PDF 视觉换行会尽量合并;扫描版、复杂公式和乱码尚不支持可靠还原。
  • 无选区时找回的是本次运行保留的内容,退出程序后不会自动恢复上次窗口。

参与贡献

问题和建议可提交到 Issues。提交代码时附上 复现方式和验证结果;请勿提交 API Key、用户配置或翻译记忆。项目使用 MIT License。

About

轻量、快速的 Windows 划词 AI 翻译工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages