Skip to content

标注 AI Diff ​

Annotate AI Diff 是 DevAgent 针对 agent 生成代码的行内审查循环。你可以在任意 AI 生成 hunk 的任意一行上留下评论,然后把它们作为一个批次发回给 agent 进行修订——不用复制行号,也不用来回切换上下文。

留下评论 ​

  1. 将鼠标悬停在 diff 中的任意一行上。装订线处会出现一个 +。
  2. 点击它(或在光标位于该行时按 c)。
  3. 输入你的反馈——支持 markdown。
  4. 按 Cmd-Enter 保存,按 Esc 取消。

评论会固定在确切的行上;DevAgent 会在多次编辑之间跟踪它们,即便 diff 发生位移,评论也会跟着对应的行走。

发送批次 ​

审查完成后,点击 diff 顶部的 Send to agent。DevAgent 会把你所有的评论组合成一个 prompt,每条都锚定到对应行,然后打开一个 Send notes to 菜单,列出该 worktree 可用的 agent。选择应当负责修订该改动的 agent,或者从同一个菜单启动一个新的 agent。

Send Review Notes to Agent 默认没有绑定按键,因此不会与其他快捷组合键冲突。你可以在 设置 → 快捷键 中为它分配快捷键,从而用键盘打开那个发送菜单(即使编辑器处于聚焦状态也可用)。

为什么要批量发送? ​

一次只发一条评论会让 agent 来回摇摆。批量发送能让反馈保持连贯:一轮思考、一遍修订,命中率也高得多。

回复、解决、再审查 ​

  • agent 修订之后,评论仍会保持固定——可以用它们来验证修复是否到位。
  • 点击 Resolve 可以折叠一个评论线程。
  • 如果你再次点击 Send,未解决的评论会被纳入下一个批次。

DevAgent 桌面客户端文档