两条命令把英文 PDF 变成中英双语：PDFMathTranslate 翻译上手指南
两条命令把英文 PDF 变成中英双语PDFMathTranslate 翻译上手指南【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslatePDFMathTranslatepip 包名与命令行都叫pdf2zh是一款保留排版的 PDF 论文全文翻译工具先识别页面里的公式、图表和正文再调用翻译服务逐段翻译把译文写回原位置一次产出纯译文版和双语对照版。它服务的是啃外文文献的研究生、科研人员和要翻译技术文档的工程师。项目已被系统演示论文收录于 2025 年自然语言处理国际会议 EMNLP。两条命令出第一份 PDF 翻译结果第一条命令安装工具本地运行要求 Python 3.11 或 3.12pip install pdf2zh第二条命令执行 PDF 翻译输出文件生成在当前目录pdf2zh paper.pdf完成后得到paper-mono.pdf纯译文和paper-dual.pdf双语对照。默认用 Google 翻译、无需配置任何密钥这是验证装没装好的最短路径。版面检测模型拉不下来首次运行会下载一个 DocLayout-YOLO 版面检测模型网络不畅时先设镜像源再跑set HF_ENDPOINThttps://hf-mirror.comPowerShell 里写法是$env:HF_ENDPOINT https://hf-mirror.com。PDF 翻译和复制粘贴有什么不同普通翻译软件复制 PDF 文本公式变乱码、多栏排版散架。PDFMathTranslate 的做法是先用版面分析模型内置 DocLayout-YOLO 的 ONNX 推理ONNX 是一种跨平台模型运行格式把页面切成正文、公式、图片、表格、页眉等区域只翻文本区再按原坐标把译文回填。能力一句话说明排版保留公式、图表、目录、注释位置与样式不变支持多栏和跨页文档双版本输出一次翻译同时产出纯译文-mono.pdf和双语对照-dual.pdf翻译服务可插拔内置 Google、Bing、DeepL、OpenAI、Ollama、Gemini、DeepSeek 等 20 余种服务多种使用形态命令行、浏览器 Web 界面、Docker 容器、MCP 服务、Python/HTTP API挑一个你的场景照着敲只翻某几页只想看摘要和某一章时用-p指定页码-li/-lo指定语言对pdf2zh paper.pdf -li en -lo zh -p 1-3,5输出仍是paper-mono.pdf和paper-dual.pdf未指定的页码原样保留。批量处理整个文献目录文献综述前要把一整个目录的 PDF 都翻掉用--dir指向目录即可pdf2zh --dir /path/to/papers/程序会遍历目录逐个翻译每篇都生成对应的-mono和-dual文件。把翻译能力接进自己的脚本开发者可以直接在 Python 里调 API返回两份输出文件的路径方便串进自己的数据流程from pdf2zh import translate (file_mono, file_dual) translate(files[paper.pdf], lang_inen, lang_outzh, servicegoogle, thread4)常用参数与配置文件速查-li/-lo源语言与目标语言代码-p只翻指定页码范围如-p 1-3,5-s翻译服务名服务名:模型名写法可直接指定模型-t翻译线程数长文档可适当加大-o输出目录--prompt自定义翻译提示词文件支持${lang_in}、${lang_out}、${text}三个变量--ignore-cache忽略已翻译片段的缓存强制重新翻译--skip-subset-fonts关闭字体子集化个别阅读器兼容不佳时使用配置文件默认放在~/.config/PDFMathTranslate/config.json可预填语言、字体路径和多组翻译服务的密钥覆盖优先级为命令行 环境变量 配置文件。部署与集成团队共享一台翻译服务Docker 拉镜像后浏览器访问http://localhost:7860/界面与本机 Web 版相同docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh不想记参数一条命令打开浏览器界面上传 PDF、选服务与页码范围翻完直接预览下载pdf2zh -i加--share可生成对外访问链接--authorized users.txt用用户名,密码文件限制可登录用户。不装 Python 的 Windows 用户从项目发布页下载pdf2zh.exe压缩包解压双击即运行打不开时按提示补装 VC 运行库。自建在线翻译服务装 backend 依赖并启动 Flask 与 Celery worker依赖 Redis即可通过 REST 接口提交任务、查进度、下载结果pip install pdf2zh[backend] pdf2zh --flask pdf2zh --celery worker把翻译交给 AI 助手安装pdf2zh[mcp]后运行pdf2zh --mcp即可接入 Claude Desktop 等 MCP 客户端用自然语言让助手找 PDF 并翻译。哪些 PDF 它翻不了能用的带文本层的电子 PDF学术论文、技术报告、标准文档、教材公式排版保留是核心场景双语对照学习-dual.pdf原文译文并排方便核对术语批量与复现--dir扫目录处理翻译缓存让重复文档不再消耗 API 额度用不了或要留意的扫描版 / 图片型 PDF程序识别的是 PDF 内嵌文本纯图片页没有可翻译内容需先做 OCR翻译质量取决于所选服务默认 Google 免配置术语要求高时换 DeepL 或大模型服务并用--prompt注入领域要求付费服务要配密钥DeepL、OpenAI、Gemini 等需设置对应 API Key 环境变量变量名对照表见 高级用法实验性功能--mode precise为 v2 翻译内核属实验特性需先运行pdf2zh-setup-precise搭建独立环境正式交付建议用默认模式继续深入高级用法文档完整参数表、语言代码与 20 余种服务的环境变量对照API 细节文档Python API 与 HTTP API 的完整用法Web 界面说明界面操作与 10 种支持的目标语言项目以 AGPL-3.0 协议开源可自由使用、修改与分发。现在打开终端敲pip install pdf2zh几分钟内就能拿到第一份双语对照论文。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考