@modusensus/dsh-mneme 0.8.14 → 0.8.15

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 (271) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +655 -654
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +689 -689
  5. package/bin/dsh-mneme-mcp.mjs +510 -510
  6. package/bin/dsh-mneme-serve.mjs +151 -151
  7. package/cordis.patch.yml +21 -21
  8. package/docs/CONFIGURATION.md +263 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/ENTITIES.md +245 -0
  12. package/docs/LOCAL_MODEL.md +222 -0
  13. package/docs/SEMANTIC.md +256 -0
  14. package/docs/SLEEP.md +164 -0
  15. package/docs/STORAGE.md +89 -0
  16. package/lib/api-standalone.js +673 -673
  17. package/lib/api.js +1437 -1433
  18. package/lib/bootstrap.js +211 -211
  19. package/lib/client.js +5444 -5295
  20. package/lib/commands.js +95 -95
  21. package/lib/config.js +880 -843
  22. package/lib/content-hash.js +54 -54
  23. package/lib/continuity.js +220 -220
  24. package/lib/document-index.js +94 -94
  25. package/lib/document.js +303 -303
  26. package/lib/dream/clustering.js +118 -118
  27. package/lib/dream/decisions.js +674 -674
  28. package/lib/dream/narratives.js +44 -44
  29. package/lib/dream/sleep.js +819 -819
  30. package/lib/dream.js +1501 -1501
  31. package/lib/embedding.js +177 -177
  32. package/lib/entities/extractor.js +252 -252
  33. package/lib/graph/anchoring.js +179 -179
  34. package/lib/guide.js +74 -74
  35. package/lib/heat.js +144 -144
  36. package/lib/hot-memory.js +46 -46
  37. package/lib/index.js +535 -503
  38. package/lib/inject.js +464 -450
  39. package/lib/lang.js +248 -229
  40. package/lib/local-embedder.js +358 -358
  41. package/lib/maintenance.js +142 -142
  42. package/lib/mirror.js +330 -330
  43. package/lib/organize.js +450 -450
  44. package/lib/peak-hours.js +117 -117
  45. package/lib/placement.js +13 -0
  46. package/lib/pre-inject-gate.js +340 -0
  47. package/lib/quality-filter.js +126 -126
  48. package/lib/recall-stats.js +175 -175
  49. package/lib/reranker.js +269 -269
  50. package/lib/runtime/adopt.js +176 -176
  51. package/lib/runtime/closure.js +172 -172
  52. package/lib/runtime/download.js +247 -247
  53. package/lib/runtime/layout.js +265 -265
  54. package/lib/runtime/loader.js +252 -252
  55. package/lib/runtime/model-fetch.js +361 -361
  56. package/lib/runtime/provision.js +237 -237
  57. package/lib/runtime/tarball.js +130 -130
  58. package/lib/runtime/verify.js +223 -204
  59. package/lib/scope.js +146 -146
  60. package/lib/search/adaptive.js +60 -60
  61. package/lib/search/bm25.js +96 -96
  62. package/lib/semantic.js +229 -229
  63. package/lib/sensitive-scan.js +209 -209
  64. package/lib/serve.js +215 -215
  65. package/lib/service.js +2663 -2605
  66. package/lib/settings.js +517 -511
  67. package/lib/store.js +3007 -3007
  68. package/lib/summarize.js +891 -856
  69. package/lib/tools.js +743 -737
  70. package/lib/vector-index.js +110 -110
  71. package/lib/version-check.js +122 -122
  72. package/lib/write-admission.js +402 -402
  73. package/locale/en.json +6 -6
  74. package/locale/zh.json +6 -6
  75. package/package.json +118 -118
  76. package/runtime-manifest.json +526 -526
  77. package/scripts/benchmark-embed.js +201 -201
  78. package/scripts/benchmark-recall.js +249 -249
  79. package/scripts/benchmark-rerank.js +166 -166
  80. package/scripts/build-runtime-manifest.mjs +224 -224
  81. package/scripts/changelog-prep.mjs +36 -36
  82. package/scripts/check-sync.js +42 -42
  83. package/scripts/e2e-dsh.js +220 -220
  84. package/scripts/mneme-runtime.mjs +277 -277
  85. package/scripts/stress-dsh.js +255 -255
  86. package/scripts/sync-lib.js +47 -47
  87. package/scripts/sync-test-badge.mjs +69 -69
  88. package/scripts/test-count-sync.mjs +44 -44
  89. package/src/api-standalone.js +673 -673
  90. package/src/api.js +1437 -1433
  91. package/src/bootstrap.js +211 -211
  92. package/src/commands.js +95 -95
  93. package/src/config.js +880 -843
  94. package/src/content-hash.js +54 -54
  95. package/src/continuity.js +220 -220
  96. package/src/document-index.js +94 -94
  97. package/src/document.js +303 -303
  98. package/src/dream/clustering.js +118 -118
  99. package/src/dream/decisions.js +674 -674
  100. package/src/dream/narratives.js +44 -44
  101. package/src/dream/sleep.js +819 -819
  102. package/src/dream.js +1501 -1501
  103. package/src/embedding.js +177 -177
  104. package/src/entities/extractor.js +252 -252
  105. package/src/graph/anchoring.js +179 -179
  106. package/src/guide.js +74 -74
  107. package/src/heat.js +144 -144
  108. package/src/hot-memory.js +46 -46
  109. package/src/index.js +535 -503
  110. package/src/inject.js +464 -450
  111. package/src/lang.js +248 -229
  112. package/src/local-embedder.js +358 -358
  113. package/src/maintenance.js +142 -142
  114. package/src/mirror.js +330 -330
  115. package/src/organize.js +450 -450
  116. package/src/peak-hours.js +117 -117
  117. package/src/placement.js +13 -0
  118. package/src/pre-inject-gate.js +340 -0
  119. package/src/quality-filter.js +126 -126
  120. package/src/recall-stats.js +175 -175
  121. package/src/reranker.js +269 -269
  122. package/src/runtime/adopt.js +176 -176
  123. package/src/runtime/closure.js +172 -172
  124. package/src/runtime/download.js +247 -247
  125. package/src/runtime/layout.js +265 -265
  126. package/src/runtime/loader.js +252 -252
  127. package/src/runtime/model-fetch.js +361 -361
  128. package/src/runtime/provision.js +237 -237
  129. package/src/runtime/tarball.js +130 -130
  130. package/src/runtime/verify.js +223 -204
  131. package/src/scope.js +146 -146
  132. package/src/search/adaptive.js +60 -60
  133. package/src/search/bm25.js +96 -96
  134. package/src/semantic.js +229 -229
  135. package/src/sensitive-scan.js +209 -209
  136. package/src/serve.js +215 -215
  137. package/src/service.js +2663 -2605
  138. package/src/settings.js +517 -511
  139. package/src/store.js +3007 -3007
  140. package/src/summarize.js +891 -856
  141. package/src/tools.js +743 -737
  142. package/src/vector-index.js +110 -110
  143. package/src/version-check.js +122 -122
  144. package/src/write-admission.js +402 -402
  145. package/test/adaptive-inject-budget.test.js +85 -85
  146. package/test/api-routes-gaps.test.js +218 -218
  147. package/test/api.test.js +1702 -1690
  148. package/test/audit.test.js +448 -448
  149. package/test/baseline-persist.test.js +248 -248
  150. package/test/benchmark.test.js +94 -94
  151. package/test/bootstrap.test.js +220 -220
  152. package/test/changelog-prep.test.js +60 -60
  153. package/test/client.test.js +1230 -1169
  154. package/test/clustering.test.js +100 -100
  155. package/test/commands.test.js +106 -106
  156. package/test/config.test.js +66 -66
  157. package/test/conflict-freeze.test.js +300 -300
  158. package/test/content-hash.test.js +204 -204
  159. package/test/continuity.test.js +333 -333
  160. package/test/document-dir.test.js +233 -233
  161. package/test/document.test.js +671 -671
  162. package/test/dream-archive-guardrail.test.js +116 -116
  163. package/test/dream-candidate-hybrid.test.js +281 -281
  164. package/test/dream-coverage-degrade.test.js +86 -86
  165. package/test/dream-failure-backoff.test.js +173 -173
  166. package/test/dream-peak-hours.test.js +194 -194
  167. package/test/dream.test.js +1385 -1383
  168. package/test/embedding-ready.test.js +196 -196
  169. package/test/entities.test.js +627 -547
  170. package/test/entity-recall.test.js +179 -179
  171. package/test/epistemic.test.js +325 -325
  172. package/test/fnew-0112.test.js +311 -311
  173. package/test/fnew-03.test.js +422 -422
  174. package/test/graph-anchoring.test.js +184 -184
  175. package/test/graph-api.test.js +175 -175
  176. package/test/graph-inject-budget.test.js +103 -103
  177. package/test/graph-passive-confirm.test.js +91 -91
  178. package/test/graph-weight-evolution.test.js +104 -104
  179. package/test/heat.test.js +175 -175
  180. package/test/helpers/dream-mock.js +82 -82
  181. package/test/helpers/peer-worker.mjs +25 -25
  182. package/test/helpers/runtime-source.js +60 -60
  183. package/test/helpers/tar-builder.js +80 -80
  184. package/test/helpers/write-admission-samples.js +308 -308
  185. package/test/hot-memory.test.js +145 -145
  186. package/test/inject-content-cap.test.js +91 -91
  187. package/test/inject-first-round-bm25.test.js +89 -89
  188. package/test/inject-heat.test.js +77 -77
  189. package/test/inject-parent-gate.test.js +106 -106
  190. package/test/inject-pools.test.js +194 -194
  191. package/test/inject-recall.test.js +105 -105
  192. package/test/inject-rotation.test.js +161 -161
  193. package/test/inject.test.js +420 -420
  194. package/test/lang.test.js +87 -87
  195. package/test/lastrunat-persist.test.js +101 -101
  196. package/test/lib-smoke.test.js +96 -96
  197. package/test/llm-audit.test.js +598 -598
  198. package/test/llm-message-source.test.js +207 -207
  199. package/test/local-embedder.test.js +292 -292
  200. package/test/maintenance.test.js +391 -391
  201. package/test/mcp-stdio.test.js +385 -385
  202. package/test/mirror-dirty.test.js +424 -424
  203. package/test/mirror-edit-digest.test.js +187 -187
  204. package/test/mirror-generation.test.js +499 -499
  205. package/test/mirror-types.test.js +208 -208
  206. package/test/mirror.test.js +249 -249
  207. package/test/narrative-bars.test.js +162 -162
  208. package/test/organize.test.js +418 -418
  209. package/test/peer-blockers.test.js +193 -193
  210. package/test/placement.test.js +36 -0
  211. package/test/policy-epoch.test.js +259 -259
  212. package/test/pre-inject-gate.test.js +434 -0
  213. package/test/quality-filter.test.js +186 -186
  214. package/test/reasoning-effort.test.js +752 -752
  215. package/test/recall-anti-update.test.js +82 -82
  216. package/test/recall-evals.test.js +253 -253
  217. package/test/recall-layer.test.js +326 -326
  218. package/test/recall-stats.test.js +189 -189
  219. package/test/receipt-chain.test.js +451 -451
  220. package/test/reflection.test.js +226 -226
  221. package/test/reindex-backfill.test.js +62 -62
  222. package/test/reranker-single-logit.test.js +73 -73
  223. package/test/reranker.test.js +197 -197
  224. package/test/resident-status.test.js +83 -83
  225. package/test/runtime-adopt.test.js +206 -206
  226. package/test/runtime-cli.test.js +89 -89
  227. package/test/runtime-closure.test.js +193 -193
  228. package/test/runtime-download.test.js +302 -302
  229. package/test/runtime-layout.test.js +163 -163
  230. package/test/runtime-loader.test.js +255 -255
  231. package/test/runtime-manifest.test.js +159 -159
  232. package/test/runtime-model-fetch.test.js +348 -348
  233. package/test/runtime-provision.test.js +101 -101
  234. package/test/runtime-tarball.test.js +81 -81
  235. package/test/runtime-verify.test.js +319 -279
  236. package/test/scope-candidates.test.js +239 -239
  237. package/test/scope-explicit.test.js +452 -452
  238. package/test/scope-inject-soft.test.js +106 -106
  239. package/test/scope-retrieval.test.js +197 -197
  240. package/test/scope-storage.test.js +255 -255
  241. package/test/scope-strict.test.js +367 -367
  242. package/test/search-fusion.test.js +90 -90
  243. package/test/semantic.test.js +124 -124
  244. package/test/sensitive-scan.test.js +207 -207
  245. package/test/serve-bin.test.js +121 -121
  246. package/test/serve.test.js +196 -196
  247. package/test/service-search.test.js +174 -174
  248. package/test/service.test.js +405 -405
  249. package/test/settings.test.js +261 -261
  250. package/test/skip-invalid-restore.test.js +262 -262
  251. package/test/sleep-action-set.test.js +422 -422
  252. package/test/sleep-heat.test.js +126 -126
  253. package/test/sleep-scheduler-rearm.test.js +89 -89
  254. package/test/sleep.test.js +527 -527
  255. package/test/standalone-api.test.js +751 -751
  256. package/test/store-vector-cache.test.js +98 -98
  257. package/test/store.test.js +396 -396
  258. package/test/stress.test.js +209 -209
  259. package/test/summarize-occurred-at.test.js +127 -0
  260. package/test/summarize-reasoning-effort.test.js +189 -189
  261. package/test/summarize.test.js +1465 -1465
  262. package/test/supersede-state-tracking.test.js +394 -0
  263. package/test/test-count-sync.test.js +60 -60
  264. package/test/tools-dto-schema-matrix.test.js +325 -325
  265. package/test/tools-memory-get-schema.test.js +65 -65
  266. package/test/tools.test.js +428 -374
  267. package/test/updated-at-semantics.test.js +113 -113
  268. package/test/vector-index.test.js +221 -221
  269. package/test/version-check.test.js +152 -152
  270. package/test/webServer-optional.test.js +82 -82
  271. package/test/write-admission.test.js +668 -668
