@modusensus/dsh-mneme 0.7.0 → 0.7.1

package/README.md

@@ -93,7 +93,7 @@ dsh web
 ## 🗺️ 路线图
 
 ```
-🧬 基因（v0.3.0）→ 🛡️ 审计加固（v0.3.6–0.3.9）→ 💤 睡眠维护（v0.4.0）→ 🕸️ 召回融合与图谱（v0.5.0）→ ✨ 面板增强（v0.6.x）→ 🌡️ 自进化记忆（v0.7.0）
+🧬 基因（v0.3.0）→ 🛡️ 审计加固（v0.3.6–0.3.9）→ 💤 睡眠维护（v0.4.0）→ 🕸️ 召回融合与图谱（v0.5.0）→ ✨ 面板增强（v0.6.x）→ 🌡️ 自进化记忆（v0.7.0）→ 🕸️ 图谱增强（v0.8.0）
 ```
 
 | 版本 | 主题 | 状态 |
@@ -102,8 +102,9 @@ dsh web
 | **v0.4.0** | Sleep Mode：空闲四阶段深度维护 | ✅ |
 | **v0.5.0** | 召回融合与记忆可视化：BM25 + 图谱 + 热记忆 | ✅ |
 | **v0.6.0** | 会话生命周期：删会话 ≠ 删记忆 | ✅ |
-| **v0.7.0** | 自进化记忆（heat 热度）✅ 完成 | ✅ 完成 | heat 幂律衰减 + per-type 半衰期 + sleep 热联合双保护 + updated_at 语义修正 + recall_runs injected 标记 + 90 天清理 + 实体热投影；757 测试全绿 |
-| **v0.7.0+** | 兴趣漂移 + 跨 workspace | 🚧 远期 | 更多 heat 信号 + 跨 workspace 共享 |
+| **v0.7.0** | 自进化记忆：heat 幂律衰减 + sleep 双保护 + 实体热投影 | ✅ |
+| **v0.7.1** | issue #31 修复：tags 桥接 entity_attrs + autoTag 面板开关生效 | ✅ |
+| **v0.8.0** | 图谱增强：兴趣漂移 + 跨 workspace 共享 | 🚧 计划中（9 月末） |
 
 ## 🧪 本地开发
 
@@ -194,7 +195,7 @@ Works out of the box. Enable these as needed:
 ## 🗺️ Roadmap
 
 ```
-🧬 Gene (v0.3.0) → 🛡️ Audit hardening (v0.3.6–0.3.9) → 💤 Sleep maintenance (v0.4.0) → 🕸️ Recall fusion & graph (v0.5.0) → ✨ Panel enhancements (v0.6.x) → 🌡️ Self-evolving memory (v0.7.0)
+🧬 Gene (v0.3.0) → 🛡️ Audit hardening (v0.3.6–0.3.9) → 💤 Sleep maintenance (v0.4.0) → 🕸️ Recall fusion & graph (v0.5.0) → ✨ Panel enhancements (v0.6.x) → 🌡️ Self-evolving memory (v0.7.0) → 🕸️ Graph enhancement (v0.8.0)
 ```
 
 | Version | Theme | Status |
@@ -203,7 +204,9 @@ Works out of the box. Enable these as needed:
 | **v0.4.0** | Sleep Mode: idle 4-phase deep maintenance | ✅ |
 | **v0.5.0** | Recall fusion & visualization: BM25 + graph + hot memory | ✅ |
 | **v0.6.0** | Session lifecycle: delete session ≠ delete memories | ✅ |
-| **v0.7.0+** | Interest drift + cross-workspace | 🚧 Long-term |
+| **v0.7.0** | Self-evolving memory: heat decay + sleep dual-protection + entity heat projection | ✅ |
+| **v0.7.1** | Issue #31 fix: tags bridged to entity_attrs + autoTag panel toggle takes effect | ✅ |
+| **v0.8.0** | Graph enhancement: interest drift + cross-workspace sharing | 🚧 Planned (late Sep) |
 
 ## 🧪 Local Development
 

package/dsh-mneme/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.7.1] - 2026-08-24
+
+### 🐛 修复（issue #31）
+
+- **memory_save / memory_update 的 tags 桥接进 entity_attrs 标签存储**：工具传入的 tags 之前只写 `memories.tags` 列，目录视图（`getDirectory`）/ `tag:` 检索 / tagBoost 从 `entity_attrs`（attr_key='tags' AND valid_until IS NULL）读取，导致看不到；现在 `saveWithDedupe` 创建/合并分支与 `service.update` 在写入后同步调 `store.setMemoryTags(id, tags)`，显式 `tags: []` 会把记忆移回 untagged
+- **`store.setMemoryTags` 反向同步 `memories.tags` 列**：手动/autoTag 打标后，搜索结果与 API 返回的 `memory.tags` 不再和目录漂移
+- **autoTag 面板开关成为运行时真正的消费方**：dream 的 autoTag 判定与 `service.setMemoryTags` 的 manual 门禁改为读取「settings 覆盖合并 plugin config」的有效值；`getAutoTagConfig()` 未存储键返回 `null` 而非 `false`，`setAutoTagConfig` 只持久化用户实际触碰的键（部分更新不再误关另一开关）；`manualTagEnabled` 默认统一为插件配置的 `true`
+- 新增 7 个回归测试，全套 764 通过
+
 ## [0.7.0] - 2026-08-24
 
 ### 🆕 自进化记忆（heat 热度模型）

