轻量记忆 regrevia/dsh-lite-memory

dsh-lite-memory

全库不常驻：没有命中的轮次不追加记忆内容，命中时最多三条卡片，正文按需读。

它是什么

给 DeepSeek Harness 的轻量记忆：全库不进常驻提示、不逐轮注入、不扫描文件。记忆只在两种时刻出现——你说「记一下」，或者这句话跟已有条目真有关（最多三条卡片：标题、摘要、前提，正文仍按需读）。

触发方式

| 场景 | 行为 |
| L0 你明确要求「记住这个」 | 立即写盘，一条确认行 |
| L1 它发现有跨会话价值的经验 | 一行灰字 memory · suggested "X" + 一个「保留」按钮；标题加一句话，看得懂才点，不点就永远不写，48 小时内不重复 |
| L2 常识、一次性参数、凭据的值 | 永不写入 |

这些行只属于产生它的那一轮：每轮按那轮自己的工具结果重建，重进会话还能看见，别的轮不会混进来。再记一次时插件自己判是更新还是新增：同一层里标题（或这条用过的旧标题）完全一致就更新原条目，前置条件不同也更新这一条，不并存两条同名；换过说法而标题变了的旧标题记成别名以后也认得。像但不同名的不写：先在结果里回「相近：X」，确认要更新就用那个标题重存，确认是另一条才加 resolution="distinct"——另存要换个能区分的标题。更新时没给的字段保持原值，正文整段替换——旧正文只作内部撤回依据，不展示、不参与检索。旧数据里已经分叉的同名条目，下一次写入这一层时自动收并成一条，另一条进可恢复归档。读取时标题只记得一半（到逗号或括号为止）也认得：唯一一条前缀对得上就直接读，对得上两条就把候选标题列出来，不猜；同名前缀的归档副本不算第二条候选，活条目优先。

写入时分两层：默认只在这个项目生效；用户说「以后所有项目都这样」才进全局层（200 条起提示，硬上限 1000 条），检索时一起查。同一主题在不同前提下用 when 区分，各存一条。

写入前先蒸馏：标题是结论，正文只留原则、判断规则和触发条件，不把具体尺寸、字号、层级、颜色或一次性数字记进来；需要这些值时按记忆里的指针查当前代码或文档。单条正文超过 4096 字节会被拒绝，先删细节再存；摘要超长自动截到 60 字。

触发词：记住、记一下、上次、规范、约定、路径、凭据怎么取。

真命中看这句话和记忆的标题（含旧标题）、标签、触发词、摘要有没有对得上的词：有就多一行「已有记忆可能相关」，最多三条标题，每条前面标归属（[global] 或项目目录名如 [DSH]）；没对上就不出现，不改命中计数，正文要 memory_read 才读。一条记忆写了触发词，用户说到那个词也算命中。

普通记忆卡片和实验规则共用一份额度：一次最多 3 条、1200 字节，按整条准入，先到先占；自动提示只带标题和摘要，不带正文。实验短规则（正文不超过 240 字且不超过 4 行）直接带正文，更长的只给标题和用途，正文仍要 memory_read。
这些行属于产生它们的那一轮：每一轮都按自己的工具结果重建，所以重新打开会话时它们会再次出现，别的轮次不会混进来。再次保存时，只要标题（或它之前的某个标题）在同一层里精确匹配，就更新那一条——不同的前置条件仍然更新同一条，绝不会写出第二条同名条目。标题只是相似时，先什么都不写：结果会给出最接近的条目，调用方要么用那个标题重新保存，要么加上 resolution="distinct"，这要求标题确实不同。更新会保留所有没给的字段，整体替换正文；旧正文只留作内部撤销，不展示也不参与搜索。磁盘上已有的历史重名条目，会在下次写入该层时合并成一行，多出来的那行移入可恢复归档。

写入落在两层之一：默认是当前项目，或者全局层（超过 200 会警告，硬上限 1000），当用户说这条规则适用于所有项目时用全局层。两层一起搜索，when 字段用来区分同一主题在不同前置条件下的条目。

写之前先提炼：标题就是结论，正文只留原则、决策规则和触发条件。具体尺寸、字号、z-index、颜色和一次性数字都不写；记忆只指向去哪里读当前值。正文超过 4096 字节会被拒绝，所以保存前先删细节；过长的摘要会截断到 60 个字符。

点一下就存 / One click, no turn

