@modusensus/dsh-mneme 0.2.4 → 0.2.5

package/scripts/e2e-dsh.js

@@ -0,0 +1,216 @@
+// scripts/e2e-dsh.js
+// 端到端演示：用 cordis 搭建最小 DSH 环境，真实装载 dsh-mneme 插件，
+// 走一遍完整用户流程（工具注册 → 保存/搜索记忆 → 上下文注入 → 会话摘要 → autoDream）。
+//
+// 运行：node scripts/e2e-dsh.js
+import { Context } from "@deepseek-ai/cordis";
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import * as mneme from "../lib/index.js";
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+// ---------------------------------------------------------------- 环境
+const memDir = mkdtempSync(join(tmpdir(), "dsh-mneme-e2e-"));
+const ctx = new Context();
+
+// 插件声明的 5 个依赖服务（tools / systemPrompt / webServer / llm / agentDefaultModel）
+const registeredTools = [];
+const injectContexts = [];
+const apiRoutes = [];
+const registeredCommands = new Map();
+let llmCalls = [];
+
+ctx.provide("tools", {
+  register(def) { registeredTools.push(def); return () => {}; }
+});
+ctx.provide("commands", {
+  register(def) { registeredCommands.set(def.name, def); return () => registeredCommands.delete(def.name); }
+});
+ctx.provide("systemPrompt", {
+  context(def) { injectContexts.push(def); return () => {}; }
+});
+ctx.provide("webServer", {
+  register(route) { apiRoutes.push(route); return () => {}; }
+});
+ctx.provide("agentDefaultModel", {
+  currentSelection() { return { provider: "mock", model: "mock-model" }; }
+});
+
+// LLM mock：按 purpose / 消息内容返回合理结果（模拟真实 LLM 的巩固行为）
+ctx.provide("llm", {
+  async *stream(options) {
+    llmCalls.push(options.purpose);
+    const userText = options.messages.find((m) => m.role === "user")?.content?.[0]?.text ?? "";
+    let text = "";
+    if (options.purpose === "summarization") {
+      text = JSON.stringify([
+        { type: "preference", title: "语言偏好", content: "用户偏好使用中文交流", importance: 4 }
+      ]);
+    } else if (options.purpose === "compaction" && userText.includes("id=")) {
+      // 从传入的记忆清单解析 id 与类型，动态构造有效决策：优先演示 merge，其余 keep
+      const entries = [...userText.matchAll(/id=([^\s|]+).*?type=(\w+)/g)].map((m) => ({ id: m[1], type: m[2] }));
+      const byType = {};
+      for (const e of entries) (byType[e.type] ??= []).push(e.id);
+      const decisions = [];
+      const claimed = new Set();
+      const mergeType = Object.keys(byType).find((t) => byType[t].length >= 2);
+      if (mergeType) {
+        const ids = byType[mergeType];
+        decisions.push({
+          action: "merge", ids, keepSource: ids[0],
+          title: "合并条目", content: "两条主题相近的记忆合并后的精炼摘要", importance: 4
+        });
+        ids.forEach((id) => claimed.add(id));
+      }
+      for (const e of entries) {
+        if (!claimed.has(e.id)) decisions.push({ action: "keep", ids: [e.id] });
+      }
+      text = JSON.stringify(decisions);
+    } else if (options.purpose === "compaction") {
+      text = "记忆库总览：用户偏好中文交流；工作偏好（上午深度工作）；项目采用 SQLite 存储。";
+    }
+    yield { type: "block-start", index: 0, blockType: "text" };
+    yield { type: "text-delta", index: 0, text };
+    yield { type: "block-end", index: 0, block: { type: "text" } };
+    yield { type: "finish", reason: { kind: "stop" } };
+  }
+});
+
+// ---------------------------------------------------------------- 装载
+const fiber = ctx.plugin(
+  { name: mneme.name, inject: mneme.inject, Config: mneme.Config, apply: mneme.apply },
+  {
+    memoryDir: memDir,
+    autoInject: true,
+    autoSummarize: true,
+    maxInjectedItems: 5,
+    importanceThreshold: 3,
+    autoDream: true,
+    dreamThresholdCount: 3,
+    dreamThresholdChars: 100,
+    dreamDelayMs: 80
+  }
+);
+await fiber;
+
+// ---------------------------------------------------------------- 工具
+const tool = (name) => registeredTools.find((t) => t.name === name);
+
+console.log("══════ dsh-mneme 端到端演示 ══════");
+console.log(`记忆目录：${memDir}\n`);
+
+// 1. 装载检查
+console.log("【1】插件装载");
+const checks = [];
+checks.push(["注册 6 个模型工具", registeredTools.length === 6]);
+checks.push(["注册 2 个注入上下文", injectContexts.length === 2 && injectContexts[0].name === "memory"]);
+checks.push(["注册 9 条 API 路由", apiRoutes.length === 9]);
+for (const [label, ok] of checks) console.log(`  ${ok ? "✅" : "❌"} ${label}`);
+if (!checks.every(([, ok]) => ok)) { console.log("\n装载检查失败，中止。"); process.exit(1); }
+console.log(`  工具：${registeredTools.map((t) => t.name).join(", ")}\n`);
+
+// 2. 保存记忆（工具执行）
+console.log("【2】memory_save 保存记忆");
+const saves = [];
+saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流", importance: 5 }));
+saves.push(await tool("memory_save").execute({ type: "preference", title: "工作时段", content: "9-18 点在线，上午深度工作", importance: 4 }));
+saves.push(await tool("memory_save").execute({ type: "preference", title: "工作习惯", content: "习惯上午处理复杂任务", importance: 3 }));
+saves.push(await tool("memory_save").execute({ type: "project", title: "记忆插件", content: "dsh-mneme 用 SQLite + Markdown 镜像", importance: 4 }));
+saves.push(await tool("memory_save").execute({ type: "decision", title: "存储选型", content: "确定使用 node:sqlite", importance: 5 }));
+// 同标题再存一次 → 应触发去重合并
+saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流，偶尔英文", importance: 5 }));
+for (const s of saves) console.log(`  memory ${s.action}: ${s.id}`);
+console.log("  同标题二次保存 → 触发 merge ✓\n");
+
+// 3. 搜索
+console.log("【3】memory_search / memory_list");
+const search = await tool("memory_search").execute({ query: "SQLite" });
+console.log(`  搜索 "SQLite" → ${search.items.length} 条`);
+const list = await tool("memory_list").execute({ type: "preference" });
+console.log(`  preference 共 ${list.total} 条\n`);
+
+// 4. 上下文注入
+console.log("【4】自动注入（新会话上下文）");
+const injected = injectContexts[0].text({});
+console.log(injected ? `  ${injected.split("\n").filter(Boolean).map((l) => "  " + l).join("\n")}` : "  （空）");
+console.log("");
+
+// 5. 会话摘要（turn/end 事件）
+console.log("【5】会话摘要（模拟 turn/end）");
+const session = {
+  id: "e2e-session-1",
+  events: [
+    { type: "user/message", data: { source: { kind: "user" }, content: [{ type: "text", text: "我偏好中文交流，以后都用中文。" }] } }
+  ],
+  requestHeader() { return { config: { provider: "mock", model: "mock-model" } }; }
+};
+await ctx.emit("session/event", session, { type: "turn/end" });
+await sleep(50);
+const afterSummary = await tool("memory_search").execute({ query: "中文交流" });
+console.log(`  摘要入库：${afterSummary.items.length} 条命中（source: session）\n`);
+
+// 6. autoDream
+console.log("【6】autoDream（阈值触发 → LLM 决策 → merge + 摘要）");
+console.log("  等待调度器触发（delay 80ms）…");
+await sleep(400);
+const injectedAfter = injectContexts[0].text({});
+const hasSummary = injectedAfter.includes("记忆库总览");
+console.log(`  注入中出现"记忆库总览"：${hasSummary ? "是 ✅" : "否 ❌"}`);
+const prefs = await tool("memory_list").execute({ type: "preference" });
+console.log(`  dream merge 后 preference 条目：${prefs.items.length}（dream 时 4 条相近项，merge 成 1 条）`);
+
+// 7. Web API 模拟调用
+console.log("\n【7】Web 面板 API（/api/dsh-mneme/list）");
+const listRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/list");
+const res = { writeHead(code, h) { this.statusCode = code; this.headers = h; return this; }, end(body) { this.body = body; } };
+await listRoute.handler({ url: "/api/dsh-mneme/list?type=project" }, res);
+const payload = JSON.parse(res.body);
+console.log(`  HTTP ${res.statusCode}，project 条目 ${payload.items.length} 条\n`);
+
+// 8. 用户画像 / 规则 / 自定义命令
+console.log("【8】用户画像 / 规则 / 自定义命令");
+function apiReq(path, method = "GET", body = null) {
+  const listeners = {};
+  const r = {
+    url: path, method, headers: {},
+    on(ev, fn) { listeners[ev] = fn; return r; },
+    emit(ev, data) { listeners[ev]?.(data); return r; }
+  };
+  if (body !== null) {
+    process.nextTick(() => { r.emit("data", Buffer.from(JSON.stringify(body))); r.emit("end"); });
+  }
+  return r;
+}
+function apiRes() { return { statusCode: 0, body: "", writeHead(code) { this.statusCode = code; return this; }, end(body) { this.body = body; } }; }
+
+const profileRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/profile");
+const rp = apiRes();
+await profileRoute.handler(apiReq("/api/dsh-mneme/profile", "PUT", { profile: "我是后端开发者，擅长 Node.js" }), rp);
+const rulesRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/rules");
+const rr = apiRes();
+await rulesRoute.handler(apiReq("/api/dsh-mneme/rules", "PUT", { rules: ["回答时先给结论", "使用简体中文"] }), rr);
+const userSettings = injectContexts.find((c) => c.name === "user-settings").text({});
+console.log(`  注入含用户画像：${userSettings.includes("后端开发者") ? "✅" : "❌"}`);
+console.log(`  注入含规则：${userSettings.includes("先给结论") ? "✅" : "❌"}`);
+const cmdRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/commands");
+const rc = apiRes();
+await cmdRoute.handler(apiReq("/api/dsh-mneme/commands", "POST", { name: "review", description: "审查代码", instruction: "请按项目规范审查当前代码" }), rc);
+const cmdRegistered = registeredCommands.has("review");
+console.log(`  自定义命令 /review 已注册：${cmdRegistered ? "✅" : "❌"}`);
+if (cmdRegistered) {
+  const handler = registeredCommands.get("review").handler;
+  const result = await handler({ agent: {}, rawInput: "", signal: null });
+  console.log(`  命令触发返回：${result.text.slice(0, 24)}…`);
+}
+console.log("");
+
+// ---------------------------------------------------------------- 汇总
+console.log("══════ 汇总 ══════");
+console.log(`  LLM 调用：${llmCalls.join(" → ")}`);
+console.log(`  记忆文件：${memDir}`);
+const all = await tool("memory_list").execute({});
+console.log(`  当前可注入条目：${all.total}`);
+console.log("══════ 演示结束 ══════");
+fiber.dispose?.();

