@modusensus/dsh-mneme 0.7.17 → 0.7.18

package/README.en.md

@@ -7,7 +7,7 @@ English | [简体中文](README.md)
 [![npm version](https://img.shields.io/npm/v/@modusensus/dsh-mneme?color=blue&label=npm)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Awesome](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
-[![tests](https://img.shields.io/badge/tests-664%20passed-success)](https://github.com/modusensus/dsh-mneme)
+[![tests](https://img.shields.io/badge/tests-667%20passed-success)](https://github.com/modusensus/dsh-mneme)
 
 > A cross-session memory plugin for DeepSeek Harness: it lets the Agent remember you, remember your projects, and organize memories automatically. **Mneme** (Μνήμη) — named after Mnemosyne, the Greek goddess of memory who presides over memory and dreams, just as autoDream consolidates memories in the background.
 
@@ -166,6 +166,7 @@ Every **background LLM call** (autoDream consolidation + summary, autoSummarize
 
 | Version | Highlights |
 |------|------|
+| **v0.7.18** | Ecosystem step one + query convergence: better-sidebar soft integration (inject declaration + optional peer `dsh-better-sidebar` + registerTab reusing the four views, safe skip when absent; narrow-container `@container` adaptation) + `/list?deposited=only` view (receipt_chain ∪ source=dream) + deposited/archived filter chips in the library + status-page dashboard (server totals + view-all jumps) + drawer restore for archived memories; 667 tests green |
 | **v0.7.17** | Panel polish: sidebar entry continuously aligned with the host (MutationObserver syncs the New-Session class + `width:100%` + native centering restored, resilient to async skin rewrites) + importance rendered as Lucide star glyphs (`ImportanceStars` filled/hollow component replacing text ★) + toolbar dropdown stacking fix (z-index moved to the container; export/import menu no longer painted under the sticky month header); 664 tests green |
 | **v0.7.16** | Fixed autoDream empty-body failures on thinking models (`no json array in llm output`): restored config-first routing (settings "consolidation model" wins, Issue #25) + reasoningEffort auto-retry without effort on rejection + honest `llm_audit` error on parse failure; backfilled API-route tests (/delete, /entities, /external-api) + lib runtime smoke; 662 tests green |
 | **v0.7.15** | Desktop adaptation: library panel redesign + 30-key feature-flag UI (features API) + status dashboard + import/export (mirror-isomorphic md golden loop) + token masking by default; 645 tests green |
@@ -210,7 +211,7 @@ Every **background LLM call** (autoDream consolidation + summary, autoSummarize
 | v0.7.1–0.7.8 | ✅ Done | Issue fixes + graph backfill | tags↔entity_attrs bridge, inline-confirm delete, sidebar trigger toggle, brace escaping, user/fact layered types + stats endpoint (later removed), prefix-id resolution (later removed), sleep batch entity extraction, snapshotEvents() DSH compat; 764→812 tests green |
 | v0.7.9 | ✅ Done | lib-sync gate | Issue #65: src-only shim silently killed the shipped lib — synced lib + pre-publish src↔lib consistency check + lib smoke tests; 815 tests green |
 | v0.7.10–0.7.12 | ✅ Done | Panel redesign + near-rewrite | UX upgrades (color dots, pan/zoom, pagination, global search), then near-rewrite: inlined panel → pure HTTP API + standalone CLI + lightMode; TYPES narrowed 8→6 |
-| v0.7.13–0.7.17 | ✅ Done | Distillation, security, desktop, dream fix, panel polish | codingRetrospect + 429 governor; private reasoning blocks dropped (CWE-200); desktop panel redesign + feature flags; autoDream thinking-model empty-body fix + backfilled tests; sidebar entry alignment + star glyphs + menu stacking polish; 664 tests green |
+| v0.7.13–0.7.18 | ✅ Done | Distillation, security, desktop, dream fix, panel polish, ecosystem | codingRetrospect + 429 governor; private reasoning blocks dropped (CWE-200); desktop panel redesign + feature flags; autoDream thinking-model empty-body fix + backfilled tests; sidebar entry alignment + star glyphs + menu stacking polish; better-sidebar soft integration + deposited/archived library views; 667 tests green |
 | **v0.8.0** | 🚧 Planned (late Sep) | Graph enhancement | Interest-drift visualization + scope isolation (issue #17) + cross-workspace sharing |
 
 > All new capabilities ship as **toggleable features** (enabled/disabled via configuration), conservatively on by default and never breaking existing behavior. The `failure_memories` table and the autoDream decision engine have already paved the way for future reflective growth.

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/@modusensus/dsh-mneme?color=blue&label=npm)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Awesome](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
-[![tests](https://img.shields.io/badge/tests-664%20passed-success)](https://github.com/modusensus/dsh-mneme)
+[![tests](https://img.shields.io/badge/tests-667%20passed-success)](https://github.com/modusensus/dsh-mneme)
 [![CI](https://img.shields.io/github/actions/workflow/status/modusensus/dsh-mneme/ci.yml)](https://github.com/modusensus/dsh-mneme/actions)
 [![node](https://img.shields.io/badge/node-24%2B-blue)](https://nodejs.org)
 [![npm downloads](https://img.shields.io/npm/dm/@modusensus/dsh-mneme?color=blue&label=downloads)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
@@ -216,6 +216,7 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
 
 | 版本 | 亮点 |
 |------|------|
+| **v0.7.18** | 生态第一步 + 查询收敛：better-sidebar 软集成（inject 声明 + optional peer `dsh-better-sidebar` + registerTab 复用四视图，未装安全跳过；窄容器 `@container` 适配）+ `/list?deposited=only` 沉淀视图（receipt_chain ∪ source=dream）+ 记忆库沉淀/已归档筛选 chip + 状态页仪表盘化（统计 + 查看全部跳转预置筛选）+ 抽屉归档记忆「恢复」；667 测试全绿 |
 | **v0.7.17** | 面板体验细化：侧边栏入口持续对齐宿主（MutationObserver 同步「新会话」类名 + `width:100%` + 交还原生居中，皮肤异步改写不再失配）+ 重要性星级换 Lucide 星形（`ImportanceStars` 实心/空心组件，替换文本 ★）+ 工具栏下拉层级修复（z-index 提到容器，导出/导入菜单不再被吸顶月份头遮挡）；664 测试全绿 |
 | **v0.7.16** | 修复 autoDream 在 thinking 模型上空体 failed（`no json array in llm output`）：恢复 config-first 路由（设置面板「巩固模型」生效，Issue #25）+ reasoningEffort 被拒自动去掉重试一次 + 解析失败如实记 llm_audit error 并带原始输出头日志；补测 API 路由空白（/delete、/entities、/external-api）+ lib 运行时冒烟（src↔lib 一致性）；662 测试全绿 |
 | **v0.7.15** | 桌面端适配：记忆库面板重设计（撤对话 tab → 居中非全屏 sheet、卡片网格/时间线双视图、右侧详情抽屉、编辑/归档/关联实体）+ 侧边栏入口上移工作区上方（借用宿主原生类名对齐、收起态零位移）+ 功能开关 30 键上 UI（features API，巩固模型与 embedding 提供方可配）+ 状态页工作台（巩固卡/工作动态流/沉淀记忆/归档恢复）+ 导入导出（镜像同构 md 黄金闭环）+ Token 面板默认遮蔽；645 测试全绿 |

package/lib/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" });
       }

package/lib/client.js

@@ -105,7 +105,7 @@ window.__ModuleLoader__.load({
       return fetch(path, { ...opts, headers });
     }
 
-    const inject = ["slots", "locale"];
+    const inject = ["slots", "locale", "betterSidebar"];
 
     const NS = "memory";
 
@@ -174,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": "在记忆库中查看全文",
@@ -329,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": "已保存，镜像同步更新",
@@ -355,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": "显示",
@@ -438,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",
@@ -593,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",
@@ -619,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",
@@ -686,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)}",
@@ -705,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}",
@@ -938,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)}",
@@ -2379,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;
@@ -2391,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) => {
@@ -2425,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(""));
       };
@@ -2457,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" }),
@@ -2468,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" },
@@ -2488,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 }),
@@ -2497,7 +2542,7 @@ window.__ModuleLoader__.load({
           h(LlmStatusCard, { t }),
           h(DreamStatusCards, { t })
         ),
-        h(WorkbenchSection, { t })
+        h(WorkbenchSection, { t, onBrowse })
       );
     }
 
@@ -2633,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",
@@ -2747,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);
@@ -2785,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
@@ -2971,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));
@@ -2981,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));
@@ -3026,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") },
@@ -3144,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",
@@ -3276,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 }))
         ),
