dsh-prime-memory 0.20.0-beta.2 → 0.20.0-beta.21

package/dist/stats.js

@@ -18,6 +18,7 @@ import { EFFORT_CHOICES, resolveDataDir } from './config.js';
 import { effectiveCfg } from './pipeline/runner.js';
 import { emptyRecallStats } from './hooks/recall.js';
 import { buildRouteChain, decideSendableEffort, LAYER_DEFAULT_BUDGETS, layerChainOrNull, resolveModelContextWindow, resolveModelEfforts, resolveModelRoute } from './llm.js';
+import { mergeRoom, renameRoom } from './room-review.js';
 import { projectDistillChain, validateDistillChain } from './settings.js';
 import { RECEIPTS_QUERY_LIMIT_MAX, dimensionOf, toReceiptView } from './store/receipts.js';
 import { getTraceStore } from './store/trace.js';
@@ -25,9 +26,8 @@ import { resolveConflictPair, listConflictPairs } from './conflict-service.js';
 import { sourceAnchorLabels } from './pipeline/anchors.js';
 import { readSupersedeMarker } from './store/supersede.js';
 import { isSnapshotName } from './store/l1-snapshot.js';
-import { closeTodoRefSlot } from './hooks/long-task.js';
 import { WING_CATALOG, WING_FALLBACK } from './types.js';
-import { isTag } from './metadata-validators.js';
+import { isRoomSlug } from './metadata-validators.js';
 import { InProcMemoryBackend } from './store/memory-backend.js';
 import { isWingCorner } from './store/session-modes.js';
 import { startWingBackfill } from './wing-backfill.js';
