Honcho 记忆

Honcho 是一个 AI 原生记忆后端，在 Hermes 内置记忆系统之上增加了辩证推理和深度用户建模。不是简单的键值存储，Honcho 通过在对话发生后进行推理来维护一个关于用户是谁的持续模型——他们的偏好、沟通风格、目标和模式。

Honcho 是一个记忆提供商插件

Honcho 集成到记忆提供商系统中。以下所有功能都可以通过统一的记忆提供商接口访问。

Honcho 增加的功能

能力	内置记忆	Honcho
跨会话持久化	✔ 基于文件的 MEMORY.md/USER.md	✔ 带 API 的服务器端
用户画像	✔ 手动代理整理	✔ 自动辩证推理
多代理隔离	—	✔ 每次对等体配置分离
观察模式	—	✔ 统一或方向性观察
结论（派生洞察）	—	✔ 服务器端推理模式
历史搜索	✔ FTS5 会话搜索	✔ 对结论的语义搜索

辩证推理：每次对话后，Honcho 分析交流并得出"结论"——关于用户偏好、习惯和目标的洞察。这些结论随时间累积，使代理能够获得超越用户明确表述的深化理解。

多代理画像：当多个 Hermes 实例与同一用户对话时（例如，一个编码助手和一个个人助手），Honcho 维护独立的"对等体"画像。每个对等体只看到自己的观察和结论，防止上下文交叉污染。

设置

hermes memory setup    # 从提供商列表中选择 "honcho"

或手动配置：

# ~/.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 — 所有观察进入单个池。更简单，适合单代理设置。
• directional — 观察带有方向标记（user→agent、agent→user）。支持更丰富的对话动态分析。

工具

当 Honcho 作为记忆提供商激活时，四个额外的工具变得可用：

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

CLI 命令

hermes honcho status          # 显示连接状态和配置
hermes honcho peer            # 为多代理设置更新对等体名称

从 hermes honcho 迁移

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

1. 你的现有配置（honcho.json 或 ~/.honcho/config.json）被保留
2. 你的服务器端数据（记忆、结论、用户画像）完好无损
3. 在 config.yaml 中设置 memory.provider: honcho 以重新激活

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

完整文档

请参阅记忆提供商——Honcho获取完整参考。