AI Agent / 系统课时

支持撤销与回滚

支持撤销与回滚

本篇解决智能体修改失败或用户拒绝变更后的恢复问题,通过记录修改批次和原始状态,让代码修改引擎能够安全撤销操作并恢复工作区。

学习目标

  • 理解代码修改为什么需要可恢复机制
  • 掌握修改批次和快照的基本设计方式
  • 能实现失败场景下的安全回滚流程

为什么代码修改需要回滚

代码智能体的修改不是一次性的文本替换,而是可能涉及多个文件、多个步骤和多个工具调用。当其中一步失败,或者用户审核后拒绝结果时,系统必须能够恢复到修改前状态。

回滚的核心不是简单删除新代码,而是恢复一个已经确认可用的历史状态。因此需要在执行修改前记录足够的信息。

修改批次模型设计

一个修改批次表示一次完整的智能体操作。批次通常包含任务编号、修改文件列表、原始版本信息和执行状态。

代码修改批次状态流转图

示例批次结构:

json
{
  "batchId": "batch-<ID>",
  "status": "applied",
  "files": ["src/app.js"],
  "snapshot": "snapshot-<ID>"
}

预期结果

text
系统创建一个修改批次,并关联修改文件和恢复所需快照。

保存快照与执行恢复

回滚通常依赖快照机制。快照可以是文件副本、版本控制提交点,或者存储系统中的对象版本。

执行流程一般如下:

  1. 创建修改批次。
  2. 保存当前工作区状态。
  3. 执行智能体修改。
  4. 根据审核结果决定提交或恢复。

在工程实现中,可以利用 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 或状态检查验证恢复结果。

下一课预告

下一课将继续完善代码修改引擎,学习如何将修改验证、审核和执行流程组合成完整闭环。

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

目录与阅读设置

阅读设置

17

记录一个想法

支持撤销与回滚

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

登录哪都通