AIGC标识 AI 说已经改完了,合并前怎么看 Diff?(Caravel 实操)

一句话答案:Agent 回报「已完成」,只说明它停止了输出;能不能合进项目,要先打开实际 Diff,看清改了哪些文件、增删了多少行,再逐文件对照,而不是只看它的总结。

本文演示工具:Caravel —— 本地优先的多 AI 编码 Agent 桌面工作台,统一管理 Claude Code、Codex、OpenCode、pi、Grok、TRAE、Antigravity 的并行任务、Diff 验收与提示词库。免费使用,支持 macOS / Windows / Linux。

作者立场:本文作者在做 Caravel。通用方法不依赖某一家产品;文中按钮名以 Caravel 中文手册为准,步骤和数字来自 2026-11-11 的桌面实测。官网体验版是示例数据,不调用真实 Agent。

为什么不能只看 Agent 的「已完成」就合并?

直答:「已完成」是 Agent 自己的判断,总结里往往只写它计划改的位置;顺带改的配置、公共函数或无关文件,不一定会出现在回复里。

我自己就有过一次类似的教训。为了省事,我让 Agent 直接改一个小功能。它很快回复「已完成,验证通过」,我粗略看了眼回复就提交了。第二天发现它顺带改了几个与需求无关的文件,其中一处破坏了原有逻辑。Agent 并没有偷懒:需求做了,它也跑了自己认为必要的检查。问题是:我依据的是它的陈述,而不是实际产生的改动。

所以合并前要先回答三个问题:实际改了哪些文件?验证覆盖了什么、没覆盖什么?这些改动该不该进项目?前两个可以靠 Diff 看清楚,第三个只能由人来判断。

合并前怎么查看实际 Diff?

直答:任务显示「已完成」之后,先打开 git 菜单看未提交改动的汇总,再点「查看 Diff」,按文件清单和逐文件对照做验收,而不是先读总结。

我在 2026-11-11 实测了两次,都用 Grok(grok-4.7,推理强度 high)。

第一次任务是:「新建 hello.py,输出当前日期,并在 README 里说明用法」。任务显示已完成,上下文 6.7%,消耗 83.3K tokens。我打开任务标题旁的分支按钮(当时是 master +2),git 菜单顶部写着「2 处未提交改动:新增 1、修改 1、删除 0」。

任务完成后,打开 git 菜单,先看未提交改动汇总,再点「查看 Diff」

点「查看 Diff」后,顶部汇总是 2 文件,新增 1、修改 1、删除 0,+21 -0;左侧文件列表是 README.md +9、hello.py +12。这和需求范围对得上:一个新建文件、一个说明用法的修改,没有多出来的无关文件。

打开 README.md,能看到它补了一行 grok-4.7 的问候,以及一段用法(打印 ISO 日期,并给出 python3 hello.py)。打开 hello.py,是新建的 12 行:用 date.today().isoformat() 打印当天日期。左右对照下,新增行是绿色的。

第一次实测:2 文件 +21 -0,左侧能对上 README.md 和 hello.py

第二次我接着让它「给 hello.py 加一个 --utc 参数,输出 UTC 日期」。完成后再打开 Diff,汇总变成 2 文件,新增 1、修改 1、删除 0,+31 -0(README.md +3,hello.py +24)。这次我在「左右」和「行内」之间切换:左右适合看改前改后整块对比,行内把同一文件的增删挤在一列里,看局部补丁更紧凑。顶部还可以切换「精简 / 全文」。

第二次实测:打开 Diff 后逐文件查看,并在左右 / 行内之间切换

步骤可以记成:

  1. 任务变成「已完成」后,先别急着信总结;
  2. 打开 git 菜单,看「几处未提交改动」以及新增、修改、删除各多少;
  3. 点「查看 Diff」,先对文件清单:文件名和增删行数是否和需求一致;
  4. 再逐文件对照内容,用左右 / 行内、精简 / 全文切换;
  5. 看清楚之后,再决定提交、继续改,还是丢弃改动。

在 Caravel 里:任务完成后,从分支按钮打开 git 菜单即可看到未提交改动汇总和「查看 Diff」。Diff 顶部给出文件数和增删行数,左侧是文件清单,右侧支持左右 / 行内、精简 / 全文。

有哪些实际好用的技巧?

  1. 先看文件清单和增删行数,再看总结。 需求只涉及一两个文件,清单里却多出好几个,就是超出范围的信号。第一次实测是 2 文件 +21 -0,和「新建 hello.py + 改 README」对得上,我才继续往下看。
  2. 逐文件看,不要只扫一眼总计。 README.md +9、hello.py +12 是两件不同的事,打开才能确认有没有顺带改无关内容。
  3. 左右 / 行内、精简 / 全文按场景切换。 看整段新增用左右更直观;看补丁细节用行内更省地方。精简突出变更行,全文保留上下文。
  4. 看完再决定提交或丢弃。 菜单里的「丢弃改动」对应 git reset --hard,会清掉未提交改动,点之前一定要先看过 Diff。

Diff 验收有什么做不到的?

直答:Diff 只能让你看清改了什么,不能替你下「可以交付」的结论,也不能代替跑测试。

  • 范围对、代码能跑,仍可能不符合你的意图或项目约定,这个判断只能人来做。
  • 「丢弃改动」是破坏性操作(git reset --hard),如果改动已经提交,菜单里的丢弃也救不回那次提交,需要自己用 Git 处理。
  • Agent 自报「验证通过」,只说明它执行过的检查通过了;没跑到的路径,Diff 也不会替你补测。
  • Caravel 免费使用,支持 macOS / Windows / Linux;模型额度走你自己的 Agent 订阅或 API Key。

常见问答

  • 查看 Diff 会把改动提交掉吗? 不会。它只是打开对照,不会提交或推送。
  • 左右和行内有什么区别? 左右是改前改后并排;行内是同一列里看增删。我第二次实测切换过,小补丁用行内更紧凑。手册:查看结果并验收。
  • 精简和全文有什么区别? 精简突出变更行,全文保留前后上下文,文件较长时先精简再按需切全文。
  • 文件很多时怎么快速判断有没有改超范围? 先看左侧清单里的文件名和每个文件的增删数,对不上就先不要合并,回到任务里追问为什么要改这些文件。
  • 官网体验版能完整试用 Diff 验收吗? 体验版是示例数据,不调用真实 Agent;请以桌面应用为准。

边界说明

Diff 验收解决的是「不要只凭 Agent 的『已完成』就合并」,不能代替选对任务范围、跑测试和代码评审。按钮名以你本机当前版本和手册为准。本文不写竞品对比。

小结

Agent 说「已完成」时,先打开 Diff,看文件清单和逐文件对照,再决定是否提交。我在 2026-11-11 实测:第一次新建 hello.py 并补充 README,Diff 为 2 文件 +21 -0;接着加 --utc 参数后为 2 文件 +31 -0,并可在左右 / 行内之间切换。手册:https://www.caravelai.top/zh-CN/docs/review/ · 官网:https://www.caravelai.top/


本文展示的界面来自 Caravel(免费使用,macOS / Windows / Linux)。可先看在线体验或使用手册,安装包在官网下载与 GitHub Releases。

posted @ 2026-11-17 11:11  36295238  阅读(17)  评论(0)    收藏  举报