package/dsh-mneme/README.md

@@ -241,6 +241,7 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
 
 | 版本 | 亮点 |
 |------|------|
+| **v0.7.1** | issue #31 修复：memory_save/memory_update 的 tags 桥接进 entity_attrs 标签存储（目录/`tag:` 检索/tagBoost 立即可见，`tags: []` 清空移回 untagged）+ `store.setMemoryTags` 反向同步 `memories.tags` 列 + autoTag 面板开关成为运行时消费方（settings 覆盖 config）；764 测试全绿 |
 | **v0.7.0** | 自进化记忆（heat 热度模型 + per-type 差异化半衰期 + sleep 热联合双保护）+ updated_at 语义修正（不算访问）+ recall_runs injected 两档标记 + 90 天滚动清理 + 实体热投影（ego-graph node heat → 前端节点大小/明暗）；757 测试全绿 |
 | **v0.6.11** | 社区修复（PR #27，Jstn-1g）：memory 渲染器暴露记忆 ID + 防御性加固（条数/块预算/Unicode 截断/JSONL 注入防护）；issue #14 已关闭；735 测试全绿 |
 | **v0.6.10** | 记忆面板卡片布局品质优化：清理死 CSS + 合并 `.mneme-xmain` 双定义 + 补无障碍（分类按钮 `aria-pressed`、三卡 `role=region`+`aria-label`、搜索框 `aria-label`）；723 测试全绿 |
@@ -285,7 +286,8 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
 | **v0.6.3** | ✅ 完成 | 目录视图 | Tag 文件夹手风琴 + 无标签兜底 + 点击跳详情 + `GET /api/dsh-mneme/directory` 端点 |
 | **v0.6.4** | ✅ 完成 | Tag 加权召回 | query/session tag 交集 boost（×1.15 / ×1.08），`tagBoostEnabled` 默认关 |
 | **v0.7.0** | ✅ 完成 | 自进化记忆 | heat 幂律衰减 + per-type 差异化半衰期（TYPE_DECAY）+ sleep 热联合双保护 + updated_at 语义修正 + recall_runs injected 两档标记 + 90 天清理 + 实体热投影（前端节点大小/明暗）；757 测试全绿 |
-| **v0.7.0+** | 🚀 远期 | 自进化记忆（远期） | 跨 workspace 记忆共享（等 DSH 支持）+ 更多 heat 信号 |
+| **v0.7.1** | ✅ 完成 | issue #31 修复 | memory_save/update tags 桥接 entity_attrs 标签存储 + 列反向同步 + autoTag 面板开关生效（settings 覆盖 config）；764 测试全绿 |
+| **v0.8.0** | 🚧 计划中（9 月末） | 图谱增强 | 兴趣漂移可视化 + 跨 workspace 记忆共享 + 更多 heat 信号 |
 
 > 新能力一律做成**可开关的功能**（配置启用/关闭），默认保守开启、不破坏现有行为。`failure_memories` 表与 autoDream 决策引擎已为后续反思性成长铺好路。
 

package/dsh-mneme/lib/api.js

@@ -243,11 +243,14 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
             sendJson(res, 400, { error: "no valid config field provided" });
             return;
           }
-          const config = settings.setAutoTagConfig(patch);
-          sendJson(res, 200, { config });
+          settings.setAutoTagConfig(patch);
+          // Respond with the effective (settings-over-config merged) toggles
+          // so the panel always sees booleans that actually gate runtime
+          // behaviour (issue #31).
+          sendJson(res, 200, { config: service.getTagConfig() });
           return;
         }
-        sendJson(res, 200, { config: settings.getAutoTagConfig() });
+        sendJson(res, 200, { config: service.getTagConfig() });
       } catch {
         sendJson(res, 500, { error: "internal" });
       }

package/dsh-mneme/lib/dream.js

@@ -559,7 +559,7 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     if (inFlight) await inFlight.catch(() => {});
   }
 
