📖 开箱即用的 PDF 学术翻译神器 | Win + Mac 双平台 | 公式排版完美保留 · Zotero 深度联动 · 35 种语言 · 20+ AI 翻译引擎 · 表格/OCR/术语库 · 批量翻译 | 基于 PDFMathTranslate (EMNLP 2025)
432
stars
93
commits
Python
primary language
Sep 4, 2026
updated
🎉 无需安装 Python · 无需配置环境 · 下载解压双击就能用!
🖥️ 支持 Windows + macOS 双平台
📘 强烈推荐先看 → 完整图文使用教程(macOS)真实截图 · 每一步带红圈编号 · 配 API · 扫描件处理 · 常见问题 |
![]() ① 主界面 · 拖入 PDF · 选语言 · 一键开始 |
![]() ② 阅读页 · 中外对照 · AI 助手自动解读论文 |
快速开始 · 功能特性 · 翻译服务 · Zotero 联动 · 更新日志 · English
💬 用户交流群(QQ):1094195179(pdf2zh桌面版交流群)
基于 PDFMathTranslate(EMNLP 2025)打造,在原项目基础上大幅增强桌面体验。
让学术 PDF 翻译变得像复制粘贴一样简单——公式、图表、排版全部完美保留 ✨
还在为翻译一篇论文折腾 Python 环境?还在对着黑窗口敲命令行?
桌面版帮你把这些烦恼统统打包带走 👋
| 原版(Web/CLI)🖥️ | ✨ 桌面版 | |
|---|---|---|
| 安装方式 | 需要 Python + pip 😵 | 解压即用 🎁 |
| 操作界面 | 浏览器 / 终端 | 原生桌面 GUI 🪟 |
| 翻译预览 | 浏览器内查看 | 内置 PDF 连续滚动预览 👁️ |
| 批量处理 | 命令行参数 | 拖放文件/文件夹一键操作 🖱️ |
| Zotero 联动 | 不支持 | 拖论文进来 → 译文自动回写 📚 |
| 离线能力 | 不支持 | 程序本体完全离线 📴 |
| 平台 | 下载 | 大小 | 启动方式 |
|---|---|---|---|
| 🪟 Windows | pdf2zh-desktop-win-v2.3.9.zip | ~287MB | 解压 → 双击 pdf2zh.exe |
| 🍎 macOS | pdf2zh-desktop-mac-v2.3.9.zip | ~228MB | 解压 → 双击 pdf2zh.app |
pdf2zh.exe,不需要任何安装步骤,解压即用,首次使用和日常使用都是这一个pdf2zh.vbs(无控制台窗口)/ pdf2zh.bat(保留控制台便于看输出),效果和 pdf2zh.exe完全一样,个人喜好选一个install.bat(顺带自动检查/安装 VC++ 运行库;跑完就没用了,不做也完全不影响用 pdf2zh.exe 正常使用,只是桌面上不会有图标)debug_start.bat(看启动日志)或 diagnostic.bat(系统诊断);改设置用 config_manager.batuninstall.batinstall.bat/uninstall.bat/debug_start.bat/diagnostic.bat/config_manager.bat 这几个是批处理脚本,v2.3.9 起已修复中文 Windows 上的编码乱码问题;pdf2zh.exe/pdf2zh.vbs 不受此类问题影响,追求最稳就选它们pdf2zh.app;首次启动若提示「已损坏,无法打开」,终端跑一行:xattr -cr /Applications/pdf2zh.app,或 Finder 里右键 → 打开拖入 PDF → 选翻译服务 → 点「开始翻译」→ 搞定!🎉
💡 小贴士:Google / Bing 翻译免费无需配置,打开就能用!
⚠️ 请从 Releases 页面 下载,不要点 Source code。
| 类型 | 服务 |
|---|---|
| 🆓 免费 | Google 翻译、Bing 翻译 |
| 🔑 API Key | OpenAI、DeepL、DeepLX、DeepSeek、Gemini、Azure |
| 🇨🇳 国内服务 | 智谱 GLM、硅基流动、腾讯翻译、阿里 Qwen-MT |
| 🏠 本地部署 | Ollama、Xinference、Argos Translate(完全离线) |
| 🔧 其他 | Dify、AnythingLLM、Grok、Groq、OpenAI 兼容格式 |
支持语言:中文(简繁)、英、日、韩、法、德、俄、西、意、葡、荷、波兰、土耳其、阿拉伯、泰、越南、印尼、马来、印地、孟加拉、乌克兰、捷克、瑞典、丹麦、芬兰、希腊、希伯来、匈牙利、罗马尼亚、老挝、高棉、缅甸、格鲁吉亚 等
文件名-mono.pdf — 纯译文版文件名-dual.pdf — 双语对照版文件名-side_by_side.pdf — 左原文右译文(推荐)从 Zotero 拖论文到 pdf2zh → 翻译 → 译文自动出现在 Zotero 附件栏
side by side - 论文名)不需要每次操作,插件只装一次。没装 Zotero 的用户完全不受影响。
更快的方式:Zotero 里右键直接翻译
不用打开 pdf2zh,在 Zotero 里对着 PDF 右键 → 「📖 用 pdf2zh-desktop 翻译」即可,格式跟随右键菜单选择。右键菜单还能勾选「后台静默翻译」——不弹窗、不抢焦点,翻完自动关窗,适合批量挂后台处理。
| 快捷键 | 功能 |
|---|---|
Ctrl+T / ⌘T | 开始翻译 |
Ctrl+O / ⌘O | 打开文件 |
← → | PDF 翻页 |
Ctrl+滚轮 | 缩放预览 |
F11 | 全屏 |
| 参数 | 说明 |
|---|---|
| 🌐 源语言 / 目标语言 | 35 种语言,自动检测 |
| 📃 页面范围 | 全部、仅首页、前 5 页、自定义 |
| 🔄 翻译完成后自动打开 | 默认开启 |
| 🧩 分块翻译 | 大文件自动分块,超 50 页自动开启 |
| 📜 扫描版 PDF | 覆盖底图原文 |
| 📊 翻译表格内容 | 独立管线,按单元格翻译 |
| 🔍 OCR 识别 | 纯图片扫描件自动识别 |
| 📝 自定义提示词 | 控制 AI 翻译风格 |
| 📚 术语库 | 专业术语对照,支持 txt/csv/json |
| 项目 | Windows | macOS |
|---|---|---|
| 💿 操作系统 | Windows 10/11 64 位 | macOS 13.0+ |
| 🧠 内存 | 4 GB 起步(大文档建议 8 GB) | 4 GB 以上 |
| 💾 磁盘 | ~750 MB | ~750 MB |
| 🌐 网络 | 使用在线翻译服务时需联网 | 同左 |
| 🍎 芯片 | — | Apple Silicon (M 系列) |
| 😰 遇到了啥? | 💡 这样解决 |
|---|---|
| 双击 vbs 报"不兼容" | Windows 11 24H2 废弃了 VBScript,请改用 pdf2zh.bat |
| macOS 提示"无法验证开发者" | 右键 → 打开 → 确认(仅需一次) |
| 翻译中途断了 | 检查磁盘空间,重启后自动从缓存续接 |
| 排版错乱 / 乱码 | 试试勾选「跳过字体子集」 |
| 大文档内存不足? | 勾选「分块翻译」,设置合适的块大小 |
| 扫描版原文和译文重叠? | 勾选「扫描版 PDF」 |
| PDF 丢进去秒结束? | 勾选「OCR 识别」 |
| 专利表格不翻译? | 勾选「翻译表格内容」 |
| 怎么用 DeepSeek? | 选 DeepSeek → 填 API Key → 选模型 |
| 怎么用自己的 API? | 选「OpenAI 兼容格式」→ 快捷预设一键配置 |
| 怎么保证术语准确? | 展开「术语库」→ 选学科模板或自定义 |
| Zotero 翻译后没显示附件? | 安装 pdf2zh Connector 插件 |
pdf2zh/ocr_pipeline.py),macOS 与 Windows 共用一套代码,后续改进两端同步生效,不会再出现「一端修好另一端还是老样子」。mono = 纯译文白底页;side_by_side = 左边原始扫描图、右边干净译文,方便对照;dual = 原文页与译文页交替。E:\Zotero文档\storage、D:\我的文献\storage)后就匹配失败、被当成非 Zotero 文件跳过。改成不认目录名、只认 storage\<条目号>\ 这个 Zotero 真正特征prefs.js)里指定的活动数据目录Zotero/storage/<条目号>/ 里,靠路径抠出条目号)。但用了 ZotFile / Attanger、或选了"链接到文件"、或设了附件基目录的用户,PDF 是"链接文件"型——留在自己的目录里、不在 storage 下,路径抠不到条目号,于是界面显示不出条目名、回写被直接跳过(同学反馈"有的能回写、有的显示不了条目就不能回写")。现在加了数据库反查兜底:路径抠不到时,去 Zotero 库里按文件真实路径反查它的条目号(覆盖 storage / 绝对路径 / 附件基目录相对路径三种),存储型附件走原逻辑不变。已在真实 Windows + Attanger 环境验证strict_max_version: "9.*",Zotero 升级到 10 后会被判定为不兼容,直接整个禁用插件——用户端表现是"翻译完不回写到 Zotero",且没有任何报错(因为插件从一开始就没启动,HTTP 端点根本没注册)。现在改成不设兼容上限("*"),并把版本升到 v1.0.20;已装旧版插件的用户下次 Zotero 自动检查更新时会自动升级,不需要手动重装。受影响的用户如果等不及自动更新,可以去 Zotero「工具→附加组件」手动禁用/删除旧版 pdf2zh Connector 后,到 pdf2zh-desktop「设置」页重新一键安装insert_htmlbox 插入译文:一次性解决三个长期存在的表格排版问题——① 之前手写的字号估算和实际排版有偏差,同一张表里长短不一的译文字号此起彼伏,现在用 scale_low=0 让 PyMuPDF 按真实字体度量自动缩放;② 之前整段文字只能整体选中文或西文字体,中英混排内容要么中文变问号、要么英文字母间距被拉得很宽,现在按字符自动做中西文字体回退;③ 旋转方向经过与原表格未改动内容逐字比对校准,不再出现"有的顺时针有的逆时针"insert_htmlbox 每次调用都会给中文内容独立内嵌一份完整字体子集、不会跨单元格复用,一张表几十上百个格子就是几十上百份几乎重复的字体数据;加上原来用增量保存(saveIncr)不做垃圾回收,实测 166 个单元格能把 5.85MB 的文件撑到 313MB。现在改成完整重写并加 garbage=4 垃圾回收合并重复对象,同样的内容文件只多出几 MB--tables=<页码> 命令行参数,供自动化测试/脚本化调用(例如 Zotero 联动)勾选表格翻译并指定页码--auto/Zotero 无人值守唤起时改为写入调试日志,不弹窗阻塞)install.bat 等批处理脚本在部分中文 Windows 上会因编码问题乱码崩溃(详见下方「启动」章节说明);同时调整首次启动的推荐方式,pdf2zh.exe 现在是首选,install.bat 降级为可选的快捷方式创建工具TopK k argument...),使整个翻译任务崩溃;现已修复,正常页面不受影响deepseek-v4-flashside by side - 论文名)桌面版作者:@AaronGIG (CAS)
桌面版的独立打包、GUI 增强、便携化改造、Zotero 联动等功能由 AaronGIG (CAS) 与 Claude (Anthropic AI) 协作开发完成 🤖✨
核心翻译引擎:PDFMathTranslate(EMNLP 2025),感谢原项目的贡献 🤝
92 commits
1 commits
Python
84.2%
C++
4.3%
QML
2.7%
SIP
2.4%
Cython
2.2%
PureBasic
1.9%
C
1.8%
📖 开箱即用的 PDF 学术翻译神器 | Win + Mac 双平台 | 公式排版完美保留 · Zotero 深度联动 · 35 种语言 · 20+ AI 翻译引擎 · 表格/OCR/术语库 · 批量翻译 | 基于 PDFMathTranslate (EMNLP 2025)
432
stars
93
commits
Python
primary language
Sep 4, 2026
updated
🎉 无需安装 Python · 无需配置环境 · 下载解压双击就能用!
🖥️ 支持 Windows + macOS 双平台
📘 强烈推荐先看 → 完整图文使用教程(macOS)真实截图 · 每一步带红圈编号 · 配 API · 扫描件处理 · 常见问题 |
![]() ① 主界面 · 拖入 PDF · 选语言 · 一键开始 |
![]() ② 阅读页 · 中外对照 · AI 助手自动解读论文 |
快速开始 · 功能特性 · 翻译服务 · Zotero 联动 · 更新日志 · English
💬 用户交流群(QQ):1094195179(pdf2zh桌面版交流群)
基于 PDFMathTranslate(EMNLP 2025)打造,在原项目基础上大幅增强桌面体验。
让学术 PDF 翻译变得像复制粘贴一样简单——公式、图表、排版全部完美保留 ✨
还在为翻译一篇论文折腾 Python 环境?还在对着黑窗口敲命令行?
桌面版帮你把这些烦恼统统打包带走 👋
| 原版(Web/CLI)🖥️ | ✨ 桌面版 | |
|---|---|---|
| 安装方式 | 需要 Python + pip 😵 | 解压即用 🎁 |
| 操作界面 | 浏览器 / 终端 | 原生桌面 GUI 🪟 |
| 翻译预览 | 浏览器内查看 | 内置 PDF 连续滚动预览 👁️ |
| 批量处理 | 命令行参数 | 拖放文件/文件夹一键操作 🖱️ |
| Zotero 联动 | 不支持 | 拖论文进来 → 译文自动回写 📚 |
| 离线能力 | 不支持 | 程序本体完全离线 📴 |
| 平台 | 下载 | 大小 | 启动方式 |
|---|---|---|---|
| 🪟 Windows | pdf2zh-desktop-win-v2.3.9.zip | ~287MB | 解压 → 双击 pdf2zh.exe |
| 🍎 macOS | pdf2zh-desktop-mac-v2.3.9.zip | ~228MB | 解压 → 双击 pdf2zh.app |
pdf2zh.exe,不需要任何安装步骤,解压即用,首次使用和日常使用都是这一个pdf2zh.vbs(无控制台窗口)/ pdf2zh.bat(保留控制台便于看输出),效果和 pdf2zh.exe完全一样,个人喜好选一个install.bat(顺带自动检查/安装 VC++ 运行库;跑完就没用了,不做也完全不影响用 pdf2zh.exe 正常使用,只是桌面上不会有图标)debug_start.bat(看启动日志)或 diagnostic.bat(系统诊断);改设置用 config_manager.batuninstall.batinstall.bat/uninstall.bat/debug_start.bat/diagnostic.bat/config_manager.bat 这几个是批处理脚本,v2.3.9 起已修复中文 Windows 上的编码乱码问题;pdf2zh.exe/pdf2zh.vbs 不受此类问题影响,追求最稳就选它们pdf2zh.app;首次启动若提示「已损坏,无法打开」,终端跑一行:xattr -cr /Applications/pdf2zh.app,或 Finder 里右键 → 打开拖入 PDF → 选翻译服务 → 点「开始翻译」→ 搞定!🎉
💡 小贴士:Google / Bing 翻译免费无需配置,打开就能用!
⚠️ 请从 Releases 页面 下载,不要点 Source code。
| 类型 | 服务 |
|---|---|
| 🆓 免费 | Google 翻译、Bing 翻译 |
| 🔑 API Key | OpenAI、DeepL、DeepLX、DeepSeek、Gemini、Azure |
| 🇨🇳 国内服务 | 智谱 GLM、硅基流动、腾讯翻译、阿里 Qwen-MT |
| 🏠 本地部署 | Ollama、Xinference、Argos Translate(完全离线) |
| 🔧 其他 | Dify、AnythingLLM、Grok、Groq、OpenAI 兼容格式 |
支持语言:中文(简繁)、英、日、韩、法、德、俄、西、意、葡、荷、波兰、土耳其、阿拉伯、泰、越南、印尼、马来、印地、孟加拉、乌克兰、捷克、瑞典、丹麦、芬兰、希腊、希伯来、匈牙利、罗马尼亚、老挝、高棉、缅甸、格鲁吉亚 等
文件名-mono.pdf — 纯译文版文件名-dual.pdf — 双语对照版文件名-side_by_side.pdf — 左原文右译文(推荐)从 Zotero 拖论文到 pdf2zh → 翻译 → 译文自动出现在 Zotero 附件栏
side by side - 论文名)不需要每次操作,插件只装一次。没装 Zotero 的用户完全不受影响。
更快的方式:Zotero 里右键直接翻译
不用打开 pdf2zh,在 Zotero 里对着 PDF 右键 → 「📖 用 pdf2zh-desktop 翻译」即可,格式跟随右键菜单选择。右键菜单还能勾选「后台静默翻译」——不弹窗、不抢焦点,翻完自动关窗,适合批量挂后台处理。
| 快捷键 | 功能 |
|---|---|
Ctrl+T / ⌘T | 开始翻译 |
Ctrl+O / ⌘O | 打开文件 |
← → | PDF 翻页 |
Ctrl+滚轮 | 缩放预览 |
F11 | 全屏 |
| 参数 | 说明 |
|---|---|
| 🌐 源语言 / 目标语言 | 35 种语言,自动检测 |
| 📃 页面范围 | 全部、仅首页、前 5 页、自定义 |
| 🔄 翻译完成后自动打开 | 默认开启 |
| 🧩 分块翻译 | 大文件自动分块,超 50 页自动开启 |
| 📜 扫描版 PDF | 覆盖底图原文 |
| 📊 翻译表格内容 | 独立管线,按单元格翻译 |
| 🔍 OCR 识别 | 纯图片扫描件自动识别 |
| 📝 自定义提示词 | 控制 AI 翻译风格 |
| 📚 术语库 | 专业术语对照,支持 txt/csv/json |
| 项目 | Windows | macOS |
|---|---|---|
| 💿 操作系统 | Windows 10/11 64 位 | macOS 13.0+ |
| 🧠 内存 | 4 GB 起步(大文档建议 8 GB) | 4 GB 以上 |
| 💾 磁盘 | ~750 MB | ~750 MB |
| 🌐 网络 | 使用在线翻译服务时需联网 | 同左 |
| 🍎 芯片 | — | Apple Silicon (M 系列) |
| 😰 遇到了啥? | 💡 这样解决 |
|---|---|
| 双击 vbs 报"不兼容" | Windows 11 24H2 废弃了 VBScript,请改用 pdf2zh.bat |
| macOS 提示"无法验证开发者" | 右键 → 打开 → 确认(仅需一次) |
| 翻译中途断了 | 检查磁盘空间,重启后自动从缓存续接 |
| 排版错乱 / 乱码 | 试试勾选「跳过字体子集」 |
| 大文档内存不足? | 勾选「分块翻译」,设置合适的块大小 |
| 扫描版原文和译文重叠? | 勾选「扫描版 PDF」 |
| PDF 丢进去秒结束? | 勾选「OCR 识别」 |
| 专利表格不翻译? | 勾选「翻译表格内容」 |
| 怎么用 DeepSeek? | 选 DeepSeek → 填 API Key → 选模型 |
| 怎么用自己的 API? | 选「OpenAI 兼容格式」→ 快捷预设一键配置 |
| 怎么保证术语准确? | 展开「术语库」→ 选学科模板或自定义 |
| Zotero 翻译后没显示附件? | 安装 pdf2zh Connector 插件 |
pdf2zh/ocr_pipeline.py),macOS 与 Windows 共用一套代码,后续改进两端同步生效,不会再出现「一端修好另一端还是老样子」。mono = 纯译文白底页;side_by_side = 左边原始扫描图、右边干净译文,方便对照;dual = 原文页与译文页交替。E:\Zotero文档\storage、D:\我的文献\storage)后就匹配失败、被当成非 Zotero 文件跳过。改成不认目录名、只认 storage\<条目号>\ 这个 Zotero 真正特征prefs.js)里指定的活动数据目录Zotero/storage/<条目号>/ 里,靠路径抠出条目号)。但用了 ZotFile / Attanger、或选了"链接到文件"、或设了附件基目录的用户,PDF 是"链接文件"型——留在自己的目录里、不在 storage 下,路径抠不到条目号,于是界面显示不出条目名、回写被直接跳过(同学反馈"有的能回写、有的显示不了条目就不能回写")。现在加了数据库反查兜底:路径抠不到时,去 Zotero 库里按文件真实路径反查它的条目号(覆盖 storage / 绝对路径 / 附件基目录相对路径三种),存储型附件走原逻辑不变。已在真实 Windows + Attanger 环境验证strict_max_version: "9.*",Zotero 升级到 10 后会被判定为不兼容,直接整个禁用插件——用户端表现是"翻译完不回写到 Zotero",且没有任何报错(因为插件从一开始就没启动,HTTP 端点根本没注册)。现在改成不设兼容上限("*"),并把版本升到 v1.0.20;已装旧版插件的用户下次 Zotero 自动检查更新时会自动升级,不需要手动重装。受影响的用户如果等不及自动更新,可以去 Zotero「工具→附加组件」手动禁用/删除旧版 pdf2zh Connector 后,到 pdf2zh-desktop「设置」页重新一键安装insert_htmlbox 插入译文:一次性解决三个长期存在的表格排版问题——① 之前手写的字号估算和实际排版有偏差,同一张表里长短不一的译文字号此起彼伏,现在用 scale_low=0 让 PyMuPDF 按真实字体度量自动缩放;② 之前整段文字只能整体选中文或西文字体,中英混排内容要么中文变问号、要么英文字母间距被拉得很宽,现在按字符自动做中西文字体回退;③ 旋转方向经过与原表格未改动内容逐字比对校准,不再出现"有的顺时针有的逆时针"insert_htmlbox 每次调用都会给中文内容独立内嵌一份完整字体子集、不会跨单元格复用,一张表几十上百个格子就是几十上百份几乎重复的字体数据;加上原来用增量保存(saveIncr)不做垃圾回收,实测 166 个单元格能把 5.85MB 的文件撑到 313MB。现在改成完整重写并加 garbage=4 垃圾回收合并重复对象,同样的内容文件只多出几 MB--tables=<页码> 命令行参数,供自动化测试/脚本化调用(例如 Zotero 联动)勾选表格翻译并指定页码--auto/Zotero 无人值守唤起时改为写入调试日志,不弹窗阻塞)install.bat 等批处理脚本在部分中文 Windows 上会因编码问题乱码崩溃(详见下方「启动」章节说明);同时调整首次启动的推荐方式,pdf2zh.exe 现在是首选,install.bat 降级为可选的快捷方式创建工具TopK k argument...),使整个翻译任务崩溃;现已修复,正常页面不受影响deepseek-v4-flashside by side - 论文名)桌面版作者:@AaronGIG (CAS)
桌面版的独立打包、GUI 增强、便携化改造、Zotero 联动等功能由 AaronGIG (CAS) 与 Claude (Anthropic AI) 协作开发完成 🤖✨
核心翻译引擎:PDFMathTranslate(EMNLP 2025),感谢原项目的贡献 🤝
92 commits
1 commits
Python
84.2%
C++
4.3%
QML
2.7%
SIP
2.4%
Cython
2.2%
PureBasic
1.9%
C
1.8%