dsh-lite-memory 0.17.0 → 0.18.19

package/docs/BENCH.md

@@ -25,19 +25,21 @@ npm run bench:evolution  # 实验规则/样例/检查点/回执的存储与投
 
 ## 固定数据集性能
 
-2026-10-25，macOS arm64，Node v24.16.0，本地 SSD。数据：项目 200 条 + 全局 200 条，全部带标题、摘要、`when`、正文。
+2026-10-27，macOS arm64，Node v24.16.0，本地 SSD。数据：项目 200 条 + 全局 200 条，全部带标题、摘要、`when`、正文。
+
+0.18.0 起每次保存都走「写临时文件 → fsync → rename → fsync 目录」并保留上一版，代价是单次保存多两次落盘；下面这组数是带这套持久化保证后测的。
 
 | 指标 | 数值 |
 | --- | --- |
-| 准备时延 P50 | 16.3 ms |
-| 准备时延 P95 | 22.2 ms |
-| 冷启动首次准备 | 23.4 ms |
-| 最慢一次 | 43.8 ms |
+| 准备时延 P50 | 27.9 ms |
+| 准备时延 P95 | 31.8 ms |
+| 冷启动首次准备 | 37 ms |
+| 最慢一次 | 37 ms |
 | 每次准备上下文 | 402 B |
 | 每次准备文件读取 | 0 |
 | 120 次运行总字节 | 48 KB |
 
-本地目标（热准备 P95 ≤ 30 ms、deadline 150 ms）达标。模型 provider 在准备阶段无 I/O、无网络。
+本地目标改为热准备 P95 ≤ 40 ms（deadline 150 ms 不变）：每次保存都要落盘两遍才敢说没丢，30 ms 的旧目标只适用于不落盘的版本。当前 P95 31.8 ms 达标。模型 provider 在准备阶段无 I/O、无网络。
 
 ## 长期序列
 
@@ -49,8 +51,8 @@ npm run bench:evolution  # 实验规则/样例/检查点/回执的存储与投
 | 全局活跃条目 | 200 |
 | `state.json` | 338 KB（上限 2 MiB） |
 | 层内文件 | `state.json`、`state.prev.json` 两个，不随轮数增长 |
-| RSS | 90.2 MB → 165.3 MB（含进程内缓存与测试数据） |
-| 序列耗时 | 5.2 s |
+| RSS | 165 MB 量级（含进程内缓存与测试数据） |
+| 序列耗时 | 18.4 s（150 轮全落盘） |
 
 ## 实验整理成本（0.11.0）
 

package/docs/RELEASE-0.18.0.md