-  async function runDream(ctx, service, config) {
+  async function runDream(ctx, service, config, settings) {
     const logger = ctx.logger;
     let memories = service.all().filter((m) => !m.archived && m.type !== "summary");
     if (memories.length === 0) return { ok: true, applied: 0, skipped: true, summary: false };
@@ -838,7 +838,12 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     // and always fail-safe — a tag failure must never change the consolidation
     // outcome reported below (it is logged and counted, nothing more).
     let autoTagged = 0;
-    if (config.autoTagEnabled === true) {
+    // Effective opt-in (issue #31): the Web panel's settings toggle
+    // (user_settings) overrides the zod plugin config when explicitly stored;
+    // unset → fall back to config.autoTagEnabled. settings is null-safe (absent
+    // in tests / direct calls) so behaviour is unchanged without it.
+    const autoTagEnabled = settings?.getAutoTagConfig?.().autoTagEnabled ?? config.autoTagEnabled;
+    if (autoTagEnabled === true) {
       try {
         const tagResult = await runAutoTag({ ctx, service, config, route });
         autoTagged = tagResult?.tagged ?? 0;

package/dsh-mneme/lib/index.js

@@ -60,7 +60,12 @@ export const apply = (ctx, config) => {
     store.purgeRecallRunsOlderThan(recallRetentionDays);
   } catch { /* non-fatal */ }
   const mirror = createMirror(memoryDir);
-  const service = createService({ store, mirror, config: cfg, logger: ctx.logger });
+  // User-configurable settings (profile, rules) and custom commands share the
+  // same SQLite file but live in dedicated tables, isolated from memories.
+  // Created before the service so the tag-config resolver (issue #31) can merge
+  // the Web panel's persisted toggles over the plugin config at runtime.
+  const settings = createSettings(store.db);
+  const service = createService({ store, mirror, config: cfg, logger: ctx.logger, settings });
 
   // F-NEW-03: if the mirror sync failed last run (persisted dirty state), retry
   // a safe re-render at boot so a stale mirror converges without needing a
@@ -85,10 +90,6 @@ export const apply = (ctx, config) => {
     } catch { /* non-fatal: recall recording is bookkeeping */ }
   });
 
-  // User-configurable settings (profile, rules) and custom commands share the
-  // same SQLite file but live in dedicated tables, isolated from memories.
-  const settings = createSettings(store.db);
-
   // Semantic pipeline: a local/ollama embedder when configured, otherwise the
   // legacy OpenAI-compatible embedder (settings-driven). The vector index wraps
   // the store's embedding column and tracks the active model fingerprint. A
@@ -251,7 +252,7 @@ export const apply = (ctx, config) => {
       delayMs: cfg.dreamDelayMs,
       logger: ctx.logger,
       semantic: { embedder, vectorIndex },
-      onRun: () => (dream ? dream.runDream(ctx, service, cfg) : Promise.resolve({ ok: true, skipped: true }))
+      onRun: () => (dream ? dream.runDream(ctx, service, cfg, settings) : Promise.resolve({ ok: true, skipped: true }))
     });
     service.setDreamHook(() => dream.maybeSchedule(service));
   }

package/dsh-mneme/lib/service.js

@@ -65,7 +65,7 @@ export function computeRetrievalMetrics(actualIds, expectedIds) {
   };
 }
 
-export function createService({ store, mirror, config, onWrite, logger }) {
+export function createService({ store, mirror, config, onWrite, logger, settings }) {
   // Optional dream scheduler hook, installed via setDreamHook after creation
   // (the scheduler holds a reference back to the service, so it cannot be
   // passed in the constructor). Fired on the same write events as onWrite.
@@ -91,6 +91,20 @@ export function createService({ store, mirror, config, onWrite, logger }) {
   let vectorIndex = null;
   let reranker = null;
 
+  // Effective tag toggles (issue #31): the settings layer (Web panel switches,
+  // persisted in user_settings) overrides the plugin config when explicitly
+  // stored; unset keys fall back to the zod config default. This is the single
+  // runtime source of truth for setMemoryTags' manual gate and the Web panel's
+  // getTagConfig display — the panel toggle and the dream autoTag gate were
+  // previously writing/reading two disconnected stores.
+  const tagConfig = () => {
+    const stored = settings?.getAutoTagConfig?.() ?? {};
+    return {
+      autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : (config.autoTagEnabled ?? false),
+      manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : (config.manualTagEnabled ?? true)
+    };
+  };
+
   // Optional recall recorder, installed via setRecallRecorder after creation.
   // When searchMemories is called with recordRecall=true it receives the
   // actual merged recall scene (candidates + scores + source + threshold) so
@@ -933,6 +947,13 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       });
       // Bug7: a degraded/archived result is applied on top of the merged row.
       const result = applyQualityDisposition(merged, quality, qf);
+      // Bridge tool-passed tags (plus any quality signal tags) into the
+      // entity_attrs tag store so directory / tag: recall / tagBoost see them
+      // (issue #31). Must run before afterSync so the mirror re-render reads
+      // the bridged row. Unconditional on the array (empty included): a merge
+      // that clears tags must also invalidate any stale entity_attrs row from
+      // an earlier save, or the directory keeps showing the old tag.
+      if (Array.isArray(result.tags)) store.setMemoryTags(result.id, result.tags);
       afterSync("write");
       notifyWrite();
       scheduleEmbed(result);
@@ -952,6 +973,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       ...(quality ? { quality_score: quality.score } : {})
     });
     const result = applyQualityDisposition(created, quality, qf);
+    // Bridge tool-passed tags (plus any quality signal tags) into the
+    // entity_attrs tag store so directory / tag: recall / tagBoost see them
+    // (issue #31). Must run before afterSync so the mirror re-render reads
+    // the bridged row.
+    if (Array.isArray(result.tags) && result.tags.length) store.setMemoryTags(result.id, result.tags);
     afterSync("write");
     notifyWrite();
     scheduleEmbed(result);