「保留」是同源直写：不产生消息、不动输入框、不打断当前回复。点完按钮消失，行变成 memory · kept。真写过的行尾才有 ✕，按标题撤销：改过的条目还原成上一版（显示 restored），刚建的条目移入归档（显示 archived）；条目后来又改过就停下并说明已经变过，不覆盖后来的修改。没变、需要确认、保存失败的行没有撤销。

「保留」按钮直接从页面写盘：不发消息，不多跑一轮模型，输入框原样不动。按钮消失，行变成 memory · kept——整个交互就这些。只有真正变过的行才有 ✕，按标题撤销：改过的条目回到上一版正文（restored），刚建的条目移入归档（archived）；条目又变过就停下并说明，不覆盖。没变、需要确认和保存失败都没有撤销。

每轮引用条 / Per-turn references

每次回复末尾、在「已编辑 N 个文件」下面，按这一轮实际发生的工具结果留几行：本轮参考 N 条 和 本轮更新 N 条。点开是记忆名，再点一条就地展开当前正文；名字和正文都取当前值——改过名显示新名字，归档的标「已归档」，删掉的显示「已删除」。同一轮同一条只出现一次；没读过也没写过就整段不出现。切换会话不丢，每轮只按自己的工具结果重建。

每轮结束后，在「已编辑 N 个文件」下面留几行，由这一轮自己的工具结果生成：本轮参考 N 条 和 本轮更新 N 条。点开一行展开记忆名，点一个名字展开它现在的正文——当前标题、当前正文，归档的标出来，删掉的就直说。同一轮每条只占一行；没读过也没写过，就什么都不显示。切换会话不会丢，因为每轮只按自己的工具结果重建。

记忆面板 / Memory panel

会话头的大脑图标打开居中的记忆面板。浮层挂到 document.body 上，尺寸按视口算，宿主容器的高度和定位不影响它；点遮罩或右上角关闭。内容分「记忆」「自进化」「设置」三个页签：前两页只放内容，开关和调参都在「设置」里，不占列表和宫殿的位置。「设置」里是「启用记忆」「自进化」「记住我」三个开关、「启用图谱」「启用记忆宫殿」两个只影响展示的开关（默认关闭，按项目记住）和排序调参；回执与召回提示只在有话说时占面板底部一行。默认看当前项目，也可以切到其他项目或全局层；切过去只读，不回写、不迁移旧格式。

「记忆」页签里，搜索框右侧可以在「列表」「图谱」「宫殿」之间切换；列表、图谱或宫殿占满内容宽度，选中记忆后右侧才出现正文与归属。当前项目里点「修改」可以就地改标题和正文，保存后版本加一；别的项目和全局层只读。图谱按真实数据画，点记忆节点读正文，点标签或主题节点转成搜索，右上角可缩放。宫殿按类型分四间：习惯与规范、方法与经验、资料与入口、其他记录；一次只展开一间，每间每页 24 条，点展品只读正文。宫殿只决定怎么陈列，不改记忆、学习状态和额度。「自进化」页签只作用于当前项目，按「全部 / 候选 / 试用 / 生效 / 暂停」筛选，也能切列表与图谱；详情给出当前经验、适用范围、当前状态、学习依据和变化记录。候选可采纳、修改、放弃，试用可采纳、修改、暂停，生效可修改、暂停，暂停可恢复或查看记录。

「记忆」页签里另有一张「记住我」卡片，默认关闭，和项目记忆、自进化各自独立。开启后只累计表达偏好：先给结论还是先讲背景、讲多细、要不要举例、语气、选项怎么给等八个维度；技术方案、业务判断、参数、权限、发不发这类决定不在其中。卡片头写已记住几条，已形成的每条标出依据条数，点开能逐条看来源（你明确说过 / 多次选择 / 手动改）并删掉单条；删到没依据就退回观察中。观察中的维度可以直接点「不用这个」，之后同类证据不再累计。关掉只停止继续记，不动已记住的，也不补记关闭期间的对话；「清空画像」只清偏好，不动记忆。

「记忆」页签顶部出现「N 条保存没确认」时，一条保存相近结论的草稿在等决定。先露两条，点「查看全部 N 条」看完整队列；展开给存到哪层、什么时候用、条件、范围清单、触发词、相近条目和完整正文，底部只做「另存」或「忽略」两个动作，不在面板里合并。

