dsh-memory-tiers · 六层记忆 + 历史压缩

v0.3.0（2026-10-31）。架构细节、实测数据、踩过的坑全在 ARCHITECTURE.md。 本文只讲「它干什么」和「怎么用」。

它做三件事

1. 自动记忆：订阅 session/event，每轮结束把你说的话、我调的工具写进记忆（L1）， 满了自动摘要沉淀到 L2/L3 和深层 DL1/DL2/DL3。
2. 注入上下文：每轮把 L3（长期摘要）+ L2（最近沉淀）作为一条 user 快照注入， 内容不变就不刷新，不打掉 prompt cache。
3. 接管历史压缩：每轮结束把 dsh 自带的会话历史压成一条 20 字占位， 零 LLM 调用，被压掉的内容先归档进记忆。上下文因此保持恒定，不随轮数增长。

文件清单

文件	作用
index.mjs	dsh 插件入口：注册工具、订阅事件、注入上下文、调度压缩
memory5.mjs	六层记忆核心：分层、热度、摘要、路由、检索、遗忘
compaction.mjs	历史压缩：把 dsh 的 surface 压成占位，原文归档进记忆
silicon.mjs	模型层：embed / 摘要 / 判关系（无 key 时降级为本地哈希向量）
cordis.patch.yml	告诉 dsh 怎么把插件插进配置树
package.json	包信息，dsh.bundle.patch 是关键字段
ARCHITECTURE.md	完整架构、实测数据、已知问题清单

安装

# 方式一：链接本地目录（改代码立刻生效，开发时用）
cd ~/.dsh/profiles/desktop
pnpm add "link:/path/to/dsh-memory-tiers"

# 方式二：装打包好的 tgz（分发用）
cd ~/.dsh/profiles/desktop
pnpm add /path/to/dsh-memory-tiers-0.3.0.tgz

然后把 dsh-memory-tiers 加进该 profile package.json 的 dsh.profile.bundles，重启 dsh。

配置文件在 <数据目录>/config.json，首次启动自动生成。

数据目录（可指定，便于备份迁移）

默认 ~/.dsh/storages/memory-v5。想换地方，用环境变量（支持 ~）：

export MEMORY_TIERS_DIR="~/my-memory"    # 或 D:/backup/memory

或在插件配置里传 dir。改不了 config.json 里的路径——那个文件就在目录内部。

整个目录是自包含的：store.json + vectors-part-*.json + archive/ + graveyard/ + config.json。拷走整个目录，换个 agent、换个机器，改一下 MEMORY_TIERS_DIR 就能接着用。

打包

npm pack --pack-destination ./dist

产物 dist/dsh-memory-tiers-0.3.0.tgz，只含 package.json 里 files 列出的运行时文件 （测试、模拟脚本、数据集都不打进去）。新增文件记得同步 files， 漏了会在安装后才炸（ERR_MODULE_NOT_FOUND）——compaction.mjs 就差点栽在这。

---

以下是 v1 时代的设计笔记（保留作背景，与当前实现已有差异）

第一步：先看它跑起来（不用装 dsh）

cd dsh-memory-tiers
node test.mjs

