GitHub CLI v2.105.0 支持事件流:一条命令等待 PR 事件
GitHub 在 CLI v2.105.0 中引入 GitHub Event Streams 支持,开发者与智能体可用 gh event listen 订阅拉取请求事件,不再循环轮询。命令默认在首个事件后退出,便于嵌入脚本和智能体循环;事件流本身在 GitHub.com 上处于预览阶段,需通过候补名单获取访问权限。
从轮询到事件订阅
GitHub CLI v2.105.0 新增 gh event 命令,用户和智能体可以等待拉取请求发生变化,而不必在循环中反复查询。使用方式是在 gh event listen 后传入拉取请求 URL 以及关心的事件类型,例如已提交的评审。命令会创建订阅、打开事件流,并把每个事件作为一行 JSON 打印出来。
默认行为是收到第一个事件后退出,因此可以直接放入脚本和智能体循环。若需要等待多个事件,可用 –count 指定数量;–follow 让命令持续监听;–timeout 用于设定停止等待的时间。输出字段可通过 –jq 或 –template 筛选,只保留所需内容。
可等待的事件类型
原文列出的可等待事件包括已提交的评审、拉取请求状态与 head 变化、合并冲突,以及已完成的检查套件。这些事件覆盖了代码评审、分支更新和 CI 结果等常见协作节点,使脚本能在关键状态出现时再继续执行。
除监听外,用户还可以直接管理订阅,通过 gh event subscription create、list、view 和 delete 完成创建、列出、查看与删除操作。这为需要自行控制订阅生命周期的场景提供了入口。
智能体自动发现新命令
GitHub 表示智能体会自行发现这些新命令:gh pr create、gh pr view、gh run view、gh run watch 和 gh api 现在会建议使用 gh event listen,而不是轮询。这意味着智能体在执行相关操作时,会收到改用事件监听的提示。
这一改动针对的是智能体工作流中长期存在的轮询模式,把等待动作交给事件流处理,减少重复查询。
预览状态与访问条件
gh event 命令目前处于预览阶段,可能发生变化。使用这些命令需要访问 Event Streams,而 Event Streams 在 GitHub.com 上也处于预览阶段,用户需加入候补名单以获得访问权限。
使用前需升级到 gh v2.105.0 或更高版本。原文建议查阅 gh event 手册和 Event Streams 文档,或运行 gh event –help 了解详情,并可在 GitHub Community 讨论中反馈意见。
知序观察
观察:把 PR 等待从轮询改为事件订阅,直接降低了脚本和智能体在等待评审、CI 结果时的无效请求,也让智能体循环的触发条件更明确。不过 Event Streams 与 gh event 均处于预览阶段且需候补名单,短期内实际可用范围仍受限制,命令行为也可能调整。