「记忆」页签里另有一张「记住我」卡片，默认关闭，和项目记忆、自进化各自独立。开启后只累计表达偏好：先给结论还是先讲背景、讲多细、要不要举例、语气、选项怎么给等八个维度；技术方案、业务判断、参数、权限、发不发这类决定不在其中。卡片头写已记住几条，已形成的每条标出依据条数，点开能逐条看来源（你明确说过 / 多次选择 / 手动改）并删掉单条；删到没依据就退回观察中。观察中的维度可以直接点「不用这个」，之后同类证据不再累计。关掉只停止继续记，不动已记住的，也不补记关闭期间的对话；「清空画像」只清偏好，不动记忆。

会话头的大脑图标打开居中的记忆面板。「记忆」和「自进化」放在顶部，右上角的「显示设置」加两个只影响展示的开关：「图谱」和「记忆宫殿」，默认关闭，按项目记住。「记忆」和「自进化」两个页签放内容。当「记忆」页签出现「N 条保存没确认」时，一条和已有笔记相近的草稿在等决定。先露两行，点「查看全部 N 条」打开完整队列。展开一行显示目标层、什么时候用、条件、范围清单、触发词、相近笔记和完整正文，动作只有「另存」或「忽略」——面板从不自行合并。默认从当前项目开始，也可以切到其他项目或全局层；切过去的范围只读，不迁移、不创建状态。
在 Memories 标签页上，搜索行可在列表、图谱和宫殿之间切换；任一视图都占满内容宽度，正文面板只在选中某条记忆后才出现。在当前项目里，Edit 就地修改记忆的标题和正文，保存时递增修订号；其他项目和全局层保持只读。图谱按真实数据绘制：点记忆节点打开正文，点标签或主题枢纽转为搜索，右上角控件缩放。宫殿按类型把记忆分进四个房间：Habits and conventions、Methods and experience、References and entries、Other notes；一次打开一个房间，每页 24 条，展品只打开正文。宫殿只改呈现方式，绝不动记忆、学习状态或配额。Self-evolution 标签页只作用于当前项目，可按 All / Candidate / Trial / Active / Paused 筛选，同样提供列表和图谱视图。它显示当前规则、范围、状态、证据和变更历史。候选可采纳、编辑或丢弃；试用可采纳、编辑或暂停；生效规则可编辑或暂停；暂停的规则可恢复或查看。

- 关闭项目记忆后，这个项目不再使用任何记忆（包括全局层）：自动注入、检索、读取、引用、保存全部停，服务端也拒绝记忆工具和面板修改动作。自进化同时关闭并禁用；重新打开记忆后自进化仍为关闭，要单独开启。
- 关闭只改权限，不删数据：候选、试用、生效、证据、整理额度和默认绑定都保留，计数照常显示。
- 记忆工具与面板管理动作都在服务端拒绝，不能靠改前端绕过；其他项目不受影响。
- 范围只来自服务端枚举的层；不接受客户端拼路径，也不能写别的项目。
- 图谱只按数据画：每条有效记忆一个节点，共享标签和主题做枢纽，显式关联画实线；自进化图谱只连共用条件。位置由条目自身算出来，同一批数据每次一样。

- 关闭项目记忆会停掉该项目内所有记忆使用，包括全局层：不再注入、搜索、读取、引用或保存，服务端同时拒绝记忆工具和面板修改动作。自进化随之关闭；重新打开记忆后，自进化仍保持关闭，需单独开启。
- 关闭是权限变更，不是删除：候选、试用、生效规则、证据、整理额度和默认绑定都保留，计数照常可见。
- 记忆工具和面板管理动作在服务端被拒绝，改过的客户端也绕不过这个开关；其他项目不受影响。
- 范围只来自服务端给出的列表；页面不能自行拼路径，也不能写别的项目的笔记。
- 图谱只呈现数据：每条有效记忆一个节点，共享标签和主题作枢纽，显式关联画实线；位置由各条目自身推导，同一批数据每次看起来都一样。

为什么轻 / Why it stays light

- 0 依赖，存储层无定时器、无监听、无网络，只有同步单文件写；写入用一把有超时的锁，别的进程正在写就明确报「忙」，不抢别人的锁。
- 搜索最多 4 条、400 字；正文只在 memory_read 里出现，全文永不进上下文。
- 普通检索只列当前有效的记录；已经归档或被更新替换的旧说法不混进来，要查历史得在 memory_search 里显式要 history。
- 上限：单条正文 4096 字节、整库正文 1 MB、每层 1000 条、标题与摘要各 60 字；每层 200 条只当提示线。90 天未用只留标题与版本。到了硬上限不拒绝新记忆：把同层最久没被读的一条移进归档，用户固定过的规则不动，保存结果里写明是哪条（正文与完整记录都留着，可人工取回），单条本身超预算才报错；用户明确说「别记」也进归档。文件从不删除。
- 一个项目一个目录，项目之间互相看不见。

