AskTheWay/dsh-auto-memory

English | 中文

你的 dsh 智能体把你说过的每件事都忘掉。每一次。每一个会话。

一条命令修复。 把 Claude Code 式持久记忆带给 DeepSeek Harness——原生实现, 零服务器、零 embedding、零配置。

dsh plugin --profile demo add dsh-auto-memory

今天对它说 "记住:我是准备面试的 Python 后端工程师"—— 明天开一个全新会话,问 "你对我有什么了解?",它记得。

---

0.3.0 新增(P2)

• 置顶记忆(memory_write 传 pinned: true):置顶条目排在索引最前、 在预算截断中优先保留、豁免软淘汰——用户可控的信任锚点。
• 评测驱动修复:注入预算语义改为覆盖整段(索引+指导文本);旧实现会 超支 ~800 字节——由新评测层首跑即抓出。
• 确定性评测层(evals/)进 CI:注入预算曲线、淘汰 零误杀、链接展开边界、信噪比 characterization——pinned 优先截断把 半量预算下的探针保留率从 38% 提升到 ≥80%。同样的预算,更对的记忆。

0.2.0 新增(P1)

• 自动固化(autoSummarize: true):根会话结束时,后台 LLM 从会话中提取 值得长期保留的新事实并写入记忆——查重、限量、失败静默。Claude Code 没有全自动。
• 遗忘与淘汰:每条记忆携带生命周期元数据(created/updated/reads); memory_read 累计引用;staleAfterDays 把零引用超龄记忆从注入索引软隐藏 (文件保留);memory_prune 列出(dry-run)或删除高龄记忆。
• 召回展开:memory_read 解析一层 [[name]] 交叉链接并附摘要。
• memory_delete_all——由 tools/pre-execute 人工审批把关: 模型无法自证通过不可逆批量删除。
• 经第二轮对抗审查(11 个智能体)加固:clear 单锁窗口(并发写不逃逸)、 touch 条件重建(消除 O(N) 放大)、会话启动刷新软淘汰、子代理缓冲清理、 固化可中止。

工具:memory_write / memory_read / memory_list / memory_delete / memory_prune / memory_delete_all。

Claude Code 有的东西,dsh 一直没有。现在有了。

DeepSeek Harness 是当下 GitHub 最火的开源智能体框架——模型、工具、沙箱,万物皆插件。 但它根本没有记忆子系统。官方的答案是三份默认关闭的 MCP 外挂配置,而且官方文档 自己承认局限:不自动注入、无遗忘策略、只做子串搜索。你的智能体是设计层面的失忆症。

dsh-auto-memory 用原生实现补上这个缺口:

	MCP 外挂方案	dsh-auto-memory
记忆自动注入每一次系统提示词	✗	✓(无记忆时零 token 占用)
类型化记忆:user / feedback / project / reference	✗	✓
工作区 + 用户双层作用域——跨项目不串扰	✗	✓
崩溃与并发安全(跨进程锁、孤儿锁自愈)	—	✓
需要外部服务 / 数据库 / embedding	✓✓✓	全都不用——纯 Markdown 文件

记忆是 $DSH_HOME/memory/ 下的普通文件——可手改、可 grep、对 git 友好,完全属于你。

一分钟感受它

node scripts/demo.mjs   # 不要 API key、不开浏览器:看 写入 → 索引 → 注入 → 召回 → 遗忘

或者在真实对话里:告诉智能体值得记住的事。模型调用 memory_write / memory_read / memory_list / memory_delete, 遵循 Claude Code 的写入纪律:查重更新而非堆积、只用绝对日期、 [[name]] 交叉链接、feedback 记忆附 Why: / How to apply: 行。

模型实际看到什么

每个请求,一个系统提示词段(order 4000)携带索引——每步重新求值、字节预算控制、 存储为空时整段消失:

# Persistent memory index
## Project memories
- [压测过 PostgreSQL](id-generator-benchmark.md) — psycopg2 连接池有踩坑经验 (2026-09)
- [用户是 Python 后端工程师](user-prefers-python.md) — 正在准备面试; 偏好中文交流

中文标题、YAML frontmatter、一条记忆一个文件——完整的 Claude Code MEMORY.md 模型,在 dsh 的提示词组装管线上原生重建。

首发之前就被锤炼过

这个插件在 v0.1.0 发布前经受了一次 12 个智能体的对抗性代码审查 (68 万 token 的源码级拷问)。五个生产级陷阱被抓出并修复——全部带回归测试—— 其中两个若上线就是事故:

• NTFS 静默毁数据:名为 memory 的记忆会在大小写不敏感文件系统上撞上 MEMORY.md——写入报告成功,实际销毁记录。保留字守卫拦截。
• 毒提示炸弹:任何记忆里三个字面 {{{ }}} 花括号,就能炸掉工作区的 每一个模型请求——且模型无法自救。收敛式消毒器中和。

还有:孤儿锁自愈(Ctrl+C 砸不坏你的记忆库)、symlink 读取防护、坏文件容错、 稳定的索引排序(保住 KV 前缀缓存)、严格不写自定义会话事件(那会让 dsh 会话 拒绝 resume)。

用数字说话,不止口头宣称

确定性评测层(evals/)随 CI 运行——无 LLM、结果完全可复现:

• 注入预算任意规模下成立:20/50/100/200 条记忆,注入段恒 ≤ 4 KB (实测 4065/4048/4018/3940 字节)且带截断标记;空库注入 0 字节。
• 淘汰零误杀:四类混合场景——只有"超龄零引用"被隐藏,文件零丢失, 读一次即复活。
• 已知局限(有意钉板):预算截断目前按索引行序(位置式)而非相关性排序—— 半量预算压力下探针保留率随规模降至 ~38%→10%。置顶可解关键项:同预算下 pinned 探针保留 ≥80%(0.3.0);完整相关性排序仍在路线图。

评测层已抓到过真实 bug:字节预算曾遗漏指导文本、整段超支 ~800 字节 (已修复并带回归)。

78 项测试(含确定性评测层)。运行时依赖仅 yaml。安装体积 15 kB。

安装

dsh plugin --profile demo add dsh-auto-memory   # npm 直装(预构建)
dsh --profile demo                               # 重启 profile 生效

源码安装:npm install && npm run build && dsh plugin --profile demo add /绝对路径。 要求 @deepseek-ai/dsh >= 0.1.5-rc.2(Node ^22.19 || >=24)。

配置

在 profile 的 cordis.patch.yml 覆盖(config 整表替换):

- id: auto-memory
  config:
    maxBytes: 4096          # 注入预算
    memoryDir: D:/memories  # 默认: $DSH_HOME/memory
    enableUserScope: true   # false: 用户层在所有路径禁用

工作原理(60 秒)

• 写入:工具 execute → name 归一化为 [a-z0-9-](保留字拒绝)→ 跨进程文件锁(官方 dsh-atomic-write)→ 原子写 → 锁内全量重建索引。
• 注入:单个动态段,每步组装重新求值;同步读索引、执行字节预算、中和 {{。 工具写入在下一个请求即生效——永远不需要重启。
• 审计:不写自定义会话事件(第三方事件类型会让 dsh 拒绝 resume); 一切走标准 tool/call / tool/result。

深度内容:设计决策 · dsh 源码级调研 · 复盘:向 awesome-dsh-plugin 提 PR

路线图

• P0——类型化存储、四工具、提示词注入、分层作用域、崩溃安全
• P1——会话结束自动固化、遗忘与淘汰、召回展开、人工审批的批量删除
• P2——Web UI 记忆卡片、token 成本/召回质量评测

许可

MIT