用 HeyDeer 修复
把审查发现的问题变成一个可以检查和合并的 PR:选择要修复的问题、添加指令,由 HeyDeer 修改代码。
要求与限制
- PR 处于打开状态,且其分支位于同一仓库中,而不是来自 Fork。
- 你拥有该仓库的写权限。
- HeyDeer 拥有 Contents、Pull requests 和 Workflows 的读写权限。详见 GitHub App 与权限。
- 每个 PR 同一时间只能运行一个修复,每个修复最多包含 100 个问题。
- 修复可以更新
.github/workflows/中的 GitHub Actions 工作流文件。如果 HeyDeer 是在申请 Workflows 权限之前安装的,GitHub App 安装管理员必须先批准更新后的权限,才能开始修复。
发起修复
- 在 GitHub 审查评论中选择用 HeyDeer 修复,或在 HeyDeer 审查页面选择修复发现的问题。从单个问题的链接进入时,会预先选中该问题。打开页面不消耗积分。
- 选择要处理的问题。如果某个问题需要补充背景,例如希望采用的方案或需要保留的行为,可选择添加指令。
- 选择显示所选数量的按钮,例如修复 2 个问题。修复的页面会显示进度和结果。
列表显示该 PR 所有审查中尚未解决的问题,包括仍需处理的此前问题。已在讨论中决定不处理的问题不会列出。
如果所选问题已不再适用于当前代码,HeyDeer 可以跳过它。如果该 PR 已有正在运行的修复,请选择查看修复打开它。
检查并合并修复
HeyDeer 会新建分支,并以原 PR 分支为目标创建 PR;如果原 PR 是 HeyDeer 创建的,则直接推送到该 PR 的分支。阅读摘要,再从修复的页面打开 PR 检查代码修改。是否合并到原 PR 由你决定。
如果希望 HeyDeer 直接推送到原 PR 的分支,并持续修复和审查直到 PR 就绪,请使用 Autopilot。
摘要会列出所做的修改、HeyDeer 跳过的问题,以及已运行或无法运行的测试。如果不需要修改代码,修复会直接结束,不会创建 PR。
合并修复 PR 后,在原 PR 上评论 @heydeer review,或等待它的下一次自动审查。仅创建修复 PR 并不会让发现的问题变为已解决,也不会让 HeyDeer Review 检查通过。后续审查说明了这次审查如何重新检查此前的问题。
测试与 CI
发起修复后,HeyDeer 可以在能够访问公网的隔离沙箱中修改代码、安装依赖并运行你的测试。它会遵循你的审查指令和 AGENTS.md 等仓库指导。代码执行的隔离方式详见安全。
你的 GitHub 自动化流程可能会在修复 PR 上运行。仅针对 main 等目标分支的工作流,可能要等你将修复合并到原 PR 后才会运行。
积分与取消
与审查一样,修复按其工作量消耗工作区积分。参见修复如何计费。
修复运行期间,有写权限的人可以选择取消任务。取消会停止后续工作,已发布到 GitHub 的提交和修复 PR 会保留。如果积分用完,修复也会这样停止。
修复期间原 PR 发生变化时
修复基于你发起修复时 PR 所在的提交和分支进行。新的提交或关闭原 PR 都不会取消修复,因此合并前请检查是否有冲突。
如果原分支被删除或重命名,HeyDeer 无法创建修复 PR。请选择查看提交检查修改,并决定如何应用。