AI 热榜雷达给好奇心，找个好工具
← 继续发现工具
PDFMathTranslate /

PDFMathTranslate

办公自动化
趋势观察中

使用 AI 翻译 PDF 文档，尽量保留原文档排版，便于双语阅读。

中文简介经编辑校订 · chinese / document / edit / english / japanese / korean

GitHub 仓库 ↗项目主页 ↗

README / 项目原文

docs/README_zh-CN.md ↗抓取于 2026/10/28 13:59:01

English | 简体中文 | 繁體中文 | 日本語

PDF2ZH

PDFMathTranslate

Byaidu%2FPDFMathTranslate | Trendshift

科学 PDF 文档翻译及双语对照工具

欢迎在 GitHub Issues 或 Telegram 用户群

有关如何贡献的详细信息，请查阅 贡献指南

更新

  • [2026年10月2日] 新增命令行 --ultrafast 模式：使用 pdf-inspector 提供的 PDF 原生文本位置进行启发式布局，跳过 ONNX 布局解析和 OCR，适用于包含原生文本的 PDF。

  • [2026年3月23日] 实验性支持 v2.0 翻译内核，使用隔离环境运行（--mode precise）。（由@reycn 提交）

  • [2026年3月22日] 支持 MiniMax（由@octo-patch 提交的PR）

  • [2026年3月22日] 修复与 OpenAI 相关的问题（由@samqin123 提交的PR）

  • [2026年3月22日] 修复与 HTTP 相关的问题（由@soukouki 提交的PR）

  • [2026年3月22日] 在 mac 和 OONX 平台上加快模型加载速度，GUI 启动，版本打印和持续集成。（由@reycn 提交）

  • [2025 年 2 月 22 日] 更好的发布 CI 和精心打包的 windows-amd64 exe (由 @awwaawwa 提供)

  • [2024 年 12 月 24 日] 翻译器现在支持在 Xinference 上使用本地模型 (由 @imClumsyPanda 提供)

预览

在线演示 🌟

在线服务 🌟

您可以通过以下演示尝试我们的应用程序：

请注意演示的计算资源有限，请避免滥用它们。

安装和使用

方法

针对不同的使用案例，我们提供不同的方法来使用我们的程序：

1. UV 安装

  1. 安装 Python (3.11 <= 版本 <= 3.12)

  2. 安装我们的包：

    pip install uv
uv tool install --python 3.12 pdf2zh

  3. 执行翻译，文件生成在 当前工作目录：

    pdf2zh document.pdf
2. Windows exe

  1. 从 发布页面 下载 pdf2zh-version-win64.zip

  2. 解压缩并双击 pdf2zh.exe 运行。

3. 图形用户界面 1. 安装 Python (3.11 <= 版本 <= 3.12) 2. 安装我们的包：
pip install pdf2zh

  1. 在浏览器中开始使用：

    pdf2zh -i

  2. 如果您的浏览器没有自动启动，请访问

    http://localhost:7860/

有关更多详细信息，请参阅 GUI 文档。

4. Docker

  1. 拉取并运行：

    docker pull byaidu/pdf2zh
docker run -d -p 7860:7860 byaidu/pdf2zh

  2. 在浏览器中打开：

    http://localhost:7860/

对于云服务上的 docker 部署：

5. Zotero 插件

有关更多细节，请参见 Zotero PDF2zh。

6. 命令行

  1. 已安装 Python（3.11 <= 版本 <= 3.12）

  2. 安装我们的包：

    pip install pdf2zh

  3. 执行翻译，文件生成在 当前工作目录:

    pdf2zh document.pdf

[!TIP]

docker pull ghcr.io/byaidu/pdfmathtranslate
docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate

无法安装？

当前程序在工作前需要一个 AI 模型 (wybxc/DocLayout-YOLO-DocStructBench-onnx)，一些用户由于网络问题无法下载。如果你在下载此模型时遇到问题，我们提供以下环境变量的解决方法：

set HF_ENDPOINT=https://hf-mirror.com

对于 PowerShell 用户：

$env:HF_ENDPOINT = https://hf-mirror.com

如果此解决方案对您无效或您遇到其他问题，请参阅 常见问题解答。

高级选项

在命令行中执行翻译命令，在当前工作目录下生成译文文档 example-mono.pdf 和双语对照文档 example-dual.pdf，默认使用 Google 翻译服务，更多支持的服务在这里)。