@@ -1598,6 +1624,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     update: (id, p, ctx = {}) => {
       const old = store.getById(id);
       const updated = store.update(id, p);
+      // Bridge tag edits made through update (memory_update tool / panel) into
+      // the entity_attrs tag store too (issue #31) — same convergence as
+      // saveWithDedupe. An explicit empty array clears the live tag row, moving
+      // the memory back to `untagged`.
+      if (p?.tags !== undefined) store.setMemoryTags(updated.id, updated.tags);
       // Record a user correction when any meaningful field changed and the
       // reflection failure tracker is enabled. expected = what it became,
       // actual = what it was before; query (when provided) captures the
@@ -1757,7 +1788,7 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     // tag pass (gated by autoTagEnabled, wrapped in a transaction by the
     // extractor so the mirror re-renders exactly once).
     setMemoryTags: (memoryId, tags) => {
-      if (config.manualTagEnabled === false) {
+      if (tagConfig().manualTagEnabled === false) {
         return { ok: false, error: "manualTagEnabled is off" };
       }
       const stored = store.setMemoryTags(memoryId, tags);
@@ -1768,7 +1799,10 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     getMemoryTags: (memoryId) => store.getMemoryTags(memoryId),
     // Read-only gate flag so the Web panel can hide tag editing when the
     // manual path is disabled (default: manual tagging is on).
-    manualTagEnabled: () => config.manualTagEnabled !== false,
+    manualTagEnabled: () => tagConfig().manualTagEnabled !== false,
+    // Effective tag toggle pair (settings-over-config merge) for the panel
+    // (/api/dsh-mneme/config GET/PUT).
+    getTagConfig: tagConfig,
     applyMemoryTags: (memoryId, tags) => store.setMemoryTags(memoryId, tags),
     saveAttr: (r) => store.saveAttr(r),
     createEntity: (r) => store.createEntity(r),

package/dsh-mneme/lib/settings.js

@@ -148,9 +148,13 @@ export function createSettings(db) {
           if (j && typeof j === "object") stored = j;
         } catch { /* fall through to defaults */ }
       }
+      // null = never explicitly stored → callers fall back to the plugin
+      // config default, so the settings layer can't override a toggle the
+      // user never touched (issue #31). This also unifies the manualTagEnabled
+      // default (settings no longer invents false where plugin config says true).
       return {
-        autoTagEnabled: stored.autoTagEnabled === true,
-        manualTagEnabled: stored.manualTagEnabled === true
+        autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : null,
+        manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : null
       };
     },
     setAutoTagConfig(partial) {
@@ -161,10 +165,15 @@ export function createSettings(db) {
           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
-      };
+      const cfg = {};
+      // Only persist keys the caller explicitly set (or already stored). A
+      // partial update must never invent `false` for a key the user left
+      // alone — that would silently disable manual tagging on a toggle of
+      // autoTag alone (issue #31).
+      if (partial.autoTagEnabled !== undefined) cfg.autoTagEnabled = partial.autoTagEnabled === true;
+      else if (cur.autoTagEnabled !== undefined) cfg.autoTagEnabled = cur.autoTagEnabled === true;
+      if (partial.manualTagEnabled !== undefined) cfg.manualTagEnabled = partial.manualTagEnabled === true;
+      else if (cur.manualTagEnabled !== undefined) cfg.manualTagEnabled = cur.manualTagEnabled === true;
       setSetting("autoTag", JSON.stringify(cfg));
       return cfg;
     }

package/dsh-mneme/lib/store.js

@@ -1743,6 +1743,11 @@ export function createStore(path) {
            VALUES (?, ?, 'tags', ?, ?, ?, NULL, 1.0, 'manual')`
         ).run(id, memoryId, JSON.stringify(arr), memoryId, now);
       }
+      // Keep memories.tags (the display/search column) as a mirror of the
+      // entity_attrs source of truth, so API rows and keyword search never
+      // drift from the directory/tag store (issue #31).
+      db.prepare("UPDATE memories SET tags = ?, updated_at = ? WHERE id = ?")
+        .run(JSON.stringify(arr), now, memoryId);
       db.exec("RELEASE set_memory_tags");
     } catch (e) {
       db.exec("ROLLBACK TO set_memory_tags");

package/dsh-mneme/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@modusensus/dsh-mneme",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@modusensus/dsh-mneme",
-      "version": "0.7.0",
+      "version": "0.7.1",
       "license": "MIT",
       "dependencies": {
         "@huggingface/transformers": "^4.2.0"

package/dsh-mneme/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@modusensus/dsh-mneme",
   "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dsh-mneme/src/api.js

@@ -243,11 +243,14 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
             sendJson(res, 400, { error: "no valid config field provided" });
             return;
           }
-          const config = settings.setAutoTagConfig(patch);
-          sendJson(res, 200, { config });
+          settings.setAutoTagConfig(patch);
+          // Respond with the effective (settings-over-config merged) toggles
+          // so the panel always sees booleans that actually gate runtime
+          // behaviour (issue #31).
+          sendJson(res, 200, { config: service.getTagConfig() });
           return;
         }
-        sendJson(res, 200, { config: settings.getAutoTagConfig() });
+        sendJson(res, 200, { config: service.getTagConfig() });
       } catch {
         sendJson(res, 500, { error: "internal" });
       }

package/dsh-mneme/src/dream.js

@@ -559,7 +559,7 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     if (inFlight) await inFlight.catch(() => {});
   }
 
-  async function runDream(ctx, service, config) {
+  async function runDream(ctx, service, config, settings) {
     const logger = ctx.logger;
     let memories = service.all().filter((m) => !m.archived && m.type !== "summary");
     if (memories.length === 0) return { ok: true, applied: 0, skipped: true, summary: false };
@@ -838,7 +838,12 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     // and always fail-safe — a tag failure must never change the consolidation
     // outcome reported below (it is logged and counted, nothing more).
     let autoTagged = 0;
-    if (config.autoTagEnabled === true) {
+    // Effective opt-in (issue #31): the Web panel's settings toggle
+    // (user_settings) overrides the zod plugin config when explicitly stored;
+    // unset → fall back to config.autoTagEnabled. settings is null-safe (absent
+    // in tests / direct calls) so behaviour is unchanged without it.
+    const autoTagEnabled = settings?.getAutoTagConfig?.().autoTagEnabled ?? config.autoTagEnabled;
+    if (autoTagEnabled === true) {
       try {
         const tagResult = await runAutoTag({ ctx, service, config, route });
         autoTagged = tagResult?.tagged ?? 0;

package/dsh-mneme/src/index.js

@@ -60,7 +60,12 @@ export const apply = (ctx, config) => {
     store.purgeRecallRunsOlderThan(recallRetentionDays);
   } catch { /* non-fatal */ }
   const mirror = createMirror(memoryDir);
-  const service = createService({ store, mirror, config: cfg, logger: ctx.logger });
+  // User-configurable settings (profile, rules) and custom commands share the
+  // same SQLite file but live in dedicated tables, isolated from memories.
+  // Created before the service so the tag-config resolver (issue #31) can merge
+  // the Web panel's persisted toggles over the plugin config at runtime.
+  const settings = createSettings(store.db);
+  const service = createService({ store, mirror, config: cfg, logger: ctx.logger, settings });
 
   // F-NEW-03: if the mirror sync failed last run (persisted dirty state), retry
   // a safe re-render at boot so a stale mirror converges without needing a
@@ -85,10 +90,6 @@ export const apply = (ctx, config) => {
     } catch { /* non-fatal: recall recording is bookkeeping */ }
   });
 
-  // User-configurable settings (profile, rules) and custom commands share the
-  // same SQLite file but live in dedicated tables, isolated from memories.
-  const settings = createSettings(store.db);
-
   // Semantic pipeline: a local/ollama embedder when configured, otherwise the
   // legacy OpenAI-compatible embedder (settings-driven). The vector index wraps
   // the store's embedding column and tracks the active model fingerprint. A
@@ -251,7 +252,7 @@ export const apply = (ctx, config) => {
       delayMs: cfg.dreamDelayMs,
       logger: ctx.logger,
       semantic: { embedder, vectorIndex },
-      onRun: () => (dream ? dream.runDream(ctx, service, cfg) : Promise.resolve({ ok: true, skipped: true }))
+      onRun: () => (dream ? dream.runDream(ctx, service, cfg, settings) : Promise.resolve({ ok: true, skipped: true }))
     });
     service.setDreamHook(() => dream.maybeSchedule(service));
   }

package/dsh-mneme/src/service.js

@@ -65,7 +65,7 @@ export function computeRetrievalMetrics(actualIds, expectedIds) {
   };
 }
 
-export function createService({ store, mirror, config, onWrite, logger }) {
+export function createService({ store, mirror, config, onWrite, logger, settings }) {
   // Optional dream scheduler hook, installed via setDreamHook after creation
   // (the scheduler holds a reference back to the service, so it cannot be
   // passed in the constructor). Fired on the same write events as onWrite.
@@ -91,6 +91,20 @@ export function createService({ store, mirror, config, onWrite, logger }) {
   let vectorIndex = null;
   let reranker = null;
 
+  // Effective tag toggles (issue #31): the settings layer (Web panel switches,
+  // persisted in user_settings) overrides the plugin config when explicitly
+  // stored; unset keys fall back to the zod config default. This is the single
+  // runtime source of truth for setMemoryTags' manual gate and the Web panel's
+  // getTagConfig display — the panel toggle and the dream autoTag gate were
+  // previously writing/reading two disconnected stores.
+  const tagConfig = () => {
+    const stored = settings?.getAutoTagConfig?.() ?? {};
+    return {
+      autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : (config.autoTagEnabled ?? false),
+      manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : (config.manualTagEnabled ?? true)
+    };
+  };
+
   // Optional recall recorder, installed via setRecallRecorder after creation.
   // When searchMemories is called with recordRecall=true it receives the
   // actual merged recall scene (candidates + scores + source + threshold) so
@@ -933,6 +947,13 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       });
       // Bug7: a degraded/archived result is applied on top of the merged row.
       const result = applyQualityDisposition(merged, quality, qf);
+      // Bridge tool-passed tags (plus any quality signal tags) into the
+      // entity_attrs tag store so directory / tag: recall / tagBoost see them
+      // (issue #31). Must run before afterSync so the mirror re-render reads
+      // the bridged row. Unconditional on the array (empty included): a merge
+      // that clears tags must also invalidate any stale entity_attrs row from
+      // an earlier save, or the directory keeps showing the old tag.
+      if (Array.isArray(result.tags)) store.setMemoryTags(result.id, result.tags);
       afterSync("write");
       notifyWrite();
       scheduleEmbed(result);
@@ -952,6 +973,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       ...(quality ? { quality_score: quality.score } : {})
     });
     const result = applyQualityDisposition(created, quality, qf);
+    // Bridge tool-passed tags (plus any quality signal tags) into the
+    // entity_attrs tag store so directory / tag: recall / tagBoost see them
+    // (issue #31). Must run before afterSync so the mirror re-render reads
+    // the bridged row.
+    if (Array.isArray(result.tags) && result.tags.length) store.setMemoryTags(result.id, result.tags);
     afterSync("write");
     notifyWrite();
     scheduleEmbed(result);
@@ -1598,6 +1624,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     update: (id, p, ctx = {}) => {
       const old = store.getById(id);
       const updated = store.update(id, p);
+      // Bridge tag edits made through update (memory_update tool / panel) into
+      // the entity_attrs tag store too (issue #31) — same convergence as
+      // saveWithDedupe. An explicit empty array clears the live tag row, moving
+      // the memory back to `untagged`.
+      if (p?.tags !== undefined) store.setMemoryTags(updated.id, updated.tags);
       // Record a user correction when any meaningful field changed and the
       // reflection failure tracker is enabled. expected = what it became,
       // actual = what it was before; query (when provided) captures the
@@ -1757,7 +1788,7 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     // tag pass (gated by autoTagEnabled, wrapped in a transaction by the
     // extractor so the mirror re-renders exactly once).
     setMemoryTags: (memoryId, tags) => {
-      if (config.manualTagEnabled === false) {
+      if (tagConfig().manualTagEnabled === false) {
         return { ok: false, error: "manualTagEnabled is off" };
       }
       const stored = store.setMemoryTags(memoryId, tags);
@@ -1768,7 +1799,10 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     getMemoryTags: (memoryId) => store.getMemoryTags(memoryId),
     // Read-only gate flag so the Web panel can hide tag editing when the
     // manual path is disabled (default: manual tagging is on).
-    manualTagEnabled: () => config.manualTagEnabled !== false,
+    manualTagEnabled: () => tagConfig().manualTagEnabled !== false,
+    // Effective tag toggle pair (settings-over-config merge) for the panel
+    // (/api/dsh-mneme/config GET/PUT).
+    getTagConfig: tagConfig,
     applyMemoryTags: (memoryId, tags) => store.setMemoryTags(memoryId, tags),
     saveAttr: (r) => store.saveAttr(r),
     createEntity: (r) => store.createEntity(r),

package/dsh-mneme/src/settings.js

@@ -148,9 +148,13 @@ export function createSettings(db) {
           if (j && typeof j === "object") stored = j;
         } catch { /* fall through to defaults */ }
       }
+      // null = never explicitly stored → callers fall back to the plugin
+      // config default, so the settings layer can't override a toggle the
+      // user never touched (issue #31). This also unifies the manualTagEnabled
+      // default (settings no longer invents false where plugin config says true).
       return {
-        autoTagEnabled: stored.autoTagEnabled === true,
-        manualTagEnabled: stored.manualTagEnabled === true
+        autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : null,
+        manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : null
       };
     },
     setAutoTagConfig(partial) {
@@ -161,10 +165,15 @@ export function createSettings(db) {
           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
-      };
+      const cfg = {};
+      // Only persist keys the caller explicitly set (or already stored). A
+      // partial update must never invent `false` for a key the user left
+      // alone — that would silently disable manual tagging on a toggle of
+      // autoTag alone (issue #31).
+      if (partial.autoTagEnabled !== undefined) cfg.autoTagEnabled = partial.autoTagEnabled === true;
+      else if (cur.autoTagEnabled !== undefined) cfg.autoTagEnabled = cur.autoTagEnabled === true;
+      if (partial.manualTagEnabled !== undefined) cfg.manualTagEnabled = partial.manualTagEnabled === true;
+      else if (cur.manualTagEnabled !== undefined) cfg.manualTagEnabled = cur.manualTagEnabled === true;
       setSetting("autoTag", JSON.stringify(cfg));
       return cfg;
     }

package/dsh-mneme/src/store.js

@@ -1743,6 +1743,11 @@ export function createStore(path) {
            VALUES (?, ?, 'tags', ?, ?, ?, NULL, 1.0, 'manual')`
         ).run(id, memoryId, JSON.stringify(arr), memoryId, now);
       }
