检查点与回退

检查点用于撤销会话中的一组修改。默认在每轮运行开始时创建检查点，在文件修改前保存受影响文件的原始内容；它不对整个项目做全量备份。

在 TUI 中回退

等待当前运行结束，或按 Esc 请求停止并等待停止完成。
输入 /rewind，从列表中选择需要回到的轮次。
查看回退结果，检查工作区文件及保留的对话。

恢复会截断目标位置之后的历史，并按已捕获的文件内容和冲突保护规则恢复文件。回退后，目标之后的首条用户消息会重新填入输入框，方便修改后再次发送。

正在运行的会话不能回退。其他会话写入过的路径受到保护；有冲突时，文件恢复可能受限或跳过。不要只凭对话已经回退就认定全部文件恢复成功。

自动检查点配置

在有效的 config.json 中设置：

json

{
  "session": {
    "checkpoint_auto_before_run": true
  }
}

默认值为 true；设为 false 后不再自动创建每轮检查点。配置路径见数据目录。

26.9.11 的命令行没有手动创建、列出或恢复检查点的子命令；使用 TUI 的 /rewind。不要照旧版文档使用 sessions checkpoint 或其恢复参数。

恢复范围

只恢复已捕获且允许恢复的文件修改，不保证撤销任意 Shell 命令、外部系统操作或未跟踪文件。
历史截断与文件恢复是不同动作，发生冲突时应分别检查结果。
检查点不代替 Git 分支或项目备份，重要操作前仍应保留可恢复副本。

查看改动使用 Changes 与 Review；只需保存对话时使用会话导出。