GCMC吸附模拟原理与LAMMPS实战精要
2026/9/20 19:40:39
PDFMathTranslate 完整使用指南：本地保留公式的 PDF 全文翻译
【免费下载链接】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
用通用工具翻译论文，公式错位、表格断裂，读完比不读还费劲。PDFMathTranslate（pdf2zh）是一款开源的 PDF 全文双语翻译工具，先解析版式再翻译，译文完整保留公式、图表与目录。它支持 Google、DeepL、OpenAI、Ollama 等 20 余种翻译服务，提供命令行、Web 图形界面与 Docker 镜像三种运行形态。本使用指南从本地部署与批量处理的角度，讲清安装、场景选型和常用参数。
五分钟装上并验证
前置条件：本地 Python 为 3.11 或 3.12。安装只需一条命令：
pip install pdf2zh装完先验证：
pdf2zh --version能打印出pdf2zh v1.9.12之类的版本号即表示环境就绪。首次真正翻译需要联网下载 DocLayout-YOLO 版式模型，注意保持网络通畅。手头有一份 PDF 的话，可直接运行pdf2zh your_document.pdf，当前目录会生成your_document-mono.pdf（译文）与your_document-dual.pdf（双语版）两个文件。
按场景选一条路
按你的使用场景从下面三小节里选一条，命令均可直接执行。
单人本机：一条命令出译文
单篇论文直接把命令指向文件，默认使用 Google 服务翻译：
pdf2zh your_document.pdf pdf2zh your_document.pdf -s deepl # 换成 DeepL 服务译文与双语文件都输出到当前工作目录，无需额外配置。若偏好图形操作，运行pdf2zh -i，在 http://localhost:7860 打开页面拖入文件即可。
团队服务器：Docker 共享部署 🐳
多人共用一台机器时，不必逐台安装 Python，直接用官方镜像：
docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh启动后成员用浏览器访问http://服务器IP:7860，本地零安装，开箱即用。
脚本集成：批量翻译整个目录
文献已经攒成目录时，加--dir一次处理其中全部 PDF：
pdf2zh --dir /path/to/your/papers/可再拼上-t 8开 8 线程（默认 4 线程），直接写进定时任务或夜间脚本。
效果与原理：版式为何不散
下图是用 DeepLX 服务翻译一篇 Nature 论文前后的实际界面。
正文全部换成中文，公式编号、网络示意图与分栏位置却和原文一致。原理链路只有三步：先用 DocLayout-YOLO 版式模型把公式、图表、图注区域标为保护区；只把普通正文送进翻译服务；最后按原字体、原坐标回填译文。
高频参数一张表 ⚙️
只列日常会用到的 6 个参数，完整字段见 完整参数说明。
| 场景 | 命令 | 一句话说明 |
|---|---|---|
| 切换翻译服务 | pdf2zh paper.pdf -s deepl | 换用 DeepL，内置 20 余种服务 |
| 大文件提速 | pdf2zh paper.pdf -t 8 | 调整翻译线程数，默认 4 |
| 部分页翻译 | pdf2zh paper.pdf -p 1-3,5 | 只翻指定页码区间 |
| 批量处理 | pdf2zh --dir /path/to/papers/ | 整目录 PDF 一次翻完 |
| 自定义 LLM 提示词 | pdf2zh paper.pdf --prompt prompt.txt | 为 LLM 类服务指定翻译提示 |
| 固定配置 | pdf2zh paper.pdf --config config.json | 复用服务、术语与字体设置 |
踩坑排查 🛠️
4 个高频现象，原因与解决命令直接给到。
- 首次运行报模型下载失败→ 网络受限拉不到版式模型 →
export HF_ENDPOINT=https://hf-mirror.com（PowerShell：$env:HF_ENDPOINT = "https://hf-mirror.com"） - 复杂排版翻译报错或乱码→ 字体编码兼容性问题 →
pdf2zh complex.pdf --compatible - GUI 起不来、提示端口占用→ 7860 已被占用 →
pdf2zh -i --serverport 7861 - 同一文档反复翻译偏慢或结果不更新→ 翻译缓存生效 →
pdf2zh paper.pdf --ignore-cache
延伸资源 📚
深入配置与二次开发，看官方文档即可。
- 完整参数与服务清单：docs/ADVANCED.md
- Python / HTTP API 二次开发：docs/APIS.md
- 社区规范与参与方式：docs/CODE_OF_CONDUCT.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），仅供参考