recallnest 1.4.1

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 (261) hide show
  1. package/.claude-plugin/CLAUDE.md +29 -0
  2. package/.claude-plugin/marketplace.json +18 -0
  3. package/.env.example +3 -0
  4. package/.github/workflows/ci.yml +28 -0
  5. package/.mcp.json +9 -0
  6. package/CHANGELOG.md +51 -0
  7. package/CLAUDE.md +42 -0
  8. package/DEMO.md +94 -0
  9. package/EVAL.md +89 -0
  10. package/FAILURES.md +75 -0
  11. package/LICENSE +21 -0
  12. package/OPERATIONS.md +59 -0
  13. package/README.md +427 -0
  14. package/README_CN.md +425 -0
  15. package/ROADMAP.md +198 -0
  16. package/assets/recallnest-workbench.png +0 -0
  17. package/assets/ui/app.js +807 -0
  18. package/assets/ui/index.html +154 -0
  19. package/assets/ui/styles.css +605 -0
  20. package/assets/wechat-qr.jpg +0 -0
  21. package/config.json.example +38 -0
  22. package/daily-recall.sh +87 -0
  23. package/daily-reflections/2026-03-05.md +15 -0
  24. package/daily-reflections/2026-03-06.md +15 -0
  25. package/daily-reflections/2026-03-07.md +7 -0
  26. package/daily-reflections/2026-03-08.md +34 -0
  27. package/daily-reflections/2026-03-09.md +35 -0
  28. package/daily-reflections/2026-03-10.md +36 -0
  29. package/daily-reflections/2026-03-11.md +35 -0
  30. package/daily-reflections/2026-03-12.md +36 -0
  31. package/daily-reflections/2026-03-13.md +35 -0
  32. package/daily-reflections/2026-03-14.md +35 -0
  33. package/daily-reflections/2026-03-15.md +35 -0
  34. package/daily-reflections/2026-03-16.md +41 -0
  35. package/daily-reflections/2026-03-17.md +10 -0
  36. package/daily-reflections/2026-03-18.md +10 -0
  37. package/daily-reflections/2026-03-19.md +10 -0
  38. package/daily-reflections/2026-03-20.md +10 -0
  39. package/daily-reflections/2026-03-21.md +10 -0
  40. package/daily-reflections/2026-03-22.md +10 -0
  41. package/daily-reflections/2026-03-23.md +10 -0
  42. package/daily-reflections/2026-03-24.md +10 -0
  43. package/daily-reflections/2026-03-25.md +32 -0
  44. package/daily-reflections/2026-03-26.md +37 -0
  45. package/daily-reflections/2026-03-27.md +35 -0
  46. package/daily-reflections/2026-03-28.md +35 -0
  47. package/daily-reflections/2026-03-29.md +35 -0
  48. package/daily-reflections/2026-03-30.md +36 -0
  49. package/daily-reflections/2026-03-31.md +35 -0
  50. package/daily-reflections/2026-04-01.md +35 -0
  51. package/docs/api-reference.md +1291 -0
  52. package/docs/architecture.md +168 -0
  53. package/docs/memory-boundary-contract.md +226 -0
  54. package/docs/memory-categories.md +119 -0
  55. package/docs/pipeline-audit-ultramemory.md +177 -0
  56. package/docs/plans/2026-03-08-query-expansion.md +270 -0
  57. package/docs/plans/2026-03-16-continuity-layer.md +196 -0
  58. package/docs/plans/mcp-tiering-plan.md +126 -0
  59. package/docs/research/recall-quality-audit-2026-03-22.md +153 -0
  60. package/docs/self-evolution.md +198 -0
  61. package/docs/superpowers/plans/2026-03-19-ingest-pipeline-upgrade.md +782 -0
  62. package/docs/superpowers/specs/2026-03-19-ingest-pipeline-upgrade-design.md +77 -0
  63. package/docs/superpowers/specs/2026-03-23-pull-claude-desktop-design.md +95 -0
  64. package/eval/cases.json +85 -0
  65. package/eval/continuity/case-seeds.json +90 -0
  66. package/eval/continuity/cases.json +302 -0
  67. package/eval/continuity/memory-seeds.json +26 -0
  68. package/eval/continuity/pattern-seeds.json +100 -0
  69. package/eval/continuity/results-2026-03-16.md +117 -0
  70. package/eval/continuity/results-2026-03-19.md +453 -0
  71. package/eval/continuity/runbook.md +110 -0
  72. package/eval/continuity/seed-cases.md +54 -0
  73. package/eval/reports/2026-03-06-abstract-query-baseline.md +96 -0
  74. package/eval/reports/2026-03-06-aws-ssh-baseline.md +82 -0
  75. package/eval/reports/2026-03-06-baseline.md +82 -0
  76. package/eval/reports/query-expansion.md +138 -0
  77. package/integrations/README.md +57 -0
  78. package/integrations/claude-code/README.md +133 -0
  79. package/integrations/claude-code/claude-md-snippet.md +31 -0
  80. package/integrations/claude-code/setup.sh +66 -0
  81. package/integrations/claude-code/smoke-continuity.sh +452 -0
  82. package/integrations/codex/README.md +49 -0
  83. package/integrations/codex/agents-md-snippet.md +31 -0
  84. package/integrations/codex/setup.sh +58 -0
  85. package/integrations/examples/claude-agent-sdk/memory-agent.ts +182 -0
  86. package/integrations/examples/langchain/memory-chain.py +111 -0
  87. package/integrations/examples/openai-agents-sdk/memory-agent.py +109 -0
  88. package/integrations/gemini-cli/README.md +57 -0
  89. package/integrations/gemini-cli/gemini-md-snippet.md +31 -0
  90. package/integrations/gemini-cli/setup.sh +64 -0
  91. package/integrations/shared/install-managed-block.sh +51 -0
  92. package/lm +19 -0
  93. package/package.json +50 -0
  94. package/plan-v1.2-distributable.md +105 -0
  95. package/scripts/archive-distilled-junk.ts +116 -0
  96. package/scripts/backfill-l0l1l2.ts +98 -0
  97. package/scripts/blind-scan.ts +588 -0
  98. package/scripts/cleanup-step1-exact-dups.ts +117 -0
  99. package/scripts/cleanup-step2-template-dups.ts +113 -0
  100. package/scripts/cleanup-step3-stale-content.ts +149 -0
  101. package/scripts/cleanup-step4-orphan-scopes.ts +131 -0
  102. package/scripts/delete-distilled-junk.ts +88 -0
  103. package/scripts/distill-facts.ts +305 -0
  104. package/scripts/health-check.ts +343 -0
  105. package/scripts/incremental-ingest.sh +71 -0
  106. package/scripts/mlp-health-check.ts +382 -0
  107. package/scripts/pull-claude-desktop.ts +515 -0
  108. package/scripts/re-ingest-cc.sh +66 -0
  109. package/scripts/rebalance-memory-health.ts +181 -0
  110. package/scripts/run-desktop-ingest.sh +11 -0
  111. package/scripts/start-server.sh +12 -0
  112. package/scripts/viz-dashboard.html +423 -0
  113. package/scripts/viz-export.ts +703 -0
  114. package/src/__tests__/access-tracker-novelty.test.ts +228 -0
  115. package/src/__tests__/auto-consolidation.test.ts +168 -0
  116. package/src/__tests__/auto-recall.test.ts +131 -0
  117. package/src/__tests__/batch-dedup.test.ts +65 -0
  118. package/src/__tests__/capture-engine.test.ts +1142 -0
  119. package/src/__tests__/capture-heuristic.test.ts +171 -0
  120. package/src/__tests__/cascade-forget.test.ts +210 -0
  121. package/src/__tests__/category-min-scores.test.ts +33 -0
  122. package/src/__tests__/confidence-tracker.test.ts +196 -0
  123. package/src/__tests__/conflict-advisor.test.ts +206 -0
  124. package/src/__tests__/conflict-escalation.test.ts +149 -0
  125. package/src/__tests__/conflict-lifecycle.test.ts +83 -0
  126. package/src/__tests__/conflict-output.test.ts +85 -0
  127. package/src/__tests__/conflict-store.test.ts +374 -0
  128. package/src/__tests__/consolidation-engine.test.ts +181 -0
  129. package/src/__tests__/context-composer-pins.test.ts +64 -0
  130. package/src/__tests__/context-composer-task-selection.test.ts +24 -0
  131. package/src/__tests__/context-renderer.test.ts +91 -0
  132. package/src/__tests__/continuity-eval.test.ts +275 -0
  133. package/src/__tests__/continuity-schema.test.ts +97 -0
  134. package/src/__tests__/core-recall-eval.test.ts +235 -0
  135. package/src/__tests__/core-summary.test.ts +109 -0
  136. package/src/__tests__/dedup-actions.test.ts +58 -0
  137. package/src/__tests__/deterministic-id.test.ts +39 -0
  138. package/src/__tests__/doctor.test.ts +303 -0
  139. package/src/__tests__/drill-down.test.ts +108 -0
  140. package/src/__tests__/embedder.test.ts +122 -0
  141. package/src/__tests__/entity-resolver.test.ts +58 -0
  142. package/src/__tests__/event-segmenter.test.ts +153 -0
  143. package/src/__tests__/hotness-blend.test.ts +76 -0
  144. package/src/__tests__/ingest.test.ts +360 -0
  145. package/src/__tests__/kg-extractor.test.ts +184 -0
  146. package/src/__tests__/kg-store.test.ts +198 -0
  147. package/src/__tests__/llm-consolidation.test.ts +226 -0
  148. package/src/__tests__/memory-boundaries.test.ts +237 -0
  149. package/src/__tests__/memory-health-rebalance.test.ts +144 -0
  150. package/src/__tests__/memory-output.test.ts +215 -0
  151. package/src/__tests__/multi-vector.test.ts +242 -0
  152. package/src/__tests__/ppr-traversal.test.ts +256 -0
  153. package/src/__tests__/preference-guard-smoke.test.ts +211 -0
  154. package/src/__tests__/preference-matcher.test.ts +230 -0
  155. package/src/__tests__/preference-slots.test.ts +106 -0
  156. package/src/__tests__/prospective-memory.test.ts +283 -0
  157. package/src/__tests__/query-entity-detector.test.ts +171 -0
  158. package/src/__tests__/query-expander.test.ts +34 -0
  159. package/src/__tests__/recall-mode.test.ts +64 -0
  160. package/src/__tests__/result-synthesizer.test.ts +198 -0
  161. package/src/__tests__/resume-context.test.ts +4743 -0
  162. package/src/__tests__/retrieval-trace.test.ts +213 -0
  163. package/src/__tests__/retriever-boundary-weight.test.ts +136 -0
  164. package/src/__tests__/retroactive-boost.test.ts +223 -0
  165. package/src/__tests__/scope-inventory.test.ts +200 -0
  166. package/src/__tests__/scope-policy.test.ts +69 -0
  167. package/src/__tests__/session-checkpoint.test.ts +259 -0
  168. package/src/__tests__/session-gc.test.ts +215 -0
  169. package/src/__tests__/store-scope-audit.test.ts +81 -0
  170. package/src/__tests__/temporal-parser.test.ts +241 -0
  171. package/src/__tests__/term-registry.test.ts +121 -0
  172. package/src/__tests__/tool-output-compressor.test.ts +133 -0
  173. package/src/__tests__/version-manager.test.ts +213 -0
  174. package/src/__tests__/workflow-observation.test.ts +400 -0
  175. package/src/access-tracker.ts +316 -0
  176. package/src/adaptive-retrieval.ts +64 -0
  177. package/src/api-server.ts +667 -0
  178. package/src/asset-sync.ts +79 -0
  179. package/src/auto-consolidation.ts +133 -0
  180. package/src/auto-gc.ts +124 -0
  181. package/src/auto-recall.ts +95 -0
  182. package/src/capture-engine.ts +931 -0
  183. package/src/capture-heuristic.ts +177 -0
  184. package/src/cascade-forget.ts +135 -0
  185. package/src/chunker.ts +253 -0
  186. package/src/cli.ts +1917 -0
  187. package/src/confidence-tracker.ts +166 -0
  188. package/src/conflict-advisor.ts +433 -0
  189. package/src/conflict-engine.ts +181 -0
  190. package/src/conflict-escalation.ts +138 -0
  191. package/src/conflict-lifecycle.ts +67 -0
  192. package/src/conflict-output.ts +218 -0
  193. package/src/conflict-schema.ts +130 -0
  194. package/src/conflict-store.ts +127 -0
  195. package/src/consolidation-engine.ts +256 -0
  196. package/src/context-composer-pins.ts +183 -0
  197. package/src/context-composer-queries.ts +121 -0
  198. package/src/context-composer-scope.ts +56 -0
  199. package/src/context-composer-stable-selection.ts +200 -0
  200. package/src/context-composer-stable.ts +217 -0
  201. package/src/context-composer-task-fallbacks.ts +36 -0
  202. package/src/context-composer-task-ranking.ts +197 -0
  203. package/src/context-composer-task-results.ts +137 -0
  204. package/src/context-composer-task-selection.ts +342 -0
  205. package/src/context-composer-text.ts +57 -0
  206. package/src/context-composer.ts +300 -0
  207. package/src/context-renderer.ts +179 -0
  208. package/src/decay-engine.ts +189 -0
  209. package/src/doctor.ts +543 -0
  210. package/src/embedder.ts +557 -0
  211. package/src/entity-resolver.ts +131 -0
  212. package/src/eval.ts +632 -0
  213. package/src/event-segmenter.ts +216 -0
  214. package/src/ingest.ts +1822 -0
  215. package/src/kg-extractor.ts +217 -0
  216. package/src/kg-store.ts +353 -0
  217. package/src/legacy-scope-review.ts +53 -0
  218. package/src/llm-client.ts +629 -0
  219. package/src/llm-consolidation.ts +168 -0
  220. package/src/mcp-server.ts +1337 -0
  221. package/src/memory-assets.ts +475 -0
  222. package/src/memory-boundaries.ts +354 -0
  223. package/src/memory-health-rebalance.ts +220 -0
  224. package/src/memory-output.ts +474 -0
  225. package/src/memory-schema.ts +184 -0
  226. package/src/multi-vector.ts +234 -0
  227. package/src/noise-filter.ts +155 -0
  228. package/src/ppr-traversal.ts +279 -0
  229. package/src/preference-matcher.ts +174 -0
  230. package/src/preference-slots.ts +259 -0
  231. package/src/prospective-memory.ts +198 -0
  232. package/src/query-entity-detector.ts +207 -0
  233. package/src/query-expander.ts +98 -0
  234. package/src/result-synthesizer.ts +114 -0
  235. package/src/retrieval-profiles.ts +101 -0
  236. package/src/retrieval-trace.ts +94 -0
  237. package/src/retriever.ts +1338 -0
  238. package/src/retroactive-boost.ts +154 -0
  239. package/src/rif.ts +73 -0
  240. package/src/runtime-config.ts +172 -0
  241. package/src/schema-utils.ts +56 -0
  242. package/src/scope-inventory.ts +310 -0
  243. package/src/scope-policy.ts +142 -0
  244. package/src/session-engine.ts +168 -0
  245. package/src/session-output.ts +96 -0
  246. package/src/session-schema.ts +60 -0
  247. package/src/session-store.ts +293 -0
  248. package/src/stderr-log.ts +16 -0
  249. package/src/store.ts +903 -0
  250. package/src/temporal-parser.ts +318 -0
  251. package/src/term-registry.ts +791 -0
  252. package/src/tool-output-compressor.ts +115 -0
  253. package/src/tracker.ts +57 -0
  254. package/src/ui-server.ts +430 -0
  255. package/src/version-manager.ts +172 -0
  256. package/src/workflow-observation-engine.ts +316 -0
  257. package/src/workflow-observation-managed.ts +83 -0
  258. package/src/workflow-observation-output.ts +86 -0
  259. package/src/workflow-observation-schema.ts +87 -0
  260. package/src/workflow-observation-scope-review.ts +409 -0
  261. package/src/workflow-observation-store.ts +69 -0
