dsh-prime-memory 0.20.0-beta.13 → 0.20.0-beta.15

package/CHANGELOG.md

@@ -17,6 +17,30 @@
   - **建议状态(`longtask-hint-get`)以纯端点提供**:判定 = 上下文占用达 `contextThresholdPct` 或 todo 漂移达 `driftThreshold`(部署配置可调);配合 `longtask-compress-tail` 作手动压缩入口。
   - **撤下浮动球 UI(`client/src/longtask-fab.ts`;beta.1 起曾随包发布)**:悬浮建议面板的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——2026-10-02 用户裁定撤下。撤下不违座位契约(settings.section 恰一个 + 输入栏 pill,body 单例不占座位),但全应用级 overlay 会与其他插件的悬浮 UI 抢占屏幕角落;长任务开关与手动压缩入口待长任务定版时落记忆设置分节。
   - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
+## [0.20.0-beta.15] — 2026-10-02
+
+> 归类实测反馈两连修:①改名后的条目误带「已退役」(会掉出标注词表);②HTML5 拖拽在部分 webview 不生效 → 新增**点选归类**主路径。
+
+### 修复
+
+- **归类(改名)后条目误标 retired**:renameRoom 复用 merge 编排,`markMerged` 的"旧条目转退役"被带了过来——归完类的新 room 显示「已退役」并**掉出标注器词表**(listActive 过滤)。现 rename 收尾恢复先前状态(active 条目改名后仍 active);真 merge(并集语义)不受影响。红测试先行(unit + HTTP 面集成)。
+
+### 变更
+
+- **点选归类为主路径**:点 room 行「归类」→ 进入挑选态(按钮变「选 hall…」,所有 hall 头虚线高亮)→ 点目标 hall 头 → 出 dryRun 预览 → 确认实跑。拖拽保留(支持的環境仍可用),但不再依赖。
+## [0.20.0-beta.14] — 2026-10-02
+
+> 记忆卡片新增**老化权重**与**召回使用**展示,并开始为"老化权重效果统计"积累数据。口径(用户裁定):**进 topN(被注入上下文)才算被使用**;参与尝试未进 = 仅计尝试。
+
+### 新增
+
+- **卡片字段**:「老化 N%」chip(读路径衰减系数 `max(0.5, 0.5^(Δ天/半衰期))`,与召回排序同式同源;≤60% 标红=偏老)+「用 used/attempts」计数(title 含最近使用/尝试时间)。工具条新增汇总「召回使用 used/attempted(rate%)」。
+- **统计面**:`RecallUsageStore`(recall-usage.json sidecar,与 rooms-registry 同族纪律——损坏只读降级、绝不阻塞召回读路径);每轮召回在注入/全压制/预算清零三个终态记录(候选 attempts++、注入 used++,时间戳取最新);内存即时 + 去抖 5s 原子落盘,5 万条按最近尝试淘汰;未装配 = 零成本旁路。
+- 契约:UiRecord 增 `agingWeight`/`usage`,ListRecordsResponse 增 `usageSummary`(可选字段,旧客户端零断裂);契约键数不变。
+
+### 效果统计口径(后续分析用)
+- usageSummary:tracked(有统计的记忆数)/ attempted(Σ尝试)/ used(Σ使用)/ rate(使用率%)
+- 细粒度分析(按类型/年龄段的使用分布、半衰期调参依据)数据自本版起积累,分析视图另议。
 ## [0.20.0-beta.13] — 2026-10-02
 
 > 补全归类逻辑:把 room 归到已有 hall 下(此前只能新增 hall,或合并进别的 room 抹掉身份)。面板支持**拖拽归类**——拖 room 放到 hall 头上即可。

package/dist/client.js

@@ -3326,6 +3326,7 @@ var __defProp = Object.defineProperty;
 		        }
 		        const v = r.value;
 		        setItems((prev) => append ? prev.concat(v.items) : v.items);
+		        if (v.usageSummary) setUsageSummary(v.usageSummary);
 		        if (!append) setSel(/* @__PURE__ */ new Set());
 		        setHasMore(!!v.hasMore);
 		        setTotal(v.total === void 0 || v.total === null ? null : v.total);