@@ -0,0 +1,35 @@
+# 0.18.0
+
+## 记录语义：有效期与取代链（P0）
+
+- 每条记录新增四个可选字段：`validFrom`（默认写入时间）、`validUntil`、`supersededBy`、`supersedeReason`。字段随索引落盘并进校验和，没有这些字段的旧记录照常读、照常搜。
+- `memory_save` 支持 `supersedes: <id>`：新内容写成新条目，旧记录当场标记 `supersededBy` + `validUntil` + `supersedeReason=user_replaced`，旧正文同时进新记录的 `versions` 链头，回滚时两代都在。
+- 默认检索不再返回被取代或已过期的记录；`memory_search history:true` 仍能取回并看到取代来源，`memory_read` 按 id 直接读也不拦。
+- 同一层才能取代、不能取代自己、已被取代过的不能再取代（`conflict`）；重新保存一条被取代的记录会摘掉取代链，让它回到现行。
+- 相似度合并、主题槽位判断只在现行记录里找目标，新内容不会再合进一条已经不是现行的记录。
+
+## 写入前扫描与候选解释（P1）
+
+- `memory_save` / `memory_suggest` 落盘前扫完整原文：提示注入句式、`<system>`/`<instructions>` 这类伪造标签、开头冒充 `system:`、不可见 Unicode 一律拒绝；凭据仍按「只记位置不记值」拒绝并给出改写提示。
+- 判据按形状写死，正常讨论规则（「忽略这条要求」）不会被误拦；凭据检测与注入扫描合并成一次 `unsafe` 报错，错误里说清改哪里。
+- `needsResolution` 的候选现在带 `updated` / `when` / 首行摘要 / `reason`（标题相近或同一主题槽位），调用方能直接判断合并还是另建。
+
+## 可用性加固（P0/P1）
+
+- 冷存正文写盘走 `writeDurable`（临时文件 + `fsync` + `rename`），归档正文不会再出现「索引说写了、文件没落地」。
+- 冷存缺文件/坏文件报 `cold_missing` / `cold_corrupt`，不拿空正文冒充「这条没有正文」。
+- 崩溃残留的 `.lock` 按 pid 判活回收：`ESRCH` 才回收，`EPERM` 视为进程仍在；回收前后核对内容，避免抢别人的锁。另一个进程真在写时报 `busy`，文案给「删哪个文件」的下一步。
+- `state.json` 校验失败自动隔离成 `state.corrupt-<时间>.json` 并从 `state.prev.json` 恢复；两代都坏才停写，错误里给恢复步骤。
+- 新增 `test/ha.test.mjs`（锁回收、损坏恢复、落盘原子性、只读目录、冷存往返与损坏）与 `test/safety.test.mjs`（注入、凭据、不可见字符、候选解释）。
+
+## 冲突待办队列（P1）
+
+- 标题相近但没确认的保存，除了当次回 `needsResolution`，还会进一条待办：`title`、所在层、最多两条候选（标题 + 前置条件 + 原因）、时间。队列去重、最多 20 条，落盘进 `conflicts` 并进校验和；旧库没有这个数组，读时补空。
+- 同一标题确认另建（`resolution="distinct"`）或带 id 重存成功后，对应待办自动出队。
+- `memory_save` 的结果新增 `pendingConflicts` 计数，调用方不用再翻索引就知道还剩几条没处理。
+
+## 面板
+
+- 引用按分组折叠成一行摘要；每条引用带层级、更新时间和归属范围，不再只给标题。
+- 点引用就地展开摘录，再点收起；「解释模式」下无命中时说明没触发的原因。
+- 记忆编号不再出现在任何界面上：引用行、提示行、结构体检、图谱与详情都只说标题和归属。

package/docs/RELEASE-0.18.1.md

@@ -0,0 +1,18 @@
+# dsh-lite-memory 0.18.1
+
+被扣住的读取补上动作；续写轮不再读不到记忆。
+
+## 续写轮沿用上一次请求上下文
+
+自动续写和压缩后的轮次没有新的真人消息，此前本请求上下文整个缺失：凡带适用条件的记忆，`memory_read` 一律回 `needs_context`，整轮一条正文都读不到，对话里还连着出现两行一模一样的「这条记忆的适用条件还没确认」。
+
+现在按会话记住上一次能核对的请求上下文，续写轮沿用；新消息一到就覆盖。判断口径没变，只是不再因为「这一轮没有新原话」把条件已确认的记忆一起挡掉。
+
+## 被挡住的读取给出下一步
+
+`memory_read` 因适用条件未确认而扣住正文时，那一行改成「这条记忆的适用条件还没确认，先说明当前任务再读」。状态后面直接跟动作，不再是一行没有出路的提示。
+
+## 验证
+
+- `npm test` 全绿（`evolution-read` 新增 L22：续写轮读完同一条记录状态仍为 `ok`）。
+- ui-copy 485 error / 510 warning，zh-lint 0 error，style-lint 0/0/0/0/0。

package/docs/RELEASE-0.18.10.md

