一条命令把整篇 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 翻译工具它先识别页面中的公式、图表、目录与正文再调用 Google、DeepL、OpenAI 等翻译服务逐段翻译并把译文写回原坐标一次运行同时产出保留原始排版的纯译文版和双语对照版。适合需要批量阅读外文论文、翻译技术文档的人。一条命令产出两份 PDF对任意本地 PDF或 PDF 的 URL执行翻译后当前目录会生成两个文件paper-mono.pdf纯译文版整页替换为译文公式、编号、多栏布局、目录位置不变paper-dual.pdf双语对照版译文插回原文位置适合边读边对照学习。下图左侧为英文原文页面右侧为工具翻译后的中文页面公式与图号均保持原位从安装到第一份双语 PDF 需要几步只需两步默认 Google 翻译服务免配置任何密钥pip install pdf2zh安装命令行工具pdf2zh需要 Python 3.113.12 环境Windows 用户也可直接用发布页的pdf2zh.exe免安装版双击运行。pdf2zh paper.pdf几分钟后在当前目录得到paper-mono.pdf与paper-dual.pdf这就是验证装好了没有的最短路径。模型下载失败怎么办首次运行会下载一个几十 MB 的版面检测模型网络不佳时可先设置镜像源再运行Windows 用setPowerShell 用$env:set HF_ENDPOINThttps://hf-mirror.com更喜欢点选操作执行pdf2zh -i启动 Web 界面浏览器访问http://localhost:7860/上传文件、选服务、选语言、预览译文不用记任何参数。公式与排版为什么不会乱普通翻译靠复制粘贴 PDF 文本公式变乱码、多栏排版散架。PDFMathTranslate 的做法是翻译前先做版面分析内置的 DocLayout-YOLO ONNX 推理模型实现在 pdf2zh/doclayout.py把每页切成正文、公式、图片、表格、页眉页脚等区域只把文本区送去翻译非文本区按原坐标原样回填公式类字体再由正则默认保护、不参与翻译特殊情形可用-f/-c声明例外。多栏论文、跨页图表因此得以保留。换翻译服务、限定页码、批量翻译的常用命令# 换用 DeepL只翻译第 1~3 页和第 5 页输出到 out 目录 pdf2zh paper.pdf -s deepl -p 1-3,5 -o out-s指定翻译服务服务名:模型名的写法可直接指定模型例如-s openai:gpt-4o-mini。# 批量翻译目录内所有 PDF适合文献整理 pdf2zh --dir /path/to/papers/高频参数归纳如下完整清单见 高级用法参数作用示例-li/-lo源语言 / 目标语言-li en -lo ja-s翻译服务内置 Google、Bing、DeepL、OpenAI、Ollama、Gemini、DeepSeek 等十余种-s deepl-t翻译线程数长文档可加大-t 8-f/-c用正则声明保持原样的字体或字符-f (MS.*)--ignore-cache强制重新翻译译文默认写缓存重复翻译不耗 API 额度--prompt自定义大模型翻译指令可用${lang_in}、${lang_out}、${text}变量注入术语要求--prompt prompt.txt--config指定配置文件不指定时读~/.config/PDFMathTranslate/config.json付费服务要配密钥吗要。除 Google、Bing 等免费服务外DeepL、OpenAI、Gemini 等均需在环境变量或配置文件中提供 API Key各服务变量名对照表见 docs/ADVANCED.md自建中转时BASE_URL必须带/v1后缀配置示例见 代理配置。不想装环境GUI、Docker、API 三个入口Web 界面本地pdf2zh -i之外--share可生成对外可访问的临时链接--authorized users.txt用用户名,密码文件限制可登录用户适合团队共享详见 GUI 文档Docker两条命令起一个团队共享的翻译服务启动后浏览器访问http://localhost:7860/与本机 GUI 是同一套界面docker-compose.yml 可二次定制docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh嵌入自己的系统Python API 可在脚本里直接调用translate(files..., lang_inen, lang_outzh, servicegoogle)pdf2zh[backend]加--flask/--celery worker提供提交任务、查进度、下载结果的 REST 接口pdf2zh --mcp把翻译能力暴露给 Claude Desktop 等 MCP 客户端用自然语言指定文档即可翻译。细节见 API 文档。扫描件 PDF 能不能处理适合带文本层的电子 PDF学术论文、技术报告、标准、教材含多栏与跨页排版需要译文 原文对照学习双语表达的场景-dual.pdf需要批量、可复现处理整目录文献的科研或工程团队--dir想把翻译能力接进自有系统或 AI 助手的开发者API / MCP。不适合或需要留意扫描版 / 图片型 PDF工具读取 PDF 内嵌文本纯图片页面没有可翻译内容需先做 OCR翻译质量取决于所选服务默认 Google 免配置术语要求高时换 DeepL 或大模型并用--prompt注入领域要求环境要求本地需 Python 3.113.12或用 Docker / Windows 免安装版绕过--mode precisev2 内核为实验特性正式交付建议先用默认模式。项目以 AGPL-3.0 协议开源LICENSE可自由使用、修改与分发。pip install pdf2zh后跑一次pdf2zh paper.pdf几分钟内拿到第一份双语对照论文参数与服务配置见 docs/ADVANCED.md集成开发见 docs/APIS.md。【免费下载链接】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），仅供参考