heydeer
GitHub 上的审查

PR 评论命令

在 PR 中发表评论,即可发起 HeyDeer 审查、暂停自动审查或启动 Autopilot。无论审查时机如何设置,命令在每个已连接的仓库中都可用。

命令

alex发表了评论
@heydeer review
HeyDeer 接受请求后会在你的评论上添加 👀,审查完成后会将其移除。
命令作用
@heydeer review使用仓库的默认审查深度和反馈范围审查当前提交。开启只审查新改动时,只覆盖自上次审查以来的改动。参见后续审查。
@heydeer full review重新审查整个 PR。
@heydeer pause停止此 PR 的自动审查。排队中的审查会继续,你仍然可以手动发起审查。
@heydeer resume恢复此 PR 的自动审查。不会发起审查。
@heydeer autopilot启动 Autopilot:HeyDeer 会修复该拉取请求中待处理的问题,推送到它的分支,并审查每次改动,直到可以合并。
@heydeer autopilot stop停止该拉取请求上的 Autopilot。

结果遵循你的发布设置。如果 HeyDeer 无法运行审查,或审查失败、被取消,HeyDeer 会回复你的评论。暂停和恢复命令会立即收到回复。Autopilot 命令会收到一个表情回应,Autopilot 自己的评论会显示它正在做什么。

手动发起的审查与其他审查一样计费;参见积分如何计费。它不计入每个 PR 的自动审查次数上限。

同一提交的审查正在排队或进行时,只含 @heydeer review 的评论会加入该审查,不会另起一次,也不会额外消耗积分。HeyDeer 会照常为你的评论添加 👀 回应,审查也会照常报告结果。该审查不会读取它发起后才发布的评论;如需纳入这些评论,请在它完成后再次发起审查。

HeyDeer 如何识别评论

  • 在新的 PR 讨论评论或代码行上的审查评论中,任意位置写入命令即可。代码行评论中的命令会照常审查整个 PR,而不只是那几行代码。
  • 请以普通文本写命令,不要放在代码、引用或 HTML 注释中。HeyDeer 会忽略编辑过的评论和机器人发布的评论。
  • 如果一条评论包含多条命令,HeyDeer 只执行第一条。
  • 如需选择审查深度或反馈范围,请从 HeyDeer 发起审查。

其他提及 @heydeer 的评论,可以请 HeyDeer 回答问题或完成工作。请参阅提及 @heydeer。

如果命令没有得到 👀 或回复,参见故障排除。

补充缺失的上下文

当审查在待澄清下提出疑问,或某个发现的问题遗漏了你了解的情况时,请在新评论中说明。在同一条评论中加上 @heydeer review,即可带着你的说明发起审查。

alex发表了评论
这里的空 catch 是有意为之:缓存是可选的,未命中时会回退到数据库。@heydeer review

每次附带说明的请求都会运行一次新的审查,并读取最新的讨论,即使代码没有变化。不含命令的回复不会发起审查。

如果决定不处理某个发现的问题,参见决定不处理发现的问题。

谁可以执行命令

谁可以发起审查设置决定谁可以执行命令,位于工作区设置 → 审查规则 → 手动审查权限,或某个仓库的审查规则中。

选项谁可以发起审查
拥有仓库写权限的所有人默认。拥有写入、维护或管理权限的所有人。
拥有写权限的指定用户或团队列在“GitHub 用户名”或“团队”中、且拥有写权限的人。

同样的规则也适用于从 HeyDeer 和检查上的按钮发起的审查。自动审查筛选条件不限制手动发起的审查。

从 HeyDeer 发起审查

  1. 在 HeyDeer 中打开审查记录,选择发起审查。
  2. 选择仓库和拉取请求。只能选择你拥有写权限的仓库。
  3. 如需更改审查深度或反馈范围,请打开审查选项。两者的初始值都是仓库的默认设置。
  4. 选择运行审查。