deepseek-harness 记忆插件 · v0.1

给 agent 一张
统一的记忆图

不再是"每天一个 md 文件"的碎片化笔记。
事实、偏好、日程、任务进度——全部存进同一张实体-时间融合的记忆图

0FC-SH 选择性遗忘·单跳
最佳基线 60.0,已超越 · 全场第一
0FC-MH 选择性遗忘·多跳
基线最佳 7.0 · 7.4 倍
0LME(S*) 精确召回
最佳基线 55.7 · 领先 12.6 分
我们的信念

一个 Agent,一整份记忆——
不拆散,不分割,如人的记忆一般完整连续。

memoplus4dsh 是 deepseek-harness 的统一长期记忆插件。它把 agent 需要记住的一切——事实、偏好、日程、任务进度——存进同一张实体-时间融合的记忆图:没有按日拆散的 md 碎片,没有跨会话的遗忘。一份记忆,伴随 agent 的全部生命。

我们相信,agent 的记忆应该像人的记忆一样:一体、连续、会生长。不是文件系统里越积越多的日记页,不是每次会话结束就归零的暂存——而是一份从第一天写到今天的、完整的记忆。今天的 agent 记得昨天,也记得去年;它知道任务进行到了哪一步,也记得你无意中提起的喜好。当记忆成为一体,agent 才真正开始"认识"你。我们希望 memoplus4dsh 是这条路上的一块基石:简单、开放、可被检验——先把"一份完整的记忆"这一件事做好。

碎片化记忆的代价

大多数 agent 项目的"记忆"是每天生成一个 markdown 文件。它天真、不可检索、无法演进。

✕ 按日 md 碎片
  • "任务做到哪了"散落在七天的文件里
  • 事实被更新后,旧值新值并存打架
  • 没有实体、没有时间语义、没有结构
  • 换个 session,一切归零
✓ 一张记忆图
  • 实体 + 事件 + 双锚时间,结构可查
  • 状态更新:旧值让位,历史留痕
  • 目标 / 待办 / 日程 / 对话同图共存
  • 跨 session 继承,崩溃可恢复

看它工作

一段循环播放的实景演示:对话如何被抽取成图、事实更新如何在时间轴上共存(过去与现在同时保留)、提问时图如何被检索与注入。

对话
抽取 turn/end · 禁 thinking
记忆图 实体 × 事件 × 双锚时间
平时 昨天 现在(提问)
提问 · 检索 · 注入 · 回答

方法创新点

源自 memoplus/ETMS 在 LoCoMo 上验证的核心机制(mem0 协议 82.9%),为 dsh 插件体系重新实现。

🕸

统一记忆图

实体(人/物/概念)+ 事件(谓词·时间·来源)共存的单图结构。不是一堆文件,而是一张可查询、可演进的图。

双锚时间

区分 event_time(事情何时发生)与 mention_time(何时被提及)。"10 月聊到的挫折"能命中 9 月发生的事。

🔄

状态族去重

事实更新后旧值让位新值——检索只呈现最新状态,图里仍保留全部历史。选择性遗忘的架构化解法。

🌉

进度事件桥

goal / todo / schedule / plan 的 dsh 内部事件直接投影进图。长程任务进度跨 session 可回答——补上 dsh 原生空白。

🛡

写入可靠性

持久化抽取队列(崩溃自动补抽)、有界重试 + backoff、大输入分段、抽取显式禁 thinking(实测根治空输出丢记忆)。

🌐

本地多语言嵌入

harrier 0.6B sidecar(1024 维多语言,CPU ~10ms/条)或 onnxruntime-node + distiluse 兜底,中文逐字分词。零新增 API 密钥,全平台。

实现思路

官方 Cordis 插件,零 patch,安装卸载完全可逆。抽取与检索都复用用户已配置的模型。

零 patch官方插件机制,不改 dsh 一行代码
主动工具memory_search 主动查 · memory_remember 显式存 · memory_visualize 可视化 · memory_status 查状态
失败降级嵌入/抽取任何环节失败都只降级不中断对话
数据自主全部记忆在 <dsh-home>/memoplus4dsh/,可删可带走

MemoryAgentBench 评测

官方仓库 + 数据集 + 指标 + judge,1031 题。骨架模型 deepseek-v4-flash(DeepSeek 官方 API)。2026-09-11 全量重跑(r2),全部审计 PASS。

选择性遗忘 · 单跳 FC-SH
本组合
85.0
GPT-4o
60.0
HippoRAG-v2
54.0
Mem0
18.0
四个长度(6k/32k/64k/262k)均值 85.0;逐长度 89 / 78 / 90 / 83 —— 全场第一,超过包括 GPT-4o 全文塞窗口(60.0)在内的全部方案(r1 为 57.75)
选择性遗忘 · 多跳 FC-MH
本组合
51.5
官方最佳 agent
7.0
GPT-4o
5.0
Mem0
2.0
官方全员 ≤7 的"死亡任务";7.4 倍于最佳基线,262k 仍有 54.0。系统提示词引导的迭代 memory_search 把多跳召回从 22% 补到 86%(r1 为 30.25)
精确召回 LME(S*)
本组合
68.33
GPT-4.1-mini
55.7
HippoRAG-v2
50.7
Mem0
36.0
官方 LLM judge;全场第一,领先官方最佳 12.6 分(r1 为 56.67,已超全部基线)

另经真人场景测试:goal 跨 session 进度召回、todo 演进、SIGKILL 崩溃补抽,全部通过 · 173 单测全绿

声明:以上成绩为我们在 MemoryAgentBench 官方代码、数据集与指标下自行评测的结果,未经该 benchmark 团队评测或认证,与其无任何隶属/合作关系。

我们的方法刻意简单:一张实体-时间记忆图 + 混合检索 + 迭代搜索,无训练、无重型 pipeline——适合作为 simple baseline。如果你的方法更复杂,欢迎用同一官方协议与我们对比;评测设置、逐题归因与复现命令均在上方的评测记录中公开。

两分钟装好

bash
# 获取插件
$ git clone https://github.com/eteced/memoplus4dsh.git
$ cd memoplus4dsh

# 安装到 dsh(默认 web profile)
$ scripts/install.sh

# 完全可逆的卸载(记忆数据保留)
$ scripts/uninstall.sh

# 你的记忆在这,可删可带走
~/.dsh/memoplus4dsh/
要求:dsh ≥ 0.1.2-alpha.3(已验证至 0.1.5-alpha.2)· Node ^22.19 || ≥24 · python3
Linux / macOS 一键脚本;Windows 手动两步(README 有说明)
装完跑 node scripts/doctor.mjs 自检;对话里问"记忆系统状态"也行
完整版可选增强:scripts/setup-python.sh(harrier 嵌入 + NER);首次运行按需下载模型(~135MB 起),国内可配 hfBaseUrl 镜像
更新:git pull && npm run build 后重启 dsh;记忆数据独立保留,不受更新影响