dsh-memory-layer

给 DeepSeek Harness 的记忆层：本地单文件、零服务、零 API，靠触发信号把该想起的记忆在该想起的时候拿出来。

v0.10.0 · MIT License · DSH ≥ 0.1.1-rc.2（已在 0.2.0-rc.2 桌面版实测）· Node ≥ 22.19.0

它是什么

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

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

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

四层结构

1. 存储层：单文件 SQLite

另有两张辅助表：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 → 跑测试 → 再改代码

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

安装

# 需要已安装 git；--profile 换成你的 profile 名
dsh plugin --profile web add github:KLRSL/dsh-memory-layer

# 本地开发（link）
dsh plugin --profile web add link:./dsh-memory-layer

装完重启 DSH（桌面版会热挂载）。

用法

工具 memory

还有一个 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）可覆盖：

设计上刻意不做的事

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

版本历史

License

MIT — 详见 LICENSE。