+      // Keep memories.tags (the display/search column) as a mirror of the
+      // entity_attrs source of truth, so API rows and keyword search never
+      // drift from the directory/tag store (issue #31).
+      db.prepare("UPDATE memories SET tags = ?, updated_at = ? WHERE id = ?")
+        .run(JSON.stringify(arr), now, memoryId);
       db.exec("RELEASE set_memory_tags");
     } catch (e) {
       db.exec("ROLLBACK TO set_memory_tags");

package/dsh-mneme/test/api.test.js

@@ -29,8 +29,10 @@ function req(path, method = "GET", body = null) {
 
 function setup(embedder, apiToken = "") {
   const store = createStore(":memory:");
-  const service = createService({ store, mirror: null, config: {} });
   const settings = createSettings(store.db);
+  // settings is threaded into the service so the /config endpoint reports the
+  // effective settings-over-config tag toggles (issue #31).
+  const service = createService({ store, mirror: null, config: {}, settings });
   const commands = {
     add: (def) => settings.addCommand(def),
     remove: (id) => settings.removeCommand(id),
@@ -554,7 +556,9 @@ test("GET/PUT /api/dsh-mneme/config round-trips autoTag switches", async () => {
   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 });
+  // unset → effective config falls back to plugin-config defaults:
+  // autoTagEnabled=false, manualTagEnabled=true (issue #31 default unification)
+  assert.deepEqual(JSON.parse(res1.body).config, { autoTagEnabled: false, manualTagEnabled: true });
   const res2 = new FakeRes();
   await route.handler(req("/api/dsh-mneme/config", "PUT", { autoTagEnabled: true, manualTagEnabled: false }), res2);
   assert.equal(res2.statusCode, 200);
@@ -590,5 +594,8 @@ test("PUT /api/dsh-mneme/config supports partial update", async () => {
   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 });
+  // Partial PUT only stores autoTagEnabled; manualTagEnabled stays unset and
+  // falls back to the plugin-config default (true) — a lone autoTag toggle must
+  // never silently disable manual tagging (issue #31).
+  assert.deepEqual(JSON.parse(res.body).config, { autoTagEnabled: true, manualTagEnabled: true });
 });

package/dsh-mneme/test/settings.test.js

@@ -100,11 +100,15 @@ test("vector config disabled value is stored as false", () => {
   store.close();
 });
 
-test("autoTag config defaults to disabled and round-trips", () => {
+test("autoTag config defaults to null (unset) and round-trips only explicit keys", () => {
   const { store, settings } = setup();
-  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: false, manualTagEnabled: false });
+  // Issue #31: an unset key is null so runtime consumers fall back to the
+  // plugin config default — the settings layer must not invent `false`.
+  assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: null, manualTagEnabled: null });
   settings.setAutoTagConfig({ autoTagEnabled: true, manualTagEnabled: true });
   assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: true, manualTagEnabled: true });
