@modusensus/dsh-mneme 0.6.5 → 0.6.7

package/README.md

@@ -5,7 +5,11 @@
 [![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-628%20passed-success)](https://github.com/modusensus/dsh-mneme)
+[![tests](https://img.shields.io/badge/tests-716%20passed-success)](https://github.com/modusensus/dsh-mneme)
+[![CI](https://img.shields.io/github/actions/workflow/status/modusensus/dsh-mneme/test.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)
+[![coverage](https://img.shields.io/codecov/c/github/modusensus/dsh-mneme/main)](https://codecov.io/gh/modusensus/dsh-mneme)
 
 > 给 DeepSeek Harness 的跨会话记忆插件：让 Agent 记住你、记住项目、自动整理记忆。**Mneme**（Μνήμη）——希腊记忆女神 Mnemosyne 之名，掌管记忆与梦境，正如 autoDream 在后台巩固记忆。
 
@@ -226,6 +230,8 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
 
 | 版本 | 亮点 |
 |------|------|
+| **v0.6.7** | 记忆面板前端增强：记忆删除端点 + autoTag 手动开关 + 目录 VS Code 式文件树 + 面板卡片式布局（分类栏 + search/tree/detail 三卡）；716 测试全绿 |
+| **v0.6.6** | kimi-k3 复验 4 项修复：autoTag 跳过已打标记忆并合并、tag: 搜索召回统计门控（避免零召回拖垮 TopK）；710 测试全绿 |
 | **v0.6.5** | 整合 v0.6.2-0.6.4：Tag 系统 + 目录视图 + Tag 加权召回（全部 opt-in）；709 测试全绿 |
 | **v0.6.4** | Tag 加权召回：query/session tag 交集 boost（`tagBoostEnabled` 默认关） |
 | **v0.6.3** | 目录视图：Tag 文件夹 + 无标签兜底 + 点击跳详情 |
@@ -425,7 +431,7 @@ src/
 lib/
 ├── client.js         # Web 面板（手写 ModuleLoader bundle）
 └── *.js              # src 的同步分发产物
-test/                 # 628 个 node:test 测试（含审计与三轴线压测不变量）
+test/                 # 716 个 node:test 测试（含审计与三轴线压测不变量）
 scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压测 · sync-lib.js 同步 · benchmark-recall.js 召回基准
 ```
 
@@ -434,7 +440,7 @@ scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压
 ```bash
 cd dsh-mneme
 npm install        # 安装 peer 依赖（以 devDependencies 形式，用于本地测试）
-npm test           # 运行 628 个测试
+npm test           # 运行 716 个测试
 npm run stress     # 三轴线压测：长会话检索 / 冲突仲裁 / 多 Agent 并发（离线 mock LLM）
 npm run sync       # 把 src/ 同步到 lib/（发布时由 prepack 钩子自动执行）
 ```

package/lib/api.js

@@ -218,6 +218,96 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
     }
   });
 
+  // --- app config read/write (partial: pass only the fields to change) ---
+  register({
+    kind: "exact",
+    path: "/api/dsh-mneme/config",
+    handler: async (req, res) => {
+      try {
+        if (!requireAuth(req, res, apiToken)) return;
+        if (req.method === "PUT" || req.method === "POST") {
+          const body = parseBody(await readBody(req));
+          const patch = {};
+          const setIfBoolean = (key) => {
+            if (Object.prototype.hasOwnProperty.call(body, key)) {
+              if (typeof body[key] !== "boolean") {
+                sendJson(res, 400, { error: `${key} must be a boolean` });
+                return false;
+              }
+              patch[key] = body[key];
+            }
+            return true;
+          };
+          if (!setIfBoolean("autoTagEnabled") || !setIfBoolean("manualTagEnabled")) return;
+          if (Object.keys(patch).length === 0) {
+            sendJson(res, 400, { error: "no valid config field provided" });
+            return;
+          }
+          const config = settings.setAutoTagConfig(patch);
+          sendJson(res, 200, { config });
+          return;
+        }
+        sendJson(res, 200, { config: settings.getAutoTagConfig() });
+      } catch {
+        sendJson(res, 500, { error: "internal" });
+      }
+    }
+  });
+
+  // --- delete a memory by exact id or best query match (mirrors memory_delete tool) ---
+  register({
+    kind: "exact",
+    path: "/api/dsh-mneme/memories",
+    handler: async (req, res) => {
+      try {
+        if (!requireAuth(req, res, apiToken)) return;
+        if (req.method !== "DELETE") {
+          sendJson(res, 405, { error: "method not allowed" });
+          return;
+        }
+        const body = parseBody(await readBody(req));
+        const hasId = Object.prototype.hasOwnProperty.call(body, "id");
+        const hasQuery = Object.prototype.hasOwnProperty.call(body, "query");
+        if ((hasId && hasQuery) || (!hasId && !hasQuery)) {
+          sendJson(res, 400, { error: "provide exactly one of id or query" });
+          return;
+        }
+        if (hasId) {
+          if (typeof body.id !== "string" || !body.id.trim()) {
+            sendJson(res, 400, { error: "invalid id" });
+            return;
+          }
+          const mem = service.getById(body.id);
+          if (!mem) {
+            sendJson(res, 200, { deleted: false });
+            return;
+          }
+          service.remove(body.id);
+          sendJson(res, 200, { deleted: true, id: body.id });
+          return;
+        }
+        if (typeof body.query !== "string" || !body.query.trim()) {
+          sendJson(res, 400, { error: "invalid query" });
+          return;
+        }
+        const results = await service.searchMemories(body.query, { mode: "auto", topK: 1, useRerank: true });
+        if (!Array.isArray(results) || results.length === 0) {
+          sendJson(res, 200, { deleted: false });
+          return;
+        }
+        const mem = results[0];
+        if (!mem || !mem.id) {
+          sendJson(res, 200, { deleted: false });
+          return;
+        }
+        service.remove(mem.id);
+        sendJson(res, 200, { deleted: true, id: mem.id });
+      } catch {
+        sendJson(res, 500, { error: "internal" });
+      }
+    }
+  });
+
   // --- vector re-index (backfill embeddings for rows missing them) ---
   register({
     kind: "exact",

package/lib/client.js

@@ -72,6 +72,11 @@ window.__ModuleLoader__.load({
         "memory.settings.profileSaved": "画像已保存",
         "memory.settings.rules": "规则",
         "memory.settings.rulesHint": "Agent 必须遵守的行为规则，每轮注入",
+        "memory.settings.autoTagTitle": "自动打标签",
+        "memory.settings.autoTagHint": "开启后，新记忆由轻量模型自动打标签，目录页按标签自动分类（opt-in，默认关）",
+        "memory.settings.autoTagEnabled": "自动打标签",
+        "memory.settings.autoTagSave": "保存",
+        "memory.settings.autoTagSaved": "已保存",
         "memory.settings.ruleAdd": "添加规则",
         "memory.settings.rulePlaceholder": "例如：回答时总是先给结论",
         "memory.settings.commands": "自定义指令",
@@ -115,6 +120,8 @@ window.__ModuleLoader__.load({
         "memory.directory.untagged": "无标签",
         "memory.directory.loading": "加载中…",
         "memory.directory.empty": "暂无记忆条目",
+        "directory.editToggle": "编辑模式（显示删除）",
+        "directory.deleteConfirm": "确定删除这条记忆吗？",
         "memory.card.open": "在主区记忆库中查看全文",
         "memory.time.now": "刚刚",
         "memory.time.seconds": "{n}秒前",
@@ -172,6 +179,11 @@ window.__ModuleLoader__.load({
         "memory.settings.profileSaved": "Profile saved",
         "memory.settings.rules": "Rules",
         "memory.settings.rulesHint": "Behavior rules the agent must follow every turn",
+        "memory.settings.autoTagTitle": "Auto-Tag",
+        "memory.settings.autoTagHint": "When on, new memories are auto-tagged by a light model and the directory auto-grouped by tag (opt-in, off by default)",
+        "memory.settings.autoTagEnabled": "Auto-tagging",
+        "memory.settings.autoTagSave": "Save",
+        "memory.settings.autoTagSaved": "Saved",
         "memory.settings.ruleAdd": "Add Rule",
         "memory.settings.rulePlaceholder": "e.g. Always lead with a conclusion",
         "memory.settings.commands": "Custom Commands",
@@ -215,6 +227,8 @@ window.__ModuleLoader__.load({
         "memory.directory.untagged": "Untagged",
         "memory.directory.loading": "Loading…",
         "memory.directory.empty": "No memories yet",
+        "directory.editToggle": "Edit mode",
+        "directory.deleteConfirm": "Delete this memory?",
         "memory.card.open": "Open full text in the Memory tab",
         "memory.time.now": "just now",
         "memory.time.seconds": "{n}s ago",
@@ -365,6 +379,13 @@ window.__ModuleLoader__.load({
       // --- detail column ---
       ".mneme-xdetail{flex:none;max-height:44%;min-height:0;overflow-y:auto;padding:14px 20px 16px;border-bottom:1px solid var(--dsw-alias-border-l2)}",
       ".mneme-xtree{flex:1;min-height:0;overflow-y:auto;padding:8px 10px 28px}",
+      ".mneme-xmain{display:flex;flex-direction:column}",
+      ".mneme-xfilter-bar{flex:none;height:48px;display:flex;align-items:center;gap:8px;padding:0 12px;border-bottom:1px solid var(--dsw-alias-border-l2,#ddd)}",
+      ".mneme-xcards{flex:1;display:flex;flex-direction:row;gap:12px;padding:12px;overflow:hidden}",
+      ".mneme-card{background:var(--dsw-alias-bg-base,#fafafa);border-radius:8px;box-shadow:0 1px 3px rgba(0,0,0,.06);padding:12px;display:flex;flex-direction:column;overflow:auto}",
+      ".mneme-card--search{width:236px;flex:none}",
+      ".mneme-card--tree{width:260px;flex:none}",
+      ".mneme-card--detail{flex:1;min-width:0}",
       ".mneme-xdinner{max-width:720px}",
       ".mneme-xdtitle{font-size:16px;font-weight:600;line-height:24px;color:var(--dsw-alias-label-primary);margin-bottom:10px;word-break:break-word}",
       ".mneme-xdmeta{display:flex;flex-wrap:wrap;gap:4px 14px;margin-bottom:6px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}",
@@ -408,6 +429,16 @@ window.__ModuleLoader__.load({
       ".mneme-gs-link:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}",
       // --- directory sub-view (v0.6.3): tag folders + memory entries ---
       ".mneme-directory{flex:1;min-height:0;overflow-y:auto;padding:8px 10px 28px}",
+      ".mneme-edit-toggle{margin:6px 10px;display:flex;align-items:center;gap:6px;font-size:12px;cursor:pointer;user-select:none}",
+      ".mneme-dir-item{position:relative;display:flex;align-items:center;gap:6px;padding:2px 6px;border-radius:4px}",
+      ".mneme-dir-item:hover{background:rgba(127,127,127,.18)}",
+      ".mneme-tree-line{width:14px;height:1px;border-top:1px dashed rgba(127,127,127,.5);flex:none}",
+      ".mneme-dir-item .mneme-dir-del{opacity:0;transition:opacity .12s}",
+      ".mneme-dir-item:hover .mneme-dir-del{opacity:1}",
+      ".mneme-dir-del{margin-left:auto;background:none;border:none;color:#e5484d;cursor:pointer;font-size:13px;line-height:1;padding:2px 4px}",
+      ".mneme-dir-del:hover{filter:brightness(1.25)}",
+      ".mneme-edit-on .mneme-dir-del{opacity:1}",
+      ".mneme-dir-ititle{background:none;border:none;padding:0;font:inherit;color:inherit;cursor:pointer;flex:1;text-align:left;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
       ".mneme-dir-folder{margin-bottom:4px}",
       ".mneme-dir-folderhead{display:flex;align-items:center;gap:6px;width:100%;padding:6px 8px;border:none;border-radius:8px;background:none;color:var(--dsw-alias-label-primary);cursor:pointer;font-family:inherit;font-size:13px;font-weight:500;line-height:18px;text-align:left}",
       ".mneme-dir-folderhead:hover{background:var(--dsw-alias-interactive-bg-hover)}",
@@ -832,6 +863,8 @@ window.__ModuleLoader__.load({
         (typeof window !== "undefined" && window.localStorage) ? window.localStorage.getItem("dsh-mneme-api-token") || "" : ""
       );
       const [apiTokenSaved, setApiTokenSaved] = react.useState(false);
+      const [autoTag, setAutoTag] = react.useState(false);
+      const [autoTagSaved, setAutoTagSaved] = react.useState(false);
 
       const load = react.useCallback(async () => {
         try {
@@ -845,6 +878,11 @@ window.__ModuleLoader__.load({
           setRules(Array.isArray(r.rules) ? r.rules : []);
           setCommands(Array.isArray(c.commands) ? c.commands : []);
           setVector(v.config || { enabled: false, baseUrl: "", apiKey: "", model: "" });
+          // autoTag loads independently so a config failure can't cascade-block the rest.
+          try {
+            const g = await apiFetch("/api/dsh-mneme/config").then((res) => res.json());
+            setAutoTag(g.config?.autoTagEnabled === true);
+          } catch { /* keep default off */ }
         } catch { /* ignore */ }
       }, []);
 
@@ -941,6 +979,18 @@ window.__ModuleLoader__.load({
         } catch { /* ignore */ }
       }
 
+      async function saveAutoTag() {
+        try {
+          await apiFetch("/api/dsh-mneme/config", {
+            method: "PUT",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ autoTagEnabled: autoTag })
+          });
+          setAutoTagSaved(true);
+          setTimeout(() => setAutoTagSaved(false), 1500);
+        } catch { /* ignore */ }
+      }
+
       const inputStyle = { boxSizing: "border-box", width: "100%", height: 34, padding: "0 12px", borderRadius: 10, border: "1px solid var(--dsw-alias-border-l2, #ddd)", background: "var(--dsw-alias-bg-base, transparent)", color: "var(--dsw-alias-label-primary)", fontFamily: "inherit", fontSize: 13, outline: "none", marginBottom: 8 };
       const labelStyle = { fontSize: 12, fontWeight: 600, margin: "12px 0 4px", color: "var(--dsw-alias-label-primary)" };
       const hintStyle = { fontSize: 11, color: "var(--dsw-alias-label-tertiary, #999)", marginBottom: 8 };
@@ -1007,6 +1057,17 @@ window.__ModuleLoader__.load({
           h("button", { style: styles.footerButton, onClick: addCommand }, t("memory.settings.cmdAdd")),
           cmdError && h("div", { style: { fontSize: 12, color: "var(--dsw-alias-state-error, #c33)" } }, cmdError)
         ),
+        // auto-tag switch
+        h("div", { style: { ...labelStyle, marginTop: 20 } }, t("memory.settings.autoTagTitle")),
+        h("div", { style: hintStyle }, t("memory.settings.autoTagHint")),
+        h("label", { style: { display: "flex", alignItems: "center", gap: 6, marginBottom: 8, fontSize: 13 } },
+          h("input", { type: "checkbox", checked: autoTag, onChange: (e) => setAutoTag(e.target.checked) }),
+          h("span", null, t("memory.settings.autoTagEnabled"))
+        ),
+        h("div", { style: { display: "flex", alignItems: "center", gap: 6 } },
+          h("button", { style: styles.footerButton, onClick: saveAutoTag }, t("memory.settings.autoTagSave")),
+          autoTagSaved && h("span", { style: { fontSize: 12, color: "var(--dsw-alias-state-success, #2a7)" } }, t("memory.settings.autoTagSaved"))
+        ),
         // vector search
         h("div", { style: { ...labelStyle, marginTop: 20 } }, t("memory.settings.vectorTitle")),
         h("div", { style: hintStyle }, t("memory.settings.vectorHint")),
@@ -1120,6 +1181,7 @@ window.__ModuleLoader__.load({
     function DirectoryPanel({ t, onJump, collapsed, setCollapsed }) {
       const [dir, setDir] = useState(null); // { groups: [...], untagged: [...] }
       const [status, setStatus] = useState("loading"); // loading | ready | error
+      const [editMode, setEditMode] = useState(false); // manual tag/delete UI gate
 
       useEffect(() => {
         let cancelled = false;
@@ -1133,23 +1195,52 @@ window.__ModuleLoader__.load({
             setStatus("ready");
           })
           .catch(() => { if (!cancelled) { setDir(null); setStatus("error"); } });
+        apiFetch("/api/dsh-mneme/config")
+          .then((res) => (res.ok ? res.json() : null))
+          .then((d) => { if (!cancelled && d?.config && typeof d.config.manualTagEnabled === "boolean") setEditMode(d.config.manualTagEnabled); })
+          .catch(() => {});
         return () => { cancelled = true; };
       }, []);
 
       const toggle = (key) => setCollapsed((c) => ({ ...c, [key]: !c[key] }));
 
+      const toggleEdit = () => {
+        const next = !editMode;
+        apiFetch("/api/dsh-mneme/config", {
+          method: "PUT",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ manualTagEnabled: next })
+        }).then((res) => { if (res.ok) setEditMode(next); }).catch(() => {});
+      };
+
+      const handleDelete = (memId, e) => {
+        e?.stopPropagation?.();
+        if (typeof window === "undefined" || !window.confirm(t("directory.deleteConfirm"))) return;
+        apiFetch("/api/dsh-mneme/memories", {
+          method: "DELETE",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ id: memId })
+        })
+          .then((res) => (res.ok ? res.json() : null))
+          .then((d) => {
+            if (!d || d.deleted !== true) return;
+            setDir((prev) => ({
+              groups: prev.groups.map((g) => ({ ...g, memories: g.memories.filter((m) => m.id !== memId) })),
+              untagged: prev.untagged.filter((m) => m.id !== memId)
+            }));
+          })
+          .catch(() => {});
+      };
+
       const renderFolder = (name, memories, extraKey, emptyLabel) => {
         const folderKey = extraKey || name;
         const open = !collapsed[folderKey];
         const rows = memories.map((m) =>
-          h("button", {
-            key: m.id,
-            type: "button",
-            className: "mneme-dir-item",
-            onClick: () => onJump(m)
-          },
-            h("span", { className: "mneme-dir-ititle" }, m.title || m.content?.slice(0, 40)),
-            h("span", { className: "mneme-dir-itime" }, formatDate(m.updated_at || m.created_at))
+          h("div", { key: m.id, className: "mneme-dir-item" },
+            h("span", { className: "mneme-tree-line" }),
+            h("button", { type: "button", className: "mneme-dir-ititle", onClick: () => onJump(m) }, m.title || m.content?.slice(0, 40)),
+            h("span", { className: "mneme-dir-itime" }, formatDate(m.updated_at || m.created_at)),
+            editMode && h("button", { type: "button", className: "mneme-dir-del", "aria-label": "delete", onClick: (e) => handleDelete(m.id, e) }, "✕")
           )
         );
         return h("div", {
@@ -1164,7 +1255,7 @@ window.__ModuleLoader__.load({
             onClick: () => toggle(folderKey)
           },
             h("span", { className: "mneme-dir-caret" }, open ? "▾" : "▸"),
-            h("span", { className: "mneme-dir-fname" }, name),
+            h("span", { className: "mneme-dir-fname" }, `📁 ${name}`),
             h("span", { className: "mneme-dir-fcount" }, String(memories.length))
           ),
           open && h("div", { className: "mneme-dir-fbody" },
@@ -1180,7 +1271,11 @@ window.__ModuleLoader__.load({
       if (status === "error" || !hasAny) {
         return h("div", { className: "mneme-directory" }, h("div", { className: "mneme-dir-empty" }, t("memory.directory.empty")));
       }
-      return h("div", { className: "mneme-directory" },
+      return h("div", { className: editMode ? "mneme-directory mneme-edit-on" : "mneme-directory" },
+        h("label", { className: "mneme-edit-toggle" },
+          h("input", { type: "checkbox", checked: editMode, onChange: toggleEdit }),
+          t("directory.editToggle")
+        ),
         dir.groups.map((g) => renderFolder(g.tag, g.memories)),
         dir.untagged.length > 0 && renderFolder(t("memory.directory.untagged"), dir.untagged, "mneme-untagged")
       );
@@ -1426,38 +1521,8 @@ window.__ModuleLoader__.load({
           ),
           ),
         view === "memory" && h("div", { className: "mneme-xmain" },
-          h("div", { className: "mneme-xside" },
-            h("div", { className: "mneme-xcolhead" }, t("memory.explorer.searchTitle")),
-            h("input", {
-              className: "mneme-search mneme-xsearch",
-              placeholder: t("memory.explorer.search"),
-              value: query,
-              onChange: (e) => setQuery(e.target.value)
-            }),
-            entityQuery && h("button", {
-              className: "mneme-entitychip",
-              style: { textAlign: "left", justifyContent: "flex-start" },
-              onClick: () => openGraphFor(entityQuery)
-            }, `${t("memory.graph.viewInGraph")} “${entityQuery}”`),
-            h("div", { className: "mneme-xrow" },
-              vecEnabled && h("button", {
-                className: semantic ? "mneme-chip mneme-active" : "mneme-chip",
-                title: t("memory.settings.vectorTitle"),
-                onClick: () => setSemantic(!semantic)
-              }, t("memory.panel.semantic")),
-              h("select", {
-                className: "mneme-select mneme-xselect",
-                value: searchTopK,
-                onChange: (e) => setSearchTopK(Number(e.target.value)),
-                title: t("memory.explorer.topK")
-              }, [5, 10, 20, 50].map((n) => h("option", { key: n, value: n }, t("memory.explorer.topKOption").replace("{n}", String(n)))))
-            ),
-            h("div", { className: "mneme-xrow" },
-              h("span", { className: "mneme-xcount" }, t("memory.explorer.count").replace("{n}", String(visible.length))),
-              h("button", { className: "mneme-footbtn", onClick: () => setReloadKey((k) => k + 1) }, t("memory.explorer.refresh"))
-            )
-          ),
-          h("div", { className: "mneme-xside mneme-xside--filter" },
+          // 1. 中间分类栏
+          h("div", { className: "mneme-xfilter-bar" },
             h("div", { className: "mneme-xcolhead" }, t("memory.explorer.types")),
             h("button", {
               className: type === "all" ? "mneme-xtype mneme-active" : "mneme-xtype",
@@ -1473,8 +1538,88 @@ window.__ModuleLoader__.load({
                 h("span", { className: "mneme-xcount2" }, String(counts[key]))
               ))
           ),
-          h("div", { className: "mneme-xbrowse" },
-            h("div", { className: "mneme-xdetail" },
+          // 2. 底部三卡片
+          h("div", { className: "mneme-xcards" },
+            // 左卡：搜索
+            h("div", { className: "mneme-card mneme-card--search" },
+              h("div", { className: "mneme-xcolhead" }, t("memory.explorer.searchTitle")),
+              h("input", {
+                className: "mneme-search mneme-xsearch",
+                placeholder: t("memory.explorer.search"),
+                value: query,
+                onChange: (e) => setQuery(e.target.value)
+              }),
+              entityQuery && h("button", {
+                className: "mneme-entitychip",
+                style: { textAlign: "left", justifyContent: "flex-start" },
+                onClick: () => openGraphFor(entityQuery)
+              }, `${t("memory.graph.viewInGraph")} “${entityQuery}”`),
+              h("div", { className: "mneme-xrow" },
+                vecEnabled && h("button", {
+                  className: semantic ? "mneme-chip mneme-active" : "mneme-chip",
+                  title: t("memory.settings.vectorTitle"),
+                  onClick: () => setSemantic(!semantic)
+                }, t("memory.panel.semantic")),
+                h("select", {
+                  className: "mneme-select mneme-xselect",
+                  value: searchTopK,
+                  onChange: (e) => setSearchTopK(Number(e.target.value)),
+                  title: t("memory.explorer.topK")
+                }, [5, 10, 20, 50].map((n) => h("option", { key: n, value: n }, t("memory.explorer.topKOption").replace("{n}", String(n)))))
+              ),
+              h("div", { className: "mneme-xrow" },
+                h("span", { className: "mneme-xcount" }, t("memory.explorer.count").replace("{n}", String(visible.length))),
+                h("button", { className: "mneme-footbtn", onClick: () => setReloadKey((k) => k + 1) }, t("memory.explorer.refresh"))
+              )
+            ),
+            // 中卡：时间树
+            h("div", { className: "mneme-card mneme-card--tree" },
+              h("div", { className: "mneme-xcolhead" }, t("memory.explorer.timeline")),
+              loading
+                ? h("div", { className: "mneme-xempty" }, "…")
+                : months.length === 0
+                  ? h("div", { className: "mneme-xempty" }, t("memory.explorer.empty"))
+                  : months.map((month) =>
+                      h("div", { key: month.key },
+                        h("button", {
+                          className: "mneme-xmonth",
+                          "aria-expanded": String(!collapsed[month.key]),
+                          onClick: () => setCollapsed((c) => ({ ...c, [month.key]: !c[month.key] }))
+                        },
+                          h("span", { className: "mneme-xcaret" }, collapsed[month.key] ? "▸" : "▾"),
+                          month.label
+                        ),
+                        !collapsed[month.key] && month.days.map((day) =>
+                          h("div", { key: day.key },
+                            h("button", {
+                              className: "mneme-xday",
+                              "aria-expanded": String(!collapsed[day.key]),
+                              onClick: () => setCollapsed((c) => ({ ...c, [day.key]: !c[day.key] }))
+                            },
+                              h("span", { className: "mneme-xcaret" }, collapsed[day.key] ? "▸" : "▾"),
+                              day.label
+                            ),
+                            !collapsed[day.key] && day.items.map((m) => {
+                              const d = new Date(m.updated_at || m.created_at || 0);
+                              const time = Number.isNaN(d.getTime())
+                                ? ""
+                                : d.toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit" });
+                              return h("button", {
+                                key: m.id,
+                                ref: (el) => { if (el) itemRefs.current.set(m.id, el); else itemRefs.current.delete(m.id); },
+                                className: m.id === selectedId ? "mneme-xitem mneme-active" : "mneme-xitem",
+                                onClick: () => setSelectedId(m.id)
+                              },
+                                h("span", { className: "mneme-xtime" }, time),
+                                h("span", { className: "mneme-xname" }, m.title || m.content?.slice(0, 40))
+                              );
+                            })
+                          )
+                      )
+                  )
+            )),
+            // 右卡：详情
+            h("div", { className: "mneme-card mneme-card--detail" },
               selected
                 ? h(react.Fragment, { key: selected.id },
                     h("div", { className: "mneme-xdinner" },
@@ -1535,50 +1680,6 @@ window.__ModuleLoader__.load({
                     )
                   )
                 : h("div", { className: "mneme-xempty" }, t("memory.explorer.emptyDetail"))
-            ),
-            h("div", { className: "mneme-xtree" },
-              h("div", { className: "mneme-xcolhead" }, t("memory.explorer.timeline")),
-              loading
-                ? h("div", { className: "mneme-xempty" }, "…")
-                : months.length === 0
-                  ? h("div", { className: "mneme-xempty" }, t("memory.explorer.empty"))
-                  : months.map((month) =>
-                      h("div", { key: month.key },
-                        h("button", {
-                          className: "mneme-xmonth",
-                          "aria-expanded": String(!collapsed[month.key]),
-                          onClick: () => setCollapsed((c) => ({ ...c, [month.key]: !c[month.key] }))
-                        },
-                          h("span", { className: "mneme-xcaret" }, collapsed[month.key] ? "▸" : "▾"),
-                          month.label
-                        ),
-                        !collapsed[month.key] && month.days.map((day) =>
-                          h("div", { key: day.key },
-                            h("button", {
-                              className: "mneme-xday",
-                              "aria-expanded": String(!collapsed[day.key]),
-                              onClick: () => setCollapsed((c) => ({ ...c, [day.key]: !c[day.key] }))
-                            },
-                              h("span", { className: "mneme-xcaret" }, collapsed[day.key] ? "▸" : "▾"),
-                              day.label
-                            ),
-                            !collapsed[day.key] && day.items.map((m) => {
-                              const d = new Date(m.updated_at || m.created_at || 0);
-                              const time = Number.isNaN(d.getTime())
-                                ? ""
-                                : d.toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit" });
-                              return h("button", {
-                                key: m.id,
-                                ref: (el) => { if (el) itemRefs.current.set(m.id, el); else itemRefs.current.delete(m.id); },
-                                className: m.id === selectedId ? "mneme-xitem mneme-active" : "mneme-xitem",
-                                onClick: () => setSelectedId(m.id)
-                              },
-                                h("span", { className: "mneme-xtime" }, time),
-                                h("span", { className: "mneme-xname" }, m.title || m.content?.slice(0, 40))
-                              );
-                            })
-                          ))
-                      ))
             )
           )
         ),

package/lib/dream/tag-extractor.js

@@ -78,8 +78,12 @@ export async function runAutoTag({ ctx, service, config, route }) {
     ? config.autoTagMaxPerRun
     : 10;
   // Retained = post-consolidation active memories, newest first, capped.
+  // Skip memories that already carry live tags — otherwise every run re-picks
+  // the same "newest" batch (tagging doesn't bump updated_at) and older
+  // memories starve; manual tags are also left untouched this way.
   const memories = service.all()
     .filter((m) => !m.forgotten && !m.archived && !m.session_disposed_at && m.type !== "summary")
+    .filter((m) => (service.getMemoryTags?.(m.id) ?? []).length === 0)
     .sort((a, b) => {
       const ta = String(a.updated_at ?? "");
       const tb = String(b.updated_at ?? "");
@@ -137,7 +141,10 @@ export async function runAutoTag({ ctx, service, config, route }) {
   try {
     service.transaction(() => {
       for (const { id, tags } of toWrite) {
-        service.applyMemoryTags(id, tags);
+        // Merge with existing live tags (never clobber manual tags that landed
+        // between selection and write).
+        const existing = service.getMemoryTags?.(id) ?? [];
+        service.applyMemoryTags(id, [...new Set([...existing, ...tags])]);
         tagged++;
       }
     });

package/lib/service.js

@@ -373,7 +373,9 @@ export function createService({ store, mirror, config, onWrite, logger }) {
           .sort((a, b) => b.score - a.score)
       : hits.map((m) => ({ ...m, source: "tag" }));
     const result = hits.slice(0, topK);
-    touchRecalled(result);
+    // Only count toward recall stats/forgetting when the caller asked for
+    // recording — the panel's `tag:` search must not pollute the curve.
+    if (options.recordRecall) touchRecalled(result);
     return result;
   }
 

package/lib/settings.js

@@ -137,6 +137,36 @@ export function createSettings(db) {
       };
       setSetting("vector", JSON.stringify(cfg));
       return cfg;
+    },
+    /** Tagging switches (autoTag opt-in LLM pass + manual tag editing gate). */
+    getAutoTagConfig() {
+      const raw = getSetting("autoTag");
+      let stored = {};
+      if (raw) {
+        try {
+          const j = JSON.parse(raw);
+          if (j && typeof j === "object") stored = j;
+        } catch { /* fall through to defaults */ }
+      }
+      return {
+        autoTagEnabled: stored.autoTagEnabled === true,
+        manualTagEnabled: stored.manualTagEnabled === true
+      };
+    },
+    setAutoTagConfig(partial) {
+      const cur = (() => {
+        const raw = getSetting("autoTag");
+        try {
+          const j = JSON.parse(raw);
+          return j && typeof j === "object" ? j : {};
+        } catch { return {}; }
+      })();
+      const cfg = {
+        autoTagEnabled: partial.autoTagEnabled === undefined ? cur.autoTagEnabled === true : partial.autoTagEnabled === true,
+        manualTagEnabled: partial.manualTagEnabled === undefined ? cur.manualTagEnabled === true : partial.manualTagEnabled === true
+      };
+      setSetting("autoTag", JSON.stringify(cfg));
+      return cfg;
     }
   };
 }

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.6.5",
+  "version": "0.6.7",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -57,12 +57,14 @@
     "@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",
+    "c8": "^12.0.0"
   },
   "scripts": {
     "sync": "node scripts/sync-lib.js",
     "prepack": "npm run sync",
     "test": "node --test test/*.test.js",
+    "test:coverage": "c8 node --test test/*.test.js",
     "e2e": "node scripts/e2e-dsh.js",
     "stress": "node scripts/stress-dsh.js"
   },
@@ -71,5 +73,8 @@
   },
   "overrides": {
     "adm-zip": "0.6.0"
+  },
+  "c8": {
+    "reporter": ["text", "lcov"]
   }
 }

package/src/api.js

@@ -218,6 +218,96 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
     }
   });
 
+  // --- app config read/write (partial: pass only the fields to change) ---
+  register({
+    kind: "exact",
+    path: "/api/dsh-mneme/config",
+    handler: async (req, res) => {
+      try {
+        if (!requireAuth(req, res, apiToken)) return;
+        if (req.method === "PUT" || req.method === "POST") {
+          const body = parseBody(await readBody(req));
+          const patch = {};
+          const setIfBoolean = (key) => {
+            if (Object.prototype.hasOwnProperty.call(body, key)) {
+              if (typeof body[key] !== "boolean") {
+                sendJson(res, 400, { error: `${key} must be a boolean` });
+                return false;
+              }
+              patch[key] = body[key];
+            }
+            return true;
+          };
+          if (!setIfBoolean("autoTagEnabled") || !setIfBoolean("manualTagEnabled")) return;
+          if (Object.keys(patch).length === 0) {
+            sendJson(res, 400, { error: "no valid config field provided" });
+            return;
+          }
+          const config = settings.setAutoTagConfig(patch);
+          sendJson(res, 200, { config });
+          return;
+        }
+        sendJson(res, 200, { config: settings.getAutoTagConfig() });
+      } catch {
+        sendJson(res, 500, { error: "internal" });
+      }
+    }
+  });
+
+  // --- delete a memory by exact id or best query match (mirrors memory_delete tool) ---
+  register({
+    kind: "exact",
+    path: "/api/dsh-mneme/memories",
+    handler: async (req, res) => {
+      try {
+        if (!requireAuth(req, res, apiToken)) return;
+        if (req.method !== "DELETE") {
+          sendJson(res, 405, { error: "method not allowed" });
+          return;
+        }
+        const body = parseBody(await readBody(req));
+        const hasId = Object.prototype.hasOwnProperty.call(body, "id");
+        const hasQuery = Object.prototype.hasOwnProperty.call(body, "query");
+        if ((hasId && hasQuery) || (!hasId && !hasQuery)) {
+          sendJson(res, 400, { error: "provide exactly one of id or query" });
+          return;
+        }
+        if (hasId) {
+          if (typeof body.id !== "string" || !body.id.trim()) {
+            sendJson(res, 400, { error: "invalid id" });
+            return;
+          }
+          const mem = service.getById(body.id);
+          if (!mem) {
+            sendJson(res, 200, { deleted: false });
+            return;
+          }
+          service.remove(body.id);
+          sendJson(res, 200, { deleted: true, id: body.id });
+          return;
+        }
+        if (typeof body.query !== "string" || !body.query.trim()) {
+          sendJson(res, 400, { error: "invalid query" });
+          return;
+        }
+        const results = await service.searchMemories(body.query, { mode: "auto", topK: 1, useRerank: true });
+        if (!Array.isArray(results) || results.length === 0) {
+          sendJson(res, 200, { deleted: false });
+          return;
+        }
+        const mem = results[0];
+        if (!mem || !mem.id) {
+          sendJson(res, 200, { deleted: false });
+          return;
+        }
+        service.remove(mem.id);
+        sendJson(res, 200, { deleted: true, id: mem.id });
+      } catch {
+        sendJson(res, 500, { error: "internal" });
+      }
+    }
+  });
+
   // --- vector re-index (backfill embeddings for rows missing them) ---
   register({
     kind: "exact",

package/src/dream/tag-extractor.js

@@ -78,8 +78,12 @@ export async function runAutoTag({ ctx, service, config, route }) {
     ? config.autoTagMaxPerRun
     : 10;
   // Retained = post-consolidation active memories, newest first, capped.
+  // Skip memories that already carry live tags — otherwise every run re-picks
+  // the same "newest" batch (tagging doesn't bump updated_at) and older
+  // memories starve; manual tags are also left untouched this way.
   const memories = service.all()
     .filter((m) => !m.forgotten && !m.archived && !m.session_disposed_at && m.type !== "summary")
+    .filter((m) => (service.getMemoryTags?.(m.id) ?? []).length === 0)
     .sort((a, b) => {
       const ta = String(a.updated_at ?? "");
       const tb = String(b.updated_at ?? "");
@@ -137,7 +141,10 @@ export async function runAutoTag({ ctx, service, config, route }) {
   try {
     service.transaction(() => {
       for (const { id, tags } of toWrite) {
-        service.applyMemoryTags(id, tags);
+        // Merge with existing live tags (never clobber manual tags that landed
+        // between selection and write).
+        const existing = service.getMemoryTags?.(id) ?? [];
+        service.applyMemoryTags(id, [...new Set([...existing, ...tags])]);
         tagged++;
       }
     });

package/src/service.js

@@ -373,7 +373,9 @@ export function createService({ store, mirror, config, onWrite, logger }) {
           .sort((a, b) => b.score - a.score)
       : hits.map((m) => ({ ...m, source: "tag" }));
     const result = hits.slice(0, topK);
-    touchRecalled(result);
+    // Only count toward recall stats/forgetting when the caller asked for
+    // recording — the panel's `tag:` search must not pollute the curve.
+    if (options.recordRecall) touchRecalled(result);
     return result;
   }
 

package/src/settings.js

@@ -137,6 +137,36 @@ export function createSettings(db) {
       };
       setSetting("vector", JSON.stringify(cfg));
       return cfg;
+    },
+    /** Tagging switches (autoTag opt-in LLM pass + manual tag editing gate). */
+    getAutoTagConfig() {
+      const raw = getSetting("autoTag");
+      let stored = {};
+      if (raw) {
+        try {
+          const j = JSON.parse(raw);
+          if (j && typeof j === "object") stored = j;
+        } catch { /* fall through to defaults */ }
+      }
+      return {
+        autoTagEnabled: stored.autoTagEnabled === true,
+        manualTagEnabled: stored.manualTagEnabled === true
+      };
+    },
+    setAutoTagConfig(partial) {
+      const cur = (() => {
+        const raw = getSetting("autoTag");
+        try {
+          const j = JSON.parse(raw);
+          return j && typeof j === "object" ? j : {};
+        } catch { return {}; }
+      })();
+      const cfg = {
+        autoTagEnabled: partial.autoTagEnabled === undefined ? cur.autoTagEnabled === true : partial.autoTagEnabled === true,
+        manualTagEnabled: partial.manualTagEnabled === undefined ? cur.manualTagEnabled === true : partial.manualTagEnabled === true
+      };
+      setSetting("autoTag", JSON.stringify(cfg));
+      return cfg;
     }
   };
 }

package/test/api.test.js

@@ -547,3 +547,48 @@ test("GET /api/dsh-mneme/directory reports untagged memories", async () => {
   const data = JSON.parse(res.body);
   assert.deepEqual(data.untagged.map((m) => m.id), [bare.id]);
 });
+
+test("GET/PUT /api/dsh-mneme/config round-trips autoTag switches", async () => {
+  const { routes } = setup();
+  const route = routes.find((r) => r.path === "/api/dsh-mneme/config");
+  const res1 = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/config"), res1);
+  assert.equal(res1.statusCode, 200);
+  assert.deepEqual(JSON.parse(res1.body).config, { autoTagEnabled: false, manualTagEnabled: false });
+  const res2 = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/config", "PUT", { autoTagEnabled: true, manualTagEnabled: false }), res2);
+  assert.equal(res2.statusCode, 200);
+  assert.deepEqual(JSON.parse(res2.body).config, { autoTagEnabled: true, manualTagEnabled: false });
+});
+
+test("DELETE /api/dsh-mneme/memories removes by id and reports misses", async () => {
+  const { routes, service } = setup();
+  service.saveWithDedupe({ type: "preference", title: "语言", content: "中文" });
+  const target = service.list().find((m) => m.title === "语言");
+  const id = target.id;
+  const route = routes.find((r) => r.path === "/api/dsh-mneme/memories");
+  const res = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/memories", "DELETE", { id }), res);
+  assert.equal(res.statusCode, 200);
+  assert.equal(JSON.parse(res.body).deleted, true);
+  const res2 = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/memories", "DELETE", { id }), res2);
+  assert.equal(JSON.parse(res2.body).deleted, false);
+});
+
+test("DELETE /api/dsh-mneme/memories rejects id+query together", async () => {
+  const { routes } = setup();
+  const route = routes.find((r) => r.path === "/api/dsh-mneme/memories");
+  const res = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/memories", "DELETE", { id: "x", query: "y" }), res);
+  assert.equal(res.statusCode, 400);
+});
+
+test("PUT /api/dsh-mneme/config supports partial update", async () => {
+  const { routes } = setup();
+  const route = routes.find((r) => r.path === "/api/dsh-mneme/config");
+  const res = new FakeRes();
+  await route.handler(req("/api/dsh-mneme/config", "PUT", { autoTagEnabled: true }), res);
+  assert.equal(res.statusCode, 200);
+  assert.deepEqual(JSON.parse(res.body).config, { autoTagEnabled: true, manualTagEnabled: false });
+});

package/test/settings.test.js

@@ -99,3 +99,20 @@ test("vector config disabled value is stored as false", () => {
   assert.equal(settings.getVectorConfig().enabled, false);
   store.close();
 });
+
+test("autoTag config defaults to disabled and round-trips", () => {
+  const { store, settings } = setup();
+  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: false, manualTagEnabled: false });
+  settings.setAutoTagConfig({ autoTagEnabled: true, manualTagEnabled: true });
+  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: true, manualTagEnabled: true });
+  settings.setAutoTagConfig({ autoTagEnabled: false });
+  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: false, manualTagEnabled: true });
+  store.close();
+});
+
+test("autoTag config coerces non-boolean to false", () => {
+  const { store, settings } = setup();
+  settings.setAutoTagConfig({ autoTagEnabled: "yes", manualTagEnabled: 1 });
+  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: false, manualTagEnabled: false });
+  store.close();
+});

package/test/tag.test.js

@@ -186,6 +186,24 @@ test("runAutoTag writes validated tags into entity_attrs", async () => {
   store.close();
 });
 
+test("runAutoTag: skips already-tagged memories, merges into fresh ones", async () => {
+  const { store, service } = makeService();
+  const a = seed(service, "Linux", "内核");
+  const b = seed(service, "考研", "公共管理");
+  store.setMemoryTags(a.id, ["已有"]); // manual tag
+  const text = JSON.stringify([
+    { id: a.id, tags: ["linux"] },
+    { id: b.id, tags: ["考研"] }
+  ]);
+  const ctx = makeCtx([text]);
+  const result = await runAutoTag({ ctx, service, config: { dreamProvider: "d", dreamModel: "m" } });
+  assert.equal(result.ok, true);
+  assert.equal(result.tagged, 1, "only the untagged memory is tagged");
+  assert.deepEqual(store.getMemoryTags(a.id), ["已有"], "manual tags left untouched");
+  assert.deepEqual(store.getMemoryTags(b.id), ["考研"]);
+  store.close();
+});
+
 test("runAutoTag fail-safe: garbage / aborted LLM output never throws and writes nothing", async () => {
   const { store, service } = makeService();
   const a = seed(service, "Alpha", "正文");