@modusensus/dsh-mneme 0.7.16 → 0.7.18

package/lib/client.js

@@ -74,6 +74,24 @@ window.__ModuleLoader__.load({
       }, parts.map(([tag, attrs], i) => h(tag, { key: i, ...attrs })));
     };
 
+    // Lucide v1.42 star path（morphicons 官方配套的数据包）。morphicons 本体
+    // 是 ESM-only 的变形动画引擎、插件运行时不允许 require 第三方库，故按
+    // 既有惯例内联图标数据静态渲染；实心/空心由 fill 区分，空心降透明度。
+    const STAR_PATH_D = "M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.123 2.123 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.123 2.123 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.122 2.122 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.122 2.122 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.122 2.122 0 0 0 1.597-1.16z";
+    const ImportanceStars = ({ value = 0, size = 13, className }) => {
+      const filled = Math.min(5, Math.max(0, Math.round(value || 0)));
+      return h("span", { className: `mneme-stars${className ? ` ${className}` : ""}`, role: "img", "aria-label": `${filled}/5` },
+        [0, 1, 2, 3, 4].map((i) => h("svg", { key: i, width: size, height: size, viewBox: "0 0 24 24", "aria-hidden": "true" },
+          h("path", {
+            d: STAR_PATH_D,
+            fill: i < filled ? "currentColor" : "none",
+            stroke: "currentColor",
+            strokeWidth: 1.6,
+            strokeLinejoin: "round",
+            opacity: i < filled ? 1 : 0.35
+          }))));
+    };
+
     // 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).
