@modusensus/dsh-mneme 0.8.10 → 0.8.12

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-1431%20passed-success)](https://github.com/slow-stack/mneme)
+[![tests](https://img.shields.io/badge/tests-1497%20passed-success)](https://github.com/slow-stack/mneme)
 [![CI](https://img.shields.io/github/actions/workflow/status/slow-stack/mneme/ci.yml)](https://github.com/slow-stack/mneme/actions)
 [![node](https://img.shields.io/badge/node-22%2B-blue)](https://nodejs.org)
 [![npm downloads](https://img.shields.io/npm/d18m/@modusensus/dsh-mneme.svg?color=blue&label=downloads)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
@@ -253,7 +253,7 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
 
 ### 前置条件
 
-- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）— 兼容 DSH 0.1.x，已验证 0.1.2-rc.1（`Session.events` → `snapshotEvents()` 变更已由插件垫片兼容，新旧版本通吃；v0.7.9 确保该垫片真正进入发布产物 lib/）
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）— 兼容 DSH 0.1.x 与 0.2.x（三段式 peer 范围见 `package.json`）；开发与 CI 已对齐 0.2 线，`0.2.0-rc.1` / `0.2.0-rc.2` 实测全绿。旧版兼容垫片（`Session.events` → `snapshotEvents()`，v0.7.9 起确保进入发布产物 lib/）保留
 - Node 24+（`node:sqlite`）
 
 ### 安装步骤
@@ -430,7 +430,7 @@ dsh web
 | `searchSemanticDedupThreshold` | `0.95` | 语义去重相似度阈值（v0.5.0，默认 0.95，范围 0.5-1.0）：`searchSemanticDedup=true` 时生效，调整可防小模型误折叠 |
 | `memoryQualityFilter` | `{enabled:true, archiveThreshold:30, degradeThreshold:60, minContentLength:10, exemptImportance:4}` | 记忆质量过滤（v0.4.6，默认开）：写库前启发式打分 0-100，元记忆词汇/自指/过短/重复/近似重复扣分；≥60 正常存储，30-60 降权（注入排序按 importance×quality/100），<30 归档标记 `low_quality`（显式搜索仍可召回，永不自动注入；`exemptImportance` 豁免：importance ≥ 该值只降权不归档，#135） |
 | `llmAudit` | `{enabled:true, retentionDays:90}` | LLM 消耗审计（v0.4.6，默认开）：每次后台 LLM 调用（`autoDream` / `autoSummarize` / `sleep` / `entityExtract`，对应 `operation_type` 为 `dream_consolidate` / `dream_summarize` / `dream_narrative`、`summarize_compress`、`sleep_conflict` / `sleep_pattern`、`entity_extract`）写 `llm_audit_logs`（tokens/duration/status/source）；失败记 error 不阻塞；只读 API `/api/dsh-mneme/semantic/llm-audit` + `/llm-audit/stats` |
-| `scopeEnabled` | `false` | 作用域隔离总开关（v0.8.0，issue #17）：memory_save 按会话身份写入 agent / workspace 标注（agentPreset / 工作区路径，registry 反查取不到回退 header.cwd，再取不到 NULL）；去重键扩展含作用域三元——跨作用域同标题不再物理合并；检索按当前会话作用域加权（命中 ×1.25、他 scope ×0.5 保留可见）。也走 feature_flags 白名单（面板可启停） |
+| `scopeEnabled` | `false` | 作用域隔离总开关（v0.8.0，issue #17）：memory_save 按会话身份写入 agent / workspace 标注（agentPreset / 工作区路径，registry 反查取不到回退 header.cwd，再取不到 NULL）；去重键扩展含作用域三元——跨作用域同标题不再物理合并；检索与注入排序按当前会话作用域加权（命中 ×1.25、他 scope ×0.5 保留可见，issue #339 补齐注入通道）。也走 feature_flags 白名单（面板可启停） |
 | `strictScope` | `false` | 作用域硬过滤（v0.8.0 引入，v0.8.1 起只认显式声明；依赖 `scopeEnabled`）：检索 / 注入 / 列表 / 单取四路过滤，**显式声明**收窄到他者作用域的记忆完全不可见；载体自动标注只降权保留可见——真正的物理隔离请用 sensitivity。会话身份解析不到时 fail-closed 只挡显式行。关闭时全部为软隔离（降权保留可见）。也走 feature_flags 白名单 |
 | `writeAdmission` | `{enabled:false, enforce:false}` | 写入准入（issue #254，默认关）：把「这条该不该进库」前移到 LLM 之前。第 1 级是零 LLM 的确定性判据——空白 / 纯噪声 + 密钥 / PII（判据来源是 #164 A2，经 `sensitiveScan` 注入，本批只定义接口）。`enabled` 跑判据并落审计行（`llm_audit_logs` 的 `metadata.deny`），`enforce` 才真的拒（`store.save` 之前返回，`memory_save` 返回 `action:"denied"` + `reason`）；只开 `enabled` = 仅告警、写入不拦。去重键命中不进第 1 级（归 write-update 放行），G1/G2 阈值只计量。也走 feature_flags 白名单 |
 | `conflictFreezeEnabled` | `false` | 冲突冻结（v0.4.4）：dream 发现矛盾对不自动裁决，冻结进冲突队列；状态页「冲突队列」支持并排对比与人工确认（保留 A / 保留 B / 仅标记已处理，v0.8.0） |
@@ -584,7 +584,7 @@ src/
 ├── api.js            # HTTP 路由（Web 面板数据通道，含 /conflicts 冲突队列）
 └── index.js          # 插件接线
 lib/                  # src 的同步分发产物（npm run sync；发布前由 root prepack 的 check-sync.js 校验一致性；唯一手写例外 lib/client.js——Web 面板 bundle，sync 不覆盖）
-test/                 # 1431 个 node:test 测试（审计与三轴线压测不变量；src↔lib 一致性由 scripts/check-sync.js 发布闸门校验）
+test/                 # 1497 个 node:test 测试（审计与三轴线压测不变量；src↔lib 一致性由 scripts/check-sync.js 发布闸门校验）
 scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压测 · sync-lib.js 同步 · check-sync.js 发布闸门 · benchmark-recall.js / benchmark-embed.js / benchmark-rerank.js 基准 · sync-test-badge.mjs 测试徽章 · build-runtime-manifest.mjs 运行时清单
 ```
 
@@ -593,7 +593,7 @@ scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压
 ```bash
 cd dsh-mneme
 npm install        # 安装 peer 依赖（以 devDependencies 形式，用于本地测试）
-npm test           # 运行 1431 个测试
+npm test           # 运行 1497 个测试
 npm run stress     # 三轴线压测：长会话检索 / 冲突仲裁 / 多 Agent 并发（离线 mock LLM）
 npm run sync       # 把 src/ 同步到 lib/（发布时由 prepack 钩子自动执行）
 ```

package/assets/icon.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 16 16" fill="none" stroke="#4176e6" stroke-width="1" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M4.43 12.31C2.19 10.17 2.27 6.81 4.18 4.84C6.10 2.88 9.06 2.99 10.74 4.68C12.43 6.37 12.28 8.92 10.82 10.33C9.35 11.74 7.22 11.55 6.08 10.32C4.95 9.08 5.18 7.35 6.18 6.50C6.57 6.17 7.03 5.99 7.48 5.97"/>
+</svg>

package/lib/client.js

@@ -68,19 +68,37 @@ window.__ModuleLoader__.load({
       if (ops.filter((o) => o.kind !== "same").length > 200) return null;
       return ops;
     }
-    // #287 归档图标跨代兼容：primitives 在 0.1.7 把图标命名从「像素后缀」改成
-    // 「字重后缀」（IconArchiveOutline20 → …OutlineRegular / …OutlineMedium），
-    // 旧名不留别名，而 peerDependencies 同时覆盖 0.1.6 与 0.1.7 两代宿主——
-    // 只认某一代的名字，另一代就会取到 undefined，h(undefined) 即 React #130
-    // （整个 slot entry 崩掉）。故按「旧名 → 新名」顺序取第一个存在的；
-    // 两代都缺时降级为不渲染图标，宁可无图标也不把 slot 打崩。
-    const IconArchive = primitives.IconArchiveOutline20
-      ?? primitives.IconArchiveOutlineRegular
-      ?? primitives.IconArchiveOutlineMedium
-      ?? null;
-
-    /** 渲染归档图标；宿主未提供任一候选名时返回 null（无图标，不影响其余内容）。 */
-    const renderArchiveIcon = (props) => (IconArchive ? h(IconArchive, props) : null);
+    // --- mneme mark：插件自己的标识图标 -------------------------------------
+    // 不再借宿主的 IconArchiveOutline*，两个原因：
+    //  · 语义撞车——「归档盒」和记忆库里的归档动作是同一个符号，用户反馈看不出
+    //    这是记忆插件（issue 走维护者自开通道）；
+    //  · 宿主耦合——宿主图标名会换代（#287：Outline20 → OutlineRegular/Medium），
+    //    只认某一代就取到 undefined，h(undefined) 即 React #130 把整个 slot entry
+    //    崩掉。自绘后这一整类问题消失，也不再需要「探测多代名字 + 缺名降级」。
+    // 形状：单线螺旋（记忆痕迹 / 召回回路）。规格逐条对齐宿主图标，才不像外来户：
+    // 16 栅格、fill:none、stroke:currentColor、描边 1（宿主 Regular 档）、圆头圆角。
+    // 路径是 6 段三次贝塞尔拟合同一螺旋（拟合版与逐点采样版逐像素一致，已核验），
+    // 所以源码里只有 200 字符，不是一百多个采样点。
+    // 改形状只需换 MNEME_MARK_D，并同步 assets/icon.svg（插件列表那份，同一个 d）。
+    const MNEME_MARK_D = "M4.43 12.31C2.19 10.17 2.27 6.81 4.18 4.84C6.10 2.88 9.06 2.99 10.74 4.68C12.43 6.37 12.28 8.92 10.82 10.33C9.35 11.74 7.22 11.55 6.08 10.32C4.95 9.08 5.18 7.35 6.18 6.50C6.57 6.17 7.03 5.99 7.48 5.97";
+
+    /** mneme mark 的内联 SVG；currentColor + 描边 1，随主题与字号走。 */
+    const MnemeMark = ({ size = 16, className }) => h("svg", {
+      width: size,
+      height: size,
+      className,
+      viewBox: "0 0 16 16",
+      fill: "none",
+      xmlns: "http://www.w3.org/2000/svg",
+      "aria-hidden": "true",
+      stroke: "currentColor",
+      strokeWidth: 1,
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }, h("path", { d: MNEME_MARK_D }));
+
+    /** 渲染 mneme mark：四个入口（浮层标题栏 / footer 回退 / 侧边栏 portal / better-sidebar tab）共用同一颗。 */
+    const renderMnemeMark = (props) => h(MnemeMark, props);
 
     // Portal target for the hero fallback surface. The host whitelists
     // react-dom for its own bundles (dsh-client-ui-trajectory requires it);
@@ -1328,11 +1346,26 @@ window.__ModuleLoader__.load({
       ".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}",
-      // 纵向 flex 容器按原生按钮的宽度与外边距分配空间，保留展开和收起态的对齐。
+      // 侧边栏入口两种形态的样式（挂载与搬移逻辑见 SidebarTopEntry 的头注释）。
+      // 展开态兜底：逐条镜像宿主 panelRow（36px 行高 / 透明底 / 2px 外边距 /
+      // 7px 8px 内边距）——宿主面板行类名在或不在，观感都是「插件 / 自动化任务」
+      // 那一档，不会再退回 v0.8.10 那种高亮大按钮。
+      // 收起态：按钮带宿主 newSession 类名，标题栏固定几何（position:fixed、
+      // 顶部居中、28px 圆钮、次级文字色、hover 填充）整套继承宿主规则，我们只用
+      // 一条更具体的规则把 left 从宿主的 48px 推到 84px——即「新会话」右侧，
+      // 不再像 v0.8.10 那样压在它身上（用户实测确认的遮挡 bug）。
+      // 84 = 48（宿主给「新会话」的 left）+ 28（钮宽）+ 8（间距）；120 = 84 + 28 + 8，
+      // 让「应用 / 编辑」菜单顺延到我们右侧。宿主侧出处：SidebarRoot.module.css 的
+      // `.collapsed .newSession{left:48px}` 与
+      // `html[data-windows-titlebar]:has([data-sidebar-collapsed=true]){--dsh-windows-menu-start:84px}`。
       ".mneme-topentry{display:flex;flex-direction:column;position:relative}",
-      ".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{box-sizing:border-box;min-height:36px;border:none;border-radius:var(--dsw-radius-md);background:0 0;color:var(--dsw-alias-label-primary);font:inherit;text-align:left;cursor:pointer;align-items:center;gap:8px;margin:0 2px;padding:7px 8px;line-height:22px;display:flex}",
       ".mneme-topentry-native:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}",
+      ".mneme-topentry-native:focus-visible{outline:var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:-2px}",
       ".mneme-topentry-native .mneme-topentry-label{white-space:nowrap}",
+      "html[data-windows-titlebar] .mneme-topentry .mneme-topentry-rail{left:84px}",
+      // 菜单让位只在「收起 + 入口确实挂在标题栏里」时生效；展开态完全不碰宿主变量。
+      "html[data-windows-titlebar]:has([data-sidebar-collapsed=true]):has([data-plugin-entry=\"@modusensus/dsh-mneme\"]){--dsh-windows-menu-start:120px}",
       // --- 功能开关：一行一开关，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)}",
@@ -3031,6 +3064,10 @@ window.__ModuleLoader__.load({
     // MemoryExplorer 内部状态（选中行、过滤）由各自的跳转回调处理。
     function openLibrary() {
       setOverlayOpen(true);
+      // 打开面板 = 用户正准备处理冻结冲突：顺手把入口红点重取一次，别让他
+      // 对着一个已经过期的计数（裁决走别的路径、或后台 autoDream 刚写过库时，
+      // 计数不该等 60s 兜底轮询才对齐）。
+      conflictBadgeCount.refresh();
     }
 
     // --- Hero fallback overlay state (module-level pub/sub) ---
@@ -3098,7 +3135,7 @@ window.__ModuleLoader__.load({
         h("div", { className: "mneme-overlay", role: "region", "aria-label": t("memory.view.label"), ref: panelRef },
           h("div", { className: "mneme-overlaybar" },
             h("span", { className: "mneme-overlaytitle" },
-              renderArchiveIcon({ size: 15 }),
+              renderMnemeMark({ size: 15 }),
               t("memory.view.label")
             ),
             h("button", {
@@ -4924,32 +4961,80 @@ window.__ModuleLoader__.load({
       );
     }
 
-    // --- Sidebar entry: 工作区上方的记忆按钮 ---
+    // --- Sidebar entry: 侧边栏里的记忆入口 ---
     // 注册仍在 sidebar.footer.action（list 插槽）——它既是 React 树的挂载
-    // 锚点，也是 portal 失效时的原位回退。真实按钮 portal 插到「新会话」行
-    // 之后、插件入口组的最前：任务看板/技能中心等生态插件也把入口插在新会话
-    // 行后（它们的后插入者在上），若我们固定在 regionArea 之前就会被打成
-    // 入口组末尾的孤立位（issue #130），所以观察器发现错位就搬回锚点位。
-    // 几何对齐方案：读取宿主「新会话」按钮的实时 className 原样套用，再用
-    // 我们的修饰类覆盖配色（次级观感）。这样展开态与收起态（rail）都直接
-    // 继承宿主自己的盒模型与间距——宿主改版/缩进动画零位移，无需硬编码。
+    // 锚点，也是 portal 失效时的原位回退；常驻 sheet 也从这个插槽挂载。
+    // 入口形状跟着宿主 v0.2 的侧边栏走，分两态：
+    //  · 展开态：宿主把「插件 / 自动化任务」这类全局面板渲染成 nav.panelList
+    //    里的 panelRow（36px 行高、透明底、图标 + 标题）。我们把按钮 portal 进
+    //    同一组并原样套用宿主 panelRow 的实时类名，于是它是该组的第三行——低调，
+    //    而不是 v0.8.10 那样长得像第二个高亮「新会话」按钮。
+    //  · 收起态（Windows 标题栏）：panelList / regionArea / footArea 被宿主
+    //    display:none，只有开关与「新会话」被改成固定在标题栏上。我们把按钮搬回
+    //    标题栏、并排在「新会话」右侧（84px / 120px 的算法见上面 CSS 注释），
+    //    三颗图标各就各位——v0.8.10 把入口留在宿主的 48px 上把它盖住了。
+    // 承载类名一律从活元素读取（宿主/皮肤会异步改写哈希类名），不硬编码；
+    // 面板列表不存在（没装任何面板插件）时退回「新会话」行之后。
     // 宿主结构异常时约 2 秒后放弃 portal，footer 回退按钮保持可用。
-    // #177：未处理冲突数 badge——数据走 dream-status 的 pendingConflicts（状态卡
-    // 同一端点），60s 轮询 + 打开面板即刷新。挂侧边栏入口按钮右上角（portal 与
-    // 回退两处都挂），让用户不进面板也知道有冻结要裁决。
-    function useConflictBadgeCount(t) {
-      const [pending, setPending] = useState(0);
+    // #177：未处理冲突数 badge——数据走 dream-status 的 pendingConflicts（与状态卡
+    // 同一端点）。挂侧边栏入口按钮右上角（portal 与回退两处都挂），让用户不进面板
+    // 也知道有冻结要裁决。
+    // 刷新时机（用户反馈「裁决完红点消失得很慢」后重做）：
+    //  · 裁决成功时冲突队列广播 mneme:conflicts-changed → 立刻重取，不必等下一轮；
+    //    此前这条广播只有状态卡订阅，红点漏订，才慢到要等 60s 兜底轮询；
+    //  · openLibrary 打开面板时重取（见上）；
+    //  · 60s 兜底轮询——后台 autoDream 自己产生/消解冲突时没人广播，靠它浮现。
+    // 计数是模块级单例：入口按钮的 portal 与 footer 回退是两个组件，原先各起一个
+    // 60s 轮询（两份请求、两个互不同步的计数）。现在共享一个 store：一次取回广播给
+    // 全部订阅者，in-flight 请求也去重，最后一个订阅者离开才停表。
+    const conflictBadgeCount = (() => {
+      const listeners = new Set();
+      let value = 0;
+      let timer = null;
+      let inflight = null;
+      const publish = (next) => {
+        if (next === value) return;
+        value = next;
+        listeners.forEach((fn) => {
+          try { fn(value); } catch { /* 单个订阅者出错不拖垮其余 */ }
+        });
+      };
+      const refresh = () => {
+        if (inflight) return inflight;
+        inflight = apiFetch("/api/dsh-mneme/dream-status")
+          .then((res) => (res.ok ? res.json() : { pendingConflicts: 0 }))
+          .then((d) => { publish(Number((d && d.pendingConflicts) ?? 0) || 0); })
+          .catch(() => { publish(0); })
+          .finally(() => { inflight = null; });
+        return inflight;
+      };
+      return {
+        get: () => value,
+        refresh,
+        subscribe: (fn) => {
+          listeners.add(fn);
+          fn(value);
+          if (listeners.size === 1) {
+            refresh();
+            timer = setInterval(refresh, 60_000);
+          }
+          return () => {
+            listeners.delete(fn);
+            if (listeners.size === 0 && timer !== null) { clearInterval(timer); timer = null; }
+          };
+        }
+      };
+    })();
+    function useConflictBadgeCount() {
+      const [pending, setPending] = useState(() => conflictBadgeCount.get());
       useEffect(() => {
-        let cancelled = false;
-        const tick = () => {
-          apiFetch("/api/dsh-mneme/dream-status")
-            .then((res) => (res.ok ? res.json() : { pendingConflicts: 0 }))
-            .then((d) => { if (!cancelled) setPending(Number((d && d.pendingConflicts) ?? 0) || 0); })
-            .catch(() => { if (!cancelled) setPending(0); });
+        const unsubscribe = conflictBadgeCount.subscribe(setPending);
+        const onChanged = () => { conflictBadgeCount.refresh(); };
+        window.addEventListener("mneme:conflicts-changed", onChanged);
+        return () => {
+          unsubscribe();
+          window.removeEventListener("mneme:conflicts-changed", onChanged);
         };
-        tick();
-        const timer = setInterval(tick, 60_000);
-        return () => { cancelled = true; clearInterval(timer); };
       }, []);
       return pending;
     }
@@ -4959,7 +5044,7 @@ window.__ModuleLoader__.load({
         pending > 99 ? "99+" : String(pending));
     }
     function SidebarFallbackTrigger({ wide, t }) {
-      const pending = useConflictBadgeCount(t);
+      const pending = useConflictBadgeCount();
       // #295 评审：.mneme-trigger 自身 overflow:hidden 且无定位上下文，badge
       // 直接放里面会被裁剪——包一层定位容器，badge 挂在容器上。
       return h("div", { className: "mneme-triggerwrap" },
@@ -4973,7 +5058,7 @@ window.__ModuleLoader__.load({
           onClick: openLibrary,
           "data-mneme-overlay-opener": "true"
         },
-          renderArchiveIcon({ size: wide ? 16 : 18 }),
+          renderMnemeMark({ size: wide ? 16 : 18 }),
           wide && h("span", { className: "mneme-trigger-label" }, t("memory.panel.open"))
         ),
         h(ConflictBadge, { pending })
@@ -4982,14 +5067,25 @@ window.__ModuleLoader__.load({
 
     function SidebarTopEntry({ wide, t, fallback }) {
       const [host, setHost] = useState(null);
-      const [nativeCls, setNativeCls] = useState("");
-      const pending = useConflictBadgeCount(t);
+      const [cls, setCls] = useState({ row: "", glyph: "", title: "" });
+      const pending = useConflictBadgeCount();
       useEffect(() => {
         if (!reactDom || typeof document === "undefined") return undefined;
         let tries = 0, timer = null, created = null, mo = null;
+        const findRegion = () => {
+          const region = document.querySelector('[class*="regionArea"]');
+          return region && region.parentElement ? region : null;
+        };
         const findNative = (region) =>
           region.parentElement.querySelector('[class*="newSession"]')
           || region.previousElementSibling;
+        const findPanelList = (region) =>
+          region.parentElement.querySelector('[class*="panelList"]');
+        // 宿主自己的面板行：排除我们自己 portal 进去的那颗按钮（它也带 panelRow）。
+        const findPanelRow = (region) => {
+          const list = findPanelList(region);
+          return list ? list.querySelector('[class*="panelRow"]:not(.mneme-topentry-native)') : null;
+        };
         // 占位锚点：新会话行（现役外壳里 newSession 按钮嵌在 logoRow 内，
         // 旧外壳是根的直接子按钮）。判定与生态插件的 sidebar-entry-core
         // 一致；锚点不可靠时回退到 regionArea 之前的旧位置。
@@ -5008,32 +5104,61 @@ window.__ModuleLoader__.load({
         // insertBefore(x, x) 在 Chromium 里不是 no-op，会触发 mutation 造成
         // 观察器自激风暴、冻死整个 SPA。
         const place = (region) => {
+          if (!created) return;
           const parent = region.parentElement;
           if (!parent) return;
+          // 展开态落进宿主的面板列表（紧跟「插件 / 自动化任务」）；宿主没有面板
+          // 列表时退回「新会话」行之后，由 .mneme-topentry-native 兜住低调行样式。
+          const list = wide ? findPanelList(region) : null;
+          if (list) {
+            if (created.parentElement === list && created === list.lastElementChild) return;
+            list.appendChild(created);
+            return;
+          }
           const anchor = findAnchor(region);
           const target = anchor ? anchor.nextSibling : region;
           if (target === created) return;
           if (created.parentElement === parent && created.nextSibling === target) return;
           parent.insertBefore(created, target);
         };
+        // 类名一律从活元素读。展开态借宿主面板行的盒模型，并剔掉激活态修饰类
+        // （否则我们的行会跟着宿主当前选中的面板一起常亮）；收起态借「新会话」
+        // 按钮的类名拿整套标题栏固定几何。两处都取不到时留空，由我们的类兜底。
+        const readCls = (region) => {
+          if (!wide) return { row: findNative(region)?.className || "", glyph: "", title: "" };
+          const row = findPanelRow(region);
+          const btn = row || findNative(region);
+          const glyph = row && row.querySelector('[class*="panelGlyph"]');
+          const title = row && row.querySelector('[class*="panelTitle"]');
+          return {
+            row: (btn?.className || "")
+              .split(/\s+/)
+              .filter((name) => name && !name.includes("panelActive"))
+              .join(" "),
+            glyph: (glyph && glyph.className) || "",
+            title: (title && title.className) || ""
+          };
+        };
+        const sync = (region) => {
+          const next = readCls(region);
+          setCls((prev) => (prev.row === next.row && prev.glyph === next.glyph && prev.title === next.title ? prev : next));
+        };
         const attempt = () => {
-          const region = document.querySelector('[class*="regionArea"]');
-          if (region && region.parentElement) {
-            // 「新会话」按钮与 regionArea 同级且紧邻其前，借它的类名获得
-            // 与原生侧边栏项完全一致的盒模型（含收起态 rail 几何）。
-            // 宿主/皮肤会异步改写按钮类名，用 MutationObserver 持续同步，
-            // 否则 portal 按钮会停留在捕获时刻的旧类上（宽度/对齐失配）。
+          const region = findRegion();
+          if (region) {
+            // 宿主切换展开/收起时会重排 DOM（面板列表 → 标题栏固定位），所以每次
+            // 变动都重新落位并重读类名；宿主/皮肤异步改写类名也靠这条同步，否则
+            // portal 按钮会停留在捕获时刻的旧类上（宽度/对齐失配）。
             created = document.createElement("div");
             created.dataset.pluginEntry = "@modusensus/dsh-mneme";
             place(region);
             setHost(created);
-            setNativeCls(findNative(region)?.className || "");
+            sync(region);
             mo = new MutationObserver(() => {
-              const cur = document.querySelector('[class*="regionArea"]');
-              if (!cur || !cur.parentElement) return;
+              const cur = findRegion();
+              if (!cur) return;
               place(cur);
-              const cls = findNative(cur)?.className || "";
-              setNativeCls((prev) => (prev === cls ? prev : cls));
+              sync(cur);
             });
             mo.observe(region.parentElement, {
               attributes: true,
@@ -5052,13 +5177,19 @@ window.__ModuleLoader__.load({
           if (mo) mo.disconnect();
           if (created && created.parentElement) created.parentElement.removeChild(created);
         };
-      }, []);
+      }, [wide]);
       if (!host) return fallback;
+      // 图标与「插件 / 自动化任务」同档（16px）；收起态沿用标题栏里原来的 18px。
+      const icon = renderMnemeMark({ size: wide ? 16 : 18 });
       return reactDom.createPortal(
         h("div", { className: "mneme-topentry" },
           h("button", {
             type: "button",
-            className: `${nativeCls} mneme-topentry-native`.trim(),
+            // 展开态：宿主面板行类名 + 我们的同款兜底；收起态：宿主「新会话」类名
+            // + 只覆盖 left 的 rail 规则（整套标题栏几何继承宿主）。
+            className: wide
+              ? `${cls.row} mneme-topentry-native`.trim()
+              : `${cls.row} mneme-topentry-rail`.trim(),
             "aria-label": pending > 0
               ? `${t("memory.sidebar.aria")} · ${t("memory.status.conflicts")} ${pending}`
               : t("memory.sidebar.aria"),
@@ -5066,8 +5197,9 @@ window.__ModuleLoader__.load({
             onClick: openLibrary,
             "data-mneme-overlay-opener": "true"
           },
-            renderArchiveIcon({ size: wide ? 15 : 18 }),
-            wide && h("span", { className: "mneme-topentry-label" }, t("memory.panel.open")),
+            // 图标套上宿主面板行的槽位类名，视觉与同组入口完全一致；取不到时裸渲染。
+            cls.glyph ? h("span", { className: cls.glyph, "aria-hidden": "true" }, icon) : icon,
+            wide && h("span", { className: `${cls.title} mneme-topentry-label`.trim() }, t("memory.panel.open")),
             h(ConflictBadge, { pending })
           )
         ), host);
@@ -5128,7 +5260,7 @@ window.__ModuleLoader__.load({
                   reg.registerTab({
                     id: TAB_ID,
                     title: () => t("memory.view.label"),
-                    icon: (size) => renderArchiveIcon({ size }),
+                    icon: (size) => renderMnemeMark({ size }),
                     order: 60,
                     component: () => h(MemoryExplorer, { t })
                   });

package/lib/config.js

@@ -281,6 +281,14 @@ export const Config = z.object({
   // 显式开启后放宽跨类型合并检查（类型边界由用户自行承担）；配合
   // dreamSkipInvalid 理解：关闭 skipInvalid 时跨类型 merge 直接整单拒绝。
   allowCrossTypeMerge: z.boolean().default(false),
+  // issue #339 / E8 考卷：merge 护栏（opt-in，默认关 = 现状）。开启后合并对象
+  // 命中长保留类型（preference/pattern/rejected_solution/constraint/pitfall，
+  // 与 archive 护栏同一张表）的 merge 决策整条跳过——E8 实测巩固损耗里
+  // 10/26 条被丢约束已归位 guarded 类型仍被 merge 吃掉，而 archive 护栏只挡
+  // archive 不挡 merge，「更精炼的摘要」恰是约束失真的主通道。skipInvalid
+  // （默认开）时被跳条目进 dream_runs.skipped、run 记 degraded；关闭
+  // skipInvalid 时整单拒绝。与 allowCrossTypeMerge 同用时长 guard 先判。
+  dreamMergeGuard: z.boolean().default(false),
   // Rule version for dream adjudication: when this bumps, older dream_runs
   // degrade to historical evidence (their receipts no longer drive live
   // decisions). Default 0 = no versioning in use yet.
@@ -463,6 +471,35 @@ export const Config = z.object({
   // 检索融合池（与 BM25 同级的确认/回填信号）。默认关=检索行为与 #219 前
   // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
   entityRecallEnabled: z.boolean().default(false),
+  // 边权重演化（issue #24 块2）：touch 门控是否把被寻回路径的边权重抬升。
+  // 默认关=边初值纯由建边来源决定（store.RELATION_SOURCE_DEFAULTS），演化
+  // 不生效；开=被激活的边经 bumpRelationWeight 上涨（只加不减、封顶 1.0）。
+  graphWeightEnabled: z.boolean().default(false),
+  // 单次有效触达的抬升幅度。
+  graphWeightDelta: z.number().min(0).max(1).default(0.1),
+  // 被动确认（issue #24 块4）：heat 触达（记忆被召回/注入=被用）即对该记忆
+  // 挂联的关系边做被动确认——bumpRelationWeight 抬一格。默认关=零行为变化；
+  // 开=正常触达演化边权，「关系是用出来的」闭环落地（异常路径复核留后续块）。
+  graphPassiveConfirm: z.boolean().default(false),
+
+  // --- 图谱锚定层（issue #24 · 块1 Activation Anchoring）-------------------
+  // entityRecallEnabled 之上再开一层：以查询命中的实体为种子，沿实体关系表
+  // 级联扩散（默认深度 2），把「邻居实体挂联的记忆」也带进融合池。种子集
+  // 上限 graphSeedCap、级联深度 graphCascadeDepth 一并下发到 anchorSeeds /
+  // cascadeDepths（见 src/graph/anchoring.js）。默认关=行为与 #219 单跳轴
+  // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
+  graphAnchoringEnabled: z.boolean().default(false),
+  graphSeedCap: z.natural().min(1).max(30).default(12),
+  graphCascadeDepth: z.natural().min(1).max(3).default(2),
+
+  // 关联提示防幻觉（issue #24 块3）：图召回的候选（查询命中实体的挂联记忆）
+  // 进注入时默认只参与排序、不改变注入块构成（graphInjectHint=false 保守档）；
+  // 开启后注入文本里以固定句式「[检索线索] …」标出，引导语说明这是链路信息
+  // 非事实断言，防 LLM 单次消费把桥接召回当有依据的事实回头扩散。
+  graphInjectHint: z.boolean().default(false),
+  // 图召回候选在注入块里的独立预算（条数上限）。与 pin/document 预算同构：
+  // 不占 maxInjectedItems 名额、只约束「桥接线索」这类低信任信息的常驻占比。
+  graphInjectBudget: z.natural().min(0).max(5).default(1),
 
   // --- sleep mode: idle-triggered deep maintenance (v0.4.0) ---------------
   // Opt-in, off by default. Unlike autoDream (threshold-triggered, lightweight)
@@ -685,7 +722,8 @@ export const Config = z.object({
   // agent_scope, workspace_scope, sensitivity)。检索侧加权/过滤在 A2/A3 落地。
   // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
   scopeEnabled: z.boolean().default(false),
-  // strictScope（A3）：硬过滤模式。关闭=A2 软隔离（他 scope 降权保留可见）；
+  // strictScope（A3）：硬过滤模式。关闭=A2 软隔离（他 scope 降权保留可见，
+  // 检索与注入排序同权重，issue #339 补齐注入通道）；
   // 开启后检索/注入/list/get 按 issue #17 四象限可见性公式硬过滤——带他 scope
   // 的记忆完全不可见，未标注（NULL）恒可见；当前会话某维度解析不到时该维度
   // 带标注的记忆一律不可见（fail-closed：身份不明只见全局）。依赖 scopeEnabled
@@ -712,6 +750,14 @@ const LIGHT_MODE_OFF = [
   "bm25SearchEnabled",
   // 轻量模式不开图召回轴（#219，依赖实体抽取产出；抽取本身已被关掉）。
   "entityRecallEnabled",
+  // 轻量模式不开图谱锚定层级联（#24 块1，依赖实体抽取 + 关系表，抽取已关则无边可扩）。
+  "graphAnchoringEnabled",
+  // 轻量模式不开边权重演化（#24 块2，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
+  "graphWeightEnabled",
+  // 轻量模式不开关联提示标注（#24 块3，常驻注入文本多一段提示成本）。
+  "graphInjectHint",
+  // 轻量模式不开被动确认（#24 块4，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
+  "graphPassiveConfirm",
   // 轻量模式不开叙述条（额外 LLM 调用；#164 对齐，opt-in）。
   "dreamNarrativeEnabled",
   // 轻量模式不开 document 指针行（#230，opt-in：注册/注入/检索增强全随闸）。

package/lib/dream/decisions.js

@@ -210,6 +210,22 @@ export function validateDecisions(decisions, snapshot, options = {}) {
         if (mergeTypes.size > 1 && options.allowCrossTypeMerge !== true) {
           local.push(`${at}: merge ids span multiple types (${[...mergeTypes].join(", ")})`);
         }
+        // issue #339 / E8 考卷：merge 护栏（opt-in，dreamMergeGuard）。巩固损耗
+        // 实测里 10/26 条被丢约束已归位 guarded 类型仍被 merge 吃掉——archive
+        // 护栏（上方）只挡 archive 不挡 merge，而 merge 的「更精炼摘要」恰是
+        // 约束失真的主通道。开启后被合并对象命中 ARCHIVE_GUARDED_TYPES 的
+        // merge 决策整条跳过（与 archive 护栏同款通道：skipInvalid 时 skipped
+        // 明细、严格模式整单拒绝）。
+        if (local.length === 0 && options.mergeGuard === true) {
+          const guardedTypes = new Set();
+          for (const id of d.ids) {
+            const mem = snapshot.get(id);
+            if (mem && ARCHIVE_GUARDED_TYPES.has(mem.type)) guardedTypes.add(mem.type);
+          }
+          if (guardedTypes.size > 0) {
+            local.push(`${at}: merge of long-retention type(s) ${[...guardedTypes].join(", ")} is blocked by dreamMergeGuard`);
+          }
+        }
       }
     }
     if (local.length > 0) {

package/lib/dream/sleep.js

@@ -373,6 +373,9 @@ async function phaseConflicts(ctx, service, config, logger, runId, semantic = nu
     minAgeHours: config.reflectionUpdateMinAgeHours,
     skipInvalid: config.dreamSkipInvalid !== false,
     allowCrossTypeMerge: config.allowCrossTypeMerge === true,
+    // issue #339 / E8：guarded 类型 merge 护栏（opt-in，dreamMergeGuard），
+    // 与 dream 主链路同一判据。
+    mergeGuard: config.dreamMergeGuard === true,
     // Issue #126 review（Copilot）：默认档必须真的只放行旧动作集——只换 prompt 挡不住
     // 模型自发输出 supersede / differentiate，那样"opt-in 零行为变化"就不成立。
     allowedActions: actionSet === "full" ? null : LEGACY_ACTIONS