仿生记忆 KLRSL/dsh-memory-layer

dsh-memory-layer

给 DeepSeek Harness 的记忆层：记住你的偏好和决定，换个会话它自己会想起来；数据只在本机，随时能查能改。

v0.10.2 · MIT License · DSH 0.2.x（>=0.2.0-rc.2 <0.3.0-0，0.2.1-rc.3 桌面版实测）· Node ≥ 22.19.0

它是什么

一句话：只做记忆，不做记忆平台。

- 不做：外置服务、向量检索、嵌入模型、知识图谱、云端同步、Web UI。
- 做：一个 SQLite 单文件 + 一套确定性规则，管「什么时候该想起什么」。

它和「记忆平台」（如外置记忆服务）的区别，不在功能多少，而在没有额外要跑的东西：装完就是一个插件，数据在你自己机器的 .dsh/biomemory/biomemory.db 里，拷走文件就是迁移。

四层结构

1. 存储层：单文件 SQLite

| 字段 | 含义 |
| realm | 隔离维度：user 或 project:<工作目录> |
| mtype | 记忆类型：workflow / error / decision / fact |
| trigger | 触发信号串（见下） |
| mkey | 同键覆盖用的主题键 |
| text | 正文 |
| created_at / last_accessed / hits | 生命周期：写入时间 / 最近使用 / 使用次数 |
| status | active / archived / deleted（删除是墓碑，不物理删） |

另有两张辅助表：chains（工作流链）、trigger_counts（触发次数，用于工作流升级）。

2. 召回层：触发信号驱动

不等模型「自己想起来」，而是看当前会话发生了什么：

- 信号来源：当前会话工作目录（session.cwd）+ 最近 12 次工具调用的名字与参数（文件路径、命令、错误代号都从这里来）。
- 触发串只有三种形态，可读可解释：
- file:<文件名> —— 例如 file:package.json
- tool:<工具名> —— 例如 tool:pwsh
- err:<错误代号> —— 例如 err:MODULE_NOT_FOUND
- 命中即注入，排序 workflow > error > decision > fact，同类型按最近使用时间；命中工作流链则整条链一起注入。
- 注入预算：每次最多 8 条、最多 1200 字符；没命中就一个字都不注入（不占 token）。

3. 清理层：五条可解释规则

/memory compact 执行，每次淘汰都写 compact.log：

1. 同 realm + type + key 的新记忆覆盖旧记忆（旧条目标墓碑）——写在写入路径上；
2. fact：超过 30 天没人用（使用次数 ≤1）→ 进墓碑；
3. workflow / error / decision：不设有效期；超过 90 天没人用 → 权重减半；
4. error 与 decision 永不自动删除；
5. 每条淘汰/降权都记 compact.log（时间 · 指纹 · 命中规则 · 摘要）。

4. 适配层：工作流从重复里自己长出来

同一个触发串出现 超过 3 次，相关记忆自动升级为 workflow，并按时间顺序拼成一条链：

当 file:package.json 时：先看 package.json → 跑测试 → 再改代码

链是顺序记录，不是因果推断——不假装知道为什么，只如实记下「你上次是这么做的」。

安装

桌面版：按包名安装（推荐）

1. 打开 DSH 桌面版 → 左侧 插件 → 加插件；
2. 在包名输入框填 dsh-memory-layer，点 安装（安装完自动启用）。

命令行等价：

把 desktop 换成你的 profile 名
dsh plugin --profile desktop add dsh-memory-layer

本地开发（link）

dsh plugin --profile desktop add link:./dsh-memory-layer

安装完重启 DSH 生效（开了 HMR 的 profile 会热挂载）。

用法

工具 memory

| action | 说明 |
| add | 写入一条记忆（text 必填；track=user|agent；source 记来源） |
| query | 关键词查询（text/topK/fragmentTypes/includeArchived） |
| list / update / remove / restore / pin / unpin | 浏览 / 改 / 删（墓碑）/ 回滚 / 锁定 / 解锁 |
| compact | 按五条规则清理（dryRun=true 只预览） |
| dump | 导出人类可读 Markdown（含工作流链） |