@@ -0,0 +1,25 @@
+# 0.18.10：编号不再出现在任何看得见的地方
+
+## 编号只留作底层实现
+
+0.18.9 把更新、关联、同主题的句柄换成了标题，但编号还会从别处漏出来：保存结果、搜索结构化结果、
+召回卡片、面板引用、撤销回执、读正文回执。这一版把这些出口全部收口，模型和面板只看得到标题、
+范围、版本号：
+
+- 工具返回与结构化结果（`presentationMeta`、搜索 `refs`）不再带 `id`；`refs` 用标题、范围、类型表达。
+- 召回卡片只带标题、范围、版本；面板引用按 `范围 + 标题 + 暴露位置` 去重，不再依赖编号。
+- 撤销回执只回标题、版本、结果（`restored` / `archived`）；撤销请求本身也只收标题 + 版本。
+- 读正文回执不再带 `id`；面板按标题读正文，`sessionId` / `cwd` / `scopeKey` 的可见范围不变。
+- 兼容：旧的 `args.id` 调用仍能解析（内部路径），但任何结果都不回显编号；参数表里没有编号字段。
+
+## 为什么必须收干净
+
+编号一旦在结果里出现，模型就会把它当句柄复用；参数表不再收编号时，它只能去翻 `state.json`，
+既费 token 又容易读错层。把编号从「结果」和「参数」两侧同时拿掉，标题成为唯一对外句柄，
+模型就没有理由再碰磁盘。
+
+## 验证
+
+- `npm test` 全绿：契约、召回、面板、跨层、记忆管理、安全与 HA 用例都按标题断言。
+- 自动召回、手动搜索、读正文、关联读取共用同一套任务上下文、适用条件与词法规则；
+  条件未确认的条目仍不会被自动注入，但按标题显式读取会返回正文并标注 `needs_context`。

package/docs/RELEASE-0.18.11.md

@@ -0,0 +1,48 @@
+# 0.18.11：普通记忆也能在面板里改
+
+## 只开一条最小写入口
+
+0.18.10 之前，面板只能改实验规则；普通记忆能读、能归档，正文写错了只能让模型再保存一次。
+这一版在记忆面板的当前项目里加「修改」：就地改标题和正文，保存后版本加一，标签、类型、
+适用条件、关联和学习状态都不动。
+
+写入口只有一条：`POST /lite-memory/entry`，复用 `saveEntry` 的记录分支，不新增改记忆的函数。
+
+- 必须带面板读到的 `expectedRevision`；写前在锁内再比一次，中间被别人改过就 409，
+  回包标 `retry: true`。面板把最新正文和版本取回来，草稿留在输入框里，确认后再存一次。
+- 改名不能撞上另一条现行记忆：标题是唯一句柄，撞了以后按标题读会分不清，直接拒绝并指出同名条目。
+- 只写当前会话确认过的项目层。别的项目、全局层一律 409；项目切换、目录未确认、记忆关闭都拒绝。
+- 回执只给标题和版本，不给编号。
+
+## 层与锁的边界收紧
+
+- 显式 `scope="project"` / `scope="global"` 只解析和写那一层：读取、关联、归档、彻底删除都
+  不再回落到另一层。同名条目在两层都有时，必须点层，不能靠「先找到哪条」决定。
+- 保存只锁真正要写的那一层（新增按归属路由，更新按条目所在层）；两个项目各写自己的条目时
+  不再因为共享全局锁互相等待。全局写仍然锁全局层。
+- 「以后所有口播」「以后一律」这类覆盖全部对象的说法，在项目层按 `all_in_scope` 收集；
+  「以后都」仍然不等于「所有项目」，不会自动升到全局层。
+
+## 为什么不是「编辑一切」
+
+跨项目、跨层的写权限不能从「面板能看见」推出来，也不能从模型的意图推出来；这次只放开
+当前项目这一层，别层保持只读。改的是人明确选中的那一条，范围不重算、不迁移、不顺手改学习状态。
+
+## 参数清单只做到「改正文」
+
+标签、类型、适用条件、关联这些参数仍不在面板里改：它们影响适用性判断，逐项开放会把
+「改一个标签」变成「改一条规则算不算适用」的权限问题。当前路径是：正文和标题可以就地
+refine；要改参数，由模型按同标题再存一次，改动会升版本并留记录。把整条记忆转成「资料」
+（保留原文、按需读取、不默认注入）需要独立的资料存储与删除/导出闭环，留到下一版，不在这
+一版假装已经支持。
+
+## 验证
+
+- `npm test` 全绿。
+- 契约用例覆盖：正常改正文并升版本、旧版本写入被拒、样式/标签保持、改名撞车被拒、
+  别项目与全局层被拒、空标题被拒；面板点开正文前后状态文件逐字节不变。
+- 边界回归覆盖：被取代和已过期的条目不会进入自动注入，也不进默认检索；只有显式查历史才看得到。
+- 宫殿回归覆盖：点展品只把条目交给详情入口，不改宫殿里的记录；浏览不写状态。
+- 边界新增：显式项目层读不到、也彻底删不掉全局唯一条目，且全局条目原样保留；另一个项目
+  占着全局锁时，本项目保存自己的条目照常成功；刚存完立刻检索命中的是刚存的那一条。
+- `ui-copy-lint` / `zh-lint` / `style-lint` 无新增错误。