@@ -1,220 +1,220 @@
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
- // 硬编码精确数会随插件演进过时(v0.7 起已有 8 工具 / 26+ 路由,早期写死的
108
- // 7/14 导致新旧 dsh 上 e2e 都误报失败);改用「下限」检查 + 打印实际数量。
109
- checks.push(["注册 ≥7 个模型工具", registeredTools.length >= 7]);
110
- checks.push(["注册 2 个注入上下文", injectContexts.length === 2 && injectContexts[0].name === "memory"]);
111
- // prefix fallback(/api/dsh-mneme → 404)是兜底,不计入路由数。
112
- checks.push(["注册 ≥14 条 API 路由", apiRoutes.filter((r) => r.kind === "exact").length >= 14]);
113
- for (const [label, ok] of checks) console.log(` ${ok ? "✅" : "❌"} ${label}`);
114
- if (!checks.every(([, ok]) => ok)) { console.log("\n装载检查失败,中止。"); process.exit(1); }
115
- console.log(` 工具(${registeredTools.length}):${registeredTools.map((t) => t.name).join(", ")}`);
116
- console.log(` exact 路由:${apiRoutes.filter((r) => r.kind === "exact").length} 条\n`);
117
-
118
- // 2. 保存记忆(工具执行)
119
- console.log("【2】memory_save 保存记忆");
120
- const saves = [];
121
- saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流", importance: 5 }));
122
- saves.push(await tool("memory_save").execute({ type: "preference", title: "工作时段", content: "9-18 点在线,上午深度工作", importance: 4 }));
123
- saves.push(await tool("memory_save").execute({ type: "preference", title: "工作习惯", content: "习惯上午处理复杂任务", importance: 3 }));
124
- saves.push(await tool("memory_save").execute({ type: "project", title: "记忆插件", content: "dsh-mneme 用 SQLite + Markdown 镜像", importance: 4 }));
125
- saves.push(await tool("memory_save").execute({ type: "decision", title: "存储选型", content: "确定使用 node:sqlite", importance: 5 }));
126
- // 同标题再存一次 → 应触发去重合并
127
- saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流,偶尔英文", importance: 5 }));
128
- for (const s of saves) console.log(` memory ${s.action}: ${s.id}`);
129
- console.log(" 同标题二次保存 → 触发 merge ✓\n");
130
-
131
- // 3. 搜索
132
- console.log("【3】memory_search / memory_list");
133
- const search = await tool("memory_search").execute({ query: "SQLite" });
134
- console.log(` 搜索 "SQLite" → ${search.items.length} 条`);
135
- const list = await tool("memory_list").execute({ type: "preference" });
136
- console.log(` preference 共 ${list.total} 条\n`);
137
-
138
- // 4. 上下文注入
139
- console.log("【4】自动注入(新会话上下文)");
140
- const injected = injectContexts[0].text({});
141
- console.log(injected ? ` ${injected.split("\n").filter(Boolean).map((l) => " " + l).join("\n")}` : " (空)");
142
- console.log("");
143
-
144
- // 5. 会话摘要(turn/end 事件)
145
- console.log("【5】会话摘要(模拟 turn/end)");
146
- const session = {
147
- id: "e2e-session-1",
148
- events: [
149
- { type: "user/message", data: { source: { kind: "user" }, content: [{ type: "text", text: "我偏好中文交流,以后都用中文。" }] } }
150
- ],
151
- requestHeader() { return { config: { provider: "mock", model: "mock-model" } }; }
152
- };
153
- await ctx.emit("session/event", session, { type: "turn/end" });
154
- await sleep(50);
155
- const afterSummary = await tool("memory_search").execute({ query: "中文交流" });
156
- console.log(` 摘要入库:${afterSummary.items.length} 条命中(source: session)\n`);
157
-
158
- // 6. autoDream
159
- console.log("【6】autoDream(阈值触发 → LLM 决策 → merge + 摘要)");
160
- console.log(" 等待调度器触发(delay 80ms)…");
161
- await sleep(400);
162
- const injectedAfter = injectContexts[0].text({});
163
- const hasSummary = injectedAfter.includes("记忆库总览");
164
- console.log(` 注入中出现"记忆库总览":${hasSummary ? "是 ✅" : "否 ❌"}`);
165
- const prefs = await tool("memory_list").execute({ type: "preference" });
166
- console.log(` dream merge 后 preference 条目:${prefs.items.length}(dream 时 4 条相近项,merge 成 1 条)`);
167
-
168
- // 7. Web API 模拟调用
169
- console.log("\n【7】Web 面板 API(/api/dsh-mneme/list)");
170
- const listRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/list");
171
- const res = { writeHead(code, h) { this.statusCode = code; this.headers = h; return this; }, end(body) { this.body = body; } };
172
- await listRoute.handler({ url: "/api/dsh-mneme/list?type=project" }, res);
173
- const payload = JSON.parse(res.body);
174
- console.log(` HTTP ${res.statusCode},project 条目 ${payload.items.length} 条\n`);
175
-
176
- // 8. 用户画像 / 规则 / 自定义命令
177
- console.log("【8】用户画像 / 规则 / 自定义命令");
178
- function apiReq(path, method = "GET", body = null) {
179
- const listeners = {};
180
- const r = {
181
- url: path, method, headers: {},
182
- on(ev, fn) { listeners[ev] = fn; return r; },
183
- emit(ev, data) { listeners[ev]?.(data); return r; }
184
- };
185
- if (body !== null) {
186
- process.nextTick(() => { r.emit("data", Buffer.from(JSON.stringify(body))); r.emit("end"); });
187
- }
188
- return r;
189
- }
190
- function apiRes() { return { statusCode: 0, body: "", writeHead(code) { this.statusCode = code; return this; }, end(body) { this.body = body; } }; }
191
-
192
- const profileRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/profile");
193
- const rp = apiRes();
194
- await profileRoute.handler(apiReq("/api/dsh-mneme/profile", "PUT", { profile: "我是后端开发者,擅长 Node.js" }), rp);
195
- const rulesRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/rules");
196
- const rr = apiRes();
197
- await rulesRoute.handler(apiReq("/api/dsh-mneme/rules", "PUT", { rules: ["回答时先给结论", "使用简体中文"] }), rr);
198
- const userSettings = injectContexts.find((c) => c.name === "user-settings").text({});
199
- console.log(` 注入含用户画像:${userSettings.includes("后端开发者") ? "✅" : "❌"}`);
200
- console.log(` 注入含规则:${userSettings.includes("先给结论") ? "✅" : "❌"}`);
201
- const cmdRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/commands");
202
- const rc = apiRes();
203
- await cmdRoute.handler(apiReq("/api/dsh-mneme/commands", "POST", { name: "review", description: "审查代码", instruction: "请按项目规范审查当前代码" }), rc);
204
- const cmdRegistered = registeredCommands.has("review");
205
- console.log(` 自定义命令 /review 已注册:${cmdRegistered ? "✅" : "❌"}`);
206
- if (cmdRegistered) {
207
- const handler = registeredCommands.get("review").handler;
208
- const result = await handler({ agent: {}, rawInput: "", signal: null });
209
- console.log(` 命令触发返回:${result.text.slice(0, 24)}…`);
210
- }
211
- console.log("");
212
-
213
- // ---------------------------------------------------------------- 汇总
214
- console.log("══════ 汇总 ══════");
215
- console.log(` LLM 调用:${llmCalls.join(" → ")}`);
216
- console.log(` 记忆文件:${memDir}`);
217
- const all = await tool("memory_list").execute({});
218
- console.log(` 当前可注入条目:${all.total}`);
219
- console.log("══════ 演示结束 ══════");
220
- 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
+ // 硬编码精确数会随插件演进过时(v0.7 起已有 8 工具 / 26+ 路由,早期写死的
108
+ // 7/14 导致新旧 dsh 上 e2e 都误报失败);改用「下限」检查 + 打印实际数量。
109
+ checks.push(["注册 ≥7 个模型工具", registeredTools.length >= 7]);
110
+ checks.push(["注册 2 个注入上下文", injectContexts.length === 2 && injectContexts[0].name === "memory"]);
111
+ // prefix fallback(/api/dsh-mneme → 404)是兜底,不计入路由数。
112
+ checks.push(["注册 ≥14 条 API 路由", apiRoutes.filter((r) => r.kind === "exact").length >= 14]);
113
+ for (const [label, ok] of checks) console.log(` ${ok ? "✅" : "❌"} ${label}`);
114
+ if (!checks.every(([, ok]) => ok)) { console.log("\n装载检查失败,中止。"); process.exit(1); }
115
+ console.log(` 工具(${registeredTools.length}):${registeredTools.map((t) => t.name).join(", ")}`);
116
+ console.log(` exact 路由:${apiRoutes.filter((r) => r.kind === "exact").length} 条\n`);
117
+
118
+ // 2. 保存记忆(工具执行)
119
+ console.log("【2】memory_save 保存记忆");
120
+ const saves = [];
121
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流", importance: 5 }));
122
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "工作时段", content: "9-18 点在线,上午深度工作", importance: 4 }));
123
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "工作习惯", content: "习惯上午处理复杂任务", importance: 3 }));
124
+ saves.push(await tool("memory_save").execute({ type: "project", title: "记忆插件", content: "dsh-mneme 用 SQLite + Markdown 镜像", importance: 4 }));
125
+ saves.push(await tool("memory_save").execute({ type: "decision", title: "存储选型", content: "确定使用 node:sqlite", importance: 5 }));
126
+ // 同标题再存一次 → 应触发去重合并
127
+ saves.push(await tool("memory_save").execute({ type: "preference", title: "语言", content: "用户用中文交流,偶尔英文", importance: 5 }));
128
+ for (const s of saves) console.log(` memory ${s.action}: ${s.id}`);
129
+ console.log(" 同标题二次保存 → 触发 merge ✓\n");
130
+
131
+ // 3. 搜索
132
+ console.log("【3】memory_search / memory_list");
133
+ const search = await tool("memory_search").execute({ query: "SQLite" });
134
+ console.log(` 搜索 "SQLite" → ${search.items.length} 条`);
135
+ const list = await tool("memory_list").execute({ type: "preference" });
136
+ console.log(` preference 共 ${list.total} 条\n`);
137
+
138
+ // 4. 上下文注入
139
+ console.log("【4】自动注入(新会话上下文)");
140
+ const injected = injectContexts[0].text({});
141
+ console.log(injected ? ` ${injected.split("\n").filter(Boolean).map((l) => " " + l).join("\n")}` : " (空)");
142
+ console.log("");
143
+
144
+ // 5. 会话摘要(turn/end 事件)
145
+ console.log("【5】会话摘要(模拟 turn/end)");
146
+ const session = {
147
+ id: "e2e-session-1",
148
+ events: [
149
+ { type: "user/message", data: { source: { kind: "user" }, content: [{ type: "text", text: "我偏好中文交流,以后都用中文。" }] } }
150
+ ],
151
+ requestHeader() { return { config: { provider: "mock", model: "mock-model" } }; }
152
+ };
153
+ await ctx.emit("session/event", session, { type: "turn/end" });
154
+ await sleep(50);
155
+ const afterSummary = await tool("memory_search").execute({ query: "中文交流" });
156
+ console.log(` 摘要入库:${afterSummary.items.length} 条命中(source: session)\n`);
157
+
158
+ // 6. autoDream
159
+ console.log("【6】autoDream(阈值触发 → LLM 决策 → merge + 摘要)");
160
+ console.log(" 等待调度器触发(delay 80ms)…");
161
+ await sleep(400);
162
+ const injectedAfter = injectContexts[0].text({});
163
+ const hasSummary = injectedAfter.includes("记忆库总览");
164
+ console.log(` 注入中出现"记忆库总览":${hasSummary ? "是 ✅" : "否 ❌"}`);
165
+ const prefs = await tool("memory_list").execute({ type: "preference" });
166
+ console.log(` dream merge 后 preference 条目:${prefs.items.length}(dream 时 4 条相近项,merge 成 1 条)`);
167
+
168
+ // 7. Web API 模拟调用
169
+ console.log("\n【7】Web 面板 API(/api/dsh-mneme/list)");
170
+ const listRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/list");
171
+ const res = { writeHead(code, h) { this.statusCode = code; this.headers = h; return this; }, end(body) { this.body = body; } };
172
+ await listRoute.handler({ url: "/api/dsh-mneme/list?type=project" }, res);
173
+ const payload = JSON.parse(res.body);
174
+ console.log(` HTTP ${res.statusCode},project 条目 ${payload.items.length} 条\n`);
175
+
176
+ // 8. 用户画像 / 规则 / 自定义命令
177
+ console.log("【8】用户画像 / 规则 / 自定义命令");
178
+ function apiReq(path, method = "GET", body = null) {
179
+ const listeners = {};
180
+ const r = {
181
+ url: path, method, headers: {},
182
+ on(ev, fn) { listeners[ev] = fn; return r; },
183
+ emit(ev, data) { listeners[ev]?.(data); return r; }
184
+ };
185
+ if (body !== null) {
186
+ process.nextTick(() => { r.emit("data", Buffer.from(JSON.stringify(body))); r.emit("end"); });
187
+ }
188
+ return r;
189
+ }
190
+ function apiRes() { return { statusCode: 0, body: "", writeHead(code) { this.statusCode = code; return this; }, end(body) { this.body = body; } }; }
191
+
192
+ const profileRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/profile");
193
+ const rp = apiRes();
194
+ await profileRoute.handler(apiReq("/api/dsh-mneme/profile", "PUT", { profile: "我是后端开发者,擅长 Node.js" }), rp);
195
+ const rulesRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/rules");
196
+ const rr = apiRes();
197
+ await rulesRoute.handler(apiReq("/api/dsh-mneme/rules", "PUT", { rules: ["回答时先给结论", "使用简体中文"] }), rr);
198
+ const userSettings = injectContexts.find((c) => c.name === "user-settings").text({});
199
+ console.log(` 注入含用户画像:${userSettings.includes("后端开发者") ? "✅" : "❌"}`);
200
+ console.log(` 注入含规则:${userSettings.includes("先给结论") ? "✅" : "❌"}`);
201
+ const cmdRoute = apiRoutes.find((r) => r.path === "/api/dsh-mneme/commands");
202
+ const rc = apiRes();
203
+ await cmdRoute.handler(apiReq("/api/dsh-mneme/commands", "POST", { name: "review", description: "审查代码", instruction: "请按项目规范审查当前代码" }), rc);
204
+ const cmdRegistered = registeredCommands.has("review");
205
+ console.log(` 自定义命令 /review 已注册:${cmdRegistered ? "✅" : "❌"}`);
206
+ if (cmdRegistered) {
207
+ const handler = registeredCommands.get("review").handler;
208
+ const result = await handler({ agent: {}, rawInput: "", signal: null });
209
+ console.log(` 命令触发返回:${result.text.slice(0, 24)}…`);
210
+ }
211
+ console.log("");
212
+
213
+ // ---------------------------------------------------------------- 汇总
214
+ console.log("══════ 汇总 ══════");
215
+ console.log(` LLM 调用:${llmCalls.join(" → ")}`);
216
+ console.log(` 记忆文件:${memDir}`);
217
+ const all = await tool("memory_list").execute({});
218
+ console.log(` 当前可注入条目:${all.total}`);
219
+ console.log("══════ 演示结束 ══════");
220
+ fiber.dispose?.();