在 GitHub 上编辑 docs/zh/github.md ↗

GitHub 集成

1. GitHub App 是什么

LaunchPad 以 GitHub App 的身份工作,而不是某个人的 PAT:

官方要求的 App 权限(docs/admin.md):

类别 权限
写 Contents、Issues、Pull requests、Commit statuses、Actions、Checks
读 Metadata、Members
订阅事件 issues、pull_request、issue_comment、pull_request_review、pull_request_review_comment、organization

Actions/Checks 的写权限用于发布状态、检查结果和重跑 CI;读权限让任务能用只读令牌查看 CI。

2. Webhook

3. 检视行为

4. 用仓库文件覆盖规则

仓库默认分支可放 .bot/ 文件,覆盖检视、标签、开发规则和虚拟电脑配置。仓库文件优先于内置默认和管理员在控制台的设置;路径、格式和限制见上游 docs/rules.md。这让一个组织可以按仓库调整策略,而不必改控制面代码。

5. 仓库自动化:模块化的门禁

src/automation/ 是“框架 + 可插拔能力模块 + 仓库级配置”(docs/automation.md):

6. CI 门禁与合并队列

“接入门禁”先介绍几条 lane:

lane 何时跑
pr-ready 每次 PR 提交:构建和基础检查
pr-merge 合入门禁:有 merge queue 时在队列里;没有时在合入后先重跑 pr-ready,再跑昂贵检查
daily 每日
release 版本标签触发

接入流程不是“一键覆盖”:agent 先审视现有 CI,和人一起定下每条 lane 的命令;人在预览里确认新增/修改的文件后,控制面才创建门禁 PR,包含门禁 job、.github/ci-gates.json,缺少时的 scripts/gate/gate.mjs 和由版本标签触发的 release.yml。已有文件只按方案合并修改。

空 lane 的 not_applicable 不代表实际检查通过;控制面不发布 PyPI、npm 包或镜像。

7. 发版

见生命周期 · 发版。要点:注释标签、跟踪 Release 工作流、准备草稿、人点击正式发布;同名标签不移动、不删除;没有新提交时跳过。

8. 限流与额度

“全局设置 → 机器人账号 → GitHub 请求额度”按账号列出每小时额度:

额度用完时任务等到窗口重置再继续,不占重试次数。

9. 身份与授权

这套模型的核心是:人类权限来自 GitHub 的可核实证明,不来自 bot 的安装令牌。