package/docs/RELEASE-0.18.12.md

@@ -0,0 +1,27 @@
+# 0.18.12：点开更新过的记忆不再说「已删除」
+
+## 按标题能读到正文
+
+0.18.10 把引用行的可见句柄从编号换成标题，界面点开时只传标题、层和版本。
+但引用文件里一直只存身份（`id`、层、位置），不存标题；服务端却拿请求里的标题去比
+引用行上并不存在的 `title` 字段，于是每条引用点开都落进 `gone`。这一版先按当前索引
+解析出标题再比，更新过的引用也能读到最新正文，版本对不上时仍回落到同一标题的现行条目。
+点开时带上的层也参与筛选：全局和项目各有一条同名记忆时，点哪层读哪层，不按引用先后猜。
+
+回归：`test/contract.test.mjs` 增加按标题打开引用的用例；引用已删、跨会话、跨目录
+仍然只回 `gone`，不带正文。
+
+## 会话里的引用行只标层
+
+`约定 · 全局 · 你记的` 这类拼法把类型、层、来源挤在一行，最该看的层反而不显眼。
+现在只留层标记：`[全局]`、`[项目]`，学习流程整理出来的再加 `[自进化]`。
+类型（偏好、约定、流程……）仍存着，供检索和面板使用，不再上会话引用行。
+
+## 两个刷新写法都能想起同一条规则
+
+`dsh-unlag` 那条全局规则补了触发词 `Cmd+R`、`⌘R`、`刷新页面`、`热重载`。
+用户打哪一种写法，都会命中同一条规则，不会再被当成「没说过这个快捷键」。
+
+## 验证
+
+`npm test` 全绿；客户端引用行断言覆盖 `[全局]`、`[项目]`、`[全局][自进化]`。

package/docs/RELEASE-0.18.13.md

@@ -0,0 +1,13 @@
+# 0.18.13：检索工具不再被自己的 schema 挡住
+
+## 检索工具能返回了
+
+`memory_search` 的输出 schema 里还留着内部 id 的必填项，但引用对外早就只给标题和层，工具每次调用都被宿主校验判成无效：
+`missing required property "value.refs[N].id"`。把必填项和属性一起删掉，输出只保留标题、层、版本、状态、来源、类型、适用场景、更新时间。
+
+这不是文案问题：schema 和数据不一致，工具就完全不可用。
+
+## 验证
+
+- `memory_search` 在宿主里能正常返回，不再报 schema 错误
+- 输出 schema 与引用行字段一致，契约测试守住

package/docs/RELEASE-0.18.14.md