你会看到完整的生命周期：5 条记忆先全落在 L1 → 时间快进 4 天 → 3 条升 L2、2 条沉到 archive/*.md → 搜"验证"能翻出旧账 → 搜"环境"把冷存那条拉回来（回温）。最后打印出"每轮注入的提示词"长什么样。

这一步是你理解它的最快方式，比读文档快十倍。

第二步：装进 dsh（已在你机器上做好了）

重要事实（我实测过）：桌面版 dsh 的 desktop profile 被 Electron 应用独占，命令行装不进去 —— 会报 error: profile "desktop" is managed exclusively by the Electron application。 所以插件装在了独立的 web profile 里，用 dsh web 启动的那个实例。

装的时候需要 pnpm（dsh 的插件管理就是转发给 pnpm），我已经装好了（pnpm 12.15.0）。

# 已经执行过的两条，你不用再跑
npm i -g pnpm
cd dsh-memory-tiers && npx -y @deepseek-ai/dsh plugin --profile web add ./

装完之后 ~/.dsh/profiles/web/package.json 里会多出 "dsh-memory-tiers": "link:...你的目录"。 因为是 link，所以你改了 memory.mjs 重启就生效，不用重装。

第三步：启动并验证

npx -y @deepseek-ai/dsh web

浏览器会打开 http://127.0.0.1:3080/?token=...（token 每次不同，别用旧的）。

验证插件真的活着，看这个文件：

cat ~/.dsh/storages/memory-tiers/status.json

{
  "loadedAt": "2026-10-26T09:02:17.193Z",
  "tools": 6,
  "promptInjected": true,   ← 这两个是重点
  "dir": "C:\\Users\\Anxiple\\.dsh\\storages\\memory-tiers"
}

tools: 6 说明六个工具都注册上了，promptInjected: true 说明记忆已经接进系统提示词。 然后在对话框里输 /memory：

三层记忆：L1=0 · L2=0 · L3=0（钉住 0）
数据目录：C:\Users\Anxiple\.dsh\storages\memory-tiers

数据实际存在 ~/.dsh/storages/memory-tiers/：store.json 是状态表，archive/ 是冷存正文，都可以直接用编辑器打开看。

---

踩过的坑（你以后一定会遇到）

报错 / 现象	真正原因	解法
函数 'memory_xxx'：schema 必须是 'type: "object"' 的 JSON 模式，获得 'type: null'	工具参数用了 { id: {...} } 简写，只有官方 defineTool 能把它编译成 schema；而插件目录 import 不到 @deepseek-ai/dsh-tools，静默回退成裸对象，dsh 判成 null	手写 { type:'object', properties:{...}, required:[...] }，不要依赖 defineTool
cannot get property "systemPrompt" without inject	Cordis 里访问任何 ctx.xxx 前都必须在 inject 里声明过	用 ctx.inject(['systemPrompt'], cb) 包起来，别直接读 ctx.systemPrompt
插件加载了但模型完全看不到记忆	section() 的签名是 { name, order, text }，不是 { id, content }，写错会被 try/catch 悄悄吞掉	现在写错了会直接抛错，不会再静默失败
profile "desktop" is managed exclusively by the Electron application	桌面版独占 profile	换 web profile，或用桌面端的插件市场（只收 npm 包）
pnpm: command not found	dsh 的 plugin 命令只是把参数转给 pnpm	npm i -g pnpm

想调什么，改哪里

全在 memory.mjs 顶部的 DEFAULTS：

参数	默认	含义
l1TtlDays	3	即时记忆几天不用就结算
l1PromoteImportance	0.6	重要性够了就升长期
l1PromoteAccess	2	被用过 2 次也升长期
l2IdleDays	30	长期记忆多久没碰考虑下沉
l2ArchiveScore	0.25	评分低于这个就沉到文件
bootMaxChars	2000	每轮最多注入多少字

预算分配写在 buildBlock() 里：L1 拿 60%、L2 拿 35%、L3 只占一行——冷存正文永远不进上下文，这是省 token 的关键。

排错对照表

现象	原因	怎么办
重启后没反应，也看不到工具	package.json 的 dsh.bundle.patch 丢了，或 cordis.patch.yml 里的 name 和包名不一致	检查这两个字符串是否都是 dsh-memory-tiers
日志里出现"未能注入系统提示词"	你这个 dsh 版本的 systemPrompt API 名字不一样	告诉我版本号，改 index.mjs 里 injectPrompt() 那 10 行
工具能看到但不被调用	模型不知道什么时候该用	改工具的 description，把触发场景写具体
记了一大堆但想不起来	召回是关键词匹配，命中率有限	先 /memory 看分布，再考虑换向量检索

一句实话

这版是能跑的 MVP，不是成品。它的召回是两字组合的关键词匹配，够用但不够聪明；它的"蒸馏"是原样搬运，没有让模型总结压缩。这两块是后面真正拉开差距的地方——建议先用两周，等你真的被"想不起来"坑到了，再动手升级，否则你会一直在调你还没遇到的问题。

---

日常怎么用（装好之后）

大部分时候你什么都不用做。 正常聊天就行——插件每轮都会把记忆塞进上下文，模型看到"长期偏好 / 已定的决定 / 硬约束 / 你说记住"这几类信息时会自己调 memory_write。

四句话就够

你想干什么	直接说
让它记住	「记住：报告一律用 markdown」
让它想起来	「我之前说过报告用什么格式？」（它会自己调 memory_recall）
纠正记错的	「那条记错了，删掉重记：是 PDF 不是 markdown」
看它到底记了什么	/memory

怎么确认它真的在工作（三步）

1. 在会话里说一句「记住：我的项目路径是 D:/lung」
2. 开一个新会话，问「我的项目路径是什么？」——能答出来就说明跨会话生效了
3. 打开 C:\Users\Anxiple\.dsh\storages\memory-tiers\store.json，能看到那条记录，tier 是 L1

三个不明显的点

• /memory recall 关键词 是手动检索，冷存里的东西也能搜到，比问模型快。
• 冷存不是删除。 L3 的正文在 archive/*.md 里躺着，搜到就自动捞回来并升回 L2，你随时能看能改。
• 重要的东西要钉住。 说「把那条钉住」，它会调 memory_pin，之后无论多久不用都不会被降级——核心偏好和硬性约束值得钉。

它什么时候"遗忘"

• 每 6 小时自动结算一次（插件里的定时器），重启 dsh 也会补结算一次。
• L1 三天没人碰 → 重要的升 L2，不重要的沉到 archive/。
• L2 三十天没人碰且评分低 → 沉到 archive/。

想改这些天数，回去改 memory.mjs 顶部的 DEFAULTS，重启生效。