AI Agent / 系统课时
支持撤销与回滚
支持撤销与回滚
本篇解决智能体修改失败或用户拒绝变更后的恢复问题,通过记录修改批次和原始状态,让代码修改引擎能够安全撤销操作并恢复工作区。
学习目标
- 理解代码修改为什么需要可恢复机制
- 掌握修改批次和快照的基本设计方式
- 能实现失败场景下的安全回滚流程
为什么代码修改需要回滚
代码智能体的修改不是一次性的文本替换,而是可能涉及多个文件、多个步骤和多个工具调用。当其中一步失败,或者用户审核后拒绝结果时,系统必须能够恢复到修改前状态。
回滚的核心不是简单删除新代码,而是恢复一个已经确认可用的历史状态。因此需要在执行修改前记录足够的信息。
修改批次模型设计
一个修改批次表示一次完整的智能体操作。批次通常包含任务编号、修改文件列表、原始版本信息和执行状态。

示例批次结构:
json
{
"batchId": "batch-<ID>",
"status": "applied",
"files": ["src/app.js"],
"snapshot": "snapshot-<ID>"
}预期结果
text
系统创建一个修改批次,并关联修改文件和恢复所需快照。保存快照与执行恢复
回滚通常依赖快照机制。快照可以是文件副本、版本控制提交点,或者存储系统中的对象版本。
执行流程一般如下:
- 创建修改批次。
- 保存当前工作区状态。
- 执行智能体修改。
- 根据审核结果决定提交或恢复。
在工程实现中,可以利用 Git 提交点保存修改前状态:
bash
git add .
git commit -m "snapshot before agent change"
git reset --hard HEAD~1预期输出
text
HEAD is now at <ID> restore previous workspace state实际使用时,<ID> 会由 Git 根据仓库历史生成,不同环境中的值可能不同。
处理失败与拒绝场景
回滚需要区分不同失败类型。执行异常可能来自工具调用失败、代码生成错误或测试不通过;用户拒绝则属于正常业务流程。
两者都需要恢复工作区,但日志记录方式不同:
| 场景 | 操作 |
|---|---|
| 工具执行失败 | 标记异常并恢复 |
| 测试失败 | 保留失败信息后恢复 |
| 用户拒绝 | 取消批次并恢复 |
| 审核通过 | 固化修改结果 |
验证回滚结果
回滚完成后不能只依赖执行成功消息,还需要验证工作区是否恢复。
可以检查文件哈希或重新生成 Diff:
bash
git diff --exit-code预期输出
text
无输出,表示当前工作区与提交状态一致。如果仍存在差异,需要继续检查是否有未纳入快照的文件变化。
常见错误
只保存修改后的结果而没有保存修改前状态,会导致失败后无法恢复。另一个常见问题是回滚范围过大,例如一次任务修改多个文件,却错误恢复整个项目。
可靠的回滚系统需要让修改批次、快照和 Diff 三者保持关联。
本课总结
- 回滚机制通过保存修改前状态保证智能体修改可恢复。
- 修改批次是管理执行、审核和恢复流程的核心对象。
- 回滚完成后需要通过 Diff 或状态检查验证恢复结果。
下一课预告
下一课将继续完善代码修改引擎,学习如何将修改验证、审核和执行流程组合成完整闭环。
按自己的节奏,确认真正理解。