@@ -3369,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 注册作为锚点与回退；真实按钮
@@ -3377,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",
@@ -3392,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.17",
+  "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" });
       }

package/src/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/test/api.test.js

@@ -994,3 +994,58 @@ test("GET /api/dsh-mneme/list?archived=only lists just archived rows; default li
   await route.handler(req("/api/dsh-mneme/list"), back);
   assert.equal(JSON.parse(back.body).total, 2);
 });
+
+test("GET /api/dsh-mneme/list?deposited=only lists dream-touched memories (receipts ∪ source=dream)", async () => {
+  const { routes, service } = setup();
+  const plain = service.saveWithDedupe({ type: "preference", title: "无关", content: "plain" });
+  const merged = service.saveWithDedupe({ type: "project", title: "被巩固", content: "merged" });
+  const updated = service.saveWithDedupe({ type: "decision", title: "被更新", content: "updated" });
+  service.saveWithDedupe({ type: "summary", title: "总览", content: "overview", source: "dream" });
+  const ids = [plain, merged, updated].map((r) => r.memory.id);
+
+  // 巩固账本：merge 落在 keepSource、update 落在目标；conflict 只仲裁不落
+  // 内容，不算沉淀。verdict='live' 才有效。
+  service.saveReceipt({
+    receipt_id: "r-merge", run_id: "run-1", record_id: merged.memory.id, kind: "merge",
+    input_digest: "d1", keep_source: merged.memory.id, sources: [merged.memory.id, ids[0]],
+    verdict: "live", count_before: 2, count_after: 1, policy_epoch: 0,
+    created_at: new Date().toISOString()
+  });
+  service.saveReceipt({
+    receipt_id: "r-update", run_id: "run-1", record_id: updated.memory.id, kind: "update",
+    input_digest: "d2", verdict: "live", count_before: 1, count_after: 1,
+    policy_epoch: 0, created_at: new Date().toISOString()
+  });
+  service.saveReceipt({
+    receipt_id: "r-conflict", run_id: "run-1", record_id: "winner-x", kind: "conflict",
+    input_digest: "d3", winner_id: "winner-x", loser_id: "loser-y", verdict: "live",
+    count_before: 2, count_after: 2, policy_epoch: 0, created_at: new Date().toISOString()
+  });
+
+  const route = routes.find((r) => r.path === "/api/dsh-mneme/list");
+  const res = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/list?deposited=only"), res);
+  const data = JSON.parse(res.body);
+  assert.deepEqual(
+    data.items.map((m) => m.title).sort(),
+    ["总览", "被巩固", "被更新"],
+    "deposited view = receipt merge/update records ∪ source=dream writes"
+  );
+  assert.equal(data.total, 3, "total honors the deposited filter");
+
+  // 默认列表不受 deposited 过滤影响
+  const def = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/list"), def);
+  assert.equal(JSON.parse(def.body).total, 4);
+
+  // 与 archived=only 可叠加：归档的沉淀记忆才出现在交集视图里
+  const upd = routes.find((r) => r.path === "/api/dsh-mneme/update");
+  const arch = new FakeRes();
+  await upd.handler(req("/api/dsh-mneme/update", "POST", { id: merged.memory.id, archived: true }), arch);
+  assert.equal(arch.statusCode, 200);
+  const both = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/list?deposited=only&archived=only"), both);
+  const bothData = JSON.parse(both.body);
+  assert.deepEqual(bothData.items.map((m) => m.title), ["被巩固"]);
+  assert.equal(bothData.total, 1);
+});

