第30篇：凭证池——多账号轮流用 | Easy Understand Hermes Agent

第30篇：憑證池——多帳號輪流用

等等，標題不是「憑證池」嗎？怎麼開頭講的是檢查點？別急，這篇其實是雙主題：先講清楚「憑證池」這個老朋友，再帶你認識新來的「檢查點/回滾」功能。兩個都是讓你用得安心、省心的好東西。

憑證池：多帳號輪流用，不再手忙腳亂

你有沒有遇到過這種情況：一個 API 服務有速率限制，一個帳號一天只能調幾百次，但你的任務量遠超這個數。一個個手動換帳號？太累了。

憑證池（Credential Pool） 就是幹這個的。你提前把多個帳號的 API Key 丟進池子裡，Hermes 每次要呼叫服務時，會自動從池子裡輪流取一個來用。這個用完換下一個，循環往復，誰也不會超限。

用起來很簡單，在設定檔裡加一段：

credentials:
  openai:
    - sk-帳號1的key
    - sk-帳號2的key
    - sk-帳號3的key

Hermes 會自己記住「上次用到哪個了」，下次接著往下輪。你完全不用操心。

檢查點：動手前先拍張「快照」

新功能來了——檢查點（Checkpoints）。簡單說，Hermes 在幹「危險操作」之前，會自動給你的專案拍一張快照。萬一改壞了，一條指令就能還原。

注意：這個功能預設是關的，需要你主動開啟。兩種方式：

臨時開啟（只對本次工作階段生效）：

hermes chat --checkpoints

永久開啟（寫進設定檔）：

checkpoints:
  enabled: true

什麼時候會自動拍快照？

Hermes 會在這些操作之前自動儲存：

檔案操作：write_file、patch
危險指令：rm、mv、cp、sed -i、truncate、dd、shred、> 重新導向、git reset / clean / checkout

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

怎麼用？一條 `/rollback` 搞定

在工作階段裡輸入：

/rollback

就能看到所有檢查點清單，像這樣：

📸 Checkpoints for /path/to/project:

  1. 4270a8c  2026-03-16 04:36  before patch  (1 file, +1/-0)
  2. eaf4c1f  2026-03-16 04:35  before write_file
  3. b3f9d2e  2026-03-16 04:34  before terminal: sed -i s/old/new/ config.py

常用指令：

指令	作用
`/rollback <N>`	恢復到第 N 個檢查點，保留你手動改的內容
`/rollback <N> --all`	完全恢復，覆蓋你手動改的內容
`/rollback diff <N>`	預覽第 N 個檢查點和目前狀態的差異
`/rollback <N> <file>`	只恢復某一個檔案

儲存原理：不碰你專案的 .git

檢查點存在一個共用的隱藏儲存庫裡：~/.hermes/checkpoints/store/。你專案的 .git 目錄完全不會被碰。所有專案共用這一個儲存庫，靠 git 的內容定址自動去重，不會佔太多空間。

命令列管理工具

在終端機裡也能管理檢查點：

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 小時

小結

憑證池幫你解決多帳號輪換的麻煩，檢查點給你一個「後悔藥」機制。兩個都是「背景默默幹活、關鍵時刻拉你一把」的類型。建議把檢查點開起來，反正預設設定已經很克制了，不會撐爆磁碟。