dsh-memory-core 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.1.4
+
+- 默认改为 **full 五轨**（memory / user / project / key / daily）。原先默认是 lite 三轨，装完只有三轨，得手改配置才能拿到完整记忆；老配置里显式写 `memoryTracks: lite` 的仍按三轨跑。
+- 记忆管理页 `manage.html` 按 dsh-memory-evolve 的记忆页形制重做：顶部页签（五轨 + 三份归档，带条数）、文件条（名称 / 条数 / 完整路径 / 复制路径）、美观视图与纯文本视图切换、搜索框、条目卡片（编辑 / 归档 / 删除）、待确认队列（允许并写入 / 拒绝）、归档区（移回主轨 / 删除）、新增条目框。
+- 新增 `GET /api/memory-core/files`：一次返回每轨路径、是否存在、条数、归档数、待确认数，以及当前模式、数据目录、preset 名。面板与页签都用它，不再按前端硬编码的三轨逐个查。
+- `GET /api/memory-core/entries` 与 `POST /api/memory-core/entry` 支持 `?cwd=` / `body.cwd`：管理页在别的会话里打开时也能读写项目记忆与关键事实（这两轨按会话工作目录隔离）。
+- 插件详情页面板改用 `/files`，模式、条数、归档数按实际值显示；「打开记忆管理页」改成按钮样式并提到顶部。
+- 管理页细节：条目改成**最新在前**（记忆文件是追加写，原先按文件顺序渲染会把最旧的排最上面）；每页 20 条分页；没有 `?cwd=` 时顶部给输入框，填一次记在浏览器里；「项目日志」页签不再报 `无效的归档轨 "project"`。
+- 工具面补齐：`list` 支持 `filter` / `since` / `until` / `limit`（默认 50）/ `recent`，返回总条数与文件路径；`add` 支持 `entries` 批量写（仅 daily/project）；`replace` 保留原时间戳，不再重盖；子代理只读，不能往常驻轨写。
+- 误伤防护：`archive` / `promote` / `removeArchive` / `replace` / `remove` 都接受整条原文或唯一子串，子串命中多条时明确报「命中 N 条，无法确定」，不做模糊删除；`archive` 只支持 memory/user/key 三轨。
+- 待确认队列带 `cwd` / `reason` / 命中次数并去重；`confirm` / `reject` 按「轨 + 内容」定位，未传轨时退回只按内容匹配。
+- 看门狗在 full 模式下只认 `daily` / `project` 的写入（lite 模式退回任意轨），子代理不提醒；面板的写操作返回真实结果，`promote` 会剥掉归档时附加的理由行。
+- 项目轨 / 关键事实在取不到会话工作目录时，`list` 直接报错说明原因，不再静默返回 0 条让人以为没有记忆。
+
+## 0.1.3
+
+- 修复：路由与注入段直接访问 `ctx.agent`。Cordis 的 `ctx.<服务>` 在插件未声明 `inject` 时会抛 `cannot get property "agent" without inject`，被 webserver 兜底成 **400 空体**：`/api/memory-core/status`、`/manage`、`/entries` 全部打不开，`memory-core:snapshot` 注入同时失效，日志里也没有堆栈。改为 `agentOf(ctx)`，只经 `ctx.get(name, false)` 探测（取不到返回 undefined；lite 三轨不依赖 agent）。
+- `_dryrun.mjs`：stub ctx 补 `get(name)`（模拟真实服务读取），并加 8d2 回归断言——`index.js` 里出现 `ctx.agent` 即失败。
+
 ## 0.1.2
 
 - 修复：`lib/schema.js` 用 `z.enum(...)`（zod 的写法，`@deepseek-ai/schemastery` 没有这个方法），包一 import 就抛 `TypeError: z.enum is not a function`。内核 Loader 的 `_init()` 捕获 import 错误后不建 fiber，于是 preset 里这一行只显示「never started」，日志里不落错。改为 `z.union([z.const("lite"), z.const("full")])`。

package/README.md

