拉取请求

在 Repo 面板中阅读、评论并合并 GitHub 拉取请求和 GitLab 合并请求——可合并状态一行会明确指出是什么在阻止合并,合并会锁定到你审阅过的那个版本,批量合并则会为每个请求给出单独的结果。

拉取请求是 Repo 面板的第三个标签页,位于流水线与议题旁边。它与面板的其余部分使用同一个 Git 远程仓库,同时支持 GitHub 拉取请求和 GitLab 合并请求。

Repo 面板中的“拉取请求”标签页,列出两个处于打开状态的请求及其分支和作者,标签页上显示打开数量

列表

拉取请求标签页上的角标会显示有多少个请求处于打开状态,这样你无需打开标签页就能知道是否有待处理的内容。

可以按已打开、已合并、已关闭或全部进行筛选,也可以按标题、编号或分支搜索。搜索带有防抖处理,而不是每次按键都触发——在 GitHub 上,它会在面板已有的数据中本地搜索;在 GitLab 上,则会向服务提供方发起请求。

拉取请求不会被轮询。它们的变化以人的节奏发生,而实时请求额度要留给流水线轮询,因此列表只会在你主动刷新时更新。

查看单个请求

打开某一行,你会看到源分支和目标分支(来自复刻仓库的会有标记)、描述、标签、负责人、diff 大小以及完整的评论讨论串。

操作按钮上方是一行可合并状态,它给出的是真实状态,而不是一个简单的对勾:

状态行含义
可合并托管平台表示可以合并
存在冲突的更改两个分支之间有分歧
落后于基础分支请先更新它
被检查或审阅策略阻止缺少必需的检查或审阅
检查失败或仍在运行CI 尚未通过
草稿——请先在托管平台上标记为就绪再合并该请求尚未请求被合并
正在检查可合并性…托管平台尚未得出结果

详情视图中打开的一个拉取请求,描述和评论讨论串位于评论、合并和关闭按钮上方,并带有发送给 AI 按钮

合并

在 GitHub 上可选择合并提交、Squash 或 Rebase。GitLab 没有 rebase 合并这一操作,因此只提供合并或 squash。

应用会把你审阅过的确切版本作为合并的前置条件一并发送。如果你在阅读期间有人向该分支推送了新提交,托管平台会拒绝这次合并,而不是把你从未看过的代码合入。

你还可以评论(带有编辑 / 预览切换)、关闭请求,或重新打开已关闭的请求。

发送给 AI

发送给 AI 会把该请求交给一个 AI 终端进行审阅。你可以选择随请求一起发送的内容——拉取请求 URL、全部评论,或你勾选的个别评论——分支信息会自动附带。这与议题此前已有的流程相同。

一次合并多个

在列表中勾选任意处于打开状态且非草稿的请求,然后确认一次即可。它们会依次合并,各自保留自己的 head 版本条件,并且每个请求都会得到一个结果:哪些已合入,对于未能合入的,则会明确说明原因。

  • 草稿和已合并的请求无法被勾选,因此批量合并不会从一开始就包含本就不可能合入的成员。
  • 如果某个请求在你的选择仍打开期间已在别处合并或关闭,它会从选择中移除,而不会被带入本次执行。
  • 合并顺序就是你看到的顺序——列表按最近更新时间排序,这也是你刚才审阅它们的顺序,而不是按编号排序。

相关内容