SQLite 持久记忆 ben7am1n/dsh-memory

dsh-memory

为 DeepSeek Harness 提供持久的跨会话记忆。

该 harness 不附带任何记忆插件。它的 extension-cookbook 指明了机制——一个提示词区段加上若干工具——但没有任何实现，因此每个会话都从空白开始。本包用一个本地 SQLite 文件填补了这一空白：无需嵌入服务、无需 API 密钥、无需边车进程。

安装

dsh plugin --profile web add dsh-memory

随附的 bundle 行将记忆存储在 $DSH_HOME/memory/memory.db，由机器上的每个 profile 共享。

它为模型提供什么

| 工具 | 用途 |
| memory_write | 存储一条自包含的持久事实，可选地打标签并固定 |
| memory_search | 对记忆文本和标签进行关键词搜索 |
| memory_forget | 删除一条现已错误或过时的记忆 |

外加一个 memory:recall 提示词区段，它在字符预算内先渲染固定的记忆，再渲染最近更新的记忆。因此，召回并不依赖于模型记得去搜索——它存储的内容已经呈现在它面前，而搜索则用于查找超出预算允许范围的更早内容。

memory_write 的描述引导模型避开常见的失败模式：临时任务状态（那是待办列表的用途）、机密信息，以及仓库已记录的事实。

配置

- id: memory
name: dsh-memory
config:
path: !!js dshHomePath('memory/memory.db')
promptRecentCount: 10
promptMaxChars: 2000
maxTextChars: 2000
searchLimitDefault: 10
searchLimitMax: 50
promptOrder: 50

| 字段 | 默认值 | 含义 |
| path | —（必填） | SQLite 文件，或 :memory: 表示临时存储 |
| promptRecentCount | 10 | 提供给提示词区段的未固定近期记忆数量 |
| promptMaxChars | 2000 | 渲染区段的预算；溢出以计数形式报告，且固定记忆优先输出，因此它们能在紧张的预算下保留 |
| maxTextChars | 2000 | 单条记忆接受的最大字符数 |
| searchLimitDefault | 10 | 模型省略时 memory_search 的 limit |
| searchLimitMax | 50 | 硬性上限，无论模型请求多少 |
| promptOrder | 50 | 区段顺序；-100 是 harness 身份，0 是 persona |

path 有意不在代码侧设置默认值：默认值会将持久的用户事实散落到 harness 恰好启动时所在的任意目录中。部署值位于 patch 行中。

存储

一个 SQLite 文件：一张 memories 表，外加一个由触发器保持同步的外部内容 FTS5 索引。父目录在打开时创建，且存储可在进程重启后存续。
搜索通过为每个 token 加引号来编译查询，因此模型碰巧输入的 FTS5 运算符（OR、*、-、"）会被按字面匹配，而不会改变查询的含义，也不会在工具调用中途引发语法错误。存留的 token 通过 FTS5 的隐式 AND 组合：每个 token 都必须出现，而如果查询的 token 中包含一个你并未合法存储的词，则合法地匹配不到任何内容。

node:sqlite 在 Node 22/24 中仍被标记为实验性，因此运行测试框架会打印一条 ExperimentalWarning。测试框架自身的 dsh-session-query-sqlite 使用的是同一个模块。

失败行为

加载时的错误配置会大声失败：空的 path、非正的边界值，或高于 searchLimitMax 的 searchLimitDefault，都会在插件加载时抛出异常。

在调用时，空白事实或超过 maxTextChars 的事实是模型可以纠正的工具错误。对不存在的 id 执行 memory_forget 是一个成功的结果，报告 forgotten: false —— 模型请求的是一个已经成立的状态，这不是基础设施故障。

扩展点

三个工具使用 ctx.tools.register()，召回使用 ctx.systemPrompt.section()。每次注册都是一个 Cordis effect，因此卸载插件会一并移除这些工具和该 section，并关闭数据库。

开发

pnpm install --ignore-workspace
pnpm run typecheck
pnpm test
pnpm run build

测试直接覆盖存储层（FTS 检索、字面 token 查询契约、提示词排序、跨重新打开的持久性），并针对真实的工具注册表和提示词服务测试插件（注册、释放、写入→召回往返、边界、大声失败的配置）。

许可证

MIT

先前技术

这个想法来自 Pi 生态系统中的 pi-mentis（MIT）。这是一个针对 Harness 扩展点的独立实现，与其不共享任何代码。它有意舍弃了 pi-mentis 的 sidecar 进程、Zvec 向量存储和必需的 SiliconFlow embedding key，转而采用单个本地 FTS5 文件——更小、无需密钥、可离线，代价是词法检索而非语义检索。