前言¶
在 DSH 这类「一切皆插件」的智能体工作流里,对话记忆常有两个痛点:一是模型可见内容里混入思考链、工具噪声和系统注入;二是多个 DSH 对话、多个助手视角之间缺少稳定的 session 与 peer 边界。
下面介绍 dsh-honcho-memory。它针对这两个问题,提供 Honcho v3 记忆适配和共享知识库能力。
这是什么¶
dsh-honcho-memory 是 kingcharleslzy-ai 维护的 DSH 插件,许可证为 MIT。它的定位是 DeepSeek Harness(DSH)的 Honcho v3 记忆适配器与共享知识库插件。
需要先说清边界:这个 npm 包不是 Honcho 后端,也不会替你安装 Honcho。使用前必须有 DSH 能访问的 Honcho v3 服务。只有安装 DSH 插件、没有 Honcho API/数据库/后台 deriver 时,记忆不会工作。
核心功能¶
下面列出已核实能力:
- 自动保存真实用户消息和模型可见回答,并过滤思考链、工具噪声和系统注入。
- 每个 DSH 对话默认映射到独立 Honcho session。
- 每轮召回 session summary、用户模型、peer card、本地结论和共享知识。
- 提供七个 DSH 工具:
memory_store
memory_search
memory_context
memory_reason
memory_profile
memory_dream
memory_status
- 保留方向性视角,例如
deepseek -> user,不把不同助手伪装成同一个 peer。 - 使用
shared-knowledge -> user/shared-knowledge作为可选的 canonical 共享层。 - 相似结论只在读取时去重;整理工具默认 dry-run,不会静默删除后端数据。
- 使用 Honcho 官方 v3 HTTP API,目标 Node.js 20 或更高版本。
- 安装包内置零运行时依赖的
dsh-honcho-memory-core,不需要再单独安装 core。
先准备 Honcho¶
下面是两种前置方案,二选一。
方案 A:使用 Honcho 官方托管服务¶
使用官方托管服务时,把插件配置指向官方 API:
baseUrl: https://api.honcho.dev
apiKey: YOUR_HONCHO_API_KEY
方案 B:自托管官方 Honcho¶
按 Plastic Labs 官方仓库的 Docker 方式部署官方 Honcho。部署后做健康检查,结果应返回:
{"status":"ok"}
如果 Honcho 在另一台机器上,应确保 DSH 进程能访问该地址,并使用 HTTPS、VPN 或 SSH 隧道保护网络链路;不要把未鉴权的 Honcho 端口直接暴露到公网。
安装与启用¶
安装命令示例如下:
dsh plugin --profile web add dsh-honcho-memory
这里使用 --profile web 是资料给出的示例;其他 DSH profile 是否适用,需要结合你的 profile 配置判断。
安装后,在对应 DSH profile 的 cordis.patch.yml 中覆盖配置。至少应确认 baseUrl、workspace、userPeer、aiPeer 指向你实际使用的 Honcho 服务和 peer 约定。
启用后检查¶
重启 DSH 后,调用:
memory_status({"check":"health"})
然后确认以下几项:
1、Honcho API 可用;
2、workspace、userPeer、aiPeer 与你的配置一致;
3、queue 从 pending/in-progress 进入 completed;
4、新对话能够用 memory_store 写入,并被 memory_search 找回。
工具使用注意¶
七个工具中,memory_status 用于状态检查;memory_store 和 memory_search 用于写入与读取验证。
memory_dream 可能消耗后端 LLM 资源,必须明确:
confirm=true
数据与隐私¶
- 插件会把启用范围内的 DSH 对话发送到你配置的
baseUrl。 - 插件本身不包含维护者账号、服务器地址或用户身份默认值,也不提供遥测服务。
- Honcho 后端可能把内容发送给其配置的 embedding、summary、deriver 或 dialectic 模型提供商;隐私边界取决于你自己的 Honcho 部署和模型配置。
- 插件会在当前 DSH 进程中运行,因此安装前应检查源码和 MIT 许可证,并确认你愿意将对话发送到所选 Honcho 服务。
升级与兼容¶
- 目标 API 为 Honcho v3。
- Node.js 要求 20 或更高版本。
- 0.5.2 起默认值不包含维护者身份或机器配置。
- 从 0.5.1 或更早版本升级前,需确认旧数据实际所在位置,并把
baseUrl、workspace、userPeer写进自己的cordis.patch.yml。 - 0.5.2 不会迁移、重命名或删除已有 Honcho 数据;只有继续使用相同 backend、workspace 和 peer ID,才会召回原有记忆。
- 本插件不是 Plastic Labs 官方发布的 DSH 集成;Codex、Hermes 等其他客户端的安装与配置也不由本插件完成。
开发与验证¶
开发验证可按下面命令执行:
npm install
npm test
npm run audit:public
npm run smoke
npm run smoke:dsh
npm run tidy:messages
其中 tidy:messages 与整理工具保持一致,默认 dry-run,不会静默删除后端数据。
适用场景与注意¶
适合已经在 DSH 中使用 Honcho v3,或准备自托管 Honcho 的开发者。它适合需要把 DSH 对话接入独立记忆后端,同时保留 peer 视角与共享知识层的使用者。
注意:
- 插件以当前 DSH 进程权限运行,并会把启用范围内的对话发送到配置的
baseUrl。 - 安装前应检查源码和许可证。
- 如果只安装插件而没有完整 Honcho v3 服务,记忆不会工作。
结尾¶
dsh-honcho-memory 的价值在于把 DSH 的消息、session、peer 视角和共享知识接入 Honcho v3,同时把后端部署、隐私边界和升级数据位置留给使用者自己确认。
GitHub:
https://github.com/kingcharleslzy-ai/dsh-honcho-memory
社区目录页地址未在本次已核实资料中给出;DSH 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,可在目录中搜索 dsh-honcho-memory。