翻译外语 PDF 并生中英对照交付件

可以得到什么

• 一份或多份外语 PDF 的中文版本。
• 同一份 PDF 的中英双语对照版本，方便逐段核查。
• 由 Git 提交沉淀的归档记录与目录约定。

适合哪些情况

• PDF 较长，本地或浏览器插件翻译慢、容易失败或占用个人设备。
• 翻译结果需要进一步人工校对。
• 愿意配置 GitHub Actions 与第三方 LLM API。
• 倾向于把"放入文件"作为唯一触发动作的轻量自动化。

需要准备什么

• 一个 GitHub 仓库，以及 papers/、archive/、translation_output/ 目录约定。
• .github/workflows 中的工作流文件与 papers/ 的占位文件。
• 一个 LLM API 平台的账号与 API Key，例如硅基流动。
• 选定的翻译模型，例如 DeepSeek V3、Gemini、Qwen2.5-7B-Instruct 或 DeepL。

常见做法

• 通过文件夹触发式自动化，把翻译交给云端长任务。
• 同步产出单语与双语版本，作为人工校对界面。
• 把原文件移入归档目录，避免重复处理。
• 在 Action 步骤中加入 stash、pull/rebase、push 重试以应对 push 冲突。
• 把模型输出视为待校对译稿，逐段核对术语与语义。

真实案例与教程

• 案例：用 GitHub Actions 翻译 Google 提示词工程白皮书（Ygria 使用该方法翻译 Google 提示词工程白皮书）
• 方法：文件夹触发式 PDF 翻译工作流
• 工具：pdf2zh、GitHub Actions、硅基流动 API
• 创作者：Ygria

限制和检查点

• 翻译耗时受文档大小、模型与网络影响，大 PDF 常需四五十分钟甚至超过一小时。
• 实际费用依赖具体模型、文档长度与平台赠送额度；个案数据（"一毛多"/累计 2 元）不构成通用单价。
• 默认机器翻译可能出现语义错译，需保留人工核对环节。
• 把含敏感内容的 PDF 上传至 GitHub 并发送给云端 API 涉及文档隐私。
• 文章中部分平台邀请链接带有返利关系，应注意区分"工具介绍"与"推广内容"。

相关任务

• 批量处理长 PDF
• 生成中英对照交付件
• 把处理结果以 Git 提交形式沉淀

来源

• 来源 ID：SRC-WORK-001
• 作者：Ygria
• 平台：Ygria's Blog
• URL：https://ygria.site/pdf-translate/