package/scripts/stress-dsh.js

@@ -0,0 +1,255 @@
+// scripts/stress-dsh.js
+// 压测：沿着三条轴线检验 dsh-mneme 的 autoDream 与存储在长会话、冲突、
+// 并发压力下的表现。LLM 全部用确定性的 mock 决策，离线可跑、无需 API Key。
+//
+//   轴线 1 · 长会话检索：Recall@k（规范记忆能否被召回）与陈旧残留率
+//   轴线 2 · 冲突裁决：可重放仲裁集 —— 仲裁正确率、确定性、审计/回放
+//   轴线 3 · 多 Agent 并发：丢更新、重复合并、事务/崩溃恢复
+//
+// 运行：node scripts/stress-dsh.js
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createStore } from "../src/store.js";
+import { createService } from "../src/service.js";
+import {
+  createDreamScheduler,
+  hashSnapshot,
+  parseReceipt
+} from "../src/dream.js";
+import { applyDecisions } from "../src/dream/decisions.js";
+import {
+  sessionDecisions,
+  arbitrationDecisions,
+  mockCtx
+} from "../test/helpers/dream-mock.js";
+
+const pass = (ok) => (ok ? "✅" : "❌");
+
+// ---------------------------------------------------------------- 轴线 1
+
+async function axis1LongSessionRetrieval() {
+  console.log("【轴线 1】长会话检索：Recall@k 与陈旧残留率");
+  const topics = 20;
+  const rounds = 8;
+  const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a1-"));
+  const store = createStore(join(dir, "memory.db"));
+  const service = createService({ store, mirror: null, config: {} });
+  const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
+  const ctx = mockCtx({ onConsolidation: sessionDecisions });
+
+  // 每个主题一条规范记忆（ground truth，importance 5）
+  const gt = [];
+  for (let t = 1; t <= topics; t++) {
+    const title = `主题${String(t).padStart(2, "0")}`;
+    const { memory } = service.saveWithDedupe({ type: "project", title, content: `${title} 的规范内容`, importance: 5 });
+    gt.push({ title, id: memory.id });
+  }
+  // 长会话：每轮追加同主题旧变体（importance 3）并触发一次 autoDream
+  for (let round = 1; round <= rounds; round++) {
+    for (let t = 1; t <= topics; t++) {
+      service.saveWithDedupe({
+        type: "project",
+        title: `主题${String(t).padStart(2, "0")}·变体${round}`,
+        content: `主题${t} 第${round}轮旧变体`,
+        importance: 3
+      });
+    }
+    await dream.runDream(ctx, service, {});
+  }
+
+  let hits5 = 0;
+  let hits10 = 0;
+  for (const { title, id } of gt) {
+    const k5 = service.search(title, { limit: 5 });
+    const k10 = service.search(title, { limit: 10 });
+    if (k5.some((m) => m.id === id)) hits5++;
+    if (k10.some((m) => m.id === id)) hits10++;
+  }
+  const recall5 = hits5 / topics;
+  const recall10 = hits10 / topics;
+
+  // 陈旧残留率 = 仍活跃的旧变体 / 全部旧变体（dream 应全部清掉 → 0）
+  const all = store.all();
+  const variants = all.filter((m) => m.type === "project" && m.title.includes("变体"));
+  const staleResidual = variants.filter((m) => !m.archived).length / variants.length;
+  const runs = store.listDreamRuns().length;
+
+  console.log(`  主题 ${topics} 个 × 变体 ${rounds} 轮 = ${topics * rounds} 条旧记忆，autoDream 触发 ${runs} 次`);
+  console.log(`  ${pass(recall5 >= 0.95)} Recall@5  = ${(recall5 * 100).toFixed(1)}%（规范记忆 top5 召回）`);
+  console.log(`  ${pass(recall10 >= 0.95)} Recall@10 = ${(recall10 * 100).toFixed(1)}%`);
+  console.log(`  ${pass(staleResidual === 0)} 陈旧残留率 = ${(staleResidual * 100).toFixed(1)}%（理想 0%）`);
+  store.close();
+  return { recall5, recall10, staleResidual, runs };
+}
+
+// ---------------------------------------------------------------- 轴线 2
+
+async function axis2ConflictArbitration() {
+  console.log("【轴线 2】冲突裁决：可重放仲裁集");
+  const sets = [
+    { key: "项目截止日期", winner: { type: "decision", title: "项目截止日期", content: "8月20日交付", importance: 5 }, loser: { type: "decision", title: "项目截止日期(旧)", content: "8月15日交付", importance: 3 } },
+    { key: "语言偏好", winner: { type: "preference", title: "语言偏好", content: "使用简体中文", importance: 5 }, loser: { type: "preference", title: "语言偏好(旧)", content: "使用繁体中文", importance: 2 } },
+    { key: "存储选型", winner: { type: "decision", title: "存储选型", content: "node:sqlite（零依赖）", importance: 5 }, loser: { type: "decision", title: "存储选型(旧)", content: "better-sqlite3（需编译）", importance: 3 } },
+    { key: "部署环境", winner: { type: "project", title: "部署环境", content: "生产环境 Node 24 + Windows Server", importance: 4 }, loser: { type: "project", title: "部署环境(旧)", content: "生产环境 Node 20 + Linux", importance: 2 } }
+  ];
+
+  const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a2-"));
+  const store = createStore(join(dir, "memory.db"));
+  const service = createService({ store, mirror: null, config: {} });
+  const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
+  const ctx = mockCtx({ onConsolidation: arbitrationDecisions });
+
+  // 仲裁集入库（先败者后胜者，模拟旧信息先存、新信息后到）
+  for (const set of sets) {
+    service.saveWithDedupe({ ...set.loser });
+    service.saveWithDedupe({ ...set.winner });
+  }
+  const before = hashSnapshot(service.all().filter((m) => !m.archived && m.type !== "summary"));
+
+  // 跑一次裁决 → 审计 + receipt
+  const run1 = await dream.runDream(ctx, service, {});
+  console.log(`  裁决运行：${pass(run1.ok)}（applied=${run1.applied}，receipt=${run1.receipt.slice(0, 40)}…）`);
+
+  // 正确性：胜者保留 + 败者归档 + 来源链注释
+  let arbOk = 0;
+  for (const set of sets) {
+    const winner = service.list({ type: set.winner.type }).find((m) => m.title === set.winner.title);
+    const loser = store.all().find((m) => m.title === set.loser.title);
+    if (winner && loser && loser.archived && winner.content.includes("已否决旧信息")) arbOk++;
+  }
+  const arbRate = arbOk / sets.length;
+  console.log(`  ${pass(arbRate === 1)} 仲裁正确率 = ${(arbRate * 100).toFixed(0)}%（胜者保留 + 败者归档 + 来源链注释）`);
+
+  // 确定性：同一输入快照 → 同一决策。重跑前先把败者"复活"为原始状态。
+  const audit = store.getDreamRun(run1.runId);
+  const receipt = parseReceipt(audit.receipt);
+  console.log(`  ${pass(!!receipt && receipt.status === "ok")} receipt 可解析，snapshot=${receipt.snapshotHash}，输入 ${receipt.inputCount} 条`);
+  console.log(`  ${pass(audit.outcome && Object.keys(audit.outcome.byId).length === sets.length * 2)} 审计 outcome 覆盖全部 ${sets.length * 2} 个仲裁对象`);
+
+  // 可重放：审计中的决策清单在同一 store 上重放 → 幂等（无副作用）
+  const winnerBefore = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
+  const replayed = applyDecisions(audit.decisions, service);
+  const winnerAfter = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
+  const idempotent = replayed.applied === 0 && winnerBefore === winnerAfter;
+  console.log(`  ${pass(idempotent)} 决策清单重放幂等（repeat 无副作用，来源链不重复追加）`);
+  console.log(`  ${pass(before.length === 64)} 快照哈希稳定（${before.length} hex 位）`);
+
+  const runs = store.listDreamRuns().length;
+  store.close();
+  return { arbRate, runs, idempotent };
+}
+
+// ---------------------------------------------------------------- 轴线 3
+
+function bump(content) {
+  const m = content.match(/count=(\d+)/);
+  return `count=${m ? Number(m[1]) + 1 : 1}`;
+}
+
+async function axis3Concurrency() {
+  console.log("【轴线 3】多 Agent 并发：丢更新 / 重复合并 / 事务恢复");
+  const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a3-"));
+  const path = join(dir, "memory.db");
+
+  // --- 重复合并：20 个 agent 并发保存同标题 → 最终只 1 条活跃
+  const sA = createStore(path);
+  const svA = createService({ store: sA, mirror: null, config: {} });
+  const agents = 20;
+  const writes = [];
+  for (let i = 0; i < agents; i++) {
+    writes.push(Promise.resolve().then(() => svA.saveWithDedupe({ type: "preference", title: "并发任务", content: `agent-${i}` })));
+  }
+  await Promise.all(writes);
+  const dupes = svA.list({ type: "preference", limit: 100 }).filter((m) => m.title === "并发任务");
+  const noDupes = dupes.length === 1;
+  console.log(`  ${pass(noDupes)} 重复合并：${agents} 个 agent 同标题并发保存 → 活跃 ${dupes.length} 条（期望 1）`);
+
+  // --- 丢更新：CAS 原子递增（硬断言：陈旧版本必须被拒，增量不得丢失）
+  const sB = createStore(path);
+  const svB = createService({ store: sB, mirror: null, config: {} });
+  svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
+  const counterId = svA.list({ type: "history" })[0].id;
+  svA.update(counterId, { content: "count=0" });
+  const baseline = svA.getById(counterId); // updated_at=T, count=0
+  // Agent A 持最新版本 → CAS 成功（count=1）
+  const aOk = svA.compareAndUpdate(counterId, baseline.updated_at, { content: bump(baseline.content) });
+  // Agent B 仍持过期版本 T → CAS 必须被拒；若被接受即丢更新
+  const bStale = svB.compareAndUpdate(counterId, baseline.updated_at, { content: bump("count=0") });
+  const casRejected = aOk !== undefined && bStale === undefined;
+  // B 重读最新值重试 → 两个 +1 都落地
+  if (bStale === undefined) {
+    const cur = svB.getById(counterId);
+    svB.compareAndUpdate(counterId, cur.updated_at, { content: bump(cur.content) });
+  }
+  const casResult = svB.getById(counterId).content;
+  const noLostUpdate = casRejected && casResult === "count=2";
+  console.log(`  ${pass(noLostUpdate)} CAS 并发递增：陈旧版本被拒=${casRejected}，重读重试后 → ${casResult}（期望 count=2，硬断言）`);
+  // 串行化修复（无 CAS 时的人工约定）：写前重读最新值
+  svA.update(counterId, { content: "count=0" });
+  svA.update(counterId, { content: bump(svA.getById(counterId).content) });
+  svB.update(counterId, { content: bump(svB.getById(counterId).content) });
+  const fixedResult = svB.getById(counterId).content;
+  const fixed = fixedResult === "count=2";
+  console.log(`  ${pass(fixed)} 串行重读修复：写前重读最新 → ${fixedResult}（期望 count=2）`);
+
+  // --- 多步原子性：事务中途抛错 → 全部回滚（硬断言，无半成品）
+  let txThrew = false;
+  try {
+    svB.transaction(() => {
+      svB.saveWithDedupe({ type: "project", title: "原子A", content: "x" });
+      svB.saveWithDedupe({ type: "project", title: "原子B", content: "y" });
+      throw new Error("boom");
+    });
+  } catch { txThrew = true; }
+  const allNow = svB.all();
+  const atomic = txThrew
+    && !allNow.some((m) => m.title === "原子A")
+    && !allNow.some((m) => m.title === "原子B");
+  console.log(`  ${pass(atomic)} 多步原子性：事务中途抛错 → 原子A/原子B 全部回滚（期望均不存在，硬断言）`);
+
+  // --- 事务/崩溃恢复：已提交写入在异常后 + reopen 后完整保留
+  const svC = createService({ store: sB, mirror: null, config: {} }); // 复用同一文件连接
+  svC.saveWithDedupe({ type: "project", title: "已提交A", content: "x" });
+  svC.saveWithDedupe({ type: "project", title: "已提交B", content: "y" });
+  let threw = false;
+  try {
+    svC.update("nonexistent-id", { content: "boom" }); // store.update 对未知 id 抛错
+  } catch {
+    threw = true;
+  }
+  sA.close();
+  sB.close();
+  const sR = createStore(path); // 重新打开（模拟进程重启）
+  const recovered = sR.all();
+  const recoveryOk = threw
+    && recovered.some((m) => m.title === "已提交A")
+    && recovered.some((m) => m.title === "已提交B")
+    && recovered.some((m) => m.title === "计数器");
+  console.log(`  ${pass(recoveryOk)} 事务恢复：中途异常后已提交写入不丢，reopen 后完整可读`);
+  console.log(`  ${pass(recovered.filter((m) => m.title === "已提交A").length === 1)} 无半成品残留（已提交A 仅 1 条）`);
+
+  sR.close();
+  return { noDupes, noLostUpdate, atomic, fixed, recoveryOk };
+}
+
+// ---------------------------------------------------------------- 汇总
+
+console.log("══════ dsh-mneme 压测：三条轴线 ══════");
+console.log("");
+const a1 = await axis1LongSessionRetrieval();
+console.log("");
+const a2 = await axis2ConflictArbitration();
+console.log("");
+const a3 = await axis3Concurrency();
+console.log("");
+console.log("══════ 压测汇总 ══════");
+console.log(`  轴线1 长会话检索：Recall@5=${(a1.recall5 * 100).toFixed(1)}%  Recall@10=${(a1.recall10 * 100).toFixed(1)}%  陈旧残留=${(a1.staleResidual * 100).toFixed(1)}%  （${a1.runs} 次 autoDream 全部入审计）`);
+console.log(`  轴线2 冲突裁决：仲裁正确率=${(a2.arbRate * 100).toFixed(0)}%  重放幂等=${a2.idempotent ? "是" : "否"}`);
+console.log(`  轴线3 多 Agent 并发：去重=${a3.noDupes ? "✅" : "❌"}  CAS无丢更新=${a3.noLostUpdate ? "✅" : "❌"}  多步原子=${a3.atomic ? "✅" : "❌"}  串行修复=${a3.fixed ? "✅" : "❌"}  崩溃恢复=${a3.recoveryOk ? "✅" : "❌"}`);
+// 丢更新与多步原子性都是硬断言：任一失败 → 非零退出，绝不把风险标成通过
+const allOk = a1.recall5 >= 0.95 && a1.staleResidual === 0 && a2.arbRate === 1 && a2.idempotent
+  && a3.noDupes && a3.noLostUpdate && a3.atomic && a3.fixed && a3.recoveryOk;
+console.log(`  结论：${allOk ? "全部通过 ✅" : "存在失败项 ❌"}`);
+console.log("══════ 压测结束 ══════");
+process.exit(allOk ? 0 : 1);

