用 GitHub Actions 翻译 Google 提示词工程白皮书

背景和目标

作者 Ygria 希望解决"大 PDF 在本地或浏览器插件翻译慢、容易失败、占用个人设备"的问题，并把这一过程沉淀为可重复运行的 GitHub 仓库流程。

输入与条件

• 文档：Google 的提示词工程白皮书（外语 PDF）。
• 仓库约定：papers/（输入）、translation_output/（交付）、archive/（归档）。
• 工具：GitHub Actions + pdf2zh（PDFMathTranslate）+ 硅基流动 API。
• 模型候选：DeepL、Gemini、Qwen2.5-7B-Instruct、DeepSeek V3。

过程

1. 在 GitHub 仓库建立 papers/、archive/、translation_output/ 三个目录，并在 papers/ 放入占位文件。
2. 在 .github/workflows 中配置 Action，安装 Python 与 pdf2zh，并读取 API Secret。
3. 把待翻译 PDF 放入 papers/，由工作流自动触发。
4. 步骤内调用模型 API 翻译，同时产出纯中文 PDF 与中英双语对照 PDF。
5. 把原 PDF 移入 archive/，把译后文件写入 translation_output/。
6. 在 commit 步骤中加入 stash、pull/rebase、push 重试，处理长任务期间远端仓库变化导致的冲突。
7. 将变化提交回仓库，沉淀为可追溯的目录结构。

产物或结果

• 一份纯中文 PDF。
• 一份中英双语对照 PDF。
• 归档目录中保留原 PDF。
• 由 Git 提交记录沉淀的目录变化。

自报数据

• 几十页 PDF 一次翻译 API 消耗约"一毛多"。
• 大 PDF 翻译需四五十分钟，部分可超过一小时。
• 多轮测试累计约 2 元。
• 默认翻译把"摘要"误译为"抽象的"。

限制

• 上述费用与耗时为作者个案，不能换算为通用单页成本。
• 翻译质量比较基于一份测试文档与作者主观经验，不构成模型排名。
• 文章包含硅基流动邀请链接，存在推荐返利关系。
• 文档内容被发送至云端 API，隐私与合规需单独评估。
• 页面未显示可可靠确认的发布日期。

相关教程和工具

• 方法：文件夹触发式 PDF 翻译工作流
• 任务：翻译外语 PDF 并生中英对照交付件
• 工具：pdf2zh、GitHub Actions、硅基流动 API
• 创作者：Ygria
• 风险：PDF 云端翻译的隐私与费用边界

来源

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