dsh-honcho-memory
DeepSeek Harness（DSH）的 Honcho v3 记忆适配器与共享知识库插件。
> [!IMPORTANT] > 这个 npm 包不是 Honcho 后端，也不会替你安装 Honcho。使用前必须已有一个 > DSH 能访问的 Honcho v3 服务：使用 Honcho 官方托管服务，或自行部署官方开源 > Honcho。只有安装 DSH 插件、没有 Honcho API/数据库/后台 deriver，记忆不会工作。
更准确地说，不是把 Honcho 安装进 DSH 的 node_modules；Honcho 是独立运行的 后端服务，DSH 通过本插件访问它。使用官方托管服务时无需在本机部署；选择自托管时， 则需另外部署 Plastic Labs 官方 Honcho 服务栈。
它负责什么
DSH ── dsh-honcho-memory ── Honcho v3 API
│
├─ workspace / peers / sessions / messages
├─ conclusions / representations / peer cards
├─ context / search / dialectic
└─ queue / dream- 自动保存真实用户消息和模型可见回答；过滤思考链、工具噪声和系统注入。
- 每个 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，但不是 Plastic Labs 官方发布的 DSH 集成。 Codex、Hermes 等其他客户端的安装与配置也不由本插件完成。
前置条件：先准备 Honcho
二选一。
方案 A：Honcho 官方托管服务
在 Honcho 创建 API key，然后配置：
baseUrl: https://api.honcho.dev
apiKey: YOUR_HONCHO_API_KEY方案 B：自托管官方 Honcho
按 Plastic Labs 官方仓库 的 Docker 方式部署。以下只是官方流程的摘要，实际变量以 Honcho 当前文档为准：
git clone https://github.com/plastic-labs/honcho.git
cd honcho
cp docker-compose.yml.example docker-compose.yml
cp .env.template .env
# 编辑 .env，配置 Honcho 所需的模型/API key
docker compose up -d --build
curl http://127.0.0.1:8000/health健康检查应返回 {"status":"ok"}。完整服务不仅包含 API，还需要数据库、Redis 和 deriver；deriver 负责异步生成 conclusions、summary、representation、peer card 以及 dream 结果。仅有一个返回 200 的空代理并不等于完整可用。
如果 Honcho 在另一台机器上，请确保 DSH 进程能访问该地址，并使用 HTTPS、VPN 或 SSH 隧道保护网络链路。不要把未鉴权的 Honcho 端口直接暴露到公网。
安装 DSH 插件
dsh plugin --profile web add dsh-honcho-memory然后在对应 DSH profile 的 cordis.patch.yml 中覆盖配置。示例：
- id: honcho-memory
name: dsh-honcho-memory
config:
baseUrl: http://127.0.0.1:8000
apiKey: ''
workspace: dsh
userPeer: user
aiPeer: deepseek
sessionId: ''
sessionPrefix: dsh
autoCapture: true
captureSubagents: false
autoContext: true
contextMaxChars: 4000
contextTokens: 1600
contextFetchTimeoutMs: 8000
searchScope: workspace
includeConclusions: true
maxConclusions: 10
dialecticReasoningLevel: low
messageMaxChars: 24000重启 DSH 后，在对话中调用 memory_status({"check":"health"})。check 是必填字段， 用于保证 DSH Code Mode 始终传递 JSON 参数对象。至少确认：
Honcho API：可用；- workspace、userPeer、aiPeer 与你的配置一致；
- queue 最终从 pending/in-progress 进入 completed；
- 新对话能够用
memory_store写入并被memory_search找回。
默认值
0.5.2 起默认值不包含维护者身份或机器配置：
| 配置 | 默认值 |
|---|---|
baseUrl | http://127.0.0.1:8000 |
workspace | dsh |
userPeer | user |
aiPeer | deepseek |
knowledgePeer | shared-knowledge |
knowledgeSessionId | shared-knowledge |
从 0.5.1 或更早版本升级
旧版本曾错误地携带维护者环境的非通用默认值。如果你以前没有在 profile 中显式写 baseUrl、workspace 和 userPeer，升级前必须先确认旧数据实际所在的位置，并把这 三个值写进自己的 cordis.patch.yml。0.5.2 不会迁移、重命名或删除已有 Honcho 数据； 只有继续使用相同 backend、workspace 和 peer ID，才会召回原有记忆。
如果你已有其他 Honcho 集成，可以让它们指向同一 backend/workspace，但每个助手应使用 不同的 aiPeer。跨客户端共享不会自动配置；其他客户端也必须自行安装各自的 Honcho 集成，并遵守相同的 canonical peer 约定。
数据与隐私
- 插件会把启用范围内的 DSH 对话发送到你配置的
baseUrl。 - 插件本身不包含维护者账号、服务器地址或用户身份默认值，也不提供遥测服务。
- Honcho 后端可能把内容发送给其配置的 embedding、summary、deriver 或 dialectic
模型提供商；隐私边界取决于你自己的 Honcho 部署和模型配置。
memory_dream可能消耗后端 LLM 资源，必须明确confirm=true。
兼容性边界
- 目标 API：Honcho v3。
- Node.js：20 或更高版本。
- 安装包内置零运行时依赖的
dsh-honcho-memory-core，不需要再单独安装 core。 - 已验证官方 Honcho 的 message、deriver、conclusion、context、search、dialectic 和
queue 流程；不同 Honcho/DSH 版本组合仍应先做 memory_status 和小规模写入测试。
- 没有任何插件能保证对未来所有 DSH 或 Honcho 版本“完美兼容”；本项目通过契约测试
和真实后端 smoke test 降低升级风险。
开发与验证
npm install
npm test
npm run audit:public
npm run smoke # 需要可用的 Honcho；可用 HONCHO_* 环境变量覆盖配置
npm run smoke:dsh # 通过 DSH adapter 做临时写入/读取并清理
npm run tidy:messages # 只生成旧垃圾消息的备份与 dry-run 清单；不会自动删除更多资料：
- [架构与数据模型](docs/architecture.md)
- [运行、健康检查与回滚](docs/operations.md)
- Honcho 官方仓库
- Honcho 官方 MCP
License
MIT