@@ -87,7 +105,7 @@ window.__ModuleLoader__.load({
       return fetch(path, { ...opts, headers });
     }
 
-    const inject = ["slots", "locale"];
+    const inject = ["slots", "locale", "betterSidebar"];
 
     const NS = "memory";
 
@@ -156,6 +174,11 @@ window.__ModuleLoader__.load({
         "memory.explorer.updated": "更新",
         "memory.explorer.tags": "标签",
         "memory.explorer.importance": "重要性",
+        "memory.explorer.sourceFilter": "来源",
+        "memory.explorer.filterDeposited": "沉淀",
+        "memory.explorer.filterDepositedHint": "只看 autoDream 巩固/更新过的记忆",
+        "memory.explorer.filterArchived": "已归档",
+        "memory.explorer.filterArchivedHint": "只看已归档的记忆（默认列表不含它们）",
         "memory.explorer.topK": "返回数量",
         "memory.explorer.topKOption": "返回 {n} 条",
         "memory.card.open": "在记忆库中查看全文",
@@ -311,6 +334,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": "已保存，镜像同步更新",
@@ -337,6 +362,9 @@ window.__ModuleLoader__.load({
         "memory.status.consolidated": "沉淀的记忆",
         "memory.status.consolidatedEmpty": "autoDream / autoSummarize 沉淀的记忆会出现在这里",
         "memory.status.archivedMemories": "已归档的记忆",
+        "memory.status.viewAll": "查看全部",
+        "memory.status.depositedCount": "沉淀的记忆（{n}）",
+        "memory.status.archivedCount": "已归档的记忆（{n}）",
         "memory.status.archivedEmpty": "没有归档的记忆",
         "memory.status.restore": "恢复",
         "memory.settings.extapi.reveal": "显示",
@@ -420,6 +448,11 @@ window.__ModuleLoader__.load({
         "memory.explorer.updated": "Updated",
         "memory.explorer.tags": "Tags",
         "memory.explorer.importance": "Importance",
+        "memory.explorer.sourceFilter": "Source",
+        "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",
@@ -575,6 +608,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",
@@ -601,6 +636,9 @@ 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.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",
@@ -668,6 +706,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)}",
@@ -687,7 +727,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}",
@@ -695,7 +739,9 @@ window.__ModuleLoader__.load({
       ".mneme-vtab:hover{color:var(--dsw-alias-label-primary)}",
       ".mneme-vtab.mneme-active{color:var(--dsw-alias-state-business-primary)}",
       ".mneme-vtab.mneme-active::after{content:\"\";position:absolute;left:10px;right:10px;bottom:-1px;height:2.5px;border-radius:2px;background:var(--dsw-alias-state-business-primary)}",
-      ".mneme-xtools{position:absolute;right:14px;top:50%;transform:translateY(-50%);display:flex;align-items:center;gap:8px;padding:0}",
+      // transform 会自建层叠上下文：层级必须给在容器上——3 高于吸顶月份头(2)、
+      // 低于详情抽屉(6)，下拉菜单/导入对话框随容器整体上浮。
+      ".mneme-xtools{position:absolute;right:14px;top:50%;transform:translateY(-50%);display:flex;align-items:center;gap:8px;padding:0;z-index:3}",
       ".mneme-xcount{flex:none;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary);white-space:nowrap}",
       // --- three-column browse layout: hairline separators, no outer box ---
       ".mneme-xmain{flex:1;min-height:0;display:flex;flex-direction:row;overflow:hidden}",
@@ -824,10 +870,13 @@ window.__ModuleLoader__.load({
       // --- 侧边栏顶部入口：借宿主「新会话」按钮的原生类名对齐 ---
       // wrapper display:contents 隐身，按钮成为侧边栏弹性布局的直接子元素；
       // 盒模型/间距/收起态 rail 几何全部继承宿主，我们只覆盖配色为次级观感。
+      ".mneme-stars{display:inline-flex;align-items:center;gap:2px}",
+      // width:100% 与「新会话」同宽（同一弹性父容器）；文案对齐交给复制来的
+      // 原生类，不再用 flex:1/text-align:left 覆盖成左对齐。
       ".mneme-topentry{display:contents}",
-      ".mneme-topentry-native{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}",
+      ".mneme-topentry-native{width:100%;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}",
       ".mneme-topentry-native:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}",
-      ".mneme-topentry-native .mneme-topentry-label{flex:1;min-width:0;text-align:left;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
+      ".mneme-topentry-native .mneme-topentry-label{white-space:nowrap}",
       // --- 功能开关：一行一开关，Claude 式安静排版 ---
       ".mneme-featgroup{flex:none;font-size:12px;font-weight:600;letter-spacing:.02em;color:var(--dsw-alias-label-tertiary);margin:16px 0 2px}",
       ".mneme-featrow{display:flex;align-items:center;gap:14px;padding:11px 2px;border-bottom:1px solid var(--dsw-alias-border-l1)}",
@@ -915,7 +964,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)}",
@@ -2356,11 +2405,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;
@@ -2368,30 +2420,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) => {
@@ -2402,7 +2455,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(""));
       };
@@ -2434,8 +2490,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" }),
@@ -2445,7 +2507,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" },
@@ -2465,7 +2533,7 @@ window.__ModuleLoader__.load({
       );
     }
 
-    function StatusPanel({ t }) {
+    function StatusPanel({ t, onBrowse }) {
       return h("div", { className: "mneme-status" },
         h("div", { className: "mneme-statusgrid" },
           h(MemoriesStatusCard, { t }),
@@ -2474,7 +2542,7 @@ window.__ModuleLoader__.load({
           h(LlmStatusCard, { t }),
           h(DreamStatusCards, { t })
         ),
-        h(WorkbenchSection, { t })
+        h(WorkbenchSection, { t, onBrowse })
       );
     }
 
@@ -2560,7 +2628,7 @@ window.__ModuleLoader__.load({
                   value: importance,
                   onChange: (e) => setImportance(Number(e.target.value))
                 }, [1, 2, 3, 4, 5].map((n) => h("option", { key: n, value: n }, "★".repeat(n))))
-              : h("span", { className: "mneme-dmetaval" }, "★".repeat(Math.min(5, Math.max(0, memory.importance || 0)))),
+              : h(ImportanceStars, { className: "mneme-dmetaval", value: memory.importance || 0 }),
             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)),
@@ -2610,8 +2678,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",
@@ -2724,6 +2795,9 @@ 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 [pendingIds, setPendingIds] = useState(() => new Set());
       const [menuOpen, setMenuOpen] = useState(false);
       const [importOpen, setImportOpen] = useState(false);
@@ -2762,7 +2836,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
@@ -2948,7 +3024,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));
@@ -2958,6 +3034,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));
@@ -3003,6 +3090,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") },
@@ -3121,6 +3218,19 @@ 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"))
+            ),
             h("div", { className: "mneme-xcolhead" }, t("memory.explorer.types")),
             h("button", {
               className: type === "all" ? "mneme-xtype mneme-active" : "mneme-xtype",
@@ -3160,7 +3270,7 @@ window.__ModuleLoader__.load({
                         h("div", { className: "mneme-cardtitle" }, m.title || (m.content || "").slice(0, 60)),
                         h("div", { className: "mneme-cardexcerpt" }, m.content || ""),
                         h("div", { className: "mneme-cardfoot" },
-                          h("span", null, "★".repeat(Math.min(5, Math.max(0, m.importance || 0)))),
+                          h(ImportanceStars, { value: m.importance || 0, size: 12 }),
                           m.source && h("span", { className: "mneme-cardsrc", title: m.source }, m.source)
                         )
                       )),
@@ -3253,7 +3363,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 }))
         ),
