文档

文档导航

• 最佳实践：有代码审查和没有代码审查的团队分别如何配置、如何在团队中推广，以及如何减少噪音。
• GitHub 上的审查：解读审查结果、用 HeyDeer 修复、HeyDeer Review 检查、PR 评论命令和后续审查。
• 配置审查：设置如何生效、自动审查及其筛选条件、审查深度、反馈范围、发布结果和自动批准。
• 让 HeyDeer 了解你的代码库：HeyDeer 读取的内容、AGENTS.md、REVIEW.md、仓库检查、技能、审查指令和连接器。
• 工作区与账单：成员、洞察、通知邮箱、积分、套餐、自动充值和用量上限。
• 参考：所有设置、GitHub App 权限、故障排除和常见问题。

遇到问题？参见故障排除。

工作原理

你会在 PR 上看到什么

HeyDeer 以 GitHub 审查的形式发布发现的问题。大多数问题以行内评论的形式出现在相关代码行上，包含严重程度、问题所在，通常还有修复建议。涉及 diff 之外代码的问题会显示在审查评论中。参见解读审查结果。

src/sync/retry.ts

18for (let attempt = 1; ; attempt++) {

19 const res = await fetch(url);

20 if (res.ok) return res;

21 await sleep(backoff(attempt));

heydeerbot

🟠 高（可靠性）：遇到 404 时重试循环不会停止

fetchWithRetry() 会重试每个失败的响应，包括永远不会成功的 404，导致同步任务一直循环到超时。

建议修改

- if (res.ok) return res;

+ if (res.ok) return res;

+ if (res.status < 500 && res.status !== 429) throw new HttpError(res);

了解更多

修复建议: 只重试服务器错误和 429 响应，其他客户端错误直接抛出。

如需让 HeyDeer 修复你选择的问题，请在审查中选择用 HeyDeer 修复。HeyDeer 会创建一个独立的 PR，由你检查并合并；参见用 HeyDeer 修复。

为什么选择 HeyDeer

• HeyDeer 独立于编写代码的人或智能体来审查每项改动。
• 发布每个问题之前，它都会先对照代码核实。
• 它会把 AGENTS.md 中的约定和仓库检查中的要求应用到它们覆盖的文件上。

设置 HeyDeer

新工作区默认使用免费套餐，首月包含 1,000 积分，之后每月 300 积分。快速入门介绍从安装 GitHub App 到首次审查的完整流程。

然后，根据团队目前的合并方式选择对应的配置：

• 没有代码审查的团队：智能体直接提交到 main，或 PR 在 CI 通过后即合并。
• 有人工审查员的团队：每个 PR 在合并前都由人审查。