dsh-prime-memory 0.26.21 → 0.26.23

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 更新日志（Changelog）
 
+## [0.26.23] — 2026-11-02
+
+- **方案 B：DRSC 读面改走 collector 的正式门面（`drsReadFacade`）**。`0.26.21` 的进程内直调虽然绕开了宿主鉴权，但代价是**耦合 collector 的五个内部导出名**（`openProjectionStore`/`createQueryContext`/`search`/`sessionDetail`/`listSessions`），并且**自己另开一份投影库**——多占一份常驻 `summaries` 内存与一个读事务。现在 collector `0.2.5` 导出 `drsReadFacade()`，返回绑它**自己活 QueryContext** 的只读对象；本仓优先用这个门面，只认一个稳定符号，也不再开第二份库。
+- **三条路径的优先级与降级**（`src/clients/drsc-inproc.ts`）：① collector ≥0.2.5 且库已就绪 → 走门面；② collector 是新版本但库还在 `setImmediate` 初始化 → **本轮抛可重试错、且不缓存**，让下一次读重取门面。这一点是本轮自查出的真设计缺陷：若此时回退自开库，会把自开库结果**永久缓存**，把「优先用门面」变成只在首轮赌运气。降级走既有链路（背景窗当轮空窗、工具面显式报错），语义与旧 HTTP 遇 `503 initializing` 一致；③ collector 是旧版（无该导出）→ 回退自开只读库（保留 `0.26.21` 行为）。
+- **参数映射不分叉**：门面对象被适配成与兼容路径同一个「模块形」，所以 `op`/`q`/`tail`/`limit`/`redact` 的解析口径、非法值整键缺席、`session` 缺 id 返回空行等语义只有一份实现，两条路径共用。
+- **依赖下限抬到 `>=0.2.5 <0.3.0`**（`package.json` dependencies；`dsh.plugin.json` 的 `pluginDependencies` 只列包名不带区间，无需改）。低于该版仍可用，只是走兼容路径。
+- **测试**：`tests/drsc-inproc.test.ts` 新增 3 例——门面可用时绝不调用 `openProjectionStore`；未就绪时报错且不缓存、对端就绪后下一次读拿到门面；旧版 collector 仍回退自开库。全量 **1904 例 / 190 文件**，typecheck/lint/build/build:smoke/smoke 全 0。
+
+## [0.26.22] — 2026-11-02
+
+- **#27 真机通过**：用户在 desktop 上 `register(work/dsh-host)` → `list` 显示「**现有 59 条**」，与注册前自生长清单里的 `work/dsh-host(59)` 逐位一致；`?? 0` 分支也未被误伤（有绑定即显示真数）。
+- **修掉这次验证顺带查出的口径缺陷**（`memory_room_admin` 的 `action=list`）：`grownOnly` 原先用 `roomRegistry.list()`（**含 retired**）排除自生长项，而归类词表面（`room-review.ts`）用 `listActive()`。两侧口径不一致的后果是——**一个 slug 退役后，它既不在注册表活跃词表里、又被从「自生长未注册」清单排除，若它还挂着记录，那些记录的 Room 归属就在两个面上同时隐形**，且没有任何动作能把它找回来（工具面只有 `retire`，无 un-retire；恢复只能走 RPC `dsh-memory/room-admin` 的 `action=retire, active:true`，工具没暴露该参数）。现改为按 `activeSlugs` 排除，退役项回到自生长面继续可见可计数。
+- **额度显示同步**：`注册表 N 条(上限 200)` 原先把 retired 条目也计入 N（占额度视觉位），现 N = 活跃条目数，并在存在退役项时追加「已退役 M 条（不占额度、可用面板「恢复」切回 active）」。退役条目本身仍列在明细里并标 `[source/retired]`，便于恢复。
+- **测试**：新增 `tests/room-admin-list.test.ts` 3 例（注册项真计数 / 退役后两侧口径一致 / 零绑定仍显示 0）。**红绿已验**：把排除集退回修复前的 `registry.some(...)` 写法后 1 例转红，恢复即全绿。全量 **1901 例 / 190 文件**。
+- **冒烟脚本去钉版**：`scripts/verify-desktop-smoke.mjs` 的版本断言从等值改为 `0.26.` 族前缀（上一版每发一次就得改脚本，是自我制造的维护债）；同时清掉两个未使用变量使 lint 归零。
+
 ## [0.26.21] — 2026-11-02
 
 - **#20 追加修复：DRSC 读面从 HTTP 改为进程内直调**。桌面宿主在**任何**注册路由之前有一道 pre-dispatch 鉴权（`isAuthenticated` 只认由 `requestAudience(Host)` 派生的签名 cookie，豁免分支仅 `GET /?token=` 与已认证的 `GET /`），而插件服务端 `fetch` 既无 cookie 也无可取用 launch token 的服务面（该字段是宿主 `BrowserAuth` 私有）。真机实测确认：基址修对后请求确实发出、参数形状正确，但仍被回 `401` —— 即上一版只解决了「打错端口」，没解决「打不通」。本版新增 `src/clients/drsc-inproc.ts`，直调 collector 导出的只读查询面（`resolveIndexDir` → `openProjectionStore` → `createQueryContext` → `search` / `sessionDetail` / `listSessions`），全程不碰 `ProjectionSync` 写侧引擎，故不会与 collector 自身的同步器抢水位、也不会多挂一个 interval；索引库为 WAL（实测同目录有 `-wal`/`-shm`），宿主持写连接时本侧只读句柄可并发读，且句柄只开一次（常驻 summaries 是内存 Map，每请求重开等于重扫全表）。

