第10篇：内置插件——开箱即用的增强包

第10篇：內建外掛——開箱即用的增強包

嘿，朋友們！今天咱們來聊一個特別實用的功能——檢查點（Checkpoints）。你可以把它想像成遊戲裡的「存檔」功能：AI 在動手改你程式碼之前，先悄悄拍一張「快照」，萬一改壞了，一條指令就能回到之前的狀態。是不是很安心？

什麼是檢查點？

簡單說，Hermes Agent 會在執行危險操作（比如刪除檔案、覆蓋內容）之前，自動給你的專案拍個快照。這個快照存在一個獨立的影子倉庫裡（~/.hermes/checkpoints/store/），完全不會碰你真實的 .git 歷史，所以放心用。

不過要注意：這個功能預設是關閉的（v2 開始改為「主動開啟」模式），因為長期儲存會佔磁碟空間。想用的話，兩種方式開啟：

臨時開啟（目前工作階段）：

hermes chat --checkpoints

永久開啟（改設定檔 ~/.hermes/config.yaml）：

checkpoints:
  enabled: true

什麼時候會自動存檔？

在兩類操作前會自動觸發：

檔案操作：write_file（寫檔案）、patch（打修補程式）
危險指令：rm、mv、sed -i、> 重新導向、git reset 等

而且每個目錄每輪對話最多存一次，不會瘋狂洗版。

怎麼用？超簡單！

在對話裡直接輸入：

指令	作用
`/rollback`	列出所有存檔點
`/rollback 3`	恢復到第 3 個存檔（保留你手動改的內容）
`/rollback 3 --all`	完全恢復（連你手動改的也覆蓋）
`/rollback diff 3`	預覽第 3 個存檔和現在的差異
`/rollback 3 config.py`	只恢復單一檔案

命令列管理工具

在終端機裡也能管理存檔庫：

hermes checkpoints          # 查看總大小、專案數
hermes checkpoints prune    # 清理過期/孤兒存檔
hermes checkpoints clear    # 清空所有存檔（會先確認）

設定項一覽

checkpoints:
  enabled: false            # 總開關（預設關）
  max_snapshots: 20         # 每個專案最多 20 個存檔
  max_total_size_mb: 500    # 總大小上限 500MB
  max_file_size_mb: 10      # 超過 10MB 的檔案不存檔
  auto_prune: true          # 自動清理（預設開）
  retention_days: 7         # 保留 7 天
  min_interval_hours: 24    # 至少隔 24 小時才清理一次

小撇步

如果 auto_prune 關了，存檔會一直累積，記得手動 hermes checkpoints prune
孤兒存檔（專案資料夾已刪除）不會自動清理，需要手動執行 prune 指令
影子倉庫用的是 git 的「內容定址」儲存，多個專案共享，自動去重，省空間

總結

檢查點功能就像給你的 AI 助手加了個「後悔藥」，特別適合那些喜歡讓 AI 大膽改程式碼、又怕改崩的朋友。雖然預設關閉，但一旦開啟，那種「隨便亂搞，反正能回滾」的底氣，真的很爽！

下期見，咱們繼續挖 Hermes 的寶藏功能！