@@ -11,11 +11,27 @@
 dsh plugin --profile web add dsh-memory-core
 ```
 
-装完还要**手动启用一次**：包默认是关闭的（`cordis.patch.yml` 里 `disabled: true`），不启用的话重启后没有工具、没有记忆注入、面板也是空的，而且不报错。
+装完默认是关闭的（包内 `cordis.patch.yml` 写了 `disabled: true`），插件列表里会显示「已关闭」——这是预期行为，不是装错了：装上只是把代码放好，不会给任何会话加记忆。
 
-1. 打开 `%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml`（macOS/Linux 下是 `~/.dsh/profiles/web/cordis.patch.yml`）。
-2. 找到 `id: memory-core` 那一段，把 `disabled: true` 改成 `disabled: false`，或直接删掉这一行。
-3. 完全退出并重启 DSH，再新建会话。
+启用有两条路，推荐第一条：
+
+1. **挂进目标 preset（推荐）**：在该 preset 的 `plugins:` 里加两项（见下面「preset 挂载」），重启后新建会话即生效。数据按 preset 名分目录，不影响其他会话。
+2. 全局启用（不推荐）：把 `cordis.patch.yml` 里 `id: memory-core` 那段的 `disabled: true` 改成 `false`，重启。这样所有会话都会多一套记忆工具与注入，只在单会话环境里合适。
+
+判断它是否真的在跑，看插件详情页有没有条数，或 `GET /api/memory-core/status` 的 `memoryTracks` 是不是五轨；不要看插件列表那颗开关，它管的是 profile 层。
+
+> **别同时开两处**：如果你已经用 preset 挂载了本包，就不要再打开插件列表上的开关——两个实例会抢同一个 `/api/memory-core` 路由，后挂载的那个 preset 会报 `duplicate prefix route` 并整体加载失败。真遇到了：把列表开关关掉、重启，数据不会丢。
+
+## preset 挂载
+
+```yaml
+      - id: memory-core
+        name: dsh-memory-core
+        config:
+          presetName: <preset 名>
+```
+
+`presetName` 决定数据落点 `~/.dsh-plugin-data/<preset 名>/memory/`，建议与 preset 的 `id` 一致。
 
 前提：已安装 `dsh-memory-shield`（shield 包）。两包配对时建议只把 `dsh-memory-core` 挂进需要独立记忆的那个 preset，不要放进全局 `dsh.profile.bundles`。
 
@@ -23,33 +39,30 @@ dsh plugin --profile web add dsh-memory-core
 
 | 配置项 | 默认值 | 说明 |
 |---|---|---|
-| `memoryTracks` | `"lite"` | 记忆轨模式：`lite` = 三轨 memory/user/key；`full` = 五轨 memory/user/project/key/daily |
+| `memoryTracks` | `"full"` | 记忆轨模式：`full` = 五轨 memory/user/project/key/daily（默认）；`lite` = 三轨 memory/user/key |
 | `presetName` | `"default"` | preset 名称（影响数据目录落点） |
 | `memoryDir` | `""` | 记忆数据目录（留空自动解析到 `~/.dsh-plugin-data/<presetName>/memory/`） |
 | `writeGuard` | `true` | key 轨写入走待确认队列（防误写） |
 | `writeGuardThreshold` | `2` | 连续 N 轮没写记忆就提醒 |
 | `snapshotOrder` | `500` | memory-core:snapshot 注入顺序 |
 
+上面几项都可以在插件详情页的「配置」页签里改，落点是一份覆盖层 `~/.dsh-plugin-data/<presetName>/memory-core.config.json`，每轮重读，改完立即生效（`snapshotOrder` 这种注册期属性除外，要重启）。
+
 ## 记忆轨
 
-### lite 模式（默认，三轨）
+### full 模式（默认，五轨）
 
 | 轨 | 文件 | 用途 |
 |---|---|---|
 | `memory` | `memory.md` | 长期记忆（跨会话复用） |
 | `user` | `user.md` | 用户偏好与画像 |
-| `key` | `key.md` | 关键事实（走待确认队列） |
-
-### full 模式（五轨）
-
-在 lite 三轨基础上加：
-
-| 轨 | 文件 | 用途 |
-|---|---|---|
+| `key` | `projects/<hash>/key.md` | 关键事实（走待确认队列，按 cwd 隔离） |
 | `project` | `projects/<hash>/memory.md` | 项目记忆（按 cwd 隔离） |
 | `daily` | `daily/<date>.md` | 每日日志（编年史） |
 
-切 full 模式：把配置里 `memoryTracks` 改成 `"full"`，重启会话即可。
+### lite 模式（三轨）
+
+只保留 `memory` / `user` / `key`（`key` 落在根目录 `key.md`，不按项目分）。切 lite：在设置页「配置」里把记忆模式改成 lite 即可。
 
 ## 工具
 

package/client.js

@@ -1,7 +1,9 @@
 /**
- * dsh-memory-core —— 浏览器半端：插件详情页的状态面板。
+ * dsh-memory-core —— 浏览器半端：插件详情页的设置面板。
  *
- * 显示当前模式、各轨记忆条数、待确认队列，以及打开独立管理页 manage.html 的按钮。
+ * 形制对齐 dsh-memory-evolve 的设置页：三个页签（指南 / 配置 / 版本），
+ * 配置项改完立即 POST 到覆盖层并生效（不需要重启），同时展示记忆状态与
+ * 独立管理页入口。
  * 挂载点：plugins.bundle.config（key = 包名）。
  */
 window.__ModuleLoader__.load({
@@ -13,45 +15,216 @@ window.__ModuleLoader__.load({
     const PKG = "dsh-memory-core";
     const API = "/api/memory-core";
     const jget = async (p) => (await fetch(API + p, { credentials: "same-origin" })).json();
+    const jpost = async (p, body) =>
+      (await fetch(API + p, {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body ?? {}),
+      })).json();
 
     const CSS = `
