GitHub Actions

工具概况

• 名称：GitHub Actions
• 类型：CI/自动化平台
• 在本来源中的角色：工作流编排与运行环境，承担检测输入文件、安装依赖、调用翻译、归档与提交回仓库。

在工作流中的位置

• 仓库中 .github/workflows 目录定义触发与步骤。
• 检测 papers/*.pdf 出现后启动任务。
• 安装 Python 与 pdf2zh，调用 LLM API 翻译。
• 把原文件移至 archive/，把译后文件写入 translation_output/，并自动提交回仓库。

适用任务

• 长时间 PDF 翻译的云端执行。
• 以文件夹变化为触发条件的轻量自动化。
• 把处理结果以 Git 提交形式沉淀回仓库。

限制与检查点

• 长任务期间远端仓库可能变化，导致 push 冲突；需配合 stash、pull/rebase、push 重试。
• 空目录不会被 Git 跟踪，触发目录需放置占位文件。
• 任务最长运行时间存在平台上限，大 PDF 可能需要拆分或重试。

关联内容

• 任务：翻译外语 PDF 并生中英对照交付件
• 工具：pdf2zh、硅基流动 API
• 方法：文件夹触发式 PDF 翻译工作流
• 案例：用 GitHub Actions 翻译 Google 提示词工程白皮书