参考

故障排除

在下方找到你遇到的问题。每个表格都把最常见的原因列在前面，较少见的放在后面。

PR 没有被自动审查

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

关闭发布 GitHub 检查后，当 PR 达到每个 PR 的自动审查次数上限或 HeyDeer 无法运行审查时，HeyDeer 会改为在 PR 中发表评论说明原因，每种原因只评论一次。只有开启在 PR 中发布审查评论时，才会发布这些评论。

可能的原因	处理方法
审查时机为仅手动。	选择每个 PR 审查一次或每次推送时审查。参见自动审查。
PR 不符合你的自动审查筛选条件，默认会跳过草稿、Fork 和依赖更新。	将 PR 标记为可审查（Ready for review）、修改筛选条件，或评论 `@heydeer review`。
可用容量已占满，审查正在排队（审查排队中）。	请等待。
审查时机为“每个 PR 审查一次”且已有一次成功完成的审查，或该 PR 已达到“每个 PR 的自动审查次数上限”。	评论 `@heydeer review`。
工作区积分已用完或已达到用量上限。	等待下次免费积分刷新、选择付费套餐或购买积分，或在用量与账单 → 概览 → 消费控制中提高上限，然后重新发起审查。参见自动充值与用量上限。
此 PR 的自动审查已暂停。	评论 `@heydeer resume`。
该提交已经审查过；重新打标签或重新打开 PR 不会再次审查。	推送新的提交，或评论 `@heydeer review`。
HeyDeer 的 GitHub 访问权限不包括该仓库。	检查工作区设置 → GitHub 连接。参见 GitHub App 与权限。
该仓库已关联另一个工作区的免费积分。	选择套餐，然后发起审查。

检查失败或审查未完成

检查标题	原因	处理方法
审查发现了需要处理的问题	审查报告了发现的问题或仍未解决的此前问题，且发现问题时将检查标记为失败已开启。	修复后推送。如需决定不处理某个问题，由有写权限的人说明决定或将讨论标记为已解决，然后评论 `@heydeer review`。
审查已取消	有人取消了审查、其 PR 已关闭，或更新的推送取代了它。	重新发起审查。
审查未完成	有仓库检查未运行，或此前的问题未被重新检查。	重新发起审查。
审查失败 / 审查超时	审查未完成。HeyDeer 会退回其积分，除非审查调用过连接器。	重新发起审查。
审查无法运行	GitHub 或 HeyDeer 暂时不可用。	重新发起审查。
没有可审查的文件	所有改动的文件都不在审查范围内，例如生成文件。	无需处理。

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

HeyDeer 没有批准 PR

开启自动批准时，HeyDeer 中的审查页面会显示未自动批准及原因。所有要求都列在自动批准中。

可能的原因	处理方法
自动批准处于关闭状态（默认）。	在审查规则的发布结果下开启自动批准。参见开启自动批准。
仍有发现的问题或此前的问题。	修复后推送，或决定不处理。如果希望只剩低严重程度问题时也能批准，请将允许保留的问题设为允许低严重程度问题。
可自动批准的 PR：该 PR 的风险等级高于你的设置。	由人在 GitHub 上批准；审查会写明风险等级和理由。如果想让 HeyDeer 批准这类 PR，请在可自动批准的 PR中选择更高的等级。
待澄清：HeyDeer 有一个代码无法回答的疑问。	在新的 PR 评论中回答，并在评论中加上 `@heydeer review`。参见补充缺失的上下文。
审查带有审查说明，例如有仓库检查未运行。	解决说明中描述的问题，然后重新发起审查。
此前的问题未能完整检查。	重新发起审查。
在 PR 中发布审查评论已关闭。	将其开启。HeyDeer 通过发布审查来批准。

PR 有变化、是草稿或由 HeyDeer 创建时

可能的原因	处理方法
审查之后有新的提交被推送，或目标分支发生了变化。	发起或等待对最新提交的审查。
PR 是草稿。	将 PR 标记为可审查（Ready for review），然后发起审查。
PR 是由 HeyDeer 创建的，例如修复 PR。	需要由人来批准。

没有出现 HeyDeer Review 检查

可能的原因	处理方法
该仓库设置为“仅手动”，且从未被审查过。	发起一次审查。之后的提交就会有检查。
该仓库的发布 GitHub 检查已关闭。	将其开启。参见发布结果。
HeyDeer 在 GitHub 上缺少 Checks 读写权限，或其 GitHub 访问权限不包括该仓库。	由 GitHub 所有者在工作区设置 → GitHub 连接中选择查看权限请求或添加仓库。
PR 已关闭。	重新打开 PR。