还有一个 memory_recall 工具，用于「你还记得…吗」式的显式召回。

命令 /memory

/memory list | query <词> | add <内容> | edit <fp> <新内容> | remove <fp> | undo <fp> /memory pin <fp> | unpin <fp> | entries [词] /memory compact [--dry-run] | dump

写入审批

重要记忆（用户偏好/决定/纠正类）走 DSH 官方审批：批准才落库，审批服务不可用时默认拒绝（fail-closed，可用配置 approvalFallback=auto 放宽）。

数据与隐私

- 全部本地：零网络请求、零外部 API、零遥测。
- 数据库：<DSH_BIOMEMORY_DIR || ~/.dsh/biomemory>/biomemory.db（SQLite，WAL）。
- 删除是墓碑（可恢复），compact 也只在库内改状态；需要真备份时 dump 出 Markdown。
- 环境变量：DSH_BIOMEMORY_DIR（数据目录）、DSH_MEMORY_ROOT（Markdown 备份/日志目录）。

配置

~/.dsh/biomemory/biomemory.config.json（或 bundle config）可覆盖：

| 键 | 默认 | 说明 |
| nearDuplicateThreshold | 0.7 | 写入去重的相似度阈值（0=关闭） |
| nearDuplicateAction | merge | 命中近重复时合并 / skip 只提示 |
| approvalFallback | deny | 审批不可用时拒绝 / auto 自动保存 |
| decayThreshold | 3 | 状态页「低权重待处理」的阈值 |
| hotTokenLimit | 5000 | 冻结快照注入的 token 上限 |
| maxQueryResults | 20 | 查询返回上限 |

设计上刻意不做的事

- 不做向量/嵌入检索：相同输入必须给相同结果，检索要可解释。
- 不做自动「反思」：没有模型就不假装会归纳；工作流只从重复里浮出来。
- 不做删除即销毁：一切删除留墓碑，误删可回滚。
- 不做跨机同步：那是另一类产品；这里只保证文件可以整体搬走。

版本历史

| 版本 | 日期 | 变更 |
| v0.10.2 | 2026-10-25 | 简介换成「记住偏好与决定、换会话自动带上」的说法，桌面版实测版本改 0.2.1-rc.3；功能无变更 |
| v0.10.1 | 2026-10-25 | 插件卡片文案重写：中英双语显示名与一句话简介（locale 的 meta），description 去掉版本号与功能罗列；功能无变更 |
| v0.10.0 | 2026-10-05 | 重构为「记忆层」：新增触发式召回（trigger + realm + mtype + mkey 四列）、类型优先级排序、五条清理规则 + 墓碑 + compact.log、工作流从重复中升级并成链、注入预算（≤8 条 / ≤1200 字符）、compact/dump；移除记忆代谢（dream）、深度反思（reflect）、冲突裁决、结构化审计与自动 Markdown 镜像 |
| v0.9.2 | 2026-09-29 | 删死模块与死配置键；文档与实现对齐（配置表/API 表/测试数） |
| v0.9.1 | 2026-09-29 | 移除管理 UI，插件退化为纯宿主能力 |
| v0.9.0 | 2026-09-29 | 移除嵌入模型与 semantic/hybrid 检索，改单一确定性检索路径 |
| v0.8.2 | 2026-09-20 | 合规化批次：审计双写修复、配置按类型落库、近重复写入去重 |
| v0.8.0 | 2026-09-16 | 写入去重（bigram 相似度）+ 合并/跳过两种策略 |
| v0.7.0 | 2026-09-17 | 镜像同步钩子（v0.10.0 已移除） |
| v0.6.4 | 2026-09-06 | 单轨制：SQLite 为唯一事实来源，Markdown 降级只读备份 |
| v0.6.0 | 2026-08-19 | 架构拆分（shared/store/retrieve/snapshot/gate）+ 会话沉淀 |
| v0.5.0 | 2026-08-15 | 数据层迁移到 SQLite（node:sqlite） |

License

MIT — 详见 LICENSE。