package/dist/clients/drsc-inproc.d.ts

@@ -38,7 +38,7 @@ export interface CollectorReadModule {
 }
 /** 注入面（单测）；缺省按裸名动态 import。 */
 export type CollectorLoader = () => Promise<CollectorReadModule>;
-/** 清掉缓存（单测用；也供 collector 换装后强制重开）。 */
+/** 清掉缓存（单测用；也供 collector 换装后强制重取）。 */
 export declare function resetCollectorReadState(): void;
 /**
  * 执行一次读，返回与 HTTP 包络同形的对象（`ok:true` + 各 op 的字段）。

package/dist/clients/drsc-inproc.js

@@ -22,37 +22,67 @@
 const COLLECTOR_PACKAGE = 'dsh-reference-session-collector';
 const defaultLoader = async () => (await import(/* @vite-ignore */ COLLECTOR_PACKAGE));
 let modulePromise;
-let queryContext;
 /**
- * 只读句柄（`openProjectionStore` 的返回值）。常驻 summaries 是内存 Map，
- * 每请求重开等于重扫全表，故只开一次；undefined 是合法的未开哨兵
- * （句柄真为 undefined 时 createQueryContext 会在首读即报错，不会静默重开）。
+ * 兼容路径（旧 collector）的只读句柄（`openProjectionStore` 的返回值）。常驻 summaries
+ * 是内存 Map，每请求重开等于重扫全表，故只开一次；undefined 是合法的未开哨兵。
  */
 let storeHandle;
-/** 清掉缓存（单测用；也供 collector 换装后强制重开）。 */
+/** 清掉缓存（单测用；也供 collector 换装后强制重取）。 */
 export function resetCollectorReadState() {
     modulePromise = undefined;
-    queryContext = undefined;
     storeHandle = undefined;
 }