@@ -3464,6 +3465,7 @@ var __defProp = Object.defineProperty;
 		    unknown: "已退场"
 		  };
 		  const countText = total !== null ? "共 " + total + " 条" : items.length + " 条" + (hasMore ? "+" : "");
+		  const [usageSummary, setUsageSummary] = (0, import_react15.useState)(null);
 		  const selCount = sel.size;
 		  return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { children: [
 		    /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: S.toolbar, children: [
@@ -3746,6 +3748,7 @@ var __defProp = Object.defineProperty;
 		    ] }),
 		    /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { ...S.flexRow, marginBottom: 10 }, children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: loading ? "加载中…" : countText }),
+		      usageSummary ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, title: "老化权重效果口径:参与召回尝试的记忆中,进 topN(被注入上下文)的比例", children: "召回使用 " + usageSummary.used + "/" + usageSummary.attempted + "(" + usageSummary.rate + "%)" }) : null,
 		      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "退场筛查" }),
 		      [["", "全部"], ["active", "仅活跃"], ["retired", "仅退场"]].map(([val, label]) => {
 		        const on = retiredFilter === val;
@@ -3849,6 +3852,29 @@ var __defProp = Object.defineProperty;
 		                }
 		              ) : null,
 		              /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "优先级 " + m.priority }),
+		              m.agingWeight != null ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		                "span",
+		                {
+		                  style: {
+		                    fontSize: 11,
+		                    padding: "1px 6px",
+		                    borderRadius: 999,
+		                    whiteSpace: "nowrap",
+		                    border: "1px solid " + (m.agingWeight <= 0.6 ? "var(--dsh-mem-danger)" : "var(--dsh-mem-border)"),
+		                    color: m.agingWeight <= 0.6 ? "var(--dsh-mem-danger)" : "var(--dsh-mem-text-2)"
+		                  },
+		                  title: "老化权重 " + Math.round(m.agingWeight * 100) + "%(读路径衰减系数 max(0.5, 0.5^(Δ天/半衰期)));越低越老",
+		                  children: "老化 " + Math.round(m.agingWeight * 100) + "%"
+		                }
+		              ) : null,
+		              m.usage ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		                "span",
+		                {
+		                  style: S.muted,
+		                  title: "召回使用 " + m.usage.used + "/" + m.usage.attempts + "(进 topN 才算 used)" + (m.usage.lastUsedAt ? ";最近使用 " + fmtTime(new Date(m.usage.lastUsedAt).toISOString()) : "") + (m.usage.lastAttemptAt ? ";最近尝试 " + fmtTime(new Date(m.usage.lastAttemptAt).toISOString()) : ""),
+		                  children: "用 " + m.usage.used + "/" + m.usage.attempts
+		                }
+		              ) : null,
 		              m.score !== null && m.score !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "相关度 " + Number(m.score).toFixed(2) }) : null,
 		              /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { style: S.grow }),
 		              /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: fmtTime(m.updatedAt) }),
@@ -4017,6 +4043,7 @@ var __defProp = Object.defineProperty;
 		  const [preview, setPreview] = (0, import_react16.useState)(null);
 		  const [grownOpen, setGrownOpen] = (0, import_react16.useState)(false);
 		  const [dragOverHall, setDragOverHall] = (0, import_react16.useState)(null);