-[data-pmc-page]{display:flex;flex-direction:column;gap:10px;padding:4px 2px 10px;max-width:640px;font-size:13px;}
+[data-pmc-page]{display:flex;flex-direction:column;gap:10px;padding:4px 2px 10px;max-width:680px;font-size:13px;}
 [data-pmc-head]{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap;}
 [data-pmc-title]{font-size:14px;font-weight:600;}
 [data-pmc-sub]{font-size:12px;color:var(--dsw-alias-label-tertiary,#8a9099);}
+[data-pmc-tabs]{display:flex;gap:4px;border-bottom:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18));}
+[data-pmc-tab]{appearance:none;border:0;background:transparent;font:inherit;font-size:13px;padding:7px 12px;cursor:pointer;color:var(--dsw-alias-label-secondary,#6b7280);border-bottom:2px solid transparent;margin-bottom:-1px;}
+[data-pmc-tab][data-on]{color:var(--dsw-alias-brand-primary,#2f6fed);border-bottom-color:var(--dsw-alias-brand-primary,#2f6fed);font-weight:600;}
+[data-pmc-card]{display:flex;flex-direction:column;gap:12px;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18));border-radius:10px;padding:14px 16px;background:var(--dsw-alias-bg-elevated,#fff);}
+[data-pmc-lead]{font-size:12px;color:var(--dsw-alias-label-tertiary,#8a9099);line-height:18px;}
 [data-pmc-sec]{display:flex;flex-direction:column;gap:6px;border-top:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18));padding-top:10px;}
+[data-pmc-sec]:first-child{border-top:0;padding-top:0;}
+[data-pmc-h]{font-size:13px;font-weight:600;}
 [data-pmc-row]{display:flex;align-items:center;gap:10px;flex-wrap:wrap;min-height:26px;}
-[data-pmc-name]{min-width:100px;flex:none;}
+[data-pmc-name]{min-width:110px;flex:none;}
 [data-pmc-val]{flex:1;color:var(--dsw-alias-label-secondary,#6b7280);}
-[data-pmc-btn]{font-size:12px;min-height:26px;padding:2px 10px;border-radius:6px;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));background:transparent;color:inherit;flex:none;}
+[data-pmc-desc]{flex-basis:100%;font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary,#8a9099);}
+[data-pmc-btn]{appearance:none;font:inherit;font-size:12px;min-height:28px;padding:2px 12px;border-radius:6px;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.35));background:transparent;color:inherit;}
+[data-pmc-btn][data-on]{border-color:var(--dsw-alias-brand-primary,#2f6fed);color:var(--dsw-alias-brand-primary,#2f6fed);background:rgba(47,111,237,.08);}
+[data-pmc-num]{width:88px;min-height:28px;padding:2px 8px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.35));background:transparent;color:inherit;font:inherit;}
+[data-pmc-open]{display:inline-flex;align-items:center;gap:6px;font-size:12px;min-height:28px;padding:2px 12px;border-radius:6px;cursor:pointer;text-decoration:none;border:1px solid var(--dsw-alias-brand-primary,#2f6fed);color:var(--dsw-alias-brand-primary,#2f6fed);background:transparent;flex:none;}
+[data-pmc-open]:hover{background:rgba(47,111,237,.08);}
 [data-pmc-note]{font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary,#8a9099);}
 [data-pmc-chip]{display:inline-block;padding:1px 8px;border-radius:999px;font-size:11px;background:var(--dsw-alias-bg-weak,rgba(128,128,128,.1));}
 [data-pmc-chip="ok"]{background:#e6f5ec;color:#1a7f4b;}
 [data-pmc-chip="warn"]{background:#fdf3e3;color:#b26a00;}
+[data-pmc-chip="muted"]{background:rgba(128,128,128,.14);color:inherit;opacity:.75;}
+[data-pmc-mono]{font-family:ui-monospace,Consolas,monospace;font-size:12px;word-break:break-all;}
+[data-pmc-list]{margin:0;padding-left:18px;line-height:20px;}
+[data-pmc-banner]{position:fixed;top:0;left:0;right:0;z-index:2147483000;display:flex;align-items:flex-start;gap:10px;padding:9px 14px;font-size:12px;line-height:18px;box-shadow:0 1px 0 rgba(0,0,0,.08);}
+[data-pmc-banner="warn"]{background:#fef3c7;color:#7c4a03;}
+[data-pmc-banner="danger"]{background:#fee2e2;color:#991b1b;}
+[data-pmc-bx]{margin-left:auto;flex:none;appearance:none;border:0;background:transparent;color:inherit;cursor:pointer;font:inherit;opacity:.65;}
+[data-pmc-bx]:hover{opacity:1;}
 `;
 
-    const TRACKS_LITE = ["memory", "user", "key"];
-    const TRACKS_FULL = ["memory", "user", "project", "key", "daily"];
     const TRACK_LABELS = { memory: "长期记忆", user: "用户档案", project: "项目记忆", key: "关键事实", daily: "每日日志" };
+    const TABS = [["guide", "指南"], ["config", "配置"], ["version", "版本"]];
+
+    function TabBar({ tab, setTab }) {
+      return h("div", { "data-pmc-tabs": "" },
+        TABS.map(([id, label]) =>
+          h("button", {
+            key: id,
+            type: "button",
+            "data-pmc-tab": "",
+            ...(tab === id ? { "data-on": "" } : {}),
+            onClick: () => setTab(id),
+          }, label),
+        ));
+    }
+
+    /** 开关：用原生 checkbox 承载语义，视觉上是一枚滑块。 */
+    function Toggle({ on, disabled, onChange }) {
+      return h("button", {
+        type: "button",
+        role: "switch",
+        "aria-checked": on ? "true" : "false",
+        "data-pmc-btn": "",
+        ...(on ? { "data-on": "" } : {}),
+        style: { minWidth: "56px", opacity: disabled ? 0.5 : 1 },
+        disabled: !!disabled,
+        onClick: () => onChange(!on),
+      }, on ? "开" : "关");
+    }
+
+    function Guide() {
+      return h("div", { "data-pmc-card": "" },
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "这是什么"),
+          h("div", { "data-pmc-lead": "" },
+            "给被 dsh-memory-shield 遮蔽的会话提供一套隔离记忆：独立数据目录，与普通会话的 dsh-memory-evolve 互不影响。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "五条记忆轨"),
+          h("ul", { "data-pmc-list": "" },
+            h("li", {}, "memory 长期记忆：跨项目通用事实，每轮注入。"),
+            h("li", {}, "user 用户档案：关于用户的稳定偏好，每轮注入。"),
+            h("li", {}, "project 项目日志：按工作目录哈希记录每回合进展，不注入、按需读取。"),
+            h("li", {}, "key 项目关键记忆：下次会话不知道就会做错的事实，注入摘要，写入需确认。"),
+            h("li", {}, "daily 今日日志：按天记录，不注入。"))),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "怎么用"),
+          h("div", { "data-pmc-lead": "" },
+            "会话里用 memory_core 工具写入；管理页可新增、编辑、归档、删除，并处理待确认队列。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "插件列表里为什么显示「已关闭」"),
+          h("div", { "data-pmc-lead": "" },
+            "包自带硬开关（patch 里 disabled: true）：装进 profile 只是加载，默认不跑，避免给所有会话都塞一套记忆。" +
+              "本页显示的状态来自 preset 里的显式挂载——只要这里的条数与路径是活的，就说明它在工作。" +
+              "列表上的开关管的是 profile 层，打开等于让所有会话都用这套记忆，一般不需要。"),
+          h("div", { "data-pmc-desc": "" },
+            "注意：如果已经用 preset 挂载了本包，不要再打开列表开关——两个实例会抢同一个 /api/memory-core 路由，" +
+              "后挂载的 preset 会报 duplicate prefix route 并整体加载失败。误开了就关掉开关、重启，数据不会丢。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "致谢"),
+          h("div", { "data-pmc-lead": "" },
+            "存储层与注入预算参考 dsh-memory-evolve（作者 csyangwen，MIT）的实现，按隔离场景做了适配。")),
+      );
+    }
+
+    function ConfigView({ cfg, save, saving }) {
+      if (!cfg) return h("div", { "data-pmc-note": "" }, "配置读取中…");
+      const full = cfg.memoryTracks === "full";
+      const set = (patch) => save(patch);
+      return h("div", { "data-pmc-card": "" },
+        h("div", { "data-pmc-lead": "" }, "修改立即生效并持久化（写入本 preset 的覆盖层，不改 preset 本身）。"),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "记忆模式"),
+          h("div", { "data-pmc-row": "" },
+            h("button", { type: "button", "data-pmc-btn": "", ...(full ? {} : { "data-on": "" }), disabled: saving, onClick: () => set({ memoryTracks: "lite" }) }, "lite · 三轨"),
+            h("button", { type: "button", "data-pmc-btn": "", ...(full ? { "data-on": "" } : {}), disabled: saving, onClick: () => set({ memoryTracks: "full" }) }, "full · 五轨"),
+            h("span", { "data-pmc-chip": "ok" }, full ? "五轨" : "三轨")),
+          h("div", { "data-pmc-desc": "" }, "lite 只开 memory / user / key；full 再加 project 与 daily（按会话工作目录隔离）。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "记忆写入看门狗"),
+          h("div", { "data-pmc-row": "" },
+            h("span", { "data-pmc-val": "" }, "连续多轮没写记忆时在快照里提醒"),
+            h(Toggle, { on: cfg.writeGuard === true, disabled: saving, onChange: (v) => set({ writeGuard: v }) })),
+          h("div", { "data-pmc-desc": "" }, "关掉后 key 轨写入也不再进待确认队列，直接落盘。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "看门狗阈值（轮）"),
+          h("div", { "data-pmc-row": "" },
+            h("input", {
+              type: "number",
+              min: 1,
+              step: 1,
+              "data-pmc-num": "",
+              defaultValue: cfg.writeGuardThreshold,
+              disabled: saving,
+              onBlur: (e) => {
+                const n = parseInt(e.target.value, 10);
+                if (Number.isInteger(n) && n >= 1 && n !== cfg.writeGuardThreshold) set({ writeGuardThreshold: n });
+              },
+            }),
+            h("span", { "data-pmc-val": "" }, "连续 N 轮未写入即提醒（2 = 容忍漏 1 轮）")),
+          h("div", { "data-pmc-desc": "" }, "失焦即保存。小于 1 的值会被忽略。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "快照顺序"),
+          h("div", { "data-pmc-row": "" },
+            h("input", {
+              type: "number",
+              step: 10,
+              "data-pmc-num": "",
+              defaultValue: cfg.snapshotOrder,
+              disabled: saving,
+              onBlur: (e) => {
+                const n = parseInt(e.target.value, 10);
+                if (Number.isInteger(n) && n !== cfg.snapshotOrder) set({ snapshotOrder: n });
+              },
+            }),
+            h("span", { "data-pmc-val": "" }, "注入段在同名段里的排序")),
+          h("div", { "data-pmc-desc": "" }, "顺序改动要重启 DSH 才对已存在的会话生效（挂载时注册）。")),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-row": "" },
+            h("span", { "data-pmc-name": "" }, "覆盖层文件"),
+            h("span", { "data-pmc-val": "", "data-pmc-mono": "" }, cfg.livePath || "—"))),
+        saving ? h("div", { "data-pmc-note": "" }, "保存中…") : null,
+      );
+    }
+
+    function Version({ cfg }) {
+      return h("div", { "data-pmc-card": "" },
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "版本"),
+          h("div", { "data-pmc-row": "" }, h("span", { "data-pmc-val": "" }, "dsh-memory-core 0.1.4"))),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-h": "" }, "本版要点"),
+          h("ul", { "data-pmc-list": "" },
+            h("li", {}, "默认 full 五轨；数据落点仍是本 preset 的独立目录。"),
+            h("li", {}, "管理页按 memory-evolve 的形制重做：页签、条数、路径、美观/纯文本切换、搜索。"),
+            h("li", {}, "注入前净化 {{}}，避免记忆正文被宿主当模板解析。"),
+            h("li", {}, "配置可在此页修改，立即生效。"))),
+        h("div", { "data-pmc-sec": "" },
+          h("div", { "data-pmc-row": "" },
+            h("a", { href: "/api/memory-core/manage", target: "_blank", rel: "noopener", "data-pmc-open": "" }, "打开记忆管理页"),
+            h("span", { "data-pmc-note": "" }, cfg?.presetName ? "preset " + cfg.presetName : ""))),
+      );
+    }
 
     function Panel() {
       const [st, setSt] = React.useState(null);
+      const [cfg, setCfg] = React.useState(null);
+      const [tab, setTab] = React.useState("guide");
+      const [saving, setSaving] = React.useState(false);
       const [err, setErr] = React.useState("");
 
       const load = React.useCallback(async () => {
         try {
-          // 拉各轨条数 + 待确认（后端没有 /pending，pending 挂在 /entries 的返回里）
-          const tracks = TRACKS_LITE; // 默认 lite，full 模式需要切配置
-          const counts = {};
-          let pendingCount = 0;
-          for (const t of tracks) {
-            try {
-              const j = await jget(`/entries?track=${t}`);
-              counts[t] = j.ok ? j.data.count : 0;
-              if (j.ok && Array.isArray(j.data.pending)) pendingCount += j.data.pending.length;
-            } catch { counts[t] = 0; }
-          }
-          setSt({ counts, pendingCount, tracks });
+          const [j, c] = await Promise.all([jget("/files"), jget("/config")]);
+          if (!j.ok) throw new Error(j.why || "状态读取失败");
+          const d = j.data;
+          const rows = Array.isArray(d.rows) ? d.rows : [];
+          setSt({
+            rows,
+            mode: d.memoryTracks,
+            preset: d.presetName,
+            dir: d.memoryDir,
+            pending: rows.reduce((a, r) => a + (r.pending || 0), 0),
+            archived: rows.reduce((a, r) => a + (r.archived || 0), 0),
+            needCwd: rows.some((r) => r.track === "project" || r.track === "key") && !d.cwd,
+          });
+          if (c && c.ok) setCfg(c.data);
           setErr("");
         } catch (e) {
           setErr(String(e?.message || e));
@@ -60,39 +233,109 @@ window.__ModuleLoader__.load({
 
       React.useEffect(() => {
         load();
-        const t = setInterval(load, 10000);
-        return () => clearInterval(t);
+      }, [load]);
+
+      const save = React.useCallback(async (patch) => {
+        setSaving(true);
+        try {
+          const j = await jpost("/config", { patch });
+          if (!j.ok) throw new Error(j.why || "保存失败");
+          setCfg(j.data);
+          await load();
+        } catch (e) {
+          setErr(String(e?.message || e));
+        } finally {
+          setSaving(false);
+        }
       }, [load]);
 
       if (err) return h("div", { "data-pmc-page": "" }, h("div", { "data-pmc-note": "" }, "状态读取失败：" + err));
       if (!st) return h("div", { "data-pmc-page": "" }, h("div", { "data-pmc-note": "" }, "读取中…"));
 
+      const full = st.mode === "full";
+
       return h("div", { "data-pmc-page": "" },
         h("div", { "data-pmc-head": "" },
           h("span", { "data-pmc-title": "" }, "遮蔽会话记忆"),
-          h("span", { "data-pmc-sub": "" }, "记忆核心 · 数据与普通会话完全隔离")),
-        h("div", { "data-pmc-sec": "" },
-          h("div", { "data-pmc-row": "" },
-            h("span", { "data-pmc-name": "" }, "当前模式"),
-            h("span", { "data-pmc-val": "" }, "lite（三轨 memory/user/key）"),
-            h("span", { "data-pmc-chip": "ok" }, "默认")),
-          h("div", { "data-pmc-row": "" },
-            h("span", { "data-pmc-name": "" }, "待确认记忆"),
-            h("span", { "data-pmc-val": "" }, st.pendingCount > 0 ? `${st.pendingCount} 条待确认` : "无"),
-            st.pendingCount > 0 ? h("span", { "data-pmc-chip": "warn" }, "需处理") : null)),
+          h("span", { "data-pmc-sub": "" }, "preset " + (st.preset || "—") + " · 与普通会话完全隔离"),
+          h("span", { "data-pmc-chip": "ok" }, full ? "五轨" : "三轨"),
+          st.pending > 0 ? h("span", { "data-pmc-chip": "warn" }, st.pending + " 条待确认") : null),
+        h(TabBar, { tab, setTab }),
+        tab === "guide" ? h(Guide) : null,
+        tab === "config" ? h(ConfigView, { cfg, save, saving }) : null,
+        tab === "version" ? h(Version, { cfg }) : null,
         h("div", { "data-pmc-sec": "" },
-          ...st.tracks.map((t) =>
-            h("div", { "data-pmc-row": "", key: t },
-              h("span", { "data-pmc-name": "" }, TRACK_LABELS[t] || t),
-              h("span", { "data-pmc-val": "" }, `${st.counts[t] || 0} 条`),
+          ...st.rows.map((r) =>
+            h("div", { "data-pmc-row": "", key: r.track },
+              h("span", { "data-pmc-name": "" }, TRACK_LABELS[r.track] || r.track),
+              h("span", { "data-pmc-val": "" }, r.available ? `${r.count || 0} 条 · ${r.path || ""}` : "需会话工作目录"),
+              r.pending > 0 ? h("span", { "data-pmc-chip": "warn" }, `${r.pending} 待确认`) : null,
+              r.archived > 0 ? h("span", { "data-pmc-chip": "muted" }, `归档 ${r.archived}`) : null,
             ),
           )),
-        h("div", { "data-pmc-sec": "" },
-          h("div", { "data-pmc-row": "" },
-            h("a", { href: "/api/memory-core/manage", target: "_blank", rel: "noopener", "data-pmc-btn": "" }, "打开记忆管理面板"),
-          ),
-          h("div", { "data-pmc-note": "" },
-            "管理面板在独立窗口打开，可查看/修改/归档各轨记忆。升级到 full 模式（五轨）需在配置里改 memoryTracks=full。")),
+        h("div", { "data-pmc-note": "" },
+          "数据目录：" + (st.dir || "—") + (st.needCwd
+            ? "。项目记忆与关键事实按会话工作目录隔离，管理页会自动带上当前 cwd。"
+            : "。")),
+      );
+    }
+
+    /**
+     * 顶部横幅：把「配置方式不对」的隐形代价变成看得见的告警。
+     *
+     * 两种危险状况各一档：
+     * - 红：遮蔽在 profile 层生效（插件列表开关），所有会话的记忆工具与注入都被挡掉——这是全局破坏；
+     * - 黄：记忆核在 profile 层生效（没在 preset 里挂），所有会话多一份隔离记忆并与 evolve 双写。
+     * 判定只读两个插件的公开状态接口，不改任何配置；用户关掉横幅只在当前页面生效（不持久化）。
+     */
+    function Banner() {
+      const [state, setState] = React.useState(null);
+      const [hidden, setHidden] = React.useState(false);
+      React.useEffect(() => {
+        let alive = true;
+        const tick = async () => {
+          try {
+            const [core, shield] = await Promise.all([
+              jget("/status").catch(() => null),
+              fetch("/api/memory-shield/health", { credentials: "same-origin" })
+                .then((r) => r.json())
+                .catch(() => null),
+            ]);
+            if (!alive) return;
+            const c = core?.data ?? {};
+            const sh = shield?.data ?? shield ?? {};
+            if (sh.layer === "profile" && sh.enabled === true && (sh.shadowTools || 0) > 0) {
+              setState({
+                kind: "danger",
+                text:
+                  "记忆遮蔽正在全局生效：所有会话的记忆工具与上下文段都被挡掉，只剩 memory_core。" +
+                  "这是全局破坏性配置，请立刻关掉插件列表里的 dsh-memory-shield 开关，改成只在目标 preset 里挂载并开 enabled。",
+              });
+            } else if (c.layer === "profile") {
+              setState({
+                kind: "warn",
+                text:
+                  "dsh-memory-core 是被插件列表开关拉起来的（没在 preset 里挂）：所有会话都会多一份隔离记忆，" +
+                  "并与记忆插件双写；数据落在 " + (c.memoryDir || "（未知目录）") + "。建议关掉列表开关，只在目标 preset 里挂载它。",
+              });
+            } else {
+              setState(null);
+            }
+          } catch {
+            if (alive) setState(null);
+          }
+        };
+        tick();
+        const id = setInterval(tick, 30000);
+        return () => {
+          alive = false;
+          clearInterval(id);
+        };
+      }, []);
+      if (!state || hidden) return null;
+      return h("div", { "data-pmc-banner": state.kind, role: "alert" },
+        h("span", null, (state.kind === "danger" ? "⛔ " : "⚠️ ") + state.text),
+        h("button", { "data-pmc-bx": "", onClick: () => setHidden(true) }, "关闭"),
       );
     }
 
@@ -111,6 +354,11 @@ window.__ModuleLoader__.load({
           { name: "plugins.bundle.config", key: PKG },
           Panel,
         ));
+        // 顶部横幅走 shell.overlay（list 型槽位，用 id）
+        slots.inject("shell.overlay", () => slots.register(
+          { name: "shell.overlay", id: "memory-core-banner" },
+          Banner,
+        ));
       },
     };
   },