AI Agent / 系统课时
实现 Diff 审查与回滚
实现 Diff 审查与回滚
本课实现代码智能体修改后的审查与恢复能力,让用户能够理解 AI 做了什么变化,并在发现问题时安全撤销修改,形成可控的代码变更闭环。
学习目标
- 理解 Diff 审查在代码智能体中的作用
- 掌握文件级和代码级变更展示方式
- 实现修改批次记录与回滚机制
设计可审查的 Diff 流程
代码智能体直接修改项目文件后,如果用户只能看到最终结果,就无法判断修改是否合理。因此需要生成 Diff,将修改前后的差异展示出来,让用户能够审查新增、删除和替换内容。
一个完整的审查流程通常包含修改生成、差异计算、用户确认、状态提交四个阶段。Diff 不只是展示文本变化,还需要关联任务、文件和修改批次,方便后续撤销。

文件级 Diff 关注哪些文件发生变化,适合快速判断影响范围;代码级 Diff 关注具体行变化,适合定位实现细节。实际智能体通常需要同时提供两层视图。
记录修改批次状态
回滚的核心不是重新生成代码,而是恢复某一次确定的修改状态。因此需要为每次 Agent 修改创建独立批次,保存修改前快照和当前状态。
常见状态包括 pending、reviewing、accepted 和 reverted。只有用户接受后的修改才进入稳定状态,被拒绝的修改则恢复到原始版本。
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);预期结果
batch.status = accepted状态记录让系统能够知道当前修改是否可撤销,也避免多个任务并发修改时互相覆盖。
实现回滚策略
回滚通常有三种方式:文件快照恢复、Git 提交恢复和操作日志重放。对于桌面代码智能体,Git 分支或临时提交通常更安全,因为它天然保留完整历史。
简单场景可以保存修改前文件内容,在拒绝时覆盖当前文件。生产环境则应结合版本控制系统,确保目录结构、权限和删除文件也能正确恢复。
git add src/app.ts
git commit -m "agent-change-<ID>"
git revert HEAD预期输出
[main <ID>] Revert "agent-change-<ID>"回滚操作必须保留记录,包括谁触发回滚、回滚原因以及恢复后的状态,方便后续分析智能体行为。
处理局部撤销
整批回滚适合发现整体方向错误的情况,局部撤销适合只拒绝某个文件或某段代码。
实现局部撤销时,需要让 Diff 单元具备独立身份。例如每个文件变化记录 filePath、beforeHash 和 afterHash,用户可以选择恢复指定变化单元。
最终的审查系统应该让用户始终拥有控制权:AI 可以提出修改,但不能绕过确认直接固化危险变化。