dsh-lite-memory 0.18.39 → 0.18.41

package/client.js

@@ -1006,6 +1006,8 @@ window.__ModuleLoader__.load({
       });
       return counts;
     };
+    /** 真被用过才算读过：`lastUsed` 有创建时间回退值。 */
+    const usedOf = (record) => (record && record.used !== undefined ? record.used === true : Boolean(record && record.lastUsed));
     /** 标签/话题按精确值筛选；只有自由搜索才用包含匹配。 */
     const filterRecords = (records, query, hub) => {
       const rows = Array.isArray(records) ? records : EMPTY;
@@ -1020,7 +1022,7 @@ window.__ModuleLoader__.load({
       if (kind === 'duplicate' || kind === 'unread' || kind === 'noWhen') {
         const counts = titleCountsOf(rows);
         return rows.filter((record) => {
-          if (kind === 'unread') return !record.lastUsed;
+          if (kind === 'unread') return !usedOf(record);
           if (kind === 'noWhen') return !record.when;
           const title = typeof record.title === 'string' ? record.title.trim() : '';
           return Boolean(title) && counts.get(title) > 1;
@@ -1043,7 +1045,7 @@ window.__ModuleLoader__.load({
       const globalRow = (Array.isArray(scopes) ? scopes : EMPTY).find((scope) => scope && scope.kind === 'global');
       return {
         duplicate,
-        unread: rows.filter((record) => !record.lastUsed).length,
+        unread: rows.filter((record) => !usedOf(record)).length,
         globalEntries: globalRow && Number.isInteger(globalRow.entries) ? globalRow.entries : null,
         globalMissingWhen: globalSelected ? rows.filter((record) => !record.when).length : null,
       };

package/docs/BENCH.md

@@ -25,22 +25,22 @@ npm run bench:evolution  # 实验规则/样例/检查点/回执的存储与投
 
 ## 固定数据集性能
 
-2026-10-29，macOS arm64，Node v24.16.0，本地 SSD。数据：项目 200 条 + 全局 200 条，全部带标题、摘要、`when`、正文；另加一条正面场景，确认全局卡片真的进得来且不超预算。0.18.38 版含跨层搬移后的复测。
+2026-10-29，macOS arm64，Node v24.16.0，本地 SSD。数据：项目 200 条 + 全局 200 条，全部带标题、摘要、`when`、正文；另加一条正面场景，确认全局卡片真的进得来且不超预算。0.18.40 版复测（两次取稳定的一次）。
 
 0.18.0 起每次保存都走「写临时文件 → fsync → rename → fsync 目录」并保留上一版，代价是单次保存多两次落盘；下面这组数是带这套持久化保证后测的。
 
 | 指标 | 数值 |
 | --- | --- |
-| 准备时延 P50 | 51.4 ms |
-| 准备时延 P95 | 59.4 ms |
-| 冷启动首次准备 | 76.5 ms |
-| 最慢一次 | 76.5 ms |
+| 准备时延 P50 | 48.6 ms |
+| 准备时延 P95 | 51.4 ms |
+| 冷启动首次准备 | 69.6 ms |
+| 最慢一次 | 69.6 ms |
 | 每次准备上下文 | 368 B |
 | 正面场景上下文 | 335 B，含 1 张全局卡片，未超 3 条 / 1200 字节 |
 | 每次准备文件读取 | 0.2 |
 | 本次数据规模 | 项目 200 条 + 全局 200 条 |
 
-数据翻倍到两层各 200 条后仍在 deadline 150 ms 内：0.18.38 复测 P95 59.4 ms。模型 provider 在准备阶段无 I/O、无网络。
+数据翻倍到两层各 200 条后仍在 deadline 150 ms 内：0.18.40 复测 P95 51.4 ms。模型 provider 在准备阶段无 I/O、无网络。
 
 ## 长期序列
 
@@ -52,7 +52,7 @@ npm run bench:evolution  # 实验规则/样例/检查点/回执的存储与投
 | 全局活跃条目 | 200 |
 | `state.json` | 396 KB（上限 2 MiB） |
 | 层内文件 | `state.json`、`state.prev.json` 两个，不随轮数增长 |
-| RSS | 219 MB（含进程内缓存与测试数据） |
+| RSS | 315 MB（含进程内缓存与测试数据；两次 301/315 MB） |
 | 序列耗时 | 5.8 s（150 轮全落盘） |
 
 ## 实验整理成本（0.11.0）

package/docs/RELEASE-0.18.40.md

@@ -0,0 +1,13 @@
+# 0.18.40
+
+## 更新句柄也能拿到相近完整标题
+
+`memory_save` 用 `updateTitle` 改一条记忆时，如果传的是缩短过的标题，以前只回「没有这条记忆」；现在和 `memory_read` / `memory_search` 一致，在报错里列出最多 3 条相近的完整标题，模型可以一次改对。
+
+- 只影响失败路径：成功写入的流程、工具描述和常驻字节不变（13375 字节）。
+- 不会模糊读取或模糊改写：仍要求完整标题或 id。
+- 回归：`test/contract.test.mjs` 断言缩短标题的更新请求报出完整标题，且不出现 `undefined`。
+
+## 使用记账回归
+
+`test/recall.test.mjs` 新增用例：没有送达模型的回合结束后，条目的 `lastUsed` 不变；真正送达到卡片的回合收尾时才回写。防止以后改动把「检索过」误记为「用过」。

package/docs/RELEASE-0.18.41.md

@@ -0,0 +1,26 @@
+# 0.18.41：把「从未读过」变成真话
+
+## 问题
+
+面板「结构体检」里的「从未读过」和筛选器按 `lastUsed` 是否为空判断。但 `lastUsed`
+在新建、编辑时都会写入回退值，于是这个数字恒为 0，筛选也永远筛不出东西——一条从没被
+召回过的记忆看起来像读过。
+
+## 改法
+
+- 记录新增 `everUsed`：只有真正送达模型并完成使用记账（`touchUsed`）才置真；
+  第一次被用到时即使还在 `lastUsed` 的十分钟防抖窗口内，也只补标记、不额外落盘。
+- 旧数据没有这个标记，用时间戳差异回填：`lastUsed` 与创建/更新时间都不同才算用过，
+  因此升级后「从未读过」直接可信，不需要迁移脚本。
+- 面板记录多带一个 `used` 布尔值；筛选项与体检计数都改看它，`lastUsed` 只继续用于
+  陈旧度排序。界面文案不变。
+- 没有新增常驻提示、没有改召回顺序、没有增加单次注入字节。
+
+## 验证
+
+- `test/recall.test.mjs`：新建条目 `used === false`；同一回合送达后变 `true`，
+  且未送达的回合不变。
+- `test/client.test.mjs`：带 `lastUsed` 回退值但 `used === false` 的条目仍计入
+  「从未读过」，`used === true` 的排除。
+- 全量 `npm test` 通过；三次基准 P50 67–69 ms，发生在系统负载 8.6 的机器上，
+  与 0.18.40 的 48.6 ms 差异来自负载，上下文字节仍为 368 B。

package/index.js

@@ -476,6 +476,7 @@ function keepHandler(webServer, cwdForSession) {
         origin: originOut(record.origin),
         updated: record.updated || '',
         lastUsed: record.lastUsed || '',
+        used: record.used === true,
         bytes: Number(record.bytes) || 0,
         experimental: isExperimentalRecord(record),
         learning: record.learning ? {
@@ -2094,7 +2095,13 @@ export function apply(ctx, config) {
         }
         const layer = args.scope === 'global' ? 'global' : args.scope === 'project' ? 'project' : '';
         const picked = layer ? candidates.find((row) => row.scope === layer) : candidates[0];
-        if (!picked) return saveFailure(`没有「${updateTitle}」这条记忆；要新增就不用 updateTitle`, args);
+        if (!picked) {
+          const near = nearTitleHints(runtimeLayers(projectScope), updateTitle);
+          if (near.length) {
+            return saveFailure(`没有「${updateTitle}」这条记忆。相近的里有：${near.map((item) => `「${item}」`).join('、')}；要新增就不用 updateTitle`, args);
+          }
+          return saveFailure(`没有「${updateTitle}」这条记忆；要新增就不用 updateTitle`, args);
+        }
         draft.id = picked.id;
       }
       /** 关联目标同样按标题解析成内部 id 再落盘。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lite-memory",
-  "version": "0.18.39",
+  "version": "0.18.41",
   "description": "On-demand memory for the DeepSeek Harness: nothing resident, at most three small cards on a real hit, bodies read on demand.",
   "type": "module",
   "main": "index.js",

package/store.js

@@ -115,6 +115,9 @@ function toFlat(entry) {
     supersededBy: typeof entry.supersededBy === 'string' ? entry.supersededBy : '',
     supersedeReason: typeof entry.supersedeReason === 'string' ? entry.supersedeReason : '',
     lastUsed: maintenance.lastUsed || entry.updatedAt || entry.createdAt || '',
+    /** 是否真被用过（送达模型并记账过）；`lastUsed` 有创建/更新时间回退值，不能拿它判断「从未读过」。 */
+    used: maintenance.everUsed === true
+      || Boolean(maintenance.lastUsed && maintenance.lastUsed !== entry.createdAt && maintenance.lastUsed !== entry.updatedAt),
     revision: Number(entry.revision) || 1,
     status: entry.status === 'archived' ? 'archived' : 'active',
     origin: ORIGINS.includes(entry.origin) ? entry.origin : 'user_explicit',
@@ -172,6 +175,7 @@ function fromFlat(record, status) {
       learning: cloneJson(record.learning) || cloneJson(record.maintenance?.learning) || undefined,
       hits: Number(record.hits) || 0,
       merges: Number(record.merges) || 0,
+      everUsed: record.everUsed === true || (record.maintenance && record.maintenance.everUsed === true),
       lastUsed: record.lastUsed || at,
     },
   };
@@ -1519,7 +1523,13 @@ function touchUsed(scope, ids) {
       const stamp = new Date(now).toISOString();
       let changed = false;
       for (const record of index.entries) {
-        if (!wanted.has(record.id) || !usedStale(record, now)) continue;
+        if (!wanted.has(record.id)) continue;
+        if (record.everUsed !== true) {
+          /** 第一次被真用到必须记下来，哪怕刚创建、还没过 lastUsed 的防抖门槛。 */
+          record.everUsed = true;
+          changed = true;
+        }
+        if (!usedStale(record, now)) continue;
         record.lastUsed = stamp;
         changed = true;
       }

package/test/client.test.mjs

@@ -339,6 +339,8 @@ assert.deepEqual(checkupOf(checkupRows, checkupScopes, false), { duplicate: 1, u
 assert.deepEqual(checkupOf(checkupRows, checkupScopes, true), { duplicate: 1, unread: 1, globalEntries: 213, globalMissingWhen: 1 });
 assert.deepEqual(filterRecords(checkupRows, '', { kind: 'duplicate' }).map((row) => row.id), ['mem_c0000001', 'mem_c0000002']);
 assert.deepEqual(filterRecords(checkupRows, '', { kind: 'unread' }).map((row) => row.id), ['mem_c0000001']);
+assert.deepEqual(filterRecords([{ id: 'mem_u1', title: '新写的', lastUsed: '2026-01-01T00:00:00.000Z', used: false }], '', { kind: 'unread' }).map((row) => row.id), ['mem_u1'], '有创建时间回退值但没真用过，仍算从未读过');
+assert.equal(checkupOf([{ id: 'mem_u2', title: '用过的', lastUsed: '2026-01-01T00:00:00.000Z', used: true }], [], false).unread, 0);
 assert.deepEqual(filterRecords(checkupRows, '', { kind: 'noWhen' }).map((row) => row.id), ['mem_c0000001']);
 assert.deepEqual([...titleCountsOf(checkupRows).values()], [2, 1]);
 assert.equal(checkupOf([], [], false).globalEntries, null);

package/test/contract.test.mjs

@@ -295,6 +295,11 @@ await assert.rejects(
 );
 const hintedRead = await exec('memory_read', { title: '生效验证顺序（含：桌面端没有 Cmd+R）' });
 assert.equal(hintedRead.body, '正文');
+const hintedUpdate = await exec('memory_save', { title: '缩短标题的探针', summary: '改正文', body: '新正文', updateTitle: '生效验证顺序' });
+assert.ok(hintedUpdate.error);
+assert.match(hintedUpdate.error, /相近的里有：「生效验证顺序（含：桌面端没有 Cmd\+R）」/);
+assert.doesNotMatch(hintedUpdate.error, /undefined/);
+
 
 /** 重命名后仍按原 id 定位到同一条；归档后重建同名条目也不能冒领旧 id。 */
 const renameSaved = store.saveEntry(twinScope, { title: '改名前的探针', summary: '旧身份', body: '旧正文', writeMode: 'patch' });

package/test/recall.test.mjs

@@ -1009,3 +1009,26 @@ console.log('recall.test.mjs: ok');
     assert.equal(asked(text), false, text);
   }
 }
+
+// A32：只有真递到模型眼里的条目才记使用时间；空召回/未命中的回合不能顺手记账。
+{
+  const cwd = mkdir('usage');
+  const scope = store.scopeOf(cwd);
+  const probe = save(scope, { title: '量子纠缠咖啡机', tags: ['记账'], summary: '只有送达才记 lastUsed' });
+  const lastUsedOf = () => store.locateByTitle(scope, '量子纠缠咖啡机').record.lastUsed;
+  const usedOf = () => store.locateByTitle(scope, '量子纠缠咖啡机').record.used;
+  assert.equal(usedOf(), false, '新建但没被用过的条目不能算读过');
+  const baseline = lastUsedOf();
+  const runtime = boot();
+  const agent = makeAgent('agent-usage', cwd);
+  const missSignal = await prepare(runtime, agent, '完全无关的一串词');
+  assert.doesNotMatch(runtime.provider.text({ agent, signal: missSignal }), /量子纠缠咖啡机/);
+  runtime.handlers.get('agent/turn-stopping').at(-1)({ signal: missSignal });
+  assert.equal(lastUsedOf(), baseline, '没送达的条目不能被记账');
+  const hitSignal = await prepare(runtime, agent, '量子纠缠咖啡机', 't2');
+  assert.match(runtime.provider.text({ agent, signal: hitSignal }), /量子纠缠咖啡机/);
+  assert.equal(lastUsedOf(), baseline, '送达也不在 provider 路径上写盘');
+  runtime.handlers.get('agent/turn-stopping').at(-1)({ signal: hitSignal });
+  assert.equal(usedOf(), true, '送达并记账后「读过」标记跟着成立');
+  assert.equal(store.locateByTitle(scope, '量子纠缠咖啡机').record.id, probe.id);
+}