@@ -36,7 +36,7 @@ import { snapshotTokenCost } from './token-cost.js';
 const require = createRequire(import.meta.url);
 export const PLUGIN_VERSION = require('../package.json').version;
 /**
- * 端点全集运行时清单(36 个,与 tests/contract-keys.test.ts 的 ENDPOINTS 及
+ * 端点全集运行时清单(与 tests/contract-keys.test.ts 的 ENDPOINTS 及
  * contract.ts 类型映射表三方对齐,漂移由键集 diff 测试暴露)。
  * 注意:本清单同时是 HTTP 前缀路由 `/dsh-memory/rpc/<短名>` 的**放行白名单**
  * (见下方 SHORT_ENDPOINTS),漏一条 = 该端点在面板里静默消失(404 被客户端
@@ -51,10 +51,11 @@ export const MEMORY_ENDPOINTS = [
     'dsh-memory/token-cost',
     'dsh-memory/session-mode-get',
     'dsh-memory/session-mode-set',
-    'dsh-memory/longtask-hint-get',
-    'dsh-memory/longtask-compress-tail',
     'dsh-memory/wing-overview',
     'dsh-memory/rooms-get',
+    'dsh-memory/rooms-export',
+    'dsh-memory/room-register',
+    'dsh-memory/room-admin',
     'dsh-memory/wing-backfill',
     'dsh-memory/session-stats',
     'dsh-memory/settings-get',
@@ -156,51 +157,6 @@ function readJsonBody(req) {
         req.on('error', reject);
     });
 }
-/** 压缩后去抖 ruminate:上次触发时刻(模块级;跨轮询/按压共享)。 */
-let lastCompressRuminateAt = 0;
-const COMPRESS_RUMINATE_DEBOUNCE_MS = 10 * 60_000;
-/**
- * 尾部压缩闭环(T05):压缩入队成功后,冲刷+L2(带 repo 感知)+relabel+recluster
- * 消费一条龙由 ruminate 轻刷新接管——去抖 10 分钟,失败静默(压缩本身已成功,
- * 重算由下一次任何触发兜底)。
- */
-function debouncedCompressRuminate(ruminate, logger) {
-    const now = Date.now();
-    if (!ruminate || now - lastCompressRuminateAt < COMPRESS_RUMINATE_DEBOUNCE_MS)
-        return;
-    lastCompressRuminateAt = now;
-    void ruminate.start().catch((err) => logger.warn(`[memory] 压缩后反刍触发失败(压缩产物保留,重算由下次触发兜底): ${err instanceof Error ? err.message : String(err)}`));
-}
-/**
- * 尾部 turn 压缩:把 (水位线, maxCapturedTurn] 内最近的最近 N 轮强制蒸馏入记忆
- * (force 跳过阈值;L1 去重与水位线双重防重)。off 档会话保持完全隐身(不压缩)。
- * 无锚点老数据只在首次压缩(无水位线)时纳入——宁少收不重蒸。
- */
-export async function compressTailTurns(sessionId, turns, io) {
-    const toTurn = io.l0.maxCapturedTurn(sessionId);
-    if (toTurn === undefined)
-        return { enqueued: 0, fromTurn: null, toTurn: null };
-    const watermark = io.modes.getTailWatermark(sessionId) ?? 0;
-    const fromTurn = Math.max(watermark + 1, toTurn - turns + 1);
-    if (fromTurn > toTurn)
-        return { enqueued: 0, fromTurn, toTurn };
-    const mode = io.modes.get(sessionId);
-    if (mode === 'off')
-        return { enqueued: 0, fromTurn, toTurn };
-    const messages = await io.l0.recentBySession(sessionId, turns * 12 + 24);
-    const picked = messages.filter((m) => {
-        const t = m.anchor?.turn;
-        if (t === undefined)
-            return watermark === 0;
-        return t >= fromTurn && t <= toTurn;
-    });
-    if (picked.length === 0)
-        return { enqueued: 0, fromTurn, toTurn };
-    io.runner.enqueue(sessionId, picked, mode, { force: true });
-    io.modes.setTailWatermark(sessionId, toTurn);
-    io.logger.info(`[memory] 尾部压缩:turn ${fromTurn}..${toTurn} 已强制入队蒸馏(${picked.length} 条)`);
-    return { enqueued: picked.length, fromTurn, toTurn };
-}
 /**
  * 组装端点 deps。抽成函数是为了让"哪个控制器落入哪个字段"成为可测接缝:
  * 反刍端点读 deps.ruminate,若此处漏注入,端点会静默恒返 {supported:false}(面板整块不渲染)。
@@ -216,15 +172,15 @@ export function buildEndpointDeps(base, sources, controller) {
         embedManager: sources.embedManager,
         sessionInfo: sources.sessionInfo,
         ruminate: controller,
-        longTask: sources.longTask,
+        roomRegistry: sources.roomRegistry,
     };
     return { ...base, ...injected };
 }
 export function registerMemoryRpc(ctx, cfg, stores, logger, status, live, modes, dataDir, rebuild, embedManager, sessionInfo, 
 /** 反刍控制器(存储降级时为 undefined):经 buildEndpointDeps 落入 deps.ruminate。 */
 ruminate, 