package/scripts/sync-lib.js

@@ -0,0 +1,47 @@
+// Sync the src/ tree into lib/ — the distributable consumed by DSH (package
+// main is lib/index.js). lib/client.js (the Web panel bundle) is authored
+// independently under lib/ and is left untouched: the sync only copies
+// src -> lib, it never prunes lib-only files.
+//
+// Usage: npm run sync   (also run automatically by `npm pack`/`npm publish`
+// via the prepack hook, so a published tarball always ships a fresh lib/).
+import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(fileURLToPath(new URL("..", import.meta.url)));
+const srcDir = join(root, "src");
+const libDir = join(root, "lib");
+
+/** Recursively collect all files under a directory (sorted for stable output). */
+function walk(dir) {
+  const out = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walk(full));
+    else if (entry.isFile()) out.push(full);
+  }
+  return out;
+}
+
+let copied = 0;
+mkdirSync(libDir, { recursive: true });
+
+for (const file of walk(srcDir)) {
+  const rel = relative(srcDir, file);
+  const dest = join(libDir, rel);
+  mkdirSync(join(dest, ".."), { recursive: true });
+  cpSync(file, dest);
+  copied++;
+  console.log(`synced  ${rel}`);
+}
+
+// Report lib-only files (authored separately, e.g. client.js) so drift is
+// visible but never clobbered.
+for (const file of walk(libDir)) {
+  const rel = relative(libDir, file);
+  if (!existsSync(join(srcDir, rel))) console.log(`kept    ${rel} (lib-only, not pruned)`);
+}
+
+console.log(`\nSynced ${copied} file(s) from src/ to lib/.`);
+if (!copied) process.exitCode = 1;

package/src/config.js

@@ -49,8 +49,11 @@ export const Config = z.object({
   hybridSearchKeywordWeight: z.number().min(0).max(1).default(0.4),
 
   // --- semantic: rerank layer (v0.2) --------------------------------------
-  rerankEnabled: z.boolean().default(true),
-  rerankProvider: z.union([z.const("local"), z.const("none")]).default("local"),
+  // Opt-in by default (item ⑥): the local cross-encoder pulls in onnxruntime
+  // (transformers.js) at init, so a bare install must not load it. Only an
+  // explicit rerankEnabled=true + rerankProvider="local" constructs LocalReranker.
+  rerankEnabled: z.boolean().default(false),
+  rerankProvider: z.union([z.const("local"), z.const("none")]).default("none"),
   rerankModel: z.string().default("Xenova/bge-reranker-base"),
   rerankBatchSize: z.natural().min(1).max(64).default(8),
   rerankMaxCandidates: z.natural().min(5).max(100).default(30),