@modusensus/dsh-mneme 0.7.17 → 0.7.20

package/lib/client.js

@@ -55,7 +55,8 @@ window.__ModuleLoader__.load({
       copy: [["rect", { width: "14", height: "14", x: "8", y: "8", rx: "2", ry: "2" }], ["path", { d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" }]],
       check: [["path", { d: "M20 6 9 17l-5-5" }]],
       inbox: [["polyline", { points: "22 12 16 12 14 15 10 15 8 12 2 12" }], ["path", { d: "M5.45 5.11 2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z" }]],
-      activity: [["path", { d: "M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2" }]]
+      activity: [["path", { d: "M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2" }]],
+      flame: [["path", { d: "M8.5 14.5A2.5 2.5 0 0 0 11 12c0-1.38-.5-2-1-3-1.072-2.143-.224-4.054 2-6 .5 2.5 2 4.9 4 6.5 2 1.6 3 3.5 3 5.5a7 7 0 1 1-14 0c0-1.153.433-2.294 1-3a2.5 2.5 0 0 0 2.5 2.5z" }]]
     };
     const Icon = ({ name, size = 16, className }) => {
       const parts = ICON_PATHS[name];
@@ -92,6 +93,18 @@ window.__ModuleLoader__.load({
           }))));
     };
 
+    // 热度徽章（阶段二）：flame 图标 + 整数百分比，三档配色（热/温/冷）。
+    // /list 仅在 heatEnabled=true 时下发 heat 字段——缺省即不渲染，开关关闭
+    // 时徽章全站自动消失，前端无需感知开关状态。
+    const HeatBadge = ({ value, size = 12 }) => {
+      if (typeof value !== "number" || !Number.isFinite(value)) return null;
+      const pct = Math.round(Math.min(1, Math.max(0, value)) * 100);
+      const tier = pct >= 66 ? "hot" : pct >= 33 ? "warm" : "cold";
+      return h("span", { className: `mneme-heat mneme-heat--${tier}`, title: `${pct}%` },
+        h(Icon, { name: "flame", size, className: "mneme-heatico" }),
+        h("span", { className: "mneme-heatpct" }, `${pct}%`));
+    };
+
     // Unified API fetcher: attaches the optional apiToken (set in the settings
     // view, persisted in localStorage) as a Bearer header. When no token has
     // been configured the header is omitted and the API stays open (default).
@@ -105,6 +118,10 @@ window.__ModuleLoader__.load({
       return fetch(path, { ...opts, headers });
     }
 
+    // ⚠️ 'betterSidebar' 绝不能进模块级 inject（issue #88 实锤）：loader 对
+    // inject 声明的服务是硬等待——未安装 better-sidebar 的环境里整个 entry
+    // 永远 pending（"1 entry did not activate" → Failed to load plugins）。
+    // 软依赖靠内层动态子插件探测（见 apply 内 better-sidebar 挂载块）。
     const inject = ["slots", "locale"];
 
     const NS = "memory";
@@ -174,6 +191,15 @@ window.__ModuleLoader__.load({
         "memory.explorer.updated": "更新",
         "memory.explorer.tags": "标签",
         "memory.explorer.importance": "重要性",
+        "memory.explorer.heat": "热度",
+        "memory.explorer.sourceFilter": "来源",
+        "memory.explorer.sort": "排序",
+        "memory.explorer.heatSort": "热度优先",
+        "memory.explorer.heatSortHint": "对已加载条目按热度降序（页内排序，非全局序；时间树保持时间序）",
+        "memory.explorer.filterDeposited": "沉淀",
+        "memory.explorer.filterDepositedHint": "只看 autoDream 巩固/更新过的记忆",
+        "memory.explorer.filterArchived": "已归档",
+        "memory.explorer.filterArchivedHint": "只看已归档的记忆（默认列表不含它们）",
         "memory.explorer.topK": "返回数量",
         "memory.explorer.topKOption": "返回 {n} 条",
         "memory.card.open": "在记忆库中查看全文",
@@ -329,6 +355,8 @@ window.__ModuleLoader__.load({
         "memory.explorer.detail.save": "保存",
         "memory.explorer.detail.cancel": "取消",
         "memory.explorer.detail.archive": "归档",
+        "memory.explorer.detail.restore": "恢复",
+        "memory.explorer.detail.restored": "已恢复到主列表",
         "memory.explorer.detail.archived": "已归档",
         "memory.explorer.detail.archiveFailed": "操作失败",
         "memory.explorer.detail.saved": "已保存，镜像同步更新",
@@ -355,6 +383,11 @@ window.__ModuleLoader__.load({
         "memory.status.consolidated": "沉淀的记忆",
         "memory.status.consolidatedEmpty": "autoDream / autoSummarize 沉淀的记忆会出现在这里",
         "memory.status.archivedMemories": "已归档的记忆",
+        "memory.status.heatDistribution": "热度分布",
+        "memory.status.heatHint": "热门（≥66%）{hot} · 温热（33–66%）{warm} · 冷却（<33%）{cold}，样本为最近 {sample} 条",
+        "memory.status.viewAll": "查看全部",
+        "memory.status.depositedCount": "沉淀的记忆（{n}）",
+        "memory.status.archivedCount": "已归档的记忆（{n}）",
         "memory.status.archivedEmpty": "没有归档的记忆",
         "memory.status.restore": "恢复",
         "memory.settings.extapi.reveal": "显示",
@@ -438,6 +471,15 @@ window.__ModuleLoader__.load({
         "memory.explorer.updated": "Updated",
         "memory.explorer.tags": "Tags",
         "memory.explorer.importance": "Importance",
+        "memory.explorer.heat": "Heat",
+        "memory.explorer.sourceFilter": "Source",
+        "memory.explorer.sort": "Sort",
+        "memory.explorer.heatSort": "By heat",
+        "memory.explorer.heatSortHint": "Sort loaded items by heat, in-page (not global; the month tree keeps chronological order)",
+        "memory.explorer.filterDeposited": "Deposited",
+        "memory.explorer.filterDepositedHint": "Only memories autoDream consolidated or updated",
+        "memory.explorer.filterArchived": "Archived",
+        "memory.explorer.filterArchivedHint": "Only archived memories (excluded from the default list)",
         "memory.explorer.topK": "Results limit",
         "memory.explorer.topKOption": "Return {n}",
         "memory.card.open": "Open full text in the memory library",
@@ -593,6 +635,8 @@ window.__ModuleLoader__.load({
         "memory.explorer.detail.save": "Save",
         "memory.explorer.detail.cancel": "Cancel",
         "memory.explorer.detail.archive": "Archive",
+        "memory.explorer.detail.restore": "Restore",
+        "memory.explorer.detail.restored": "Restored to the main list",
         "memory.explorer.detail.archived": "Archived",
         "memory.explorer.detail.archiveFailed": "Action failed",
         "memory.explorer.detail.saved": "Saved; mirrors re-rendered",
@@ -619,6 +663,11 @@ window.__ModuleLoader__.load({
         "memory.status.consolidated": "Deposited memories",
         "memory.status.consolidatedEmpty": "Memories deposited by autoDream / autoSummarize appear here",
         "memory.status.archivedMemories": "Archived memories",
+        "memory.status.heatDistribution": "Heat distribution",
+        "memory.status.heatHint": "hot (≥66%) {hot} · warm (33–66%) {warm} · cooled (<33%) {cold}, sampled from the latest {sample}",
+        "memory.status.viewAll": "View all",
+        "memory.status.depositedCount": "Deposited memories ({n})",
+        "memory.status.archivedCount": "Archived memories ({n})",
         "memory.status.archivedEmpty": "Nothing archived",
         "memory.status.restore": "Restore",
         "memory.settings.extapi.reveal": "Reveal",
@@ -686,6 +735,8 @@ window.__ModuleLoader__.load({
     // text-turns-brand-blue active states — no boxed panels).
     const CSS_TAG = "@modusensus/dsh-mneme/drawer.css";
     const css = [
+      // --- explorer shell: container queries let the toolbar adapt to the
+      // better-sidebar workbench pane (~500px) as well as the 1240px sheet ---
       // --- sidebar foot trigger (wide row / collapsed rail icon) ---
       ".mneme-trigger{box-sizing:border-box;cursor:pointer;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:none;align-items:center;gap:8px;margin:4px -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}",
       ".mneme-trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}",
@@ -705,7 +756,11 @@ window.__ModuleLoader__.load({
       ".mneme-entitychip{flex:none;height:26px;padding:0 10px;border-radius:8px;border:none;background:none;color:var(--dsw-alias-state-business-primary);cursor:pointer;font-family:inherit;font-size:12px;line-height:16px;display:inline-flex;align-items:center}",
       ".mneme-entitychip:hover{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,transparent)}",
       // --- main-area memory library page ---
-      ".mneme-x{flex:1;min-height:0;height:100%;width:100%;box-sizing:border-box;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2)}",
+      ".mneme-x{flex:1;min-height:0;height:100%;width:100%;box-sizing:border-box;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);container-type:inline-size}",
+      // 窄容器（better-sidebar 工作台 ~500px）下中央 vtabs 会与右缘悬浮的
+      // 卡片/时间线切换器重叠：容器查询收窄时隐藏切换器，视图模式沿用
+      // localStorage 记忆，宽容器（sheet）不受影响。
+      "@container (max-width: 640px){.mneme-xtools .mneme-seg{display:none}}",
       ".mneme-xbar{position:relative;flex:none;display:flex;align-items:center;justify-content:center;gap:6px;border-bottom:1px solid var(--dsw-alias-border-l2);padding:0 16px;min-height:52px}",
       ".mneme-filterbar{flex:none;display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:8px 16px;border-bottom:1px solid var(--dsw-alias-border-l2)}",
       ".mneme-vtabs{display:flex;align-items:stretch;height:46px}",
@@ -845,6 +900,12 @@ window.__ModuleLoader__.load({
       // wrapper display:contents 隐身，按钮成为侧边栏弹性布局的直接子元素；
       // 盒模型/间距/收起态 rail 几何全部继承宿主，我们只覆盖配色为次级观感。
       ".mneme-stars{display:inline-flex;align-items:center;gap:2px}",
+      // 热度徽章三档：热（橙）/温（次级文字）/冷（弱化文字），冷档藏百分比只留图标。
+      ".mneme-heat{display:inline-flex;align-items:center;gap:2px;font-size:11px;line-height:14px;font-variant-numeric:tabular-nums}",
+      ".mneme-heat--hot{color:var(--dsw-alias-state-warning,#d97706)}",
+      ".mneme-heat--warm{color:var(--dsw-alias-label-secondary)}",
+      ".mneme-heat--cold{color:var(--dsw-alias-label-tertiary)}",
+      ".mneme-heat--cold .mneme-heatpct{display:none}",
       // width:100% 与「新会话」同宽（同一弹性父容器）；文案对齐交给复制来的
       // 原生类，不再用 flex:1/text-align:left 覆盖成左对齐。
       ".mneme-topentry{display:contents}",
@@ -938,7 +999,7 @@ window.__ModuleLoader__.load({
       ".mneme-statusgrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:12px;max-width:1000px;margin:0 auto}",
       ".mneme-statuscard{min-width:0;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:14px}",
       // --- 状态页工作台：让用户看见插件在干活（动态/沉淀/归档） ---
-      ".mneme-wbhead{margin:28px auto 10px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary);max-width:1000px}",
+      ".mneme-wbhead{margin:28px auto 10px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary);max-width:1000px;display:flex;align-items:baseline;justify-content:space-between;gap:8px}",
       ".mneme-wblist{max-width:1000px;display:flex;flex-direction:column;gap:6px}",
       ".mneme-wbrow{display:flex;gap:10px;align-items:flex-start;padding:10px 14px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px}",
       ".mneme-wbdot{flex:none;width:8px;height:8px;border-radius:50%;margin-top:6px;background:var(--dsw-alias-state-success,#2a9d6a)}",
@@ -1023,7 +1084,16 @@ window.__ModuleLoader__.load({
 
     function nodeRadius(n) {
       // mention_count → area-ish growth, clamped so hubs stay legible.
-      return 7 + Math.min(20, Math.max(1, n.mention_count ?? 1)) * 0.55;
+      const base = 7 + Math.min(20, Math.max(1, n.mention_count ?? 1)) * 0.55;
+      // heat projection (0-1 or null): hot entities render slightly larger.
+      if (n.heat == null) return base;
+      return base + (Math.max(0, Math.min(1, n.heat)) - 0.5) * 4;
+    }
+
+    function nodeOpacity(n) {
+      // heat projection: hot entities are bright (opacity 1), cold fade to 0.4.
+      if (n.heat == null) return 1;
+      return 0.4 + 0.6 * Math.max(0, Math.min(1, n.heat));
     }
 
     // Deterministic golden-angle spiral: no two nodes start overlapping, and
@@ -1472,7 +1542,7 @@ window.__ModuleLoader__.load({
                           onClick: () => onNodeClick(n),
                           "data-node": n.name
                         },
-                          h("circle", { r: nodeRadius(n), fill: typeColor(n.type) }),
+                          h("circle", { r: nodeRadius(n), fill: typeColor(n.type), fillOpacity: nodeOpacity(n) }),
                           h("text", { className: "mneme-glabel", y: nodeRadius(n) + 13 }, n.name)
                         ))
                       )
@@ -2379,11 +2449,14 @@ window.__ModuleLoader__.load({
       return [];
     }
 
-    function WorkbenchSection({ t }) {
+    function WorkbenchSection({ t, onBrowse }) {
       const [feed, setFeed] = useState(null); // audit rows（已过滤巩固/总结）
-      const [deposited, setDeposited] = useState(null); // ids 解析出的记忆
-      const [archived, setArchived] = useState(null);
+      const [deposited, setDeposited] = useState(null); // 沉淀记忆首页（服务端 deposited 视图）
+      const [depositedTotal, setDepositedTotal] = useState(0);
+      const [archived, setArchived] = useState(null); // 归档记忆首页
+      const [archivedTotal, setArchivedTotal] = useState(0);
       const [restoring, setRestoring] = useState("");
+      const [wbReload, setWbReload] = useState(0);
 
       const load = useCallback(() => {
         let cancelled = false;
@@ -2391,30 +2464,31 @@ window.__ModuleLoader__.load({
           .then((r) => (r.ok ? r.json() : { items: [] }))
           .then((d) => {
             if (cancelled) return;
-            const rows = (d.items || []).filter((r) =>
-              r.trigger_source === "autoDream" || r.trigger_source === "autoSummarize");
-            setFeed(rows);
-            const ids = [];
-            for (const row of rows) {
-              for (const id of parseRelatedIds(row.related_memory_ids)) {
-                if (!ids.includes(id)) ids.push(id);
-              }
-            }
-            return apiFetch("/api/dsh-mneme/list?limit=300&order=chrono")
-              .then((r2) => (r2.ok ? r2.json() : { items: [] }))
-              .then((d2) => {
-                if (cancelled) return;
-                const byId = new Map((d2.items || []).map((m) => [m.id, m]));
-                setDeposited(ids.map((id) => byId.get(id)).filter(Boolean).slice(0, 8));
-              });
+            setFeed((d.items || []).filter((r) =>
+              r.trigger_source === "autoDream" || r.trigger_source === "autoSummarize"));
           })
           .catch(() => { if (!cancelled) setFeed([]); });
-        apiFetch("/api/dsh-mneme/list?archived=only&limit=50&order=chrono")
-          .then((r) => (r.ok ? r.json() : { items: [] }))
-          .then((d) => { if (!cancelled) setArchived(d.items || []); })
+        // 仪表盘数据源：沉淀/归档各取一小页 + 服务端 total（/list 的 total
+        // 与行同过滤）。长列表不再进状态页——「查看全部」跳记忆库的筛选
+        // 视图，查询收敛到有搜索/分页的地方。
+        apiFetch("/api/dsh-mneme/list?deposited=only&limit=8&order=chrono")
+          .then((r) => (r.ok ? r.json() : { items: [], total: 0 }))
+          .then((d) => {
+            if (cancelled) return;
+            setDeposited(d.items || []);
+            setDepositedTotal(d.total || 0);
+          })
+          .catch(() => { if (!cancelled) setDeposited([]); });
+        apiFetch("/api/dsh-mneme/list?archived=only&limit=3&order=chrono")
+          .then((r) => (r.ok ? r.json() : { items: [], total: 0 }))
+          .then((d) => {
+            if (cancelled) return;
+            setArchived(d.items || []);
+            setArchivedTotal(d.total || 0);
+          })
           .catch(() => { if (!cancelled) setArchived([]); });
         return () => { cancelled = true; };
-      }, []);
+      }, [wbReload]);
       useEffect(() => { load(); }, [load]);
 
       const restore = (id) => {
@@ -2425,7 +2499,10 @@ window.__ModuleLoader__.load({
           body: JSON.stringify({ id, archived: false })
         })
           .then((r) => { if (!r.ok) throw new Error("http"); })
-          .then(() => setArchived((cur) => (cur || []).filter((m) => m.id !== id)))
+          .then(() => {
+            setArchived((cur) => (cur || []).filter((m) => m.id !== id));
+            setArchivedTotal((n) => Math.max(0, n - 1));
+          })
           .catch(() => {})
           .finally(() => setRestoring(""));
       };
@@ -2457,8 +2534,14 @@ window.__ModuleLoader__.load({
                         row.error_message ? ` · ${row.error_message}` : "")
                     ));
                 })),
-        deposited !== null && deposited.length > 0 && h(react.Fragment, null,
-          h("div", { className: "mneme-wbhead" }, t("memory.status.consolidated")),
+        deposited !== null && depositedTotal > 0 && h(react.Fragment, null,
+          h("div", { className: "mneme-wbhead" },
+            h("span", null, t("memory.status.depositedCount").replace("{n}", String(depositedTotal))),
+            onBrowse && depositedTotal > deposited.length && h("button", {
+              type: "button",
+              className: "mneme-footbtn",
+              onClick: () => onBrowse({ deposited: true })
+            }, t("memory.status.viewAll"))),
           h("div", { className: "mneme-wblist" },
             deposited.map((m) => h("div", { className: "mneme-wbmemo", key: m.id },
               h("span", { className: "mneme-xdot", style: { color: memoryTypeColor(m.type) }, "aria-hidden": "true" }),
@@ -2468,7 +2551,13 @@ window.__ModuleLoader__.load({
                   `${typeLabel(t, m.type)} · ${formatRelativeTime(m.updated_at || m.created_at, t)}`))
               )))),
         archived !== null && h(react.Fragment, null,
-          h("div", { className: "mneme-wbhead" }, t("memory.status.archivedMemories")),
+          h("div", { className: "mneme-wbhead" },
+            h("span", null, t("memory.status.archivedCount").replace("{n}", String(archivedTotal))),
+            onBrowse && archivedTotal > archived.length && h("button", {
+              type: "button",
+              className: "mneme-footbtn",
+              onClick: () => onBrowse({ archived: true })
+            }, t("memory.status.viewAll"))),
           archived.length === 0
             ? h("div", { className: "mneme-featsubhint" }, t("memory.status.archivedEmpty"))
             : h("div", { className: "mneme-wblist" },
@@ -2488,16 +2577,56 @@ window.__ModuleLoader__.load({
       );
     }
 
-    function StatusPanel({ t }) {
+    // 热度分布卡（阶段二）：采样最近 200 条的 heat 值做三档分布。自门控——
+    // /list 不下发 heat（heatEnabled=false）时整卡不渲染，前端不感知开关。
+    function HeatStatusCard({ t }) {
+      const [state, setState] = useState({ loading: true, off: false, hot: 0, warm: 0, cold: 0, sample: 0 });
+      useEffect(() => {
+        let cancelled = false;
+        apiFetch("/api/dsh-mneme/list?limit=200&order=chrono")
+          .then((res) => { if (!res.ok) throw new Error("http"); return res.json(); })
+          .then((d) => {
+            if (cancelled) return;
+            const items = d.items || [];
+            if (!items.length || typeof items[0].heat !== "number") {
+              setState({ loading: false, off: true, hot: 0, warm: 0, cold: 0, sample: 0 });
+              return;
+            }
+            let hot = 0, warm = 0, cold = 0;
+            for (const m of items) {
+              if (m.heat >= 0.66) hot++; else if (m.heat >= 0.33) warm++; else cold++;
+            }
+            setState({ loading: false, off: false, hot, warm, cold, sample: items.length });
+          })
+          .catch(() => { if (!cancelled) setState({ loading: false, off: true, hot: 0, warm: 0, cold: 0, sample: 0 }); });
+        return () => { cancelled = true; };
+      }, []);
+      if (state.off) return null;
+      return h(StatusCard, {
+        t,
+        title: t("memory.status.heatDistribution"),
+        loading: state.loading,
+        error: false,
+        num: `${state.hot}`,
+        cap: t("memory.status.heatHint")
+          .replace("{hot}", String(state.hot))
+          .replace("{warm}", String(state.warm))
+          .replace("{cold}", String(state.cold))
+          .replace("{sample}", String(state.sample))
+      });
+    }
+
+    function StatusPanel({ t, onBrowse }) {
       return h("div", { className: "mneme-status" },
         h("div", { className: "mneme-statusgrid" },
           h(MemoriesStatusCard, { t }),
           h(EntitiesStatusCard, { t }),
           h(VectorStatusCard, { t }),
           h(LlmStatusCard, { t }),
-          h(DreamStatusCards, { t })
+          h(DreamStatusCards, { t }),
+          h(HeatStatusCard, { t })
         ),
-        h(WorkbenchSection, { t })
+        h(WorkbenchSection, { t, onBrowse })
       );
     }
 
@@ -2584,6 +2713,9 @@ window.__ModuleLoader__.load({
                   onChange: (e) => setImportance(Number(e.target.value))
                 }, [1, 2, 3, 4, 5].map((n) => h("option", { key: n, value: n }, "★".repeat(n))))
               : h(ImportanceStars, { className: "mneme-dmetaval", value: memory.importance || 0 }),
+            memory.heat != null && h(react.Fragment, null,
+              h("span", { className: "mneme-dmetakey" }, t("memory.explorer.heat")),
+              h("span", { className: "mneme-dmetaval" }, h(HeatBadge, { value: memory.heat, size: 13 }))),
             memory.source && h(react.Fragment, null,
               h("span", { className: "mneme-dmetakey" }, t("memory.explorer.source")),
               h("span", { className: "mneme-dmetaval", title: memory.source }, memory.source)),
@@ -2633,8 +2765,11 @@ window.__ModuleLoader__.load({
               )
             : h(react.Fragment, null,
                 h("button", { type: "button", className: "mneme-btn", onClick: () => setEditing(true) }, t("memory.explorer.detail.edit")),
-                h("button", { type: "button", className: "mneme-btn", disabled: busy, onClick: () => postUpdate({ archived: true }, { archived: true }) },
-                  t("memory.explorer.detail.archive")),
+                memory.archived
+                  ? h("button", { type: "button", className: "mneme-btn", disabled: busy, onClick: () => postUpdate({ archived: false }, { restored: true }) },
+                      t("memory.explorer.detail.restore"))
+                  : h("button", { type: "button", className: "mneme-btn", disabled: busy, onClick: () => postUpdate({ archived: true }, { archived: true }) },
+                      t("memory.explorer.detail.archive")),
                 h("button", {
                   type: "button",
                   className: "mneme-btn",
@@ -2747,6 +2882,10 @@ window.__ModuleLoader__.load({
         catch { return "timeline"; }
       });
       const [dateRange, setDateRange] = useState("all"); // all | 7d | 30d | 90d
+      // 方案 A：沉淀/归档筛选 chip——状态页「查看全部」也会带着它们跳转过来。
+      const [depositedOnly, setDepositedOnly] = useState(false); // 只看 autoDream 巩固
+      const [archivedOnly, setArchivedOnly] = useState(false); // 只看已归档
+      const [heatSort, setHeatSort] = useState(false); // 卡片页内热度降序（阶段二补口）
       const [pendingIds, setPendingIds] = useState(() => new Set());
       const [menuOpen, setMenuOpen] = useState(false);
       const [importOpen, setImportOpen] = useState(false);
@@ -2785,7 +2924,9 @@ window.__ModuleLoader__.load({
       ).toISOString();
       const filterQS = (type === "all" ? "" : `&type=${encodeURIComponent(type)}`)
         + (minImp ? `&minImportance=${minImp}` : "")
-        + (dateFromIso ? `&updatedFrom=${encodeURIComponent(dateFromIso)}` : "");
+        + (dateFromIso ? `&updatedFrom=${encodeURIComponent(dateFromIso)}` : "")
+        + (depositedOnly ? "&deposited=only" : "")
+        + (archivedOnly ? "&archived=only" : "");
       const listUrl = (offset) => `/api/dsh-mneme/list?limit=${PAGE_SIZE}&offset=${offset}${filterQS}&order=chrono`;
 
       // Browse = paged, pure-chronological pages (order=chrono). The default
@@ -2914,6 +3055,13 @@ window.__ModuleLoader__.load({
       // the grouping follows the sort order instead of re-sorting buckets.
       const sorted = [...visible].sort((a, b) =>
         new Date(b.updated_at || b.created_at || 0) - new Date(a.updated_at || a.created_at || 0));
+      // heatSort（阶段二补口，order=heat 的前端实现）：热度是运行时投影、
+      // 无存储序，SQL 排不了；页内对已加载条目降序（非全局序），时间树
+      // 仍走 chrono 不受影响。开关仅在 heat 字段在场上时出现（自门控）。
+      const heatAvailable = visible.some((m) => typeof m.heat === "number");
+      const gridItems = heatSort
+        ? [...sorted].sort((a, b) => (b.heat ?? 0) - (a.heat ?? 0))
+        : sorted;
       const months = [];
       let curMonth = null, curDay = null;
       for (const m of sorted) {
@@ -2971,7 +3119,7 @@ window.__ModuleLoader__.load({
 
       // 编辑保存 / 归档的本地落账：替换或移除对应行；镜像由后端重渲染。
       // 归档从所有视图移除（列表默认只看未归档），并清空选中。
-      const applyMemoryUpdate = (updated, { archived = false } = {}) => {
+      const applyMemoryUpdate = (updated, { archived = false, restored = false } = {}) => {
         if (archived) {
           setItems((cur) => cur.filter((m) => m.id !== updated.id));
           setRemoteItems((cur) => (cur ? cur.filter((m) => m.id !== updated.id) : cur));
@@ -2981,6 +3129,17 @@ window.__ModuleLoader__.load({
           setTimeout(() => setToastMsg(""), 2500);
           return;
         }
+        if (restored) {
+          // 恢复：行离开当前视图（抽屉只能从归档浏览列表打开它），回主列表
+          // 由下一次筛选切换/刷新自然带出。
+          setItems((cur) => cur.filter((m) => m.id !== updated.id));
+          setRemoteItems((cur) => (cur ? cur.filter((m) => m.id !== updated.id) : cur));
+          setTotal((n) => Math.max(0, n - 1));
+          setSelectedId(null);
+          setToastMsg(t("memory.explorer.detail.restored"));
+          setTimeout(() => setToastMsg(""), 2500);
+          return;
+        }
         const replace = (m) => (m.id === updated.id ? updated : m);
         setItems((cur) => cur.map(replace));
         setRemoteItems((cur) => (cur ? cur.map(replace) : cur));
@@ -3026,6 +3185,16 @@ window.__ModuleLoader__.load({
         setView("entity");
       };
 
+      // 状态页「查看全部」入口：跳回记忆库并预置对应筛选（清搜索态，避免
+      // remoteItems 盖过浏览列表）。
+      const browseWithFilter = (patch) => {
+        setDepositedOnly(!!patch.deposited);
+        setArchivedOnly(!!patch.archived);
+        setQuery("");
+        setRemoteItems(null);
+        setView("memory");
+      };
+
       const subviews = [
         { key: "memory", label: t("memory.explorer.tabMemory") },
         { key: "entity", label: t("memory.explorer.tabEntities") },
@@ -3144,6 +3313,32 @@ window.__ModuleLoader__.load({
                   onClick: () => setMinImp(v)
                 }, v === 0 ? t("memory.tab.all") : `★${v}+`))
             ),
+            h("div", { className: "mneme-xcolhead" }, t("memory.explorer.sourceFilter")),
+            h("div", { className: "mneme-xrow" },
+              h("button", {
+                className: depositedOnly ? "mneme-chip mneme-active" : "mneme-chip",
+                title: t("memory.explorer.filterDepositedHint"),
+                onClick: () => setDepositedOnly(!depositedOnly)
+              }, t("memory.explorer.filterDeposited")),
+              h("button", {
+                className: archivedOnly ? "mneme-chip mneme-active" : "mneme-chip",
+                title: t("memory.explorer.filterArchivedHint"),
+                onClick: () => setArchivedOnly(!archivedOnly)
+              }, t("memory.explorer.filterArchived"))
+            ),
+            heatAvailable && h(react.Fragment, null,
+              h("div", { className: "mneme-xcolhead" }, t("memory.explorer.sort")),
+              h("div", { className: "mneme-xrow" },
+                h("button", {
+                  className: heatSort ? "mneme-chip mneme-active" : "mneme-chip",
+                  title: t("memory.explorer.heatSortHint"),
+                  onClick: () => {
+                    setHeatSort(!heatSort);
+                    if (!heatSort) switchViewMode("cards"); // 排序只作用于卡片网格
+                  }
+                }, t("memory.explorer.heatSort"))
+              )
+            ),
             h("div", { className: "mneme-xcolhead" }, t("memory.explorer.types")),
             h("button", {
               className: type === "all" ? "mneme-xtype mneme-active" : "mneme-xtype",
@@ -3168,7 +3363,7 @@ window.__ModuleLoader__.load({
                     ? h("div", { className: "mneme-xempty", style: { gridColumn: "1 / -1" } },
                         h(Icon, { name: "inbox", size: 20, className: "mneme-xemptyico" }),
                         t("memory.explorer.empty"))
-                    : sorted.map((m) => h("button", {
+                    : gridItems.map((m) => h("button", {
                         key: m.id,
                         type: "button",
                         className: m.id === selectedId ? "mneme-card mneme-active" : "mneme-card",
@@ -3184,6 +3379,7 @@ window.__ModuleLoader__.load({
                         h("div", { className: "mneme-cardexcerpt" }, m.content || ""),
                         h("div", { className: "mneme-cardfoot" },
                           h(ImportanceStars, { value: m.importance || 0, size: 12 }),
+                          h(HeatBadge, { value: m.heat }),
                           m.source && h("span", { className: "mneme-cardsrc", title: m.source }, m.source)
                         )
                       )),
@@ -3276,7 +3472,7 @@ window.__ModuleLoader__.load({
       })
         ),
         view === "entity" && h(EntityPanel, { t, focusEntity: graphFocus, onJumpMemory: jumpToMemory }),
-        view === "status" && h(StatusPanel, { t }),
+        view === "status" && h(StatusPanel, { t, onBrowse: browseWithFilter }),
         view === "settings" && h("div", { className: "mneme-set" },
           h("div", { className: "mneme-set-inner" }, h(SettingsContent, { t }))
         ),
@@ -3369,6 +3565,7 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
+      const t = ctx.locale.bind(NS);
       ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-mneme: dictionaries");
 
       // 记忆库唯一入口：sidebar.footer.action 注册作为锚点与回退；真实按钮
@@ -3377,7 +3574,6 @@ window.__ModuleLoader__.load({
       // v0.7.15 起不再注册 conversation.view tab——对话内嵌的面板被悬浮
       // 输入框遮挡、挤压会话布局，sheet 页是更舒服的承载方式。
       ctx.slots.inject("sidebar.footer.action", () => {
-        const t = ctx.locale.bind(NS);
         return ctx.slots.register({
           name: "sidebar.footer.action",
           id: "dsh-mneme",
@@ -3392,6 +3588,48 @@ window.__ModuleLoader__.load({
           h(MemoryOverlay, { t })
         ));
       });
+
+      // --- better-sidebar 生态 tab（可选软依赖）---
+      // ⚠️ 平台事实（issue #88 实测 + dsh-server-deck 同款方案）：模块级
+      // inject 声明 betterSidebar 是硬等待——未安装 bs 的环境整个 entry
+      // pending（"1 entry did not activate" → Failed to load plugins），
+      // v0.7.18 即因此对无 bs 用户启动失败。正确双模式（server-deck 验证
+      // 过）：外层入口零 inject 立即激活（独立模式保底）；tab 注册挂在内层
+      // 动态子插件 `ctx.plugin({ inject: ['betterSidebar'] })`，由 cordis
+      // 原生等待服务——bs 未装时该内层 fiber 永远 INACTIVE，静默无害。
+      // 兄弟上下文取未声明属性会直接抛错（"cannot get property without
+      // inject"），轮询探测方案不可用。
+      ctx.effect(() => {
+        let dead = false;
+        try {
+          ctx.plugin?.({
+            name: "dsh-mneme:bs-tab",
+            inject: ["betterSidebar"],
+            apply: (bsCtx) => {
+              bsCtx.effect(() => {
+                if (dead) return;
+                const reg = bsCtx.betterSidebar;
+                if (!reg || typeof reg.registerTab !== "function") return;
+                try {
+                  reg.registerTab({
+                    id: "dsh-mneme:memory",
+                    title: () => t("memory.view.label"),
+                    icon: (size) => h(IconArchiveOutline20, { size }),
+                    order: 60,
+                    component: () => h(MemoryExplorer, { t })
+                  });
+                } catch (err) {
+                  // id 重复等注册失败不应拖垮其余功能，留一条线索即可
+                  console.error("[dsh-mneme] better-sidebar registerTab failed:", err);
+                }
+              }, "dsh-mneme: better-sidebar tab");
+            }
+          });
+        } catch (err) {
+          console.error("[dsh-mneme] better-sidebar mount failed:", err);
+        }
+        return () => { dead = true; };
+      }, "dsh-mneme: better-sidebar mount");
     }
 
     exports.apply = apply;

package/lib/config.js

@@ -1,4 +1,5 @@
 import z from "@deepseek-ai/schemastery";
+import { TYPE_DECAY_DEFAULTS } from "./heat.js";
 
 export const Config = z.object({
   memoryDir: z.string().default("~/.dsh/memory"),
@@ -301,6 +302,24 @@ export const Config = z.object({
   // reaches any service; a persisted panel_mode="light" (settings kv) counts
   // as lightMode=true too and wins over the bundle config.
   lightMode: z.boolean().default(false),
+
+  // --- heat: v0.7.0 self-evolution (heat + interest drift) ----------------
+  // 总开关，默认关（v0.7.12+ 用户已习惯无 heat 行为，默认开=全员行为变更）。
+  // 开启后：提供热度字段 / sleep 降级联合判定保护 / 前端热度投影，不改变
+  // 召回排序。关闭则跳过所有 heat 计算与热度触达，sleep 降级退回纯时间分层。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  heatEnabled: z.boolean().default(false),
+  // 幂律形状参数 α（heat = 1/(1+λΔt)^α），越大衰减越快。
+  heatGlobalAlpha: z.number().min(0.1).max(5).default(1.2),
+  // per-type 衰减因子 λ；λ=0 的类型免疫（热度恒 1.0，sleep 永不降级）。
+  // 未知类型走默认 0.002。dict 的键为 type 字符串、值为数字 λ。
+  heatTypeDecay: z.dict(z.number(), z.string()).default({ ...TYPE_DECAY_DEFAULTS }),
+  // sleep 降级联合判定的热度下限：heat < 该值 且 importance<5 才允许降级。
+  sleepHeatThreshold: z.number().min(0).max(1).default(0.05),
+  // recordRecall 默认值（recall_runs 记录默认开；显式传 false 的调用方不受影响）。
+  recallRecordDefault: z.boolean().default(true),
+  // recall_runs 滚动清理保留天数。
+  recallRetentionDays: z.natural().min(1).max(3650).default(90),
 });
 
 // Fields forced to false by the light-mode preset. Everything not listed here
@@ -315,7 +334,9 @@ const LIGHT_MODE_OFF = [
   "hybridInject",
   "searchSemanticDedup",
   "selectiveInjectEnabled",
-  "bm25SearchEnabled"
+  "bm25SearchEnabled",
+  // 轻量模式不开热计算（heat 属于重型增强；关掉后 sleep 降级也退回纯时间分层）。
+  "heatEnabled"
 ];
 
 /**

package/lib/dream/sleep.js

@@ -18,6 +18,7 @@ import { randomUUID, createHash } from "node:crypto";
 import { validateDecisions, applyDecisions } from "./decisions.js";
 import { findPotentialConflicts } from "./clustering.js";
 import { buildReceipt, withEffortFallback } from "../dream.js";
+import { computeHeat } from "../heat.js";
 
 const SUMMARY_MAX = 120;
 // Conflict similarity threshold per strictness level (v0.4.0):
@@ -242,10 +243,22 @@ function phaseDemotion(service, config, logger, runId, signal = null) {
   for (const m of service.all()) {
     if (signal?.aborted) break;
     if (m.archived || m.forgotten) continue;
-    const ref = m.last_accessed_at ?? m.updated_at ?? m.created_at;
+    const ref = m.last_accessed_at ?? m.created_at;
     if (!ref) continue;
     const t = new Date(ref).getTime();
     if (Number.isNaN(t)) continue;
+    // v0.7.0 热联合判定（仅 heatEnabled 时启用；默认关则退回纯时间分层，
+    // 与 v0.7.12 行为一致）：时间窗之外再加两道保护闸——热度低于
+    // sleepHeatThreshold 且 importance<5 才允许降级。λ=0 的免疫类型 heat 恒
+    // 1.0 天然豁免（preference/pattern/summary 永不因 sleep 降级）；importance
+    // ≥5 的紧要记忆无论多冷都保留。`冷但重要` 与 `热但低值` 均不满足条件。
+    const heatOn = config.heatEnabled !== false;
+    if (heatOn) {
+      const heat = computeHeat(m, Date.now(), config);
+      const heatProtected = heat >= (config.sleepHeatThreshold ?? 0.05);
+      const important = (m.importance ?? 0) >= 5;
+      if (heatProtected || important) continue;
+    }
     if (t < compressCut) {
       service.setArchived(m.id, true);
       archived.push(m.id);