如何快速使用 pdf2zh:保留版式的 PDF 论文翻译完整指南 📅 发布时间:2026/9/20 17:54:13 👁 浏览次数: 如何快速使用 pdf2zh保留版式的 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/PDFMathTranslatePDFMathTranslate命令pdf2zh是一个只动文字层、排版原样保留的论文翻译工具。公式、图表、目录、双栏结构都不碰跑完给你纯译文版和中英对照版两份文件。如果你翻论文时经常被散架的公式、漂移的版式折磨它是照着这个问题做的。装好 pdf2zh 翻出第一份中文 PDF 环境要求只有一条Python 版本落在 3.11 和 3.12 之间。项目的pyproject.toml声明requires-python 3.11,3.133.10、3.13 都会装不上。依赖不用手补pip install时 onnxruntime、pdfminer-six、gradio 会自动带入。pip install pdf2zh pdf2zh paper.pdf默认走 Google 翻译不需要任何 API key。跑完当前目录多出两个文件paper-mono.pdf是纯译文版paper-dual.pdf是中英文对照版。首次运行比平时慢它要先从 Hugging Face 下载版面模型等就行。Windows 上直接跑 exe 版本、报 DLL 加载失败的先装 VC 2015–2022 运行库再试。公式和双栏为什么不散架DocLayout-YOLO 先检测版面思路是把不该翻译的东西排除掉。ONNX 版 DocLayout-YOLO模型名wybxc/DocLayout-YOLO-DocStructBench-onnx逐页扫描先标出公式、图片、表格、目录只有文字块会被送去翻译服务其余一律不动。翻译后的文本按原字体、原位置回填图编号、脚注、页眉都留在原位。等于对文本层做外科手术所以你后面不用手动修排版。想翻检测逻辑直接看 pdf2zh/doclayout.py。四种跑法任选单文件、批量目录、Web GUI、Docker 按场景挑入口跑法命令适合单文件pdf2zh paper.pdf日常产物直接落在当前目录批量目录pdf2zh --dir /path/to/papers/ -o results/一整个论文目录一次翻完输出归入-o指定目录Web GUIpdf2zh -i浏览器开 http://localhost:7860/配服务、选页码、实时预览Dockerdocker pull byaidu/pdf2zh再docker run -d -p 7860:7860 byaidu/pdf2zh不想碰本机环境同样是 7860 端口的 Web 界面GUI 长这样选页、换服务、看预览都在浏览器里完成还有一个进阶入口pdf2zh --mcp能把自己注册成 MCP 服务接进 Claude Desktop在对话里直接让它翻 PDF配置示例在 docs/ADVANCED.md。常用 pdf2zh 参数表页码、服务、语言、线程、输出目录参数作用示例-p只翻指定页pdf2zh paper.pdf -p 1-3,5只翻第 1–3 页和第 5 页-s切换翻译服务-s deepl、-s openai:gpt-4o-mini-li/-lo源语言 / 目标语言-li en -lo zh-t翻译线程数-t 4四线程并发-o输出目录缺省为当前目录--ignore-cache忽略翻译缓存强制重新翻译pdf2zh paper.pdf --ignore-cache--prompt加载自定义 LLM 提示词文件pdf2zh paper.pdf --prompt prompt.txt--config加载 JSON 配置文件pdf2zh --config config.json翻不动时先查这三个报错 ️扫描件翻不动你拿到的是纯图片 PDF没有文本层而 pdf2zh 解析的就是文本层自然取不到内容。先 OCR 出文本层再投入翻译项目自带实验性 OCR 支持装法pip install pdf2zh[ocr]。模型下载卡住首次运行从 Hugging Face 拉版面模型部分地区访问受限。运行前先设镜像set HF_ENDPOINThttps://hf-mirror.comPowerShell 里写$env:HF_ENDPOINT https://hf-mirror.com。切换服务后报鉴权错误DEEPL_AUTH_KEY、OPENAI_API_KEY这类环境变量没提前设置。各服务对应的变量名在 docs/ADVANCED.md 的表格里设完再跑。下一步第一次跑通之后的三件事拿一个论文目录跑pdf2zh --dir体验批量模式起pdf2zh -i在浏览器里换一套服务对比翻译质量翻一遍 docs/ADVANCED.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),仅供参考