- 零依赖。 存储层没有定时器、没有监听、没有网络——只有同步单文件写，由一把锁守着，锁等 500 ms 拿不到就放弃，不去抢。
- 搜索最多返回 4 条命中、400 个字符。全文只在 memory_read 里出现。
- 普通搜索只列当前条目；归档笔记和被取代的措辞不会出现，除非 memory_search 要求查 history。
- 限制：每条正文 4096 字节，每个存储 1 MB 正文，每层 1000 条，标题或摘要 60 个字符；每层 200 条只是一行警告。到达硬上限时，保存永远不会被拒绝：同一层里最久未被读取的条目移入归档（固定规则永不淘汰），结果里会点名它（正文和完整记录都保留，可手动恢复）；只有单条自身超出预算才会失败。说「别记」也会归档。文件永不删除。
- 每个项目一个目录，所以项目之间永远看不到彼此的笔记。

项目自进化〔实验〕 / Project self-evolution (experimental)

默认关闭，只对当前项目生效。开启后，它从你的纠正和认可里整理出少量项目规范：纠正更新做法，认可作品只给已有规范留一条带维度的样例；执行漏掉只补检查点，不改写成禁令。下次匹配任务按需读取，不逐轮注入。会增加一次有上限的后台整理调用，以及命中的记忆读取消耗。

Off by default, per project only. When enabled it distills a few project rules from your corrections and approvals: corrections revise the approach, approvals attach one bounded sample to an existing rule, and an execution miss adds a checkpoint instead of a ban. Matching tasks read them on demand, never per turn. It adds one bounded background organize call and the memory reads that actually hit.

- 一次整理最多 2 处改动、768 输出 token、15 秒；输入不超过 8 KiB，同一作品最多 2 次，同一项目 24 小时内最多 6 次。
- 成果停在 pending / trial / active / paused；明确说「以后都这样」或两个独立作品支持才 active，试用与暂停 30 天后清理。试用会参与条件匹配任务的读取，不是预览稿；到期自动暂停。
- 规则 32 条、待定 12 条、每规则样例 4 个/检查点 3 个/来源 3 条、旧版本 2 个，都有硬上限；到顶先暂停新学习，不静默丢已生效规则。
- 面板显示整理次数和已知用量；usage 没返回就写未知，不补零。
- 关闭后停止学习、读取和晚到写入；成果保留可查看。记忆总开关关闭时自进化一定也是关闭，不能单独打开。
- 同一项目换栏目、新一期、临时例外不会互相继承；仓库子目录、符号链接、worktree 视为同一项目，不同克隆分开。

- At most 2 changes, 768 output tokens and 15 s per organize call; input ≤ 8 KiB, ≤ 2 calls per episode and ≤ 6 per project in 24 h.
- Results stay pending / trial / active / paused; they become active only on an explicit long-term ask or two independent episodes; trial and paused entries expire after 30 days. A trial is read by matching tasks — it is not a preview — and pauses when it expires.
- Hard caps: 32 rules, 12 pending, 4 samples / 3 checkpoints / 3 sources per rule, 2 old versions. At the ceiling new learning pauses; active explicit rules are never silently dropped.
- The panel reports organize calls and known usage; missing usage is shown as unknown, never zero.
- Turning it off stops learning, reads and late writes; results stay viewable. While project memory is off, self-evolution is necessarily off and cannot be switched on by itself.
- Switching columns, a new episode and one-off exceptions do not leak into each other; a repository subdirectory, symlink or worktree is the same project, separate clones are not.

发布候选 / Release candidate

- 全链路审计结论与轻量化数字：docs/RC-0.18.46.md
- 基准复现：npm run bench、npm run bench:evolution，基线见 docs/BENCH.md

安装

在 Plugin Manager 里搜 dsh-lite-memory 直接装；或 npm pack 后用 Plugin Manager 安装生成的 .tgz。

工具

memory_save · memory_suggest · memory_search · memory_read · memory_forget

完整触发规则见 TRIGGERS.md，内部判定契约（准入顺序、状态码、写入/更新/失败语义）见 docs/CONVENTIONS.md；性能与 UI 门禁的实测数字见 docs/BENCH.md。

License

MIT