@modusensus/dsh-mneme 0.6.7 → 0.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/.github/workflows/test.yml +32 -0
  2. package/.release-notes-v0.6.9.md +13 -0
  3. package/CHANGELOG.md +89 -0
  4. package/LICENSE +21 -21
  5. package/README.md +219 -463
  6. package/SECURITY.md +544 -0
  7. package/docs/devlog/2026-08-14-dsh-mneme-dev-log.md +247 -0
  8. package/docs/devlog/2026-08-15-dsh-mneme-audit-stress-dev-log.md +145 -0
  9. package/docs/devlog/2026-08-15-dsh-mneme-pipeline-dev-log.md +56 -0
  10. package/docs/devlog/2026-08-15-dsh-mneme-reflection-dev-log.md +77 -0
  11. package/docs/devlog/2026-08-15-dsh-mneme-review-fixes-dev-log.md +64 -0
  12. package/docs/devlog/2026-08-15-dsh-mneme-semantic-dev-log.md +90 -0
  13. package/dsh-mneme/CHANGELOG.md +248 -0
  14. package/dsh-mneme/LICENSE +21 -0
  15. package/dsh-mneme/README.md +465 -0
  16. package/{cordis.patch.yml → dsh-mneme/cordis.patch.yml} +15 -15
  17. package/dsh-mneme/docs/AGENT_MEMORY_RESEARCH.md +183 -0
  18. package/dsh-mneme/docs/ENTITIES.md +245 -0
  19. package/dsh-mneme/docs/LOCAL_MODEL.md +141 -0
  20. package/dsh-mneme/docs/MIGRATION.md +127 -0
  21. package/dsh-mneme/docs/SEMANTIC.md +256 -0
  22. package/dsh-mneme/docs/SLEEP.md +163 -0
  23. package/{lib → dsh-mneme/lib}/api.js +783 -783
  24. package/{lib → dsh-mneme/lib}/client.js +1757 -1757
  25. package/{src → dsh-mneme/lib}/commands.js +64 -64
  26. package/{lib → dsh-mneme/lib}/config.js +298 -288
  27. package/{lib → dsh-mneme/lib}/dream/clustering.js +118 -118
  28. package/{src → dsh-mneme/lib}/dream/decisions.js +488 -439
  29. package/{lib → dsh-mneme/lib}/dream/sleep.js +561 -554
  30. package/{src → dsh-mneme/lib}/dream/tag-extractor.js +156 -156
  31. package/{lib → dsh-mneme/lib}/dream.js +958 -929
  32. package/{src → dsh-mneme/lib}/embedding.js +154 -154
  33. package/{src → dsh-mneme/lib}/entities/extractor.js +242 -242
  34. package/{src → dsh-mneme/lib}/hot-memory.js +53 -53
  35. package/{lib → dsh-mneme/lib}/index.js +361 -361
  36. package/{src → dsh-mneme/lib}/inject.js +208 -208
  37. package/{lib → dsh-mneme/lib}/local-embedder.js +282 -282
  38. package/{lib → dsh-mneme/lib}/mirror.js +170 -170
  39. package/{lib → dsh-mneme/lib}/parser/tag.js +59 -59
  40. package/{lib → dsh-mneme/lib}/parser/wiki-link.js +38 -38
  41. package/{src → dsh-mneme/lib}/quality-filter.js +123 -123
  42. package/{lib → dsh-mneme/lib}/reranker.js +218 -218
  43. package/{lib → dsh-mneme/lib}/search/adaptive.js +22 -22
  44. package/{lib → dsh-mneme/lib}/search/bm25.js +96 -96
  45. package/{src → dsh-mneme/lib}/search/tag-boost.js +61 -61
  46. package/{src → dsh-mneme/lib}/service.js +1726 -1726
  47. package/{lib → dsh-mneme/lib}/settings.js +172 -172
  48. package/{lib → dsh-mneme/lib}/store.js +2238 -2238
  49. package/{lib → dsh-mneme/lib}/summarize.js +236 -236
  50. package/{lib → dsh-mneme/lib}/tools.js +290 -290
  51. package/{lib → dsh-mneme/lib}/vector-index.js +116 -116
  52. package/dsh-mneme/package-lock.json +1936 -0
  53. package/dsh-mneme/package.json +80 -0
  54. package/{scripts → dsh-mneme/scripts}/benchmark-embed.js +201 -201
  55. package/{scripts → dsh-mneme/scripts}/benchmark-recall.js +133 -133
  56. package/{scripts → dsh-mneme/scripts}/benchmark-rerank.js +166 -166
  57. package/{scripts → dsh-mneme/scripts}/e2e-dsh.js +218 -218
  58. package/{scripts → dsh-mneme/scripts}/stress-dsh.js +255 -255
  59. package/{scripts → dsh-mneme/scripts}/sync-lib.js +52 -52
  60. package/{src → dsh-mneme/src}/api.js +783 -783
  61. package/{lib → dsh-mneme/src}/commands.js +64 -64
  62. package/{src → dsh-mneme/src}/config.js +298 -288
  63. package/{src → dsh-mneme/src}/dream/clustering.js +118 -118
  64. package/{lib → dsh-mneme/src}/dream/decisions.js +488 -439
  65. package/{src → dsh-mneme/src}/dream/sleep.js +561 -554
  66. package/{lib → dsh-mneme/src}/dream/tag-extractor.js +156 -156
  67. package/{src → dsh-mneme/src}/dream.js +958 -929
  68. package/{lib → dsh-mneme/src}/embedding.js +154 -154
  69. package/{lib → dsh-mneme/src}/entities/extractor.js +242 -242
  70. package/{lib → dsh-mneme/src}/hot-memory.js +53 -53
  71. package/{src → dsh-mneme/src}/index.js +361 -361
  72. package/{lib → dsh-mneme/src}/inject.js +208 -208
  73. package/{src → dsh-mneme/src}/local-embedder.js +282 -282
  74. package/{src → dsh-mneme/src}/mirror.js +170 -170
  75. package/{src → dsh-mneme/src}/parser/tag.js +59 -59
  76. package/{src → dsh-mneme/src}/parser/wiki-link.js +38 -38
  77. package/{lib → dsh-mneme/src}/quality-filter.js +123 -123
  78. package/{src → dsh-mneme/src}/reranker.js +218 -218
  79. package/{src → dsh-mneme/src}/search/adaptive.js +22 -22
  80. package/{src → dsh-mneme/src}/search/bm25.js +96 -96
  81. package/{lib → dsh-mneme/src}/search/tag-boost.js +61 -61
  82. package/{lib → dsh-mneme/src}/service.js +1726 -1726
  83. package/{src → dsh-mneme/src}/settings.js +172 -172
  84. package/{src → dsh-mneme/src}/store.js +2238 -2238
  85. package/{src → dsh-mneme/src}/summarize.js +236 -236
  86. package/{src → dsh-mneme/src}/tools.js +290 -290
  87. package/{src → dsh-mneme/src}/vector-index.js +116 -116
  88. package/{test → dsh-mneme/test}/api.test.js +594 -594
  89. package/{test → dsh-mneme/test}/audit.test.js +448 -448
  90. package/{test → dsh-mneme/test}/benchmark.test.js +35 -35
  91. package/{test → dsh-mneme/test}/boundary-v0625.test.js +82 -82
  92. package/{test → dsh-mneme/test}/client.test.js +368 -368
  93. package/{test → dsh-mneme/test}/clustering.test.js +100 -100
  94. package/{test → dsh-mneme/test}/commands.test.js +69 -69
  95. package/{test → dsh-mneme/test}/config.test.js +50 -50
  96. package/{test → dsh-mneme/test}/conflict-freeze.test.js +290 -290
  97. package/{test → dsh-mneme/test}/directory.test.js +134 -134
  98. package/{test → dsh-mneme/test}/dream.test.js +1060 -901
  99. package/{test → dsh-mneme/test}/entities.test.js +522 -522
  100. package/{test → dsh-mneme/test}/epistemic.test.js +298 -298
  101. package/{test → dsh-mneme/test}/fnew-0112.test.js +311 -311
  102. package/{test → dsh-mneme/test}/fnew-03.test.js +422 -422
  103. package/{test → dsh-mneme/test}/graph-api.test.js +175 -175
  104. package/{test → dsh-mneme/test}/helpers/dream-mock.js +82 -82
  105. package/{test → dsh-mneme/test}/hot-memory.test.js +174 -174
  106. package/{test → dsh-mneme/test}/inject.test.js +103 -103
  107. package/{test → dsh-mneme/test}/llm-audit.test.js +279 -279
  108. package/{test → dsh-mneme/test}/local-embedder.test.js +227 -227
  109. package/{test → dsh-mneme/test}/mirror-dirty.test.js +424 -424
  110. package/{test → dsh-mneme/test}/mirror-edit-digest.test.js +187 -187
  111. package/{test → dsh-mneme/test}/mirror-generation.test.js +499 -499
  112. package/{test → dsh-mneme/test}/mirror.test.js +249 -249
  113. package/{test → dsh-mneme/test}/normalize-decisions.test.js +120 -120
  114. package/{test → dsh-mneme/test}/peer-blockers.test.js +190 -190
  115. package/{test → dsh-mneme/test}/policy-epoch.test.js +259 -259
  116. package/{test → dsh-mneme/test}/provenance.test.js +103 -103
  117. package/{test → dsh-mneme/test}/quality-filter.test.js +118 -118
  118. package/{test → dsh-mneme/test}/reasoning-effort.test.js +199 -199
  119. package/{test → dsh-mneme/test}/recall-evals.test.js +235 -235
  120. package/{test → dsh-mneme/test}/recall-layer.test.js +315 -315
  121. package/{test → dsh-mneme/test}/receipt-chain.test.js +451 -451
  122. package/{test → dsh-mneme/test}/reflection.test.js +226 -226
  123. package/{test → dsh-mneme/test}/reranker.test.js +240 -240
  124. package/{test → dsh-mneme/test}/search-fusion.test.js +90 -90
  125. package/{test → dsh-mneme/test}/semantic.test.js +124 -124
  126. package/{test → dsh-mneme/test}/service-search.test.js +199 -199
  127. package/{test → dsh-mneme/test}/service.test.js +435 -435
  128. package/{test → dsh-mneme/test}/settings.test.js +118 -118
  129. package/{test → dsh-mneme/test}/sleep.test.js +365 -365
  130. package/{test → dsh-mneme/test}/store.test.js +436 -436
  131. package/{test → dsh-mneme/test}/stress.test.js +209 -209
  132. package/{test → dsh-mneme/test}/summarize.test.js +191 -191
  133. package/{test → dsh-mneme/test}/tag-boost.test.js +125 -125
  134. package/{test → dsh-mneme/test}/tag.test.js +312 -312
  135. package/{test → dsh-mneme/test}/tools.test.js +285 -285
  136. package/{test → dsh-mneme/test}/vector-index.test.js +221 -221
  137. package/{test → dsh-mneme/test}/wiki-link.test.js +332 -332
  138. package/package.json +18 -40
  139. package//346/250/252/345/271/205.png +0 -0
