Honcho Memory

Honcho 是一个 AI 原生的记忆后端，它在 Hermes 内置记忆系统的基础上，增加了辩证推理和深度用户建模功能。与简单的键值存储不同，Honcho 会通过分析对话后的内容，持续构建对用户身份的动态模型——包括用户的偏好、沟通风格、目标和行为模式。

Honcho 是一个记忆提供者插件

Honcho 已集成到 记忆提供者 系统中。以下所有功能均可通过统一的记忆提供者接口使用。

Honcho 所提供的功能

能力	内置记忆	Honcho
跨会话持久化	✔ 基于文件的 MEMORY.md/USER.md	✔ 服务器端存储，通过 API 访问
用户档案	✔ 手动代理维护	✔ 自动辩证推理
多代理隔离	—	✔ 每个对等方独立的档案分离
观察模式	—	✔ 统一或定向观察
结论（衍生洞察）	—	✔ 服务器端对模式的推理分析
历史记录搜索	✔ FTS5 会话搜索	✔ 基于结论的语义搜索

辩证推理：每次对话结束后，Honcho 会分析对话内容并生成“结论”——即关于用户偏好、习惯和目标的洞察。这些结论随时间不断积累，使代理对用户的理解不断深化，超越用户明确表达的内容。

多代理档案：当多个 Hermes 实例与同一用户交互时（例如，一个编程助手和一个个人助手），Honcho 会为每个对等方维护独立的“同伴”档案。每个对等方仅能访问自己的观察结果和结论，防止上下文相互污染。

设置

hermes memory setup    # select "honcho" from the provider list

或手动配置：

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

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

在 honcho.dev 获取 API 密钥。

配置选项

# ~/.hermes/config.yaml
honcho:
  observation: directional    # "unified" (default for new installs) or "directional"
  peer_name: ""               # auto-detected from platform, or set manually

观察模式：

• unified — 所有观察结果进入单一池。更简单，适合单代理设置。
• directional — 观察结果标记方向（用户→代理，代理→用户）。支持对对话动态的更丰富分析。

工具

当 Honcho 作为记忆提供者激活时，将提供四个额外工具：

工具	目的
honcho_conclude	触发服务器端对近期对话的辩证推理
honcho_context	从 Honcho 的记忆中检索当前对话的相关上下文
honcho_profile	查看或更新用户的 Honcho 档案
honcho_search	在所有存储的结论和观察中进行语义搜索

CLI 命令

hermes honcho status          # Show connection status and config
hermes honcho peer            # Update peer names for multi-agent setups

从 hermes honcho 迁移

如果您之前使用过独立的 hermes honcho setup：

1. 您现有的配置文件（honcho.json 或 ~/.honcho/config.json）将被保留
2. 您的服务器端数据（记忆、结论、用户档案）保持完整
3. 在 config.yaml 中设置 memory.provider: honcho 以重新激活

无需重新登录或重新配置。运行 hermes memory setup 并选择 "honcho" —— 向导会检测到您现有的配置。

完整文档

参见 记忆提供者 — Honcho 以获取完整参考。