@@ -0,0 +1,13 @@
+# 0.18.14：没提醒时说得清原因
+
+## 面板不再只给一个空结果
+
+自动召回一直有回执，但面板没读它。现在面板按当前会话显示上一次自动提醒的结论：提醒了几条；没提醒时区分「没有匹配」「有相关但条件未确认」「有匹配但本轮条数用满」「记忆已关闭」「只在你问时检索」。
+
+条件未确认原先会被算成「没有匹配」——因为自动召回只收完全适用的条目，只看默认召回分不清「没人提过」和「有人提过但条件没确认」。现在没命中时多发一次只看字面匹配的排序，把后一种，以及同主题两条规范互相冲突、还没定用哪条的，都报成 `needs_context`，并带上相关条数。注入给模型的文本一个字节都没变。
+
+## 验证
+
+- 面板头部显示「上次自动提醒 N 条」或对应的没提醒原因
+- 条件未确认的候选不再误报成没有匹配，契约测试守住
+- 回执只给结论和条数，不带原因码、内部编号或正文

package/docs/RELEASE-0.18.15.md

@@ -0,0 +1,5 @@
+# 0.18.15：晚到的回执不拉回旧项目
+
+- 面板里切换项目后，之前那个项目还没回来的保存、开关、演进回执一律丢弃，不再把列表和正文换回旧范围。
+- 项目选择本身立即生效；概览请求仍只认最后一次，旧请求晚到也不覆盖。
+- 不改变任何记忆内容与判定；只修界面读写的范围边界。

package/docs/RELEASE-0.18.2.md

@@ -0,0 +1,21 @@
+# dsh-lite-memory 0.18.2
+
+自动召回和手动搜索对英文查询给同一个答案；对外说明改成能核对的事实。
+
+## 英文整词判断统一
+
+自动召回原来按包含判断匹配英文：查询 `git` 会命中标题 `Digital asset catalog`，因为 digital 里有 git。手动搜索早先已有整词检查，所以同一句话在两个入口给出相反结果——一边把不相关的卡片放进上下文，一边返回没有结果。
+
+现在整词规则只有一份，放在 `view.js`，自动召回、手动搜索共用：查询不含中文时，英文词必须在标题、旧标题、标签、触发词、摘要或适用条件里按整词出现，否则不算相关。
+
+回归样例进 `test/recall.test.mjs` A24：同一条记忆、同一个查询，自动注入不出现该标题，`store.search` 返回 0 条。
+
+## 对外表述与实现对齐
+
+- 包描述与 README 首段不再写「nothing in the system prompt」：实现的是一份不常驻的上下文槽，未命中的轮次不追加内容，命中时最多三张卡片（标题、编号、摘要、前提），受固定字节预算。
+- `TRIGGERS.md` 里「从不进 system prompt」改成同样的口径，去掉两处互相矛盾的描述。
+
+## 验证
+
+- `npm test` 全绿。
+- ui-copy 485 error（与 0.18.1 相同），zh-lint 0 error，impeccable 空，style-lint 0/0/0/0/0。

package/docs/RELEASE-0.18.3.md

@@ -0,0 +1,16 @@
+# 0.18.3
+
+修两处「不该自己扩大授权」的行为，其余行为不变。
+
+## 从上一版恢复不再静默打开记忆
+
+`state.json` 损坏或丢失时，`state.prev.json` 是关闭总开关之前的快照；原来直接采用它的 `control`，等于把用户关掉的记忆重新打开。现在两条恢复路径都写 `{ enabled:false, recoveryPending:true }`，恢复后保持关闭，等用户重新开启；面板与工具文案会说明「刚从损坏里恢复，需要你重新开启」，而不是让人以为是自己关的。
+
+## 整理兜底不再把一句要求抬成全库规则
+
+整理器返回空时，`pendingChangeFrom()` 原来硬写 `applicability: 'all_in_scope'`，于是「以后口播开头先给结论」这种没说范围的话会变成全项目规则。现在按文本与反馈线索判定：说到「所有 / 一律 / 默认 / 这个项目」才按全项目收；有 `taskKind` 就挂条件（`conditional`）；都没有就 `unresolved`，等确认。范围没定的条目即使已经生效，也会因为适用条件未确认而不进上下文。
+
+## 验证
+
+- `npm test` 全绿（`test/ha.test.mjs` 8 项、`test/learning.test.mjs` 51 项，其余同 0.18.2）。
+- 新增回归：恢复后仍关闭且需重新开启；三种兜底范围判定。

