AI Agent / 系统课时

实现 Diff 审查与回滚

实现 Diff 审查与回滚

本课实现代码智能体修改后的审查与恢复能力,让用户能够理解 AI 做了什么变化,并在发现问题时安全撤销修改,形成可控的代码变更闭环。

学习目标

  • 理解 Diff 审查在代码智能体中的作用
  • 掌握文件级和代码级变更展示方式
  • 实现修改批次记录与回滚机制

设计可审查的 Diff 流程

代码智能体直接修改项目文件后,如果用户只能看到最终结果,就无法判断修改是否合理。因此需要生成 Diff,将修改前后的差异展示出来,让用户能够审查新增、删除和替换内容。

一个完整的审查流程通常包含修改生成、差异计算、用户确认、状态提交四个阶段。Diff 不只是展示文本变化,还需要关联任务、文件和修改批次,方便后续撤销。

代码修改 Diff 审查与回滚流程图

文件级 Diff 关注哪些文件发生变化,适合快速判断影响范围;代码级 Diff 关注具体行变化,适合定位实现细节。实际智能体通常需要同时提供两层视图。

记录修改批次状态

回滚的核心不是重新生成代码,而是恢复某一次确定的修改状态。因此需要为每次 Agent 修改创建独立批次,保存修改前快照和当前状态。

常见状态包括 pending、reviewing、accepted 和 reverted。只有用户接受后的修改才进入稳定状态,被拒绝的修改则恢复到原始版本。

ts
interface ChangeBatch {
  id: string;
  taskId: string;
  files: string[];
  status: "pending" | "reviewing" | "accepted" | "reverted";
}

function acceptBatch(batch: ChangeBatch) {
  batch.status = "accepted";
}

const batch: ChangeBatch = {
  id: "batch-<ID>",
  taskId: "task-<ID>",
  files: ["src/app.ts"],
  status: "reviewing"
};

acceptBatch(batch);

预期结果

text
batch.status = accepted

状态记录让系统能够知道当前修改是否可撤销,也避免多个任务并发修改时互相覆盖。

实现回滚策略

回滚通常有三种方式:文件快照恢复、Git 提交恢复和操作日志重放。对于桌面代码智能体,Git 分支或临时提交通常更安全,因为它天然保留完整历史。

简单场景可以保存修改前文件内容,在拒绝时覆盖当前文件。生产环境则应结合版本控制系统,确保目录结构、权限和删除文件也能正确恢复。

bash
git add src/app.ts
git commit -m "agent-change-<ID>"

git revert HEAD

预期输出

text
[main <ID>] Revert "agent-change-<ID>"

回滚操作必须保留记录,包括谁触发回滚、回滚原因以及恢复后的状态,方便后续分析智能体行为。

处理局部撤销

整批回滚适合发现整体方向错误的情况,局部撤销适合只拒绝某个文件或某段代码。

实现局部撤销时,需要让 Diff 单元具备独立身份。例如每个文件变化记录 filePath、beforeHash 和 afterHash,用户可以选择恢复指定变化单元。

最终的审查系统应该让用户始终拥有控制权:AI 可以提出修改,但不能绕过确认直接固化危险变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现 Diff 审查与回滚

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通