-/** 长任务端点依赖(cfg.longTask.enabled 门控;缺省 = 端点恒 disabled)。 */
-longTaskDeps) {
+/** Room 分类管理依赖(注册表;缺省 = rooms-get 不带 registry、rooms-export 恒 404 语义)。 */
+roomRegistry) {
     /** 当前是否持有一段有效注册(dispose 完成后清空,允许服务重上线时重注册)。 */
     let holding = false;
     /** 当前 handle 绑定的 connection 实例(internal/service 第二参;用于识别实例替换)。 */
@@ -242,7 +198,10 @@ longTaskDeps) {
             // 端点处理器:HTTP 层与旧 connection.rpc 的 handler 共用同一分发。
             const rpcHandler = async (endpoint, payload) => {
                 try {
-                    const value = await handleEndpoint(endpoint, payload, buildEndpointDeps({ ctx, cfg, stores, logger }, { status, live, modes, dataDir, rebuild, embedManager, sessionInfo }, ruminate));
+                    const value = await handleEndpoint(endpoint, payload, buildEndpointDeps({ ctx, cfg, stores, logger }, 
+                    // roomRegistry 必须随 sources 下发——漏带 = 面板侧 room-* 恒"未装配"
+                    // (工具面直传不受影响;2026-10-02 beta.9 实测回归)
+                    { status, live, modes, dataDir, rebuild, embedManager, sessionInfo, roomRegistry }, ruminate));
                     return { ok: true, value };
                 }
                 catch (err) {
@@ -390,7 +349,7 @@ function sanitizeSettings(s) {
 }
 /** 端点分发表(导出供测试直调:可精确注入 rebuild/ruminate 等可选控制器,验证 deps 接线)。 */
 export async function handleEndpoint(endpoint, payload, deps) {
-    const { cfg, stores, status, live, modes, dataDir, rebuild, ruminate, embedManager, sessionInfo, longTask: longTaskDeps } = deps;
+    const { cfg, stores, status, live, modes, dataDir, rebuild, ruminate, embedManager, sessionInfo, roomRegistry } = deps;
     switch (endpoint) {
         case 'dsh-memory/stats':
             return buildStats(cfg, stores, status);
@@ -424,7 +383,6 @@ export async function handleEndpoint(endpoint, payload, deps) {
                 halls: locked,
                 hallIncludeUnlabeled: bounds.includeUnlabeled,
                 hallIncludeGeneral: bounds.includeGeneral,
-                longTask: modes.getLongTask(sessionId),
             };
             return v;
         }
@@ -434,9 +392,8 @@ export async function handleEndpoint(endpoint, payload, deps) {
             const p = (payload ?? {});
             const sessionId = expectSessionId(p.sessionId);
             const allowed = ['auto', 'chat', 'work', 'off'];
-            // mode 可选(带 longTask 的轻量切换);二者都不传 = 无操作拒绝(防旧客户端漏字段静默)。
-            if (p.mode === undefined && p.longTask === undefined) {
-                throw new Error('session-mode-set 需要 mode 或 longTask 之一');
+            if (p.mode === undefined) {
+                throw new Error('session-mode-set 需要 mode');
             }
             if (p.mode !== undefined && (typeof p.mode !== 'string' || !allowed.includes(p.mode))) {
                 throw new Error(`非法档位: ${String(p.mode)}(允许 ${allowed.join('/')})`);
@@ -458,17 +415,6 @@ export async function handleEndpoint(endpoint, payload, deps) {
                     throw new Error(`非法 Wing 锁定: ${String(bad)}(允许 ${WING_CATALOG.map((h) => h.id).join('/')}/null)`);
                 }
             }
-            // 长任务开关可选同车:布尔 = 切换;缺省 = 不动。关闭时撤下 todo 参考槽位
-            // (todo 参考只在长任务模式可用;撤下失败不影响开关本身,log 即可)。
-            if (p.longTask !== undefined) {
-                if (typeof p.longTask !== 'boolean') {
-                    throw new Error(`非法长任务开关: ${String(p.longTask)}(允许 true/false)`);
-                }
-                modes.setLongTask(sessionId, p.longTask);
-                if (!p.longTask && longTaskDeps?.slots) {
-                    closeTodoRefSlot({ cfg, modes, slots: longTaskDeps.slots, contextUsage: longTaskDeps.contextUsage, todoRef: longTaskDeps.todoRef, logger: deps.logger }).catch((err) => deps.logger.warn(`[memory] todo 参考槽位撤下失败: ${err instanceof Error ? err.message : String(err)}`));
-                }
-            }
             if (p.mode !== undefined)
                 modes.set(sessionId, p.mode);
             if (typeof p.recall === 'boolean') {
@@ -508,129 +454,6 @@ export async function handleEndpoint(endpoint, payload, deps) {
                 halls: locked,
                 hallIncludeUnlabeled: bounds.includeUnlabeled,
                 hallIncludeGeneral: bounds.includeGeneral,
-                longTask: modes.getLongTask(sessionId),
-            };
-            return v;
-        }
-        case 'dsh-memory/longtask-hint-get': {
-            if (!modes)
-                throw new Error('档位存储未初始化');
-            const p = (payload ?? {});
-            const sessionId = expectSessionId(p.sessionId);
-            const enabled = cfg.longTask.enabled;
-            const longTask = modes.getLongTask(sessionId);
-            let contextPct = null;
-            if (enabled && longTask) {
-                // 分母:主对话模型官方窗口(3s race 封顶,同 session-stats 口径)
-                let window = null;
-                try {
-                    const sel = deps.ctx.get('agentDefaultModel')?.currentSelection?.();
-                    if (sel?.provider && sel?.model) {
-                        window = await Promise.race([
-                            resolveModelContextWindow(deps.ctx, sel.provider, sel.model),
-                            new Promise((resolve) => setTimeout(() => resolve(null), 3_000)),
-                        ]);
-                    }
-                }
-                catch {
-                    /* 可选服务缺失 = 分母未知 */
-                }
-                contextPct = longTaskDeps
-                    ? longTaskDeps.contextUsage.percentOfWindow(sessionId, window ?? undefined)
-                    : null;
-            }
-            const drift = enabled ? longTaskDeps?.todoRef.latest(sessionId)?.drift ?? null : null;
-            const todoCount = enabled ? longTaskDeps?.todoRef.latest(sessionId)?.items.length ?? 0 : 0;
-            const reasons = [];
-            if (!longTask) {
-                if (contextPct !== null && contextPct >= cfg.longTask.contextThresholdPct) {
-                    reasons.push('context-threshold');
-                }
-                if (drift !== null && drift >= cfg.longTask.driftThreshold) {
-                    reasons.push('todo-drift');
-                }
-            }
-            const watermark = modes.getTailWatermark(sessionId);
-            let pendingTailTurns = null;
-            if (enabled && longTask && longTaskDeps) {
-                const captured = stores.l0.maxCapturedTurn(sessionId);
-                pendingTailTurns = captured === undefined ? 0 : Math.max(0, captured - (watermark ?? 0));
-            }
-            // 自动尾部压缩(长任务开启 + 显式 opt-in + 跨阈值):水位线只前进,
-            // 轮询重复触发天然幂等;失败只 warn,不打断建议状态返回。
-            if (enabled &&
-                longTask &&
-                longTaskDeps &&
-                cfg.longTask.autoCompress &&
-                pendingTailTurns !== null &&
-                pendingTailTurns > 0 &&
-                contextPct !== null &&
-                contextPct >= cfg.longTask.contextThresholdPct) {
-                try {
-                    const ar = await compressTailTurns(sessionId, cfg.longTask.tailTurns, {
-                        modes,
-                        l0: stores.l0,
-                        runner: longTaskDeps.runner,
-                        logger: deps.logger,
-                    });
-                    if (ar.enqueued > 0)
-                        debouncedCompressRuminate(ruminate, deps.logger);
-                }
-                catch (err) {
-                    deps.logger.warn(`[memory] 自动尾部压缩失败: ${err instanceof Error ? err.message : String(err)}`);
-                }
-                const captured = stores.l0.maxCapturedTurn(sessionId);
-                pendingTailTurns = captured === undefined ? 0 : Math.max(0, captured - (modes.getTailWatermark(sessionId) ?? 0));
-            }
-            const v = {
-                sessionId,
-                enabled,
-                longTask,
-                contextPct,
-                contextThresholdPct: cfg.longTask.contextThresholdPct,
-                drift,
-                driftThreshold: cfg.longTask.driftThreshold,
-                todoCount,
-                suggest: reasons.length > 0,
-                reasons,
-                tailTurns: cfg.longTask.tailTurns,
-                lastTailCompressedTurn: watermark ?? null,
-                pendingTailTurns,
-            };
-            return v;
-        }
-        case 'dsh-memory/longtask-compress-tail': {
-            if (!modes)
-                throw new Error('档位存储未初始化');
-            const p = (payload ?? {});
-            const sessionId = expectSessionId(p.sessionId);
-            const longTask = modes.getLongTask(sessionId);
-            const turns = p.turns === undefined
-                ? cfg.longTask.tailTurns
-                : Math.max(1, Math.min(50, Math.round(p.turns)));
-            let enqueued = 0;
-            let fromTurn = null;
-            let toTurn = null;
-            if (longTask && longTaskDeps) {
-                // 只在长任务模式可用(部署开关在 compressTailTurns 内再守一道)
-                const r = await compressTailTurns(sessionId, turns, {
-                    modes,
-                    l0: stores.l0,
-                    runner: longTaskDeps.runner,
-                    logger: deps.logger,
-                });
-                enqueued = r.enqueued;
-                fromTurn = r.fromTurn;
-                toTurn = r.toTurn;
-                if (enqueued > 0)
-                    debouncedCompressRuminate(ruminate, deps.logger);
-            }
-            const v = {
-                sessionId,
-                enqueued,
-                fromTurn,
-                toTurn,
-                longTask,
             };
             return v;
         }
@@ -647,10 +470,226 @@ export async function handleEndpoint(endpoint, payload, deps) {
         // ── Room 分类计数(标签自生长分类;展开 metadata.tags 聚合,零 schema) ──
         case 'dsh-memory/rooms-get': {
             const rooms = stores.l1.listRooms();
-            const v = { rooms, total: rooms.length };
+            // 端点层合并注册表(Agent A 设计):注册表 active 条目 count=0 补齐并带
+            // source/label(source 用条目真实来源——收编 grown ≠ 预注册,⭐角标靠它区分);
+            // 自生长条目标 source='grown'。不动 listRooms() 的缓存语义。
+            const merged = rooms.map((r) => ({ ...r, source: 'grown' }));
+            const registry = roomRegistry?.listActive() ?? [];
+            for (const e of registry) {
+                const idx = merged.findIndex((r) => r.room === e.slug);
+                if (idx === -1) {
+                    merged.push({ room: e.slug, count: 0, source: e.source, label: e.label });
+                }
+                else {
+                    merged[idx] = { ...merged[idx], source: e.source, label: e.label ?? merged[idx].label };
+                }
+            }
+            const v = {
+                rooms: merged,
+                total: merged.length,
+                orphanCount: stores.l1.untaggedL1Count(),
+                registry: roomRegistry?.list().map((e) => ({
+                    slug: e.slug,
+                    label: e.label,
+                    description: e.description,
+                    source: e.source,
+                    aliases: e.aliases,
+                    status: e.status,
+                })),
+            };
+            return v;
+        }
+        case 'dsh-memory/room-register': {
+            if (!roomRegistry)
+                throw new Error('Room 注册表未装配(需要插件重载以初始化)。');
+            if (!live?.get().memoryMutate)
+                throw new Error('记忆写删未开放:请在记忆库面板开启「高权限模式」后,模型才能预注册 Room。');
+            const p = (payload ?? {});
+            const slug = String(p.slug ?? '').trim();
+            if (!slug)
+                throw new Error('slug 不能为空');
+            const r = await roomRegistry.register({
+                slug,
+                label: typeof p.label === 'string' ? p.label : undefined,
+                description: typeof p.description === 'string' ? p.description : undefined,
+                source: p.source === 'grown' ? 'grown' : undefined,
+            });
+            const v = {
+                slug: r.entry.slug,
+                created: r.created,
+                notice: r.created ? '已预注册。' : '已存在(只补全了缺失的 label/description)。',
+            };
+            return v;
+        }
+        // ── Room 破坏性面管理(merge/rename/retire;与 memory_room_admin 工具同编排) ──
+        case 'dsh-memory/room-admin': {
+            if (!roomRegistry)
+                throw new Error('Room 注册表未装配(需要插件重载以初始化)。');
+            if (!live?.get().memoryMutate)
+                throw new Error('记忆写删未开放:请在记忆库面板开启「高权限模式」后,才能执行 Room 管理。');
+            const p = (payload ?? {});
+            if (p.action === 'update') {
+                const slug = String(p.slug ?? '').trim();
+                if (!slug)
+                    throw new Error('update 需要 slug');
+                const changed = await roomRegistry.update(slug, {
+                    label: typeof p.label === 'string' ? p.label : undefined,
+                    description: typeof p.description === 'string' ? p.description : undefined,
+                });
+                const v = {
+                    notice: changed
+                        ? `已更新:${slug}(显示名/归类说明,标注器下次即用新词)`
+                        : `无变化:${slug} 未找到或未提供任何非空字段`,
+                };
+                return v;
+            }
+            if (p.action === 'retire') {
+                const slug = String(p.slug ?? '').trim();
+                if (!slug)
+                    throw new Error('retire 需要 slug');
+                const active = p.active === true;
+                const changed = await roomRegistry.setStatus(slug, active ? 'active' : 'retired');
+                // 带记录退场(软删,可恢复):该 room 下全部**活跃**记录分批 retire(每批 ≤200,与 records-delete 同原语)
+                let retiredRecords = 0;
+                if (p.withRecords === true && !active) {
+                    for (let offset = 0;; offset += 200) {
+                        const page = stores.l1.list({ tag: slug, retired: false, limit: 200, offset });
+                        if (page.items.length === 0)
+                            break;
+                        const n = stores.l1.retire(page.items.map((r) => r.id), { at: new Date().toISOString(), reason: 'manual' });
+                        retiredRecords += n;
+                        if (page.items.length < 200)
+                            break;
+                    }
+                    deps.logger.info(`[memory] Room 退役带记录:${slug},退场 ${retiredRecords} 条(软删,可恢复)`);
+                }
+                const v = {
+                    retiredRecords: retiredRecords > 0 ? retiredRecords : undefined,
+                    notice: changed
+                        ? active
+                            ? `已恢复:${slug}`
+                            : `已退役:${slug}(存量记录的 tags 不动,仅词表不再推荐)。${retiredRecords > 0 ? `已连同退场 ${retiredRecords} 条记录(软删,可在「已退场」区恢复)。` : ''}`
+                        : `未找到注册条目或状态无变化:${slug}。${retiredRecords > 0 ? `已退场 ${retiredRecords} 条记录(软删,可恢复)。` : ''}`,
+                };
+                return v;
+            }
+            if (p.action === 'merge' || p.action === 'rename') {
+                const from = String(p.from ?? '').trim();
+                const to = String(p.to ?? '').trim();
+                if (!from || !to)
+                    throw new Error('merge/rename 需要 from 与 to 两个 slug');
+                const dryRun = p.dryRun !== false;
+                const r = await (p.action === 'merge' ? mergeRoom : renameRoom)({ l1: stores.l1, registry: roomRegistry, logger: deps.logger }, from, to, { dryRun });
+                if (r.dryRun) {
+                    const v = {
+                        notice: `[dryRun 预览] ${from} → ${to}:影响 ${r.affected} 条${r.hasMore ? '(超过单次上限,需续跑)' : ''}。` +
+                            `样例:${r.preview.join(', ') || '无'}。确认无误后以 dryRun=false 执行(执行前自动备份,完成后自动入队场景重算)。`,
+                        dryRun: true,
+                        affected: r.affected,
+                        preview: r.preview,
+                        hasMore: r.hasMore,
+                    };
+                    return v;
+                }
+                // 实跑:受影响场景入队重算(source='room-merge';与工具同口径)
+                let requeued = 0;
+                for (const family of r.families ?? []) {
+                    for (const scene of r.scenes ?? []) {
+                        stores.l1.enqueueSceneRecluster(family, [scene], `room-merge:${Date.now()}`, 'room-merge');
+                        requeued++;
+                    }
+                }
+                const v = {
+                    notice: `${p.action === 'merge' ? '合并' : '改名'}完成:${from} → ${to},重写 ${r.applied} 条` +
+                        `(备份:${r.backupFile ?? '无'})${requeued > 0 ? `;已入队 ${requeued} 个场景重算` : ''}。`,
+                    dryRun: false,
+                    affected: r.applied,
+                    backupFile: r.backupFile,
+                };
+                return v;
+            }
+            throw new Error(`非法 action:${String(p.action)}(允许 merge/rename/retire)`);
+        }
+        case 'dsh-memory/rooms-export': {
+            const p = (payload ?? {});
+            const kind = p.kind === 'orphans' ? 'orphans' : p.kind === 'rooms' ? 'rooms' : p.kind === 'records' ? 'records' : '';
+            if (!kind)
+                throw new Error(`非法 kind: ${String(p.kind)}(允许 rooms/orphans/records)`);
+            const limit = Math.min(Math.max(Number(p.limit) || 2000, 1), 10_000);
+            const esc = (v) => {
+                const t = String(v ?? '');
+                return /[,\r\n"]/.test(t) ? '"' + t.replace(/"/g, '""') + '"' : t;
+            };
+            if (kind === 'rooms') {
+                const registry = roomRegistry?.list() ?? [];
+                const counts = new Map(stores.l1.listRooms().map((r) => [r.room, r.count]));
+                const lines = ['slug,count,source,label,description,status,aliases'];
+                let n = 0;
+                const seen = new Set();
+                for (const e of registry) {
+                    lines.push([e.slug, String(counts.get(e.slug) ?? 0), e.source, e.label ?? '', e.description ?? '', e.status, (e.aliases ?? []).join('|')].map(esc).join(','));
+                    seen.add(e.slug);
+                    n++;
+                }
+                for (const r of stores.l1.listRooms()) {
+                    if (seen.has(r.room))
+                        continue;
+                    lines.push([r.room, String(r.count), 'grown', '', '', 'active', ''].map(esc).join(','));
+                    n++;
+                }
+                const v = { kind, csv: lines.join('\r\n'), total: n, truncated: false };
+                return v;
+            }
+            if (kind === 'records') {
+                const tag = String(p.tag ?? '').trim();
+                if (!tag)
+                    throw new Error('kind=records 需要 tag(目标 Room slug)');
+                const header = 'id,type,scene_name,updated_at,tags,content';
+                const lines = [header];
+                let n = 0;
+                let truncated2 = false;
+                for (let offset = 0; offset < limit; offset += 200) {
+                    const page = stores.l1.list({ tag, retired: undefined, limit: 200, offset });
+                    for (const r of page.items) {
+                        if (n >= limit) {
+                            truncated2 = true;
+                            break;
+                        }
+                        const meta = (r.metadata ?? {});
+                        const tags = Array.isArray(meta.tags) ? meta.tags.join('|') : '';
+                        lines.push([r.id, r.type, r.scene_name, new Date(r.updatedAt).toISOString(), tags, r.content].map(esc).join(','));
+                        n++;
+                    }
+                    if (truncated2 || page.items.length < 200)
+                        break;
+                }
+                const v = { kind, csv: lines.join('\r\n'), total: n, truncated: truncated2 };
+                return v;
+            }
+            // orphans:无 Room 绑定的活跃记录清单(id/type/scene/updated/content/候选/状态)
+            const header = 'id,type,scene_name,updated_at,content,room_candidates,room_review';
+            const lines = [header];
+            let n = 0;
+            let truncated = false;
+            for (let offset = 0; offset < limit; offset += 200) {
+                const page = stores.l1.list({ untagged: true, retired: false, limit: 200, offset });
+                for (const r of page.items) {
+                    if (n >= limit) {
+                        truncated = true;
+                        break;
+                    }
+                    const meta = (r.metadata ?? {});
+                    lines.push([r.id, r.type, r.scene_name, new Date(r.updatedAt).toISOString(), r.content,
+                        Array.isArray(meta.roomCandidates) ? meta.roomCandidates.join('|') : '',
+                        String(meta.roomReview ?? '')].map(esc).join(','));
+                    n++;
+                }
+                if (truncated || page.items.length < 200)
+                    break;
+            }
+            const v = { kind, csv: lines.join('\r\n'), total: n, truncated };
             return v;
         }
-        // ── 一键回填(task_15):后台任务,单飞;端点立即返回,进度看 wing-overview ──
         case 'dsh-memory/wing-backfill': {
             const r = startWingBackfill({
                 ctx: deps.ctx,
@@ -944,8 +983,10 @@ export async function handleEndpoint(endpoint, payload, deps) {
             const retiredSel = typeof p.retired === 'boolean' ? p.retired : undefined;
             // Room 过滤:tag 是**自生长**的 slug(无枚举),只做形状与长度校验(SQL 侧参数化)
             const tagSel = typeof p.tag === 'string' ? p.tag.trim().slice(0, 64) : '';
-            if (tagSel && !isTag(tagSel))
-                throw new Error('tag 非法(需小写字母数字连字符,1-32 字符)');
+            if (tagSel && !isRoomSlug(tagSel))
+                throw new Error('tag 非法(两级制:major 或 major/minor,各段小写字母数字连字符)');
+            // 孤儿记忆筛选(与 tag 互斥,tag 优先):只认显式布尔,其余视为缺省。
+            const untaggedSel = p.untagged === true && !tagSel;
             // R13 多值归一: halls 数组只留非空字符串(≤40 字符),去重,上限 8(角数);
             // wing 单值保留兼容,归一后与 halls 合并
             const wingSel = Array.from(new Set([
@@ -986,29 +1027,46 @@ export async function handleEndpoint(endpoint, payload, deps) {
                             if (!Array.isArray(tags) || !tags.some((t) => t === tagSel))
                                 return false;
                         }
+                        if (untaggedSel) {
+                            // 孤儿:tags 缺失/非数组/全部空串均算无 Room
+                            const tags = m?.tags;
+                            const hasRoom = Array.isArray(tags) && tags.some((t) => typeof t === 'string' && t !== '');
+                            if (hasRoom)
+                                return false;
+                        }
                         return true;
                     });
                 }
+                const pageIds = filtered.slice(offset, offset + limit).map((h) => h.id);
+                const updatedById = new Map(stores.l1.getByIds(pageIds).map((r) => [r.id, r.updatedAt]));
                 const resp = {
-                    items: filtered.slice(offset, offset + limit).map((h) => hitToUiRecord({ ...h, metadata: metaById?.get(h.id) })),
+                    items: filtered.slice(offset, offset + limit).map((h) => hitToUiRecord({ ...h, metadata: metaById?.get(h.id) }, {
+                        agingWeight: agingWeightOf(updatedById.get(h.id), stores.l1.decayHalfLife),
+                        usage: stores.usage?.get(h.id) ?? null,
+                    })),
                     hasMore: filtered.length > offset + limit,
                     total: null,
                     truncated: wanted > SEARCH_CAP,
                     scenes: offset === 0 ? stores.l1.distinctScenes() : undefined,
                     wingCatalog,
+                    usageSummary: stores.usage?.summary() ?? null,
                 };
                 return resp;
             }
             // 退场筛查仅浏览路径透传;检索路径不接——FTS/向量里本就没有已退场行,
             // 接了只会让「仅退场+关键词」永远空结果,不如如实不筛。
-            const { items, total } = stores.l1.list({ type: p.type || undefined, scene: p.scene || undefined, hall: p.hall || undefined, halls: wingSel.length > 0 ? wingSel : undefined, tag: tagSel || undefined, retired: retiredSel, limit, offset });
+            const { items, total } = stores.l1.list({ type: p.type || undefined, scene: p.scene || undefined, hall: p.hall || undefined, halls: wingSel.length > 0 ? wingSel : undefined, tag: tagSel || undefined, untagged: untaggedSel || undefined, retired: retiredSel, limit, offset });
             const resp = {
-                items: items.map(hitToUiRecord),
+                items: items.map((r) => hitToUiRecord(r, {
+                    agingWeight: agingWeightOf(r.updatedAt, stores.l1.decayHalfLife),
+                    usage: stores.usage?.get(r.id) ?? null,
+                })),
                 hasMore: offset + items.length < total,
                 total,
                 truncated: false,
                 scenes: offset === 0 ? stores.l1.distinctScenes() : undefined,
                 wingCatalog,
+                usageSummary: stores.usage?.summary() ?? null,
             };
             return resp;
         }
@@ -1615,7 +1673,14 @@ export async function handleEndpoint(endpoint, payload, deps) {
     }
 }
 /** 浏览器卡片字段(比 MemoryRecord 精简,去掉大 metadata;Hall 从 metadata 提取)。 */
-export function hitToUiRecord(r) {
+/** 老化权重(与读路径 applyDecayWeight 同式):max(0.5, 0.5^(Δ天/半衰期));半衰期 ≤0 = 关 → null。 */
+export function agingWeightOf(updatedAtMs, halfLifeDays, now = Date.now()) {
+    if (!(halfLifeDays > 0))
+        return null;
+    const ageDays = Math.max(0, (now - (updatedAtMs ?? 0)) / 86_400_000);
+    return Math.max(0.5, Math.pow(0.5, ageDays / halfLifeDays));
+}
+export function hitToUiRecord(r, extra) {
     const retired = r.validTo !== undefined;
     const mark = retired ? readSupersedeMarker(r.metadata) : undefined;
     return {
@@ -1641,6 +1706,8 @@ export function hitToUiRecord(r) {
         // 但必须给出可见差异。
         retired,
         retiredReason: retired ? (mark?.reason ?? 'unknown') : null,
+        agingWeight: extra?.agingWeight ?? null,
+        usage: extra?.usage ?? null,
     };
 }
 /**