dsh-lite-memory 0.18.38 → 0.18.39

package/docs/RELEASE-0.18.39.md

@@ -0,0 +1,8 @@
+# 0.18.39：读记忆找不到时直接给完整标题
+
+- 上下文被压缩后常只剩缩短的标题；按短标题读会精确匹配失败，以前只报「没有这条」，模型只能再猜一轮。
+- 现在失败时就地列出最多 3 条相近的完整标题，模型一次就能换对；成功路径与常驻提示都不变，多出的字只出现在失败回执里。
+- 候选只从当前会话能看到的项目层与全局层取，不跨项目；仍然不按标题模糊读正文，避免读错条目。
+- 补回归：存一条带括号后缀的标题，用前缀读要报出完整标题，再用完整标题读到正文。
+
+验证：`npm test` 全绿；常驻工具文本仍是 13375 B。

package/index.js

@@ -1005,6 +1005,28 @@ function ambiguousTitleError(title, hits, label) {
   return `${label}「${title}」有 ${hits.length} 条同名，无法确定是哪一条：${detail}。先归档其中一条，或换一个能区分的标题再试`;
 }
 
+/**
+ * 标题解析失败时给几条相近的完整标题：上下文里常只剩缩短的标题，
+ * 精确匹配失败就地列出候选，比让模型再猜一次省一轮。
+ */
+function nearTitleHints(targets, title) {
+  const out = [];
+  const seen = new Set();
+  for (const target of targets) {
+    let index;
+    try { index = loadIndex(target); } catch { continue; }
+    for (const entry of [...(index.entries || []), ...(index.archived || [])]) {
+      const current = String(entry && entry.title || '').trim();
+      if (!current || current === title || seen.has(current)) continue;
+      if (!current.includes(title) && !title.includes(current)) continue;
+      seen.add(current);
+      out.push(current);
+      if (out.length >= 3) return out;
+    }
+  }
+  return out;
+}
+
 /**
  * 返回 { id } 或抛出：显式层只查那一层；默认先项目后全局（别的项目不参与解析）。
  * 同一层出现多条同名一律报歧义，绝不取第一条。
@@ -1030,6 +1052,10 @@ function refIdOf(scope, args, label = '记忆') {
     if (hits.length > 1) throw new Error(ambiguousTitleError(title, hits, label));
     if (hits.length === 1) return hits[0].id;
   }
+  const near = nearTitleHints(sources, title);
+  if (near.length) {
+    throw new Error(`没有「${title}」这条${label}。相近的里有：${near.map((item) => `「${item}」`).join('、')}；用完整标题或 id 再试`);
+  }
   throw new Error(`没有「${title}」这条${label}；先用 memory_search 对一下标题`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lite-memory",
-  "version": "0.18.38",
+  "version": "0.18.39",
   "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/test/contract.test.mjs

@@ -287,6 +287,15 @@ assertSchema('memory_save', twinUpdate);
 assert.equal(store.readEntry(twinScope, twinAId).body, '正文甲', '按 id 读不能被同名条目串走');
 assert.equal(store.readEntry(twinScope, twinBId).body, '正文乙');
 
+/** 上下文里常只剩缩短的标题：精确匹配失败时要把完整标题就地报出来，不让模型再猜一轮。 */
+store.saveEntry(twinScope, { title: '生效验证顺序（含：桌面端没有 Cmd+R）', summary: '缩短标题的探针', body: '正文', writeMode: 'patch' });
+await assert.rejects(
+  () => exec('memory_read', { title: '生效验证顺序' }),
+  /相近的里有：「生效验证顺序（含：桌面端没有 Cmd\+R）」/,
+);
+const hintedRead = await exec('memory_read', { title: '生效验证顺序（含：桌面端没有 Cmd+R）' });
+assert.equal(hintedRead.body, '正文');
+
 /** 重命名后仍按原 id 定位到同一条；归档后重建同名条目也不能冒领旧 id。 */
 const renameSaved = store.saveEntry(twinScope, { title: '改名前的探针', summary: '旧身份', body: '旧正文', writeMode: 'patch' });
 const renameSeedId = renameSaved.record?.id ?? renameSaved.id;