dsh-mem0-plugins

dsh-mem0-plugins

English | 简体中文

为 DeepSeek Harness (dsh) web profile 提供持久记忆，后端为自托管 Mem0 server。插件让智能体零手工获得长期记忆： 回答前自动召回相关记忆，每轮对话结束后自动把内容提炼成事实写回服务端。

[!IMPORTANT] 兼容性——请先阅读。 本插件对接的是 runfali/mem0-graph 项目的自定义 HTTP API（X-API-Key 鉴权、POST /search、 POST/PUT/DELETE /memories、POST /evolve/feedback），仅适用于 从该项目部署的 server。不支持 Mem0 Cloud，也不兼容 mem0 官方 OSS REST/SDK API，不能直接用于其他 Mem0 部署。

以标准 dsh bundle 插件交付：dsh plugin add 安装、dsh plugin remove 卸载，不改任何 dsh 源码。

---

目录

• 自动行为
• 模型工具
• 环境要求
• 安装
• 配置
  • 连接与身份
  • 自动召回与查询蒸馏
  • 自动写入（潮浪并忆）
  • 可靠性与超时
• 召回设计
• 可靠性设计
• 可观测性
• 开发与测试
• 排障
• 文档
• 许可证

自动行为

被打断的轮次永不写入：半截流式回复不是持久的对话真相。

模型工具

注册四个模型工具：

环境要求

• Node.js ≥ 22 与可用的 DeepSeek Harness 安装（web profile）。 已针对 dsh 0.1.5-rc.1 实测；声明区间为 >=0.1.2-alpha.3 <0.2.0 || >=0.1.5-alpha.1 <0.1.6（析取不是冗余——按 npm 预发布规则，单区间 >=0.1.2-alpha.3 <0.2.0 不覆盖 0.1.5-rc.1）。
• 一台从 runfali/mem0-graph 部署并可通过 HTTP 访问的 server（如 http://127.0.0.1:8888）。
• 服务端开启鉴权时需在其 Dashboard 创建 API Key；AUTH_DISABLED=true 部署留空即可。

安装

# 安装到 web profile（安装后重启 dsh 生效）
dsh plugin --profile web add /path/to/dsh-mem0-plugins

# 卸载
dsh plugin --profile web remove dsh-mem0-plugins

插件默认启用：指向本机 AUTH_DISABLED server 时零配置可用。 设置页改动即时生效，无需重启。要彻底关闭记忆，在设置卡片里关掉 「启用插件」开关即可；卡片头部实时显示启用状态与 host。

配置

所有设置位于 dsh 设置页 mem0 命名空间下，设置页保存的用户值优先于 profile 层默认值。

连接与身份

自动召回与查询蒸馏

自动写入（潮浪并忆）

可靠性与超时

修改 profile 层默认值（对本机全部用户生效），在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- id: mem0
  config:
    enabled: true
    host: http://mem0.internal:8888
    apiKey: your-admin-api-key

召回设计

• 显式工具链路。 不做后台静默预取——dsh 平台在消息回显后没有内容注入钩子 （平台时序分析见 docs/COMPARISON.md）。模型按 usage 引导调用 mem0_search，工具卡让召回过程可见；蒸馏、双飞、熔断全套在 工具内部生效。
• 强制召回步（默认开）。 每轮第一步注入 plugin-source 提醒 （「必须先调 mem0_search 再回答」），UI 中渲染为折叠的上下文注入行。 它不写记忆、琐碎轮跳过、forceRecallStep 可关。
• 琐碎输入守卫（src/guards.js）。纯问候 / 确认 / 斜杠命令按词表三分类，只做整串匹配——正常句子永不误伤。同一词表还支撑 usage 节与 mem0_search 描述中的显式豁免条款：整串仅为应答/推进短消息 （好的、嗯、收到、继续、ok…）时明确跳过搜索；携带任何实义内容即恢复强制。
• 查询蒸馏。 移植自 hermes agent/memory_manager.py::_distill_query，只作用于召回查询， 从不触碰写入路径：
  1. 查询 ≤ distillMinChars：原样直查；
  2. 超长查询（贴日志/代码）：截断到 distillInputMaxChars，由小模型提炼成 2–4 个关键词的检索意图再去检索；
  3. 语言漂移防护：中文输入的蒸馏结果若出现越南语重音字符或其他非拉丁非 CJK 文字（实测的小模型路由漂移症状），判为污染即拒绝；
  4. 并发双飞：首请求无响应即并发第二请求，先完成者胜出；
  5. 全部失败：回退原始 query——检索永不静默失效。

可靠性设计

• 熔断器：连续失败达 breakerThreshold 次暂停所有 mem0 流量， breakerCooldownMs 冷却后半开恢复。404 / not found 类客户端错误不计入熔断。
• 连接级重试：连接拒绝/DNS 类失败自动重试一次——此时请求大概率没到达 服务端，不会造成重复写入。
• 有界队列：待写队列上限 queueMaxLen（满则丢最旧），服务端长时间不可用 也不会内存膨胀。
• 兜底冲刷：插件停止时冲刷全部未落库的合并桶——排队中的记忆绝不丢失。

可观测性

潮浪并忆与写路径卫生计数落在 dsh 宿主进程日志（不打到浏览器）： 插件同时走 ctx.logger（内部日志）与 console.log/warn（直出宿主 stdout）。 systemd 部署看 journalctl -u dsh.service -f；否则看 dsh 进程 stdout。

每次合并冲刷打一条 info 日志，含累计 totals：

[dsh-mem0] mem0 coalesced 3 turn(s) into 1 write (session=<id>, saved 2 call(s), chars=512, trigger=idle; totals: batches=12 savedCalls=34 dropped=0 jsonSanitized=3 redacted=0)

队列丢弃打 warn；JSON 剥除与快速直写为 debug 级；熔断开合与直写失败必打 warn；脱敏命中按会话+标签去重后打 warn：

[dsh-mem0] mem0 upload redacted 1 secret label(s) [openai-key] before infer (session=<id>)

开发与测试

git clone <本仓库> && cd dsh-mem0-plugins
npm install                # 或 symlink 本机 dsh node_modules 以离线开发
node --test test/*.test.mjs # 宿主入口（真实 import + engines 守护）+ 纯函数单测
node test/smoke.mjs        # Host 半：apply 链路 + 工具 + 写入路径 + 守卫
node test/client-smoke.mjs # Client 半：bundle 加载 + locale/slot + 设置表单保存真链
npm test                   # 一把跑完以上全部

排障

文档

• docs/COMPARISON.md —— 与 hermes 原版的设计对比， 含塑造「工具驱动召回」形态的平台时序约束分析（中文）。

许可证

MIT © 2026 dsh-mem0 contributors