@@ -1,218 +1,218 @@
1
- // scripts/e2e-dsh.js
2
- // 端到端演示:用 cordis 搭建最小 DSH 环境,真实装载 dsh-mneme 插件,
3
- // 走一遍完整用户流程(工具注册 → 保存/搜索记忆 → 上下文注入 → 会话摘要 → autoDream)。
4
- //
5
- // 运行:node scripts/e2e-dsh.js
6
- import { Context } from "@deepseek-ai/cordis";
7
- import { mkdtempSync } from "node:fs";
8
- import { tmpdir } from "node:os";
9
- import { join } from "node:path";
10
- import * as mneme from "../lib/index.js";
11
-
12
- const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
13
-
14
- // ---------------------------------------------------------------- 环境
15
- const memDir = mkdtempSync(join(tmpdir(), "dsh-mneme-e2e-"));
16
- const ctx = new Context();
17
-
18
- // 插件声明的 5 个依赖服务(tools / systemPrompt / webServer / llm / agentDefaultModel)
19
- const registeredTools = [];
20
- const injectContexts = [];
21
- const apiRoutes = [];
22
- const registeredCommands = new Map();
23
- let llmCalls = [];
24
-
25
- ctx.provide("tools", {
26
- register(def) { registeredTools.push(def); return () => {}; }
27
- });
28
- ctx.provide("commands", {
29
- register(def) { registeredCommands.set(def.name, def); return () => registeredCommands.delete(def.name); }
30
- });
31
- ctx.provide("systemPrompt", {
32
- context(def) { injectContexts.push(def); return () => {}; }
33
- });
34
- ctx.provide("webServer", {
35
- register(route) { apiRoutes.push(route); return () => {}; }
36
- });
37
- ctx.provide("agentDefaultModel", {
38
- currentSelection() { return { provider: "mock", model: "mock-model" }; }
39
- });
40
-
41
- // LLM mock:按 purpose / 消息内容返回合理结果(模拟真实 LLM 的巩固行为)
42
- ctx.provide("llm", {
43
- async *stream(options) {
44
- llmCalls.push(options.purpose);
45
- const userText = options.messages.find((m) => m.role === "user")?.content?.[0]?.text ?? "";
46
- let text = "";
47
- if (options.purpose === "summarization") {
48
- text = JSON.stringify([
49
- { type: "preference", title: "语言偏好", content: "用户偏好使用中文交流", importance: 4 }
50
- ]);
51
- } else if (options.purpose === "compaction" && userText.includes("id=")) {
52
- // 从传入的记忆清单解析 id 与类型,动态构造有效决策:优先演示 merge,其余 keep
53
- const entries = [...userText.matchAll(/id=([^\s|]+).*?type=(\w+)/g)].map((m) => ({ id: m[1], type: m[2] }));
54
- const byType = {};
55
- for (const e of entries) (byType[e.type] ??= []).push(e.id);
56
- const decisions = [];
57
- const claimed = new Set();
58
- const mergeType = Object.keys(byType).find((t) => byType[t].length >= 2);
59
- if (mergeType) {
60
- const ids = byType[mergeType];
61
- decisions.push({
62
- action: "merge", ids, keepSource: ids[0],
63
- title: "合并条目", content: "两条主题相近的记忆合并后的精炼摘要", importance: 4
64
- });
65
- ids.forEach((id) => claimed.add(id));
66
- }
67
- for (const e of entries) {
68
- if (!claimed.has(e.id)) decisions.push({ action: "keep", ids: [e.id] });
69
- }
70
- text = JSON.stringify(decisions);
71
- } else if (options.purpose === "compaction") {
72
- text = "记忆库总览:用户偏好中文交流;工作偏好(上午深度工作);项目采用 SQLite 存储。";
73
- }
74
- yield { type: "block-start", index: 0, blockType: "text" };
75
- yield { type: "text-delta", index: 0, text };
76
- yield { type: "block-end", index: 0, block: { type: "text" } };
77
- yield { type: "finish", reason: { kind: "stop" } };
78
- }
79
- });
80
-
81
- // ---------------------------------------------------------------- 装载
82
- const fiber = ctx.plugin(
83
- { name: mneme.name, inject: mneme.inject, Config: mneme.Config, apply: mneme.apply },
84
- {
85
- memoryDir: memDir,
86
- autoInject: true,
87
- autoSummarize: true,
88
- maxInjectedItems: 5,
89
- importanceThreshold: 3,
90
- autoDream: true,
91
- dreamThresholdCount: 3,
92
- dreamThresholdChars: 100,
93
- dreamDelayMs: 80
94
- }
95
- );
96
- await fiber;
97
-
98
- // ---------------------------------------------------------------- 工具
99
- const tool = (name) => registeredTools.find((t) => t.name === name);
100
-
101
- console.log("══════ dsh-mneme 端到端演示 ══════");
102
- console.log(`记忆目录:${memDir}\n`);
103
-
104
- // 1. 装载检查
105
- console.log("【1】插件装载");
106
- const checks = [];
107
- checks.push(["注册 7 个模型工具", registeredTools.length === 7]);
108
- checks.push(["注册 2 个注入上下文", injectContexts.length === 2 && injectContexts[0].name === "memory"]);
109
- // 契约是 9 条 exact 路由;prefix fallback(/api/dsh-mneme → 404)是兜底,
110
- // 不计入路由数。
111
- checks.push(["注册 9 条 API 路由", apiRoutes.filter((r) => r.kind === "exact").length === 9]);
112
- for (const [label, ok] of checks) console.log(` ${ok ? "✅" : "❌"} ${label}`);
113
- if (!checks.every(([, ok]) => ok)) { console.log("\n装载检查失败,中止。"); process.exit(1); }
114
- console.log(` 工具:${registeredTools.map((t) => t.name).join(", ")}\n`);
115
-
116
- // 2. 保存记忆(工具执行)
117
- console.log("【2】memory_save 保存记忆");
118
- const saves = [];
119
- saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流", importance: 5 }));
120
- saves.push(await tool("memory_save").execute({ type: "preference", title: "工作时段", content: "9-18 点在线,上午深度工作", importance: 4 }));
121
- saves.push(await tool("memory_save").execute({ type: "preference", title: "工作习惯", content: "习惯上午处理复杂任务", importance: 3 }));
122
- saves.push(await tool("memory_save").execute({ type: "project", title: "记忆插件", content: "dsh-mneme 用 SQLite + Markdown 镜像", importance: 4 }));
123
- saves.push(await tool("memory_save").execute({ type: "decision", title: "存储选型", content: "确定使用 node:sqlite", importance: 5 }));
124
- // 同标题再存一次 → 应触发去重合并
125
- saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流,偶尔英文", importance: 5 }));
126
- for (const s of saves) console.log(` memory ${s.action}: ${s.id}`);
127
- console.log(" 同标题二次保存 → 触发 merge ✓\n");
128
-
129
- // 3. 搜索
130
- console.log("【3】memory_search / memory_list");
131
- const search = await tool("memory_search").execute({ query: "SQLite" });
132
- console.log(` 搜索 "SQLite" → ${search.items.length} 条`);
133
- const list = await tool("memory_list").execute({ type: "preference" });
134
- console.log(` preference 共 ${list.total} 条\n`);
135
-
136
- // 4. 上下文注入
137
- console.log("【4】自动注入(新会话上下文)");
138
- const injected = injectContexts[0].text({});
139
- console.log(injected ? ` ${injected.split("\n").filter(Boolean).map((l) => " " + l).join("\n")}` : " (空)");
140
- console.log("");
141
-
142
- // 5. 会话摘要(turn/end 事件)
143
- console.log("【5】会话摘要(模拟 turn/end)");
144
- const session = {
145
- id: "e2e-session-1",
146
- events: [
147
- { type: "user/message", data: { source: { kind: "user" }, content: [{ type: "text", text: "我偏好中文交流,以后都用中文。" }] } }
148
- ],
149
- requestHeader() { return { config: { provider: "mock", model: "mock-model" } }; }
150
- };
151
- await ctx.emit("session/event", session, { type: "turn/end" });
152
- await sleep(50);
153
- const afterSummary = await tool("memory_search").execute({ query: "中文交流" });
154
- console.log(` 摘要入库:${afterSummary.items.length} 条命中(source: session)\n`);
155
-
156
- // 6. autoDream
157
- console.log("【6】autoDream(阈值触发 → LLM 决策 → merge + 摘要)");
158
- console.log(" 等待调度器触发(delay 80ms)…");
159
- await sleep(400);
160
- const injectedAfter = injectContexts[0].text({});
161
- const hasSummary = injectedAfter.includes("记忆库总览");
162
- console.log(` 注入中出现"记忆库总览":${hasSummary ? "是 ✅" : "否 ❌"}`);
163
- const prefs = await tool("memory_list").execute({ type: "preference" });
164
- console.log(` dream merge 后 preference 条目:${prefs.items.length}(dream 时 4 条相近项,merge 成 1 条)`);
165
-
166
- // 7. Web API 模拟调用
167
- console.log("\n【7】Web 面板 API(/api/dsh-mneme/list)");
168
- const listRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/list");
169
- const res = { writeHead(code, h) { this.statusCode = code; this.headers = h; return this; }, end(body) { this.body = body; } };
170
- await listRoute.handler({ url: "/api/dsh-mneme/list?type=project" }, res);
171
- const payload = JSON.parse(res.body);
172
- console.log(` HTTP ${res.statusCode},project 条目 ${payload.items.length} 条\n`);
173
-
174
- // 8. 用户画像 / 规则 / 自定义命令
175
- console.log("【8】用户画像 / 规则 / 自定义命令");
176
- function apiReq(path, method = "GET", body = null) {
177
- const listeners = {};
178
- const r = {
179
- url: path, method, headers: {},
180
- on(ev, fn) { listeners[ev] = fn; return r; },
181
- emit(ev, data) { listeners[ev]?.(data); return r; }
182
- };
183
- if (body !== null) {
184
- process.nextTick(() => { r.emit("data", Buffer.from(JSON.stringify(body))); r.emit("end"); });
185
- }
186
- return r;
187
- }
188
- function apiRes() { return { statusCode: 0, body: "", writeHead(code) { this.statusCode = code; return this; }, end(body) { this.body = body; } }; }
189
-
190
- const profileRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/profile");
191
- const rp = apiRes();
192
- await profileRoute.handler(apiReq("/api/dsh-mneme/profile", "PUT", { profile: "我是后端开发者,擅长 Node.js" }), rp);
193
- const rulesRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/rules");
194
- const rr = apiRes();
195
- await rulesRoute.handler(apiReq("/api/dsh-mneme/rules", "PUT", { rules: ["回答时先给结论", "使用简体中文"] }), rr);
196
- const userSettings = injectContexts.find((c) => c.name === "user-settings").text({});
197
- console.log(` 注入含用户画像:${userSettings.includes("后端开发者") ? "✅" : "❌"}`);
198
- console.log(` 注入含规则:${userSettings.includes("先给结论") ? "✅" : "❌"}`);
199
- const cmdRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/commands");
200
- const rc = apiRes();
201
- await cmdRoute.handler(apiReq("/api/dsh-mneme/commands", "POST", { name: "review", description: "审查代码", instruction: "请按项目规范审查当前代码" }), rc);
202
- const cmdRegistered = registeredCommands.has("review");
203
- console.log(` 自定义命令 /review 已注册:${cmdRegistered ? "✅" : "❌"}`);
204
- if (cmdRegistered) {
205
- const handler = registeredCommands.get("review").handler;
206
- const result = await handler({ agent: {}, rawInput: "", signal: null });
207
- console.log(` 命令触发返回:${result.text.slice(0, 24)}…`);
208
- }
209
- console.log("");
210
-
211
- // ---------------------------------------------------------------- 汇总
212
- console.log("══════ 汇总 ══════");
213
- console.log(` LLM 调用:${llmCalls.join(" → ")}`);
214
- console.log(` 记忆文件:${memDir}`);
215
- const all = await tool("memory_list").execute({});
216
- console.log(` 当前可注入条目:${all.total}`);
217
- console.log("══════ 演示结束 ══════");
218
- fiber.dispose?.();
1
+ // scripts/e2e-dsh.js
2
+ // 端到端演示:用 cordis 搭建最小 DSH 环境,真实装载 dsh-mneme 插件,
3
+ // 走一遍完整用户流程(工具注册 → 保存/搜索记忆 → 上下文注入 → 会话摘要 → autoDream)。
4
+ //
5
+ // 运行:node scripts/e2e-dsh.js
6
+ import { Context } from "@deepseek-ai/cordis";
7
+ import { mkdtempSync } from "node:fs";
8
+ import { tmpdir } from "node:os";
9
+ import { join } from "node:path";
10
+ import * as mneme from "../lib/index.js";
11
+
12
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
13
+
14
+ // ---------------------------------------------------------------- 环境
15
+ const memDir = mkdtempSync(join(tmpdir(), "dsh-mneme-e2e-"));
16
+ const ctx = new Context();
17
+
18
+ // 插件声明的 5 个依赖服务(tools / systemPrompt / webServer / llm / agentDefaultModel)
19
+ const registeredTools = [];
20
+ const injectContexts = [];
21
+ const apiRoutes = [];
22
+ const registeredCommands = new Map();
23
+ let llmCalls = [];
24
+
25
+ ctx.provide("tools", {
26
+ register(def) { registeredTools.push(def); return () => {}; }
27
+ });
28
+ ctx.provide("commands", {
29
+ register(def) { registeredCommands.set(def.name, def); return () => registeredCommands.delete(def.name); }
30
+ });
31
+ ctx.provide("systemPrompt", {
32
+ context(def) { injectContexts.push(def); return () => {}; }
33
+ });
34
+ ctx.provide("webServer", {
35
+ register(route) { apiRoutes.push(route); return () => {}; }
36
+ });
37
+ ctx.provide("agentDefaultModel", {
38
+ currentSelection() { return { provider: "mock", model: "mock-model" }; }
39
+ });
40
+
41
+ // LLM mock:按 purpose / 消息内容返回合理结果(模拟真实 LLM 的巩固行为)
42
+ ctx.provide("llm", {
43
+ async *stream(options) {
44
+ llmCalls.push(options.purpose);
45
+ const userText = options.messages.find((m) => m.role === "user")?.content?.[0]?.text ?? "";
46
+ let text = "";
47
+ if (options.purpose === "summarization") {
48
+ text = JSON.stringify([
49
+ { type: "preference", title: "语言偏好", content: "用户偏好使用中文交流", importance: 4 }
50
+ ]);
51
+ } else if (options.purpose === "compaction" && userText.includes("id=")) {
52
+ // 从传入的记忆清单解析 id 与类型,动态构造有效决策:优先演示 merge,其余 keep
53
+ const entries = [...userText.matchAll(/id=([^\s|]+).*?type=(\w+)/g)].map((m) => ({ id: m[1], type: m[2] }));
54
+ const byType = {};
55
+ for (const e of entries) (byType[e.type] ??= []).push(e.id);
56
+ const decisions = [];
57
+ const claimed = new Set();
58
+ const mergeType = Object.keys(byType).find((t) => byType[t].length >= 2);
59
+ if (mergeType) {
60
+ const ids = byType[mergeType];
61
+ decisions.push({
62
+ action: "merge", ids, keepSource: ids[0],
63
+ title: "合并条目", content: "两条主题相近的记忆合并后的精炼摘要", importance: 4
64
+ });
65
+ ids.forEach((id) => claimed.add(id));
66
+ }
67
+ for (const e of entries) {
68
+ if (!claimed.has(e.id)) decisions.push({ action: "keep", ids: [e.id] });
69
+ }
70
+ text = JSON.stringify(decisions);
71
+ } else if (options.purpose === "compaction") {
72
+ text = "记忆库总览:用户偏好中文交流;工作偏好(上午深度工作);项目采用 SQLite 存储。";
73
+ }
74
+ yield { type: "block-start", index: 0, blockType: "text" };
75
+ yield { type: "text-delta", index: 0, text };
76
+ yield { type: "block-end", index: 0, block: { type: "text" } };
77
+ yield { type: "finish", reason: { kind: "stop" } };
78
+ }
79
+ });
80
+
81
+ // ---------------------------------------------------------------- 装载
82
+ const fiber = ctx.plugin(
83
+ { name: mneme.name, inject: mneme.inject, Config: mneme.Config, apply: mneme.apply },
84
+ {
85
+ memoryDir: memDir,
86
+ autoInject: true,
87
+ autoSummarize: true,
88
+ maxInjectedItems: 5,
89
+ importanceThreshold: 3,
90
+ autoDream: true,
91
+ dreamThresholdCount: 3,
92
+ dreamThresholdChars: 100,
93
+ dreamDelayMs: 80
94
+ }
95
+ );
96
+ await fiber;
97
+
98
+ // ---------------------------------------------------------------- 工具
99
+ const tool = (name) => registeredTools.find((t) => t.name === name);
100
+
101
+ console.log("══════ dsh-mneme 端到端演示 ══════");
102
+ console.log(`记忆目录:${memDir}\n`);
103
+
104
+ // 1. 装载检查
105
+ console.log("【1】插件装载");
106
+ const checks = [];
107
+ checks.push(["注册 7 个模型工具", registeredTools.length === 7]);
108
+ checks.push(["注册 2 个注入上下文", injectContexts.length === 2 && injectContexts[0].name === "memory"]);
109
+ // 契约是 9 条 exact 路由;prefix fallback(/api/dsh-mneme → 404)是兜底,
110
+ // 不计入路由数。
111
+ checks.push(["注册 9 条 API 路由", apiRoutes.filter((r) => r.kind === "exact").length === 9]);
112
+ for (const [label, ok] of checks) console.log(` ${ok ? "✅" : "❌"} ${label}`);
113
+ if (!checks.every(([, ok]) => ok)) { console.log("\n装载检查失败,中止。"); process.exit(1); }
114
+ console.log(` 工具:${registeredTools.map((t) => t.name).join(", ")}\n`);
115
+
116
+ // 2. 保存记忆(工具执行)
117
+ console.log("【2】memory_save 保存记忆");
118
+ const saves = [];
119
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流", importance: 5 }));
120
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "工作时段", content: "9-18 点在线,上午深度工作", importance: 4 }));
121
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "工作习惯", content: "习惯上午处理复杂任务", importance: 3 }));
122
+ saves.push(await tool("memory_save").execute({ type: "project", title: "记忆插件", content: "dsh-mneme 用 SQLite + Markdown 镜像", importance: 4 }));
123
+ saves.push(await tool("memory_save").execute({ type: "decision", title: "存储选型", content: "确定使用 node:sqlite", importance: 5 }));
124
+ // 同标题再存一次 → 应触发去重合并
125
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流,偶尔英文", importance: 5 }));
126
+ for (const s of saves) console.log(` memory ${s.action}: ${s.id}`);
127
+ console.log(" 同标题二次保存 → 触发 merge ✓\n");
128
+
129
+ // 3. 搜索
130
+ console.log("【3】memory_search / memory_list");
131
+ const search = await tool("memory_search").execute({ query: "SQLite" });
132
+ console.log(` 搜索 "SQLite" → ${search.items.length} 条`);
133
+ const list = await tool("memory_list").execute({ type: "preference" });
134
+ console.log(` preference 共 ${list.total} 条\n`);
135
+
136
+ // 4. 上下文注入
137
+ console.log("【4】自动注入(新会话上下文)");
138
+ const injected = injectContexts[0].text({});
139
+ console.log(injected ? ` ${injected.split("\n").filter(Boolean).map((l) => " " + l).join("\n")}` : " (空)");
140
+ console.log("");
141
+
142
+ // 5. 会话摘要(turn/end 事件)
143
+ console.log("【5】会话摘要(模拟 turn/end)");
144
+ const session = {
145
+ id: "e2e-session-1",
146
+ events: [
147
+ { type: "user/message", data: { source: { kind: "user" }, content: [{ type: "text", text: "我偏好中文交流,以后都用中文。" }] } }
148
+ ],
149
+ requestHeader() { return { config: { provider: "mock", model: "mock-model" } }; }
150
+ };
151
+ await ctx.emit("session/event", session, { type: "turn/end" });
152
+ await sleep(50);
153
+ const afterSummary = await tool("memory_search").execute({ query: "中文交流" });
154
+ console.log(` 摘要入库:${afterSummary.items.length} 条命中(source: session)\n`);
155
+
156
+ // 6. autoDream
157
+ console.log("【6】autoDream(阈值触发 → LLM 决策 → merge + 摘要)");
158
+ console.log(" 等待调度器触发(delay 80ms)…");
159
+ await sleep(400);
160
+ const injectedAfter = injectContexts[0].text({});
161
+ const hasSummary = injectedAfter.includes("记忆库总览");
162
+ console.log(` 注入中出现"记忆库总览":${hasSummary ? "是 ✅" : "否 ❌"}`);
163
+ const prefs = await tool("memory_list").execute({ type: "preference" });
164
+ console.log(` dream merge 后 preference 条目:${prefs.items.length}(dream 时 4 条相近项,merge 成 1 条)`);
165
+
166
+ // 7. Web API 模拟调用
167
+ console.log("\n【7】Web 面板 API(/api/dsh-mneme/list)");
168
+ const listRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/list");
169
+ const res = { writeHead(code, h) { this.statusCode = code; this.headers = h; return this; }, end(body) { this.body = body; } };
170
+ await listRoute.handler({ url: "/api/dsh-mneme/list?type=project" }, res);
171
+ const payload = JSON.parse(res.body);
172
+ console.log(` HTTP ${res.statusCode},project 条目 ${payload.items.length} 条\n`);
173
+
174
+ // 8. 用户画像 / 规则 / 自定义命令
175
+ console.log("【8】用户画像 / 规则 / 自定义命令");
176
+ function apiReq(path, method = "GET", body = null) {
177
+ const listeners = {};
178
+ const r = {
179
+ url: path, method, headers: {},
180
+ on(ev, fn) { listeners[ev] = fn; return r; },
181
+ emit(ev, data) { listeners[ev]?.(data); return r; }
182
+ };
183
+ if (body !== null) {
184
+ process.nextTick(() => { r.emit("data", Buffer.from(JSON.stringify(body))); r.emit("end"); });
185
+ }
186
+ return r;
187
+ }
188
+ function apiRes() { return { statusCode: 0, body: "", writeHead(code) { this.statusCode = code; return this; }, end(body) { this.body = body; } }; }
189
+
190
+ const profileRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/profile");
191
+ const rp = apiRes();
192
+ await profileRoute.handler(apiReq("/api/dsh-mneme/profile", "PUT", { profile: "我是后端开发者,擅长 Node.js" }), rp);
193
+ const rulesRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/rules");
194
+ const rr = apiRes();
195
+ await rulesRoute.handler(apiReq("/api/dsh-mneme/rules", "PUT", { rules: ["回答时先给结论", "使用简体中文"] }), rr);
196
+ const userSettings = injectContexts.find((c) => c.name === "user-settings").text({});
197
+ console.log(` 注入含用户画像:${userSettings.includes("后端开发者") ? "✅" : "❌"}`);
198
+ console.log(` 注入含规则:${userSettings.includes("先给结论") ? "✅" : "❌"}`);
199
+ const cmdRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/commands");
200
+ const rc = apiRes();
201
+ await cmdRoute.handler(apiReq("/api/dsh-mneme/commands", "POST", { name: "review", description: "审查代码", instruction: "请按项目规范审查当前代码" }), rc);
202
+ const cmdRegistered = registeredCommands.has("review");
203
+ console.log(` 自定义命令 /review 已注册:${cmdRegistered ? "✅" : "❌"}`);
204
+ if (cmdRegistered) {
205
+ const handler = registeredCommands.get("review").handler;
206
+ const result = await handler({ agent: {}, rawInput: "", signal: null });
207
+ console.log(` 命令触发返回:${result.text.slice(0, 24)}…`);
208
+ }
209
+ console.log("");
210
+
211
+ // ---------------------------------------------------------------- 汇总
212
+ console.log("══════ 汇总 ══════");
213
+ console.log(` LLM 调用:${llmCalls.join(" → ")}`);
214
+ console.log(` 记忆文件:${memDir}`);
215
+ const all = await tool("memory_list").execute({});
216
+ console.log(` 当前可注入条目:${all.total}`);
217
+ console.log("══════ 演示结束 ══════");
218
+ fiber.dispose?.();