dsh-plugin-memory-lite

dsh-plugin-memory-lite

给 DSH 的本地优先跨会话记忆：每轮自动沉淀，空闲时自动整理，需要时按需注入。

数据全部存在本地 SQLite 文件里 —— 不联网、不上传、不依赖任何外部记忆服务。

---

它解决什么

DSH 的会话本身是有记忆边界的：换一个会话、或者一次压缩（compact）之后， 之前聊过的结论就找不回来了。你得反复重新交代"我们用两层架构""那个坑别再踩"。

这个插件在后台做三件事：

日志层永远不进提示词 —— 只有蒸馏后的条目才会被注入。 否则上下文预算和前缀缓存都会被日志淹没。

日志层存的不是"逐字原样"：落盘前会剔掉宿主注入的系统样板（<system-reminder> 里的 用户全局 AGENTS.md 等），也会去掉与前文重复的部分（实测 10 轮对话曾因此写出 804 KB， 相邻两条有 6/9 对是"后一条完整包含前一条"）。没有内容的轮次干脆不记。

---

安装

命令行：

dsh plugin --profile <你的profile名> add github:eighteentang/dsh-plugin-memory-lite#v1.3.0

或者在界面里装（不用命令行）：侧边栏 「插件」→「添加插件」，把地址贴进去。 那个输入框接受包名、Git 地址、压缩包、本地绝对路径四类写法：

⚠ 别贴 Releases 页的地址。 …/releases/tag/v1.3.0 会被直接拒绝 （提示 a URL must point at a git repository or a tarball）—— 它只认仓库根地址 或压缩包链接；版本要写成 #v1.3.0 拼在根地址后面。同理 …/tree/main 这类网页地址也不行。

这几条不是猜的：宿主侧的解析函数 parseInstallSpec 曾被抽出来逐例跑过 （那是开发者本机的诊断脚本，不随仓库发布 —— 见下方「关于本仓库不含开发工具」）。

装完后重启客户端，设置页会出现 「记忆控制」。

#v1.3.0 是版本钉子 —— 钉住版本避免"装到一半上游改了"。 去掉 #… 就是跟随主分支（自动拿到新改动，也自动拿到新 bug）。 全部版本见 CHANGELOG.md；升级就是先卸载再装新版 （DSH 的插件目前不支持自动更新）。

开发期用 link: 装（link:D:/path/to/memory-lite）也是支持的， 但必须保留 peerDependencies，否则插件的包解析会失败。

---

怎么用

平时不用管

• 每轮对话结束，它自动把这一轮记下来（不花模型额度）
• 每句用户消息到达时，它按关键词找相关记忆，注入到对话尾部
• 整理成条目默认要你手动点（避免"没打招呼就花额度"）。 想让它自己长出来，把 autoDistill 设成 true —— 那样空闲 30 分钟后会自动整理 （每天最多 4 次，见下面配置）。

想手动做点什么

设置页 →「记忆控制」分成上下两块：

• 上面两个文本框：人设设定 / 工作规范与行为准则 想写什么就写什么 —— 没有任何格式要求（不用标题、不用 markdown）。 两块内容存在插件自己的两个文件里：

  $DSH_HOME/memory-lite/persona/persona.md   ← 人设设定
  $DSH_HOME/memory-lite/persona/rules.md     ← 工作规范与行为准则
  

  它们被注入成 system prompt 的一段（位置紧跟框架自己的人设段）—— 所以是 每一轮都生效，不像记忆库那样靠召回（规范类的东西"这轮没命中"就等于静默失效）。 保存后下一轮立刻生效，不用重启；写前自动备份到同目录的 backup/。

  代价：它们随插件走 —— 插件停用/卸载，人设与准则就不生效了。

• 下面是长期记忆列表：搜索、按状态筛选、改状态（在用 / 已完成 / 已停用）、点「立即整理」。 列表是一行一条、行行等高（层级 · 项目 · 标题 · 敏感 · 用过N次 · 状态）， 不展示正文 —— 标题/项目太长会省略号截断，鼠标悬停看全文。 「用过几次」显示成 3×（悬停会说明"被自动注入过 3 次"，– 表示还没用过）。

想手动记一条记忆：直接在对话里说（memory_note），比在界面上敲更快、还能带上上下文。

• 对 DSH 说（这些是模型可见的工具）：
  • 「记住：这个项目用两层记忆架构」→ memory_note
  • 「搜一下我之前说过关于注入的东西」→ memory_search
  • 「把那条标记成已完成」→ memory_update
  • 「忘了那条吧」→ memory_forget（删除需要你点头，走审批）

用户级记忆（跨工作区）

有些事跟哪个项目无关：你是谁、做什么工作、说什么语言、跨项目的工作约定。 这类东西写进某个工作区，就只有那个项目能召回 —— 所以要显式写进用户级库：

$DSH_HOME/memory-lite/global/memory.db   ← 用户级（跨工作区）
<工作区>/.dsh-memory/memory.db           ← 该工作区自己的（默认）

• 怎么写：对话里说「记住（跨工作区）：我在深圳，做产品运营」→ 我用 memory_note 带 scope="user" 写进用户级库。默认是当前工作区，我不会靠 project 字段猜。
• 怎么起作用：每轮召回时「当前工作区 + 用户级」一起搜、合并排序， 同分时工作区优先；同一条记忆只出现一次（按内容判重，不是按 id）。
• 不会拖累提示词：合并后仍受 injectMaxItems 那一个名额上限管， 用户级记忆写多少条都不会让每轮注入变长。
• 不进常驻索引段：索引段只有 4096 B，容量留给工作区条目 （所以用户级条目是靠「按需召回」生效，不是像人设那样每轮都在）。
• 面板：设置页 →「记忆控制」的库下拉里会多一项「用户级（跨工作区）」， 可以像别的库一样看、搜、改状态。