package/test/client.test.js

@@ -219,6 +219,45 @@ test("importance renders as star glyphs, not raw text stars", () => {
   );
 });
 
+// better-sidebar ecosystem integration is an optional capability (official
+// external-plugin-guide §2.2): 'betterSidebar' IS declared in inject (DSH's
+// runtime gates ctx property access on the inject declaration — probing
+// without declaring fails the whole loader entry, verified in the field) and
+// marked as an optional peer dependency, so when it is absent the service
+// resolves to undefined and registration skips gracefully. Registration
+// probes at runtime inside a named ctx.effect (scope cleanup on HMR/disable)
+// with a bounded retry for service-provision ordering.
+test("better-sidebar tab declares optional inject, probes, and skips gracefully", () => {
+  assert.ok(
+    /const inject = \["slots", "locale", "betterSidebar"\];/.test(clientSource),
+    "module inject must declare betterSidebar — DSH gates ctx property access on it"
+  );
+  assert.ok(
+    /const bs = ctx\.betterSidebar;[\s\S]{0,60}typeof bs\.registerTab === "function"/.test(clientSource),
+    "the tab registration must still probe ctx.betterSidebar at runtime (undefined when absent)"
+  );
+  assert.ok(
+    /id: "dsh-mneme:memory"/.test(clientSource),
+    "the registered tab id must be package-prefixed"
+  );
+  assert.ok(
+    /title: \(\) => t\("memory\.view\.label"\)/.test(clientSource),
+    "the tab title must reuse the localized 记忆库 label"
+  );
+  assert.ok(
+    /component: \(\) => h\(MemoryExplorer, \{ t \}\)/.test(clientSource),
+    "the tab must reuse the MemoryExplorer views"
+  );
+  assert.ok(
+    clientSource.includes('"dsh-mneme: better-sidebar tab"'),
+    "the registration effect must carry a named label for scope cleanup"
+  );
+  assert.ok(
+    /if \(\+\+tries <= 10\) timer = setTimeout\(attempt, 1000\);/.test(clientSource),
+    "the service probe must retry with a bound (10 × 1s), not loop forever"
+  );
+});
+
 // The graph toggle must not read as "share": the primitives share icon is
 // banned and a custom node-graph glyph takes its place.
 test("graph toggle uses a node-graph glyph, not the share icon", () => {
@@ -233,6 +272,44 @@ test("graph toggle uses a node-graph glyph, not the share icon", () => {
   );
 });
 
+// 方案 A：查询收敛。状态页只做仪表盘（小页预览 + 服务端 total + 查看全部），
+// 沉淀/归档的完整浏览走记忆库的 deposited/archived 筛选视图（chip 预置 +
+// 状态页入口跳转），详情抽屉给归档记忆一个反向的「恢复」。
+test("status dashboard links into deposited/archived library views", () => {
+  assert.ok(
+    clientSource.includes('"/api/dsh-mneme/list?deposited=only&limit=8&order=chrono"'),
+    "the workbench deposited preview must read the server-side deposited view"
+  );
+  assert.ok(
+    clientSource.includes('"/api/dsh-mneme/list?archived=only&limit=3&order=chrono"'),
+    "the workbench archived preview must cap at 3 rows backed by a server total"
+  );
+  assert.ok(
+    clientSource.includes("browseWithFilter"),
+    "the status page must jump into the library with preset filters"
+  );
+  assert.ok(
+    /view === "status" && h\(StatusPanel, \{ t, onBrowse: browseWithFilter \}\)/.test(clientSource),
+    "the status panel must receive the browse-jump callback"
+  );
+  assert.ok(
+    clientSource.includes('(depositedOnly ? "&deposited=only" : "")'),
+    "the library filterQS must carry the deposited chip"
+  );
+  assert.ok(
+    clientSource.includes('(archivedOnly ? "&archived=only" : "")'),
+    "the library filterQS must carry the archived chip"
+  );
+  assert.ok(
+    clientSource.includes('postUpdate({ archived: false }, { restored: true })'),
+    "the drawer must offer restore for archived memories"
+  );
+  assert.ok(
+    clientSource.includes('"memory.status.viewAll"'),
+    "the view-all entries must come from the dictionary"
+  );
+});
+
 // Every memory feature lives in the main-area library now: the explorer
 // hosts three sub-views (browse / entities / settings) switched by tabs whose
 // labels come from dedicated dictionary keys.