在 GitHub 上编辑 content/zh/controller.md ↗
只负责标签的 Controller
Controller 每 30 分钟及按需运行 .github/scripts/controller.mjs;只使用内置 GITHUB_TOKEN,没有 LLM、密钥、GitHub App 或保存的 token。
职责
它只管理标签,从不合并、批准、评论、编辑或关闭任何东西,也不 checkout 或运行 PR/issue。issue/PR 文本只作为数据读取(用正则找 Fixes #N);PR 的变更文件通过 API 读取,并按与风险门相同的规则判断(.github/agent/risk-rules.json)。
| 规则 | 效果 |
|---|---|
每个开放 PR(最近更新 50 个,排除 hold) |
由风险门设置 risk:T0..risk:T3,替换过时标签;文件读不到时不做任何变更。仅供参考:标签不参与合并决策 |
| Agent 的 PR | 作者在 agentAuthors、分支以 agent/ 开头、或本仓库分支对 agent-ready/agent-working issue 写 Fixes #N 时添加 agent-pr。fork PR 只按作者判断;标签不删除 |
agent-ready / agent-working issue |
最后一次 agent-ready 由非维护者设置,或非维护者在批准后编辑正文时,移除两个标签;维护者重新打标签即重新批准 |
agent-working claim |
超过 claimTtlHours(6 小时)且没有开放关联 PR 活动时移除 |
issue/PR 上的 hold |
全部跳过 |
| 仓库中不存在的标签 | 跳过添加并报告,绝不创建;移除仍然执行 |
维护者列表在 .github/agent/controller.json;编辑它是 T3。Controller 永远不能添加 agent-ready 或 agent-working;validatePlan 会拒绝。
模式
| 开关 | 位置 | 效果 |
|---|---|---|
| 默认 | 未设置 | dry run:plan 只读,把计划写进 job summary;apply 不运行 |
CONTROLLER_LIVE=true |
仓库变量 | live:apply 添加/移除标签;其他值仍是 dry run |
AGENT_PAUSE=true |
仓库变量 | 完全停止:不读、不计划、不修改 |
| 禁用/删除 workflow | Actions | 关闭 |
权限
plan:contents: read、issues: read、pull-requests: read。apply:contents: read、issues: write、pull-requests: write,且只在 CONTROLLER_LIVE=true 且有操作时运行。workflow 级权限为 {}。
脚本只写入 POST .../issues/N/labels 与 DELETE .../issues/N/labels/NAME;没有 merge、review、comment、close、eval 或额外网络访问。计划以 job output 传递(数字、固定标签名与固定原因码);apply 再次校验并重新读取目标。