cmd

在下表中，我们列出了所有高级选项供参考：

选项 功能 示例
files 本地文件 pdf2zh ~/local.pdf
links 在线文件 pdf2zh http://arxiv.org/paper.pdf
-i 进入 GUI pdf2zh -i
-p 部分文档翻译 pdf2zh example.pdf -p 1
-li 源语言 pdf2zh example.pdf -li en
-lo 目标语言 pdf2zh example.pdf -lo zh
-s 翻译服务 pdf2zh example.pdf -s deepl
-t 多线程 pdf2zh example.pdf -t 1
-o 输出目录 pdf2zh example.pdf -o output
-f, -c 异常 pdf2zh example.pdf -f "(MS.*)"
-cp 兼容模式 pdf2zh example.pdf --compatible
--ultrafast 使用 pdf-inspector 的 PDF 原生文本位置进行启发式布局，跳过 ONNX 布局解析和 OCR（适用于包含原生文本的 PDF） pdf2zh example.pdf --ultrafast
--share 公开链接 pdf2zh -i --share
--authorized 授权 pdf2zh -i --authorized users.txt [auth.html]
--prompt 自定义提示 pdf2zh --prompt [prompt.txt]
--onnx [使用自定义 DocLayout-YOLO ONNX 模型] pdf2zh --onnx [onnx/model/path]
--serverport [使用自定义 WebUI 端口] pdf2zh --serverport 7860
--dir [批量翻译] pdf2zh --dir /path/to/translate/
--config 配置文件 pdf2zh --config /path/to/config/config.json
--serverport [自定义 gradio 服务器端口] pdf2zh --serverport 7860
--mode 翻译模式：fast（默认，v1）或 precise（v2，实验性，需要 pdf2zh_next 子模块） pdf2zh --mode precise example.pdf
--babeldoc 使用实验性后端 BabelDOC 翻译 pdf2zh --babeldoc -s openai example.pdf

--ultrafast 需要 pdf-inspector>=1.25.2,<2 可选依赖：pip install 'pdf2zh[ultrafast]'。该模式使用 PDF 原生文本位置进行启发式布局；没有原生文本的页面会保留且不会执行 OCR。启发式文本分组仍保留常规的字体和字符公式保护规则；对于复杂表格或公式，请使用普通模式。该模式仅支持 fast 命令行模式，不能与 --mode precise、--babeldoc、服务器或 GUI 模式以及 --onnx 一起使用。它会自动跳过字体子集化，因此输出 PDF 更大，但仍会按需使用 BabelDOC 字体资源。--ultrafast --ignore-cache 会同时跳过翻译缓存的读取和写入；普通模式的 --ignore-cache 语义不变。Ultrafast 默认使用 16 个 worker 建立整篇文档共享的段落任务池，每次请求单个段落；-t 可覆盖该值，普通模式默认仍为 4。INFO 日志会自动输出 [ultrafast perf] 的分阶段和逐页耗时。page_scan 表示提交段落任务的扫描；translation 表示等待整篇文档共享任务池排空的耗时（包括 API 重试），不能通过相加逐页等待时间重建。paragraph_parse 覆盖两次解析，typesetting 在翻译完成后执行，layout_extract 会在字体设置前单独报告。page_processing 包含嵌套的 layout_mask、paragraph_parse、translation 和 typesetting 耗时，请勿将嵌套值再次相加。此路径不会导入 ONNX 或 OpenCV。

有关详细说明，请参阅我们的文档 高级用法，以获取每个选项的完整列表。

二次开发 (API)

当前的 pdf2zh API 暂时已弃用。API 将在 pdf2zh 2.0发布后重新提供。对于需要程序化访问的用户，请使用BabelDOC的 babeldoc.high_level.async_translate 函数。

API 暂时弃用意味着：相关代码暂时不会被移除，但不会提供技术支持，也不会修复 bug。

待办事项

  • 使用基于 DocLayNet 的模型解析布局，PaddleX，PaperMage，SAM2

  • 修复页面旋转、目录、列表格式

  • 修复旧论文中的像素公式

  • 异步重试，除了 KeyboardInterrupt

  • 针对西方语言的 Knuth–Plass 算法

  • 支持非 PDF/A 文件

  • Zotero 和 Obsidian 的插件

致谢

贡献者

Alt

星标历史

星标历史图表