命令没有回复或返回错误

可能的原因	处理方法
没有回复或 👀 表情回应：命令位于代码、引用块或 HTML 注释中，是编辑时添加的，或是由机器人发布的。	使用个人账号，在新的 PR 评论或代码行上的审查评论中，在任意位置以普通文本写入命令。
你没有写权限，或未列在手动审查权限中。	请联系管理员或有权限的人。
积分不足，或已达到用量上限。	选择套餐、购买积分或提高上限，然后再次发布命令。
请求过多，或审查队列已满。	稍后再发一次命令。
没有 👀 表情回应：HeyDeer 可能缺少 PR 讨论评论所需的 Issues 读写权限，或代码行上的审查评论所需的 Pull requests 读写权限。	由 GitHub 所有者在工作区设置 → GitHub 连接中选择查看权限请求，并在 GitHub 上批准。
在已关闭的 PR 上使用 `pause` 或 `resume`。	这两个命令只对打开的 PR 有效。
GitHub 暂时不可用。	在新评论中再次发布命令。

所有命令都列在 PR 评论命令中。

某条约定或检查似乎被忽略

可能的原因	处理方法
检查的模式没有匹配任何改动的文件，其 frontmatter 中没有 `files`，或该文件不是直接位于 `.agents/checks/` 中的 .md 文件。	修正 frontmatter 或模式，或移动文件。参见仓库检查。
该问题在你的反馈范围之外。	尝试“平衡”或“详尽”。参见反馈范围。
该 AGENTS.md 约定所在的目录不覆盖改动的文件。	移动它。参见 AGENTS.md。
该 REVIEW.md 所在的目录不覆盖改动的文件。	移动它。参见 REVIEW.md。
指令是在发起审查之后保存的，或被仓库指令覆盖。	重新发起审查，或解决冲突。参见审查指令。
检查要求的内容无法通过阅读代码核实。	将其改写为 HeyDeer 通过阅读代码就能核实的条件。参见编写有效的检查。
该文件在 `.gitattributes` 中被标记为 linguist-generated，或者是目标分支中已有的锁文件。	移除该属性，或将锁文件标记为 `-linguist-generated`。参见 HeyDeer 读取的内容。

审查带有审查说明

HeyDeer 会在审查说明下列出限制审查的因素。只要有审查说明，这次审查就不会自动批准。参见审查说明。

审查说明	处理方法
部分问题已省略	修复已显示的问题或决定不处理，然后重新发起审查。
匹配的仓库检查过多	缩小这些检查的文件模式，然后重新发起审查。参见仓库检查。
部分仓库检查无效	修复审查说明中列出的检查，然后重新发起审查。参见仓库检查。
部分仓库检查未能完成	重新发起审查。
部分发现的问题或此前的问题未能完整评估	重新发起审查。

登录与 GitHub 访问

可能的原因	处理方法
你的 GitHub 登录已过期，HeyDeer 显示使用 GitHub 登录。	选择它重新登录，并返回同一页面。
你登录的 GitHub 账号无法查看该审查或组织。	选择使用 GitHub 继续或重新登录 GitHub，然后在 GitHub 上选择正确的账号。
连接时找不到某个组织或仓库。	组织装上 HeyDeer 后才会列出，所以请选择在 GitHub 上安装或安装到其他账号，然后在 GitHub 上选择该组织。如果已装 HeyDeer 的组织仍然缺失，必要时先在 GitHub 上通过 SSO 登录，然后展开找不到你的账号？，选择重新登录 GitHub。参见 GitHub App 与权限。

账单问题

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

连接器问题

只有标记为GitHub 所有者或账号所有者的管理员才能管理连接器。参见连接器。

可能的原因	处理方法
HeyDeer 无法加载工具。	检查端点是否为服务器公开的 Streamable HTTP 地址，以及请求头中的凭据是否有效。
没有有效的付费套餐时，审查和任务不会使用连接器。	付费套餐包含连接器。选择套餐后，已保存的连接器会用于新的审查和任务。
审查或任务在你保存连接器之前就已开始。	设置只对保存之后发起的审查和任务生效。请重新发起一次。
审查或任务页面将某个连接器列为不可用。	仓库是公开的，或变更来自 fork 或没有写权限的人。只有公开数据才应选择也包括公开仓库和 fork。
审查没有使用连接器的任何工具。	审查只会调用已允许的只读工具。请在“只读工具”下允许所需的工具，或请服务器提供方为其只读工具添加标记。
审查在调用连接器后失败。	其积分不会退回。请发起新的审查。