pdf2zh

工具概况

• 名称：pdf2zh（项目名 PDFMathTranslate）
• 类型：Python 翻译包
• 在本来源中的角色：被 GitHub Actions 安装并调用，承担把外语 PDF 翻译为中文与中英对照版本的实际工作。

在工作流中的位置

• 在 .github/workflows 中通过 Python 步骤安装并调用。
• 读取仓库 Secret 中的 API Key 与所选模型配置。
• 处理 papers/*.pdf，把原文件移入 archive/，把译后文件写入 translation_output/。

适用任务

• 翻译较长的外语 PDF。
• 同时产出单语版本与双语对照版本，便于逐段核查。
• 在 CI/Action 场景中以云端长任务方式运行。

限制与检查点

• 默认翻译可能出现语义错译，例如把"摘要"误译为"抽象的"；输出应被视为待校对译稿。
• 翻译大 PDF 耗时长，需在 CI 中处理 push 冲突和目录占位。
• 仍依赖第三方 LLM API 凭据，具体模型选择影响费用、质量与耗时。

关联内容

• 任务：翻译外语 PDF 并生中英对照交付件
• 方法：文件夹触发式 PDF 翻译工作流
• 案例：用 GitHub Actions 翻译 Google 提示词工程白皮书
• 风险：PDF 云端翻译的隐私与费用边界
• 工具：GitHub Actions、硅基流动 API