第39章：Annotate AI Diff

Annotate AI Diff 是 Orca 为 agent 生成的代码提供的行内评审闭环。你可以对 AI 生成的任意代码块的任意行添加评论，然后把这些评论一次性批量发回给 agent 进行修改——不用复制行号，也不用切换上下文。

Annotate AI Diff — 固定在 diff 行上的行内评论

添加评论

把鼠标悬停在 diff 中的任意行上，行号旁会出现一个 +。拖选相邻的多行，或按住 Shift 扩展选区，即可针对多行范围添加评论。Orca 会将范围限制在代码块内部，并标注所选的行区间。

点击这个 +（或将光标移到该行后按 c）。

输入你的反馈——支持 markdown。

按 Enter 或 Cmd/Ctrl-Enter 保存，Shift-Enter 换行，Esc 取消。

评论会固定在具体行上；Orca 会在代码变更时追踪这些行，即使 diff 发生偏移，评论也会跟着走。

批量发送

评审完成后，点击 diff 顶部的 Send to agent。Orca 会把所有评论整合成一条以行为锚点的提示词，并弹出 Send notes to 菜单，列出该 worktree 可用的 agent。选择负责修改的 agent，或从同一菜单启动一个新的 agent。

Send Review Notes to Agent 默认未绑定快捷键，以避免与其他组合键冲突。你可以在 Settings → Shortcuts 中为其分配快捷键，从而通过键盘打开发送菜单（即使焦点在编辑器中也能使用）。

为什么要批量？

逐条发送评论会让 agent 来回折腾。批量发送能让反馈保持连贯：一轮思考、一次修改，命中率也高得多。

回复、解决、复查

agent 修改后评论依然保留——可以用它们验证修复是否到位。

点击 Resolve 可折叠一条讨论串。

如果再次点击 Send，未解决的评论会自动纳入下一批发送内容。