Honcho 内存系统

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 获取完整参考手册。