dsh-prime-memory 0.20.0-beta.12 → 0.20.0-beta.14

package/CHANGELOG.md

@@ -17,6 +17,31 @@
   - **建议状态(`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.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 头上即可。
+
+### 新增
+
+- **Hall 页拖拽归类**:room 行可拖(hiPriv 开启时抓手光标),hall 头为放置目标(虚线高亮);松手 = 预填改名(major/minor)并直接出 dryRun 预览,确认后实跑——记录随迁、旧名进别名、分组视图即挂到该 hall 下。触屏/不支持拖放的环境用 room 行「归类」按钮或改名表单里的 hall 快选 chips 兜底。
+- 后端修复:`renameSlug` 目标校验 `isTag` → `isRoomSlug`——此前两级目标(major/minor)被误拒,「归类到 hall 下」这条路实际不通(且 rename 编排会先重写记录再在注册表改名时抛错,留下半程状态)。按 C3 卸除/变更纪律:红测试先行(unit + HTTP 面集成各一),验红后修复回绿。
+
+### 修复
+
+- 同上:`renameSlug` 两级目标校验(beta.5 引入的缺口)。
 ## [0.20.0-beta.12] — 2026-10-02
 
 > lint 清账 + 卸除纪律成文(ENGINEERING-NOTES 新增 C3)。**无功能变更**。

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) }),
@@ -3978,6 +4004,10 @@ var __defProp = Object.defineProperty;
 		  const i = slug.indexOf("/");
 		  return i === -1 ? slug : slug.slice(0, i);
 		}
+		function suffixOf(slug) {
+		  const i = slug.indexOf("/");
+		  return i === -1 ? slug : slug.slice(i + 1);
+		}
 		function downloadCsv(csv, name) {
 		  const blob = new Blob([csv], { type: "text/csv;charset=utf-8" });
 		  const url = URL.createObjectURL(blob);
@@ -4012,6 +4042,7 @@ var __defProp = Object.defineProperty;
 		  const [form, setForm] = (0, import_react16.useState)(null);
 		  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 loadAll = (0, import_react16.useCallback)(() => {
 		    rpc("dsh-memory/rooms-get", {}).then((r) => {
 		      if (r && r.ok) {
@@ -4073,22 +4104,41 @@ var __defProp = Object.defineProperty;
 		      loadAll();
 		    } else setError(r && r.error ? r.error.message : "收编失败");
 		  });
-		  const previewMerge = () => run(async () => {
-		    if (!form) return;
-		    const to = form.to.trim();
+		  const previewMerge = (override) => run(async () => {
+		    const fm = override ?? form;
+		    if (!fm) return;
+		    const to = fm.to.trim();
 		    if (!to) {
 		      setError("目标 slug 不能为空");
 		      return;
 		    }
-		    if (to === form.from) {
+		    if (to === fm.from) {
 		      setError("目标与源相同");
 		      return;
 		    }
-		    const r = await rpc("dsh-memory/room-admin", { action: form.action, from: form.from, to });
+		    const r = await rpc("dsh-memory/room-admin", { action: fm.action, from: fm.from, to });
 		    if (r && r.ok) {
-		      setPreview({ action: form.action, from: form.from, to, notice: String(r.value?.notice ?? "") });
+		      setPreview({ action: fm.action, from: fm.from, to, notice: String(r.value?.notice ?? "") });
 		    } else setError(r && r.error ? r.error.message : "预览失败");
 		  });
+		  const beginReclass = (from, hall) => {
+		    if (!busy) {
+		      setMsg(null);
+		      setError(null);
+		    }
+		    if (!hall) {
+		      setError("尚无 hall:先注册一个(如 dsh-plugin),再归类。");
+		      return;
+		    }
+		    if (majorOf(from) === hall) {
+		      setMsg(`${from} 已在 ${hall} 下。`);
+		      return;
+		    }
+		    const f = { action: "rename", from, to: `${hall}/${suffixOf(from)}` };
+		    setForm(f);
+		    setPreview(null);
+		    void previewMerge(f);
+		  };
 		  const execMerge = () => run(async () => {
 		    if (!preview) return;
 		    const r = await rpc("dsh-memory/room-admin", { action: preview.action, from: preview.from, to: preview.to, dryRun: false });
@@ -4239,41 +4289,83 @@ var __defProp = Object.defineProperty;
 		    msg ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("div", { style: S.hint, children: msg }) : null,
 		    error ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("div", { style: S.error, children: error }) : null,
 		    groups.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("p", { style: S.intro, children: "注册表为空。在上方注册 Hall/Room(如 dsh-plugin),或把自生长 slug「收编」进词表 —— 之后候选标注器会优先把相关记忆挂到这些 slug 上。" }) : groups.map((g) => /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("div", { style: { marginBottom: 10, border: "1px solid var(--dsh-mem-border)", borderRadius: 8, overflow: "hidden" }, children: [
-		      /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 8, padding: "5px 10px", background: "var(--dsh-mem-bg-inset)" }, children: [
-		        /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("span", { style: { fontSize: 12, fontWeight: 600 }, children: [
-		          g.hall,
-		          g.label ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: " (" + g.label + ")" }) : null
-		        ] }),
-		        /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: `合计 ${g.total} 条 · ${g.entries.length} 个 room` }),
-		        /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("div", { style: S.grow }),
-		        /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
-		          "button",
-		          {
-		            type: "button",
-		            disabled: !hiPriv || busy,
-		            title: `预填注册表单为 ${g.hall}/…(注册该 hall 下的小类)`,
-		            onClick: () => setRegSlug(g.hall + "/"),
-		            style: btn,
-		            children: "+小类"
-		          }
-		        )
-		      ] }),
+		      /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)(
+		        "div",
+		        {
+		          onDragOver: (ev) => {
+		            if (!hiPriv || busy) return;
+		            ev.preventDefault();
+		            ev.dataTransfer.dropEffect = "move";
+		            setDragOverHall(g.hall);
+		          },
+		          onDragLeave: () => setDragOverHall((cur) => cur === g.hall ? null : cur),
+		          onDrop: (ev) => {
+		            ev.preventDefault();
+		            setDragOverHall(null);
+		            if (!hiPriv || busy) return;
+		            const from = ev.dataTransfer.getData("text/dsh-room");
+		            if (from) 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
+		          },
+		          title: hiPriv ? "拖入 room 归类到该 hall 下(major/minor;记录随迁,旧名进别名,预览后确认)" : void 0,
+		          children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("span", { style: { fontSize: 12, fontWeight: 600 }, children: [
+		              g.hall,
+		              g.label ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: " (" + g.label + ")" }) : null
+		            ] }),
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: `合计 ${g.total} 条 · ${g.entries.length} 个 room` }),
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("div", { style: S.grow }),
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
+		              "button",
+		              {
+		                type: "button",
+		                disabled: !hiPriv || busy,
+		                title: `预填注册表单为 ${g.hall}/…(注册该 hall 下的小类)`,
+		                onClick: () => setRegSlug(g.hall + "/"),
+		                style: btn,
+		                children: "+小类"
+		              }
+		            )
+		          ]
+		        }
+		      ),
 		      g.entries.map((e) => {
 		        const standalone = e.slug === g.hall;
 		        const count = rooms.find((r) => r.room === e.slug)?.count ?? 0;
 		        const retired = e.status === "retired";
 		        return /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("div", { style: { padding: "4px 10px", borderTop: "1px solid var(--dsh-mem-border)", opacity: retired ? 0.55 : 1 }, children: [
 		          /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" }, children: [
-		            /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("span", { style: { fontSize: 12 }, title: e.description ? `${e.slug} — ${e.description}` : e.slug, children: [
-		              standalone ? e.slug : "· " + e.slug.slice(g.hall.length + 1),
-		              e.source === "pre-registered" ? " ⭐" : ""
-		            ] }),
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)(
+		              "span",
+		              {
+		                style: { fontSize: 12, cursor: hiPriv && !busy ? "grab" : "default" },
+		                draggable: hiPriv && !busy,
+		                onDragStart: (ev) => {
+		                  ev.dataTransfer.setData("text/dsh-room", e.slug);
+		                  ev.dataTransfer.effectAllowed = "move";
+		                },
+		                title: hiPriv && !busy ? "拖到某个 hall 头上归类(major/minor;记录随迁,旧名进别名)" : e.description ? `${e.slug} — ${e.description}` : e.slug,
+		                children: [
+		                  standalone ? e.slug : "· " + e.slug.slice(g.hall.length + 1),
+		                  e.source === "pre-registered" ? " ⭐" : ""
+		                ]
+		              }
+		            ),
 		            e.label ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: e.label }) : null,
 		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: S.muted, children: count + " 条" }),
 		            retired ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: { ...S.muted, color: "var(--dsh-mem-danger)" }, children: "已退役" }) : null,
 		            (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: `改名(= merge 1:1 + 注册表改名)`, onClick: () => {
 		                setForm({ action: "rename", from: e.slug, to: "" });
 		                setPreview(null);
@@ -4303,7 +4395,18 @@ var __defProp = Object.defineProperty;
 		                style: { ...S.input, width: 180, fontSize: 12 }
 		              }
 		            ),
-		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("button", { type: "button", disabled: busy, onClick: previewMerge, style: { ...btn, color: "var(--dsh-mem-accent)", borderColor: "var(--dsh-mem-accent)" }, children: "预览" }),
+		            form.action === "rename" ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { style: { display: "inline-flex", gap: 4, flexWrap: "wrap" }, children: groups.filter((gg) => gg.hall !== majorOf(form.from)).map((gg) => /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
+		              "button",
+		              {
+		                type: "button",
+		                title: `归入 ${gg.hall} 下(${gg.hall}/${suffixOf(form.from)})`,
+		                onClick: () => setForm({ ...form, to: `${gg.hall}/${suffixOf(form.from)}` }),
+		                style: { ...btn, borderRadius: 999, padding: "1px 8px" },
+		                children: gg.hall
+		              },
+		              gg.hall
+		            )) }) : null,
+		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("button", { type: "button", disabled: busy, onClick: () => previewMerge(), style: { ...btn, color: "var(--dsh-mem-accent)", borderColor: "var(--dsh-mem-accent)" }, children: "预览" }),
 		            /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("button", { type: "button", disabled: busy, onClick: () => {
 		              setForm(null);
 		              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/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/dist/store/rooms-registry.d.ts

@@ -50,7 +50,9 @@ export declare class RoomRegistryStore {
     }>;
     /** 改状态(active↔retired);无变化返回 false。 */
     setStatus(slug: string, status: 'active' | 'retired'): Promise<boolean>;
-    /** 改名(merge 1:1 收尾):slug 换名 + 旧 slug 进 aliases。新名与既有条目冲突时走 merge。 */
+    /** 改名(merge 1:1 收尾):slug 换名 + 旧 slug 进 aliases。新名与既有条目冲突时走 merge。
+     *  目标用两级制词表(isRoomSlug)——把 standalone room 归类到 hall 下(改名 major/minor)
+     *  走的就是这条路;isTag 会误拒带 slash 的目标。 */
     renameSlug(oldSlug: string, newSlug: string): Promise<boolean>;
     /** 合并收尾:fromSlug 条目转 retired + toSlug 进 aliases(记录重写由调用方游标执行)。 */
     markMerged(fromSlug: string, toSlug: string): Promise<boolean>;

package/dist/store/rooms-registry.js

@@ -170,11 +170,13 @@ export class RoomRegistryStore {
         await this.persist();
         return true;
     }
-    /** 改名(merge 1:1 收尾):slug 换名 + 旧 slug 进 aliases。新名与既有条目冲突时走 merge。 */
+    /** 改名(merge 1:1 收尾):slug 换名 + 旧 slug 进 aliases。新名与既有条目冲突时走 merge。
+     *  目标用两级制词表(isRoomSlug)——把 standalone room 归类到 hall 下(改名 major/minor)
+     *  走的就是这条路;isTag 会误拒带 slash 的目标。 */
     async renameSlug(oldSlug, newSlug) {
         this.ensureLoaded();
-        if (!isTag(newSlug))
-            throw new Error(`非法 Room slug: ${newSlug}`);
+        if (!isRoomSlug(newSlug))
+            throw new Error(`非法 Room slug: ${newSlug}(两级制:major 或 major/minor)`);
         const found = this.entries.find((e) => e.slug === oldSlug);
         if (!found)
             return false;

package/package.json

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