dsh 记忆体（Memory Body · Layered Memory Architecture）—— 多体挂载 + 自动总结 + FTS 检索

[szx-a]

dsh 记忆体（Memory Body）体验版

这是 Memory Body 提案 的可运行实现，核心闭环已跑通，发出来求反馈。

一句话：给 agent 一个跨会话、可挂载、可检索的长期记忆。

---

核心能力

• 多记忆体 + 按会话挂载：/mount /unmount 决定当前会话能检索哪些体
• 双权威记忆：user（用户钦定文档）/ model（模型总结的经验）
• 自动总结 + 降权不删除：/summarize 提炼会话经验；/forget 只标记失效、历史可追溯
• FTS5 全文检索：trigram 分词，中英文 3 字以上任意子串命中
• GUI + 后台 JSONL 双编辑：设置页「记忆体」tab 管体，也能直接改纯文本

---

和已有记忆插件的不同（我们的取舍）

1. 挂载，而不是全量注入

很多记忆方案是把所有记忆一股脑塞进上下文。这里相反：记忆体永远持久在磁盘，只有「挂载」的体才对当前会话可见。模型只加载挂载体的 id + 描述，需要时才检索。

好处：跨会话的记忆不会污染当前任务，隔离是显式的、可控的。

2. 双权威，而不是混在一起

严格区分两类记忆：

• user —— 用户钦定的文档，模型只读引用、不擅自改写
• model —— 模型自动总结的经验，可编辑、可被新经验推翻

好处：避免把模型自动总结的「噪声」和用户亲口说的「钦定」混为一谈，可信度分层清晰。

3. 降权不删除，而不是覆盖

推翻旧记忆不是物理删除，而是追加 superseded 标记，保留出处链（哪条被哪条推翻）。

好处：记忆可审计、可回滚，不会因为一次错误总结永久丢信息。

4. GUI + 纯文本双编辑，而不是黑盒

既有图形界面（设置页 tab），存储又是可读的 JSONL 纯文本，人能直接打开改。

好处：透明、可手改、可审计 —— 记忆不锁在一个看不见的数据库里。

5. 事件溯源，索引可重建

JSONL 是唯一权威，SQLite FTS 只是可丢弃的读模型，每次检索前从 JSONL 重建。

好处：索引坏了、丢了都不影响数据，从权威层随时重建，永不因索引损坏而丢记忆。

---

开发中踩过的坑

坑	现象	根因	解法
循环等待	pending (waiting for service: remote.memoryBody)	把「自己 $mount 出来的服务」写进 inject，apply 前死等	inject 只写外部依赖，$mount 后用 ctx.get() 读 ，这个错误的本质是插件把“由自己挂载出来的服务”错误地声明成了“启动前必须由别人提供的依赖”：memory-body 插件本身在 apply() 中通过 ctx.remote.$mount(memoryBodyRemote) 才会创建 remote.memoryBody，但如果同时把它写进 inject，Cordis 就会在插件执行 apply() 之前一直等待 remote.memoryBody 出现，而该服务又只能等插件启动后才会出现，于是形成循环等待，插件最终停留在 pending (waiting for service: remote.memoryBody)。正确做法是 inject 只保留 slots 和 remote，先执行 $mount，再用 ctx.get('remote.memoryBody') 读取刚挂载出来的服务。
假阳性	删 row 后「启动成功」但功能全无	删 row = 弃用服务，服务不加载自然无 pending	用 SQLite warning 判断服务是否真加载
waiting for memoryStore	preset 工具不激活	前置 MODULE_NOT_FOUND 把 memory-store row 带崩	修模块解析（leaf 包进 fallback 闭包）
中文搜不到	搜「用中文」搜不到「用中文交流」	unicode61 把连续中文粘成一个 token	换 trigram 分词器

版本状态

项	值
workspace 版本	0.1.0-rc.5
npm 官方最新	0.1.0-rc.6
发布前动作	git pull 同步 rc.6 → 重新构建 → 改 peerDependencies

npm 上没有 0.1.0-rc.5（官方是 rc.2 → rc.3 → rc.6），workspace:^ 原样发布会依赖解析失败。

已知限制（诚实）

• 检索最短 3 字符（trigram 机制）
• 挂载是会话临时，未持久化
• 未发布 npm（依赖版本未对齐 rc.6）

---

源码

https://github.com/szx-a/ds

---

请教与讨论

1. 「挂载」语义（数据永久、挂载临时）是否符合大家对记忆体的预期？
2. 下一步优先做挂载持久化，还是先补齐 npm 发布？

---

完整文档

安装步骤、目录结构、完整用法与设计细节，具体见仓库 README：

https://github.com/szx-a/ds#readme