@@ -3287,19 +3397,34 @@ window.__ModuleLoader__.load({
       const [nativeCls, setNativeCls] = useState("");
       useEffect(() => {
         if (!reactDom || typeof document === "undefined") return undefined;
-        let tries = 0, timer = null, created = null;
+        let tries = 0, timer = null, created = null, mo = null;
+        const findNative = (region) =>
+          region.parentElement.querySelector('[class*="newSession"]')
+          || region.previousElementSibling;
         const attempt = () => {
           const region = document.querySelector('[class*="regionArea"]');
           if (region && region.parentElement) {
             // 「新会话」按钮与 regionArea 同级且紧邻其前，借它的类名获得
             // 与原生侧边栏项完全一致的盒模型（含收起态 rail 几何）。
-            const ns = region.parentElement.querySelector('[class*="newSession"]')
-              || region.previousElementSibling;
+            // 宿主/皮肤会异步改写按钮类名，用 MutationObserver 持续同步，
+            // 否则 portal 按钮会停留在捕获时刻的旧类上（宽度/对齐失配）。
             created = document.createElement("div");
             created.dataset.pluginEntry = "@modusensus/dsh-mneme";
             region.parentElement.insertBefore(created, region);
             setHost(created);
-            setNativeCls(ns?.className || "");
+            setNativeCls(findNative(region)?.className || "");
+            mo = new MutationObserver(() => {
+              const cur = document.querySelector('[class*="regionArea"]');
+              if (!cur || !cur.parentElement) return;
+              const cls = findNative(cur)?.className || "";
+              setNativeCls((prev) => (prev === cls ? prev : cls));
+            });
+            mo.observe(region.parentElement, {
+              attributes: true,
+              attributeFilter: ["class"],
+              childList: true,
+              subtree: true
+            });
             return;
           }
           if (++tries > 40) return; // 放弃 portal，footer 回退保持可用
@@ -3308,6 +3433,7 @@ window.__ModuleLoader__.load({
         attempt();
         return () => {
           clearTimeout(timer);
+          if (mo) mo.disconnect();
           if (created && created.parentElement) created.parentElement.removeChild(created);
         };
       }, []);
@@ -3330,6 +3456,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 注册作为锚点与回退；真实按钮
@@ -3338,7 +3465,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",
@@ -3353,6 +3479,40 @@ window.__ModuleLoader__.load({
           h(MemoryOverlay, { t })
         ));
       });
+
+      // --- better-sidebar 生态 tab（可选软依赖，官方指南 §2.2 契约）---
+      // 'betterSidebar' 声明进 inject + package.json optional peer：未安装
+      // better-sidebar 时服务解析为 undefined，探测条件不成立即静默跳过，
+      // 现有 footer 锚点 + 顶部入口 + sheet 完全不受影响（实测：DSH 运行时
+      // 对 ctx 属性访问有 inject 闸门，未声明就取值会直接 fail 整个 loader
+      // entry，§15 的「不声明纯探测」模式在 DSH 上不可用）。
+      // 服务提供时序仍无保证（better-sidebar 可能晚于本插件加载），短重试
+      // 兜底；注册包在 ctx.effect 里，HMR/禁用时随作用域自动清理。
+      ctx.effect(() => {
+        let tries = 0, timer = null;
+        const attempt = () => {
+          const bs = ctx.betterSidebar;
+          if (bs && typeof bs.registerTab === "function") {
+            try {
+              bs.registerTab({
+                id: "dsh-mneme:memory",
+                title: () => t("memory.view.label"),
+                icon: (size) => h(IconArchiveOutline20, { size }),
+                order: 60,
+                component: () => h(MemoryExplorer, { t })
+              });
+              return;
+            } catch (err) {
+              // id 重复等注册失败不应拖垮其余功能，留一条线索即可
+              console.error("[dsh-mneme] better-sidebar registerTab failed:", err);
+              return;
+            }
+          }
+          if (++tries <= 10) timer = setTimeout(attempt, 1000);
+        };
+        attempt();
+        return () => clearTimeout(timer);
+      }, "dsh-mneme: better-sidebar tab");
     }
 
     exports.apply = apply;

package/lib/store.js

@@ -637,7 +637,7 @@ export function createStore(path) {
     return ts;
   }
 
-  function count(type, { minImportance = null, source = null, includeForgotten = false, includeArchived = false, onlyArchived = false, updatedFrom = null, updatedTo = null } = {}) {
+  function count(type, { minImportance = null, source = null, includeForgotten = false, includeArchived = false, onlyArchived = false, depositedOnly = false, updatedFrom = null, updatedTo = null } = {}) {
     const clauses = [];
     const params = [];
     if (type !== undefined) {
@@ -673,6 +673,12 @@ export function createStore(path) {
     } else if (!includeArchived) {
       clauses.push("archived = 0");
     }
+    // 与 list() 同过滤：deposited 视图的 total 才能和行保持一致。
+    if (depositedOnly) {
+      clauses.push(
+        "(id IN (SELECT record_id FROM receipt_chain WHERE kind IN ('merge', 'update') AND verdict = 'live') OR source = 'dream')"
+      );
+    }
     const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
     return db.prepare(`SELECT count(*) AS c FROM memories ${where}`).get(...params).c;
   }
@@ -924,7 +930,7 @@ export function createStore(path) {
     return rows.map(toRow);
   }
 
-  function list({ type, limit = 50, offset = 0, order = "importance", includeForgotten = false, includeArchived = false, onlyArchived = false, minImportance = null, source = null, updatedFrom = null, updatedTo = null } = {}) {
+  function list({ type, limit = 50, offset = 0, order = "importance", includeForgotten = false, includeArchived = false, onlyArchived = false, depositedOnly = false, minImportance = null, source = null, updatedFrom = null, updatedTo = null } = {}) {
     const clauses = [];
     const params = [];
     if (type) {
@@ -962,6 +968,14 @@ export function createStore(path) {
     } else if (!includeArchived) {
       clauses.push("archived = 0");
     }
+    // depositedOnly：只看 autoDream 巩固过的记忆——receipt_chain 的 merge /
+    // update live verdict（record_id 即保留/更新目标）∪ source="dream" 的
+    // 直写沉淀（记忆库总览）。conflict 不算沉淀：两侧只被仲裁，内容未落。
+    if (depositedOnly) {
+      clauses.push(
+        "(id IN (SELECT record_id FROM receipt_chain WHERE kind IN ('merge', 'update') AND verdict = 'live') OR source = 'dream')"
+      );
+    }
     const { limit: lim, offset: off } = sanitizePage(limit, offset, 50);
     const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
     // "chrono" is pure newest-first — the stable order paged browsing (month

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@modusensus/dsh-mneme",
   "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
-  "version": "0.7.16",
+  "version": "0.7.18",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -39,7 +39,8 @@
         "slots",
         "locale",
         "layout",
-        "connection"
+        "connection",
+        "betterSidebar"
       ],
       "platform": "web"
     },
@@ -53,7 +54,13 @@
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "dsh-better-sidebar": "*"
+  },
+  "peerDependenciesMeta": {
+    "dsh-better-sidebar": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",

package/src/api.js

@@ -178,7 +178,11 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
         // archived=only：只看归档（状态页的归档列表用）。归档行不进默认列表，
         // 所以这是独立的视图开关，而不是 includeArchived 的混看模式。
         const onlyArchived = url.searchParams.get("archived") === "only";
-        const rows = service.list({ type, limit, offset, order, minImportance, source, updatedFrom, updatedTo, onlyArchived });
+        // deposited=only：只看 autoDream 巩固过的记忆（receipt_chain 的
+        // merge/update verdict ∪ source=dream 直写）——状态页「查看全部」
+        // 与记忆库的「沉淀」筛选 chip 共用这个视图。
+        const depositedOnly = url.searchParams.get("deposited") === "only";
+        const rows = service.list({ type, limit, offset, order, minImportance, source, updatedFrom, updatedTo, onlyArchived, depositedOnly });
         // 面板行在 wire DTO 之上补 archived/quality_score——模型工具的输出
         // schema 严格复用 toApiList，扩展只发生在 HTTP 层。
         const items = service.toApiList(rows).map((m, i) => ({
@@ -189,7 +193,7 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
         // Total honors the same filters as the rows, or the pager's
         // has-more math breaks whenever minImportance/source/updated-at
         // bounds are active.
-        sendJson(res, 200, { items, total: service.count(type, { minImportance, source, updatedFrom, updatedTo, onlyArchived }) });
+        sendJson(res, 200, { items, total: service.count(type, { minImportance, source, updatedFrom, updatedTo, onlyArchived, depositedOnly }) });
       } catch {
         sendJson(res, 500, { error: "internal" });
       }