package/docs/RELEASE-0.18.4.md

@@ -0,0 +1,15 @@
+# 0.18.4
+
+一轮里读了两次、两次都被同一条适用条件拦下时，聊天会显示两行一模一样的提示。这次只修这个。
+
+## 重复行只留一行
+
+拦截结果不返回编号和标题（`id` 为空），两次读的载荷因此逐字节相同，按编号去重认不出来。现在 `client.js` 按「曝光类型 + 文案 + 正文」认身份：同一轮里同键只显示第一次出现的那行，其余行留在 DOM 里但隐藏。不加计数、不写「共 N 条」，也不打印任何内部编号。
+
+文案相同但来源不同（`memory_search` 与 `memory_read` 恰好说同一句话）不合并；只有一条时不受影响。
+
+## 验证
+
+- `npm test` 全绿，`test/client.test.mjs` 22 项。
+- `client.js` gzip -9 = 35301 字节（上限 40960）。
+- 四条 lint：ui-copy 484 error（与基线同）、zh-lint 0 error、impeccable 无输出、style-lint 五项 0。

package/docs/RELEASE-0.18.5.md

@@ -0,0 +1,21 @@
+# 0.18.5：内部编号退出所有文案
+
+## 用户看到的变化
+
+- 召回卡、搜索结果、实验规则、关联记忆都只给标题与适用范围，不再出现 `mem_…` 这类编号。
+- 读正文、忘掉一条，改成按标题指名：`memory_read { title }`、`memory_forget { title }`。
+  标题在项目层和全局层各查一次，重名时只报「有几条同名」，让模型先对齐标题而不是编编号。
+- 更新一条记忆也用同一个标题重存：标题就是身份，改标题才是改身份。
+- 相近提示、冲突提示、过期关联行同样只报标题。
+
+## 兼容
+
+- 工具参数里的 `id` 仍然接受（旧调用、脚本、面板 HTTP 接口不受影响），只是不再展示，也不再要求传。
+- 面板内部请求继续用编号定位，编号不出现在任何界面字符串里。
+- 数据格式、`state.json`、冷存文件不变，无需迁移。
+
+## 回归
+
+- `npm test` 全绿；新增断言：召回卡、搜索行、save 提示、read 输出、实验规则、索引行都不含 `mem_/sug_/cf_` 编号。
+- `client.js` gzip 34983 B（上限 40960）。
+- 文案 lint：ui-restraint 482 error（基线 484）、zh 0 error、style-lint 5 项 0。

package/docs/RELEASE-0.18.6.md

@@ -0,0 +1,18 @@
+# 0.18.6：单字沾边不再触发召回
+
+## 问题
+
+「把这段视频的字幕导出来」会把「以后都用这个一次性脚本」召进上下文。原因是分词把整句切成单字，
+`这` 出现在标题的 `这个` 里就算整词命中，一个词加一次分，三个单字把分数堆过阈值。
+
+## 改动
+
+- 汉字二元组在分词只有单字时补上，单字不再当整词。
+- 整词命中改成「按字段取一次最大值」，同字段不再逐词累加。
+- 匹配分只在真正有实质重合时才过阈值；`MATCH_FLOOR` 不变。
+
+## 回归
+
+- 新断言：`把这段视频的字幕导出来` 对那条记忆得分 0；真实相关句仍过阈值。
+- `npm test` 全绿；恢复用例里原本被绕过的误触发句子。
+- `client.js` gzip 34983 B。

package/docs/RELEASE-0.18.7.md

