文件夹触发式 PDF 翻译工作流

方法定义

把外语 PDF 放入 GitHub 仓库指定目录，由 GitHub Actions 自动检测、安装 pdf2zh 与 LLM API 凭据、调用模型翻译、归档原文件并提交译后结果，从而把"放入文件"这一动作变成完整交付链的轻量自动化模式。

适用场景

• 需要重复翻译多份外语 PDF，并希望由云端长任务承担算力。
• 愿意维护一个 GitHub 仓库及其 Action 配置。
• 同时需要单语版本与中英双语对照版本以方便逐段核查。
• 可对模型输出做人工校对。

输入与条件

• 一份或多份外语 PDF 放入 papers/ 目录。
• GitHub 仓库 Secret 中保存 LLM API Key。
• 已配置的 .github/workflows 步骤与占位文件。
• 一个 LLM API 服务（例如硅基流动）与所选模型。

处理步骤

1. 仓库约定 papers/、archive/、translation_output/ 三个目录。
2. .github/workflows 检测 papers/*.pdf 出现后启动任务。
3. 步骤内安装 Python 与 pdf2zh。
4. 调用模型 API，把 PDF 翻译为中文与中英双语对照。
5. 把原 PDF 移入 archive/，避免重复处理。
6. 把译后 PDF 写入 translation_output/。
7. 通过 git commit 与 push 把结果沉淀回仓库。

关键工程修正

• 长任务期间远端仓库变化会导致 push 冲突；步骤中需加入 stash、pull/rebase、push 重试。
• Git 不跟踪空目录，papers/ 需放置占位文件。
• 大 PDF 单次运行可能超过四五十分钟，需考虑拆分或 CI 任务时长上限。

失败经验

• 默认机器翻译存在语义错译，例如把"摘要"误译为"抽象的"；模型输出应作为待校对译稿。
• "0 成本"依赖第三方赠送额度，真实 API 费用由模型、文档长度、平台政策共同决定。
• 文章中硅基流动邀请链接带有返利关系，不构成中立工具对比。

关联内容

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