-/** 载入并缓存 collector 模块；失败不缓存 rejection，否则一次抖动会永久打死后续所有读。 */
+/** 把门面对象适配成本模块统一的「模块形」，以便与兼容路径共用同一套参数映射。
+ * 前三个成员在门面路径上永不会被调用：moduleOf 命中门面后直接返回，不走进兼容分支。
+ */
+function fromFacade(facade) {
+    const unused = () => {
+        throw new Error('门面路径不应自开投影库');
+    };
+    return {
+        resolveIndexDir: unused,
+        openProjectionStore: unused,
+        createQueryContext: unused,
+        listSessions: (ctx, offset, limit) => facade.listSessions(offset, limit),
+        sessionDetail: (ctx, sessionId, opts) => facade.sessionDetail(sessionId, opts),
+        search: (ctx, query, opts) => facade.search(query, opts),
+    };
+}
+/** 取一个可用的「模块形」：优先 collector 门面（>=0.2.5），否则回退自开只读库。 */
 async function moduleOf(load) {
-    const pending = (modulePromise ??= load().catch((err) => {
+    const pending = (modulePromise ??= (async () => {
+        const mod = (await load());
+        if (typeof mod.drsReadFacade === 'function') {
+            const facade = mod.drsReadFacade();
+            // 对端是新版本但库未就绪（collector 的重活推迟在 setImmediate 臂）：本轮**不**回退
+            // 自开库，而是抛可重试错——否则会把自开库结果永久缓存，把“优先用门面”变成
+            // 只在首轮赌运气。抛错走既有降级链（背景窗当轮空窗、工具面显式报错），
+            // 且不缓存 rejection，下一次读会重取门面。
+            if (facade === undefined) {
+                throw new Error('collector 投影库尚未就绪（稍后自动重试）');
+            }
+            return fromFacade(facade);
+        }
+        return legacyStoreModule(mod);
+    })().catch((err) => {
         if (modulePromise === pending)
             modulePromise = undefined;
         throw err;
     }));
     return pending;
 }
-async function contextFor(load) {
-    if (queryContext !== undefined)
-        return queryContext;
-    const mod = await moduleOf(load);
+/** 旧 collector（无 drsReadFacade）的兼容路径：自己开一份只读库。 */
+async function legacyStoreModule(mod) {
     if (storeHandle === undefined) {
         storeHandle = mod.openProjectionStore(mod.resolveIndexDir());
     }
-    queryContext = mod.createQueryContext(storeHandle);
-    return queryContext;
+    const ctx = mod.createQueryContext(storeHandle);
+    return {
+        ...mod,
+        listSessions: (_c, offset, limit) => mod.listSessions(ctx, offset, limit),
+        sessionDetail: (_c, sessionId, opts) => mod.sessionDetail(ctx, sessionId, opts),
+        search: (_c, query, opts) => mod.search(ctx, query, opts),
+    };
 }
 /** 把 HTTP 查询串拆成参数表（与 collector 路由同源解析口径：它也只读 searchParams）。 */
 function paramsOf(query) {
@@ -66,7 +96,6 @@ function paramsOf(query) {
  * 把传输从 fetch 换成函数调用，不顺手改任何语义。
  */
 export async function callCollectorRead(query, load = defaultLoader) {
-    const ctx = await contextFor(load);
     const mod = await moduleOf(load);
     const p = paramsOf(query);
     const op = p.get('op') ?? '';
@@ -76,7 +105,7 @@ export async function callCollectorRead(query, load = defaultLoader) {
         const limit = positiveInt(p.get('limit'));
         return {
             ok: true,
-            ...mod.search(ctx, p.get('q') ?? '', {
+            ...mod.search(READ_SURFACE, p.get('q') ?? '', {
                 // 非法/缺省时整个键缺席，而不是传 `limit: undefined` —— `'limit' in opts`
                 // 与 `opts.limit === undefined` 不是一回事，对端可能按前者走钳位分支。
                 ...(limit === undefined ? {} : { limit }),
@@ -90,7 +119,7 @@ export async function callCollectorRead(query, load = defaultLoader) {
             return { ok: true, session: null, rows: [] };
         }
         const tail = positiveInt(p.get('tail'));
-        const detail = mod.sessionDetail(ctx, sessionId, {
+        const detail = mod.sessionDetail(READ_SURFACE, sessionId, {
             // collector 侧：tail 为正整数才切尾窗，键缺席即全量（#14-B 的整会话臂依赖这点）。
             ...(tail === undefined ? {} : { tail }),
             redact,
@@ -101,7 +130,7 @@ export async function callCollectorRead(query, load = defaultLoader) {
         // 这两个是位置参数，undefined 与“没传”在 JS 里同义，无需上面对象字面量那套处置。
         const offset = positiveInt(p.get('offset')) ?? 0;
         const limit = positiveInt(p.get('limit'));
-        return { ok: true, ...mod.listSessions(ctx, offset, limit) };
+        return { ok: true, ...mod.listSessions(READ_SURFACE, offset, limit) };
     }
     throw new Error(`collector 未知 op: ${op === '' ? '(missing)' : op}`);
 }
@@ -112,3 +141,5 @@ function positiveInt(raw) {
     const n = Number(raw);
     return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined;
 }
+/** 统一形后的模块不再需要真 QueryContext，这个占位只用来占位。 */
+const READ_SURFACE = 'inproc-read-surface';

package/dist/tools/index.js

@@ -390,9 +390,17 @@ graphWrite) {
                 // 线性 find,上限 200 条注册表 × N 个 Room——语义相同、形状不同就是分叉位。
                 const countOf = mergeRoomCatalog(counts);
                 const regLines = registry.map((e) => `- ${e.slug}${e.label ? `(${e.label})` : ''} [${e.source}/${e.status}] 现有 ${countOf.get(e.slug) ?? 0} 条${e.description ? ` — ${e.description}` : ''}`);
-                const grownOnly = counts.filter((r) => !registry.some((e) => e.slug === r.room));
+                // 口径必须跟词表一致（`room-review.ts` 用 listActive）：已退役条目不再进归类词表，
+                // 那它的 slug 就应回到「自生长未注册」面。原先用全量 registry 排除，使退役后的
+                // slug 两边都不显示（带记录时那些记录在词表上隐形）——退役不可逆地捐掉可见性。
+                const activeSlugs = new Set(registry.filter((e) => e.status === 'active').map((e) => e.slug));
+                const grownOnly = counts.filter((r) => !activeSlugs.has(r.room));
+                const activeCount = activeSlugs.size;
+                const retiredCount = registry.length - activeCount;
                 return {
-                    notice: `注册表 ${registry.length} 条(上限 200),自生长未注册 ${grownOnly.length} 个。\n` +
+                    notice: 
+                    // 额度与词表同步：上限 200 算的是活跃条目，退役项不占额度（另计）。
+                    `注册表 ${activeCount} 条(上限 200)${retiredCount > 0 ? `，已退役 ${retiredCount} 条（不占额度、可用面板「恢复」切回 active）` : ''}，自生长未注册 ${grownOnly.length} 个。\n` +
                         (regLines.join('\n') || '(注册表为空——用 action=register 预注册)') +
                         `\n自生长未注册:${grownOnly.map((r) => `${r.room}(${r.count})`).join(", ") || "无"}`,
                     rooms: `${registry.length}+${grownOnly.length}`,

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.21",
+  "version": "0.26.23",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.21",
+  "version": "0.26.23",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",
@@ -98,7 +98,7 @@
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
     "@node-rs/jieba": "^2.0.2",
-    "dsh-reference-session-collector": ">=0.2.0-beta.0 <0.3.0",
+    "dsh-reference-session-collector": ">=0.2.5 <0.3.0",
     "sqlite-vec": "^0.1.7-alpha.2",
     "undici": "^7.29.0"
   },