英文论文 PDF 翻译器使用说明

项目简介

这是一个 Windows 下的英文论文 PDF 翻译工具，底层采用开源项目 PDFMathTranslate / pdf2zh。它会尽量保留论文的页面尺寸、双栏结构、公式、图片、表格和注释，并将可识别的正文替换为中文。

PDF 不是可编辑的 Word 文档，扫描件、复杂矢量图中的文字和特别密集的表格仍然需要人工复核。

首次安装

在 PowerShell 中进入项目目录并执行：

cd "D:\Documents\桌面\工程实践与创新能力大赛\codex\paper_pdf_translator"
.\install.ps1

安装脚本会在项目目录创建独立的 .venv，安装固定版本的 pdf2zh 及兼容的翻译 SDK，不会修改其他项目的 Python 环境。首次翻译时还会下载版面分析模型，可能需要几分钟和数百 MB 磁盘空间。

图形界面翻译

不想输入命令时，可以运行：

.\run_gui.ps1

在窗口中选择英文 PDF 和输出目录，然后点击“开始翻译”。

命令行翻译

.\run_translate.ps1 `
  -InputPdf "D:\论文\paper.pdf" `
  -OutputDir "D:\论文\paper_zh" `
  -Service google

默认翻译后端是 bing，通常不需要单独申请 API key；也可以使用 google。如果 Google 返回 429 限流，可以切换回 bing。

常用选项

只翻译第 1 至 3 页：

.\run_translate.ps1 -InputPdf "D:\论文\paper.pdf" -Partial "1-3"

遇到 PDF/A 兼容性问题时，可以尝试：

.\run_translate.ps1 -InputPdf "D:\论文\paper.pdf" -Compatible

如果 Windows 权限导致临时文件错误，去掉 -Compatible 后重新执行。

输出文件

• *-mono.pdf：中文单语版本。
• *-dual.pdf：中英对照版本。
• *.translation.log：本次命令和返回码记录。

检查译文

.\check_translation.ps1 `
  -OriginalPdf "D:\论文\paper.pdf" `
  -TranslatedPdf "D:\论文\paper_zh\paper-mono.pdf"

检查脚本会比较页数、可提取文字页数和图片数量。检查通过后，仍建议人工抽查标题、双栏分栏、表格、公式、脚注和参考文献。

注意事项

• 默认后端需要联网。
• 扫描版 PDF 可能无法正确提取正文。
• 复杂公式、表格和图片内文字需要重点复核。
• 上游项目和依赖的许可证、版权以 PDFMathTranslate / pdf2zh 官方仓库和发行页面为准。

项目来源：PDFMathTranslate、pdf2zh。

实际使用示例：翻译文献包中的论文

如果论文和文献包放在其他磁盘目录，可以直接把完整路径传给 -InputPdf，并把结果写入文献包目录。例如：

Set-Location "D:\Documents\桌面\工程实践与创新能力大赛\codex\paper_pdf_translator"

.\run_translate.ps1 `
  -InputPdf "D:\Documents\桌面\chuang\论文调研与发表规划\飞行视景与进近着陆文献包_20261009\03_跑道识别与相对定位\13_固定翼真实着陆估计系统.pdf" `
  -OutputDir "D:\Documents\桌面\chuang\论文调研与发表规划\飞行视景与进近着陆文献包_20261009\03_跑道识别与相对定位" `
  -Service bing

这条命令使用 Bing 翻译后端，输出文件会放在“跑道识别与相对定位”目录中。为了避免 PowerShell 把命令提前执行，反引号 ` 必须是每一行末尾的最后一个字符，后面不要再加空格。

翻译完成后，可以在同一目录中查找 *-mono.pdf、*-dual.pdf 和 *.translation.log。如果输出目录中已有同名结果，建议先确认是否需要覆盖或改用新的输出目录。