GitHub 上的审查
PR 评论命令
在 PR 中发表评论,即可发起 HeyDeer 审查、暂停自动审查或启动 Autopilot。无论审查时机如何设置,命令在每个已连接的仓库中都可用。
命令
alex发表了评论
@heydeer review
| 命令 | 作用 |
|---|---|
@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 用户名”或“团队”中、且拥有写权限的人。 |