Honcho Memory

Honcho 是一個 AI 原生的記憶後端，它在 Hermes 內置記憶系統的基礎上，增加了辯證推理和深度用戶建模功能。與簡單的鍵值存儲不同，Honcho 會通過分析對話後的內容，持續構建對用戶身份的動態模型——包括用戶的偏好、溝通風格、目標和行為模式。

Honcho 是一個記憶提供者插件

Honcho 已集成到 記憶提供者 系統中。以下所有功能均可通過統一的記憶提供者接口使用。

Honcho 所提供的功能

能力	內置記憶	Honcho
跨會話持久化	✔ 基於文件的 MEMORY.md/USER.md	✔ 服務器端存儲，通過 API 訪問
用戶檔案	✔ 手動 Agent 維護	✔ 自動辯證推理
多 Agent 隔離	—	✔ 每個對等方獨立的檔案分離
觀察模式	—	✔ 統一或定向觀察
結論（衍生洞察）	—	✔ 服務器端對模式的推理分析
歷史記錄搜索	✔ FTS5 會話搜索	✔ 基於結論的語義搜索

辯證推理：每次對話結束後，Honcho 會分析對話內容並生成“結論”——即關於用戶偏好、習慣和目標的洞察。這些結論隨時間不斷積累，使 Agent 對用戶的理解不斷深化，超越用戶明確表達的內容。

多 Agent 檔案：當多個 Hermes 實例與同一用戶交互時（例如，一個編程助手和一個個人助手），Honcho 會為每個對等方維護獨立的“同伴”檔案。每個對等方僅能訪問自己的觀察結果和結論，防止上下文相互汙染。

設置

hermes memory setup    # 從“1”列表中選擇“0”

或手動配置：

# ~/.hermes/config.yaml
memory:
  provider: honcho

echo "HONCHO_API_KEY=your-key" >> ~/.hermes/.env

在 honcho.dev 獲取 API 密鑰。

配置選項

# ~/.hermes/config.yaml
honcho:
  observation: directional    # "unified"（新安裝的默認值）或"directional"
  peer_name: ""               # 從平臺自動檢測，或手動設置

觀察模式：

• unified — 所有觀察結果進入單一池。更簡單，適合單 Agent 設置。
• directional — 觀察結果標記方向（用戶→Agent，Agent→用戶）。支持對對話動態的更豐富分析。

工具

當 Honcho 作為記憶提供者激活時，將提供四個額外工具：

工具	目的
honcho_conclude	觸發服務器端對近期對話的辯證推理
honcho_context	從 Honcho 的記憶中檢索當前對話的相關上下文
honcho_profile	查看或更新用戶的 Honcho 檔案
honcho_search	在所有存儲的結論和觀察中進行語義搜索

CLI 命令

hermes honcho status          # 顯示連接狀態和配置
hermes honcho peer            # 更新多 agent 設置的對等名稱

從 hermes honcho 遷移

如果您之前使用過獨立的 hermes honcho setup：

1. 您現有的配置文件（honcho.json 或 ~/.honcho/config.json）將被保留
2. 您的服務器端數據（記憶、結論、用戶檔案）保持完整
3. 在 config.yaml 中設置 memory.provider: honcho 以重新激活

無需重新登錄或重新配置。運行 hermes memory setup 並選擇 "honcho" —— 嚮導會檢測到您現有的配置。

完整文檔

參見 記憶提供者 — Honcho 以獲取完整參考。