@modusensus/dsh-mneme 0.8.14 → 0.8.16

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 (279) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +660 -654
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +691 -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 +275 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/DISTILL.md +162 -0
  12. package/docs/ENTITIES.md +245 -0
  13. package/docs/LOCAL_MODEL.md +222 -0
  14. package/docs/SEMANTIC.md +256 -0
  15. package/docs/SLEEP.md +164 -0
  16. package/docs/STORAGE.md +98 -0
  17. package/lib/api-standalone.js +656 -673
  18. package/lib/api.js +1605 -1433
  19. package/lib/bootstrap.js +211 -211
  20. package/lib/client.js +6354 -5296
  21. package/lib/commands.js +95 -95
  22. package/lib/config.js +947 -843
  23. package/lib/content-hash.js +54 -54
  24. package/lib/continuity.js +220 -220
  25. package/lib/document-index.js +94 -94
  26. package/lib/document.js +303 -303
  27. package/lib/dream/clustering.js +118 -118
  28. package/lib/dream/decisions.js +694 -674
  29. package/lib/dream/narratives.js +44 -44
  30. package/lib/dream/sleep.js +819 -819
  31. package/lib/dream.js +1503 -1501
  32. package/lib/embedding.js +177 -177
  33. package/lib/entities/extractor.js +252 -252
  34. package/lib/graph/anchoring.js +179 -179
  35. package/lib/guide.js +74 -74
  36. package/lib/heat.js +144 -144
  37. package/lib/hot-memory.js +108 -46
  38. package/lib/index.js +552 -503
  39. package/lib/inject.js +428 -450
  40. package/lib/lang.js +248 -229
  41. package/lib/local-embedder.js +358 -358
  42. package/lib/maintenance.js +162 -142
  43. package/lib/mirror.js +330 -330
  44. package/lib/organize.js +450 -450
  45. package/lib/peak-hours.js +117 -117
  46. package/lib/placement.js +13 -0
  47. package/lib/pre-inject-gate.js +340 -0
  48. package/lib/quality-filter.js +126 -126
  49. package/lib/recall-stats.js +190 -175
  50. package/lib/reclaim-http.js +150 -0
  51. package/lib/reranker.js +269 -269
  52. package/lib/runtime/adopt.js +176 -176
  53. package/lib/runtime/closure.js +172 -172
  54. package/lib/runtime/download.js +247 -247
  55. package/lib/runtime/layout.js +265 -265
  56. package/lib/runtime/loader.js +252 -252
  57. package/lib/runtime/model-fetch.js +361 -361
  58. package/lib/runtime/provision.js +237 -237
  59. package/lib/runtime/tarball.js +130 -130
  60. package/lib/runtime/verify.js +223 -204
  61. package/lib/safe-slice.js +18 -0
  62. package/lib/scope.js +146 -146
  63. package/lib/search/adaptive.js +60 -60
  64. package/lib/search/bm25.js +96 -96
  65. package/lib/semantic.js +229 -229
  66. package/lib/sensitive-scan.js +209 -209
  67. package/lib/serve.js +215 -215
  68. package/lib/service.js +2688 -2605
  69. package/lib/settings.js +528 -511
  70. package/lib/store.js +3196 -3007
  71. package/lib/summarize.js +1039 -856
  72. package/lib/tools.js +743 -737
  73. package/lib/vector-index.js +110 -110
  74. package/lib/version-check.js +122 -122
  75. package/lib/write-admission.js +402 -402
  76. package/locale/en.json +6 -6
  77. package/locale/zh.json +6 -6
  78. package/package.json +118 -118
  79. package/runtime-manifest.json +526 -526
  80. package/scripts/benchmark-embed.js +201 -201
  81. package/scripts/benchmark-recall.js +249 -249
  82. package/scripts/benchmark-rerank.js +166 -166
  83. package/scripts/build-runtime-manifest.mjs +224 -224
  84. package/scripts/changelog-prep.mjs +36 -36
  85. package/scripts/check-sync.js +42 -42
  86. package/scripts/e2e-dsh.js +220 -220
  87. package/scripts/mneme-runtime.mjs +277 -277
  88. package/scripts/stress-dsh.js +255 -255
  89. package/scripts/sync-lib.js +47 -47
  90. package/scripts/sync-test-badge.mjs +69 -69
  91. package/scripts/test-count-sync.mjs +44 -44
  92. package/src/api-standalone.js +656 -673
  93. package/src/api.js +1605 -1433
  94. package/src/bootstrap.js +211 -211
  95. package/src/commands.js +95 -95
  96. package/src/config.js +947 -843
  97. package/src/content-hash.js +54 -54
  98. package/src/continuity.js +220 -220
  99. package/src/document-index.js +94 -94
  100. package/src/document.js +303 -303
  101. package/src/dream/clustering.js +118 -118
  102. package/src/dream/decisions.js +694 -674
  103. package/src/dream/narratives.js +44 -44
  104. package/src/dream/sleep.js +819 -819
  105. package/src/dream.js +1503 -1501
  106. package/src/embedding.js +177 -177
  107. package/src/entities/extractor.js +252 -252
  108. package/src/graph/anchoring.js +179 -179
  109. package/src/guide.js +74 -74
  110. package/src/heat.js +144 -144
  111. package/src/hot-memory.js +108 -46
  112. package/src/index.js +552 -503
  113. package/src/inject.js +428 -450
  114. package/src/lang.js +248 -229
  115. package/src/local-embedder.js +358 -358
  116. package/src/maintenance.js +162 -142
  117. package/src/mirror.js +330 -330
  118. package/src/organize.js +450 -450
  119. package/src/peak-hours.js +117 -117
  120. package/src/placement.js +13 -0
  121. package/src/pre-inject-gate.js +340 -0
  122. package/src/quality-filter.js +126 -126
  123. package/src/recall-stats.js +190 -175
  124. package/src/reclaim-http.js +150 -0
  125. package/src/reranker.js +269 -269
  126. package/src/runtime/adopt.js +176 -176
  127. package/src/runtime/closure.js +172 -172
  128. package/src/runtime/download.js +247 -247
  129. package/src/runtime/layout.js +265 -265
  130. package/src/runtime/loader.js +252 -252
  131. package/src/runtime/model-fetch.js +361 -361
  132. package/src/runtime/provision.js +237 -237
  133. package/src/runtime/tarball.js +130 -130
  134. package/src/runtime/verify.js +223 -204
  135. package/src/safe-slice.js +18 -0
  136. package/src/scope.js +146 -146
  137. package/src/search/adaptive.js +60 -60
  138. package/src/search/bm25.js +96 -96
  139. package/src/semantic.js +229 -229
  140. package/src/sensitive-scan.js +209 -209
  141. package/src/serve.js +215 -215
  142. package/src/service.js +2688 -2605
  143. package/src/settings.js +528 -511
  144. package/src/store.js +3196 -3007
  145. package/src/summarize.js +1039 -856
  146. package/src/tools.js +743 -737
  147. package/src/vector-index.js +110 -110
  148. package/src/version-check.js +122 -122
  149. package/src/write-admission.js +402 -402
  150. package/test/adaptive-inject-budget.test.js +85 -85
  151. package/test/api-routes-gaps.test.js +899 -218
  152. package/test/api.test.js +1725 -1690
  153. package/test/audit.test.js +448 -448
  154. package/test/baseline-persist.test.js +248 -248
  155. package/test/benchmark.test.js +94 -94
  156. package/test/bootstrap.test.js +220 -220
  157. package/test/changelog-prep.test.js +60 -60
  158. package/test/client.test.js +1582 -1169
  159. package/test/clustering.test.js +100 -100
  160. package/test/commands.test.js +106 -106
  161. package/test/config.test.js +66 -66
  162. package/test/conflict-freeze.test.js +300 -300
  163. package/test/content-hash.test.js +204 -204
  164. package/test/continuity.test.js +333 -333
  165. package/test/contrast.test.js +314 -0
  166. package/test/document-dir.test.js +233 -233
  167. package/test/document.test.js +671 -671
  168. package/test/dream-archive-guardrail.test.js +116 -116
  169. package/test/dream-candidate-hybrid.test.js +281 -281
  170. package/test/dream-coverage-degrade.test.js +86 -86
  171. package/test/dream-failure-backoff.test.js +173 -173
  172. package/test/dream-merge-guardrail.test.js +219 -0
  173. package/test/dream-peak-hours.test.js +194 -194
  174. package/test/dream.test.js +1385 -1383
  175. package/test/embedding-ready.test.js +196 -196
  176. package/test/entities.test.js +627 -547
  177. package/test/entity-recall.test.js +179 -179
  178. package/test/epistemic.test.js +325 -325
  179. package/test/fnew-0112.test.js +311 -311
  180. package/test/fnew-03.test.js +422 -422
  181. package/test/graph-anchoring.test.js +184 -184
  182. package/test/graph-api.test.js +175 -175
  183. package/test/graph-inject-budget.test.js +103 -103
  184. package/test/graph-passive-confirm.test.js +91 -91
  185. package/test/graph-weight-evolution.test.js +104 -104
  186. package/test/heat.test.js +175 -175
  187. package/test/helpers/dream-mock.js +82 -82
  188. package/test/helpers/peer-worker.mjs +25 -25
  189. package/test/helpers/runtime-source.js +60 -60
  190. package/test/helpers/tar-builder.js +80 -80
  191. package/test/helpers/write-admission-samples.js +308 -308
  192. package/test/hot-memory.test.js +211 -145
  193. package/test/inject-content-cap.test.js +91 -91
  194. package/test/inject-first-round-bm25.test.js +89 -89
  195. package/test/inject-heat.test.js +77 -77
  196. package/test/inject-parent-gate.test.js +106 -106
  197. package/test/inject-pools.test.js +194 -194
  198. package/test/inject-recall.test.js +144 -105
  199. package/test/inject-rotation.test.js +161 -161
  200. package/test/inject.test.js +443 -420
  201. package/test/lang.test.js +87 -87
  202. package/test/lastrunat-persist.test.js +101 -101
  203. package/test/lib-smoke.test.js +96 -96
  204. package/test/llm-audit.test.js +696 -598
  205. package/test/llm-message-source.test.js +207 -207
  206. package/test/local-embedder.test.js +292 -292
  207. package/test/maintenance.test.js +501 -391
  208. package/test/mcp-stdio.test.js +385 -385
  209. package/test/mirror-dirty.test.js +424 -424
  210. package/test/mirror-edit-digest.test.js +187 -187
  211. package/test/mirror-generation.test.js +499 -499
  212. package/test/mirror-types.test.js +208 -208
  213. package/test/mirror.test.js +249 -249
  214. package/test/narrative-bars.test.js +162 -162
  215. package/test/organize.test.js +418 -418
  216. package/test/peer-blockers.test.js +193 -193
  217. package/test/placement.test.js +36 -0
  218. package/test/policy-epoch.test.js +259 -259
  219. package/test/pre-inject-gate.test.js +444 -0
  220. package/test/quality-filter.test.js +186 -186
  221. package/test/reasoning-effort.test.js +752 -752
  222. package/test/recall-anti-update.test.js +82 -82
  223. package/test/recall-evals.test.js +253 -253
  224. package/test/recall-layer.test.js +326 -326
  225. package/test/recall-stats.test.js +274 -189
  226. package/test/receipt-chain.test.js +451 -451
  227. package/test/reclaim-http.test.js +209 -0
  228. package/test/reflection.test.js +226 -226
  229. package/test/reindex-backfill.test.js +62 -62
  230. package/test/reranker-single-logit.test.js +73 -73
  231. package/test/reranker.test.js +197 -197
  232. package/test/resident-status.test.js +83 -83
  233. package/test/runtime-adopt.test.js +206 -206
  234. package/test/runtime-cli.test.js +89 -89
  235. package/test/runtime-closure.test.js +193 -193
  236. package/test/runtime-download.test.js +302 -302
  237. package/test/runtime-layout.test.js +163 -163
  238. package/test/runtime-loader.test.js +255 -255
  239. package/test/runtime-manifest.test.js +159 -159
  240. package/test/runtime-model-fetch.test.js +348 -348
  241. package/test/runtime-provision.test.js +101 -101
  242. package/test/runtime-tarball.test.js +81 -81
  243. package/test/runtime-verify.test.js +319 -279
  244. package/test/scope-candidates.test.js +239 -239
  245. package/test/scope-explicit.test.js +452 -452
  246. package/test/scope-inject-soft.test.js +106 -106
  247. package/test/scope-retrieval.test.js +197 -197
  248. package/test/scope-storage.test.js +255 -255
  249. package/test/scope-strict.test.js +367 -367
  250. package/test/search-fusion.test.js +90 -90
  251. package/test/semantic.test.js +124 -124
  252. package/test/sensitive-scan.test.js +207 -207
  253. package/test/serve-bin.test.js +121 -121
  254. package/test/serve.test.js +196 -196
  255. package/test/service-search.test.js +174 -174
  256. package/test/service.test.js +410 -405
  257. package/test/settings.test.js +269 -261
  258. package/test/skip-invalid-restore.test.js +262 -262
  259. package/test/sleep-action-set.test.js +422 -422
  260. package/test/sleep-heat.test.js +126 -126
  261. package/test/sleep-scheduler-rearm.test.js +89 -89
  262. package/test/sleep.test.js +527 -527
  263. package/test/standalone-api.test.js +751 -751
  264. package/test/store-vector-cache.test.js +98 -98
  265. package/test/store.test.js +504 -396
  266. package/test/stress.test.js +209 -209
  267. package/test/summarize-occurred-at.test.js +127 -0
  268. package/test/summarize-reasoning-effort.test.js +189 -189
  269. package/test/summarize.test.js +1639 -1465
  270. package/test/supersede-state-tracking.test.js +394 -0
  271. package/test/test-count-sync.test.js +60 -60
  272. package/test/tools-dto-schema-matrix.test.js +325 -325
  273. package/test/tools-memory-get-schema.test.js +65 -65
  274. package/test/tools.test.js +428 -374
  275. package/test/updated-at-semantics.test.js +113 -113
  276. package/test/vector-index.test.js +221 -221
  277. package/test/version-check.test.js +152 -152
  278. package/test/webServer-optional.test.js +82 -82
  279. 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?.();