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" (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。