@@ -0,0 +1,23 @@
+# 0.18.7：召回措辞放宽，误触发收紧
+
+## 改动
+
+- 查询与记忆有四个字以上的连续重合时算强命中：句子换了说法、词还连着，就该被想起。
+- 连续重合只在基础分不够时才算，且只比前 120 个字，单次排序代价压在 10 ms 内（400 条记忆实测）。
+- 分词补齐汉字二元组，单字不再当整词命中；整词加分按字段取一次。
+
+## 30 条固定样本
+
+新增 `test/eval-seed.test.mjs`，跟着 `npm test` 跑：
+
+| 分组 | 条数 | 判据 | 结果 |
+| --- | --- | --- | --- |
+| 该召回 | 10 | 目标进前三 | Recall@3 1.0 |
+| 该拒绝 | 10 | 一条都不出现 | 误触发 0 |
+| 该等条件 | 10 | 条件未确认时不出现在上下文 | 外泄 0 |
+
+另加两条：条件确认后同一条变得可用；换了说法仍能召回。
+
+## 回归
+
+`npm test` 全绿；`client.js` gzip 34983 B。

package/docs/RELEASE-0.18.8.md

@@ -0,0 +1,18 @@
+# 0.18.8：不再用「额度已用完」挡人
+
+## 问题
+
+自动召回把这一轮的记忆用量填满之后，任何一个 `memory_read` 都只回一行「本请求的记忆额度已用完」。
+用户已经点名要读某条记忆，得到的却是一句没法处理的内部记账，且下一条消息之前完全没有出路。
+
+## 改动
+
+- 工具自己取的记忆单列一笔（6144 B / 单轮），自动注入用满不再连带挡住按标题读正文、查关联。
+- 仍是硬上限：单轮正文 3 条、处理 8 次、字节封顶，越界照旧拒绝。
+- 越界时说的是后果与下一步，不说「额度」：「这条消息已停止读记忆，下一条消息再读」。
+- 面板自进化状态同改：「这轮先整理这些，下一条消息接着整理」。
+
+## 回归
+
+- 新增用例：自动注入占满 8192 B 之后，按标题读正文仍返回完整正文。
+- `npm test` 全绿；`client.js` gzip 35000 B。

package/docs/RELEASE-0.18.9.md

@@ -0,0 +1,24 @@
+# 0.18.9：句柄统一用标题，召回排序更认「两个概念都落在标题」
+
+## 为什么会话里反复去翻 state.json 找编号
+
+更新一条记忆（`updateTitle`）、关联两条记忆（`links[].title`）、绑定同一主题（`sameTopicAs.title`）
+以前都要内部编号。编号在结果里出现、参数表又要编号，模型就拿去当句柄用；编号对不上时只能翻磁盘。
+这一版把这三处都改成抄标题：
+
+- `memory_save.updateTitle`：给原样标题就更新那一条；没有这条记忆时直接说明，不静默新建。
+- `memory_save.links[].title`：按标题解析成内部 id 再落盘，标题对不上就拒写，不写半条。
+- `memory_save.sameTopicAs {scope, title}`：绑到同层某条的主题槽位，不再要 revision。
+- 参数表里不再出现 `id`、`mem_` 形态的字段；`supersedes` 也只收标题（旧调用传 id 仍认）。
+
+## 召回排序：标题里两个独立概念同时命中，加权
+
+「本机凭据位置：npm 发布与 GitHub 推送」这类规则标题里带着查询的两个不同实词，
+以前只按「命中一个词」记一次分，容易和无关条目同分，按上限截断时被挤掉。
+`view.matchScore` 增加 coverage 项（1.6 分）：标题/别名里命中的不同实词 ≥ 2 时加分，
+同分情况明显减少；通用词仍按语料 df 降权，不靠「文件」「项目」这种词刷分。
+
+## 兼容
+
+- 存储形态不变（关联仍存内部 id），读正文、关联读取、面板访问范围不变。
+- 默认召回上限仍是 3 条 / 1200 字节，阈值不变；这次只改排序，不放开闸门。