第30篇：检查点与回滚——AI 的后悔药

第30篇：检查点与回滚——AI 的后悔药

你有没有过这种经历：AI 助手一顿操作猛如虎，结果把你的代码改得面目全非，你想反悔却找不到“撤销”按钮？Hermes 的**检查点（Checkpoint）**功能就是为你准备的后悔药——它会在危险操作前自动给你的项目拍一张“快照”，随时可以一键还原。

---

第1步：开启检查点（默认关闭）

检查点功能默认是关的，因为快照会占用磁盘空间。你可以按需开启：

# 只在本次会话开启
hermes chat --checkpoints

或者写入全局配置 ~/.hermes/config.yaml，永久开启：

checkpoints:
  enabled: true

第2步：了解什么会触发快照

Hermes 会在两类操作前自动拍快照：

• 文件工具：write_file、patch 等修改文件的动作
• 危险终端命令：rm、mv、sed -i、> 重定向、git reset 等

注意：每个目录每轮对话最多只拍一次快照，不会刷屏。

第3步：使用 /rollback 命令后悔

在会话中，你可以用斜杠命令操作：

命令	作用
/rollback	列出所有快照及变更统计
/rollback 3	恢复到第3个快照（同时撤销上一轮对话）
/rollback diff 3	先预览第3个快照和当前状态的差异
/rollback 3 src/app.js	只恢复单个文件

第4步：用 CLI 管理快照仓库

所有快照存在 ~/.hermes/checkpoints/store/ 这个共享仓库里，不会碰你项目的 .git。用命令行管理：

hermes checkpoints          # 查看总大小、项目数
hermes checkpoints prune    # 手动清理过期快照
hermes checkpoints clear    # 清空全部快照（有确认提示）

第5步：按需调整配置

在 config.yaml 里可以精细控制：

checkpoints:
  enabled: true
  max_snapshots: 20        # 每个项目最多保留20个快照
  max_total_size_mb: 500   # 仓库总大小上限500MB
  max_file_size_mb: 10     # 大于10MB的文件不拍快照
  auto_prune: true         # 自动清理7天前的旧快照
  retention_days: 7

---

总结：检查点功能就是给 AI 操作加一道保险。开启后，Hermes 会在动手改文件前自动留底，你随时可以用 /rollback 回到任意历史状态。默认关闭是为了省空间，但如果你经常让 AI 改代码，强烈建议开启。

下一篇预告：第31篇将介绍 「Hermes 的日志系统」——如何查看 AI 每一步的思考与操作记录，方便调试和审计。敬请期待！