+		  const [picking, setPicking] = (0, import_react16.useState)(null);
 		  const loadAll = (0, import_react16.useCallback)(() => {
 		    rpc("dsh-memory/rooms-get", {}).then((r) => {
 		      if (r && r.ok) {
@@ -4280,16 +4307,23 @@ var __defProp = Object.defineProperty;
 		            const from = ev.dataTransfer.getData("text/dsh-room");
 		            if (from) beginReclass(from, g.hall);
 		          },
+		          onClick: () => {
+		            if (!picking || busy) return;
+		            const from = picking;
+		            setPicking(null);
+		            beginReclass(from, g.hall);
+		          },
 		          style: {
 		            display: "flex",
 		            alignItems: "center",
 		            gap: 8,
 		            padding: "5px 10px",
 		            background: "var(--dsh-mem-bg-inset)",
-		            outline: dragOverHall === g.hall ? "2px dashed var(--dsh-mem-accent)" : void 0,
-		            outlineOffset: dragOverHall === g.hall ? "-2px" : void 0
+		            outline: dragOverHall === g.hall || picking !== null ? "2px dashed var(--dsh-mem-accent)" : void 0,
+		            outlineOffset: dragOverHall === g.hall || picking !== null ? "-2px" : void 0,
+		            cursor: picking ? "pointer" : void 0
 		          },
-		          title: hiPriv ? "拖入 room 归类到该 hall 下(major/minor;记录随迁,旧名进别名,预览后确认)" : void 0,
+		          title: picking ? "点击此 hall:把「" + picking + "」归入 " + g.hall + " 下(major/minor,预览后确认)" : hiPriv ? "拖入 room 归类到该 hall 下(major/minor;记录随迁,旧名进别名,预览后确认)" : void 0,
 		          children: [
 		            /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("span", { style: { fontSize: 12, fontWeight: 600 }, children: [
 		              g.hall,
@@ -4339,7 +4373,27 @@ var __defProp = Object.defineProperty;
 		            (e.aliases ?? []).length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: "别名: " + (e.aliases ?? []).join(", ") }) : null,
 		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("div", { style: S.grow }),
 		            !hiPriv ? null : /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)(import_jsx_runtime16.Fragment, { children: [
-		              /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("button", { type: "button", disabled: busy, title: "归类到已有 hall 下(major/minor;记录随迁)", onClick: () => beginReclass(e.slug, groups.find((gg) => gg.hall !== majorOf(e.slug))?.hall ?? ""), style: btn, children: "归类" }),
+		              /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
+		                "button",
+		                {
+		                  type: "button",
+		                  disabled: busy,
+		                  title: picking === e.slug ? "再点一次取消挑选;然后点击目标 hall 头完成归类" : "归类到已有 hall 下:点击后选目标 hall(记录随迁,旧名进别名)",
+		                  onClick: () => {
+		                    if (picking === e.slug) {
+		                      setPicking(null);
+		                      return;
+		                    }
+		                    setForm({ action: "rename", from: e.slug, to: "" });
+		                    setPreview(null);
+		                    setPicking(e.slug);
+		                    setMsg(null);
+		                    setError(null);
+		                  },
+		                  style: { ...btn, ...picking === e.slug ? { color: "var(--dsh-mem-accent)", borderColor: "var(--dsh-mem-accent)" } : {} },
+		                  children: picking === e.slug ? "选 hall…" : "归类"
+		                }
+		              ),
 		              /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("button", { type: "button", disabled: busy, title: `改名(= merge 1:1 + 注册表改名)`, onClick: () => {
 		                setForm({ action: "rename", from: e.slug, to: "" });
 		                setPreview(null);

package/dist/contract.d.ts

@@ -765,6 +765,15 @@ export interface UiRecord {
     sourceAnchors: string[];
     /** 检索相关度(列表路径无 score → null)。 */
     score: number | null;
+    /** 老化权重:读路径衰减系数 max(0.5, 0.5^(Δ天/半衰期))(Δ=updatedAt;半衰期 0=关 → null)。 */
+    agingWeight?: number | null;
+    /** 召回使用统计:**进 topN(被注入)才算 used**;参与尝试未进 = 仅 attempts。缺省 = 未装配。 */
+    usage?: {
+        attempts: number;
+        used: number;
+        lastAttemptAt: number | null;
+        lastUsedAt: number | null;
+    } | null;
     /**
      * 是否已退场(软删)。`true` 时该记录在活动列表里仍以「已退场」态呈现(置灰 + 徽标),
      * 可被 `records-restore` 找回——这正是设计要的「不静默消失、可恢复」,而非真删。
@@ -783,6 +792,13 @@ export interface ListRecordsResponse {
     truncated: boolean;
     /** 场景筛选下拉选项(仅 offset===0 时附带)。 */
     scenes?: string[];
+    /** 召回使用汇总(老化权重效果口径:进 topN 才算 used)。未装配 = undefined。 */
+    usageSummary?: {
+        tracked: number;
+        attempted: number;
+        used: number;
+        rate: number;
+    } | null;
     /**
      * Wing 词表(R8 单一事实源:服务端随 list-records 下发,client 不再手抄;仅 offset===0 时附带)。
      * 含 8 角 + `general`(跨域兜底,存量大 reserved 值仍可筛)。缺省(旧服务端)时 client

package/dist/hooks/recall.d.ts

@@ -22,6 +22,7 @@ import type { L1Store } from '../store/l1.js';
 import type { PersonaStore } from '../store/persona.js';
 import type { SceneStore } from '../store/scenes.js';
 import type { SessionModeStore } from '../store/session-modes.js';
+import type { RecallUsageStore } from '../store/recall-usage.js';
 import type { MemoryLogger } from '../types.js';
 import { type OccupancyLedger } from '../util/context-occupancy.js';
 /**
@@ -89,4 +90,6 @@ export declare function registerRecall(ctx: Context, cfg: MemoryConfig, stores:
     l1: L1Store;
     scenes: Record<'chat' | 'work', SceneStore>;
     persona: Record<'chat' | 'work', PersonaStore>;
-}, logger: MemoryLogger, live: LiveSettingsHandle, modes: SessionModeStore, dataDir: string): RecallHooks;
+}, logger: MemoryLogger, live: LiveSettingsHandle, modes: SessionModeStore, dataDir: string, 
+/** 召回使用统计(可选;未装配 = 零成本旁路):进 topN(注入)才算 used。 */
+usage?: RecallUsageStore): RecallHooks;

package/dist/hooks/recall.js

@@ -114,7 +114,9 @@ export function emptyRecallStats(now = Date.now()) {
         updatedAt: now,
     };
 }
-export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
+export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir, 
+/** 召回使用统计(可选;未装配 = 零成本旁路):进 topN(注入)才算 used。 */
+usage) {
     /** 召回去重存储(同会话已注入的记忆不再重复注入;写穿持久化,重启不丢)。 */
     const dedupe = new RecallDedupeStore(dataDir, logger);
     /** 记忆占用流水(账本迁移写穿;重启后历史会话账目由此复生)。 */
@@ -393,6 +395,7 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                         injectedIds: [], suppressedCount: scoped.length - fresh.length,
                         durationMs: Date.now() - searchStart, outcome: 'suppressed',
                     });
+                    usage?.recordAttempt(scoped.map((h) => h.id), []);
                     return decision;
                 }
                 const lines = applyRecallBudget(fresh.map((h) => `- [${h.scene_name ? `${h.type}|${h.scene_name}` : h.type}] ${h.content}`), { maxCharsPerMemory: cfg.recall.maxCharsPerMemory, maxTotalRecallChars: cfg.recall.maxTotalRecallChars });
@@ -404,6 +407,7 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                         injectedIds: [], suppressedCount: scoped.length - fresh.length,
                         durationMs: Date.now() - searchStart, outcome: 'suppressed',
                     });
+                    usage?.recordAttempt(fresh.map((h) => h.id), []);
                     return decision;
                 }
                 st.lastHits = lines.length;
@@ -436,6 +440,8 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                     injectedIds: fresh.slice(0, lines.length).map((h) => h.id), suppressedCount: scoped.length - fresh.length,
                     durationMs: Date.now() - searchStart, outcome: 'injected',
                 });
+                // 使用统计:候选=scoped(尝试),进 topN(注入)=used
+                usage?.recordAttempt(scoped.map((h) => h.id), fresh.slice(0, lines.length).map((h) => h.id));
                 // 入账在成功构造注入消息之后、返回 enter 之前——任何前置抛错路径账目零扰动
                 const led = ledgerFor(payload.agent.id);
                 recordRecallInjection(led, text.length);

package/dist/index.js

@@ -37,6 +37,7 @@ import { registerMemoryTools } from './tools/index.js';
 import { registerSlotTools } from './tools/slots.js';
 import { registerSlotRecall } from './hooks/slot-recall.js';
 import { RoomRegistryStore } from './store/rooms-registry.js';
+import { RecallUsageStore } from './store/recall-usage.js';
 import { registerSlotsProjection } from './projection/slots.js';
 import { errDetail, withFileLog } from './util/filelog.js';
 import { buildRouteChain, resolveModelRoute, invalidateEffortCache } from './llm.js';
@@ -159,6 +160,7 @@ export async function apply(ctx, config) {
         }
     }
     const stores = {
+        usage: undefined, // 装配于下方(依赖 dataDir 就绪)
         l0: new L0Store(dataDir, db, embed, logger),
         l1: new L1Store(dataDir, db, embed, config.recall.strategy, logger, config.recall.decayHalfLifeDays, 
         // §D 第 3 路:图谱回链。图谱不可用时 searchNodes 自带 no-op,不影响双路。
@@ -361,7 +363,11 @@ export async function apply(ctx, config) {
     if (storageOk) {
         flushL0 = registerCapture(ctx, config, runner, stores.l0, logger, live, modes);
     }
-    const recall = registerRecall(ctx, config, stores, logger, live, modes, dataDir);
+    // 召回使用统计(进 topN 才算 used;热路径只碰内存,去抖落盘)
+    const recallUsage = new RecallUsageStore(dataDir, logger);
+    await recallUsage.init();
+    stores.usage = recallUsage;
+    const recall = registerRecall(ctx, config, stores, logger, live, modes, dataDir, recallUsage);
     runner.setAfterRun(recall.invalidateProfile);
     registerMemoryTools(ctx, config, stores, logger, modes, live, ruminate, storageOk ? roomRegistry : undefined);
     // 激活槽位(active slot):工具面 + 常驻注入 + 服务端投影(均走 ctx.effect,可撤销)

package/dist/room-review.d.ts

@@ -65,6 +65,11 @@ export interface RoomMergeStore extends RoomReviewStore {
 export interface RoomRegistryMerge {
     markMerged(fromSlug: string, toSlug: string): Promise<boolean>;
     renameSlug(oldSlug: string, newSlug: string): Promise<boolean>;
+    /** rename 收尾恢复先前状态用(active 条目改名后不掉出标注词表)。 */
+    bySlug?(slug: string): {
+        status: 'active' | 'retired';
+    } | undefined;
+    setStatus?(slug: string, status: 'active' | 'retired'): Promise<boolean>;
 }
 export interface RoomCandidate {
     id: string;
@@ -153,7 +158,9 @@ export declare function mergeRoom(io: {
     dryRun?: boolean;
     cap?: number;
 }): Promise<MergeRoomResult>;
-/** rename = merge 1:1 + 注册表改名(冲突时抛错提示走 merge)。 */
+/** rename = merge 1:1 + 注册表改名(冲突时抛错提示走 merge)。
+ *  归类语义:改名**不是退役**——merge 编排的 markMerged 会把旧条目置 retired,
+ *  这里在改名后恢复其先前状态(active 条目改名后仍 active,不掉出标注词表)。 */
 export declare function renameRoom(io: {
     l1: RoomMergeStore;
     registry: RoomRegistryMerge;

package/dist/room-review.js

@@ -202,11 +202,17 @@ export async function mergeRoom(io, from, to, opts = {}) {
         roomMergeRunning = false;
     }
 }
-/** rename = merge 1:1 + 注册表改名(冲突时抛错提示走 merge)。 */
+/** rename = merge 1:1 + 注册表改名(冲突时抛错提示走 merge)。
+ *  归类语义:改名**不是退役**——merge 编排的 markMerged 会把旧条目置 retired,
+ *  这里在改名后恢复其先前状态(active 条目改名后仍 active,不掉出标注词表)。 */
 export async function renameRoom(io, from, to, opts = {}) {
+    const priorStatus = io.registry.bySlug?.(from)?.status ?? 'active';
     const r = await mergeRoom(io, from, to, opts);
-    if (!r.dryRun && r.applied > 0)
+    if (!r.dryRun && r.applied > 0) {
         await io.registry.renameSlug(from, to);
+        if (priorStatus === 'active')
+            await io.registry.setStatus?.(to, 'active');
+    }
     return r;
 }
 /** 下一条待复查(供 agent 逐个过):记录摘要 + 候选 + 现有 Room 词表 + 剩余数。 */

package/dist/stats.d.ts

@@ -4,6 +4,7 @@ import { type RecallSessionStats } from './hooks/recall.js';
 import type { RebuildController } from './pipeline/rebuild.js';
 import type { RuminateController } from './pipeline/ruminate.js';
 import type { RoomRegistryStore } from './store/rooms-registry.js';
+import type { RecallUsageStore } from './store/recall-usage.js';
 import { type LiveSettingsHandle } from './settings.js';
 import type { GraphStore } from './store/graph-store.js';
 import type { L0Store } from './store/l0.js';
@@ -94,6 +95,8 @@ export declare function registerMemoryRpc(ctx: Context, cfg: MemoryConfig, store
     scenes: Record<MemoryFamily, SceneStore>;
     persona: Record<MemoryFamily, PersonaStore>;
     state: StateStore;
+    /** 召回使用统计(可选)。 */
+    usage?: RecallUsageStore;
     /** 记忆后端(后台边界);未装配时回退为包 l1 的进程内实现。 */
     backend?: MemoryBackend;
     /** 图谱存储(可选:未装配时图谱端点返空,不报错)。 */
@@ -109,6 +112,8 @@ export interface EndpointDeps {
     stores: {
         l0: L0Store;
         l1: L1Store;
+        /** 召回使用统计(可选:未装配 = 列表不带 usage/usageSummary)。 */
+        usage?: RecallUsageStore;
         scenes: Record<MemoryFamily, SceneStore>;
         persona: Record<MemoryFamily, PersonaStore>;
         state: StateStore;
@@ -131,6 +136,8 @@ export interface EndpointDeps {
 /** 端点分发表(导出供测试直调:可精确注入 rebuild/ruminate 等可选控制器,验证 deps 接线)。 */
 export declare function handleEndpoint(endpoint: string, payload: unknown, deps: EndpointDeps): Promise<unknown>;
 /** 浏览器卡片字段(比 MemoryRecord 精简,去掉大 metadata;Hall 从 metadata 提取)。 */
+/** 老化权重(与读路径 applyDecayWeight 同式):max(0.5, 0.5^(Δ天/半衰期));半衰期 ≤0 = 关 → null。 */
+export declare function agingWeightOf(updatedAtMs: number | undefined, halfLifeDays: number, now?: number): number | null;
 export declare function hitToUiRecord(r: {
     id: string;
     content: string;
@@ -147,4 +154,12 @@ export declare function hitToUiRecord(r: {
     family?: string;
     /** 退场判据:`valid_to` 闭合即已退场(软删)。由 `listL1`/`getByIds` 透传。 */
     validTo?: number;
+}, extra?: {
+    agingWeight?: number | null;
+    usage?: {
+        attempts: number;
+        used: number;
+        lastAttemptAt: number | null;
+        lastUsedAt: number | null;
+    } | null;
 }): UiRecord;

package/dist/stats.js

@@ -1007,13 +1007,19 @@ export async function handleEndpoint(endpoint, payload, deps) {
                         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;
             }
@@ -1021,12 +1027,16 @@ export async function handleEndpoint(endpoint, payload, deps) {
             // 接了只会让「仅退场+关键词」永远空结果,不如如实不筛。
             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;
         }
@@ -1633,7 +1643,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 {
@@ -1659,6 +1676,8 @@ export function hitToUiRecord(r) {
         // 但必须给出可见差异。
         retired,
         retiredReason: retired ? (mark?.reason ?? 'unknown') : null,
+        agingWeight: extra?.agingWeight ?? null,
+        usage: extra?.usage ?? null,
     };
 }
 /**

package/dist/store/l1.d.ts

@@ -70,6 +70,8 @@ export declare class L1Store {
     decayHalfLifeDays?: number, 
     /** 图谱路提供者(§D 第 3 路);不传则该路不存在,融合退回双路。 */
     graphLane?: GraphLaneProvider);
+    /** 读路径时效半衰期(天;0=关)。老化权重展示与召回衰减同一事实源。 */
+    get decayHalfLife(): number;
     init(): Promise<void>;
     /** 旧版单文件 records.jsonl 一次性导入检索库,成功后改名 .imported。 */
     private importLegacy;

package/dist/store/l1.js

@@ -56,6 +56,10 @@ export class L1Store {
         this.decayHalfLifeDays = decayHalfLifeDays ?? 30;
         this.graphLaneProvider = graphLane;
     }
+    /** 读路径时效半衰期(天;0=关)。老化权重展示与召回衰减同一事实源。 */
+    get decayHalfLife() {
+        return this.decayHalfLifeDays;
+    }
     async init() {
         await ensureDir(this.recordsDir);
         await this.importLegacy();

package/dist/store/recall-usage.d.ts

@@ -0,0 +1,43 @@
+import type { MemoryLogger } from '../types.js';
+export declare const RECALL_USAGE_FILE_VERSION: 1;
+export interface RecallUsageEntry {
+    attempts: number;
+    used: number;
+    lastAttemptAt: number | null;
+    lastUsedAt: number | null;
+}
+export interface RecallUsageSummary {
+    /** 有统计的记忆条数。 */
+    tracked: number;
+    /** 尝试总次数(Σ attempts)。 */
+    attempted: number;
+    /** 使用总次数(Σ used)。 */
+    used: number;
+    /** 使用率(百分比整数;attempted=0 时 0)。 */
+    rate: number;
+}
+export declare class RecallUsageStore {
+    private readonly logger?;
+    private readonly file;
+    private entries;
+    private loaded;
+    private degraded;
+    private degradedLogged;
+    private writeTimer;
+    private writeChain;
+    constructor(dataDir: string, logger?: MemoryLogger | undefined);
+    init(): Promise<void>;
+    private ensureLoaded;
+    /** 一轮召回:候选集 attempts++/lastAttemptAt=now;used 子集额外 used++/lastUsedAt=now
+     *  (used 不在候选内 = 防御路径,同样算一次尝试——用了就是被尝试过)。 */
+    recordAttempt(candidateIds: readonly string[], usedIds: readonly string[]): void;
+    get(id: string): RecallUsageEntry | undefined;
+    summary(): RecallUsageSummary;
+    /** 立即落盘(去抖窗口内的兜底;测试/停机用)。 */
+    flush(): Promise<void>;
+    /** 同步等待在途写(测试用;无在途写时立即返回)。 */
+    flushSync(): void;
+    private prune;
+    private schedulePersist;
+    private persist;
+}

package/dist/store/recall-usage.js

@@ -0,0 +1,149 @@
+/**
+ * 召回使用统计 sidecar(老化权重效果统计的数据面)。
+ *
+ * 口径(用户裁定):**进 topN(被注入上下文)才算被使用**;参与尝试未进 = 只有
+ * attempts。每轮召回 recordAttempt(候选集, 注入集)——内存即时、去抖原子持久化
+ * (召回是热路径,统计只碰内存 Map)。
+ *
+ * 存储:`recall-usage.json` slots 式 sidecar,与 rooms-registry/session-modes 同族
+ * 纪律:缺失 = 合法空表;损坏/不可读 → 只读降级(内存态照常,停止回写),绝不阻塞
+ * 召回读路径(R2 红线)。
+ */
+import * as path from 'node:path';
+import { readJsonStrict, atomicWriteText, ensureDir } from '../util/io.js';
+export const RECALL_USAGE_FILE_VERSION = 1;
+/** 条目上限(防已退场/被取代记忆的 id 无限累积):超限按 lastAttemptAt 淘汰最旧。 */
+const MAX_ENTRIES = 50_000;
+/** 去抖持久化间隔(召回热路径;窗口内断电最多丢最近统计,不影响记忆本体)。 */
+const PERSIST_DEBOUNCE_MS = 5_000;
+export class RecallUsageStore {
+    logger;
+    file;
+    entries = new Map();
+    loaded = false;
+    degraded;
+    degradedLogged = false;
+    writeTimer;
+    writeChain = Promise.resolve();
+    constructor(dataDir, logger) {
+        this.logger = logger;
+        this.file = path.join(dataDir, 'recall-usage.json');
+    }
+    async init() {
+        await ensureDir(path.dirname(this.file));
+        const read = await readJsonStrict(this.file);
+        if (!read.ok) {
+            if (read.reason !== 'missing') {
+                this.degraded = `${read.reason}${'detail' in read && read.detail ? `: ${read.detail}` : ''}`;
+                this.logger?.warn(`[memory] 召回使用统计只读降级: ${this.degraded}`);
+            }
+            this.loaded = true;
+            return;
+        }
+        const raw = read.value.entries ?? {};
+        for (const [id, e] of Object.entries(raw)) {
+            if (!e || typeof e.attempts !== 'number')
+                continue;
+            this.entries.set(id, {
+                attempts: e.attempts,
+                used: typeof e.used === 'number' ? e.used : 0,
+                lastAttemptAt: typeof e.lastAttemptAt === 'number' ? e.lastAttemptAt : null,
+                lastUsedAt: typeof e.lastUsedAt === 'number' ? e.lastUsedAt : null,
+            });
+        }
+        this.loaded = true;
+    }
+    ensureLoaded() {
+        if (!this.loaded)
+            throw new Error('召回使用统计未初始化(先 await init())');
+    }
+    /** 一轮召回:候选集 attempts++/lastAttemptAt=now;used 子集额外 used++/lastUsedAt=now
+     *  (used 不在候选内 = 防御路径,同样算一次尝试——用了就是被尝试过)。 */
+    recordAttempt(candidateIds, usedIds) {
+        this.ensureLoaded();
+        if (candidateIds.length === 0 && usedIds.length === 0)
+            return;
+        const now = Date.now();
+        const cand = new Set(candidateIds);
+        for (const id of cand) {
+            const e = this.entries.get(id) ?? { attempts: 0, used: 0, lastAttemptAt: null, lastUsedAt: null };
+            e.attempts += 1;
+            e.lastAttemptAt = now;
+            this.entries.set(id, e);
+        }
+        for (const id of usedIds) {
+            const e = this.entries.get(id) ?? { attempts: 0, used: 0, lastAttemptAt: null, lastUsedAt: null };
+            e.used += 1;
+            if (!cand.has(id)) {
+                e.attempts += 1;
+                e.lastAttemptAt = now;
+            }
+            e.lastUsedAt = now;
+            this.entries.set(id, e);
+        }
+        this.prune();
+        this.schedulePersist();
+    }
+    get(id) {
+        this.ensureLoaded();
+        const e = this.entries.get(id);
+        return e ? { ...e } : undefined;
+    }
+    summary() {
+        this.ensureLoaded();
+        let attempted = 0;
+        let used = 0;
+        for (const e of this.entries.values()) {
+            attempted += e.attempts;
+            used += e.used;
+        }
+        return { tracked: this.entries.size, attempted, used, rate: attempted > 0 ? Math.round((used / attempted) * 100) : 0 };
+    }
+    /** 立即落盘(去抖窗口内的兜底;测试/停机用)。 */
+    flush() {
+        if (this.writeTimer) {
+            clearTimeout(this.writeTimer);
+            this.writeTimer = undefined;
+        }
+        return this.persist();
+    }
+    /** 同步等待在途写(测试用;无在途写时立即返回)。 */
+    flushSync() {
+        void this.flush();
+    }
+    prune() {
+        if (this.entries.size <= MAX_ENTRIES)
+            return;
+        const byOldest = [...this.entries.entries()].sort((a, b) => (a[1].lastAttemptAt ?? 0) - (b[1].lastAttemptAt ?? 0));
+        for (const [id] of byOldest.slice(0, this.entries.size - MAX_ENTRIES))
+            this.entries.delete(id);
+    }
+    schedulePersist() {
+        if (this.degraded || this.writeTimer)
+            return;
+        this.writeTimer = setTimeout(() => {
+            this.writeTimer = undefined;
+            void this.persist();
+        }, PERSIST_DEBOUNCE_MS);
+        this.writeTimer.unref?.(); // 不为统计写hold进程(停机即丢窗口内统计,可接受)
+    }
+    async persist() {
+        if (this.degraded)
+            return;
+        this.writeChain = this.writeChain.then(async () => {
+            try {
+                await ensureDir(path.dirname(this.file));
+                const data = { version: RECALL_USAGE_FILE_VERSION, entries: Object.fromEntries(this.entries) };
+                await atomicWriteText(this.file, JSON.stringify(data));
+            }
+            catch (err) {
+                this.degraded = err instanceof Error ? err.message : String(err);
+                if (!this.degradedLogged) {
+                    this.degradedLogged = true;
+                    this.logger?.warn(`[memory] 召回使用统计写入失败,只读降级: ${this.degraded}`);
+                }
+            }
+        });
+        await this.writeChain;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.20.0-beta.13",
+  "version": "0.20.0-beta.15",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",