dsh-auto-memory

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

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

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

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

dsh Web UI 中的记忆管理面板

亮点

0.7——更新替换语义:固化命中同一事实即原地更新,不再堆积近似重复; 匹配核心由产品与评测共用。已实测官方桌面端(0.2.0-rc.2)。完整历史:CHANGELOG.md · Releases

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 字节 (已修复并带回归)。

106 项测试 + 三层评测(L0 确定性/L1 召回/L3 固化质量)。运行时依赖仅 yaml。

安装

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)。兼容官方桌面端——已在 0.2.0-rc.2 实测。

配置

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

- id: auto-memory
  config:
    maxBytes: 4096          # 注入预算(索引+指导文本+协议壳)
    memoryDir: D:/memories  # 默认: $DSH_HOME/memory
    enableUserScope: true   # false: 用户层在所有路径禁用
    autoSummarize: false         # true: 根会话结束时后台 LLM 提取持久事实写入
    autoSummarizeMaxMemories: 5  # 单次固化上限
    autoSummarizeMaxTokens: 2048 # 固化输出 token 上限
    staleAfterDays: 0            # >0: 软隐藏超 N 天零引用记忆(文件保留)

工作原理(60 秒)

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

深度内容:设计决策 · 复盘:向 awesome-dsh-plugin 提 PR

路线图

P0——类型化存储、四工具、提示词注入、分层作用域、崩溃安全
P1——会话结束自动固化、遗忘与淘汰、召回展开、人工审批的批量删除
P2——Web UI 记忆面板、token 成本/召回质量评测
P3——更新替换语义、匹配核心与评测共用
注入审计日志(#11)、L2 端到端评测

更新日志

逐版本说明:CHANGELOG.md · GitHub Releases

许可

MIT

dsh-auto-memory

Install

Source

Tags

Creators

Readme

dsh-auto-memory

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

亮点

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

一分钟感受它

模型实际看到什么

首发之前就被锤炼过

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

安装

配置

工作原理(60 秒)

路线图

更新日志

许可