Skip to content

dsh-memory-system

Verified

dsh-memory-system · v0.3.5 · MIT

File-based memory for DSH agents: layers, FSRS-5 decay, cold archive, recall, zones, and optional auto-injection.

Install

dsh plugin add dsh-memory-system

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

dsh-memory-system

给 DeepSeek Harness 用的文件式记忆体系:分层、会忘、能找回。

不是向量数据库,也不是「把聊天记录全塞进上下文」。它把记忆拆成四层:

  • L3 灵魂:身份/锚点,不衰减,只能本人改写;
  • L2 知识:判据(我信什么)+ 外部参考(用时查);
  • L1 情节:日记/判例/情节单元,FSRS-5 算牢固度,会冻结、可归档;
  • L0 会话:当前上下文,压缩即丢。

核心是分层 + 允许忘 + 能找回来,不是记得更多。

安装

dsh plugin --profile desktop add dsh-memory-system

或用本地 tarball:

npm pack
dsh plugin --profile desktop add ./dsh-memory-system-0.1.0.tgz

装完重启 DSH。插件本身不带任何人的灵魂/知识;初始化后才有模板。

初始化

装好后对助手说:

初始化记忆体系

或直接调用工具 memory_init。它会把模板(六件套、判据库、数据文件)和脚本复制到当前工作区,已存在的文件不覆盖。

工具

工具 作用
memory_init 初始化模板 + 脚本(不覆盖)
memory_status 单元总数、冻结数、每个单元的 R/S
memory_recall 按关键词找单元 + 原文;默认不列冻结
memory_review 复习一个单元,更新 FSRS-5(1-4)
memory_archive 冷归档(默认 dry-run,apply=true 才动)

分区

每个记忆单元有 zone,默认 task:

zone 放什么 自动注入 自动归档
identity 身份/锚点 ❌ ❌
relation 人物、关系、约定 ✅ ✅
task 手头的事、项目、待办 ✅ ✅
reference 外部参考、书摘 ✅ ✅
vault 私密仓 ❌ ❌

自动注入只读 relation/task/reference;vault 和 identity 要显式 memory_recall 才出现。

自动注入

插件启动后,每 3 秒检查活着的会话,挂一段 systemPrompt.context:

  • 取当前用户消息,和单元标题/note/source 算关键词相关度;
  • 再按重要度、FSRS R 排序;
  • 最多 6 条、700 字;只列 id + 标题 + zone,不注入全文;
  • 没有命中就返回空,不加噪音;
  • 需要细节让模型再调 memory_recall。

这是 v0.1 的轻量版:没有向量检索,也没有 token 精算;够用就好。

直接跑脚本

不装插件也能用(把 template/ 和 scripts/ 复制到工作区):

node scripts/memory-decay.mjs list
node scripts/memory-decay.mjs test
node scripts/memory-archive.mjs --self-test
node scripts/memory-archive.mjs                 # dry-run
node scripts/memory-archive.mjs --apply
node scripts/memory-recall.mjs 关键词 --review 3
node scripts/episode-add.mjs --kind text --title "..." --source "..." --detail "..."

结构

工作区/
├── 灵魂.md / 自我.md / 人设.md / 日记.md / 意向.md / 状态.md
├── 判据库.md
├── 知识/索引.md
├── 数据/记忆单元.json
├── 数据/memory-decay.json
├── 数据/archive/
└── scripts/

测试

npm test

test/smoke.mjs 会初始化一个临时工作区,验证:模板复制、分区过滤、自动注入不泄漏 vault、关键词召回、归档 dry-run。

设计取舍

  • 文件优先:可读、可 diff、可迁移;没有事务/并发控制。
  • 忘是功能:冻结/归档让旧细节不稀释当前判断;代价是要手动 review。
  • 判据 vs 参考:判据要案例 + 失效条件;参考用时查,不背。
  • 灵魂不可外包:外部插件可代存知识,不能代写「我是谁」。

边界

  • 召回是关键词/子串,不是语义检索;
  • 初始寿命是校准值(30/90/365/3650 天),不是验证过的效率;
  • 归档是半自动,不会自己判断「这条没用了」;
  • 没有内置加密:凭据不要放进这个体系,也不要进云备份。

许可

MIT。模板里的示例是虚构的,替换成你自己的。