← 返回列表
✓ 可直接安装
用本地 SQLite 跨会话记住事实，自动召回并可搜索
自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。 · 最近上游提交 2026/8/14 · 已提供中文文档
DeepSeek Harness 的持久化跨会话 SQLite 记忆
综合分
31.6
GitHub 分
31.6
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add dsh-memorynpm 包 dsh-memory 已校验归属本仓库，走 npm 安装最省事
数据截至 2026/9/16（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查✓ 自动检查通过
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-memory @ 0.1.0
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 01:13:22
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
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 文件——更小、无需密钥、可离线，代价是词法检索而非语义检索。扫码进群