一条命令把整篇 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/PDFMathTranslatePDFMathTranslatePython 包名pdf2zh是一款免费开源的 PDF 科学论文全文翻译工具它先识别 PDF 中的公式、图表、目录与正文再调用 Google、DeepL、OpenAI 等翻译服务逐段翻译最后把译文写回原文位置得到一份保留原始排版的纯译文版-mono.pdf和一份中英对照版-dual.pdf。适合需要批量阅读外文文献的研究生、科研人员和需要翻译技术文档的工程师。该项目已被 EMNLP 2025自然语言处理领域国际会议收录为系统演示论文。它是什么排版保留型 PDF 全文翻译器普通翻译软件复制粘贴 PDF 文本后公式会变成乱码、多栏排版会散掉PDFMathTranslate 的做法是在翻译前用版面分析模型内置 DocLayout-YOLO ONNX 推理把页面切分成正文、公式、图片、表格、页眉页脚等区域只翻译其中的文本区非文本区域原样保留再按原坐标回填译文。核心能力可以归纳为能力说明排版保留公式、图表、目录、注释的位置与样式不变支持多栏、跨页文档多种译文输出一次翻译同时产出纯译文版和双语对照版可插拔翻译服务内置 Google、Bing、DeepL、OpenAI、Ollama、Gemini、DeepSeek 等十余种服务也可对接任意 OpenAI 兼容接口多种使用形态命令行、浏览器 Web 界面、Docker 容器、MCP 服务、Python / HTTP API下图左侧为英文原文页面右侧为工具翻译后的中文页面公式与编号均保持原位从安装到第一份双语 PDF 的最短路径整个上手过程只需安装、运行两步。以下命令基于 Python 3.113.12 环境项目要求3.11,3.13。第一步安装工具pip install pdf2zh第二步对任意一个 PDF 文件执行翻译输出文件会生成在当前目录pdf2zh paper.pdf完成后你会得到paper-mono.pdf纯译文和paper-dual.pdf双语对照。默认使用 Google 翻译服务无需配置任何密钥因此这是验证装好了没有的最短路径。模型下载遇到网络问题怎么办程序首次运行会下载一个约几十 MB 的版面检测模型若下载失败可先设置镜像源再运行Windows 用setPowerShell 用$env:set HF_ENDPOINThttps://hf-mirror.com更喜欢点选操作一条命令启动 Web 界面然后访问http://localhost:7860/pdf2zh -i更多界面细节见 GUI 文档。功能详解命令行、界面、API 与批量任务命令行指定语言、页码与翻译服务翻译语言、页码范围和服务都通过短参数控制常用组合如下完整参数表见 高级用法文档# 英文→中文只翻译第 1~3 页和第 5 页 pdf2zh paper.pdf -li en -lo zh -p 1-3,5 # 换用 DeepL翻译结果输出到 out 目录 pdf2zh paper.pdf -s deepl -o out # 换用 OpenAI 并指定模型名 pdf2zh paper.pdf -s openai:gpt-4o-mini-li/-lo源语言与目标语言代码参照各服务的支持列表-s翻译服务服务名:模型名的写法可直接指定模型-t多线程数长文档可适当加大-f/-c用正则声明需要保持原样不翻译的字体或字符默认已保护 Math、Mono、Italic 等数学/代码字体。除本地文件外也可以直接把 PDF 的 URL 作为输入例如pdf2zh http://example.org/paper.pdf。Web 界面在浏览器里配置并预览运行pdf2zh -i后界面提供文件上传、服务选择、目标语言、页码范围等选项翻译完成后可直接预览并下载-mono.pdf与-dual.pdf适合不想记参数的用户部署为共享服务时还有两个实用开关--share可生成对外可访问的临时链接--authorized users.txt用用户名,密码文件限制可登录的用户并支持自定义登录页。详见 GUI 文档。批量任务、缓存与配置文件整目录批量翻译pdf2zh --dir /path/to/papers/会遍历目录内的 PDF 逐一处理适合文献整理。配置文件--config config.json加载指定配置不指定时读取~/.config/PDFMathTranslate/config.json。文件里可以预先写好语言、字体路径和多组翻译服务含密钥之后命令行和环境变量仍可覆盖文件内容。自定义提示词--prompt prompt.txt让你控制发给大模型的翻译指令模板中可用${lang_in}、${lang_out}、${text}三个变量适合注入领域术语要求。缓存已翻译过的文本段会写入缓存重复翻译同一文档不再消耗 API 额度需要强制重新翻译时用--ignore-cache。字体子集化默认对输出字体做子集裁剪以减小文件体积个别阅读器兼容性不佳时可用--skip-subset-fonts关闭。嵌入自己的工作流Python API、HTTP API 与 MCP如果你是开发者项目提供三种集成方式细节见 API 文档# Python在自己的脚本里直接调用 from pdf2zh import translate (file_mono, file_dual) translate( files[example.pdf], lang_inen, lang_outzh, servicegoogle, thread4 )HTTP API安装pdf2zh[backend]后运行pdf2zh --flask与pdf2zh --celery worker即可通过 REST 接口提交任务、查询进度、下载结果方便做成自己的在线服务MCP 服务pdf2zh --mcp或加--sse可把翻译能力暴露给 Claude Desktop 等 MCP 客户端用自然语言让 AI 助手替你找文件并翻译。部署方式与进阶选项Docker 一键部署适合团队共用一台翻译服务docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh运行后浏览器访问http://localhost:7860/即可与本机 GUI 是同一套界面。仓库内的 Dockerfile 与 docker-compose.yml 可用于二次定制。Windows 免安装版项目发布页提供pdf2zh.exe压缩包解压后双击即可运行若打不开按提示补装 VC 运行库。实验性功能--mode precise启用 v2 翻译内核实验性需运行pdf2zh-setup-precise搭建独立环境面向跨栏跨页一致性等边缘场景--babeldoc换用 BabelDOC 后端翻译可搭配-s openai使用Zotero 用户可安装社区 Zotero 插件在文献管理软件里直接触发翻译。自定义代理若你的 API 需要走自建中转代理配置文档 给出了 Grok / OpenAI 兼容接口的完整配置示例注意BASE_URL必须带/v1后缀。适合谁用哪些情况用不了比较适合带文本层的电子 PDF学术论文、技术报告、标准文档、教材需要译文 原文对照学习双语表达的场景-dual.pdf输出需要批量、可复现地处理整目录文献的科研或工程团队想把翻译能力接进自己系统或 AI 助手的工作流API / MCP。不适合或需要留意扫描版 / 图片型 PDF程序识别的是 PDF 内嵌文本纯图片页面没有可翻译的文本需先做 OCR 再处理翻译质量取决于所选服务默认 Google 免配置对术语质量要求高时可换 DeepL 或大模型服务并通过--prompt注入领域要求付费服务要配密钥除 Google、Bing 等免费服务外DeepL、OpenAI、Gemini 等均需在环境变量或配置文件中提供 API Key各项服务的变量名见 高级用法文档 的对照表环境要求本地运行需 Python 3.113.12或使用 Docker / Windows 免安装版绕过--mode precise为实验特性正式交付建议先用默认模式。下一步pip install pdf2zh后运行一次pdf2zh paper.pdf几分钟内即可得到第一份双语对照论文。参数与服务配置详见 docs/ADVANCED.md集成开发参考 docs/APIS.md。项目以 AGPL-3.0 协议开源可自由使用、修改与分发。【免费下载链接】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），仅供参考 一条命令把整篇 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/PDFMathTranslatePDFMathTranslatePython 包名pdf2zh是一款免费开源的 PDF 科学论文全文翻译工具它先识别 PDF 中的公式、图表、目录与正文再调用 Google、DeepL、OpenAI 等翻译服务逐段翻译最后把译文写回原文位置得到一份保留原始排版的纯译文版-mono.pdf和一份中英对照版-dual.pdf。适合需要批量阅读外文文献的研究生、科研人员和需要翻译技术文档的工程师。该项目已被 EMNLP 2025自然语言处理领域国际会议收录为系统演示论文。它是什么排版保留型 PDF 全文翻译器普通翻译软件复制粘贴 PDF 文本后公式会变成乱码、多栏排版会散掉PDFMathTranslate 的做法是在翻译前用版面分析模型内置 DocLayout-YOLO ONNX 推理把页面切分成正文、公式、图片、表格、页眉页脚等区域只翻译其中的文本区非文本区域原样保留再按原坐标回填译文。核心能力可以归纳为能力说明排版保留公式、图表、目录、注释的位置与样式不变支持多栏、跨页文档多种译文输出一次翻译同时产出纯译文版和双语对照版可插拔翻译服务内置 Google、Bing、DeepL、OpenAI、Ollama、Gemini、DeepSeek 等十余种服务也可对接任意 OpenAI 兼容接口多种使用形态命令行、浏览器 Web 界面、Docker 容器、MCP 服务、Python / HTTP API下图左侧为英文原文页面右侧为工具翻译后的中文页面公式与编号均保持原位从安装到第一份双语 PDF 的最短路径整个上手过程只需安装、运行两步。以下命令基于 Python 3.113.12 环境项目要求3.11,3.13。第一步安装工具pip install pdf2zh第二步对任意一个 PDF 文件执行翻译输出文件会生成在当前目录pdf2zh paper.pdf完成后你会得到paper-mono.pdf纯译文和paper-dual.pdf双语对照。默认使用 Google 翻译服务无需配置任何密钥因此这是验证装好了没有的最短路径。模型下载遇到网络问题怎么办程序首次运行会下载一个约几十 MB 的版面检测模型若下载失败可先设置镜像源再运行Windows 用setPowerShell 用$env:set HF_ENDPOINThttps://hf-mirror.com更喜欢点选操作一条命令启动 Web 界面然后访问http://localhost:7860/pdf2zh -i更多界面细节见 GUI 文档。功能详解命令行、界面、API 与批量任务命令行指定语言、页码与翻译服务翻译语言、页码范围和服务都通过短参数控制常用组合如下完整参数表见 高级用法文档# 英文→中文只翻译第 1~3 页和第 5 页 pdf2zh paper.pdf -li en -lo zh -p 1-3,5 # 换用 DeepL翻译结果输出到 out 目录 pdf2zh paper.pdf -s deepl -o out # 换用 OpenAI 并指定模型名 pdf2zh paper.pdf -s openai:gpt-4o-mini-li/-lo源语言与目标语言代码参照各服务的支持列表-s翻译服务服务名:模型名的写法可直接指定模型-t多线程数长文档可适当加大-f/-c用正则声明需要保持原样不翻译的字体或字符默认已保护 Math、Mono、Italic 等数学/代码字体。除本地文件外也可以直接把 PDF 的 URL 作为输入例如pdf2zh http://example.org/paper.pdf。Web 界面在浏览器里配置并预览运行pdf2zh -i后界面提供文件上传、服务选择、目标语言、页码范围等选项翻译完成后可直接预览并下载-mono.pdf与-dual.pdf适合不想记参数的用户部署为共享服务时还有两个实用开关--share可生成对外可访问的临时链接--authorized users.txt用用户名,密码文件限制可登录的用户并支持自定义登录页。详见 GUI 文档。批量任务、缓存与配置文件整目录批量翻译pdf2zh --dir /path/to/papers/会遍历目录内的 PDF 逐一处理适合文献整理。配置文件--config config.json加载指定配置不指定时读取~/.config/PDFMathTranslate/config.json。文件里可以预先写好语言、字体路径和多组翻译服务含密钥之后命令行和环境变量仍可覆盖文件内容。自定义提示词--prompt prompt.txt让你控制发给大模型的翻译指令模板中可用${lang_in}、${lang_out}、${text}三个变量适合注入领域术语要求。缓存已翻译过的文本段会写入缓存重复翻译同一文档不再消耗 API 额度需要强制重新翻译时用--ignore-cache。字体子集化默认对输出字体做子集裁剪以减小文件体积个别阅读器兼容性不佳时可用--skip-subset-fonts关闭。嵌入自己的工作流Python API、HTTP API 与 MCP如果你是开发者项目提供三种集成方式细节见 API 文档# Python在自己的脚本里直接调用 from pdf2zh import translate (file_mono, file_dual) translate( files[example.pdf], lang_inen, lang_outzh, servicegoogle, thread4 )HTTP API安装pdf2zh[backend]后运行pdf2zh --flask与pdf2zh --celery worker即可通过 REST 接口提交任务、查询进度、下载结果方便做成自己的在线服务MCP 服务pdf2zh --mcp或加--sse可把翻译能力暴露给 Claude Desktop 等 MCP 客户端用自然语言让 AI 助手替你找文件并翻译。部署方式与进阶选项Docker 一键部署适合团队共用一台翻译服务docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh运行后浏览器访问http://localhost:7860/即可与本机 GUI 是同一套界面。仓库内的 Dockerfile 与 docker-compose.yml 可用于二次定制。Windows 免安装版项目发布页提供pdf2zh.exe压缩包解压后双击即可运行若打不开按提示补装 VC 运行库。实验性功能--mode precise启用 v2 翻译内核实验性需运行pdf2zh-setup-precise搭建独立环境面向跨栏跨页一致性等边缘场景--babeldoc换用 BabelDOC 后端翻译可搭配-s openai使用Zotero 用户可安装社区 Zotero 插件在文献管理软件里直接触发翻译。自定义代理若你的 API 需要走自建中转代理配置文档 给出了 Grok / OpenAI 兼容接口的完整配置示例注意BASE_URL必须带/v1后缀。适合谁用哪些情况用不了比较适合带文本层的电子 PDF学术论文、技术报告、标准文档、教材需要译文 原文对照学习双语表达的场景-dual.pdf输出需要批量、可复现地处理整目录文献的科研或工程团队想把翻译能力接进自己系统或 AI 助手的工作流API / MCP。不适合或需要留意扫描版 / 图片型 PDF程序识别的是 PDF 内嵌文本纯图片页面没有可翻译的文本需先做 OCR 再处理翻译质量取决于所选服务默认 Google 免配置对术语质量要求高时可换 DeepL 或大模型服务并通过--prompt注入领域要求付费服务要配密钥除 Google、Bing 等免费服务外DeepL、OpenAI、Gemini 等均需在环境变量或配置文件中提供 API Key各项服务的变量名见 高级用法文档 的对照表环境要求本地运行需 Python 3.113.12或使用 Docker / Windows 免安装版绕过--mode precise为实验特性正式交付建议先用默认模式。下一步pip install pdf2zh后运行一次pdf2zh paper.pdf几分钟内即可得到第一份双语对照论文。参数与服务配置详见 docs/ADVANCED.md集成开发参考 docs/APIS.md。项目以 AGPL-3.0 协议开源可自由使用、修改与分发。【免费下载链接】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），仅供参考