+  // A partial update only touches the key it was given: manualTagEnabled was
+  // stored earlier so it keeps its value (true), it does not revert to null.
   settings.setAutoTagConfig({ autoTagEnabled: false });
   assert.deepEqual(settings.getAutoTagConfig(), { autoTagEnabled: false, manualTagEnabled: true });
   store.close();

package/dsh-mneme/test/tag.test.js

@@ -12,6 +12,7 @@ import { join } from "node:path";
 import { createStore } from "../src/store.js";
 import { createService } from "../src/service.js";
 import { createMirror } from "../src/mirror.js";
+import { createSettings } from "../src/settings.js";
 import { parseTags, sanitizeTags, MAX_TAG_LENGTH } from "../src/parser/tag.js";
 import { runAutoTag } from "../src/dream/tag-extractor.js";
 import { createDreamScheduler } from "../src/dream.js";
@@ -310,3 +311,116 @@ test("service.setMemoryTags respects manualTagEnabled=false gate", () => {
   assert.equal(r.ok, false);
   assert.match(r.error, /manualTagEnabled/);
 });
+
+// ============================================================ issue #31 fixes
+
+test("memory_save with tags bridges into the entity_attrs tag store (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({
+    type: "project", title: "桥接", content: "c", tags: ["linux", "考研"]
+  });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["linux", "考研"], "tool-passed tags land in entity_attrs");
+  assert.deepEqual(store.getMemoryTagsMap([memory.id]).get(memory.id), ["linux", "考研"], "tag map sees them");
+  const dir = store.getDirectory();
+  assert.deepEqual(dir.groups.map((g) => g.tag).sort(), ["linux", "考研"], "directory groups by tool-passed tags");
+  assert.equal(dir.untagged.length, 0, "not dumped in the untagged bucket");
+  assert.ok(store.findMemoriesByTags(["linux"]).some((m) => m.id === memory.id), "tag: recall finds it");
+  store.close();
+});
+
+test("saveWithDedupe merge with tags bridges into the tag store too (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({
+    type: "project", title: "同题", content: "第一段", tags: ["linux"]
+  });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["linux"]);
+  const { action, memory: merged } = service.saveWithDedupe({
+    type: "project", title: "同题", content: "第二段", tags: ["bash"]
+  });
+  assert.equal(action, "merged");
+  assert.deepEqual(store.getMemoryTags(merged.id), ["bash"], "merge overwrites tags and bridges them");
+  store.close();
+});
+
+test("saveWithDedupe merge with empty tags clears stale entity_attrs tags (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "清空", content: "第一段", tags: ["old"] });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["old"]);
+  const { action, memory: merged } = service.saveWithDedupe({
+    type: "project", title: "清空", content: "第二段", tags: []
+  });
+  assert.equal(action, "merged");
+  assert.deepEqual(store.getMemoryTags(merged.id), [], "empty tags on merge invalidate the stale live row");
+  const dir = store.getDirectory();
+  assert.equal(dir.groups.length, 0, "directory no longer shows the stale tag");
+  assert.equal(dir.untagged.length, 1, "memory back to untagged");
+  store.close();
+});
+
+test("memory_update (service.update) with tags bridges and clearing moves to untagged (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "更新", content: "c", tags: ["old"] });
+  const updated = service.update(memory.id, { tags: ["new", "考研"] });
+  assert.deepEqual(store.getMemoryTags(updated.id), ["new", "考研"], "update bridges new tags");
+  assert.ok(store.getDirectory().groups.some((g) => g.tag === "new"), "directory reflects update tags");
+  service.update(updated.id, { tags: [] });
+  assert.deepEqual(store.getMemoryTags(updated.id), [], "clearing removes the live row");
+  const dir = store.getDirectory();
+  assert.equal(dir.groups.length, 0, "no tag groups after clearing");
+  assert.equal(dir.untagged.length, 1, "memory back to untagged");
+  store.close();
+});
+
+test("setMemoryTags keeps the memories.tags column in sync with entity_attrs (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "列同步", content: "c" });
+  service.setMemoryTags(memory.id, ["linux"]);
+  assert.deepEqual(store.getById(memory.id).tags, ["linux"], "column mirrors the live tag row");
+  service.setMemoryTags(memory.id, []);
+  assert.deepEqual(store.getById(memory.id).tags, [], "clearing also clears the column");
+  store.close();
+});
+
+test("runDream auto-tag respects the settings toggle over plugin config (issue #31)", async () => {
+  const store = createStore(":memory:");
+  const settings = createSettings(store.db);
+  settings.setAutoTagConfig({ autoTagEnabled: true });
+  // plugin config says auto-tagging is OFF; the settings toggle flips it on.
+  const service = createService({ store, mirror: null, config: { autoTagEnabled: false }, settings });
+  const a = service.saveWithDedupe({ type: "preference", title: "旧1", content: "第一段" }).memory;
+  const b = service.saveWithDedupe({ type: "preference", title: "旧2", content: "第二段" }).memory;
+  const keep = (id) => JSON.stringify([{ action: "keep", ids: [id] }]);
+  let calls = 0;
+  const ctx = {
+    llm: {
+      stream: async function* () {
+        calls++;
+        if (calls === 1) yield { type: "text-delta", text: keep(a.id) }; // consolidation
+        else if (calls === 2) yield { type: "text-delta", text: JSON.stringify([{ id: a.id, tags: ["内核"] }]) }; // auto-tag
+        else yield { type: "text-delta", text: "总览" }; // summary
+        yield { type: "finish", reason: { kind: "ok" } };
+      }
+    },
+    logger: { warn: () => {}, info: () => {} }
+  };
+  const dream = createDreamScheduler({ thresholdCount: 1, thresholdChars: 0, delayMs: 0 });
+  const result = await dream.runDream(ctx, service, {
+    dreamProvider: "deepseek", dreamModel: "deepseek-chat", autoTagEnabled: false
+  }, settings);
+  assert.equal(result.ok, true);
+  assert.deepEqual(store.getMemoryTags(a.id), ["内核"], "settings toggle enabled auto-tag despite config.autoTagEnabled=false");
+  store.close();
+});
+
+test("service.setMemoryTags manual gate follows the settings toggle (issue #31)", () => {
+  const store = createStore(":memory:");
+  const settings = createSettings(store.db);
+  settings.setAutoTagConfig({ manualTagEnabled: false });
+  const service = createService({ store, mirror: null, config: {}, settings });
+  const a = service.saveWithDedupe({ type: "preference", title: "Alpha", content: "正文" }).memory;
+  const r = service.setMemoryTags(a.id, ["linux"]);
+  assert.equal(r.ok, false, "settings gate blocks manual tagging");
+  assert.match(r.error, /manualTagEnabled/);
+  assert.equal(service.manualTagEnabled(), false, "gate flag reflects the settings override");
+  store.close();
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modusensus/dsh-mneme",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Structured memory engine for DeepSeek Harness. Offline semantic search, entity-attribute-timeline, autoDream self-consolidation, and human-editable Markdown storage.",
   "license": "MIT",
   "repository": {