参考

故障排除

找到对应的症状，然后逐一排查可能的原因。

PR 没有被自动审查

最新提交上的 HeyDeer Review 检查会说明原因，标题为“已跳过审查”；如果开启了“发现问题时将检查标记为失败”，标题为“需要审查”。没有检查？参见没有出现 HeyDeer Review 检查。

可能的原因	处理方法
审查时机为“仅手动”，这是新工作区的默认设置。	选择“每个 PR 审查一次”或“每次推送时审查”。参见自动审查。
PR 不符合你的自动审查筛选条件，默认会跳过草稿和 Fork。	将其标记为可供审查、修改筛选条件，或评论 `@heydeer review`。
此 PR 的自动审查已暂停。	评论 `@heydeer resume`。
“每个 PR 审查一次”已经发起过一次审查，或仍有审查在排队或运行中；或者 PR 已达到“每个 PR 的自动审查次数上限”。	评论 `@heydeer review`。
工作区积分已用完或已达到用量上限。	加购积分，或在“消费控制”中提高上限，然后重新发起审查。参见自动充值与用量上限。
试用期间，该仓库已经在另一个工作区中试用过。	选择套餐，然后请求审查。
GitHub App 无法访问该仓库。	检查“组织设置 → GitHub 连接”。参见 GitHub App 与权限。
推送后 HeyDeer 会等待约 30 秒，或者审查正在排队（审查排队中）。	请等待。
该提交已经审查过；重新打标签或重新打开 PR 不会再次审查。	推送新的提交，或评论 `@heydeer review`。

检查标题	原因	处理方法
审查发现需要关注的问题	发现了问题，且“发现问题时将检查标记为失败”已开启。	修复问题并推送，或将相关讨论标记为已解决。
审查未完成	有仓库检查或先前发现的问题未被评估。	重新发起审查。
无法运行审查	基础分支上的 `.agents/checks` 配置无效。	修复后请求审查。
无法运行审查	PR 讨论过大：超过 200 个审查讨论、单个讨论超过 1,000 条评论，或约 180 KB。	在新的 PR 中继续。
无法运行审查	GitHub 或 HeyDeer 暂时不可用。	重新请求审查。
审查失败、审查超时	审查未完成。因 HeyDeer 方面原因导致的失败会退还积分。	重新发起审查。
审查已取消	有人取消了审查，其 PR 已关闭，或更新的推送取代了它（“每次推送时审查”）。	重新发起审查。
没有可审查的文件	所有改动的文件都不在审查范围内，例如生成文件。	无需处理。

所有结论都列在 HeyDeer Review 检查中。

可能的原因	处理方法
该仓库的“发布 GitHub 检查”已关闭。	将其开启。参见发布结果。
该仓库设置为“仅手动”，且从未被审查过。	请求一次审查。之后的版本就会有检查。
GitHub App 缺少 Checks: Read and write 权限，或该仓库不在其安装范围内。	在 GitHub 上批准该权限或添加该仓库。
PR 已关闭。	重新打开它。

可能的原因	处理方法
没有回复：评论中除了命令还有其他内容、命令是编辑时添加的，或是由机器人发布的。	使用个人账号发布一条只包含命令的新评论。
没有回复：GitHub App 缺少 Issues 读取权限。	在 GitHub 上批准该权限。
你没有写权限，或不在“谁可以发起手动审查”的范围内。	请联系管理员或有权限的人。
请求过多，或审查队列已满。	稍等片刻，然后再次发布命令。
在已关闭的 PR 上使用 `pause` 或 `resume`。	这两个命令只对打开的 PR 有效。
积分不足，或已达到用量上限。	加购积分或提高上限，然后再次发布命令。
GitHub 暂时不可用。	在新评论中再次发布命令。

HeyDeer 不回答问题。参见 PR 评论命令。

每个警告都会关闭该次审查的自动批准。

可能的原因	处理方法
该检查在此 PR 中被修改；HeyDeer 读取的是基础分支上的版本。	先合并该修改。
检查的模式没有匹配任何改动的文件，或该文件不是直接位于 `.agents/checks/` 中的 .md 文件。	修正模式或移动文件。参见仓库检查。
该 AGENTS.md 规则所在的目录不覆盖改动的文件。	移动它。参见 AGENTS.md。
指令是在请求审查之后保存的，或被仓库指令覆盖。	重新发起审查，或解决冲突。参见审查指令。
该问题未达到“反馈范围”的要求。	尝试“平衡”或“详尽”。参见反馈范围。
该文件在 `.gitattributes` 中被标记为 linguist-generated。	移除该属性。参见 HeyDeer 读取的内容。
该规则无法通过阅读代码来判断。	将其改写为能在 diff 中看出的内容。参见编写有效的检查。

表单会说明每个被拒绝的值；参见 MCP 服务器。更改端点后，请输入新令牌或删除已保存的令牌。只有同时是 GitHub 组织或账号所有者的工作区管理员才能管理服务器。

可能的原因	处理方法
你的 GitHub 登录已过期，HeyDeer 显示“使用 GitHub 登录”。	选择它重新登录，并返回同一页面。
你登录的 GitHub 账号无法查看该审查或组织。	选择“使用 GitHub 继续”或“重新授权 GitHub”，然后在 GitHub 上选择正确的账号。
连接时找不到某个组织或仓库。	在“找不到组织或仓库？”下检查安装情况，必要时在 GitHub 上通过 SSO 登录，然后选择“重新授权 GitHub”。参见 GitHub App 与权限。

可能的原因	处理方法
银行卡被拒绝，或银行要求验证付款。	如果是订阅付款，请在“用量与账单 → 概览”中选择“完成付款”。其他购买请使用另一张银行卡。
“加购积分”提示你需要套餐。	请先选择套餐；如果“概览”中显示“完成付款”，则选择它。参见套餐与加购积分。
“自动充值”显示为已关闭，下方附有原因。	解决原因后重新开启。参见充值失败时。
续订付款处理中。	在此期间，你的套餐保持有效。如果付款失败或需要银行确认，HeyDeer 会向工作区发送邮件；请选择“完成付款”。
“加购积分”或自动充值提示已达到 24 小时上限。	等待滚动 24 小时购买上限释放出可用额度，或联系支持团队。
付款和新的付费审查已暂停。	HeyDeer 正在处理该工作区的账单问题。请联系支持团队。
付款仍在处理中，或“加购积分”要求你确认之前的购买。	选择“确认购买结果”，直到显示结果。不要发起新的购买。