跳到主要内容

Rewind 与 Checkpoint

Rewind / Checkpoint 让你在智能体走错方向时回到之前的稳定状态。它不只是删除几条聊天消息，还可以恢复当时的文件、媒体、AgentFS、记忆和技能状态。

什么时候用​

  • 智能体误解需求，后续执行都偏了
  • 一次大改动影响了文件或文档状态
  • 想比较两个方案，但保留旧分支
  • 需要撤回刚才的自动学习或技能变更

入口​

你可以通过以下方式打开回撤：

  • 在输入框输入 /rewind
  • 在消息操作栏选择 Rewind
  • 在聊天头部「更多」菜单中选择回撤
  • 使用快捷键 Cmd + Alt + Z（macOS）或 Ctrl + Alt + Z（Windows/Linux）

回撤模式​

模式作用
仅对话回到某条用户消息前的对话状态
仅状态恢复文件、媒体、AgentFS、记忆或技能状态
对话 + 状态同时恢复对话和工作状态

执行前会显示影响范围预览。确认后，DesireCore 会从目标检查点创建新的运行分支，旧分支仍保留在历史中。

自动检查点​

DesireCore 会在关键操作前后自动建立检查点，例如：

  • 用户发送新任务
  • 智能体开始修改文件
  • 写入记忆或技能
  • 生成媒体或导出文档

你不需要手动创建检查点。

限制​

Rewind 主要恢复 DesireCore 管理的本地状态。以下外部副作用通常不会被撤销：

  • 已发送的邮件或已调用的外部 API
  • 已推送到远程仓库的变更
  • 通过命令行在 DesireCore 管理范围外手动修改的文件
  • 第三方服务内部已经完成的交易或审批

如果回撤涉及外部副作用，建议查看审计记录后再决定下一步处理方式。

分支机制​

Rewind 不是"删除"历史，而是从检查点创建新的运行分支：

Rewind 分支机制示意图

  • 旧分支保留：回撤前的所有消息和操作记录仍然存在于历史中，不会被删除
  • 新分支创建：确认后，系统从目标检查点开始一条新的运行路径
  • 多次 Rewind：你可以多次执行 Rewind，每次都会产生新的分支，形成类似 Git 的分支结构
时间线：
  消息1 → 消息2 → 消息3 → 消息4（原始路径）
                  ↘
                   消息3' → 消息4'（第一次 Rewind 后的新路径）
                  ↘
                   消息3'' → ...（第二次 Rewind）
安全网

因为旧分支始终保留，Rewind 是一个低风险操作。即使回撤后新路径也不理想，你可以再次 Rewind 回到更早的检查点，或者查看旧分支中的内容作为参考。