@@ -0,0 +1,703 @@
1
+ /**
2
+ * 可视化数据导出 + HTML 仪表盘生成
3
+ * 模块 6:把体检数据做成交互式可视化
4
+ *
5
+ * 用法:bun run scripts/viz-export.ts [lancedb-dir]
6
+ * 输出:scripts/viz-dashboard.html(本地打开即可)
7
+ */
8
+
9
+ import lancedb from "@lancedb/lancedb";
10
+ import { writeFileSync } from "fs";
11
+ import { join, dirname } from "path";
12
+
13
+ const DB_PATH = process.argv[2] || "./data/lancedb";
14
+ const TABLE_NAME = "memories";
15
+ const OUTPUT_HTML = join(dirname(new URL(import.meta.url).pathname), "viz-dashboard.html");
16
+
17
+ interface MemoryRow {
18
+ id: string;
19
+ text: string;
20
+ vector: number[];
21
+ category: string;
22
+ scope: string;
23
+ importance: number;
24
+ timestamp: number;
25
+ metadata?: string;
26
+ }
27
+
28
+ function cosineSimilarity(a: number[], b: number[]): number {
29
+ let dot = 0, normA = 0, normB = 0;
30
+ for (let i = 0; i < a.length; i++) {
31
+ dot += a[i] * b[i];
32
+ normA += a[i] * a[i];
33
+ normB += b[i] * b[i];
34
+ }
35
+ return dot / (Math.sqrt(normA) * Math.sqrt(normB));
36
+ }
37
+
38
+ async function main() {
39
+ console.log("⏳ 读取数据...");
40
+ const db = await lancedb.connect(DB_PATH);
41
+ const table = await db.openTable(TABLE_NAME);
42
+
43
+ const allRows: MemoryRow[] = await table
44
+ .query()
45
+ .select(["id", "text", "category", "scope", "importance", "timestamp", "metadata"])
46
+ .toArray() as any;
47
+
48
+ const total = allRows.length;
49
+ console.log(`✅ ${total.toLocaleString()} 条记忆`);
50
+
51
+ const parsedRows = allRows.map(row => ({
52
+ ...row,
53
+ meta: row.metadata ? JSON.parse(row.metadata) : {},
54
+ }));
55
+
56
+ // ── Prepare visualization data ──
57
+
58
+ // 1. Category distribution
59
+ const catMap = new Map<string, number>();
60
+ for (const r of parsedRows) {
61
+ catMap.set(r.category, (catMap.get(r.category) || 0) + 1);
62
+ }
63
+ const categoryData = Object.fromEntries([...catMap.entries()].sort((a, b) => b[1] - a[1]));
64
+
65
+ // 2. Tier distribution
66
+ const tierMap = new Map<string, number>();
67
+ for (const r of parsedRows) {
68
+ const tier = r.meta.tier ?? "unknown";
69
+ tierMap.set(tier, (tierMap.get(tier) || 0) + 1);
70
+ }
71
+ const tierData = Object.fromEntries([...tierMap.entries()].sort((a, b) => b[1] - a[1]));
72
+
73
+ // 3. Monthly timeline
74
+ const monthMap = new Map<string, {total: number, cats: Record<string, number>}>();
75
+ for (const r of parsedRows) {
76
+ const month = new Date(r.timestamp).toISOString().slice(0, 7);
77
+ if (!monthMap.has(month)) monthMap.set(month, { total: 0, cats: {} });
78
+ const m = monthMap.get(month)!;
79
+ m.total++;
80
+ m.cats[r.category] = (m.cats[r.category] || 0) + 1;
81
+ }
82
+ const timelineData = Object.fromEntries([...monthMap.entries()].sort());
83
+
84
+ // 4. Daily timeline (last 90 days)
85
+ const now = Date.now();
86
+ const dayMap = new Map<string, number>();
87
+ for (const r of parsedRows) {
88
+ if (now - r.timestamp < 90 * 24 * 60 * 60 * 1000) {
89
+ const day = new Date(r.timestamp).toISOString().slice(0, 10);
90
+ dayMap.set(day, (dayMap.get(day) || 0) + 1);
91
+ }
92
+ }
93
+ const dailyData = Object.fromEntries([...dayMap.entries()].sort());
94
+
95
+ // 5. Hourly pattern
96
+ const hourData: number[] = new Array(24).fill(0);
97
+ for (const r of parsedRows) {
98
+ hourData[new Date(r.timestamp).getHours()]++;
99
+ }
100
+
101
+ // 6. Day of week
102
+ const dowData: number[] = new Array(7).fill(0);
103
+ for (const r of parsedRows) {
104
+ dowData[new Date(r.timestamp).getDay()]++;
105
+ }
106
+
107
+ // 7. Importance distribution (histogram)
108
+ const impBins = 20;
109
+ const impHist: number[] = new Array(impBins).fill(0);
110
+ for (const r of parsedRows) {
111
+ const bin = Math.min(impBins - 1, Math.floor(r.importance * impBins));
112
+ impHist[bin]++;
113
+ }
114
+
115
+ // 8. Access count distribution
116
+ const accessBuckets: Record<string, number> = {
117
+ "0 (死记忆)": 0, "1-2": 0, "3-5": 0, "6-10": 0, "11-50": 0, "50+": 0,
118
+ };
119
+ for (const r of parsedRows) {
120
+ const ac = r.meta.accessCount ?? r.meta.access_count ?? 0;
121
+ if (ac === 0) accessBuckets["0 (死记忆)"]++;
122
+ else if (ac <= 2) accessBuckets["1-2"]++;
123
+ else if (ac <= 5) accessBuckets["3-5"]++;
124
+ else if (ac <= 10) accessBuckets["6-10"]++;
125
+ else if (ac <= 50) accessBuckets["11-50"]++;
126
+ else accessBuckets["50+"]++;
127
+ }
128
+
129
+ // 9. Top scopes
130
+ const scopeMap = new Map<string, number>();
131
+ for (const r of parsedRows) {
132
+ const s = r.scope || "(empty)";
133
+ scopeMap.set(s, (scopeMap.get(s) || 0) + 1);
134
+ }
135
+ const topScopes = Object.fromEntries(
136
+ [...scopeMap.entries()].sort((a, b) => b[1] - a[1]).slice(0, 15)
137
+ );
138
+
139
+ // 10. Text length distribution
140
+ const lenBins = 30;
141
+ const maxLen = 3000; // cap for histogram
142
+ const lenHist: number[] = new Array(lenBins).fill(0);
143
+ for (const r of parsedRows) {
144
+ const bin = Math.min(lenBins - 1, Math.floor(r.text.length / maxLen * lenBins));
145
+ lenHist[bin]++;
146
+ }
147
+
148
+ // 11. Embedding 2D projection (PCA on sample)
149
+ console.log("⏳ 读取向量样本做 PCA 投影...");
150
+ const pca_sample_size = 3000;
151
+ const sampleRows: MemoryRow[] = await table
152
+ .query()
153
+ .select(["id", "text", "vector", "category", "scope", "timestamp"])
154
+ .limit(pca_sample_size)
155
+ .toArray() as any;
156
+
157
+ // Simple PCA: project onto top 2 principal components
158
+ const dim = sampleRows[0]?.vector?.length || 0;
159
+ let pcaPoints: Array<{x: number, y: number, category: string, scope: string, text: string}> = [];
160
+
161
+ if (dim > 0) {
162
+ // Compute mean
163
+ const mean = new Array(dim).fill(0);
164
+ for (const r of sampleRows) {
165
+ for (let d = 0; d < dim; d++) mean[d] += r.vector[d];
166
+ }
167
+ for (let d = 0; d < dim; d++) mean[d] /= sampleRows.length;
168
+
169
+ // Center data (vector may be Float32Array, convert to plain array)
170
+ const centered = sampleRows.map(r => {
171
+ const vec = Array.from(r.vector);
172
+ return vec.map((v, d) => v - mean[d]);
173
+ });
174
+
175
+ // Power iteration for top 2 eigenvectors
176
+ function powerIteration(data: number[][], deflateVec?: number[]): number[] {
177
+ const n = data.length;
178
+ const d = data[0].length;
179
+ let v = new Array(d).fill(0).map(() => Math.random() - 0.5);
180
+ // Normalize
181
+ let norm = Math.sqrt(v.reduce((s, x) => s + x * x, 0));
182
+ v = v.map(x => x / norm);
183
+
184
+ // If deflating, project out previous component
185
+ let dataToUse = data;
186
+ if (deflateVec) {
187
+ dataToUse = data.map(row => {
188
+ const proj = row.reduce((s, x, i) => s + x * deflateVec[i], 0);
189
+ return row.map((x, i) => x - proj * deflateVec[i]);
190
+ });
191
+ }
192
+
193
+ for (let iter = 0; iter < 50; iter++) {
194
+ // v_new = X^T * X * v
195
+ const Xv = dataToUse.map(row => row.reduce((s, x, i) => s + x * v[i], 0));
196
+ const newV = new Array(d).fill(0);
197
+ for (let i = 0; i < n; i++) {
198
+ for (let j = 0; j < d; j++) {
199
+ newV[j] += dataToUse[i][j] * Xv[i];
200
+ }
201
+ }
202
+ norm = Math.sqrt(newV.reduce((s, x) => s + x * x, 0));
203
+ v = newV.map(x => x / norm);
204
+ }
205
+ return v;
206
+ }
207
+
208
+ const pc1 = powerIteration(centered);
209
+ const pc2 = powerIteration(centered, pc1);
210
+
211
+ // Project
212
+ pcaPoints = sampleRows.map((r, i) => ({
213
+ x: centered[i].reduce((s, v, d) => s + v * pc1[d], 0),
214
+ y: centered[i].reduce((s, v, d) => s + v * pc2[d], 0),
215
+ category: r.category,
216
+ scope: (r.scope || "").slice(0, 40),
217
+ text: r.text.slice(0, 80),
218
+ }));
219
+ }
220
+
221
+ // 12. Scope × Category heatmap (top 10 scopes × all categories)
222
+ const scopeCatMatrix: Record<string, Record<string, number>> = {};
223
+ const heatmapScopes = [...scopeMap.entries()]
224
+ .sort((a, b) => b[1] - a[1])
225
+ .slice(0, 10)
226
+ .map(([s]) => s);
227
+ const allCats = [...catMap.keys()].sort();
228
+
229
+ for (const s of heatmapScopes) {
230
+ scopeCatMatrix[s] = {};
231
+ for (const c of allCats) scopeCatMatrix[s][c] = 0;
232
+ }
233
+ for (const r of parsedRows) {
234
+ const s = r.scope || "(empty)";
235
+ if (scopeCatMatrix[s]) {
236
+ scopeCatMatrix[s][r.category] = (scopeCatMatrix[s][r.category] || 0) + 1;
237
+ }
238
+ }
239
+
240
+ // ── Summary stats ──
241
+ const summaryStats = {
242
+ total,
243
+ categories: catMap.size,
244
+ scopes: scopeMap.size,
245
+ deadMemories: accessBuckets["0 (死记忆)"],
246
+ deadPct: (accessBuckets["0 (死记忆)"] / total * 100).toFixed(1),
247
+ oldest: new Date(Math.min(...parsedRows.map(r => r.timestamp))).toISOString().slice(0, 10),
248
+ newest: new Date(Math.max(...parsedRows.map(r => r.timestamp))).toISOString().slice(0, 10),
249
+ avgImportance: (parsedRows.reduce((s, r) => s + r.importance, 0) / total).toFixed(3),
250
+ };
251
+
252
+ // ── Generate HTML ──
253
+ const vizData = {
254
+ summaryStats,
255
+ categoryData,
256
+ tierData,
257
+ timelineData,
258
+ dailyData,
259
+ hourData,
260
+ dowData,
261
+ impHist,
262
+ accessBuckets,
263
+ topScopes,
264
+ lenHist,
265
+ pcaPoints,
266
+ scopeCatMatrix,
267
+ heatmapScopes,
268
+ allCats,
269
+ };
270
+
271
+ const html = generateHTML(vizData);
272
+ writeFileSync(OUTPUT_HTML, html, "utf-8");
273
+ console.log(`\n✅ 仪表盘已生成: ${OUTPUT_HTML}`);
274
+ console.log(" 用浏览器打开即可查看交互图表");
275
+ }
276
+
277
+ function generateHTML(data: any): string {
278
+ return `<!DOCTYPE html>
279
+ <html lang="zh-CN">
280
+ <head>
281
+ <meta charset="UTF-8">
282
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
283
+ <title>RecallNest 记忆体检仪表盘</title>
284
+ <script src="https://cdn.plot.ly/plotly-2.35.2.min.js"></script>
285
+ <style>
286
+ * { margin: 0; padding: 0; box-sizing: border-box; }
287
+ body {
288
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
289
+ background: #0f0f23;
290
+ color: #e0e0e0;
291
+ padding: 20px;
292
+ }
293
+ h1 {
294
+ text-align: center;
295
+ font-size: 28px;
296
+ color: #00d4ff;
297
+ margin-bottom: 8px;
298
+ }
299
+ .subtitle {
300
+ text-align: center;
301
+ color: #888;
302
+ margin-bottom: 30px;
303
+ font-size: 14px;
304
+ }
305
+ .stats-bar {
306
+ display: flex;
307
+ justify-content: center;
308
+ gap: 30px;
309
+ margin-bottom: 30px;
310
+ flex-wrap: wrap;
311
+ }
312
+ .stat-card {
313
+ background: #1a1a3e;
314
+ border: 1px solid #333;
315
+ border-radius: 12px;
316
+ padding: 16px 24px;
317
+ text-align: center;
318
+ min-width: 140px;
319
+ }
320
+ .stat-card .value {
321
+ font-size: 28px;
322
+ font-weight: bold;
323
+ color: #00d4ff;
324
+ }
325
+ .stat-card .label {
326
+ font-size: 12px;
327
+ color: #888;
328
+ margin-top: 4px;
329
+ }
330
+ .stat-card.alert .value { color: #ff6b6b; }
331
+ .grid {
332
+ display: grid;
333
+ grid-template-columns: 1fr 1fr;
334
+ gap: 20px;
335
+ max-width: 1400px;
336
+ margin: 0 auto;
337
+ }
338
+ .chart-box {
339
+ background: #1a1a3e;
340
+ border: 1px solid #333;
341
+ border-radius: 12px;
342
+ padding: 16px;
343
+ }
344
+ .chart-box.full-width {
345
+ grid-column: 1 / -1;
346
+ }
347
+ .chart-box h3 {
348
+ color: #00d4ff;
349
+ font-size: 16px;
350
+ margin-bottom: 12px;
351
+ }
352
+ .chart-container {
353
+ width: 100%;
354
+ min-height: 350px;
355
+ }
356
+ .chart-container.tall {
357
+ min-height: 500px;
358
+ }
359
+ footer {
360
+ text-align: center;
361
+ color: #555;
362
+ margin-top: 40px;
363
+ font-size: 12px;
364
+ }
365
+ @media (max-width: 900px) {
366
+ .grid { grid-template-columns: 1fr; }
367
+ }
368
+ </style>
369
+ </head>
370
+ <body>
371
+
372
+ <h1>🧠 RecallNest 记忆体检仪表盘</h1>
373
+ <p class="subtitle">生成时间: ${new Date().toISOString().slice(0, 19)} · 数据来源: LanceDB memories table</p>
374
+
375
+ <div class="stats-bar">
376
+ <div class="stat-card">
377
+ <div class="value">${data.summaryStats.total.toLocaleString()}</div>
378
+ <div class="label">总记忆数</div>
379
+ </div>
380
+ <div class="stat-card alert">
381
+ <div class="value">${data.summaryStats.deadPct}%</div>
382
+ <div class="label">死记忆率</div>
383
+ </div>
384
+ <div class="stat-card">
385
+ <div class="value">${data.summaryStats.categories}</div>
386
+ <div class="label">类别数</div>
387
+ </div>
388
+ <div class="stat-card">
389
+ <div class="value">${data.summaryStats.scopes}</div>
390
+ <div class="label">Scope 数</div>
391
+ </div>
392
+ <div class="stat-card">
393
+ <div class="value">${data.summaryStats.avgImportance}</div>
394
+ <div class="label">平均 Importance</div>
395
+ </div>
396
+ <div class="stat-card">
397
+ <div class="value">${data.summaryStats.oldest}</div>
398
+ <div class="label">最早记忆</div>
399
+ </div>
400
+ </div>
401
+
402
+ <div class="grid">
403
+
404
+ <!-- 1. Category Distribution -->
405
+ <div class="chart-box">
406
+ <h3>📊 类别分布</h3>
407
+ <div class="chart-container" id="chart-category"></div>
408
+ </div>
409
+
410
+ <!-- 2. Tier Distribution -->
411
+ <div class="chart-box">
412
+ <h3>📊 Tier 分布</h3>
413
+ <div class="chart-container" id="chart-tier"></div>
414
+ </div>
415
+
416
+ <!-- 3. Monthly Timeline -->
417
+ <div class="chart-box full-width">
418
+ <h3>📈 月度记忆增长</h3>
419
+ <div class="chart-container" id="chart-timeline"></div>
420
+ </div>
421
+
422
+ <!-- 4. Daily Timeline (last 90 days) -->
423
+ <div class="chart-box full-width">
424
+ <h3>📈 近 90 天每日记忆量</h3>
425
+ <div class="chart-container" id="chart-daily"></div>
426
+ </div>
427
+
428
+ <!-- 5. Hourly Pattern -->
429
+ <div class="chart-box">
430
+ <h3>⏰ 小时分布</h3>
431
+ <div class="chart-container" id="chart-hourly"></div>
432
+ </div>
433
+
434
+ <!-- 6. Day of Week -->
435
+ <div class="chart-box">
436
+ <h3>📅 星期分布</h3>
437
+ <div class="chart-container" id="chart-dow"></div>
438
+ </div>
439
+
440
+ <!-- 7. Access Count -->
441
+ <div class="chart-box">
442
+ <h3>🔍 访问次数分布</h3>
443
+ <div class="chart-container" id="chart-access"></div>
444
+ </div>
445
+
446
+ <!-- 8. Importance Distribution -->
447
+ <div class="chart-box">
448
+ <h3>⚖️ Importance 分布</h3>
449
+ <div class="chart-container" id="chart-importance"></div>
450
+ </div>
451
+
452
+ <!-- 9. Top Scopes -->
453
+ <div class="chart-box full-width">
454
+ <h3>🏷️ Top 15 Scopes</h3>
455
+ <div class="chart-container" id="chart-scopes"></div>
456
+ </div>
457
+
458
+ <!-- 10. Scope × Category Heatmap -->
459
+ <div class="chart-box full-width">
460
+ <h3>🗺️ Scope × Category 热力图</h3>
461
+ <div class="chart-container" id="chart-heatmap"></div>
462
+ </div>
463
+
464
+ <!-- 11. Text Length Distribution -->
465
+ <div class="chart-box">
466
+ <h3>📏 文本长度分布</h3>
467
+ <div class="chart-container" id="chart-textlen"></div>
468
+ </div>
469
+
470
+ <!-- 12. Embedding PCA Scatter -->
471
+ <div class="chart-box full-width">
472
+ <h3>🧬 Embedding PCA 散点图 (采样 ${data.pcaPoints.length} 条)</h3>
473
+ <div class="chart-container tall" id="chart-pca"></div>
474
+ </div>
475
+
476
+ </div>
477
+
478
+ <footer>RecallNest Data Checkup · Module 6 Visualization · ${new Date().toISOString().slice(0, 10)}</footer>
479
+
480
+ <script>
481
+ const DATA = ${JSON.stringify(data)};
482
+ const DARK_LAYOUT = {
483
+ paper_bgcolor: 'rgba(0,0,0,0)',
484
+ plot_bgcolor: 'rgba(0,0,0,0)',
485
+ font: { color: '#e0e0e0', size: 12 },
486
+ margin: { t: 30, r: 20, b: 50, l: 60 },
487
+ };
488
+ const COLORS = ['#00d4ff', '#ff6b6b', '#ffd93d', '#6bcb77', '#9b59b6', '#e67e22', '#1abc9c', '#e74c3c', '#3498db'];
489
+
490
+ // 1. Category Donut
491
+ Plotly.newPlot('chart-category', [{
492
+ type: 'pie',
493
+ labels: Object.keys(DATA.categoryData),
494
+ values: Object.values(DATA.categoryData),
495
+ hole: 0.45,
496
+ marker: { colors: COLORS },
497
+ textinfo: 'label+percent',
498
+ textfont: { size: 11 },
499
+ }], { ...DARK_LAYOUT, showlegend: false });
500
+
501
+ // 2. Tier Donut
502
+ Plotly.newPlot('chart-tier', [{
503
+ type: 'pie',
504
+ labels: Object.keys(DATA.tierData),
505
+ values: Object.values(DATA.tierData),
506
+ hole: 0.45,
507
+ marker: { colors: ['#ff6b6b', '#ffd93d', '#6bcb77'] },
508
+ textinfo: 'label+percent',
509
+ textfont: { size: 12 },
510
+ }], { ...DARK_LAYOUT, showlegend: false });
511
+
512
+ // 3. Monthly Timeline (stacked area)
513
+ {
514
+ const months = Object.keys(DATA.timelineData);
515
+ const allCats = [...new Set(months.flatMap(m => Object.keys(DATA.timelineData[m].cats)))];
516
+ const traces = allCats.map((cat, i) => ({
517
+ x: months,
518
+ y: months.map(m => DATA.timelineData[m].cats[cat] || 0),
519
+ name: cat,
520
+ type: 'bar',
521
+ marker: { color: COLORS[i % COLORS.length] },
522
+ }));
523
+ Plotly.newPlot('chart-timeline', traces, {
524
+ ...DARK_LAYOUT,
525
+ barmode: 'stack',
526
+ xaxis: { title: '月份' },
527
+ yaxis: { title: '记忆数' },
528
+ legend: { orientation: 'h', y: -0.2 },
529
+ });
530
+ }
531
+
532
+ // 4. Daily Timeline
533
+ {
534
+ const days = Object.keys(DATA.dailyData);
535
+ Plotly.newPlot('chart-daily', [{
536
+ x: days,
537
+ y: days.map(d => DATA.dailyData[d]),
538
+ type: 'bar',
539
+ marker: { color: '#00d4ff', opacity: 0.7 },
540
+ }], {
541
+ ...DARK_LAYOUT,
542
+ xaxis: { title: '日期' },
543
+ yaxis: { title: '记忆数' },
544
+ });
545
+ }
546
+
547
+ // 5. Hourly Pattern
548
+ Plotly.newPlot('chart-hourly', [{
549
+ x: DATA.hourData.map((_, i) => i + ':00'),
550
+ y: DATA.hourData,
551
+ type: 'bar',
552
+ marker: {
553
+ color: DATA.hourData.map((v, i) =>
554
+ (i >= 22 || i <= 6) ? '#9b59b6' : (i >= 9 && i <= 18) ? '#00d4ff' : '#ffd93d'
555
+ ),
556
+ },
557
+ }], {
558
+ ...DARK_LAYOUT,
559
+ xaxis: { title: '小时' },
560
+ yaxis: { title: '记忆数' },
561
+ });
562
+
563
+ // 6. Day of Week
564
+ {
565
+ const dowNames = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
566
+ Plotly.newPlot('chart-dow', [{
567
+ x: dowNames,
568
+ y: DATA.dowData,
569
+ type: 'bar',
570
+ marker: { color: COLORS.slice(0, 7) },
571
+ }], {
572
+ ...DARK_LAYOUT,
573
+ xaxis: { title: '星期' },
574
+ yaxis: { title: '记忆数' },
575
+ });
576
+ }
577
+
578
+ // 7. Access Count
579
+ Plotly.newPlot('chart-access', [{
580
+ x: Object.keys(DATA.accessBuckets),
581
+ y: Object.values(DATA.accessBuckets),
582
+ type: 'bar',
583
+ marker: {
584
+ color: Object.keys(DATA.accessBuckets).map((k, i) =>
585
+ k.includes('死记忆') ? '#ff6b6b' : COLORS[i]
586
+ ),
587
+ },
588
+ }], {
589
+ ...DARK_LAYOUT,
590
+ xaxis: { title: '访问次数' },
591
+ yaxis: { title: '记忆数', type: 'log' },
592
+ });
593
+
594
+ // 8. Importance Histogram
595
+ Plotly.newPlot('chart-importance', [{
596
+ x: DATA.impHist.map((_, i) => (i / DATA.impHist.length).toFixed(2)),
597
+ y: DATA.impHist,
598
+ type: 'bar',
599
+ marker: {
600
+ color: DATA.impHist.map((_, i) => {
601
+ const v = i / DATA.impHist.length;
602
+ return v < 0.3 ? '#ff6b6b' : v < 0.6 ? '#ffd93d' : '#6bcb77';
603
+ }),
604
+ },
605
+ }], {
606
+ ...DARK_LAYOUT,
607
+ xaxis: { title: 'Importance' },
608
+ yaxis: { title: '记忆数' },
609
+ });
610
+
611
+ // 9. Top Scopes
612
+ Plotly.newPlot('chart-scopes', [{
613
+ y: Object.keys(DATA.topScopes),
614
+ x: Object.values(DATA.topScopes),
615
+ type: 'bar',
616
+ orientation: 'h',
617
+ marker: { color: '#00d4ff' },
618
+ }], {
619
+ ...DARK_LAYOUT,
620
+ margin: { ...DARK_LAYOUT.margin, l: 250 },
621
+ xaxis: { title: '记忆数' },
622
+ });
623
+
624
+ // 10. Heatmap
625
+ Plotly.newPlot('chart-heatmap', [{
626
+ z: DATA.heatmapScopes.map(s => DATA.allCats.map(c => DATA.scopeCatMatrix[s]?.[c] || 0)),
627
+ x: DATA.allCats,
628
+ y: DATA.heatmapScopes.map(s => s.length > 35 ? s.slice(0, 32) + '...' : s),
629
+ type: 'heatmap',
630
+ colorscale: [[0, '#0f0f23'], [0.5, '#00d4ff'], [1, '#ff6b6b']],
631
+ showscale: true,
632
+ }], {
633
+ ...DARK_LAYOUT,
634
+ margin: { ...DARK_LAYOUT.margin, l: 250 },
635
+ });
636
+
637
+ // 11. Text Length
638
+ {
639
+ const maxLen = 3000;
640
+ Plotly.newPlot('chart-textlen', [{
641
+ x: DATA.lenHist.map((_, i) => Math.round(i / DATA.lenHist.length * maxLen)),
642
+ y: DATA.lenHist,
643
+ type: 'bar',
644
+ marker: { color: '#1abc9c' },
645
+ }], {
646
+ ...DARK_LAYOUT,
647
+ xaxis: { title: '字符数' },
648
+ yaxis: { title: '记忆数' },
649
+ });
650
+ }
651
+
652
+ // 12. PCA Scatter
653
+ if (DATA.pcaPoints.length > 0) {
654
+ const cats = [...new Set(DATA.pcaPoints.map(p => p.category))];
655
+ const traces = cats.map((cat, i) => {
656
+ const points = DATA.pcaPoints.filter(p => p.category === cat);
657
+ return {
658
+ x: points.map(p => p.x),
659
+ y: points.map(p => p.y),
660
+ text: points.map(p => p.text),
661
+ name: cat,
662
+ mode: 'markers',
663
+ type: 'scattergl',
664
+ marker: {
665
+ size: 3,
666
+ color: COLORS[i % COLORS.length],
667
+ opacity: 0.6,
668
+ },
669
+ hovertemplate: '<b>%{text}</b><br>scope: ' + points.map(p => p.scope).join('<br>') + '<extra>%{fullData.name}</extra>',
670
+ };
671
+ });
672
+ // Fix hover: use customdata
673
+ const pcaTraces = cats.map((cat, i) => {
674
+ const points = DATA.pcaPoints.filter(p => p.category === cat);
675
+ return {
676
+ x: points.map(p => p.x),
677
+ y: points.map(p => p.y),
678
+ customdata: points.map(p => [p.text, p.scope]),
679
+ name: cat,
680
+ mode: 'markers',
681
+ type: 'scattergl',
682
+ marker: {
683
+ size: 3,
684
+ color: COLORS[i % COLORS.length],
685
+ opacity: 0.6,
686
+ },
687
+ hovertemplate: '%{customdata[0]}<br><i>scope: %{customdata[1]}</i><extra>%{fullData.name}</extra>',
688
+ };
689
+ });
690
+ Plotly.newPlot('chart-pca', pcaTraces, {
691
+ ...DARK_LAYOUT,
692
+ xaxis: { title: 'PC1', zeroline: false },
693
+ yaxis: { title: 'PC2', zeroline: false },
694
+ legend: { orientation: 'h', y: -0.15 },
695
+ margin: { ...DARK_LAYOUT.margin, b: 80 },
696
+ });
697
+ }
698
+ </script>
699
+ </body>
700
+ </html>`;
701
+ }
702
+
703
+ main().catch(console.error);