还要更"永远在场"的？那是人设/工作规范两个文本框的活（它们每轮都注入）。 分工：每轮都必须遵守的规则 → 那两个框；换个项目还需要的事实 → 用户级库； 跟这个项目有关的事 → 工作区库。

三种状态

---

数据在哪

<工作区>/.dsh-memory/memory.db        ← 记忆库（每个工作区一个）
<工作区>/.dsh-memory/archive/         ← 日志溢出后的归档（jsonl）
$DSH_HOME/memory-lite/global/         ← 用户级库（跨工作区，见上一节）
$DSH_HOME/memory-lite/persona/        ← 人设 / 工作规范两个文本框的内容
$DSH_HOME/memory-lite/workspaces.json ← 库 → 工作区 的注册表

删除记忆：三种方式，按彻底程度

1. 设置页把条目改成「已停用」—— 不注入了，但还在库里（推荐，可恢复）
2. 用 memory_forget 工具删单条 —— 需要审批
3. 直接删 .dsh-memory/ 目录 —— 全部记忆消失，不可恢复

---

配置

在 profile 的 cordis.patch.yml 里给插件加 config：

- id: memory-lite
  name: dsh-plugin-memory-lite
  config:
    autoCapture: true             # 每轮自动落日志（不花额度）
    autoRecall: true              # 每轮按关键词注入（不花额度）
    autoDistill: false            # 空闲自动整理 —— 默认关（会花模型额度）
    distillIdleMinutes: 30        # 开启 autoDistill 时：多久没说话才算"空闲"
    distillMinIntervalMinutes: 30 # 开启 autoDistill 时：两次整理之间的最小间隔
    distillMaxPerDay: 4           # 开启 autoDistill 时：每天最多整理几次（成本硬上限）
    injectMaxItems: 3             # 单次最多注入几条
    injectMaxChars: 2000          # 单次注入的字符上限
    crossWorkspaceSearch: true    # 允许跨工作区检索
    distillProvider: ''           # 留空 = 用会话默认模型
    distillModel: ''

关于花额度：默认 autoDistill: false —— 日志照记，但只有你点「立即整理」时才会调用模型。 想让它自己长出来就把 autoDistill 设成 true，那时上面三个 distill* 参数才生效 （空闲多久算闲 / 冷却 / 每天上限）。

---

设计上的几个刻意选择

这些都是踩过坑之后定下来的，改动前请先读 AGENTS.md：

• 注入只走长期层。日志层永不进提示词，否则前缀缓存失效、上下文预算被淹。
• 注入是"只追加"：作为独立消息追加在本轮已领取消息之后，不改写已有历史。
• 不重复注入：同一会话里已注入过的条目不再注入；压缩后重置这个记录并补回常驻记忆。
• 敏感内容 fail-closed：sensitive 在写入时算一次并落列，注入时只读列。 注入路径上再判断，等于把 fail-closed 变成 fail-open（判断代码出错就注入了）。
• 删除走审批：memory_forget 声明为破坏性工具，转人工确认。
• 超预算的日志留到下次：不"发都没发出去却记成处理过了"——那会永久丢内容。
• 蒸馏输入先剔系统样板，再取头尾：日志一条 = 一整轮，里面夹着宿主注入的 <system-reminder>（用户全局 AGENTS.md 等）。实测 10 条真实日志里有 7 条的 "前 1500 字"逐字相同 —— 不剔样板的话，模型看到的不是"这一轮发生了什么"， 而是同一段样板。剔完再按 头 40% + 尾 60% 取样（结论在尾部）。
• 常驻索引段每条只列 20 字：这段每轮都在 system prompt 里，中文 1 字 = 3 B。 实测 33 条时它已占到 4096 B 预算的 83.8%（每行 123 B）→ 只装得下约 33 条， 再多就会静默掉出提示词。截到 20 字后约能装 49 条。别指望"回填标题"来救容量 —— 回填的标题同样会被截断，额外容量是 0。

---

已知限制

• 检索是关键词级的，不是语义向量检索。中文查询按连续串与子串匹配， 所以换个说法可能搜不到（用 memory_search 时尽量带上你当时用的词）。
• 每个工作区一个库，默认只搜当前工作区；跨工作区要显式 scope="all"。
• 日志层有容量上限（每会话约 200 条），超出会先写归档文件再删库内行（不静默丢）。
• 空闲自动整理依赖宿主进程活着 —— 客户端关着的时候不会整理。

---

关于本仓库不含开发工具

本仓库只有插件本身（index.js / lib/ / client/ / locale/ / 图标 / 补丁 / README / LICENSE）。

校验器（verify-*.mjs）、诊断脚本（diag-*.mjs）、迁移脚本与发布助手不在仓库里， 它们只在开发者本机（原因：那些脚本含开发机的绝对路径与个人数据位置，不该跟着插件发给别人； 这也是本项目的一贯纪律 —— 开发产物不进用户包）。

如果你想自己验证这个插件的行为，用它的运行时表现验： 装完之后在设置页看「记忆控制」，或者用 memory_stats / memory_search 这些工具直接问它。 真机行为才是判据。

---

许可

MIT