dsh-macro-memory 0.0.0-stage → 0.4.0

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 (132) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +506 -2
  3. package/cordis.patch.yml +6 -0
  4. package/lib/client.js +3623 -0
  5. package/lib/index.js +502 -0
  6. package/lib/macro/brand.js +82 -0
  7. package/lib/macro/bridge.js +158 -0
  8. package/lib/macro/chain.js +206 -0
  9. package/lib/macro/contract.js +471 -0
  10. package/lib/macro/cost.js +164 -0
  11. package/lib/macro/defs/admin.js +442 -0
  12. package/lib/macro/defs/dream.js +24 -0
  13. package/lib/macro/defs/link.js +257 -0
  14. package/lib/macro/defs/project.js +25 -0
  15. package/lib/macro/defs/read.js +160 -0
  16. package/lib/macro/defs/remember.js +411 -0
  17. package/lib/macro/defs/search.js +871 -0
  18. package/lib/macro/defs/update.js +161 -0
  19. package/lib/macro/dreamledger.js +1398 -0
  20. package/lib/macro/facade.js +135 -0
  21. package/lib/macro/fusion.js +182 -0
  22. package/lib/macro/linkflow.js +391 -0
  23. package/lib/macro/links.js +448 -0
  24. package/lib/macro/neighbor.js +209 -0
  25. package/lib/macro/panel.js +96 -0
  26. package/lib/macro/prompt.js +139 -0
  27. package/lib/macro/provenance.js +148 -0
  28. package/lib/macro/render.js +35 -0
  29. package/lib/macro/revisions.js +253 -0
  30. package/lib/macro/shared.js +113 -0
  31. package/lib/macro/store.js +103 -0
  32. package/lib/macro/supersede.js +197 -0
  33. package/lib/macro/tokencost.js +90 -0
  34. package/lib/macro/tools.js +67 -0
  35. package/package.json +54 -4
  36. package/vendor/VENDOR.json +23 -0
  37. package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
  38. package/vendor/dsh-memory-nebula/LICENSE +21 -0
  39. package/vendor/dsh-memory-nebula/README.en.md +203 -0
  40. package/vendor/dsh-memory-nebula/README.md +253 -0
  41. package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
  42. package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
  43. package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
  44. package/vendor/dsh-memory-nebula/lib/client.js +105 -0
  45. package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
  46. package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
  47. package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +320 -0
  48. package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
  49. package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
  50. package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
  51. package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
  52. package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
  53. package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
  54. package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
  55. package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
  56. package/vendor/dsh-memory-nebula/lib/host/entities.js +230 -0
  57. package/vendor/dsh-memory-nebula/lib/host/graph.js +1762 -0
  58. package/vendor/dsh-memory-nebula/lib/host/graphcache.js +290 -0
  59. package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
  60. package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
  61. package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
  62. package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
  63. package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
  64. package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
  65. package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
  66. package/vendor/dsh-memory-nebula/lib/host/recall.js +524 -0
  67. package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
  68. package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
  69. package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
  70. package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
  71. package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
  72. package/vendor/dsh-memory-nebula/lib/index.js +782 -0
  73. package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
  74. package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
  75. package/vendor/dsh-memory-nebula/lib/web/app.js +4172 -0
  76. package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
  77. package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
  78. package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
  79. package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
  80. package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
  81. package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
  82. package/vendor/dsh-memory-nebula/locale/en.json +7 -0
  83. package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
  84. package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
  85. package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
  86. package/vendor/dsh-memory-nebula/market/index.json +101 -0
  87. package/vendor/dsh-memory-nebula/package.json +87 -0
  88. package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
  89. package/vendor/meow-memory/LICENSE +21 -0
  90. package/vendor/meow-memory/README.en.md +192 -0
  91. package/vendor/meow-memory/README.md +174 -0
  92. package/vendor/meow-memory/README.pt-br.md +180 -0
  93. package/vendor/meow-memory/cordis.patch.yml +7 -0
  94. package/vendor/meow-memory/lib/client.js +3344 -0
  95. package/vendor/meow-memory/lib/client.js.map +7 -0
  96. package/vendor/meow-memory/lib/index.js +9802 -0
  97. package/vendor/meow-memory/lib/index.js.map +7 -0
  98. package/vendor/meow-memory/lib/prompts/README.md +65 -0
  99. package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
  100. package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
  101. package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
  102. package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
  103. package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
  104. package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
  105. package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
  106. package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
  107. package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
  108. package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
  109. package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
  110. package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
  111. package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
  112. package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
  113. package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
  114. package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
  115. package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
  116. package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
  117. package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
  118. package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
  119. package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
  120. package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
  121. package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
  122. package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
  123. package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
  124. package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
  125. package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
  126. package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
  127. package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
  128. package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
  129. package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
  130. package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
  131. package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
  132. package/vendor/meow-memory/package.json +64 -0
@@ -0,0 +1,4172 @@
1
+ /* 宏记忆 · 星图 —— 界面逻辑
2
+ 数据:/api/memory-nebula/*(同源)。渲染交给 render.js。 */
3
+ ;(function () {
4
+ const APP_VERSION = '1.11.74' // 和 package.json 同步(release-check 会核对)
5
+ 'use strict'
6
+ /** 中文即源文:英文模式查 i18n.js 的表,查不到就原样返回中文。 */
7
+ const T = (zh, vars) => (window.NebulaI18n ? window.NebulaI18n.t(zh, vars) : zh)
8
+ /** 服务端生成的解释句是中文:在英文模式里做一层有限翻译,翻不了就保留原文。 */
9
+ function localizeWhy(s) {
10
+ if (Array.isArray(s)) return s.map(localizeWhy).join(' · ')
11
+ if (!s || typeof s !== 'string' || !window.NebulaI18n || window.NebulaI18n.lang !== 'en') return s
12
+ const exact = {
13
+ '直接命中查询词': 'Direct query hit',
14
+ '直接命中查询词(跨工作区)': 'Direct query hit (cross-workspace)',
15
+ }
16
+ if (exact[s]) return exact[s]
17
+ let m = s.match(/^被读过 (\d+) 次$/)
18
+ if (m) return 'read ' + m[1] + (m[1] === '1' ? ' time' : ' times')
19
+ m = s.match(/^经由「(.*)」的(.+?)关联(跨工作区)?扩散而来$/)
20
+ if (m) return 'via “' + m[1] + '” · ' + m[2] + ' link' + (m[3] ? ' · cross-workspace' : '')
21
+ return s
22
+ }
23
+
24
+ const API = window.NebulaAPI
25
+ const LEVEL_COLOR = window.Nebula.LEVEL_COLOR
26
+ const TYPE_COLOR = window.Nebula.TYPE_COLOR
27
+ const LEVEL_LABEL = {
28
+ soul: T('灵魂'),
29
+ user: T('主人'),
30
+ project: T('项目'),
31
+ lesson: T('教训'),
32
+ topic: T('话题'),
33
+ fact: T('事实'),
34
+ rules: T('准则'),
35
+ source: T('来源'),
36
+ }
37
+ /** 记忆来源(provider)的显示名与配色:meow 是主来源,其他插件各给一个色。 */
38
+ const PROVIDER_LABEL = {
39
+ 'meow-memory': 'meow-memory',
40
+ inventory: T('环境 · 插件/技能/MCP'),
41
+ }
42
+ const PROVIDER_COLOR = {
43
+ 'meow-memory': '#6ce0ff',
44
+ inventory: '#8b93b8',
45
+ }
46
+ function providerColor(p) {
47
+ if (PROVIDER_COLOR[p]) return PROVIDER_COLOR[p]
48
+ let h = 0
49
+ for (let i = 0; i < p.length; i++) h = (h * 31 + p.charCodeAt(i)) % 360
50
+ return 'hsl(' + h + ' 72% 62%)'
51
+ }
52
+ function providerLabel(p) {
53
+ return PROVIDER_LABEL[p] || p
54
+ }
55
+
56
+ const TYPE_LABEL = {
57
+ explicit: T('手工'),
58
+ project: T('同项目'),
59
+ entity: T('同一实体'),
60
+ keyword: T('同关键词'),
61
+ semantic: T('语义相似'),
62
+ hebbian: T('共激活'),
63
+ mentions: T('提到来源'),
64
+ }
65
+
66
+ const $ = (s) => document.querySelector(s)
67
+ const el = (tag, cls, text) => {
68
+ const d = document.createElement(tag)
69
+ if (cls) d.className = cls
70
+ if (text !== undefined) d.textContent = text
71
+ return d
72
+ }
73
+ const esc = (s) =>
74
+ String(s ?? '')
75
+ .replace(/&/g, '&amp;')
76
+ .replace(/</g, '&lt;')
77
+ .replace(/>/g, '&gt;')
78
+ .replace(/"/g, '&quot;')
79
+
80
+ const state = {
81
+ graph: null,
82
+ stage: null,
83
+ // 图数据的快速索引:键盘走位要频繁查标题、算枢纽度,不能在几千条里线性找
84
+ nodeById: null,
85
+ degree: null,
86
+ navAlongAt: 0,
87
+ filter: { ws: null, levels: null, types: null, providers: null, minW: 0, minImp: 0 },
88
+ selected: null,
89
+ detail: null,
90
+ // 引力四个参数(三维视图)与局部图深度:都只活在面板里,不进请求前缀
91
+ forceUI: null,
92
+ localDepth: 0,
93
+ localCount: 0,
94
+ query: '',
95
+ hits: [],
96
+ timer: 0,
97
+ lastError: '',
98
+ warnedSourceError: false,
99
+ // 分页:page={total,offset,limit,next};大图只装了第一页时它才非空
100
+ page: null,
101
+ }
102
+
103
+ let toastTimer = 0
104
+ let toastPinned = false
105
+ // 用户刚亲手点过东西(重建星图等),接下来这几秒里背景消息不许插嘴:
106
+ // 不然「后台那轮重建完成了」会盖掉「你刚点的这一下结果是什么」(1.11.33)。
107
+ let toastQuietUntil = 0
108
+ function toastBackground(msg) {
109
+ if (Date.now() < toastQuietUntil) return
110
+ toast(msg)
111
+ }
112
+ // 提示条可以带一个动作(「撤销」)。屏蔽关联 / 断开连边都是即时生效、没有确认框的,
113
+ // 所以误点之后必须留一条退路——退路就挂在提示条上,不另开弹窗。
114
+ let toastSeq = 0
115
+ function toast(msg, action) {
116
+ const t = $('#toast')
117
+ const hasAct = !!(action && action.label && typeof action.run === 'function')
118
+ // 带动作的提示条是「还没做完的一件事」,不能被轮询那种背景提示顶掉——
119
+ // 否则 12 秒一次的「星云已更新」会把「撤销」按钮冲走,人就再也点不到了。
120
+ if (toastPinned && !hasAct) return
121
+ const mySeq = ++toastSeq
122
+ t.innerHTML = ''
123
+ t.appendChild(el('span', 't-msg', msg))
124
+ if (hasAct) {
125
+ const btn = el('button', 't-act', action.label)
126
+ btn.onclick = async () => {
127
+ btn.disabled = true
128
+ const msgEl = t.querySelector('.t-msg')
129
+ if (msgEl) msgEl.textContent = T('正在处理…')
130
+ toastPinned = false
131
+ try {
132
+ await action.run()
133
+ } catch (e) {
134
+ toast(T('撤销失败:') + (e && e.message ? e.message : e))
135
+ }
136
+ // 动作里往往自己又 toast 了一句「已撤销」:那是新的一条,别在这里把它关掉。
137
+ if (toastSeq !== mySeq) return
138
+ toastPinned = false
139
+ clearTimeout(toastTimer)
140
+ t.classList.remove('show')
141
+ t.classList.remove('act')
142
+ }
143
+ t.appendChild(btn)
144
+ }
145
+ toastPinned = hasAct
146
+ t.classList.toggle('act', hasAct)
147
+ t.classList.add('show')
148
+ clearTimeout(toastTimer)
149
+ toastTimer = setTimeout(() => {
150
+ if (toastSeq !== mySeq) return
151
+ toastPinned = false
152
+ t.classList.remove('show')
153
+ t.classList.remove('act')
154
+ }, hasAct ? 8000 : 2600)
155
+ }
156
+
157
+ // ---------------- 顶栏统计 ----------------
158
+ function renderStats(graph) {
159
+ const box = $('#stats')
160
+ box.innerHTML = ''
161
+ const stats = graph.stats || {}
162
+ const items = [
163
+ [T('记忆'), stats.nodes ?? 0],
164
+ [T('连接'), stats.edges ?? 0],
165
+ [T('工作区'), stats.workspaces ?? 0],
166
+ [T('会话'), stats.sessions ?? 0],
167
+ [T('平均连接'), (stats.avgDegree ?? 0).toFixed(1)],
168
+ ]
169
+ const tips = {
170
+ 记忆: T('跨工作区收集到的记忆条目总数'),
171
+ 连接: T('图里画出来的边:同一实体 / 同关键词 / 语义近邻 / 人工连的'),
172
+ 工作区: T('这些记忆来自几个工作区'),
173
+ 会话: T('写这些记忆时所在的会话数'),
174
+ 平均连接: T('平均每条记忆连了几条边'),
175
+ }
176
+ for (const [label, value] of items) {
177
+ const s = el('div', 'stat')
178
+ s.title = tips[label] || label
179
+ s.appendChild(el('b', null, String(value)))
180
+ s.appendChild(el('span', null, label))
181
+ box.appendChild(s)
182
+ }
183
+ }
184
+
185
+ // ---------------- 筛选面板 ----------------
186
+ /* 左栏折叠:记住上次收起的分组(小屏上把「连接类型」收起来就能看见图) */
187
+ const FOLD_KEY = 'nebula.fold'
188
+
189
+ /* ---------- 引力(三维视图):滑杆 0..4 根,参数存在本机 ---------- */
190
+
191
+ const FORCE_KEY = 'nebula.force'
192
+
193
+ /**
194
+ * 四个滑杆的定义。fix 是小数位,step 是最小步长。
195
+ * 上下限和 space3d.js 的 forceParams() 是同一组数——那边负责夹,这边负责不许拖出界。
196
+ */
197
+ const FORCE_SPEC = [
198
+ { key: 'repulse', label: '斥力', min: 1200, max: 20000, step: 200, fix: 0 },
199
+ { key: 'springRest', label: '弹簧长度', min: 30, max: 200, step: 5, fix: 0 },
200
+ { key: 'clusterPull', label: '项目向心', min: 0, max: 0.08, step: 0.002, fix: 3 },
201
+ { key: 'damping', label: '阻尼', min: 0.6, max: 0.96, step: 0.01, fix: 2 },
202
+ ]
203
+
204
+ /** 默认值从渲染器那边取,面板里不另写一份数字(两份数字早晚会分叉)。 */
205
+ function forceDefaults() {
206
+ const NS = window.NebulaSpace
207
+ const base = (NS && NS.FORCE_BASE) || { repulse: 6200, springRest: 90, clusterPull: 0.02, damping: 0.86 }
208
+ const out = {}
209
+ for (const f of FORCE_SPEC) out[f.key] = base[f.key]
210
+ return out
211
+ }
212
+
213
+ function readForceUI() {
214
+ let saved = {}
215
+ try {
216
+ saved = JSON.parse(localStorage.getItem(FORCE_KEY) || '{}') || {}
217
+ } catch (err) {
218
+ saved = {} // 存坏了就当没存过:一组画不好看的引力不该让整个面板打不开
219
+ }
220
+ const out = forceDefaults()
221
+ for (const f of FORCE_SPEC) {
222
+ const v = Number(saved[f.key])
223
+ if (Number.isFinite(v)) out[f.key] = v
224
+ }
225
+ return out
226
+ }
227
+
228
+ function saveForceUI(ui) {
229
+ try {
230
+ localStorage.setItem(FORCE_KEY, JSON.stringify(ui))
231
+ } catch (err) {
232
+ /* 隐私模式里写不进去:这一轮照样生效,下次打开回默认 */
233
+ }
234
+ }
235
+
236
+ /** 把四个参数交给三维渲染器。2D 星云不吃这组参数,所以只在三维视图里有效。 */
237
+ function applyForceToStage() {
238
+ if (!state.forceUI) state.forceUI = readForceUI()
239
+ if (state.space3d && typeof state.space3d.setForce === 'function') state.space3d.setForce(state.forceUI)
240
+ }
241
+
242
+ /**
243
+ * 局部图:选中一颗星就只看它 depth 跳以内的邻居。
244
+ * depth = 0 或者没选中 → 传 null 回全图(空集合会被渲染器理解成「什么都别画」)。
245
+ */
246
+ function applyLocal(id) {
247
+ if (!state.space3d || typeof state.space3d.setLocal !== 'function') return null
248
+ const depth = Number(state.localDepth) || 0
249
+ const target = id === undefined ? state.selected : id
250
+ if (!(depth > 0) || !target) {
251
+ state.space3d.setLocal(null, 0)
252
+ state.localCount = 0
253
+ return null
254
+ }
255
+ state.space3d.setLocal(target, depth)
256
+ const info = typeof state.space3d.localInfo === 'function' ? state.space3d.localInfo() : null
257
+ state.localCount = (info && Number(info.count)) || 0
258
+ return info
259
+ }
260
+ function foldSet() {
261
+ try {
262
+ return new Set(JSON.parse(localStorage.getItem(FOLD_KEY) || '[]'))
263
+ } catch {
264
+ return new Set()
265
+ }
266
+ }
267
+ function saveFold(set) {
268
+ try {
269
+ localStorage.setItem(FOLD_KEY, JSON.stringify([...set]))
270
+ } catch {}
271
+ }
272
+ /* 静默失败的出口:不弹 toast 打断人,但第一次出问题时留一行可查的日志。
273
+ 同一种失败只记一次,避免 12 秒轮询把控制台刷满。 */
274
+ const _softSeen = new Set()
275
+ /** 接口长时间连不上时,在画面顶部留一条细提示(不挡操作,恢复后自己消失)。 */
276
+ function setOffline(on) {
277
+ const bar = $('#netbar')
278
+ if (!bar) return
279
+ const was = state.offline
280
+ state.offline = !!on
281
+ bar.hidden = !on
282
+ if (was && !on) toast(T('连接已恢复'))
283
+ }
284
+
285
+ function softWarn(tag, err) {
286
+ if (_softSeen.has(tag)) return
287
+ _softSeen.add(tag)
288
+ try {
289
+ // 降级路径默认安静;排查时在控制台执行 window.__NEBULA_DEBUG__ = true 再刷新。
290
+ if (window.__NEBULA_DEBUG__) console.debug('[nebula] ' + tag + T(' 降级:') + ((err && err.message) || err))
291
+ } catch {}
292
+ }
293
+
294
+ function attachFold(box, key) {
295
+ if (foldSet().has(key)) box.classList.add('folded')
296
+ const b = el('button', 'fold')
297
+ b.type = 'button'
298
+ b.title = T('收起 / 展开')
299
+ b.innerHTML =
300
+ '<svg width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4"><path d="M6 9l6 6 6-6"/></svg>'
301
+ b.onclick = (ev) => {
302
+ ev.stopPropagation()
303
+ box.classList.toggle('folded')
304
+ const now = foldSet()
305
+ if (box.classList.contains('folded')) now.add(key)
306
+ else now.delete(key)
307
+ saveFold(now)
308
+ }
309
+ return b
310
+ }
311
+
312
+ function buildFilters(graph) {
313
+ const root = $('#filters')
314
+ root.innerHTML = ''
315
+ const stats = graph.stats || {}
316
+ const wsCounts = stats.byWorkspace || {}
317
+ const lvCounts = stats.byLevel || {}
318
+ const typeCounts = stats.byType || {}
319
+
320
+ // 重建后工作区/层级/类型可能增减:先把筛选键收敛到现有集合。
321
+ // 否则某个工作区改名后,键还留在 state.filter 里,画面上就会「一条都看不见」,
322
+ // 而左侧 chip 却全是亮的 —— 最难查的那种不一致。
323
+ const prune = (set, valid) => {
324
+ if (!set) return null
325
+ const next = new Set()
326
+ for (const k of set) if (valid.has(k)) next.add(k)
327
+ return next.size === valid.size ? null : next
328
+ }
329
+ state.filter.ws = prune(state.filter.ws, new Set(Object.keys(wsCounts)))
330
+ state.filter.levels = prune(state.filter.levels, new Set(Object.keys(lvCounts)))
331
+ state.filter.types = prune(state.filter.types, new Set(Object.keys(typeCounts)))
332
+ const provCounts = {}
333
+ for (const n of graph.nodes || []) {
334
+ const key = n.provider || 'meow-memory'
335
+ provCounts[key] = (provCounts[key] || 0) + 1
336
+ }
337
+ state.filter.providers = prune(state.filter.providers, new Set(Object.keys(provCounts)))
338
+ const chipClass = (set, key) => (set && !set.has(key) ? 'chip' : 'chip on')
339
+
340
+ // 记忆来源:接了多个记忆插件之后,这一栏回答「这条记忆是谁给的」。
341
+ // 只有一种来源时整节省略——一颗 chip 的筛选器只是噪音。
342
+ const provChips = []
343
+ const provKeys = Object.keys(provCounts).sort((a, b) => provCounts[b] - provCounts[a])
344
+ if (provKeys.length > 1) {
345
+ for (const prov of provKeys) {
346
+ const chip = el('button', chipClass(state.filter.providers, prov))
347
+ const sw = el('i', 'sw')
348
+ sw.style.background = providerColor(prov)
349
+ chip.appendChild(sw)
350
+ chip.appendChild(el('span', null, providerLabel(prov)))
351
+ chip.appendChild(el('span', 'n', String(provCounts[prov])))
352
+ chip.dataset.provider = prov
353
+ chip.title = T('只画「') + providerLabel(prov) + T('」给的记忆')
354
+ chip.onclick = () => {
355
+ chip.classList.toggle('on')
356
+ syncProviderFilter()
357
+ }
358
+ provChips.push(chip)
359
+ }
360
+ root.appendChild(section(T('记忆来源'), provChips, () => provChips.forEach((c) => c.classList.add('on'))))
361
+ }
362
+
363
+ const wsChips = []
364
+ for (const [ws, count] of Object.entries(wsCounts).sort((a, b) => b[1] - a[1])) {
365
+ const chip = el('button', chipClass(state.filter.ws, ws))
366
+ const sw = el('i', 'sw')
367
+ sw.style.background = clusterColor(graph, ws)
368
+ chip.appendChild(sw)
369
+ chip.appendChild(el('span', null, ws))
370
+ chip.appendChild(el('span', 'n', String(count)))
371
+ chip.dataset.ws = ws
372
+ chip.onclick = () => {
373
+ chip.classList.toggle('on')
374
+ syncWsFilter()
375
+ }
376
+ wsChips.push(chip)
377
+ }
378
+ root.appendChild(section(T('工作区'), wsChips, () => wsChips.forEach((c) => c.classList.add('on'))) )
379
+
380
+ // 顶部常驻的「回全视图」+ 当前筛选代价提示:
381
+ // 防止筛到只剩几条时以为图坏了(连接看不见 / 回不到全视图)
382
+ const resetBar = el('div', 'sect reset-bar')
383
+ const resetBtn = el('button', 'chip reset', T('重置筛选 · 回全视图'))
384
+ resetBtn.title = T('清掉所有筛选,并把镜头拉回能看见全部记忆的位置(F)')
385
+ resetBtn.onclick = () => resetFilters()
386
+ resetBar.appendChild(resetBtn)
387
+ const hint = el('div', 'filter-hint', '')
388
+ hint.id = 'filter-hint'
389
+ resetBar.appendChild(hint)
390
+ root.appendChild(resetBar)
391
+
392
+ const lvChips = []
393
+ for (const key of ['project', 'lesson', 'topic', 'fact', 'user', 'rules', 'soul']) {
394
+ if (!lvCounts[key]) continue
395
+ const chip = el('button', chipClass(state.filter.levels, key))
396
+ const sw = el('i', 'sw')
397
+ sw.style.background = LEVEL_COLOR[key]
398
+ chip.appendChild(sw)
399
+ chip.appendChild(el('span', null, LEVEL_LABEL[key] || key))
400
+ chip.appendChild(el('span', 'n', String(lvCounts[key])))
401
+ chip.dataset.level = key
402
+ chip.onclick = () => {
403
+ chip.classList.toggle('on')
404
+ syncLevelFilter()
405
+ }
406
+ lvChips.push(chip)
407
+ }
408
+ root.appendChild(section(T('记忆层级'), lvChips, () => lvChips.forEach((c) => c.classList.add('on'))))
409
+
410
+ const typeChips = []
411
+ for (const [type, count] of Object.entries(typeCounts).sort((a, b) => b[1] - a[1])) {
412
+ const chip = el('button', chipClass(state.filter.types, type))
413
+ const sw = el('i', 'sw')
414
+ sw.style.background = TYPE_COLOR[type] || '#8fb8d8'
415
+ chip.appendChild(sw)
416
+ chip.appendChild(el('span', null, TYPE_LABEL[type] || type))
417
+ chip.appendChild(el('span', 'n', String(count)))
418
+ chip.dataset.type = type
419
+ chip.onclick = () => {
420
+ chip.classList.toggle('on')
421
+ syncTypeFilter()
422
+ }
423
+ typeChips.push(chip)
424
+ }
425
+ root.appendChild(section(T('连接类型'), typeChips, () => typeChips.forEach((c) => c.classList.add('on'))))
426
+
427
+ // 强度滑杆
428
+ const sect = el('div', 'sect')
429
+ const h4a = el('h4', null, T('最小连接强度'))
430
+ h4a.appendChild(attachFold(sect, 'f:minW'))
431
+ sect.appendChild(h4a)
432
+ const slider = el('div', 'slider')
433
+ const range = document.createElement('input')
434
+ range.type = 'range'
435
+ range.min = '0'
436
+ range.max = '90'
437
+ range.value = String(Math.round((state.filter.minW || 0) * 100))
438
+ range.setAttribute('data-zh-aria', '最小连接强度')
439
+ range.setAttribute('aria-label', T('最小连接强度'))
440
+ const val = el('span', 'val', (state.filter.minW || 0).toFixed(2))
441
+ range.oninput = () => {
442
+ state.filter.minW = Number(range.value) / 100
443
+ val.textContent = (Number(range.value) / 100).toFixed(2)
444
+ applyFilter()
445
+ }
446
+ slider.appendChild(range)
447
+ slider.appendChild(val)
448
+ sect.appendChild(slider)
449
+ root.appendChild(sect)
450
+
451
+ // 重要度滑杆
452
+ const sect2 = el('div', 'sect')
453
+ const h4b = el('h4', null, T('最低重要度'))
454
+ h4b.appendChild(attachFold(sect2, 'f:minImp'))
455
+ sect2.appendChild(h4b)
456
+ const slider2 = el('div', 'slider')
457
+ const range2 = document.createElement('input')
458
+ range2.type = 'range'
459
+ range2.min = '0'
460
+ range2.max = '4'
461
+ range2.value = String(state.filter.minImp || 0)
462
+ range2.setAttribute('data-zh-aria', '最低重要度')
463
+ range2.setAttribute('aria-label', T('最低重要度'))
464
+ const val2 = el('span', 'val', String(state.filter.minImp || 0))
465
+ range2.oninput = () => {
466
+ state.filter.minImp = Number(range2.value)
467
+ val2.textContent = range2.value
468
+ applyFilter()
469
+ }
470
+ slider2.appendChild(range2)
471
+ slider2.appendChild(val2)
472
+ sect2.appendChild(slider2)
473
+ root.appendChild(sect2)
474
+
475
+ // 引力:只影响三维视图。2D 星云用固定参数,改这里不会有反应,所以把范围写进标题
476
+ const sectF = el('div', 'sect')
477
+ const h4f = el('h4', null, T('引力(三维视图)'))
478
+ h4f.appendChild(attachFold(sectF, 'f:force'))
479
+ sectF.appendChild(h4f)
480
+ const forceUI = (state.forceUI = readForceUI())
481
+ for (const f of FORCE_SPEC) {
482
+ const row = el('div', 'slider')
483
+ const inp = document.createElement('input')
484
+ inp.type = 'range'
485
+ inp.min = String(f.min)
486
+ inp.max = String(f.max)
487
+ inp.step = String(f.step)
488
+ inp.value = String(forceUI[f.key])
489
+ inp.setAttribute('data-zh-aria', T(f.label))
490
+ inp.setAttribute('aria-label', T(f.label))
491
+ const out = el('span', 'val', Number(forceUI[f.key]).toFixed(f.fix))
492
+ // 拖动只改数字,松手(change)才重排:每动一像素重算三百轮布局,画面会卡成幻灯片
493
+ inp.oninput = () => {
494
+ out.textContent = Number(inp.value).toFixed(f.fix)
495
+ }
496
+ inp.onchange = () => {
497
+ forceUI[f.key] = Number(inp.value)
498
+ out.textContent = Number(inp.value).toFixed(f.fix)
499
+ saveForceUI(forceUI)
500
+ applyForceToStage()
501
+ }
502
+ row.appendChild(el('span', 'k', T(f.label)))
503
+ row.appendChild(inp)
504
+ row.appendChild(out)
505
+ sectF.appendChild(row)
506
+ }
507
+ const sectL = el('div', 'sect')
508
+ const h4l = el('h4', null, T('局部图(三维视图)'))
509
+ h4l.appendChild(attachFold(sectL, 'f:local'))
510
+ sectL.appendChild(h4l)
511
+ const rowL = el('div', 'slider')
512
+ const rangeL = document.createElement('input')
513
+ rangeL.type = 'range'
514
+ rangeL.min = '0'
515
+ rangeL.max = '4'
516
+ rangeL.step = '1'
517
+ rangeL.value = String(Number(state.localDepth) || 0)
518
+ rangeL.setAttribute('data-zh-aria', T('只看这几跳以内'))
519
+ rangeL.setAttribute('aria-label', T('只看这几跳以内'))
520
+ const valL = el('span', 'val', rangeL.value === '0' ? T('全图') : rangeL.value + T(' 跳'))
521
+ rangeL.oninput = () => {
522
+ valL.textContent = rangeL.value === '0' ? T('全图') : rangeL.value + T(' 跳')
523
+ }
524
+ rangeL.onchange = () => {
525
+ state.localDepth = Number(rangeL.value) || 0
526
+ const info = applyLocal()
527
+ if (state.localDepth > 0 && !state.selected) {
528
+ toast(T('先点一颗星,局部图才知道从谁出发'))
529
+ } else if (info) {
530
+ toast(T('局部图:') + state.localCount + T(' 条在 ') + state.localDepth + T(' 跳以内'))
531
+ }
532
+ }
533
+ rowL.appendChild(el('span', 'k', T('看得见')))
534
+ rowL.appendChild(rangeL)
535
+ rowL.appendChild(valL)
536
+ sectL.appendChild(rowL)
537
+ sectL.appendChild(el('div', 'filter-hint', T('以选中的那颗星为中心,只留 N 跳以内的邻居;拖回「全图」恢复')))
538
+ root.appendChild(sectF)
539
+ root.appendChild(sectL)
540
+
541
+ function syncWsFilter() {
542
+ const on = wsChips.filter((c) => c.classList.contains('on')).map((c) => c.dataset.ws)
543
+ state.filter.ws = on.length === wsChips.length ? null : new Set(on)
544
+ applyFilter()
545
+ }
546
+ function syncLevelFilter() {
547
+ const on = lvChips.filter((c) => c.classList.contains('on')).map((c) => c.dataset.level)
548
+ state.filter.levels = on.length === lvChips.length ? null : new Set(on)
549
+ applyFilter()
550
+ }
551
+ function syncProviderFilter() {
552
+ const on = provChips.filter((c) => c.classList.contains('on')).map((c) => c.dataset.provider)
553
+ state.filter.providers = on.length === provChips.length ? null : new Set(on)
554
+ applyFilter()
555
+ }
556
+ function syncTypeFilter() {
557
+ const on = typeChips.filter((c) => c.classList.contains('on')).map((c) => c.dataset.type)
558
+ state.filter.types = on.length === typeChips.length ? null : new Set(on)
559
+ applyFilter()
560
+ }
561
+
562
+ // 新的一批节点刚被 load 进来,hidden 标记还没跟上当前筛选 —— 这里补一次,
563
+ // 让「面板显示的筛选」和「画布上真正画出来的」从第一帧就一致。
564
+ applyFilter()
565
+ }
566
+
567
+ function section(title, chips, reset) {
568
+ const s = el('div', 'sect')
569
+ const h = document.createElement('h4')
570
+ h.appendChild(document.createTextNode(title))
571
+ const right = el('span', 'h4-r')
572
+ right.appendChild(attachFold(s, 'f:' + title))
573
+ const btn = document.createElement('button')
574
+ btn.textContent = T('全部')
575
+ btn.onclick = reset
576
+ right.appendChild(btn)
577
+ h.appendChild(right)
578
+ s.appendChild(h)
579
+ const box = el('div', 'chips')
580
+ for (const c of chips) box.appendChild(c)
581
+ s.appendChild(box)
582
+ return s
583
+ }
584
+
585
+ // ---------------- 记忆来源面板 ----------------
586
+ // 谁在写记忆:每个工作区一个 meow 库,外加装了哪些插件 / 技能 / MCP。
587
+ // 点工作区那一行就等于筛掉别的工作区,和左边 chips 联动。
588
+ /**
589
+ * 有来源读不动时的常驻横幅。
590
+ *
591
+ * 为什么要有它:这条信息原来只出现在两处——「记忆来源」面板里一行红色小字,
592
+ * 以及图第一次载入时两秒钟的 toast。于是最常见的现场是:某个工作区的库坏了、
593
+ * 图里少了一整个工作区的记忆,而人正看着这张图,什么都不知道。
594
+ * 横幅不消失,并且在概览标题上带一个计数,点一下跳到「记忆来源」看明细。
595
+ */
596
+ function renderReadErrors(ov) {
597
+ const box = $('#readerr')
598
+ if (!box) return
599
+ const list = (ov.readErrors || []).filter((e) => e && e.error)
600
+ if (!list.length) {
601
+ box.hidden = true
602
+ box.textContent = ''
603
+ return
604
+ }
605
+ box.hidden = false
606
+ box.innerHTML = ''
607
+ const icon = el('span', 're-icon', '!')
608
+ icon.setAttribute('aria-hidden', 'true')
609
+ box.appendChild(icon)
610
+ const text = el('span', 're-text')
611
+ const names = list.slice(0, 3).map((e) => e.key || e.title || '?')
612
+ const rest = list.length > 3 ? ' +' + (list.length - 3) : ''
613
+ text.textContent =
614
+ T('有 ') + list.length + T(' 个来源读不动:') + names.join(' / ') + rest + T(',这些记忆不在图里')
615
+ text.title = list.map((e) => (e.key || e.title || '?') + ' — ' + (e.error || '')).join('\n')
616
+ box.appendChild(text)
617
+ const go = el('button', 'mini re-go', T('看来源'))
618
+ go.onclick = () => {
619
+ const panel = $('#sources')
620
+ if (!panel) return
621
+ panel.scrollIntoView({ block: 'nearest' })
622
+ panel.focus()
623
+ }
624
+ box.appendChild(go)
625
+ }
626
+
627
+ // 体检是这张图里最贵的一步(20 万条要 12.9 秒)。概览现在不等它,先回来;
628
+ // 这里再去补一次,算完就更新 state 并重画打开着的面板。
629
+ // 只说一次「正在算」——不能把「算不出来」静默成「库里没问题」。
630
+ let hygieneLoading = null
631
+ function hydrateHygiene(ov) {
632
+ if (!ov || !ov.hygienePending || hygieneLoading) return hygieneLoading
633
+ hygieneLoading = (async () => {
634
+ try {
635
+ const r = await API.hygiene()
636
+ if (r && r.hygiene) {
637
+ state.hygiene = r.hygiene
638
+ if (state.over) {
639
+ state.over.hygiene = r.hygiene
640
+ if (r.cards) state.over.cards = r.cards
641
+ state.over.hygienePending = false
642
+ }
643
+ const boards = $('#boards')
644
+ if (boards && !boards.hidden) await renderBoards()
645
+ else if ($('#src-list')) await renderSources()
646
+ }
647
+ } catch (err) {
648
+ softWarn('hygiene', err)
649
+ } finally {
650
+ hygieneLoading = null
651
+ }
652
+ })()
653
+ return hygieneLoading
654
+ }
655
+
656
+ async function renderSources() {
657
+ const list = $('#src-list')
658
+ if (!list) return
659
+ let ov
660
+ try {
661
+ ov = await API.overview()
662
+ } catch (err) {
663
+ softWarn('overview', err)
664
+ list.innerHTML = ''
665
+ list.appendChild(el('div', 'dim', T('来源读不到:') + ((err && err.message) || err)))
666
+ return
667
+ }
668
+ list.innerHTML = ''
669
+ state.hygiene = ov.hygiene || null
670
+ // 体检没随概览回来时,自己再去取一次(大库上它要算十几秒)
671
+ hydrateHygiene(ov)
672
+ // 读不动的库:一条常驻横幅 + 概览标题上的计数。
673
+ // toast 只响两秒,去倒杯水回来的人不会知道图里少了一整个工作区。
674
+ renderReadErrors(ov)
675
+ // 库大到会影响手感时,面板上常驻一句实话(不是错误,是尺度的说明)
676
+ for (const w of ov.warnings || []) {
677
+ if (w.code === 'config-unreadable') {
678
+ // 配置坏了 → 用户加的来源整批不在图里。这句话必须看得见,不能只留在日志里。
679
+ const note = el('div', 'src src-note', T('配置文件读不出来:') + (w.message || ''))
680
+ note.title = w.message || ''
681
+ list.appendChild(note)
682
+ continue
683
+ }
684
+ if (w.code === 'source-truncated') {
685
+ const note = el('div', 'src src-note', T('来源被截断:') + (w.store || '') + T(' 只读了前 ') +
686
+ w.maxFiles + T(' 个文件,其余没有进图(调大该来源的 maxFiles)'));
687
+ note.title = w.message || ''
688
+ list.appendChild(note)
689
+ continue
690
+ }
691
+ if (w.code === 'store-recovered') {
692
+ // 星图自己的小库坏了:图照样起来了,但策展的连边与屏蔽记录要重做一遍。
693
+ const note = el('div', 'src src-note', T('星图自己的小库重建了:') + (w.message || ''))
694
+ note.title = w.message || ''
695
+ list.appendChild(note)
696
+ continue
697
+ }
698
+ if (w.code !== 'large-library') continue
699
+ const note = el('div', 'src src-note', T('库很大:') + w.nodes + T(' 条记忆,最近一次建图 ') + Math.round((w.buildMs || 0) / 1000) + T(' 秒。建议按工作区拆库。'))
700
+ note.title = w.message || ''
701
+ list.appendChild(note)
702
+ }
703
+ const tagn = $('#src-tag')
704
+ if (tagn) {
705
+ const bad = (ov.readErrors || []).length
706
+ tagn.textContent = (ov.stats?.nodes || 0) + T(' 条') + (bad ? ' · ' + bad + T(' 个库读不动') : '')
707
+ }
708
+
709
+ const num = (v) => (Array.isArray(v) ? v.length : Number(v) || 0)
710
+ const line = (k, v, note) => {
711
+ const row = el('div', 'src')
712
+ row.appendChild(el('span', null, k))
713
+ row.appendChild(el('span', 'n', v))
714
+ if (note) row.title = note
715
+ list.appendChild(row)
716
+ }
717
+ const wsList = (ov.workspaces || []).map((w) => `${w.name} ${w.count}`)
718
+ const inv = ov.inventory || {}
719
+ line(T('记忆库'), (ov.workspaces || []).length + T(' 个'), T('每个工作区一个 .dsh-meow/memory.db\n') + wsList.join('\n'))
720
+ // 读不动的库要单独列一行:只显示「0 条」会被当成记忆被删了
721
+ for (const s of ov.sources || []) {
722
+ if (!s.error) continue
723
+ const bad = el('div', 'src src-bad')
724
+ bad.appendChild(el('span', null, s.key || s.title || '?'))
725
+ bad.appendChild(el('span', 'n', T('读不动')))
726
+ bad.title = s.error
727
+ list.appendChild(bad)
728
+ }
729
+ line(T('已装插件'), num(inv.plugins), T('profile 里声明的全部插件'))
730
+ const memPlugins = inv.memoryPlugins || []
731
+ if (memPlugins.length) line(T('记忆类插件'), memPlugins.length, memPlugins.join('\n'))
732
+ line(T('技能'), num(inv.skills), T('SKILL.md 目录数'))
733
+ line('MCP', num(inv.mcp), (inv.mcpNames || []).join(' · '))
734
+
735
+ // 被人工否掉的关联:可以展开看、逐条恢复。
736
+ // 这张表就是「关联算错了」的出口,比删边更彻底——重建时也不会再连。
737
+ let mutes = []
738
+ let muteOk = true
739
+ try {
740
+ const r = await API.mutes()
741
+ mutes = r.mutes || []
742
+ } catch {
743
+ // 走到这里说明后台是旧版宿主(没有 /mutes),先不显示这一行,免得点了报错
744
+ muteOk = false
745
+ }
746
+ if (muteOk) {
747
+ const mRow = el('div', 'src src-click')
748
+ mRow.appendChild(el('span', null, T('已屏蔽关联')))
749
+ mRow.appendChild(el('span', 'n', mutes.length + T(' 条')))
750
+ mRow.title = mutes.length ? T('点一下展开,可以逐条恢复') : T('还没有屏蔽过任何关联')
751
+ list.appendChild(mRow)
752
+ if (mutes.length) {
753
+ const box = el('div', 'mutes')
754
+ box.style.display = 'none'
755
+ const label = (id) => {
756
+ const n = state.graph && state.graph.nodes.find((x) => x.id === id)
757
+ return n ? n.label || n.title || id : id.slice(-8)
758
+ }
759
+ for (const m of mutes.slice(0, 24)) {
760
+ const row = el('div', 'mute')
761
+ const t = el('div', 'mt', label(m.a) + ' ⇸ ' + label(m.b))
762
+ t.title = m.a + '\n' + m.b
763
+ row.appendChild(t)
764
+ const undo = el('button', 'mini', T('恢复'))
765
+ undo.onclick = async (ev) => {
766
+ ev.stopPropagation()
767
+ try {
768
+ await API.unmute(m.a, m.b)
769
+ toast(T('已恢复这条关联'))
770
+ await reload(false)
771
+ renderSources()
772
+ } catch (e) {
773
+ toast(T('恢复失败:') + e.message)
774
+ }
775
+ }
776
+ row.appendChild(undo)
777
+ box.appendChild(row)
778
+ }
779
+ list.appendChild(box)
780
+ mRow.onclick = () => {
781
+ box.style.display = box.style.display === 'none' ? 'block' : 'none'
782
+ }
783
+ }
784
+ }
785
+
786
+ // 记忆体检:把「越写越肥 / 没人读 / 疑似重复 / 关系是凑的」查成一张清单。
787
+ // 只诊断、不改记忆——这里点进去看,改不改由人(或 AI)决定。
788
+ const hy = ov.hygiene
789
+ if (hy && hy.total) {
790
+ // [macro-fusion 0.4.0] 后三项是写入端通胀(P2.5):前六项看「这条记忆本身」,
791
+ // 后三项看「写入与检索被同一批词反复喂」——同一张卡片里放,但门槛比前六项高,免得噪声常驻。
792
+ const HORDER = ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan', 'selfecho', 'unused', 'inflate']
793
+ const HMIN = { dup: 1, stale: 1, thin: 1, oversize: 2, unread: 6, orphan: 6, selfecho: 3, unused: 3, inflate: 1 }
794
+ const kinds = HORDER.filter((k) => (hy.counts?.[k] || 0) >= (HMIN[k] || 1))
795
+ if (kinds.length) {
796
+ const head = el('div', 'src src-click')
797
+ head.appendChild(el('span', null, T('记忆体检')))
798
+ head.appendChild(el('span', 'n', hy.total + T(' 项')))
799
+ head.title = T('不是说记忆写错了,是说它们该整理、该更新、该被用起来\n点一下展开')
800
+ list.appendChild(head)
801
+
802
+ const box = el('div', 'mutes')
803
+ box.style.display = 'none'
804
+ for (const k of kinds) {
805
+ const meta = (hy.meta && hy.meta[k]) || { label: k, hint: '' }
806
+ const wrap = el('div', 'hy')
807
+ const items = (hy.items?.[k] || []).slice(0, 5)
808
+ // 标题里的「只列前 N 条」说的必须是**屏幕上真的画了几条**(5 条),
809
+ // 不能用服务端 40 条的上限——否则标题与下面的行数互相打脸。
810
+ const shownN = items.length
811
+ const capped = shownN < (hy.counts?.[k] || 0)
812
+ const title = el('div', 'hy-t', meta.label + ' · ' + hy.counts[k] + (capped ? T(' · 只列前 ') + shownN + T(' 条') : ''))
813
+ title.title = meta.hint || ''
814
+ wrap.appendChild(title)
815
+ for (const it of items) {
816
+ let text = ''
817
+ let jump = null
818
+ if (k === 'dup') {
819
+ text = (it.a.label || '').slice(0, 22) + ' ⇄ ' + (it.b.label || '').slice(0, 22) + ' · ' + it.sim
820
+ jump = it.a.id
821
+ } else if (k === 'stale') {
822
+ text = (it.label || '').slice(0, 26) + ' · ' + it.days + T(' 天')
823
+ jump = it.id
824
+ } else if (k === 'thin') {
825
+ text = (it.label || '').slice(0, 26) + T(' · 均 ') + it.avg
826
+ jump = it.id
827
+ } else if (k === 'oversize') {
828
+ text = (it.label || '').slice(0, 24) + ' · ' + it.size + T(' 字')
829
+ jump = it.id
830
+ } else if (k === 'unread') {
831
+ text = (it.label || '').slice(0, 26) + ' · ' + it.days + T(' 天')
832
+ jump = it.id
833
+ } else if (k === 'selfecho') {
834
+ text = (it.label || '').slice(0, 26) + ' · ' + Math.round((it.rate || 0) * 100) + '%' + T(' 自证') + ' (' + it.echo + '/' + it.kws + ')'
835
+ jump = it.id
836
+ } else if (k === 'unused') {
837
+ text = (it.label || '').slice(0, 26) + T(' · 命中 ') + it.hits + T(' 次没读过')
838
+ jump = it.id
839
+ } else {
840
+ text = (it.label || '').slice(0, 28)
841
+ jump = it.id
842
+ }
843
+ const row = el('div', 'hy-i', text)
844
+ row.onclick = () => jump && showDetail(jump)
845
+ wrap.appendChild(row)
846
+ }
847
+ if ((hy.counts?.[k] || 0) > items.length) {
848
+ wrap.appendChild(el('div', 'hy-more', T('还有 ') + (hy.counts[k] - items.length) + T(' 条(用 nebula_stats 看全量)')))
849
+ }
850
+ box.appendChild(wrap)
851
+ }
852
+ list.appendChild(box)
853
+ head.onclick = () => {
854
+ box.style.display = box.style.display === 'none' ? 'block' : 'none'
855
+ }
856
+ }
857
+ }
858
+
859
+ const tip = el('div', 'dim', T('记忆本体只读:星图只读 meow-memory 的数据库,不改任何一条原文。'))
860
+ list.appendChild(tip)
861
+ }
862
+
863
+ function clusterColor(graph, ws) {
864
+ const c = (graph.clusters || []).find((x) => x.id === ws || x.title === ws)
865
+ return (c && c.color) || '#6cc8ff'
866
+ }
867
+
868
+ // ---------------- 项目卡片(交接卡) ----------------
869
+ // 一个工作区一张:现状(条数/层级/项目)· 最近变更 · 下一步与卡点 · 代表记忆 · 健康项。
870
+ // 数据来自引擎的 /overview.cards,这里只排版面,不做判断。
871
+ function agoText(ts) {
872
+ if (!ts) return ''
873
+ const m = Math.round((Date.now() - ts) / 60000)
874
+ if (m < 1) return T('刚刚')
875
+ if (m < 60) return m + T(' 分钟前')
876
+ const h = Math.round(m / 60)
877
+ if (h < 24) return h + T(' 小时前')
878
+ const d = Math.round(h / 24)
879
+ if (d < 30) return d + T(' 天前')
880
+ return Math.round(d / 30) + T(' 个月前')
881
+ }
882
+
883
+ const HY_NAME = {
884
+ dup: T('疑似重复'),
885
+ oversize: T('太长'),
886
+ stale: T('该更新'),
887
+ unread: T('没人读'),
888
+ thin: T('关系凑数'),
889
+ orphan: T('孤立'),
890
+ }
891
+
892
+ function closeCards() {
893
+ const box = $('#cards')
894
+ if (box) box.hidden = true
895
+ }
896
+
897
+ // 只看一个工作区:直接点掉别的工作区 chip,复用原来的筛选逻辑
898
+ function focusWorkspace(ws) {
899
+ const chips = [...document.querySelectorAll('#filters .chip[data-ws]')]
900
+ const target = chips.find((c) => c.dataset.ws === ws)
901
+ if (!target) return
902
+ for (const c of chips) {
903
+ const on = c.classList.contains('on')
904
+ if (c === target && !on) c.click()
905
+ else if (c !== target && on) c.click()
906
+ }
907
+ if (state.stage) state.stage.fit()
908
+ toast(T('只看 ') + ws)
909
+ }
910
+
911
+ async function openCards() {
912
+ const box = $('#cards')
913
+ const grid = $('#cards-grid')
914
+ if (!box || !grid) return
915
+ box.hidden = false
916
+ grid.innerHTML = ''
917
+ grid.appendChild(el('div', 'pc-empty', T('正在汇总…')))
918
+ let ov
919
+ try {
920
+ ov = await API.overview()
921
+ } catch (err) {
922
+ grid.innerHTML = ''
923
+ grid.appendChild(el('div', 'pc-empty', T('读取失败:') + ((err && err.message) || err)))
924
+ return
925
+ }
926
+ const cards = (ov.cards && ov.cards.cards) || []
927
+ const sub = $('#cards-sub')
928
+ if (sub) {
929
+ sub.textContent =
930
+ cards.length + T(' 个工作区 · 共 ') + (ov.stats ? ov.stats.nodes : 0) + T(' 条记忆 · ') + agoText((ov.cards && ov.cards.generatedAt) || Date.now())
931
+ }
932
+ grid.innerHTML = ''
933
+ if (!cards.length) {
934
+ grid.appendChild(el('div', 'pc-empty', T('还没有可汇总的记忆')))
935
+ return
936
+ }
937
+ for (const c of cards) {
938
+ const card = el('div', 'pcard')
939
+ const head = el('div', 'pc-head')
940
+ const title = el('div', 'pc-title', c.title)
941
+ title.title = T('点一下:星图里只看这个项目')
942
+ title.onclick = () => {
943
+ closeCards()
944
+ focusWorkspace(c.ws)
945
+ }
946
+ head.appendChild(title)
947
+ head.appendChild(el('div', 'pc-n', c.total + T(' 条')))
948
+ card.appendChild(head)
949
+
950
+ const meta = el('div', 'pc-meta')
951
+ const lv = c.levels || {}
952
+ for (const k of ['project', 'lesson', 'topic', 'fact', 'user', 'rules', 'soul']) {
953
+ if (!lv[k]) continue
954
+ meta.appendChild(el('span', 'pc-tag', (LEVEL_LABEL[k] || k) + ' ' + lv[k]))
955
+ }
956
+ if (c.sessions) meta.appendChild(el('span', 'pc-tag', c.sessions + T(' 个会话')))
957
+ for (const p of (c.projects || []).slice(0, 3)) meta.appendChild(el('span', 'pc-tag', p))
958
+ card.appendChild(meta)
959
+
960
+ const sec = (t) => card.appendChild(el('div', 'pc-sec', t))
961
+ const row = (txt, id, hint) => {
962
+ const d = el('div', 'pc-row', txt)
963
+ if (hint) d.title = hint
964
+ if (id) {
965
+ d.onclick = () => {
966
+ closeCards()
967
+ showDetail(id)
968
+ if (state.stage) state.stage.focusNode(id, 2.4)
969
+ }
970
+ }
971
+ card.appendChild(d)
972
+ }
973
+
974
+ if ((c.recent || []).length) {
975
+ sec(T('最近变更'))
976
+ for (const r of c.recent) row(r.label, r.id, agoText(r.at) + ' · ' + (LEVEL_LABEL[r.level] || r.level))
977
+ }
978
+ sec(T('下一步与卡点'))
979
+ if ((c.todos || []).length) {
980
+ for (const t of c.todos) row(t.label, t.id, 'importance ' + (t.importance || 1) + (t.goal ? ' · ' + t.goal : ''))
981
+ } else {
982
+ card.appendChild(el('div', 'pc-empty', T('没有 active 的 todo 条目')))
983
+ }
984
+ if ((c.hubs || []).length) {
985
+ sec(T('代表记忆'))
986
+ for (const h of c.hubs) row(h.label, h.id, T('重要度 ') + h.importance + ' · ' + h.degree + T(' 条连接'))
987
+ }
988
+ const health = Object.entries(c.health || {}).filter(([, v]) => v)
989
+ if (health.length) {
990
+ const hbox = el('div', 'pc-health')
991
+ for (const [k, v] of health) hbox.appendChild(el('i', null, (HY_NAME[k] || k) + ' ' + v))
992
+ card.appendChild(hbox)
993
+ }
994
+ grid.appendChild(card)
995
+ }
996
+ }
997
+
998
+ /**
999
+ * 取图的唯一入口:默认走 API.graph,测试可以用 state.fetchGraph 换掉它
1000
+ * (真浏览器里验「自动往后翻页」时,不然得先造一个几十页的库)。
1001
+ */
1002
+ const fetchGraph = (opts) => (typeof state.fetchGraph === 'function' ? state.fetchGraph(opts) : API.graph(opts))
1003
+
1004
+ /** 把当前筛选套到渲染器上(不负责提示文案)。 */
1005
+ function applyFilterToStage() {
1006
+ if (!state.stage || !state.stage.setFilter) return
1007
+ state.stage.setFilter({
1008
+ ws: state.filter.ws,
1009
+ levels: state.filter.levels,
1010
+ types: state.filter.types,
1011
+ providers: state.filter.providers,
1012
+ minW: state.filter.minW,
1013
+ minImp: state.filter.minImp,
1014
+ })
1015
+ }
1016
+
1017
+ /** 现在屏幕上还剩多少颗星星(渲染器没准备好时退回整图条数)。 */
1018
+ function visibleCount() {
1019
+ try {
1020
+ const vis = state.stage && state.stage.visibleNodes ? state.stage.visibleNodes() : null
1021
+ if (Array.isArray(vis)) return vis.length
1022
+ } catch {}
1023
+ return ((state.graph && state.graph.nodes) || []).length
1024
+ }
1025
+
1026
+ function filterActive() {
1027
+ const f = state.filter
1028
+ return !!(f.ws || f.levels || f.types || f.providers || f.minW > 0 || f.minImp > 0)
1029
+ }
1030
+
1031
+ function applyFilter() {
1032
+ applyFilterToStage()
1033
+ updateFilterHint()
1034
+ maybeAutoFill()
1035
+ }
1036
+
1037
+ /**
1038
+ * 筛选命中在还没加载的那几页里时,替用户往后翻——而不是让他自己一页页点「继续加载」。
1039
+ * 上限 3 页:再多就是「筛了个空条件」,应该给结论而不是把整个库读进来。
1040
+ */
1041
+ let autoFillBusy = false
1042
+ const AUTO_FILL_PAGES = 3
1043
+
1044
+ async function autoFillForFilter() {
1045
+ if (autoFillBusy) return null
1046
+ const page = state.page
1047
+ if (!page || page.next == null || !filterActive()) return null
1048
+ if (state.modeKey !== 'nebula') return null
1049
+ autoFillBusy = true
1050
+ let fetched = 0
1051
+ let added = 0
1052
+ try {
1053
+ while (fetched < AUTO_FILL_PAGES) {
1054
+ const cur = state.page
1055
+ if (!cur || cur.next == null) break
1056
+ const next = await fetchGraph({
1057
+ offset: cur.next,
1058
+ limit: cur.limit,
1059
+ sig: (state.graph && state.graph.sig) || '',
1060
+ })
1061
+ const got = mergePage(next)
1062
+ fetched++
1063
+ added += got.added || 0
1064
+ applyFilterToStage()
1065
+ updateFilterHint()
1066
+ if (visibleCount() > 0) break
1067
+ if (!got.added) break
1068
+ }
1069
+ } catch (err) {
1070
+ if (err && err.status === 409) toast(T('星图刚更新过,已从第一页重新加载'))
1071
+ else toast(T('这一页没加载上:') + ((err && err.message) || err))
1072
+ return null
1073
+ } finally {
1074
+ autoFillBusy = false
1075
+ renderPageBar()
1076
+ }
1077
+ if (!fetched) return null
1078
+ const shown = visibleCount()
1079
+ if (shown > 0) {
1080
+ toast(T('筛选命中在后面的页里:已往后加载 {n} 页,找到 {m} 条').replace('{n}', fetched).replace('{m}', shown))
1081
+ } else {
1082
+ toast(T('已往后加载 {n} 页,仍没找到匹配;可以再点底部「继续加载」').replace('{n}', fetched))
1083
+ }
1084
+ return { fetched, added, shown }
1085
+ }
1086
+
1087
+ /** 一次性触发:只有「筛选是活的、屏上一颗都没有、还有下一页」才值得翻。 */
1088
+ function maybeAutoFill() {
1089
+ const page = state.page
1090
+ if (!page || page.next == null || !filterActive()) return
1091
+ if (visibleCount() > 0) return
1092
+ autoFillForFilter().catch(() => {})
1093
+ }
1094
+
1095
+ /** 一行字告诉你「现在的筛选让多少东西看不见了」,避免误以为图坏了。 */
1096
+ function updateFilterHint() {
1097
+ const box = $('#filter-hint')
1098
+ if (!box || !state.graph) return
1099
+ const total = (state.graph.nodes || []).length
1100
+ const totalEdges = (state.graph.edges || []).length
1101
+ const shown = visibleCount()
1102
+ const hidden = Math.max(0, total - shown)
1103
+ const f = state.filter
1104
+ const active = !!(f.ws || f.levels || f.types || f.providers || f.minW > 0 || f.minImp > 0)
1105
+ if (!active && !hidden) {
1106
+ box.textContent = ''
1107
+ box.classList.remove('warn')
1108
+ clearFilterEmptyHint()
1109
+ return
1110
+ }
1111
+ box.classList.add('warn')
1112
+ box.textContent =
1113
+ T('已筛选:隐藏 ') + hidden + T(' 条记忆') + (f.minW > 0 ? T(' / 弱连接 ') + f.minW.toFixed(2) + T(' 以下不画') : '') + T('(共 ') + totalEdges + T(' 条连接)')
1114
+ // 全被筛掉时不能只留一片空屏——那看着和图坏了没区别。给一句话和一个出口。
1115
+ const hint = $('#hint')
1116
+ if (hint) {
1117
+ if (total > 0 && shown === 0) {
1118
+ hint.innerHTML = ''
1119
+ hint.appendChild(el('b', null, T('这一屏没有记忆')))
1120
+ // 分了页之后「整张图」不等于「全部记忆」:这条筛选可能只是命中在还没加载的页里。
1121
+ // 这时叫用户去重置筛选是错的建议,会把他的筛选白丢掉。
1122
+ const more = state.page && state.page.next != null ? state.page.next : null
1123
+ if (more != null) {
1124
+ hint.appendChild(
1125
+ document.createTextNode(
1126
+ T('当前已加载 ') + total + ' / ' + (state.page.total || total) + T(' 条里没有匹配 · 可能还在后面的页里:点底部「继续加载」,或用搜索直接找'),
1127
+ ),
1128
+ )
1129
+ } else {
1130
+ hint.appendChild(document.createTextNode(T('当前筛选把整张图都藏起来了 · Shift + F 或左栏「重置筛选」回到全视图')))
1131
+ }
1132
+ hint.classList.add('show')
1133
+ hint.dataset.byFilter = '1'
1134
+ } else {
1135
+ clearFilterEmptyHint()
1136
+ }
1137
+ }
1138
+ }
1139
+
1140
+ /** 只清掉「被筛空」这条提示,不碰搜索/空库的提示。 */
1141
+ function clearFilterEmptyHint() {
1142
+ const hint = $('#hint')
1143
+ if (!hint || hint.dataset.byFilter !== '1') return
1144
+ hint.classList.remove('show')
1145
+ hint.innerHTML = ''
1146
+ delete hint.dataset.byFilter
1147
+ }
1148
+
1149
+ /** 一键回到全视图:清空筛选 + 2D/3D 都回到 fit 位置。 */
1150
+ function resetFilters() {
1151
+ state.filter = { ws: null, levels: null, types: null, providers: null, minW: 0, minImp: 0 }
1152
+ for (const c of document.querySelectorAll('#filters .chip')) {
1153
+ if (!c.classList.contains('reset')) c.classList.add('on')
1154
+ }
1155
+ for (const r of document.querySelectorAll('#filters input[type=range]')) {
1156
+ r.value = r.max === '90' ? '0' : '0'
1157
+ const v = r.parentNode && r.parentNode.querySelector('.val')
1158
+ if (v) v.textContent = r.max === '4' ? '0' : '0.00'
1159
+ }
1160
+ applyFilter()
1161
+ if (state.stage) state.stage.fit()
1162
+ toast(T('已回到全视图'))
1163
+ }
1164
+
1165
+ // ---------------- 图例 ----------------
1166
+ function renderLegend(graph) {
1167
+ const box = $('#legend')
1168
+ box.innerHTML = ''
1169
+ const levels = new Set((graph.nodes || []).map((n) => n.level))
1170
+ for (const key of ['project', 'lesson', 'topic', 'fact', 'user', 'rules', 'soul', 'source']) {
1171
+ if (!levels.has(key)) continue
1172
+ const lg = el('div', 'lg')
1173
+ if (key === 'source') {
1174
+ const dia = el('i')
1175
+ dia.style.width = '7px'
1176
+ dia.style.height = '7px'
1177
+ dia.style.background = 'transparent'
1178
+ dia.style.border = `1.5px solid ${LEVEL_COLOR.source}`
1179
+ dia.style.transform = 'rotate(45deg)'
1180
+ dia.style.boxShadow = `0 0 7px ${LEVEL_COLOR.source}`
1181
+ lg.appendChild(dia)
1182
+ } else {
1183
+ const dot = el('i')
1184
+ dot.style.width = '7px'
1185
+ dot.style.height = '7px'
1186
+ dot.style.borderRadius = '50%'
1187
+ dot.style.background = LEVEL_COLOR[key]
1188
+ dot.style.boxShadow = `0 0 7px ${LEVEL_COLOR[key]}`
1189
+ lg.appendChild(dot)
1190
+ }
1191
+ lg.appendChild(el('span', null, LEVEL_LABEL[key] || key))
1192
+ box.appendChild(lg)
1193
+ }
1194
+ }
1195
+
1196
+ // ---------------- 搜索 ----------------
1197
+ const qInput = $('#q')
1198
+ /** 清空搜索并把焦点还给画布:Esc、空结果里的「清空搜索」共用同一条退路。 */
1199
+ function clearSearch() {
1200
+ qInput.value = ''
1201
+ state.query = ''
1202
+ state.hits = []
1203
+ $('#hits').classList.remove('show')
1204
+ state.stage.highlight(null, false)
1205
+ qInput.blur()
1206
+ }
1207
+ qInput.addEventListener('input', () => {
1208
+ clearTimeout(state.timer)
1209
+ const q = qInput.value.trim()
1210
+ state.query = q
1211
+ if (!q) {
1212
+ $('#hits').classList.remove('show')
1213
+ return
1214
+ }
1215
+ state.timer = setTimeout(runSearch, 240)
1216
+ })
1217
+ qInput.addEventListener('keydown', (ev) => {
1218
+ if (ev.key === 'Enter') {
1219
+ ev.preventDefault()
1220
+ // 结果来了默认高亮第一条;回车打开高亮那条(没高亮过就是第一条)
1221
+ if (state.hits.length) pickHit(state.hits[Math.max(0, state.hitIndex | 0)])
1222
+ } else if (ev.key === 'ArrowDown') {
1223
+ ev.preventDefault()
1224
+ setHitIndex((state.hitIndex | 0) + 1, true)
1225
+ } else if (ev.key === 'ArrowUp') {
1226
+ ev.preventDefault()
1227
+ // 在第一条上按 ↑ 绕到最后一条,别卡住不动
1228
+ setHitIndex(state.hitIndex <= 0 ? state.hits.length - 1 : state.hitIndex - 1, true)
1229
+ } else if (ev.key === 'Escape') {
1230
+ // 顺手把焦点还给画布:否则人以为「Esc 已经退出了」,其实键盘还留在输入框里,
1231
+ // 后面的 1/2/3、f、r 全被吞掉(看起来像快捷键坏了)。
1232
+ clearSearch()
1233
+ }
1234
+ })
1235
+ /* ── 看板(来源 / 真源 / 体检 / 屏蔽) ───────────────────────────── */
1236
+
1237
+ let boardTab = 'src'
1238
+
1239
+ function closeBoards() {
1240
+ const box = $('#boards')
1241
+ if (box) box.hidden = true
1242
+ }
1243
+
1244
+ async function openBoards(tab) {
1245
+ const box = $('#boards')
1246
+ if (!box) return
1247
+ box.hidden = false
1248
+ boardTab = tab || boardTab
1249
+ for (const b of document.querySelectorAll('#board-tabs .btab')) b.classList.toggle('on', b.dataset.tab === boardTab)
1250
+ await renderBoards()
1251
+ }
1252
+
1253
+ async function renderBoards() {
1254
+ const body = $('#boards-body')
1255
+ if (!body) return
1256
+ body.innerHTML = ''
1257
+ // 屏蔽页只读自己的列表:不必先等 overview(那一趟在数据大时挺慢)
1258
+ if (boardTab === 'mute') return renderBoardMute(body)
1259
+ body.appendChild(el('div', 'bd-dim', T('正在读…')))
1260
+ let ov
1261
+ try {
1262
+ ov = await API.overview()
1263
+ } catch (err) {
1264
+ body.innerHTML = ''
1265
+ body.appendChild(el('div', 'bd-dim', T('读取失败:') + ((err && err.message) || err)))
1266
+ return
1267
+ }
1268
+ state.over = ov
1269
+ // 体检没算完就不该卡住整个看板:先画别的,算好了再补
1270
+ hydrateHygiene(ov)
1271
+ body.innerHTML = ''
1272
+ if (boardTab === 'src') return renderBoardSources(body, ov)
1273
+ if (boardTab === 'truth') return renderBoardTruth(body, ov)
1274
+ if (boardTab === 'health') return renderBoardHealth(body, ov)
1275
+ return renderBoardMute(body)
1276
+ }
1277
+
1278
+ function boardRow(body, label, dim, act, onClick) {
1279
+ const row = el('div', 'bd-row')
1280
+ row.appendChild(el('b', '', label))
1281
+ if (dim) row.appendChild(el('span', 'bd-dim', dim))
1282
+ if (act) row.appendChild(el('span', 'bd-act', act))
1283
+ if (onClick) row.onclick = onClick
1284
+ body.appendChild(row)
1285
+ return row
1286
+ }
1287
+
1288
+ function renderBoardSources(body, ov) {
1289
+ const inv = ov.inventory || {}
1290
+ const libs = (ov.workspaces || []).filter((w) => (w.name || w.title) !== '来源')
1291
+ body.appendChild(el('div', 'bd-sec', T('记忆库(只读)')))
1292
+ for (const w of libs) {
1293
+ const name = w.name || w.title
1294
+ boardRow(body, name, (w.count != null ? w.count : w.size) + T(' 条'), T('只看它 →'), () => {
1295
+ closeBoards()
1296
+ focusWorkspace(name)
1297
+ })
1298
+ }
1299
+ body.appendChild(el('div', 'bd-sec', T('记忆类插件 / MCP / 技能')))
1300
+ boardRow(body, T('已装插件 ') + (inv.plugins || 0) + T(' · 记忆类 ') + (inv.memoryPlugins || []).length, (inv.memoryPlugins || []).join('、'), '')
1301
+ boardRow(body, 'MCP ' + (inv.mcp || 0), (inv.mcpNames || []).join('、'), '')
1302
+ boardRow(body, T('技能 ') + (inv.skills || 0), '', '')
1303
+ body.appendChild(el('div', 'bd-sec', T('外部记忆源')))
1304
+ for (const e of (ov.externals && ov.externals.items) || []) {
1305
+ boardRow(body, e.name + (e.ok ? T(' · 可读') : T(' · 暂不可读')), e.note, '')
1306
+ }
1307
+ }
1308
+
1309
+ function renderBoardTruth(body, ov) {
1310
+ const t = ov.truth || { total: 0, groups: [] }
1311
+ body.appendChild(el('div', 'bd-sec', T('声明过自己是权威的记忆:') + t.total + T(' 条 / ') + t.groups.length + T(' 个项目')))
1312
+ if (!t.total) body.appendChild(el('div', 'bd-dim', T('还没有记忆在正文里声明「以…为准」。')))
1313
+ for (const g of t.groups) {
1314
+ body.appendChild(el('div', 'bd-sec', g.project + '(' + g.items.length + ')'))
1315
+ for (const it of g.items) {
1316
+ boardRow(body, it.label, (LEVEL_LABEL[it.level] || it.level) + ' · ' + it.ws, T('打开 →'), () => {
1317
+ closeBoards()
1318
+ showDetail(it.id)
1319
+ })
1320
+ }
1321
+ }
1322
+ }
1323
+
1324
+ function renderBoardHealth(body, ov) {
1325
+ // 体检还没算出来(大库上要十几秒):说清楚在算,别画成「没查出问题」
1326
+ if (ov.hygienePending && !ov.hygiene) {
1327
+ body.appendChild(el('div', 'bd-sec', T('体检:')))
1328
+ body.appendChild(el('div', 'bd-dim', T('正在算(库大时要十几秒,算完这里会自己填上)…')))
1329
+ return
1330
+ }
1331
+ const h = ov.hygiene || { total: 0, items: {} }
1332
+ body.appendChild(el('div', 'bd-sec', T('体检:') + (h.total || 0) + T(' 项 · 只诊断不改库')))
1333
+ const groups = h.items && !Array.isArray(h.items) ? Object.entries(h.items) : []
1334
+ if (!groups.length) {
1335
+ body.appendChild(el('div', 'bd-dim', T('没查出问题。')))
1336
+ return
1337
+ }
1338
+ for (const [kind, arr] of groups) {
1339
+ if (!arr || !arr.length) continue
1340
+ body.appendChild(el('div', 'bd-sec', (HY_NAME[kind] || kind) + '(' + arr.length + ')'))
1341
+ for (const it of arr.slice(0, 8)) {
1342
+ if (kind === 'dup' && it.a && it.b) {
1343
+ // 疑似重复:两条并排显示,点哪条看哪条
1344
+ boardRow(body, 'A ' + (it.a.label || '').slice(0, 40), 'B ' + (it.b.label || '').slice(0, 40), T('对比 →'), () => {
1345
+ closeBoards()
1346
+ showDetail(it.a.id)
1347
+ })
1348
+ continue
1349
+ }
1350
+ boardRow(body, (it.label || it.title || it.id || '').slice(0, 64), (it.ws || '') + (it.importance ? T(' · 重要度 ') + it.importance : ''), T('打开 →'), () => {
1351
+ closeBoards()
1352
+ showDetail(it.id)
1353
+ })
1354
+ }
1355
+ if (arr.length > 8) body.appendChild(el('div', 'bd-dim', T('…还有 ') + (arr.length - 8) + T(' 条')))
1356
+ }
1357
+ }
1358
+
1359
+ async function renderBoardMute(body) {
1360
+ let list = []
1361
+ try {
1362
+ const r = await API.mutes()
1363
+ list = (r && r.mutes) || []
1364
+ } catch (err) {
1365
+ // 读不到 ≠ 没有屏蔽:别让人以为列表被清空了
1366
+ softWarn('mutes-board', err)
1367
+ body.appendChild(el('div', 'bd-sec', T('已屏蔽的关联')))
1368
+ body.appendChild(el('div', 'bd-dim', T('屏蔽列表读不到:') + ((err && err.message) || err)))
1369
+ return
1370
+ }
1371
+ body.appendChild(el('div', 'bd-sec', T('已屏蔽的关联:') + list.length))
1372
+ if (!list.length) body.appendChild(el('div', 'bd-dim', T('没有屏蔽任何关联。')))
1373
+ // 光给 id 尾号没人认得出来:能从当前图上找到就显示记忆标题,找不到才退回尾号
1374
+ const byId = new Map(((state.graph && state.graph.nodes) || []).map((n) => [n.id, n]))
1375
+ const nameOf = (id) => {
1376
+ const n = byId.get(id)
1377
+ const label = (n && (n.label || n.title)) || ''
1378
+ return label ? (label.length > 26 ? label.slice(0, 26) + '…' : label) : (id || '').slice(-12)
1379
+ }
1380
+ for (const m of list) {
1381
+ const row = boardRow(body, nameOf(m.a) + ' ⇸ ' + nameOf(m.b), m.note || '', T('恢复'))
1382
+ row.title = (m.a || '') + ' ⇸ ' + (m.b || '')
1383
+ const act = row.querySelector('.bd-act')
1384
+ act.onclick = async (ev) => {
1385
+ ev.stopPropagation()
1386
+ // 服务端撤完还要重建一次图(~3s),当场给个「恢复中」,别让人以为没点上
1387
+ const label = act.textContent
1388
+ act.textContent = T('恢复中…')
1389
+ act.style.pointerEvents = 'none'
1390
+ try {
1391
+ await API.unmute(m.a, m.b)
1392
+ toast(T('已恢复'))
1393
+ renderBoards()
1394
+ } catch (err) {
1395
+ act.textContent = label
1396
+ act.style.pointerEvents = ''
1397
+ toast(T('恢复失败:') + ((err && err.message) || err))
1398
+ }
1399
+ }
1400
+ }
1401
+ }
1402
+
1403
+ /* ── 导出:一张能直接发出去的图 / 一份能再分析的子图 ──────────────── */
1404
+
1405
+ /** 系统级的「减少动态效果」:动画、自动旋转都要让路。 */
1406
+ function reduceMotion() {
1407
+ return !!(window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches)
1408
+ }
1409
+
1410
+ function stamp() {
1411
+ const d = new Date()
1412
+ const p = (x) => String(x).padStart(2, '0')
1413
+ return (
1414
+ d.getFullYear() +
1415
+ p(d.getMonth() + 1) +
1416
+ p(d.getDate()) +
1417
+ '-' +
1418
+ p(d.getHours()) +
1419
+ p(d.getMinutes()) +
1420
+ p(d.getSeconds())
1421
+ )
1422
+ }
1423
+
1424
+ function download(name, blob) {
1425
+ const url = URL.createObjectURL(blob)
1426
+ const a = el('a')
1427
+ a.href = url
1428
+ a.download = name
1429
+ document.body.appendChild(a)
1430
+ a.click()
1431
+ a.remove()
1432
+ // blob URL 是下载的数据源:revoke 早了,浏览器写盘写到一半就被抽走,
1433
+ // 事件里会看到 receivedBytes 已满、state 却是 canceled。留足一分钟。
1434
+ setTimeout(() => URL.revokeObjectURL(url), 60000)
1435
+ }
1436
+
1437
+ /** 把「现在看到的画面」连同一条标题栏拼成 PNG(界面元素不进图)。 */
1438
+ /**
1439
+ * 把一张星图打包成一个 HTML:样式、脚本、数据全在里面,双击就能看。
1440
+ * 不带参数是整张图;opts.ws 只导一个工作区,opts.focus 只导选中节点周围 2 跳。
1441
+ * 范围外的记忆根本不会写进文件——隐私不是靠前端藏起来。
1442
+ * 文件里含记忆全文,是「用户主动下载」的动作,不会上传到任何地方。
1443
+ */
1444
+ function exportShare(opts = {}) {
1445
+ if (API.snapshot) {
1446
+ toast(T('这已经是一份离线快照了'))
1447
+ return
1448
+ }
1449
+ if (API.demo) {
1450
+ toast(T('示例星系不导出:先点顶部「退出示例」,再导你自己的星图'))
1451
+ return
1452
+ }
1453
+ const u = new URL(API.base + '/share', location.origin)
1454
+ let what = T('整张星图')
1455
+ const hideDiary = Boolean($('#hide-diary')?.checked)
1456
+ if (hideDiary && opts.ws === '日记') {
1457
+ toast(T('这个工作区就是「日记」:要么取消勾选,要么换个范围再导'))
1458
+ return
1459
+ }
1460
+ if (hideDiary) u.searchParams.append('hide', 'ws:日记')
1461
+ if (opts.focus) {
1462
+ u.searchParams.set('scope', 'focus:' + opts.focus)
1463
+ u.searchParams.set('hops', '2')
1464
+ what = T('选中节点周围 2 跳')
1465
+ } else if (opts.ws) {
1466
+ u.searchParams.set('scope', 'ws:' + opts.ws)
1467
+ what = T('工作区「') + opts.ws + '」'
1468
+ }
1469
+ toast(T('正在打包') + what + (hideDiary ? T('(已隐去日记)') : '') + T(';下载名带范围和本地时间,不会覆盖上一份'))
1470
+ location.href = u.toString()
1471
+ }
1472
+
1473
+ function diagnosticsText() {
1474
+ const g = state.graph || {}
1475
+ const st = g.stats || {}
1476
+ const meta = API.meta || {}
1477
+ const n = (v) => Number(v || 0)
1478
+ let gl = 'unavailable'
1479
+ try {
1480
+ const c = document.createElement('canvas')
1481
+ const ctx = c.getContext('webgl2') || c.getContext('webgl')
1482
+ if (ctx) {
1483
+ const dbg = ctx.getExtension('WEBGL_debug_renderer_info')
1484
+ gl = String(dbg ? ctx.getParameter(dbg.UNMASKED_RENDERER_WEBGL) : ctx.getParameter(ctx.RENDERER) || 'webgl')
1485
+ } else {
1486
+ gl = 'none'
1487
+ }
1488
+ } catch {}
1489
+ const lines = [
1490
+ 'memory-nebula diagnostics',
1491
+ T('# 不含记忆正文;可以整段贴给支持'),
1492
+ 'version: ' + APP_VERSION + (state.engineVersion && state.engineVersion !== APP_VERSION ? ' (engine ' + state.engineVersion + ')' : ''),
1493
+ 'build: ' + (meta.build || 'unknown'),
1494
+ 'mode: ' + (API.snapshot ? 'snapshot' : API.demo ? 'demo' : (meta.mode || 'host')) + ' / ' + (state.modeKey || 'nebula'),
1495
+ 'language: ' + (window.NebulaI18n?.lang || navigator.language || ''),
1496
+ 'browser: ' + String(navigator.userAgent || ''),
1497
+ 'screen: ' + n(screen.width) + '×' + n(screen.height) + ' @' + n(window.devicePixelRatio) + 'x',
1498
+ 'webgl: ' + gl,
1499
+ 'graph: ' + n(st.nodes) + ' memories / ' + n(st.edges) + ' links / ' + n(st.workspaces) + ' workspaces / ' + n(st.sessions) + ' sessions',
1500
+ 'build: ' + n(meta.buildMs || g.buildMs) + 'ms' + (g.builtAt ? ' at ' + new Date(g.builtAt).toISOString() : ''),
1501
+ 'sources: ' + n((g.sources || []).length),
1502
+ 'lastError: ' + (state.lastError || 'none'),
1503
+ ]
1504
+ return lines.join('\n')
1505
+ }
1506
+
1507
+ async function copyDiagnostics() {
1508
+ const ok = await copyText(diagnosticsText())
1509
+ toast(ok ? T('诊断信息已复制(不含正文)') : T('复制失败:浏览器没给剪贴板权限'))
1510
+ }
1511
+
1512
+ function exportPNG() {
1513
+ const is2d = state.modeKey === 'nebula'
1514
+ // 2D:出图时把「给左侧面板留的空白」收掉、重新居中,图才不会一半是空的。
1515
+ // 全程同步,浏览器来不及绘制中间态,所以屏幕上不会闪一下。
1516
+ if (is2d && state.stage2d) {
1517
+ // 刚点完重建就导出时,画面还在「长」:先把这一屏点亮,别导出一张半截图
1518
+ if (typeof state.stage2d.finishReveal === 'function') state.stage2d.finishReveal()
1519
+ state.stage2d.setPadding({ left: 0, right: 0, top: 0, bottom: 0 })
1520
+ state.stage2d.fit(true)
1521
+ state.stage2d.drawNow()
1522
+ }
1523
+ // 3D:先同步补画一帧再取图像。WebGL 绘制缓冲不保留,
1524
+ // 上一帧早已被合成清掉,直接 drawImage 会导出一张「只有标题和簇名」的空图。
1525
+ if (!is2d && state.space3d && typeof state.space3d.paintNow === 'function') state.space3d.paintNow()
1526
+ const labels = is2d ? null : $('#sky3dlbl')
1527
+ const sky = is2d ? $('#sky') : $('#sky3d')
1528
+ if (!sky || !sky.width) {
1529
+ toast(T('画布还没准备好'))
1530
+ if (is2d) {
1531
+ applyPadding()
1532
+ state.stage2d.fit(false)
1533
+ }
1534
+ return
1535
+ }
1536
+ const cw = sky.width
1537
+ const ch = sky.height
1538
+ const dpr = Math.min(2, window.devicePixelRatio || 1)
1539
+ const bar = Math.round(74 * dpr)
1540
+ const pad = Math.round(18 * dpr)
1541
+ const out = document.createElement('canvas')
1542
+ out.width = cw + pad * 2
1543
+ out.height = ch + bar + pad * 2
1544
+ const g = out.getContext('2d')
1545
+ g.fillStyle = '#05070d'
1546
+ g.fillRect(0, 0, out.width, out.height)
1547
+ g.drawImage(sky, pad, bar + pad, cw, ch)
1548
+ if (labels && labels.width) g.drawImage(labels, pad, bar + pad, cw, ch)
1549
+ // 像素已经拷进 out,可以立刻把界面恢复原样(回程用缓动,不硬跳)
1550
+ if (is2d && state.stage2d) {
1551
+ applyPadding()
1552
+ state.stage2d.fit(false)
1553
+ }
1554
+
1555
+ const st = (state.graph && state.graph.stats) || {}
1556
+ g.textBaseline = 'middle'
1557
+ g.fillStyle = 'rgba(232,240,250,0.94)'
1558
+ g.font = '600 ' + Math.round(17 * dpr) + 'px "Segoe UI", system-ui, sans-serif'
1559
+ g.fillText(T('宏记忆 · 星图'), pad + Math.round(4 * dpr), Math.round(26 * dpr))
1560
+ g.fillStyle = 'rgba(150,170,196,0.72)'
1561
+ g.font = '500 ' + Math.round(11 * dpr) + 'px "Segoe UI", system-ui, sans-serif'
1562
+ g.fillText('MACRO MEMORY', pad + Math.round(78 * dpr), Math.round(27 * dpr))
1563
+ const line = [st.nodes, st.edges, st.workspaces].filter((v) => v != null)
1564
+ const info = (line.length ? line[0] + T(' 记忆 · ') + line[1] + T(' 连接 · ') + line[2] + T(' 工作区') : '') +
1565
+ (state.filter && (state.filter.minW || state.filter.ws || state.filter.types || state.filter.levels) ? T(' · 已筛选') : '')
1566
+ g.fillStyle = 'rgba(150,170,196,0.66)'
1567
+ g.font = '500 ' + Math.round(11 * dpr) + 'px "Segoe UI", system-ui, sans-serif'
1568
+ g.textAlign = 'right'
1569
+ g.fillText(info, out.width - pad - Math.round(4 * dpr), Math.round(26 * dpr))
1570
+ g.fillStyle = 'rgba(120,140,166,0.5)'
1571
+ g.fillText(new Date().toLocaleString('zh-CN'), out.width - pad - Math.round(4 * dpr), bar + pad + ch + Math.round(-18 * dpr))
1572
+ g.textAlign = 'left'
1573
+
1574
+ out.toBlob((blob) => {
1575
+ if (!blob) {
1576
+ toast(T('导出失败:浏览器没给图'))
1577
+ return
1578
+ }
1579
+ download('memory-nebula-' + stamp() + '.png', blob)
1580
+ toast(T('已导出 PNG'))
1581
+ }, 'image/png')
1582
+ }
1583
+
1584
+ /** 把当前筛选下看得见的这张子图导出成 JSON(节点 + 边 + 筛选条件)。 */
1585
+ function exportSubgraph() {
1586
+ const graph = state.graph
1587
+ if (!graph || !graph.nodes) {
1588
+ toast(T('还没有图可导出'))
1589
+ return
1590
+ }
1591
+ const f = state.filter || {}
1592
+ // 「可见」要和画面同一个定义:螺旋视图拖了时间轴,导出就只给那一天及之前的
1593
+ const cut = timeCutNow()
1594
+ const keep = (n) => {
1595
+ if (cut && (Number(n.createdAt) || 0) > cut) return false
1596
+ if (f.ws && !f.ws.has(n.ws)) return false
1597
+ if (f.levels && !f.levels.has(n.level)) return false
1598
+ if (f.minImp && (n.importance || 0) < f.minImp) return false
1599
+ return true
1600
+ }
1601
+ const nodes = graph.nodes.filter(keep).map((n) => ({
1602
+ id: n.id,
1603
+ label: n.label,
1604
+ workspace: n.ws,
1605
+ level: n.level,
1606
+ importance: n.importance,
1607
+ status: n.status || undefined,
1608
+ project: n.project || undefined,
1609
+ hits: n.hits || 0,
1610
+ degree: n.degree || 0,
1611
+ createdAt: n.createdAt || undefined,
1612
+ }))
1613
+ const ids = new Set(nodes.map((n) => n.id))
1614
+ const edges = (graph.edges || [])
1615
+ .filter((e) => ids.has(e.a) && ids.has(e.b))
1616
+ .filter((e) => !(f.types && !f.types.has(e.t)))
1617
+ .filter((e) => !(f.minW && e.w < f.minW))
1618
+ .map((e) => ({ source: e.a, target: e.b, type: e.t, weight: Math.round(e.w * 1000) / 1000, curated: !!e.curated }))
1619
+ const payload = {
1620
+ format: 'memory-nebula/subgraph@1',
1621
+ exportedAt: new Date().toISOString(),
1622
+ focus: state.selected || null,
1623
+ filter: {
1624
+ workspaces: f.ws ? [...f.ws] : null,
1625
+ levels: f.levels ? [...f.levels] : null,
1626
+ types: f.types ? [...f.types] : null,
1627
+ minWeight: f.minW || 0,
1628
+ minImportance: f.minImp || 0,
1629
+ until: cut ? new Date(cut).toISOString() : null,
1630
+ },
1631
+ stats: { nodes: nodes.length, edges: edges.length },
1632
+ nodes,
1633
+ edges,
1634
+ }
1635
+ download('memory-nebula-' + stamp() + '.json', new Blob([JSON.stringify(payload, null, 2)], { type: 'application/json' }))
1636
+ toast(T('已导出 ') + nodes.length + T(' 个节点 / ') + edges.length + T(' 条连接'))
1637
+ }
1638
+
1639
+ /* ── 命令面板(Ctrl+K) ─────────────────────────────────────────── */
1640
+
1641
+ const CMDS = [
1642
+ { k: T('视图'), t: T('星云(2D)'), run: () => applyMode('nebula') },
1643
+ { k: T('视图'), t: T('星系(3D)'), run: () => applyMode('space') },
1644
+ { k: T('视图'), t: T('时间(螺旋)'), run: () => applyMode('spiral') },
1645
+ { k: T('面板'), t: T('项目卡片'), run: () => openCards() },
1646
+ { k: T('面板'), t: T('看板:来源'), run: () => openBoards('src') },
1647
+ { k: T('面板'), t: T('看板:真源'), run: () => openBoards('truth') },
1648
+ { k: T('面板'), t: T('看板:体检'), run: () => openBoards('health') },
1649
+ { k: T('面板'), t: T('看板:屏蔽'), run: () => openBoards('mute') },
1650
+ { k: T('动作'), t: T('重建星图'), run: () => $('#btn-refresh')?.click() },
1651
+ { k: T('导出'), t: T('导出当前视图 PNG'), run: exportPNG },
1652
+ { k: T('导出'), t: T('导出可见子图 JSON'), run: exportSubgraph },
1653
+ { k: T('动作'), t: T('聚焦当前选中'), run: () => state.selected && state.stage.focusNode(state.selected, 2.2) },
1654
+ { k: T('动作'), t: T('重置筛选 · 回全视图'), run: () => resetFilters() },
1655
+ { k: T('动作'), t: T('主线:当前记忆的时间线'), run: () => openLine() },
1656
+ { k: T('帮助'), t: T('快捷键一览'), run: () => toggleKeys() },
1657
+ ]
1658
+
1659
+ let cmdkIndex = 0
1660
+ let cmdkTimer = 0
1661
+
1662
+ function closeCmdk() {
1663
+ const box = $('#cmdk')
1664
+ if (box) box.hidden = true
1665
+ }
1666
+
1667
+ function openCmdk() {
1668
+ const box = $('#cmdk')
1669
+ const input = $('#cmdk-input')
1670
+ if (!box || !input) return
1671
+ box.hidden = false
1672
+ input.value = ''
1673
+ cmdkIndex = 0
1674
+ renderCmdk('')
1675
+ input.focus()
1676
+ }
1677
+
1678
+ function renderCmdk(q) {
1679
+ const list = $('#cmdk-list')
1680
+ if (!list) return
1681
+ const query = q.trim().toLowerCase()
1682
+ list.innerHTML = ''
1683
+ const rows = []
1684
+ for (const c of CMDS) {
1685
+ if (query && !(c.t.toLowerCase().includes(query) || c.k.includes(query))) continue
1686
+ rows.push({ label: c.t, kind: c.k, ws: '', run: c.run })
1687
+ }
1688
+ if (query) {
1689
+ API.recall(q, { limit: 7 })
1690
+ .then((res) => {
1691
+ if (document.activeElement !== $('#cmdk-input')) return
1692
+ const box = $('#cmdk-list')
1693
+ if (!box) return
1694
+ const extra = (res.hits || []).map((h) => ({
1695
+ label: h.label || h.title || h.preview || h.id,
1696
+ kind: T('记忆'),
1697
+ ws: h.across ? '★ ' + (h.ws || '') : h.ws || '',
1698
+ run: () => showDetail(h.id),
1699
+ }))
1700
+ if (!extra.length) return
1701
+ for (const e of extra) box.appendChild(cmdRow(e))
1702
+ })
1703
+ .catch((err) => softWarn('recall', err))
1704
+ }
1705
+ for (const r of rows) list.appendChild(cmdRow(r))
1706
+ paintCmdk()
1707
+ }
1708
+
1709
+ function cmdRow(r) {
1710
+ const row = el('div', 'cmd')
1711
+ row.appendChild(el('div', 'cm-k', r.kind))
1712
+ row.appendChild(el('div', 'cm-t', r.label))
1713
+ if (r.ws) row.appendChild(el('div', 'cm-w', r.ws))
1714
+ row.onclick = () => {
1715
+ closeCmdk()
1716
+ r.run()
1717
+ }
1718
+ row.dataset.run = '1'
1719
+ row._run = r.run
1720
+ return row
1721
+ }
1722
+
1723
+ function paintCmdk() {
1724
+ const rows = [...document.querySelectorAll('#cmdk-list .cmd')]
1725
+ rows.forEach((r, i) => r.classList.toggle('on', i === cmdkIndex))
1726
+ const on = rows[cmdkIndex]
1727
+ if (on && on.scrollIntoView) on.scrollIntoView({ block: 'nearest' })
1728
+ }
1729
+
1730
+ function runCmdk() {
1731
+ const rows = [...document.querySelectorAll('#cmdk-list .cmd')]
1732
+ const row = rows[cmdkIndex]
1733
+ if (!row) return
1734
+ closeCmdk()
1735
+ if (row._run) row._run()
1736
+ }
1737
+
1738
+ /* ── 主线(一条记忆的时间上下文) ──────────────────────────────── */
1739
+
1740
+ function closeLine() {
1741
+ const box = $('#linebar')
1742
+ if (box) box.hidden = true
1743
+ }
1744
+
1745
+ async function openLine(id) {
1746
+ const box = $('#linebar')
1747
+ if (!box) return
1748
+ const target = id || state.selected
1749
+ if (!target) {
1750
+ toast(T('先选一条记忆,再看它的主线'))
1751
+ return
1752
+ }
1753
+ box.hidden = false
1754
+ const title = $('#lb-title')
1755
+ const body = $('#lb-body')
1756
+ body.innerHTML = ''
1757
+ body.appendChild(el('div', 'bd-dim', T('正在读…')))
1758
+ let d
1759
+ try {
1760
+ d = await API.node(target)
1761
+ } catch (err) {
1762
+ body.innerHTML = ''
1763
+ body.appendChild(el('div', 'bd-dim', T('读取失败:') + ((err && err.message) || err)))
1764
+ return
1765
+ }
1766
+ const node = d.node || d
1767
+ const peers = (node.peers && node.peers.items) || []
1768
+ if (title) title.textContent = T('主线 · ') + (node.title || node.label || '').slice(0, 26) + ' · ' + peers.length + T(' 条')
1769
+ body.innerHTML = ''
1770
+ if (!peers.length) {
1771
+ body.appendChild(el('div', 'bd-dim', T('这条记忆所在会话里没有别的记忆。')))
1772
+ return
1773
+ }
1774
+ // peers 是「同会话的其它记忆」,不含自己;主线要把当前这条也放进去,
1775
+ // 否则时间轴上找不到「我现在在哪」。
1776
+ const self = { id: node.id, label: node.title || node.label, level: node.level, createdAt: node.createdAt }
1777
+ const sorted = [self, ...peers.filter((p) => p.id !== node.id)].sort((a, b) => (a.createdAt || 0) - (b.createdAt || 0))
1778
+ if (title) title.textContent = T('主线 · ') + (node.title || node.label || '').slice(0, 26) + ' · ' + sorted.length + T(' 条')
1779
+ // 跨天时给一个日期小标题:只靠「小时:分钟」的话,翻到昨天的段落完全看不出来。
1780
+ let lastKey = ''
1781
+ for (const p of sorted) {
1782
+ const dt = new Date(p.createdAt || 0)
1783
+ const key = dt.getFullYear() + '-' + (dt.getMonth() + 1) + '-' + dt.getDate()
1784
+ if (key !== lastKey) {
1785
+ lastKey = key
1786
+ body.appendChild(el('div', 'tl-day', dt.getMonth() + 1 + T('月') + dt.getDate() + T('日')))
1787
+ }
1788
+ const row = el('div', 'tl' + (p.id === node.id ? ' here' : ''))
1789
+ row.appendChild(el('div', 't', dt.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' })))
1790
+ row.appendChild(el('div', 'd', (p.label || p.title || '').slice(0, 60)))
1791
+ row.appendChild(el('div', 's', p.id === node.id ? T('当前') : LEVEL_LABEL[p.level] || p.level || ''))
1792
+ row.onclick = () => {
1793
+ closeLine()
1794
+ showDetail(p.id)
1795
+ }
1796
+ body.appendChild(row)
1797
+ }
1798
+ body.appendChild(el('div', 'bd-dim', T('同一次会话共 ') + ((node.peers.total || peers.length) + 1) + T(' 条(含当前这条),这里按时间排最相关的 ') + sorted.length + T(' 条。')))
1799
+ }
1800
+
1801
+ document.addEventListener('keydown', (ev) => {
1802
+ const typing = document.activeElement === qInput || /input|textarea/i.test(document.activeElement?.tagName || '')
1803
+ // 命令面板:输入框里也要能上下选、回车执行
1804
+ if (!$('#cmdk').hidden) {
1805
+ if (ev.key === 'Escape') return closeCmdk()
1806
+ if (ev.key === 'ArrowDown' || ev.key === 'ArrowUp') {
1807
+ ev.preventDefault()
1808
+ const n = document.querySelectorAll('#cmdk-list .cmd').length || 1
1809
+ cmdkIndex = (cmdkIndex + (ev.key === 'ArrowDown' ? 1 : n - 1)) % n
1810
+ return paintCmdk()
1811
+ }
1812
+ if (ev.key === 'Enter') {
1813
+ ev.preventDefault()
1814
+ return runCmdk()
1815
+ }
1816
+ }
1817
+ if ((ev.ctrlKey || ev.metaKey) && (ev.key === 'k' || ev.key === 'K')) {
1818
+ ev.preventDefault()
1819
+ return openCmdk()
1820
+ }
1821
+ if (ev.key === '/' && !typing) {
1822
+ ev.preventDefault()
1823
+ qInput.focus()
1824
+ return
1825
+ }
1826
+ if (typing) return
1827
+ // 快捷键:1/2/3 切三档视图,e 聚焦选中,r 重建,Esc 关详情
1828
+ if (ev.key === '1') applyMode('nebula')
1829
+ else if (ev.key === '2') applyMode('space')
1830
+ else if (ev.key === '3') applyMode('spiral')
1831
+ else if (ev.key === 'p' || ev.key === 'P') {
1832
+ // 项目卡片:再按一次收起
1833
+ if ($('#cards').hidden) openCards()
1834
+ else closeCards()
1835
+ } else if (ev.key === 'b' || ev.key === 'B') {
1836
+ if ($('#boards').hidden) openBoards(boardTab)
1837
+ else closeBoards()
1838
+ } else if (ev.key === 'l' || ev.key === 'L') {
1839
+ if ($('#linebar').hidden) openLine()
1840
+ else closeLine()
1841
+ } else if (ev.key === 'e' || ev.key === 'E') {
1842
+ if (state.selected) state.stage.focusNode(state.selected, 2.2)
1843
+ } else if (ev.key === 'f' || ev.key === 'F') {
1844
+ // F 回全视图;Shift+F 连筛选一起清
1845
+ ev.preventDefault()
1846
+ if (ev.shiftKey) resetFilters()
1847
+ else {
1848
+ state.stage.fit()
1849
+ toast(T('回到全视图'))
1850
+ }
1851
+ } else if (ev.key === 'r' || ev.key === 'R') {
1852
+ $('#btn-refresh')?.click()
1853
+ } else if (ev.key === 'Escape') {
1854
+ if ($('#keys')) $('#keys').remove()
1855
+ else if (!$('#cmdk').hidden) closeCmdk()
1856
+ else if (!$('#cards').hidden) closeCards()
1857
+ else if (!$('#boards').hidden) closeBoards()
1858
+ else if (!$('#linebar').hidden) closeLine()
1859
+ else if (!$('#pathbar').hidden) closePath()
1860
+ else closeDetail()
1861
+ } else if (ev.key === '?') {
1862
+ toggleKeys()
1863
+ }
1864
+ })
1865
+
1866
+ async function runSearch() {
1867
+ const q = state.query
1868
+ if (!q) return
1869
+ // 手快的时候两次请求会撞车:只认最后一次,别让旧结果盖掉新结果。
1870
+ const seq = (state.searchSeq || 0) + 1
1871
+ state.searchSeq = seq
1872
+ try {
1873
+ const res = await API.recall(q, { limit: 12 })
1874
+ if (seq !== state.searchSeq) return
1875
+ state.hits = res.hits || []
1876
+ renderHits(res)
1877
+ if (state.hits.length) {
1878
+ state.stage.pulseFrom(state.hits.slice(0, 6).map((h) => h.id), true)
1879
+ state.stage.highlight(state.hits[0].id, true)
1880
+ }
1881
+ } catch (err) {
1882
+ if (seq === state.searchSeq) toast(T('检索失败:') + err.message)
1883
+ }
1884
+ }
1885
+
1886
+ /** 把命中标题里与查询重合的词标出来;用 indexOf 扫,不拼正则也不拼 HTML。 */
1887
+ function markTerms(host, text, query) {
1888
+ const terms = String(query || '').split(/\s+/).filter((t) => t.length >= 2).map((t) => t.toLowerCase())
1889
+ if (!terms.length) {
1890
+ host.appendChild(document.createTextNode(text))
1891
+ return
1892
+ }
1893
+ const lower = text.toLowerCase()
1894
+ let i = 0
1895
+ while (i < text.length) {
1896
+ let best = -1
1897
+ let bestLen = 0
1898
+ for (const t of terms) {
1899
+ const k = lower.indexOf(t, i)
1900
+ if (k !== -1 && (best === -1 || k < best || (k === best && t.length > bestLen))) {
1901
+ best = k
1902
+ bestLen = t.length
1903
+ }
1904
+ }
1905
+ if (best === -1) break
1906
+ if (best > i) host.appendChild(document.createTextNode(text.slice(i, best)))
1907
+ host.appendChild(el('b', 'hm', text.slice(best, best + bestLen)))
1908
+ i = best + bestLen
1909
+ }
1910
+ if (i < text.length) host.appendChild(document.createTextNode(text.slice(i)))
1911
+ }
1912
+
1913
+ function renderHits(res) {
1914
+ const box = $('#hits')
1915
+ box.innerHTML = ''
1916
+ const hits = res.hits || []
1917
+ // 一小行抬头:搜了什么、扫了多少、最相关给了几条;认不出的词也说出来,
1918
+ // 免得人以为「没找到」而其实是词没落库。空结果也走这一套——空屏最需要解释。
1919
+ const head = el('div', 'hit-head')
1920
+ head.appendChild(el('div', 'hh-q', '“' + (res.query || '') + '”'))
1921
+ const meta = hits.length
1922
+ ? hits.length + T(' 条最相关') + (res.scanned ? T(' · 扫过 ') + res.scanned + T(' 条') : '')
1923
+ : T('没有命中') + (res.scanned ? T(' · 扫过 ') + res.scanned + T(' 条') : '')
1924
+ head.appendChild(el('div', 'hh-m', meta))
1925
+ box.appendChild(head)
1926
+ if (res.unknown && res.unknown.length) {
1927
+ box.appendChild(el('div', 'hit-unknown', T('没认出的词:') + res.unknown.slice(0, 6).join('、')))
1928
+ }
1929
+ if (!hits.length) {
1930
+ const row = el('div', 'hit-empty')
1931
+ row.appendChild(el('div', 't', T('没有找到相关记忆')))
1932
+ row.appendChild(el('div', 'm', T('换更短的词试试;也可以先按工作区筛一下,再在图里顺着连线找。')))
1933
+ const acts = el('div', 'hact')
1934
+ const retry = el('button', 'hbtn', T('清空搜索'))
1935
+ retry.type = 'button'
1936
+ retry.onclick = () => clearSearch()
1937
+ acts.appendChild(retry)
1938
+ const byWs = el('button', 'hbtn ghost', T('只看一个工作区'))
1939
+ byWs.type = 'button'
1940
+ byWs.onclick = () => {
1941
+ if ($('#leftcol') && getComputedStyle($('#leftcol')).display === 'none') $('#btn-left')?.click()
1942
+ toast(T('在左栏点一个工作区,就只看它'))
1943
+ }
1944
+ acts.appendChild(byWs)
1945
+ if (!API.snapshot && !API.demo) {
1946
+ const demo = el('button', 'hbtn ghost', T('看看示例'))
1947
+ demo.type = 'button'
1948
+ demo.onclick = () => window.dispatchEvent(new CustomEvent('nebula:enter-demo'))
1949
+ acts.appendChild(demo)
1950
+ }
1951
+ row.appendChild(acts)
1952
+ box.appendChild(row)
1953
+ box.classList.add('show')
1954
+ return
1955
+ }
1956
+ for (const h of hits) {
1957
+ const row = el('div', 'hit')
1958
+ const dot = el('i', 'dot')
1959
+ dot.style.background = LEVEL_COLOR[h.level] || '#8fb8d8'
1960
+ dot.style.boxShadow = `0 0 6px ${LEVEL_COLOR[h.level] || '#8fb8d8'}`
1961
+ const body = el('div', 'body')
1962
+ const titleRow = el('div', 't')
1963
+ if (h.across) titleRow.appendChild(document.createTextNode('★ '))
1964
+ markTerms(titleRow, h.label || h.title || h.id, res.query)
1965
+ if (h.across) {
1966
+ titleRow.title = T('跨工作区:这条记忆来自另一个项目,由星图的连接桥接过来')
1967
+ titleRow.style.color = '#ffd88a'
1968
+ }
1969
+ body.appendChild(titleRow)
1970
+ body.appendChild(el('div', 'm', [h.ws, LEVEL_LABEL[h.level] || h.level, T('强度 ') + (h.score || 0).toFixed(2)].join(' · ')))
1971
+ if (h.why) body.appendChild(el('div', 'why', '↳ ' + localizeWhy(h.why)))
1972
+ row.appendChild(dot)
1973
+ row.appendChild(body)
1974
+ row.onclick = () => pickHit(h)
1975
+ box.appendChild(row)
1976
+ }
1977
+ box.classList.add('show')
1978
+ setHitIndex(0, false)
1979
+ }
1980
+
1981
+ /** 用 ↑↓ 在命中列表里走,右侧星图会实时预览(选中态由 Enter 决定)。 */
1982
+ function setHitIndex(i, preview) {
1983
+ const rows = [...document.querySelectorAll('#hits .hit')]
1984
+ if (!rows.length || !state.hits.length) return
1985
+ state.hitIndex = Math.max(0, Math.min(state.hits.length - 1, i))
1986
+ rows.forEach((r, k) => r.classList.toggle('on', k === state.hitIndex))
1987
+ rows[state.hitIndex].scrollIntoView({ block: 'nearest' })
1988
+ if (preview) {
1989
+ const h = state.hits[state.hitIndex]
1990
+ if (h) {
1991
+ state.stage.highlight(h.id, true)
1992
+ state.stage.pulseFrom([h.id], true)
1993
+ }
1994
+ }
1995
+ }
1996
+
1997
+ function pickHit(h) {
1998
+ // 点完命中就把焦点还给画布:否则键盘还留在搜索框里,
1999
+ // 之后的 Esc / e / f / r 全被输入框吞掉(看起来像快捷键失灵)。
2000
+ if (document.activeElement === qInput) qInput.blur()
2001
+ state.stage.select(h.id)
2002
+ state.stage.focusNode(h.id, 2.1)
2003
+ showDetail(h.id)
2004
+ $('#hits').classList.remove('show')
2005
+ }
2006
+
2007
+ // ---------------- 证据链(Shift + 点第二个节点) ----------------
2008
+ function closePath() {
2009
+ const bar = $('#pathbar')
2010
+ if (!bar) return
2011
+ bar.hidden = true
2012
+ if (state.stage2d) state.stage2d.setPath(null)
2013
+ if (state.space3d && state.space3d.setPath) state.space3d.setPath(null)
2014
+ applyPadding()
2015
+ }
2016
+
2017
+ /**
2018
+ * 本地证据链:页面手里就有整张图(节点 + 带 why 的边),
2019
+ * 所以就算服务端还没带上 /path 路由(宿主未重启),也能当场算出来。
2020
+ * 代价函数与服务端一致:-log(权重),即强证据更便宜;跳数超上限就认「没连上」。
2021
+ */
2022
+ function findPathLocal(from, to, maxHops) {
2023
+ const g = state.graph
2024
+ if (!g || !Array.isArray(g.nodes) || !Array.isArray(g.edges)) return null
2025
+ const MAX_HOPS = maxHops || 6
2026
+ const MIN_W = 0.05
2027
+ const idx = new Map()
2028
+ g.nodes.forEach((n, i) => idx.set(n.id, i))
2029
+ if (!idx.has(from) || !idx.has(to)) return null
2030
+ const adj = new Map()
2031
+ for (const e of g.edges) {
2032
+ const w = Math.max(MIN_W, Number(e.w) || 0)
2033
+ if (!adj.has(e.a)) adj.set(e.a, [])
2034
+ if (!adj.has(e.b)) adj.set(e.b, [])
2035
+ adj.get(e.a).push({ to: e.b, w, t: e.t, why: e.why, e })
2036
+ adj.get(e.b).push({ to: e.a, w, t: e.t, why: e.why, e })
2037
+ }
2038
+ const cost = new Map([[from, 0]])
2039
+ const hops = new Map([[from, 0]])
2040
+ const prev = new Map()
2041
+ const done = new Set()
2042
+ while (done.size < g.nodes.length) {
2043
+ let u = null
2044
+ let best = Infinity
2045
+ for (const [id, c] of cost) {
2046
+ if (done.has(id)) continue
2047
+ if (c < best || (c === best && u && (hops.get(id) || 0) < (hops.get(u) || 0))) {
2048
+ best = c
2049
+ u = id
2050
+ }
2051
+ }
2052
+ if (u == null) break
2053
+ if (u === to) break
2054
+ done.add(u)
2055
+ for (const link of adj.get(u) || []) {
2056
+ if (done.has(link.to)) continue
2057
+ const nh = (hops.get(u) || 0) + 1
2058
+ if (nh > MAX_HOPS) continue
2059
+ const nc = best - Math.log(link.w)
2060
+ const old = cost.get(link.to)
2061
+ if (old == null || nc < old - 1e-9) {
2062
+ cost.set(link.to, nc)
2063
+ hops.set(link.to, nh)
2064
+ prev.set(link.to, { from: u, link })
2065
+ }
2066
+ }
2067
+ }
2068
+ if (!prev.has(to)) return null
2069
+ const idsR = [to]
2070
+ const edgesR = []
2071
+ let cur = to
2072
+ while (cur !== from) {
2073
+ const p = prev.get(cur)
2074
+ if (!p) return null
2075
+ edgesR.push({ t: p.link.t || 'link', w: Math.round(p.link.w * 1000) / 1000, why: p.link.why || '' })
2076
+ idsR.push(p.from)
2077
+ cur = p.from
2078
+ }
2079
+ const ids = idsR.reverse()
2080
+ edgesR.reverse()
2081
+ const score = edgesR.reduce((acc, e) => acc * e.w, 1)
2082
+ return { found: true, hops: ids.length - 1, score: Math.round(score * 1000) / 1000, ids, edges: edgesR, local: true }
2083
+ }
2084
+
2085
+ /** 把「这两条记忆中间怎么连上的」摊开:图上编号 + 面板逐步证据。 */
2086
+ async function showPath(from, to) {
2087
+ if (!from || !to || from === to) return
2088
+ closePath()
2089
+ const bar = $('#pathbar')
2090
+ const body = $('#pb-body')
2091
+ bar.hidden = false
2092
+ body.innerHTML = '<div class="pb-empty">' + T('在算这条链…') + '</div>'
2093
+ let res = null
2094
+ let local = false
2095
+ try {
2096
+ res = await API.path(from, to)
2097
+ } catch (err) {
2098
+ softWarn('path', err)
2099
+ res = null
2100
+ }
2101
+ if (!res || !res.found) {
2102
+ const loc = findPathLocal(from, to, 6)
2103
+ if (loc) {
2104
+ const byId = new Map(state.graph.nodes.map((n) => [n.id, n]))
2105
+ res = {
2106
+ found: true,
2107
+ hops: loc.hops,
2108
+ score: loc.score,
2109
+ nodes: loc.ids.map((id) => {
2110
+ const n = byId.get(id) || {}
2111
+ return { id, label: n.label || id, level: n.level, ws: n.ws }
2112
+ }),
2113
+ edges: loc.edges,
2114
+ }
2115
+ local = true
2116
+ }
2117
+ }
2118
+ if (!res || !res.found) {
2119
+ $('#pb-title').textContent = T('证据链 · 没有连上')
2120
+ body.innerHTML =
2121
+ '<div class="pb-empty">' + T('这两条记忆在星图里没有连上(') +
2122
+ esc((res && res.error) || T('超过跳数上限')) +
2123
+ T(')。没有关系就不编关系。') + '</div>'
2124
+ return
2125
+ }
2126
+ const ids = res.nodes.map((n) => n.id)
2127
+ $('#pb-title').textContent =
2128
+ T('证据链 · ') + res.hops + T(' 跳 · 链强度 ') + res.score + (local ? T('(本地计算)') : '')
2129
+ if (state.stage2d) state.stage2d.setPath(ids)
2130
+ if (state.space3d && state.space3d.setPath) state.space3d.setPath(ids)
2131
+ if (state.stage && state.stage.pulseFrom) state.stage.pulseFrom(ids, true)
2132
+ body.innerHTML = ''
2133
+ res.nodes.forEach((n, i) => {
2134
+ const step = document.createElement('div')
2135
+ step.className = 'pb-step'
2136
+ const num = document.createElement('span')
2137
+ num.className = 'pb-n'
2138
+ num.textContent = String(i + 1)
2139
+ const lab = document.createElement('span')
2140
+ lab.className = 'pb-l'
2141
+ lab.textContent = n.label
2142
+ lab.title = n.label + '(' + n.ws + ' · ' + n.level + ')'
2143
+ step.append(num, lab)
2144
+ body.appendChild(step)
2145
+ if (i < res.edges.length) {
2146
+ const e = res.edges[i]
2147
+ const ed = document.createElement('div')
2148
+ ed.className = 'pb-edge'
2149
+ ed.textContent = '↳ ' + e.t + ' · ' + e.w + ' · ' + localizeWhylocalizeWhy(e.why || '')
2150
+ ed.title = localizeWhylocalizeWhy(e.why || '')
2151
+ body.appendChild(ed)
2152
+ }
2153
+ })
2154
+ applyPadding()
2155
+ }
2156
+
2157
+ // ---------------- 详情 ----------------
2158
+ /* ── 新手三步 ─────────────────────────────────────────────────────
2159
+ * 有 1800 条记忆的人,第一眼的问题不是「怎么用」,是「从哪看起」。
2160
+ * 三步都做成能直接点的动作,不要求他先读说明书;跳过只写 localStorage,
2161
+ * 不碰记忆库,也不会在示例/快照里出现。
2162
+ */
2163
+ const ONBOARD_KEY = 'nebula.onboarded.v1'
2164
+
2165
+ function dismissOnboard(card) {
2166
+ try {
2167
+ localStorage.setItem(ONBOARD_KEY, '1')
2168
+ } catch {}
2169
+ if (card) card.remove()
2170
+ }
2171
+
2172
+ function showOnboard(force = false) {
2173
+ // 先收旧卡片,再决定要不要显示:从真实库进示例时,旧卡片不能留在画面上。
2174
+ const old = $('#onboard')
2175
+ if (old) old.remove()
2176
+ if (API.snapshot || API.demo) return
2177
+ if (!force) {
2178
+ try {
2179
+ if (localStorage.getItem(ONBOARD_KEY) === '1') return
2180
+ } catch {}
2181
+ }
2182
+ const g = state.graph
2183
+ if (!g || !Array.isArray(g.nodes) || g.nodes.length < 8) return
2184
+
2185
+ const card = el('div', 'onboard')
2186
+ card.id = 'onboard'
2187
+ card.setAttribute('role', 'dialog')
2188
+ card.setAttribute('aria-label', T('新手三步'))
2189
+
2190
+ const head = el('div', 'ob-head')
2191
+ head.appendChild(el('b', null, T('第一次来?三步就够')))
2192
+ const x = el('button', 'ob-x', '×')
2193
+ x.type = 'button'
2194
+ x.setAttribute('aria-label', T('关闭新手引导'))
2195
+ x.onclick = () => dismissOnboard(card)
2196
+ head.appendChild(x)
2197
+ card.appendChild(head)
2198
+
2199
+ const done = new Set()
2200
+ const mark = (n) => {
2201
+ done.add(n)
2202
+ const row = card.querySelector('[data-ob-step="' + n + '"]')
2203
+ if (row) row.classList.add('done')
2204
+ if (done.size === 3) {
2205
+ toast(T('三步走完了;想重看,按 ? 打开快捷键一览'))
2206
+ setTimeout(() => dismissOnboard(card), 600)
2207
+ }
2208
+ }
2209
+
2210
+ const step = (n, title, hint, action, label) => {
2211
+ const row = el('div', 'ob-step')
2212
+ row.dataset.obStep = String(n)
2213
+ row.appendChild(el('span', 'ob-n', String(n)))
2214
+ const copy = el('div', 'ob-copy')
2215
+ copy.appendChild(el('b', null, title))
2216
+ copy.appendChild(el('span', null, hint))
2217
+ row.appendChild(copy)
2218
+ const btn = el('button', 'ob-act', label)
2219
+ btn.type = 'button'
2220
+ btn.onclick = () => {
2221
+ action()
2222
+ mark(n)
2223
+ }
2224
+ row.appendChild(btn)
2225
+ card.appendChild(row)
2226
+ }
2227
+
2228
+ step(
2229
+ 1,
2230
+ T('搜一个你记得的词'),
2231
+ T('标题、正文、关键词都算;找不到就换个更短的词。'),
2232
+ () => {
2233
+ const q = $('#q')
2234
+ if (q) {
2235
+ q.focus()
2236
+ q.select()
2237
+ }
2238
+ toast(T('输入一个词,比如「记忆」「部署」,回车看命中'))
2239
+ },
2240
+ T('去搜'),
2241
+ )
2242
+ step(
2243
+ 2,
2244
+ T('点开一条,看它凭什么'),
2245
+ T('右栏是正文和它的邻居:每条连接都写了理由。'),
2246
+ () => {
2247
+ const hub = [...g.nodes]
2248
+ .filter((n) => n.level !== 'source' && n.kind !== 'source')
2249
+ .sort((a, b) => (b.degree || 0) - (a.degree || 0))[0]
2250
+ if (hub) showDetail(hub.id, { focus: true })
2251
+ else toast(T('先搜一条记忆,再点开它'))
2252
+ },
2253
+ T('看一条'),
2254
+ )
2255
+ step(
2256
+ 3,
2257
+ T('Shift 点两条,看怎么连上'),
2258
+ T('不相关就直说「没连上」,不会硬编一条关系。'),
2259
+ () => {
2260
+ const edge = [...(g.edges || [])]
2261
+ .filter((e) => e.a && e.b && e.a !== e.b && (e.w || 0) >= 0.4)
2262
+ .sort((a, b) => (b.w || 0) - (a.w || 0))[0]
2263
+ if (edge) showPath(edge.a, edge.b)
2264
+ else toast(T('这一片没有够强的连接可演示;先搜一条记忆看看'))
2265
+ },
2266
+ T('看例子'),
2267
+ )
2268
+
2269
+ const foot = el('div', 'ob-foot')
2270
+ const skip = el('button', 'ob-skip', T('跳过,直接逛'))
2271
+ skip.type = 'button'
2272
+ skip.onclick = () => dismissOnboard(card)
2273
+ foot.appendChild(skip)
2274
+ foot.appendChild(el('span', null, T('随时按 ? 可以重看')))
2275
+ card.appendChild(foot)
2276
+
2277
+ // 卡片里的点击不要冒泡到画布/菜单的全局监听,免得点一下就被别处关掉。
2278
+ card.addEventListener('click', (ev) => ev.stopPropagation())
2279
+ document.body.appendChild(card)
2280
+ }
2281
+
2282
+ /** 快捷键帮助浮层(按 ? 开合,点一下也关)。 */
2283
+ function toggleKeys() {
2284
+ let box = $('#keys')
2285
+ if (box) {
2286
+ box.remove()
2287
+ return
2288
+ }
2289
+ box = el('div', 'keys')
2290
+ box.id = 'keys'
2291
+ const rows = [
2292
+ ['/', T('搜索记忆')],
2293
+ ['Ctrl / ⌘ + K', T('命令面板:切视图、开面板、搜记忆')],
2294
+ ['↑ ↓', T('在搜索结果里走位,回车打开')],
2295
+ ['↑ ↓ ← →', T('在星图里按方向走到下一颗(先点一下画面,或 Tab 进来)')],
2296
+ ['Enter', T('打开当前这颗星')],
2297
+ ['[ / ]', T('沿连接走到相邻的一颗')],
2298
+ ['+ / -', T('放大 / 缩小')],
2299
+ ['0', T('回到全图')],
2300
+ ['Home', T('跳到连接最多的那颗')],
2301
+ ['1 / 2 / 3', T('星云 / 星系 / 时间')],
2302
+ [T('左键拖'), T('星云平移 · 星系转视角')],
2303
+ [T('点光斑'), T('钻进那个项目(拉远到点聚成光斑时)')],
2304
+ [T('双击空白'), T('回到全图')],
2305
+ [T('中键 / 右键拖'), T('平移视角(不会误选节点)')],
2306
+ [T('Shift + 点两下'), T('查两个节点之间的证据链')],
2307
+ [T('时间视图底部滑杆'), T('回到某一天之前(双击滑杆恢复全部)')],
2308
+ [T('顶栏「导出」'), T('当前视图 PNG / 可见子图 JSON')],
2309
+ [T('左栏小箭头'), T('收起任一分组,状态会记住')],
2310
+ ['f', T('回全视图(双击空白也行)')],
2311
+ ['Shift + f', T('清掉所有筛选,回全视图')],
2312
+ ['e', T('把选中的那颗拉到面前')],
2313
+ ['p / b / l', T('项目卡片 / 四块看板 / 主线')],
2314
+ ['r', T('重建星云(重新分析全部记忆)')],
2315
+ ['Esc', T('从面板一层层关回去')],
2316
+ ['?', T('显示或关闭这张说明')],
2317
+ ]
2318
+ box.appendChild(el('div', 'keys-t', T('快捷键')))
2319
+ for (const [k, v] of rows) {
2320
+ const row = el('div', 'keys-row')
2321
+ row.appendChild(el('span', 'keys-k', k))
2322
+ row.appendChild(el('span', 'keys-v', v))
2323
+ box.appendChild(row)
2324
+ }
2325
+ const re = el('button', 'keys-re', T('重看新手三步'))
2326
+ re.type = 'button'
2327
+ re.onclick = (ev) => {
2328
+ ev.stopPropagation()
2329
+ box.remove()
2330
+ showOnboard(true)
2331
+ }
2332
+ box.appendChild(re)
2333
+ const diag = el('button', 'keys-diag', T('复制诊断'))
2334
+ diag.type = 'button'
2335
+ diag.onclick = (ev) => {
2336
+ ev.stopPropagation()
2337
+ copyDiagnostics()
2338
+ }
2339
+ box.appendChild(diag)
2340
+ const foot = el(
2341
+ 'div',
2342
+ 'keys-f',
2343
+ T('宏记忆 · 星图 v') + (state.engineVersion || APP_VERSION) + T(' · 只读 · 数据留在本机')
2344
+ )
2345
+ box.appendChild(foot)
2346
+ box.onclick = () => box.remove()
2347
+ document.body.appendChild(box)
2348
+ }
2349
+
2350
+ function closeDetail() {
2351
+ $('#detail').classList.remove('show')
2352
+ document.body.classList.remove('has-detail')
2353
+ state.selected = null
2354
+ state.detail = null
2355
+ if (state.stage) state.stage.select(null)
2356
+ applyPadding()
2357
+ }
2358
+
2359
+ async function showDetail(id, opts) {
2360
+ if (!id) {
2361
+ $('#detail').classList.remove('show')
2362
+ document.body.classList.remove('has-detail')
2363
+ applyPadding()
2364
+ state.selected = null
2365
+ return
2366
+ }
2367
+ state.selected = id
2368
+ try {
2369
+ const d = await API.node(id)
2370
+ state.detail = d
2371
+ renderDetail(d)
2372
+ $('#detail').classList.add('show')
2373
+ document.body.classList.add('has-detail')
2374
+ applyPadding()
2375
+ // 从搜索、看板、详情里的邻居点进来时,把它带到画面中间——
2376
+ // 但本来就在视口里就别动镜头,免得点一下画面就跳。
2377
+ const st = state.stage
2378
+ if (st && !(opts && opts.focus === false)) {
2379
+ let onScreen = false
2380
+ try {
2381
+ const p = st.screenOf && st.screenOf(id)
2382
+ if (p) {
2383
+ const mx = window.innerWidth * 0.08
2384
+ const my = window.innerHeight * 0.08
2385
+ onScreen = p.x > mx && p.y > my && p.x < window.innerWidth - mx && p.y < window.innerHeight - my
2386
+ }
2387
+ } catch {}
2388
+ if (!onScreen || (opts && opts.focus)) {
2389
+ try {
2390
+ st.select(id)
2391
+ st.focusNode(id, (opts && opts.zoom) || 1.9)
2392
+ } catch {}
2393
+ }
2394
+ }
2395
+ } catch (err) {
2396
+ const msg = (err && err.message) || String(err)
2397
+ // 记忆被重建掉之后,右侧还挂着它的详情会很怪:这里直接收起来。
2398
+ if (/404|not\s*found|不存在|no such/i.test(msg)) {
2399
+ toast(T('这条记忆已经不在了'))
2400
+ showDetail(null)
2401
+ } else {
2402
+ toast(T('读取失败:') + msg)
2403
+ }
2404
+ }
2405
+ }
2406
+
2407
+ /** 剪贴板:优先 navigator.clipboard,失败退回 textarea(无权限时也能用)。 */
2408
+ async function copyText(text) {
2409
+ const t = String(text || '')
2410
+ if (!t) return false
2411
+ try {
2412
+ if (navigator.clipboard && navigator.clipboard.writeText) {
2413
+ await navigator.clipboard.writeText(t)
2414
+ return true
2415
+ }
2416
+ } catch (err) {
2417
+ softWarn('clipboard', err)
2418
+ }
2419
+ try {
2420
+ const ta = document.createElement('textarea')
2421
+ ta.value = t
2422
+ ta.style.position = 'fixed'
2423
+ ta.style.opacity = '0'
2424
+ document.body.appendChild(ta)
2425
+ ta.select()
2426
+ const ok = document.execCommand('copy')
2427
+ ta.remove()
2428
+ return ok
2429
+ } catch (err) {
2430
+ softWarn('clipboard-fallback', err)
2431
+ return false
2432
+ }
2433
+ }
2434
+
2435
+ function renderDetail(d) {
2436
+ const n = d.node
2437
+ const meta = $('#d-meta')
2438
+ meta.innerHTML = ''
2439
+ const tag = (text, color) => {
2440
+ const t = el('span', 'tag', text)
2441
+ if (color) {
2442
+ t.style.color = color
2443
+ t.style.borderColor = color + '44'
2444
+ }
2445
+ return t
2446
+ }
2447
+ meta.appendChild(tag(LEVEL_LABEL[n.level] || n.level, LEVEL_COLOR[n.level]))
2448
+ meta.appendChild(tag(n.ws))
2449
+ // 这条记忆是谁给的:接多个记忆插件之后,详情里必须能一眼看出来源。
2450
+ if (n.provider && n.provider !== 'meow-memory') meta.appendChild(tag(T('来源 · ') + providerLabel(n.provider), providerColor(n.provider)))
2451
+ if (n.project) meta.appendChild(tag(n.project))
2452
+ if (n.status && n.status !== 'active') meta.appendChild(tag(n.status, '#ff9f7a'))
2453
+ meta.appendChild(tag(T('连接 ') + (d.degree || 0)))
2454
+ if (n.hits) meta.appendChild(tag(T('命中 ') + n.hits))
2455
+
2456
+ // 想把一条记忆带到别处(issue、聊天、笔记)时,最缺的就是它的 id
2457
+ const copyId = el('button', 'tag tag-btn', T('复制 id'))
2458
+ copyId.title = T('复制这条记忆的完整 id')
2459
+ copyId.onclick = async (ev) => {
2460
+ ev.stopPropagation()
2461
+ toast((await copyText(n.id)) ? T('已复制记忆 id') : T('复制失败'))
2462
+ }
2463
+ meta.appendChild(copyId)
2464
+ const sid = (d.origin && d.origin.sessionId) || n.sessionId
2465
+ if (sid) {
2466
+ const copySid = el('button', 'tag tag-btn', T('复制会话'))
2467
+ copySid.title = T('复制来源会话 id:') + String(sid)
2468
+ copySid.onclick = async (ev) => {
2469
+ ev.stopPropagation()
2470
+ toast((await copyText(sid)) ? T('已复制会话 id') : T('复制失败'))
2471
+ }
2472
+ meta.appendChild(copySid)
2473
+ }
2474
+
2475
+ $('#d-title').textContent = n.title || n.label || T('(无标题)')
2476
+
2477
+ // 体检结论直接贴在详情顶部:这样看到一条记忆就知道它有没有「该更新 / 重复」的毛病
2478
+ const hy = state.hygiene
2479
+ const dbody = $('#d-body')
2480
+ const staleNote = document.getElementById('d-hygiene')
2481
+ if (staleNote) staleNote.remove()
2482
+ if (hy && hy.items) {
2483
+ const staleIt = (hy.items.stale || []).find((x) => x.id === n.id)
2484
+ const dupIt = (hy.items.dup || []).find((x) => x.a.id === n.id || x.b.id === n.id)
2485
+ const overIt = (hy.items.oversize || []).find((x) => x.id === n.id)
2486
+ const thinIt = (hy.items.thin || []).find((x) => x.id === n.id)
2487
+ // [macro-fusion 0.4.0] 写入端通胀也贴到单条上:自证与「召回过没人读」都是逐条的毛病。
2488
+ const echoIt = (hy.items.selfecho || []).find((x) => x.id === n.id)
2489
+ const unusedIt = (hy.items.unused || []).find((x) => x.id === n.id)
2490
+ const notes = []
2491
+ if (staleIt) notes.push(T('还挂着 active,但「') + (staleIt.by.label || '').slice(0, 24) + T('」更新更全——这条可能该并进去'))
2492
+ if (dupIt) {
2493
+ const other = dupIt.a.id === n.id ? dupIt.b : dupIt.a
2494
+ notes.push(T('与「') + (other.label || '').slice(0, 24) + T('」高度重复(相似 ') + dupIt.sim + ')')
2495
+ }
2496
+ if (overIt) notes.push(T('正文 ') + overIt.size + T(' 字,属于本库最长的一批,读一次很贵'))
2497
+ if (thinIt) notes.push(T('连接 ') + thinIt.degree + T(' 条但平均强度只有 ') + thinIt.avg + T(',多半是关键词撞出来的'))
2498
+ if (echoIt) notes.push(T('关键词有 ') + echoIt.echo + '/' + echoIt.kws + T(' 个逐字出现在正文里——这些词靠 BM25 本来就能命中,等于没扩召回面'))
2499
+ if (unusedIt) notes.push(T('被检索命中过 ') + unusedIt.hits + T(' 次,却一次都没被读过:排进候选但没人真去读'))
2500
+ if (notes.length) {
2501
+ const box = el('div', 'd-hygiene')
2502
+ box.id = 'd-hygiene'
2503
+ for (const t of notes) box.appendChild(el('div', 'd-hy-line', '· ' + t))
2504
+ dbody.parentNode.insertBefore(box, dbody)
2505
+ }
2506
+ }
2507
+
2508
+ const imps = $('#d-imps')
2509
+ imps.innerHTML = ''
2510
+ for (let i = 1; i <= 4; i++) {
2511
+ const bar = document.createElement('i')
2512
+ if (i <= (n.importance || 0)) bar.className = 'on'
2513
+ imps.appendChild(bar)
2514
+ }
2515
+
2516
+ const body = $('#d-body')
2517
+ body.innerHTML = ''
2518
+
2519
+ // 重要度建议:只提示,不动别人的库
2520
+ if (n.suggest && n.suggest.to !== n.suggest.from) {
2521
+ const s = el('div', 'd-origin-meta', T('重要度建议 ') + n.suggest.from + ' → ' + n.suggest.to + '(' + localizeWhy(n.suggest.why || '') + ')')
2522
+ s.style.marginBottom = '6px'
2523
+ body.appendChild(s)
2524
+ }
2525
+
2526
+ // 写入时就算过的证据(sidecar 缓存,第一次建图时落盘)
2527
+ if (n.evidence && n.evidence.edges && n.evidence.edges.length) {
2528
+ body.appendChild(el('div', 'd-sect-title', T('落库时算出的证据')))
2529
+ for (const e of n.evidence.edges) {
2530
+ const row = el('div', 'd-origin-meta', '· ' + (TYPE_LABEL[e.type] || e.type) + ' ' + e.w + ' · ' + localizeWhy(e.why || ''))
2531
+ row.style.cursor = 'pointer'
2532
+ row.onclick = () => e.id && showDetail(e.id)
2533
+ body.appendChild(row)
2534
+ }
2535
+ }
2536
+ // 出处:这条记忆是在主人在会话里说的哪句话之后写下的(来自会话转写)
2537
+ if (n.origin && n.origin.text) {
2538
+ const sect = el('div', 'd-sect-title', T('写这条记忆时,主人说的是'))
2539
+ body.appendChild(sect)
2540
+ const quote = el('div', 'd-origin')
2541
+ quote.textContent = n.origin.text
2542
+ const meta2 = el('div', 'd-origin-meta')
2543
+ const gap = Math.max(0, Math.round((n.origin.gapMs || 0) / 1000))
2544
+ const when =
2545
+ gap < 90 ? gap + T(' 秒后写下') : gap < 5400 ? Math.round(gap / 60) + T(' 分钟后写下') : Math.round(gap / 3600) + T(' 小时后写下')
2546
+ meta2.textContent =
2547
+ T('出自会话 ') + String(n.origin.sessionId || '').replace(/^session-/, '').slice(0, 8) + T(' · 说过这话') + when
2548
+ quote.appendChild(meta2)
2549
+ body.appendChild(quote)
2550
+ }
2551
+
2552
+ const content = el('div', 'd-content')
2553
+ content.innerHTML = highlight(n.content || '', n.keywords || [])
2554
+ body.appendChild(content)
2555
+
2556
+ if (n.goal) {
2557
+ body.appendChild(el('div', 'd-sect-title', T('目标')))
2558
+ const g = el('div', 'd-content')
2559
+ g.textContent = n.goal
2560
+ body.appendChild(g)
2561
+ }
2562
+
2563
+ if ((n.keywords || []).length) {
2564
+ const kw = el('div', 'd-kw')
2565
+ for (const k of n.keywords) kw.appendChild(el('span', null, k))
2566
+ body.appendChild(kw)
2567
+ }
2568
+
2569
+ if ((n.mentions || []).length) {
2570
+ body.appendChild(el('div', 'd-sect-title', T('这条记忆提到的来源')))
2571
+ const box = el('div', 'd-kw')
2572
+ for (const m of n.mentions) {
2573
+ const chip = el('span', null, (m.kind === 'skill' ? '◆ ' : m.kind === 'mcp' ? '▣ ' : '◈ ') + m.name)
2574
+ chip.style.color = m.kind === 'skill' ? '#8fd8ff' : m.kind === 'mcp' ? '#ffd88a' : '#9fe8c8'
2575
+ if (m.description) chip.title = m.description
2576
+ box.appendChild(chip)
2577
+ }
2578
+ body.appendChild(box)
2579
+ }
2580
+
2581
+ // 来源节点(技能 / MCP / 插件):反过来看「谁提到过它」,以及被哪些项目在用
2582
+ if (n.level === 'source' && n.mentionedBy) {
2583
+ const mb = n.mentionedBy
2584
+ body.appendChild(
2585
+ el('div', 'd-sect-title', T('谁提到过它 · ') + mb.total + T(' 条记忆') + (mb.byWorkspace.length ? T(' / 分布在 ') + mb.byWorkspace.length + T(' 个项目') : '')),
2586
+ )
2587
+ if (mb.usage && mb.usage.calls > 0) {
2588
+ const use = el('div', 'd-origin-meta', T('会话里实际调用过 ') + mb.usage.calls + T(' 次 · 分布在 ') + mb.usage.sessions + T(' 个会话'))
2589
+ use.style.marginBottom = '8px'
2590
+ body.appendChild(use)
2591
+ } else if (mb.usage) {
2592
+ const use = el('div', 'd-origin-meta', T('会话里没有直接调用过它(可能只是被记忆提到,或由别的入口自动挂载)'))
2593
+ use.style.marginBottom = '8px'
2594
+ body.appendChild(use)
2595
+ }
2596
+ if (mb.byWorkspace.length) {
2597
+ const box = el('div', 'd-kw')
2598
+ for (const w of mb.byWorkspace) {
2599
+ const chip = el('span', null, w.ws + ' × ' + w.n)
2600
+ box.appendChild(chip)
2601
+ }
2602
+ body.appendChild(box)
2603
+ }
2604
+ for (const t of mb.top) {
2605
+ const row = el('div', 'nbr')
2606
+ const dot = el('i', 'dot')
2607
+ dot.style.background = LEVEL_COLOR[t.level] || '#8fb8d8'
2608
+ dot.style.boxShadow = `0 0 6px ${LEVEL_COLOR[t.level] || '#8fb8d8'}`
2609
+ const b = el('div', 'nb')
2610
+ b.appendChild(el('div', 'nt', t.label || t.id))
2611
+ b.appendChild(el('div', 'nw', T('重要度 ') + (t.importance || 0) + ' · ' + (t.ws || '')))
2612
+ row.appendChild(dot)
2613
+ row.appendChild(b)
2614
+ row.onclick = () => showDetail(t.id)
2615
+ row.style.cursor = 'pointer'
2616
+ body.appendChild(row)
2617
+ }
2618
+ }
2619
+
2620
+ // 同一次会话里还写下哪些记忆:一条上下文脉络,比孤立看一条更好判断它当时在讲什么
2621
+ if (n.peers && n.peers.items && n.peers.items.length) {
2622
+ body.appendChild(el('div', 'd-sect-title', T('同一次会话里还写下 ') + n.peers.total + T(' 条')))
2623
+ for (const p of n.peers.items) {
2624
+ const row = el('div', 'nbr')
2625
+ const dot = el('i', 'dot')
2626
+ dot.style.background = LEVEL_COLOR[p.level] || '#8fb8d8'
2627
+ dot.style.boxShadow = `0 0 6px ${LEVEL_COLOR[p.level] || '#8fb8d8'}`
2628
+ const b = el('div', 'nb')
2629
+ b.appendChild(el('div', 'nt', p.label || p.id))
2630
+ b.appendChild(el('div', 'nw', T('重要度 ') + (p.importance || 0) + ' · ' + (p.ws || '')))
2631
+ row.appendChild(dot)
2632
+ row.appendChild(b)
2633
+ row.onclick = () => showDetail(p.id)
2634
+ row.style.cursor = 'pointer'
2635
+ body.appendChild(row)
2636
+ }
2637
+ }
2638
+
2639
+ const nbrTitle = el('div', 'd-sect-title')
2640
+ nbrTitle.appendChild(el('span', null, T('连接到的记忆 · ') + (d.neighbors || []).length))
2641
+ body.appendChild(nbrTitle)
2642
+ for (const nb of (d.neighbors || []).slice(0, 60)) {
2643
+ const row = el('div', 'nbr')
2644
+ const dot = el('i', 'dot')
2645
+ dot.style.background = LEVEL_COLOR[nb.level] || '#8fb8d8'
2646
+ dot.style.boxShadow = `0 0 6px ${LEVEL_COLOR[nb.level] || '#8fb8d8'}`
2647
+ const b = el('div', 'nb')
2648
+ b.appendChild(el('div', 'nt', nb.label || nb.title || nb.id))
2649
+ const reason = (TYPE_LABEL[nb.type] || nb.type) + (nb.why ? ' · ' + localizeWhy(nb.why) : '')
2650
+ b.appendChild(el('div', 'nw', reason))
2651
+ const bar = el('div', 'bar')
2652
+ const fill = document.createElement('i')
2653
+ fill.style.width = Math.round((nb.w || 0) * 100) + '%'
2654
+ fill.style.background = TYPE_COLOR[nb.type] || '#8fb8d8'
2655
+ bar.appendChild(fill)
2656
+ b.appendChild(bar)
2657
+ row.appendChild(dot)
2658
+ row.appendChild(b)
2659
+ // 「这条关联算错了」:人工策展边直接断;自动推断的边记进屏蔽表,重建也不再连
2660
+ const kill = el('button', 'mini kill', '×')
2661
+ kill.title = nb.type === 'explicit' ? T('断开这条人工连边') : T('屏蔽这条关联(以后重建也不会再连)')
2662
+ kill.onclick = async (ev) => {
2663
+ ev.stopPropagation()
2664
+ try {
2665
+ if (nb.type === 'explicit') await API.unlink(n.id, nb.id)
2666
+ else await API.mute(n.id, nb.id, '界面人工屏蔽')
2667
+ const back = async () => {
2668
+ if (nb.type === 'explicit') await API.link(n.id, nb.id)
2669
+ else await API.unmute(n.id, nb.id)
2670
+ await reload(false)
2671
+ renderSources()
2672
+ showDetail(n.id)
2673
+ toast(T('已撤销'))
2674
+ }
2675
+ toast(nb.type === 'explicit' ? T('已断开这条连边') : T('已屏蔽这条关联'), { label: T('撤销'), run: back })
2676
+ await reload(false)
2677
+ renderSources()
2678
+ showDetail(n.id)
2679
+ } catch (e) {
2680
+ // 后台是旧版宿主(没 /mute)时退一步:先把这条边断开,至少图是干净的
2681
+ if (nb.type !== 'explicit') {
2682
+ try {
2683
+ await API.unlink(n.id, nb.id)
2684
+ toast(T('当前引擎较旧,已改为断开这条边(重连后可用屏蔽)'))
2685
+ await reload(false)
2686
+ renderSources()
2687
+ showDetail(n.id)
2688
+ return
2689
+ } catch {}
2690
+ }
2691
+ toast(T('操作失败:') + e.message)
2692
+ }
2693
+ }
2694
+ // 快照与示例都是只读的:不摆一个点了必然失败的「屏蔽」按钮。
2695
+ if (!API.snapshot && !API.demo) row.appendChild(kill)
2696
+ row.onclick = () => {
2697
+ state.stage.select(nb.id)
2698
+ state.stage.focusNode(nb.id, 2.1)
2699
+ showDetail(nb.id)
2700
+ }
2701
+ row.title = T('点击查看:') + (nb.label || nb.id)
2702
+ body.appendChild(row)
2703
+ }
2704
+
2705
+ const acts = el('div', 'acts')
2706
+ const btnSpread = el('button', 'btn', T('以它为种子扩散'))
2707
+ btnSpread.title = T('不是搜索:从这条出发,沿已有连接看 2 跳内的邻居')
2708
+ btnSpread.onclick = () => spread(n.id)
2709
+ const btnCopy = el('button', 'btn ghost', T('复制 id'))
2710
+ btnCopy.onclick = () => {
2711
+ navigator.clipboard.writeText(n.uid || n.id).then(() => toast(T('已复制 ') + (n.uid || n.id)))
2712
+ }
2713
+ const btnFocus = el('button', 'btn ghost', T('定位'))
2714
+ btnFocus.onclick = () => state.stage.focusNode(n.id, 2.4)
2715
+ acts.appendChild(btnSpread)
2716
+ acts.appendChild(btnFocus)
2717
+ acts.appendChild(btnCopy)
2718
+ body.appendChild(acts)
2719
+ body.appendChild(el('div', 'seed-note', T('扩散不是搜索:从这条出发,沿已有连接看 2 跳内的邻居。')))
2720
+ }
2721
+
2722
+ function highlight(text, keywords) {
2723
+ const html = esc(text)
2724
+ // 一遍扫完:先插 <mark> 再拿后续关键词去 replace,会把标签本身也标亮,
2725
+ // 关键词含 mark 时还会生成嵌套标签,所以合成一个 alternation 一次替换。
2726
+ const words = [...new Set((keywords || []).filter((k) => k && k.length >= 2 && k.length <= 24))]
2727
+ .filter((k) => !/^(amp|lt|gt|quot|#39)$/i.test(k))
2728
+ .slice(0, 40)
2729
+ .sort((a, b) => b.length - a.length)
2730
+ if (words.length === 0) return html
2731
+ const pattern = words.map((w) => esc(w).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')
2732
+ if (!pattern) return html
2733
+ return html.replace(new RegExp('(' + pattern + ')', 'gi'), '<mark>$1</mark>')
2734
+ }
2735
+
2736
+ async function spread(id) {
2737
+ try {
2738
+ const res = await API.recall('', { seed: id, limit: 10 })
2739
+ const hits = res.hits || []
2740
+ if (!hits.length) return toast(T('它没有可以扩散出去的连接'))
2741
+ state.stage.highlight(id, true)
2742
+ state.stage.pulseFrom([id, ...hits.map((h) => h.id)], true)
2743
+ toast(T('激活 ') + hits.length + T(' 条相邻记忆'))
2744
+ } catch (err) {
2745
+ toast(T('扩散失败:') + err.message)
2746
+ }
2747
+ }
2748
+
2749
+ // ---------------- 悬停提示 ----------------
2750
+ function onHover(hit) {
2751
+ let tip = $('#tip')
2752
+ if (!tip) {
2753
+ tip = el('div')
2754
+ tip.id = 'tip'
2755
+ document.body.appendChild(tip)
2756
+ }
2757
+ if (!hit || !state.graph) {
2758
+ tip.classList.remove('show')
2759
+ return
2760
+ }
2761
+ const n = state.graph.nodes.find((x) => x.id === hit.id)
2762
+ if (!n) {
2763
+ tip.classList.remove('show')
2764
+ return
2765
+ }
2766
+ const isSrc = n.level === 'source'
2767
+ const tipTitle = String(n.title || n.label || n.id)
2768
+ tip.innerHTML =
2769
+ '<div class="tip-title">' + esc(tipTitle.length > 30 ? tipTitle.slice(0, 30) + '…' : tipTitle) + '</div>' +
2770
+ '<div class="tip-meta">' +
2771
+ (isSrc
2772
+ ? esc(n.project || T('来源')) + T(' · 用过它的记忆 ') + (n.degree || 0) + T(' 条')
2773
+ : esc(n.ws) + ' · ' + (LEVEL_LABEL[n.level] || n.level) + T(' · 重要度 ') + (n.importance || 1) + ' · ' + (n.degree || 0) + T(' 条连接')) +
2774
+ '</div>'
2775
+ const w = 300
2776
+ tip.style.left = Math.max(8, Math.min(window.innerWidth - w - 16, hit.x + 18)) + 'px'
2777
+ tip.style.top = Math.max(8, hit.y - 14) + 'px'
2778
+ tip.classList.add('show')
2779
+ }
2780
+
2781
+ function bindHover() {
2782
+ onHover(null)
2783
+ }
2784
+
2785
+ $('#btn-lang')?.addEventListener('click', () => window.NebulaI18n?.toggle())
2786
+
2787
+ // ---------------- 启动 ----------------
2788
+ /** 让星图避开左侧筛选面板与顶栏(窗口变了要重算)。 */
2789
+ function applyPadding() {
2790
+ if (!state.stage) return
2791
+ const f = $('#filters')
2792
+ const rect = f ? f.getBoundingClientRect() : null
2793
+ const shown = rect && rect.width > 0 && f.offsetParent !== null
2794
+ const d = $('#detail')
2795
+ const dOpen = d && d.classList.contains('show')
2796
+ const pad = {
2797
+ left: shown ? Math.round(rect.width) + 26 : 16,
2798
+ right: dOpen ? Math.round(d.getBoundingClientRect().width) + 22 : 16,
2799
+ top: 76,
2800
+ bottom: 48,
2801
+ }
2802
+ if (state.stage2d) state.stage2d.setPadding(pad)
2803
+ if (state.space3d) state.space3d.setPadding(pad)
2804
+ }
2805
+
2806
+ // 三档透镜:星云(2D) / 星系(3D 力导向) / 时间(3D 螺旋)
2807
+ function activeRenderer() {
2808
+ if (state.modeKey !== 'nebula' && state.space3d) return state.space3d
2809
+ return state.stage2d
2810
+ }
2811
+
2812
+ function use3d() {
2813
+ return state.modeKey !== 'nebula' && !!state.space3d
2814
+ }
2815
+
2816
+ /* ── 时间回放:把「时间」从只能看,变成能拖着看 ──────────────────
2817
+ 只在螺旋视图出现。滑到最右=全部,往左滑就是「当时那一刻已经有多少记忆」。
2818
+ 闸门加在 space3d.visible() 里,所以连线也跟着同一时刻一起收。 */
2819
+ function timeBounds() {
2820
+ let min = 0
2821
+ let max = 0
2822
+ for (const n of (state.graph && state.graph.nodes) || []) {
2823
+ const t = Number(n.createdAt) || 0
2824
+ if (!t) continue
2825
+ if (!min || t < min) min = t
2826
+ if (t > max) max = t
2827
+ }
2828
+ if (!min || max <= min) return null
2829
+ return { min, max }
2830
+ }
2831
+
2832
+ function syncTimeCut() {
2833
+ const bar = $('#timebar')
2834
+ const range = $('#time-range')
2835
+ const val = $('#time-val')
2836
+ if (!bar || !range || !val) return
2837
+ const b = timeBounds()
2838
+ if (!b || !state.space3d) {
2839
+ bar.hidden = true
2840
+ return
2841
+ }
2842
+ const v = Number(range.value) || 0
2843
+ const cut = v >= 1000 ? 0 : b.min + ((b.max - b.min) * v) / 1000
2844
+ state.space3d.setTimeCut(cut)
2845
+ const nodes = (state.graph && state.graph.nodes) || []
2846
+ if (!cut) {
2847
+ val.textContent = T('全部 ') + nodes.length + T(' 条')
2848
+ return
2849
+ }
2850
+ let shown = 0
2851
+ for (const n of nodes) {
2852
+ const t = Number(n.createdAt) || 0
2853
+ if (!t || t <= cut) shown++
2854
+ }
2855
+ const d = new Date(cut)
2856
+ const day = d.getMonth() + 1 + '-' + String(d.getDate()).padStart(2, '0')
2857
+ val.textContent = '≤ ' + day + ' · ' + shown + T(' 条')
2858
+ }
2859
+
2860
+ /** 当前时间闸门(毫秒);不在螺旋视图或滑到最右时为 0。 */
2861
+ function timeCutNow() {
2862
+ if (state.modeKey !== 'spiral' || !state.space3d) return 0
2863
+ const b = timeBounds()
2864
+ const r = $('#time-range')
2865
+ if (!b || !r) return 0
2866
+ const v = Number(r.value) || 0
2867
+ return v >= 1000 ? 0 : b.min + ((b.max - b.min) * v) / 1000
2868
+ }
2869
+
2870
+ function showTimebar(on) {
2871
+ const bar = $('#timebar')
2872
+ if (!bar) return
2873
+ if (!on) {
2874
+ bar.hidden = true
2875
+ if (state.space3d && state.space3d.setTimeCut) state.space3d.setTimeCut(0)
2876
+ const r = $('#time-range')
2877
+ if (r) r.value = '1000'
2878
+ return
2879
+ }
2880
+ bar.hidden = false
2881
+ syncTimeCut()
2882
+ }
2883
+
2884
+ function applyMode(nextKey) {
2885
+ let key = nextKey
2886
+ if (key !== 'nebula' && !state.space3d) {
2887
+ toast(T('三维模块还没加载好(独立引擎没开?),先看星云视图'))
2888
+ key = 'nebula'
2889
+ }
2890
+ const prevKey = state.modeKey
2891
+ state.modeKey = key
2892
+ const three = key !== 'nebula'
2893
+ const c2 = $('#sky')
2894
+ const c3 = $('#sky3d')
2895
+ const l3 = $('#sky3dlbl')
2896
+ c2.style.display = three ? 'none' : ''
2897
+ if (c3) c3.hidden = !three
2898
+ if (l3) l3.hidden = !three
2899
+ document.body.classList.toggle('mode-space', three)
2900
+
2901
+ if (three) {
2902
+ state.space3d.setActive(true)
2903
+ const sig = state.graph && state.graph.sig
2904
+ // 光比 sig 不够:老宿主回包没有 sig,undefined === undefined 会让三维永远停在旧图上。
2905
+ // 所以再比一次「是不是同一个 graph 对象」——applyGraph 换了对象就必须重载。
2906
+ const stale3d = !state.space3dSig || state.space3dSig !== sig || state.space3dGraph !== state.graph
2907
+ if (state.graph && stale3d) {
2908
+ state.space3d.load(state.graph, true)
2909
+ state.space3dSig = sig
2910
+ state.space3dGraph = state.graph
2911
+ }
2912
+ state.space3d.setLayout(key === 'spiral' ? 'spiral' : 'cluster')
2913
+ state.space3d.setFilter({
2914
+ ws: state.filter.ws,
2915
+ levels: state.filter.levels,
2916
+ types: state.filter.types,
2917
+ minW: state.filter.minW,
2918
+ minImp: state.filter.minImp,
2919
+ })
2920
+ state.space3d.setSpin(key === 'spiral' && !reduceMotion())
2921
+ state.space3d.fit()
2922
+ // 大库的三维是按重要度取样的:画了多少条必须说出来,
2923
+ // 否则用户会以为「图里就这些星」,把没画出来的当成不存在。
2924
+ const b3 = state.space3d.debug ? state.space3d.debug().budget : null
2925
+ if (b3 && b3.sampled) {
2926
+ toast(
2927
+ T('三维只画重要度前 {n} 条(共 {total} 条);要全量请留在星云视图')
2928
+ .replace('{n}', String(b3.limit))
2929
+ .replace('{total}', String(b3.total)),
2930
+ )
2931
+ }
2932
+ showTimebar(key === 'spiral')
2933
+ } else {
2934
+ if (state.space3d) state.space3d.setActive(false)
2935
+ // 在 3D 里改过窗口大小的话,2D 画布的后备缓冲还是隐藏时的 1×1:先补量一次。
2936
+ if (typeof state.stage2d.resize === 'function') state.stage2d.resize()
2937
+ state.stage2d.setMode('nebula')
2938
+ // 从 3D 切回来时把同一份筛选重新交给 2D:
2939
+ // 两个渲染器各有自己的 hidden 标记,不重放就会「3D 筛过、2D 全亮」。
2940
+ state.stage2d.setFilter({
2941
+ ws: state.filter.ws,
2942
+ levels: state.filter.levels,
2943
+ types: state.filter.types,
2944
+ minW: state.filter.minW,
2945
+ minImp: state.filter.minImp,
2946
+ })
2947
+ state.stage2d.fit()
2948
+ showTimebar(false)
2949
+ }
2950
+ applyPadding()
2951
+ if (prevKey !== key) applyModeLabel()
2952
+ try {
2953
+ localStorage.setItem('nebula.mode', key)
2954
+ } catch {}
2955
+ }
2956
+
2957
+ /** 三维脚本是异步加载的(宿主没它时会走独立引擎),等一会儿再建。 */
2958
+ async function waitSpace(timeout) {
2959
+ const t0 = Date.now()
2960
+ while (!window.NebulaSpace && Date.now() - t0 < (timeout || 4000)) {
2961
+ await new Promise((r) => setTimeout(r, 60))
2962
+ }
2963
+ return !!window.NebulaSpace
2964
+ }
2965
+
2966
+ /**
2967
+ * 服务端建图那几秒:遮罩上写「读来源 / 整理节点 … 第 3 步 · 共 11 步 · 4.2s」。
2968
+ * 原来这里只有一个转圈——用户没法判断是卡住了还是快好了。
2969
+ * 每 700ms 问一次 /progress;那条路由不等建图,所以建图期间也能回答。
2970
+ */
2971
+ function watchBuildProgress() {
2972
+ const boot = $('#boot')
2973
+ if (!boot || typeof API.progress !== 'function') return () => {}
2974
+ let stop = false
2975
+ let lastLabel = ''
2976
+ const t0 = performance.now()
2977
+ const tick = async () => {
2978
+ if (stop) return
2979
+ try {
2980
+ const p = await API.progress()
2981
+ if (p && p.building && p.progress) {
2982
+ const pr = p.progress
2983
+ const secs = Math.round((pr.ms || 0) / 100) / 10
2984
+ const line = T('正在建图') + ':' + (pr.label || pr.stage) + ' · ' + (pr.step + 1) + ' / ' + pr.total + ' · ' + secs + 's' + (pr.nodes ? ' · ' + pr.nodes + T(' 条记忆') : '')
2985
+ if (line !== lastLabel) {
2986
+ lastLabel = line
2987
+ const pct = Math.round(((pr.step + 1) / Math.max(pr.total, 1)) * 100)
2988
+ boot.innerHTML =
2989
+ '<div class="boot-line">' + line + '</div>' +
2990
+ '<div class="boot-bar"><i style="width:' + pct + '%"></i></div>' +
2991
+ '<div class="boot-num">' + (pr.label || pr.stage) + ' · ' + pct + '%</div>'
2992
+ }
2993
+ }
2994
+ } catch {}
2995
+ // 建图最长也就几十秒,超过两分钟就别再问了(页面早该拿到图或者报错了)。
2996
+ if (performance.now() - t0 > 120000) {
2997
+ stop = true
2998
+ return
2999
+ }
3000
+ setTimeout(tick, 700)
3001
+ }
3002
+ tick()
3003
+ return () => {
3004
+ stop = true
3005
+ }
3006
+ }
3007
+
3008
+ // 区块加载的可视化:星云是长出来的,遮罩上就给出「长到哪一步了」
3009
+ function watchGrowth() {
3010
+ const boot = $('#boot')
3011
+ if (!boot) return
3012
+ const t0 = performance.now()
3013
+ const tick = () => {
3014
+ const fn = state.stage && state.stage.progress
3015
+ const pr = typeof fn === 'function' ? state.stage.progress() : null
3016
+ if (!pr) {
3017
+ boot.style.display = 'none'
3018
+ return
3019
+ }
3020
+ const pct = pr.total ? Math.round((pr.shown / pr.total) * 100) : 100
3021
+ boot.innerHTML =
3022
+ '<div class="boot-line">' + T('正在生长记忆星云…') + '</div>' +
3023
+ '<div class="boot-bar"><i style="width:' + pct + '%"></i></div>' +
3024
+ '<div class="boot-num">' + pr.shown + ' / ' + pr.total + T(' 条记忆 · ') + pct + '%</div>'
3025
+ if (pr.done || performance.now() - t0 > 20000) {
3026
+ boot.style.display = 'none'
3027
+ if (window.__nebulaBoot) window.__nebulaBoot.doneMs = Math.round(performance.now() - window.__nebulaBoot.t0)
3028
+ return
3029
+ }
3030
+ requestAnimationFrame(tick)
3031
+ }
3032
+ requestAnimationFrame(tick)
3033
+ }
3034
+
3035
+ /* ---------------- 键盘导航与读屏索引 ----------------
3036
+ 画布本身对读屏是一块空白(canvas 里的像素没有语义),所以这里做两件事:
3037
+ 1) 一个真正的键盘入口 #skykeys:方向键按「空间方向」在星星之间走,
3038
+ Enter 打开、[ ] 沿连接走、+/- 缩放、0 回全图、Home 跳到枢纽、Esc 离开;
3039
+ 2) 一份 sr-only 的纯文本摘要 + 索引,让读屏用户不靠画面也知道这里有什么。 */
3040
+
3041
+ // 读屏索引最多列这么多条:再多就不是索引,而是把整库糊进 DOM。
3042
+ const A11Y_INDEX_MAX = 300
3043
+ let liveTimer = 0
3044
+
3045
+ /** 把一句话交给 aria-live。同样的句子连说两次(连按两下方向键)也要能再播一遍。 */
3046
+ function announce(text) {
3047
+ const box = $('#a11y-live')
3048
+ if (!box || !text) return
3049
+ box.textContent = ''
3050
+ clearTimeout(liveTimer)
3051
+ liveTimer = setTimeout(() => {
3052
+ box.textContent = text
3053
+ }, 40)
3054
+ }
3055
+
3056
+ /** 这颗星在文字列表里叫什么:标题 + 所属项目,读屏至少能听出是哪一条。 */
3057
+ function navLabel(id) {
3058
+ const n = state.nodeById && state.nodeById.get(id)
3059
+ if (!n) return String(id)
3060
+ const raw = String(n.title || n.label || id)
3061
+ const short = raw.length > 48 ? raw.slice(0, 47) + '…' : raw
3062
+ const ws = n.wsTitle || n.ws || ''
3063
+ return ws && ws !== short ? short + ' · ' + ws : short
3064
+ }
3065
+
3066
+ /** 当前视图里「看得见、又有屏幕坐标」的星星,喂给方向键做几何挑选。 */
3067
+ function navPoints() {
3068
+ const st = state.stage
3069
+ const g = state.graph
3070
+ if (!st || !g) return []
3071
+ let list = []
3072
+ try {
3073
+ list = (st.visibleNodes && st.visibleNodes()) || []
3074
+ } catch {}
3075
+ if (!list.length) list = g.nodes || []
3076
+ const out = []
3077
+ for (const n of list) {
3078
+ let p = null
3079
+ try {
3080
+ p = st.screenOf ? st.screenOf(n.id) : null
3081
+ } catch {}
3082
+ // 被转到屏幕外、或者被背面挡住的星没有坐标:跳过,别让方向键跳到看不见的地方
3083
+ if (!p || !isFinite(p.x) || !isFinite(p.y)) continue
3084
+ out.push({ id: n.id, x: p.x, y: p.y })
3085
+ if (out.length >= 2000) break
3086
+ }
3087
+ return out
3088
+ }
3089
+
3090
+ /** 走到某颗星:选中 + 播报;镜头只平移,不改缩放(缩放交给 +/- 和 Enter)。 */
3091
+ function stepTo(id, opts = {}) {
3092
+ if (!id) return
3093
+ const st = state.stage
3094
+ state.selected = id
3095
+ if (st) {
3096
+ try {
3097
+ st.select(id)
3098
+ } catch {}
3099
+ if (!opts.keepView) {
3100
+ try {
3101
+ if (st.centerOn) st.centerOn(id)
3102
+ } catch {}
3103
+ }
3104
+ }
3105
+ announce(T('当前位置:') + navLabel(id))
3106
+ // 详情面板开着的时候,键盘走到哪、右边就跟到哪
3107
+ if ($('#detail').classList.contains('show')) showDetail(id, { focus: false })
3108
+ }
3109
+
3110
+ /** 方向键:按屏幕上的空间关系挑下一颗,不是按数组顺序。 */
3111
+ function navMove(dir) {
3112
+ const pts = navPoints()
3113
+ if (!pts.length) {
3114
+ announce(T('这里还没有星星'))
3115
+ return false
3116
+ }
3117
+ const nav = window.NebulaNav
3118
+ const onScreen = state.selected && pts.some((p) => p.id === state.selected)
3119
+ const from = onScreen ? state.selected : nav ? nav.nearest(pts, null) : pts[0].id
3120
+ const id = nav ? nav.pick(pts, from, dir) : null
3121
+ if (!id) {
3122
+ // 第一次按键时还没有「当前星」:先落在最近的一颗上,不算走了一步
3123
+ if (!onScreen && from) stepTo(from, { keepView: true })
3124
+ else announce(T('这个方向没有别的记忆'))
3125
+ return false
3126
+ }
3127
+ stepTo(id)
3128
+ return true
3129
+ }
3130
+
3131
+ /** [ / ]:沿已有的连接走,按强度从强到弱循环。 */
3132
+ function navAlong(step) {
3133
+ const cur = state.selected
3134
+ if (!cur || !state.graph) return false
3135
+ const list = window.NebulaNav ? window.NebulaNav.neighbors(state.graph.edges, cur, 0.2) : []
3136
+ if (!list.length) {
3137
+ announce(T('这颗星没有连出去的线'))
3138
+ return false
3139
+ }
3140
+ const at = Number(state.navAlongAt) || 0
3141
+ const idx = (((at + step) % list.length) + list.length) % list.length
3142
+ state.navAlongAt = idx
3143
+ stepTo(list[idx].id)
3144
+ return true
3145
+ }
3146
+
3147
+ /** + / -:跟滚轮同一套限位。 */
3148
+ function navZoom(factor) {
3149
+ const st = state.stage
3150
+ if (!st || !st.zoomBy) return false
3151
+ try {
3152
+ st.zoomBy(factor)
3153
+ } catch {}
3154
+ announce(factor > 1 ? T('已放大') : T('已缩小'))
3155
+ return true
3156
+ }
3157
+
3158
+ /** 0:回到全图;Home:跳到连接最多的那颗(没有度数数据时退回第一颗)。 */
3159
+ function navFit() {
3160
+ if (state.stage) state.stage.fit()
3161
+ announce(T('回到全视图'))
3162
+ }
3163
+
3164
+ function navHub() {
3165
+ const pts = navPoints()
3166
+ if (!pts.length) {
3167
+ announce(T('这里还没有星星'))
3168
+ return
3169
+ }
3170
+ const id = window.NebulaNav ? window.NebulaNav.hub(pts, state.degree || {}) : pts[0].id
3171
+ if (id) stepTo(id)
3172
+ }
3173
+
3174
+ /** Esc:有详情先收详情,再按一次才离开星图,焦点回到页面上的按钮。 */
3175
+ function leaveSky() {
3176
+ if ($('#detail').classList.contains('show')) {
3177
+ closeDetail()
3178
+ announce(T('已收起详情'))
3179
+ return
3180
+ }
3181
+ const layer = $('#skykeys')
3182
+ if (layer) layer.blur()
3183
+ const back = $('#btn-keys') || $('#q')
3184
+ if (back && back.focus) back.focus()
3185
+ announce(T('已离开星图'))
3186
+ }
3187
+
3188
+ function bindKeyboardNav() {
3189
+ const layer = $('#skykeys')
3190
+ const stage = $('#stage')
3191
+ if (!layer || !stage) return
3192
+ const ZOOM = 1.25
3193
+ layer.addEventListener('keydown', (ev) => {
3194
+ if (ev.altKey || ev.ctrlKey || ev.metaKey) return
3195
+ let handled = true
3196
+ switch (ev.key) {
3197
+ case 'ArrowUp':
3198
+ navMove('up')
3199
+ break
3200
+ case 'ArrowDown':
3201
+ navMove('down')
3202
+ break
3203
+ case 'ArrowLeft':
3204
+ navMove('left')
3205
+ break
3206
+ case 'ArrowRight':
3207
+ navMove('right')
3208
+ break
3209
+ case 'Enter':
3210
+ case ' ':
3211
+ if (state.selected) {
3212
+ showDetail(state.selected, { focus: true })
3213
+ announce(T('已打开:') + navLabel(state.selected))
3214
+ }
3215
+ break
3216
+ case '[':
3217
+ navAlong(-1)
3218
+ break
3219
+ case ']':
3220
+ navAlong(1)
3221
+ break
3222
+ case '+':
3223
+ case '=':
3224
+ navZoom(ZOOM)
3225
+ break
3226
+ case '-':
3227
+ case '_':
3228
+ navZoom(1 / ZOOM)
3229
+ break
3230
+ case '0':
3231
+ navFit()
3232
+ break
3233
+ case 'Home':
3234
+ navHub()
3235
+ break
3236
+ case 'Escape':
3237
+ leaveSky()
3238
+ break
3239
+ default:
3240
+ handled = false
3241
+ }
3242
+ if (handled) {
3243
+ ev.preventDefault()
3244
+ // 别让 f / e / 1 / 2 / 3 这些全局快捷键把这一下也吃一遍
3245
+ ev.stopPropagation()
3246
+ }
3247
+ })
3248
+ // 焦点进来时先落一颗,否则第一次按方向键没有起点
3249
+ layer.addEventListener('focus', () => {
3250
+ if (state.selected || !state.graph) return
3251
+ const pts = navPoints()
3252
+ const first = window.NebulaNav ? window.NebulaNav.nearest(pts, null) : pts[0] && pts[0].id
3253
+ if (first) stepTo(first, { keepView: true })
3254
+ })
3255
+ // 点画布=把焦点递给键盘层,接着就能用方向键;输入框和面板按钮不受影响
3256
+ stage.addEventListener(
3257
+ 'pointerdown',
3258
+ (ev) => {
3259
+ const tag = (ev.target && ev.target.tagName) || ''
3260
+ if (tag !== 'CANVAS') return
3261
+ layer.focus({ preventScroll: true })
3262
+ },
3263
+ true
3264
+ )
3265
+ }
3266
+
3267
+ /** 给读屏的纯文本索引:标题按重要度排,最多 A11Y_INDEX_MAX 条。 */
3268
+ function renderA11yIndex(g) {
3269
+ const sum = $('#a11y-summary')
3270
+ const list = $('#a11y-index')
3271
+ if (!sum || !list) return
3272
+ const nodes = (g && g.nodes) || []
3273
+ const edges = (g && g.edges) || []
3274
+ sum.textContent = nodes.length
3275
+ ? T('宏记忆 · 星图:') + nodes.length + T(' 条记忆,') + edges.length + T(' 条连接') + T('。按 Tab 进入星图后,用方向键在星星之间移动,回车打开。')
3276
+ : T('暂无数据')
3277
+ list.innerHTML = ''
3278
+ const sorted = nodes.slice().sort((a, b) => (b.importance || 0) - (a.importance || 0))
3279
+ for (const n of sorted.slice(0, A11Y_INDEX_MAX)) {
3280
+ const li = document.createElement('li')
3281
+ li.textContent = navLabel(n.id)
3282
+ list.appendChild(li)
3283
+ }
3284
+ if (sorted.length > A11Y_INDEX_MAX) {
3285
+ const li = document.createElement('li')
3286
+ li.textContent = T('还有 ') + (sorted.length - A11Y_INDEX_MAX) + T(' 条,用搜索或项目筛选收窄范围。')
3287
+ list.appendChild(li)
3288
+ }
3289
+ }
3290
+
3291
+ /** 「记忆来源」那块也能收起:小屏时把它叠起来,图就露出来了。 */
3292
+ function bindSourcesFold() {
3293
+ const panel = $('#sources')
3294
+ const title = panel && panel.querySelector('.f-title')
3295
+ if (!panel || !title || title.dataset.foldBound) return
3296
+ title.dataset.foldBound = '1'
3297
+ const right = el('span', 'h4-r')
3298
+ const tag = $('#src-tag')
3299
+ if (tag) right.appendChild(tag)
3300
+ right.appendChild(attachFold(panel, 'f:sources'))
3301
+ title.appendChild(right)
3302
+ }
3303
+
3304
+ /**
3305
+ * 快照校验和(1.11.0):单文件快照会被聊天软件改写、被网盘截断、被编辑器重存成别的编码。
3306
+ * 断掉的文件照样能渲染出一半星图——看着像「记忆变少了」,其实文件坏了。
3307
+ * 导出时对数据那段原始文本算过 sha256,这里逐字节比对;对不上就挂在屏幕上说清楚。
3308
+ */
3309
+ function snapshotBanner(kind, msg) {
3310
+ let bar = $('#snapshot-integrity')
3311
+ if (!bar) {
3312
+ bar = el('div', null)
3313
+ bar.id = 'snapshot-integrity'
3314
+ bar.setAttribute('role', 'alert')
3315
+ document.body.appendChild(bar)
3316
+ }
3317
+ bar.className = kind === 'ok' ? 'ok' : 'bad'
3318
+ bar.textContent = msg
3319
+ bar.hidden = false
3320
+ }
3321
+
3322
+ async function verifySnapshotIntegrity() {
3323
+ // 数据块存在但解析失败(截断/编码被改):这时 API.snapshot 是 false,
3324
+ // 页面会当成「实时模式」去请求——必须抢在前面把话说清楚,否则就是白屏。
3325
+ if (window.__NEBULA_SNAPSHOT_BROKEN__) {
3326
+ snapshotBanner('bad', T('快照数据读不出来(文件损坏或没下载完整):') + window.__NEBULA_SNAPSHOT_BROKEN__ + T('。请重新导出。'))
3327
+ return
3328
+ }
3329
+ if (!API.snapshot) return
3330
+ const meta = window.__NEBULA_SNAPSHOT_INTEGRITY__
3331
+ const text = window.__NEBULA_SNAPSHOT_DATA_TEXT__
3332
+ if (!meta || typeof text !== 'string') return
3333
+ const bytes = new TextEncoder().encode(text)
3334
+ let got = ''
3335
+ const subtle = window.crypto && window.crypto.subtle
3336
+ if (subtle && typeof subtle.digest === 'function') {
3337
+ try {
3338
+ const buf = await subtle.digest('SHA-256', bytes)
3339
+ got = Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, '0')).join('')
3340
+ } catch {
3341
+ got = ''
3342
+ }
3343
+ }
3344
+ if (!got) {
3345
+ // 少数 file:// 环境没有 WebCrypto:至少核对长度,别一声不响地说「校验过」
3346
+ if (bytes.length !== meta.bytes) {
3347
+ snapshotBanner('bad', T('快照长度与导出时不一致(') + bytes.length + ' / ' + meta.bytes + T(' 字节):文件可能没下载完整。请重新导出。'))
3348
+ }
3349
+ return
3350
+ }
3351
+ if (got !== meta.sha256) {
3352
+ snapshotBanner(
3353
+ 'bad',
3354
+ T('快照校验失败:文件被改动过或没下载完整') +
3355
+ ' · ' +
3356
+ T('期望 ') +
3357
+ String(meta.sha256).slice(0, 8) +
3358
+ '… ' +
3359
+ T('实际 ') +
3360
+ got.slice(0, 8) +
3361
+ '… ' +
3362
+ T('。图上的内容可能缺一部分,请重新导出。')
3363
+ )
3364
+ return
3365
+ }
3366
+ toast(T('快照校验通过') + ' · sha256 ' + got.slice(0, 8) + '…')
3367
+ }
3368
+
3369
+ async function boot() {
3370
+ const canvas = $('#sky')
3371
+ state.stage2d = window.Nebula.stage(canvas, {})
3372
+ if (window.__NEBULA_DEBUG__) window.__NEBULA_STAGE2D__ = state.stage2d
3373
+ state.space3d = (await waitSpace()) ? window.NebulaSpace.create($('#sky3d'), $('#sky3dlbl')) : null
3374
+ // 上一轮拖过的引力在这一刻生效:不调这一下,滑杆位置和画面就是两回事
3375
+ if (state.space3d) applyForceToStage()
3376
+ state.modeKey = 'nebula'
3377
+ // 快照启动时先核对校验和:坏文件要立刻说出来,而不是渲染出一张缺角的图
3378
+ verifySnapshotIntegrity().catch(() => {})
3379
+ // 门面:所有 state.stage.xxx 调用都落到当前视图上
3380
+ state.stage = new Proxy(
3381
+ {},
3382
+ {
3383
+ get(_t, key) {
3384
+ const r = activeRenderer()
3385
+ const v = r[key]
3386
+ return typeof v === 'function' ? v.bind(r) : v
3387
+ },
3388
+ }
3389
+ )
3390
+ for (const r of [state.stage2d, state.space3d].filter(Boolean)) {
3391
+ r.on('select', (id) => {
3392
+ showDetail(id)
3393
+ // 局部图只对三维视图有效;2D 星云没有 setLocal,直接跳过
3394
+ if (r === state.space3d) applyLocal(id)
3395
+ })
3396
+ r.on('hover', (hit) => onHover(hit))
3397
+ // 点 LOD 光斑=钻进那个项目。镜头会飞过去,但得说一声,别让人以为「怎么突然变了」
3398
+ r.on('lod', (ws) => {
3399
+ const c = ((state.graph && state.graph.clusters) || []).find((x) => x.id === ws)
3400
+ toast(T('已放大「') + ((c && c.title) || ws) + T('」 · 双击空白回到全图'))
3401
+ })
3402
+ if (typeof r.on === 'function') r.on('path', (req) => showPath(req && req.from, req && req.to))
3403
+ // 调试/自动化入口:等价于「Shift + 点两下」,也方便在控制台直接查
3404
+ window.__nebulaShowPath = showPath
3405
+ }
3406
+ bindHover()
3407
+ bindKeyboardNav()
3408
+ applyPadding()
3409
+ window.addEventListener('resize', () => {
3410
+ applyPadding()
3411
+ if (use3d() && state.space3d) state.space3d.resize()
3412
+ })
3413
+ /**
3414
+ * 引擎体检:页面能打开不代表宿主里的代码是新的。DSH 只在启动时装配插件,
3415
+ * 换了代码没重启时,页面的基础视图还活着,但 /sources /bridge /ledger /ingest
3416
+ * 这些新接口会 404——对用户就是「功能忽然消失了」,必须自己说出来。
3417
+ */
3418
+ const ENGINE_CAPS = ['sources', 'bridge', 'ledger', 'ingest']
3419
+ function checkEngine(meta) {
3420
+ if (!meta) return
3421
+ state.engineBuild = meta.build
3422
+ state.engineVersion = meta.version || ''
3423
+ const bar = $('#skewbar')
3424
+ if (!bar) return
3425
+ const caps = Array.isArray(meta.capabilities) ? meta.capabilities : null
3426
+ const missing = ENGINE_CAPS.filter((c) => !caps || !caps.includes(c))
3427
+ if (!missing.length) {
3428
+ bar.hidden = true
3429
+ // 只有页面本身不是独立引擎、却切到了 7890 这条腿时才值得说一声;
3430
+ // 从 /app 直接打开时 base 就是同源,不需要提示。
3431
+ if (meta.mode === 'standalone' && API.base !== '/api/memory-nebula') {
3432
+ const tag = 'standalone:' + (meta.version || '') + ':' + (meta.build || '')
3433
+ let seen = ''
3434
+ try {
3435
+ seen = sessionStorage.getItem('nebula.engine') || ''
3436
+ } catch {}
3437
+ if (seen !== tag) {
3438
+ try {
3439
+ sessionStorage.setItem('nebula.engine', tag)
3440
+ } catch {}
3441
+ toast(T('已切到独立引擎 ') + (meta.version ? 'v' + meta.version : '') + T('(宿主里的旧引擎没被使用)'))
3442
+ }
3443
+ }
3444
+ return
3445
+ }
3446
+ // 同一个构建只劝一次;重启后 build 变了会重新提示
3447
+ let dismissed = ''
3448
+ try {
3449
+ dismissed = sessionStorage.getItem('nebula.skew') || ''
3450
+ } catch {}
3451
+ if (dismissed === String(meta.build)) {
3452
+ bar.hidden = true
3453
+ return
3454
+ }
3455
+ const text = $('#skew-text')
3456
+ if (text) {
3457
+ const ver = meta.version ? 'v' + esc(meta.version) : T('旧版')
3458
+ text.innerHTML =
3459
+ '<b>' + T('宿主里跑的是 ') + ver + T(' 引擎') + '</b>' + T(',缺 ') +
3460
+ missing.map((c) => '<code>' + esc(c) + '</code>').join(' ') +
3461
+ T(' 接口。重启 DSH 后刷新即可;不想重启就在插件目录运行 ') +
3462
+ '<code>powershell -ExecutionPolicy Bypass -File sidecar.ps1 start</code>' +
3463
+ T(',再刷新本页就会自动切到独立引擎。')
3464
+ }
3465
+ bar.hidden = false
3466
+ }
3467
+
3468
+ // 数据侧:探测接口 → 取图 → 交给渲染层 → 开轮询。
3469
+ // 失败重试走的是同一个函数,不另写一条路径(形状/统计/时间轴才不会分叉)。
3470
+ const skewClose = $('#skew-close')
3471
+ if (skewClose) {
3472
+ skewClose.onclick = () => {
3473
+ const bar = $('#skewbar')
3474
+ if (bar) bar.hidden = true
3475
+ try {
3476
+ sessionStorage.setItem('nebula.skew', String((API.meta && API.meta.build) || ''))
3477
+ } catch {}
3478
+ }
3479
+ }
3480
+ async function pullGraph() {
3481
+ // 离线快照没有后端:resolveBase 会直接返回(顺便把 META 填成快照自己的元信息),
3482
+ // 也不该去检查宿主的构建版本。
3483
+ await API.resolveBase()
3484
+ if (!API.snapshot && !API.demo) checkEngine(API.meta)
3485
+ // P0 计时:网络 / 建图 / 首帧 —— 没有基线就不许说"提速了"
3486
+ window.__nebulaBoot = { t0: performance.now() }
3487
+ // 首屏顺手问一句「有没有新东西」:没变就秒回同一张图,变了后端只在后台重建,
3488
+ // 手上这张旧图先画出来(返回里 refreshing/stale 会说明这件事)。
3489
+ const stopProgress = watchBuildProgress()
3490
+ let graph
3491
+ try {
3492
+ graph = await API.graph({ refresh: 1 })
3493
+ } finally {
3494
+ stopProgress()
3495
+ }
3496
+ window.__nebulaBoot.graphMs = Math.round(performance.now() - window.__nebulaBoot.t0)
3497
+ window.__nebulaBoot.nodes = graph.nodes.length
3498
+ window.__nebulaBoot.v = graph.v || 1
3499
+ applyGraph(graph, { keepView: false, filters: true })
3500
+ window.__nebulaBoot.firstDrawMs = Math.round(performance.now() - window.__nebulaBoot.t0)
3501
+ bindSourcesFold()
3502
+ renderSources()
3503
+ // 区块加载:星云还在长的时候别急着把遮罩撤掉
3504
+ watchGrowth()
3505
+ // 上次看的是哪一档就看哪一档
3506
+ try {
3507
+ const saved = localStorage.getItem('nebula.mode')
3508
+ if (saved && saved !== 'nebula' && state.space3d) applyMode(saved)
3509
+ } catch {}
3510
+ if (!graph.nodes.length) showEmptyHint()
3511
+ renderModeBar()
3512
+ // 示例与快照都是死的:没有「别的会话刚写了新记忆」这回事,别每 12 秒去敲一次门
3513
+ if (API.snapshot || API.demo) stopPolling()
3514
+ else startPolling()
3515
+ const boot = $('#boot')
3516
+ if (boot) {
3517
+ boot.classList.remove('err')
3518
+ boot.hidden = true
3519
+ }
3520
+ }
3521
+
3522
+ /** 空库不是一句「这里还没有星星」:给三条能走的路,第一条直接能点。 */
3523
+ function showEmptyHint() {
3524
+ const hint = $('#hint')
3525
+ if (!hint) return
3526
+ hint.innerHTML = ''
3527
+ hint.classList.add('show', 'empty')
3528
+ hint.dataset.empty = '1'
3529
+ const card = el('div', 'hcard')
3530
+ card.appendChild(el('b', null, T('还没有星星')))
3531
+ card.appendChild(el('div', 'hsub', T('这里会显示你的记忆库。挑一条路开始:')))
3532
+ const opt = (n, text) => {
3533
+ const row = el('div', 'hopt')
3534
+ row.appendChild(el('span', 'hn', n))
3535
+ row.appendChild(el('span', null, text))
3536
+ card.appendChild(row)
3537
+ }
3538
+ opt('1', T('已经在用 meow-memory / OpenViking:先去对话里写几条记忆,再点「重建星图」。'))
3539
+ opt('2', T('想先看看长什么样:进示例星系,逛完随时退出来,不会动你的库。'))
3540
+ opt('3', T('想接自己的数据:看 docs/adapters.md,把记忆库指过来。'))
3541
+ const act = el('div', 'hact')
3542
+ let demoBtn = null
3543
+ if (!API.snapshot) {
3544
+ demoBtn = el('button', 'hbtn', T('看示例'))
3545
+ demoBtn.type = 'button'
3546
+ demoBtn.onclick = () => enterDemo()
3547
+ act.appendChild(demoBtn)
3548
+ }
3549
+ const retryBtn = el('button', 'hbtn ghost', T('重建星图'))
3550
+ retryBtn.type = 'button'
3551
+ retryBtn.onclick = () => $('#btn-refresh')?.click()
3552
+ act.appendChild(retryBtn)
3553
+ card.appendChild(act)
3554
+ hint.appendChild(card)
3555
+ }
3556
+
3557
+ /** 顶部那条「示例 / 快照」的状态条。 */
3558
+ function renderModeBar() {
3559
+ const bar = $('#demobar')
3560
+ const text = $('#demo-text')
3561
+ const exit = $('#demo-exit')
3562
+ if (!bar || !text || !exit) return
3563
+ if (API.snapshot) {
3564
+ bar.hidden = false
3565
+ exit.hidden = true
3566
+ const when = API.meta && API.meta.builtAt ? new Date(API.meta.builtAt).toLocaleString(document.documentElement.lang === 'en' ? 'en-US' : 'zh-CN') : ''
3567
+ const snap = window.__NEBULA_SNAPSHOT__
3568
+ const scope = snap && snap.scope
3569
+ const where = scope && scope.kind !== 'all' && scope.label ? ' · ' + esc(scope.label) : ''
3570
+ text.innerHTML =
3571
+ '<b>' + T('离线快照') + '</b>' +
3572
+ where +
3573
+ T(' · 只读') +
3574
+ (when ? T(' · 生成于 ') + esc(when) : '') +
3575
+ T(' · 搜索与证据链都在本地算')
3576
+ return
3577
+ }
3578
+ if (API.demo) {
3579
+ bar.hidden = false
3580
+ exit.hidden = false
3581
+ const n = state.graph && state.graph.nodes ? state.graph.nodes.length : 0
3582
+ text.innerHTML = '<b>' + T('示例星系') + '</b> · ' + n + T(' 条虚构记忆 · 只读 · 你的记忆库没有被碰过')
3583
+ return
3584
+ }
3585
+ bar.hidden = true
3586
+ }
3587
+
3588
+ async function enterDemo() {
3589
+ if (API.snapshot) return
3590
+ API.setDemo(true)
3591
+ const hint = $('#hint')
3592
+ if (hint) {
3593
+ hint.classList.remove('show', 'empty')
3594
+ delete hint.dataset.empty
3595
+ }
3596
+ try {
3597
+ await pullGraph()
3598
+ showOnboard()
3599
+ toast(T('示例星系:随便点,右栏的点线都是真的算出来的'))
3600
+ } catch (err) {
3601
+ API.setDemo(false)
3602
+ showBootError(err)
3603
+ }
3604
+ }
3605
+
3606
+ /**
3607
+ * 失败态。以前这里直接把 `Failed to fetch` 和一大坨 debugState 糊在中间,
3608
+ * 用户既不知道发生了什么、也没有任何可点的东西。现在:说人话 + 给一个重试按钮,
3609
+ * 诊断信息折进 details(要报 bug 时再展开)。
3610
+ */
3611
+ function showBootError(err) {
3612
+ const boot = $('#boot')
3613
+ if (!boot) return
3614
+ const msg = String((err && err.message) || err || '')
3615
+ state.lastError = msg.slice(0, 300)
3616
+ const slow = /超时/.test(msg)
3617
+ const net = slow || /fetch|network|load failed|timeout|econn/i.test(msg)
3618
+ const denied = /40[13]/.test(msg)
3619
+ const title = denied ? T('这个视图需要从 DSH 里打开') : net ? T('连不上记忆库') : T('加载记忆库时出错')
3620
+ const why = denied
3621
+ ? T('直接打开这个地址会被挡在门外。回 DSH 的对话窗口,从侧栏或命令里打开宏记忆 · 星图即可。')
3622
+ : net
3623
+ ? slow
3624
+ ? T('等了 12 秒还没有回包:宿主可能正忙,或者独立引擎半死。稍等一下再点重试。')
3625
+ : '<b>' + T('接口') + '</b> <b>/api/memory-nebula</b>' + T('没有回应。多半是 DSH 正在重启,或者独立引擎还没起来——等两秒再点重试。')
3626
+ : T('取图这一步失败了。技术细节在下面,重试一次通常就好。')
3627
+ let dbg = ''
3628
+ try {
3629
+ const d = state.stage2d && state.stage2d.debugState ? state.stage2d.debugState() : null
3630
+ if (d) dbg = JSON.stringify(d.row || d, null, 0)
3631
+ } catch {}
3632
+ boot.hidden = false
3633
+ boot.classList.add('err')
3634
+ // 换行字符用常量拼,避免字符串里真的断行
3635
+ const NL = String.fromCharCode(10)
3636
+ const stackLines = err && err.stack ? String(err.stack).split(NL).slice(1, 4).join(NL) : ''
3637
+ const detailText = (m, stackPart, d) => [m, stackPart, d].filter(Boolean).join(NL)
3638
+ boot.innerHTML =
3639
+ '<div class="bt">' + esc(title) + '</div>' +
3640
+ '<div class="bs">' + why + '</div>' +
3641
+ '<div class="brow">' +
3642
+ '<button class="bretry" type="button">' + T('重试') + '</button>' +
3643
+ (dbg ? '<button class="bdiag" type="button">' + T('复制诊断') + '</button>' : '') +
3644
+ '</div>' +
3645
+ '<details><summary>' + T('技术细节') + '</summary><pre>' +
3646
+ esc(detailText(msg, stackLines, dbg)) +
3647
+ '</pre></details>'
3648
+ const retry = boot.querySelector('.bretry')
3649
+ if (retry) {
3650
+ retry.onclick = async () => {
3651
+ retry.disabled = true
3652
+ retry.textContent = T('重试中…')
3653
+ try {
3654
+ await pullGraph()
3655
+ } catch (e2) {
3656
+ showBootError(e2)
3657
+ }
3658
+ }
3659
+ }
3660
+ const diag = boot.querySelector('.bdiag')
3661
+ if (diag) {
3662
+ diag.onclick = () => {
3663
+ copyText([msg, dbg].filter(Boolean).join(NL))
3664
+ toast(T('诊断信息已复制'))
3665
+ }
3666
+ }
3667
+ }
3668
+
3669
+ // 退出示例必须回到真实库:这个 handler 得放在 boot 里,
3670
+ // pullGraph / showBootError 都是 boot 的局部函数(放外面会 ReferenceError,真踩过)。
3671
+ const demoExitBtn = $('#demo-exit')
3672
+ if (demoExitBtn) {
3673
+ demoExitBtn.onclick = async () => {
3674
+ demoExitBtn.disabled = true
3675
+ API.setDemo(false)
3676
+ try {
3677
+ await pullGraph()
3678
+ showOnboard()
3679
+ toast(T('回到你自己的记忆库'))
3680
+ } catch (err) {
3681
+ showBootError(err)
3682
+ } finally {
3683
+ demoExitBtn.disabled = false
3684
+ }
3685
+ }
3686
+ }
3687
+
3688
+ // 搜索空态里的「看看示例」走事件,不把 boot 内部函数挂到模块作用域。
3689
+ window.addEventListener('nebula:enter-demo', () => {
3690
+ if (!API.snapshot && !API.demo) enterDemo()
3691
+ })
3692
+
3693
+ try {
3694
+ // ?demo=1 直达示例星系:方便把示例链接发出去,也方便自动化验证。
3695
+ // 快照里没有后端,忽略这个参数。
3696
+ if (!API.snapshot && new URLSearchParams(location.search).get('demo') === '1') API.setDemo(true)
3697
+ await pullGraph()
3698
+ showOnboard()
3699
+ } catch (err) {
3700
+ console.error('[nebula] boot failed', err)
3701
+ showBootError(err)
3702
+ }
3703
+ }
3704
+
3705
+ // 轮询:别的会话写入记忆后,星云自动长出新星星
3706
+ let pollTimer = 0
3707
+ function stopPolling() {
3708
+ clearInterval(pollTimer)
3709
+ pollTimer = 0
3710
+ }
3711
+ function startPolling() {
3712
+ clearInterval(pollTimer)
3713
+ // 示例星系是内存里的死数据、离线快照连后端都没有:都不需要「有没有新记忆」的轮询。
3714
+ if (API.snapshot || API.demo) return
3715
+ const tick = async () => {
3716
+ // 标签页在后台时没必要每 12 秒打一次 /ping(也不会有人看更新提示)
3717
+ if (document.hidden) return
3718
+ try {
3719
+ const ping = await fetch(API.base + '/ping', { headers: { accept: 'application/json' } }).then((r) => r.json())
3720
+ if (state.offline) setOffline(false)
3721
+ if (ping && ping.build !== state.engineBuild) checkEngine(ping)
3722
+ if (!state.graph || ping.sig !== state.graph.sig) {
3723
+ const before = state.graph ? state.graph.nodes.length : 0
3724
+ // 数据变了,左栏的计数/新工作区也要跟着变;buildFilters 会读 state.filter 并保留筛选
3725
+ const graph = applyGraph(await API.graph(), { keepView: true, filters: true })
3726
+ const diff = graph.nodes.length - before
3727
+ toastBackground(T('星云已更新') + (diff ? ':' + (diff > 0 ? '+' : '') + diff + T(' 条记忆') : ''))
3728
+ if (state.selected) showDetail(state.selected)
3729
+ }
3730
+ } catch {
3731
+ // 这条腿断了(独立引擎被关掉 / 宿主正在重启)→ 换另一条腿再试;
3732
+ // 两条都不通就亮起顶部细提示,别让人对着不动的图猜发生了什么。
3733
+ const ok = await alignFailure()
3734
+ if (!ok) setOffline(true)
3735
+ else if (state.offline) setOffline(false)
3736
+ }
3737
+ }
3738
+ pollTimer = setInterval(tick, 12000)
3739
+ if (!state.visBound) {
3740
+ state.visBound = true
3741
+ // 回到前台补一次,免得刚切回来时图上还是十几分钟前的数据
3742
+ document.addEventListener('visibilitychange', () => {
3743
+ if (!document.hidden) tick()
3744
+ })
3745
+ }
3746
+ }
3747
+
3748
+ /** 当前接口挂了:尝试换腿,接上了就重载整张图。 */
3749
+ async function alignFailure() {
3750
+ const switched = await API.failover()
3751
+ if (!switched) return false
3752
+ checkEngine(API.meta)
3753
+ toast(T('接口已切到 ') + (API.base === '/api/memory-nebula' ? T('宿主') : T('独立引擎')))
3754
+ try {
3755
+ applyGraph(await API.graph(), { keepView: true, filters: true })
3756
+ } catch (err) {
3757
+ softWarn('align', err)
3758
+ }
3759
+ return true
3760
+ }
3761
+
3762
+ /**
3763
+ * 图进渲染层的唯一入口。
3764
+ *
3765
+ * 以前 boot / 轮询 / 重建 / 换腿 各自把 graph 塞给 stage,形状收口只在其中一条路径上,
3766
+ * 于是「点重建连线消失」这种事故迟早会发生(真的发生了)。现在统一从这里过:
3767
+ * ① 形状收口(幂等,压缩边还原成 {a,b})
3768
+ * ② 更新 state
3769
+ * ③ 交给当前视图 load,并刷新统计/图例/筛选
3770
+ */
3771
+ function applyGraph(graph, opts = {}) {
3772
+ if (!graph) return null
3773
+ const g = API.normalizeGraph ? API.normalizeGraph(graph) : graph
3774
+ state.graph = g
3775
+ // 分页信息跟着图一起换:小图 page.next 为空,分页条自然不出现
3776
+ state.page = g.page || null
3777
+ state.nodeById = new Map((g.nodes || []).map((n) => [n.id, n]))
3778
+ state.degree = new Map()
3779
+ for (const e of g.edges || []) {
3780
+ state.degree.set(e.a, (state.degree.get(e.a) || 0) + 1)
3781
+ state.degree.set(e.b, (state.degree.get(e.b) || 0) + 1)
3782
+ }
3783
+ state.navAlongAt = 0
3784
+ state.stage.load(g, opts.keepView !== false)
3785
+ renderStats(g)
3786
+ // 画布对读屏是块空白:摘要和纯文本索引放在 sr-only 区里。
3787
+ // 画布自己保持 aria-hidden —— 在 aria-hidden 的节点上设 role/aria-label 是死代码,
3788
+ // 读屏根本不会念(早先这里就有这么一段,念不到还容易让人以为已经做了无障碍)。
3789
+ renderA11yIndex(g)
3790
+ renderLegend(g)
3791
+ if (opts.filters) buildFilters(g)
3792
+ renderPageBar()
3793
+ // 某个来源读不动时,图上只是「这个工作区少了」——说一次,别让人以为记忆丢了。
3794
+ const badSources = (g.sources || []).filter((s) => s.error)
3795
+ if (badSources.length && !state.warnedSourceError) {
3796
+ state.warnedSourceError = true
3797
+ toast(T('有来源读不动:') + badSources.map((s) => s.key || s.title || '?').join(' / ') + T('(细节在「来源」里)'))
3798
+ }
3799
+ // 螺旋视图下换了图:时间轴的范围与「≤ 某天 · N 条」得跟着新数据走,
3800
+ // 否则重建后新写的记忆会被上一版的 timeCut 挡在外面,看着像「重建丢记忆」。
3801
+ if (state.modeKey === 'spiral' && state.space3d) syncTimeCut()
3802
+ // 一开始是空库、后来有数据了:那句「记忆库是空的」得自己收起来
3803
+ const emptyHint = $('#hint')
3804
+ if (emptyHint && emptyHint.dataset.empty === '1' && g.nodes && g.nodes.length) {
3805
+ emptyHint.classList.remove('show', 'empty')
3806
+ emptyHint.innerHTML = ''
3807
+ delete emptyHint.dataset.empty
3808
+ }
3809
+ // 手上这张是旧图(重启后读到的过期缓存,或后端正在后台重建):自己去等新图换上来。
3810
+ // 只在 reload() 里挂是不够的 —— 首屏走的是 pullGraph(),那条路根本不经过 reload。
3811
+ if (g.refreshing || g.stale) watchBackgroundRefresh()
3812
+ return g
3813
+ }
3814
+
3815
+ /**
3816
+ * 1.11.30:图在后台重建时,页面先把旧图用起来,隔一会儿自己来换。
3817
+ * 五万条库上一次重建要五秒多;以前这五秒里页面停在上一版的图上、也没有任何说明,
3818
+ * 看着像「点了没反应」。现在后端立刻返回旧图(带 refreshing 标记),这里负责盯到它建完。
3819
+ */
3820
+ let bgRefreshTimer = null
3821
+
3822
+ function watchBackgroundRefresh() {
3823
+ if (bgRefreshTimer) return
3824
+ const startedAt = Date.now()
3825
+ const tick = async () => {
3826
+ bgRefreshTimer = null
3827
+ // 超过三分钟还没建完就放弃:那时候要么后端出错了,要么页面早换过一轮图。
3828
+ if (!state.graph || Date.now() - startedAt > 180000) return
3829
+ let g = null
3830
+ try {
3831
+ g = await API.graph({})
3832
+ } catch {
3833
+ return
3834
+ }
3835
+ if (!g) return
3836
+ if (g.refreshing || g.stale) {
3837
+ bgRefreshTimer = setTimeout(tick, 900)
3838
+ return
3839
+ }
3840
+ const before = (state.graph.stats && state.graph.stats.nodes) || 0
3841
+ const next = applyGraph(g, { keepView: true, filters: true })
3842
+ const after = (next && next.stats && next.stats.nodes) || 0
3843
+ const diff = after - before
3844
+ toastBackground(T('星云已更新') + (diff ? ':' + (diff > 0 ? '+' : '') + diff + T(' 条记忆') : ''))
3845
+ }
3846
+ bgRefreshTimer = setTimeout(tick, 900)
3847
+ }
3848
+
3849
+ /** 重新拉一次图(force 时强制在后端重建)。屏蔽/恢复/手工连边之后都走这里。 */
3850
+ async function reload(force) {
3851
+ const graph = force ? await API.refresh() : await API.graph({ refresh: 1 })
3852
+ const g = applyGraph(graph, { keepView: true, filters: true })
3853
+ // 后端说明它正在后台重建:先把这张旧图留着,等新的建好再换上去。
3854
+ if (graph && graph.refreshing) watchBackgroundRefresh()
3855
+ return g
3856
+ }
3857
+
3858
+ /* ---------------- 分页:五万条也只先画一页 ---------------- */
3859
+ // 5 万条时整图 /graph 约 44MB,浏览器要等整包到齐才出第一帧。
3860
+ // 服务端 1.9.0 起默认只发第一页(20000),这里负责「还剩多少 → 再要一页 → 合进来」。
3861
+ let pageBusy = false
3862
+
3863
+ function pageBar() {
3864
+ let bar = $('#pagebar')
3865
+ if (bar) return bar
3866
+ bar = el('div', 'pagebar')
3867
+ bar.id = 'pagebar'
3868
+ bar.hidden = true
3869
+ // 读屏用户按「继续加载」时,画面只是多了几个点,必须有人声告诉他加载到哪了:
3870
+ // 状态文字做成 polite 的 live region,按钮用 aria-describedby 指向它。
3871
+ const txt = el('span', 'pbtxt')
3872
+ txt.id = 'pagebar-status'
3873
+ txt.setAttribute('role', 'status')
3874
+ txt.setAttribute('aria-live', 'polite')
3875
+ txt.setAttribute('aria-atomic', 'true')
3876
+ bar.appendChild(txt)
3877
+ const btn = el('button', 'pbbtn', T('继续加载'))
3878
+ btn.type = 'button'
3879
+ btn.setAttribute('aria-describedby', 'pagebar-status')
3880
+ btn.addEventListener('click', () => loadNextPage())
3881
+ bar.appendChild(btn)
3882
+ document.body.appendChild(bar)
3883
+ return bar
3884
+ }
3885
+
3886
+ function renderPageBar() {
3887
+ const page = state.page
3888
+ if (!page || !page.total) return
3889
+ const bar = pageBar()
3890
+ if (!page.next) {
3891
+ // 收起的瞬间也要说一声「加载完了」,否则读屏用户只听到按钮消失。
3892
+ const total = Number(page.total || 0)
3893
+ if (!bar.hidden && total > 0) toast(T('已经加载全部 {n} 条').replace('{n}', String(total)))
3894
+ bar.hidden = true
3895
+ return
3896
+ }
3897
+ bar.hidden = false
3898
+ const loaded = page.offset + page.limit
3899
+ const left = Math.max(0, page.total - loaded)
3900
+ const txt = bar.querySelector('.pbtxt')
3901
+ if (txt) {
3902
+ txt.textContent = T('分页:已加载 {n} / {total} 条,还有 {left} 条')
3903
+ .replace('{n}', String(loaded))
3904
+ .replace('{total}', String(page.total))
3905
+ .replace('{left}', String(left))
3906
+ }
3907
+ const btn = bar.querySelector('.pbbtn')
3908
+ if (btn) {
3909
+ btn.disabled = pageBusy
3910
+ btn.textContent = pageBusy ? T('加载中…') : T('继续加载')
3911
+ }
3912
+ bar.setAttribute('aria-busy', pageBusy ? 'true' : 'false')
3913
+ }
3914
+
3915
+ /**
3916
+ * 合并下一页。节点按 id 去重、边按 (a,b,type) 去重 ——
3917
+ * 服务端已经保证页与页之间不重复发边,这里再兜一层,防止重复点「继续加载」把图撑大。
3918
+ */
3919
+ function mergePage(next) {
3920
+ const g = state.graph
3921
+ if (!g || !next) return { added: 0, edges: 0 }
3922
+ const page = API.normalizeGraph(next)
3923
+ const seen = new Set(g.nodes.map((n) => n.id))
3924
+ const addNodes = []
3925
+ for (const n of page.nodes || []) {
3926
+ if (!n || seen.has(n.id)) continue
3927
+ seen.add(n.id)
3928
+ addNodes.push(n)
3929
+ }
3930
+ const keyOf = (e) => (e.a < e.b ? e.a + '|' + e.b : e.b + '|' + e.a) + '|' + (e.t || '')
3931
+ const have = new Set((g.edges || []).map(keyOf))
3932
+ const addEdges = []
3933
+ for (const e of page.edges || []) {
3934
+ const k = keyOf(e)
3935
+ if (have.has(k)) continue
3936
+ have.add(k)
3937
+ addEdges.push(e)
3938
+ }
3939
+ g.nodes = g.nodes.concat(addNodes)
3940
+ g.edges = g.edges.concat(addEdges)
3941
+ if (page.page) state.page = page.page
3942
+ for (const n of addNodes) state.nodeById.set(n.id, n)
3943
+ for (const e of addEdges) {
3944
+ state.degree.set(e.a, (state.degree.get(e.a) || 0) + 1)
3945
+ state.degree.set(e.b, (state.degree.get(e.b) || 0) + 1)
3946
+ }
3947
+ let appended = { added: 0, edges: 0 }
3948
+ if (state.stage && typeof state.stage.append === 'function') {
3949
+ appended = state.stage.append(addNodes, addEdges)
3950
+ } else if (state.stage && state.stage.load) {
3951
+ state.stage.load(g, true)
3952
+ }
3953
+ renderStats(g)
3954
+ renderA11yIndex(g)
3955
+ renderLegend(g)
3956
+ renderPageBar()
3957
+ return appended
3958
+ }
3959
+
3960
+ async function loadNextPage() {
3961
+ const page = state.page
3962
+ if (pageBusy || !page || !page.next) return
3963
+ pageBusy = true
3964
+ renderPageBar()
3965
+ try {
3966
+ const next = await fetchGraph({
3967
+ offset: page.next,
3968
+ limit: page.limit,
3969
+ sig: (state.graph && state.graph.sig) || '',
3970
+ })
3971
+ const got = mergePage(next)
3972
+ if (!got.added && !got.edges) toast(T('这一页没有新内容'))
3973
+ } catch (err) {
3974
+ if (err && err.status === 409) {
3975
+ // 图的签名变了:按排名切片会串页,所以整张重来而不是硬拼
3976
+ toast(T('星图刚更新过,已从第一页重新加载'))
3977
+ try {
3978
+ await pullGraph()
3979
+ } catch (e2) {
3980
+ toast(T('加载记忆库时出错'))
3981
+ }
3982
+ } else {
3983
+ toast(T('这一页没加载上:') + ((err && err.message) || err))
3984
+ }
3985
+ } finally {
3986
+ pageBusy = false
3987
+ renderPageBar()
3988
+ }
3989
+ }
3990
+
3991
+ // 自动化钩子:只有 ?debug=1 才挂出来,用来在真实浏览器里验证「分页合并 / 视口裁剪」,
3992
+ // 正常访问什么都不暴露(CSP 一样放行,因为它只是本页里的一个全局变量)。
3993
+ if (/[?&]debug=1(?:&|$)/.test(location.search)) {
3994
+ window.__nebulaDebug = { state, applyGraph, mergePage, loadNextPage, renderPageBar, renderSources, applyFilter, updateFilterHint, autoFillForFilter, maybeAutoFill, applyFilterToStage, visibleCount, showDetail, showPath, renderHits }
3995
+ }
3996
+
3997
+ // 快照没有后端,重建按钮留着只会骗人;示例里则点了也没意义。
3998
+ if (API.snapshot) {
3999
+ const rb = $('#btn-refresh')
4000
+ if (rb) rb.hidden = true
4001
+ }
4002
+
4003
+ $('#btn-refresh').onclick = async () => {
4004
+ if (API.demo) {
4005
+ toast(T('示例星系是只读的:先点顶部「退出示例」,再重建自己的库'))
4006
+ return
4007
+ }
4008
+ const btn = $('#btn-refresh')
4009
+ btn.disabled = true
4010
+ btn.classList.add('busy')
4011
+ btn.setAttribute('aria-busy', 'true')
4012
+ // 用户亲手点了一下,接下来这几秒的「结果」只该由这次点击来说。
4013
+ // 不这样的话,后台那轮(读盘恢复后按新签名重建)先完事、它的「星云已更新」
4014
+ // 会把点击的结果盖掉,人就以为自己的点击只是刷新了一下(1.11.33 修)。
4015
+ toastQuietUntil = Date.now() + 8000
4016
+ try {
4017
+ const graph = await reload(true)
4018
+ // buildMs 挂在图对象顶层(publicGraph),不在 stats 里——早先读到 undefined 就是这么来的
4019
+ const ms = graph.buildMs ?? graph.stats.buildMs ?? 0
4020
+ // 1.11.24:没重建也要说实话。以前这里一律写「已重建」,而磁盘上一个字节都没动、
4021
+ // 界面还白等了几秒,用户会以为自己的库真的变了。
4022
+ if (graph.why === 'unchanged') {
4023
+ toast(T('什么都没变,没重建:') + graph.stats.nodes + T(' 条记忆 · ') + (graph.refreshMs || 0) + 'ms')
4024
+ } else if (graph.why === 'joined') {
4025
+ toast(T('刚好有一轮重建在进行,已用它的结果'))
4026
+ } else {
4027
+ toast(T('已重建:') + graph.stats.edges + T(' 条连接 · ') + ms + 'ms')
4028
+ }
4029
+ if (state.selected) showDetail(state.selected)
4030
+ } catch (err) {
4031
+ toast(T('重建失败:') + err.message)
4032
+ } finally {
4033
+ btn.disabled = false
4034
+ btn.classList.remove('busy')
4035
+ btn.removeAttribute('aria-busy')
4036
+ }
4037
+ }
4038
+
4039
+ $('#btn-fit').onclick = () => state.stage.fit()
4040
+ const keysBtn = $('#btn-keys')
4041
+ if (keysBtn) keysBtn.onclick = (ev) => { ev.stopPropagation(); toggleKeys() }
4042
+
4043
+ // 窄屏(<=900px)左列会被 CSS 收起。不能让人因此丢掉筛选能力:
4044
+ // 顶栏「筛选」把它当抽屉叫出来,点别处或 Esc 再收回去。
4045
+ const leftBtn = $('#btn-left')
4046
+ const leftCol = $('#leftcol')
4047
+ if (leftBtn && leftCol) {
4048
+ leftBtn.onclick = (ev) => {
4049
+ ev.stopPropagation()
4050
+ const open = leftCol.classList.toggle('open')
4051
+ leftBtn.classList.toggle('on', open)
4052
+ // 抽屉每次从顶上看起,不要带着上次滚到一半的位置
4053
+ if (open) { const f = $('#filters'); if (f) f.scrollTop = 0 }
4054
+ }
4055
+ document.addEventListener('click', (ev) => {
4056
+ if (!leftCol.classList.contains('open')) return
4057
+ if (leftCol.contains(ev.target) || leftBtn.contains(ev.target)) return
4058
+ leftCol.classList.remove('open')
4059
+ leftBtn.classList.remove('on')
4060
+ })
4061
+ document.addEventListener('keydown', (ev) => {
4062
+ if (ev.key !== 'Escape') return
4063
+ if (!leftCol.classList.contains('open')) return
4064
+ leftCol.classList.remove('open')
4065
+ leftBtn.classList.remove('on')
4066
+ })
4067
+ }
4068
+
4069
+ const timeRange = $('#time-range')
4070
+ if (timeRange) timeRange.oninput = () => syncTimeCut()
4071
+ // 双击时间轴=回到「全部」,不用去找最右端
4072
+ const timeBar = $('#timebar')
4073
+ if (timeBar) {
4074
+ timeBar.addEventListener('dblclick', () => {
4075
+ const r = $('#time-range')
4076
+ if (r) r.value = '1000'
4077
+ syncTimeCut()
4078
+ })
4079
+ }
4080
+
4081
+ const exportBtn = $('#btn-export')
4082
+ const exportMenu = $('#export-menu')
4083
+ if (exportBtn && exportMenu) {
4084
+ const closeMenu = () => {
4085
+ exportMenu.hidden = true
4086
+ }
4087
+ exportBtn.onclick = (ev) => {
4088
+ ev.stopPropagation()
4089
+ exportMenu.hidden = !exportMenu.hidden
4090
+ }
4091
+ exportMenu.addEventListener('click', (ev) => {
4092
+ const hit = ev.target.closest('[data-export]')
4093
+ const act = hit && hit.dataset.export
4094
+ if (!act) return
4095
+ closeMenu()
4096
+ if (act === 'png') exportPNG()
4097
+ else if (act === 'html') exportShare()
4098
+ else if (act === 'html-ws') {
4099
+ const only = state.filter.ws && state.filter.ws.size === 1 ? [...state.filter.ws][0] : ''
4100
+ if (!only) toast(T('先在左栏「工作区」里只留一个,再导出这一片'))
4101
+ else exportShare({ ws: only })
4102
+ } else if (act === 'html-focus') {
4103
+ if (!state.selected) toast(T('先在图上点一个节点,再导出它周围 2 跳'))
4104
+ else exportShare({ focus: state.selected })
4105
+ } else exportSubgraph()
4106
+ })
4107
+ document.addEventListener('click', (ev) => {
4108
+ if (!exportMenu.hidden && !ev.target.closest('.menu-wrap')) closeMenu()
4109
+ })
4110
+ document.addEventListener('keydown', (ev) => {
4111
+ if (ev.key === 'Escape' && !exportMenu.hidden) closeMenu()
4112
+ })
4113
+ }
4114
+ $('#btn-cards').onclick = () => {
4115
+ if ($('#cards').hidden) openCards()
4116
+ else closeCards()
4117
+ }
4118
+ $('#cards-close').onclick = () => closeCards()
4119
+ const bBtn = $('#btn-boards')
4120
+ if (bBtn)
4121
+ bBtn.onclick = () => {
4122
+ if ($('#boards').hidden) openBoards(boardTab)
4123
+ else closeBoards()
4124
+ }
4125
+ const bClose = $('#boards-close')
4126
+ if (bClose) bClose.onclick = () => closeBoards()
4127
+ for (const b of document.querySelectorAll('#board-tabs .btab')) {
4128
+ b.onclick = () => {
4129
+ boardTab = b.dataset.tab
4130
+ for (const x of document.querySelectorAll('#board-tabs .btab')) x.classList.toggle('on', x === b)
4131
+ renderBoards()
4132
+ }
4133
+ }
4134
+ const lbClose = $('#lb-close')
4135
+ if (lbClose) lbClose.onclick = () => closeLine()
4136
+ const cmdInput = $('#cmdk-input')
4137
+ if (cmdInput) {
4138
+ cmdInput.addEventListener('input', () => {
4139
+ cmdkIndex = 0
4140
+ renderCmdk(cmdInput.value)
4141
+ })
4142
+ }
4143
+ $('#cmdk').addEventListener('click', (ev) => {
4144
+ if (ev.target === $('#cmdk')) closeCmdk()
4145
+ })
4146
+ const pbClose = $('#pb-close')
4147
+ if (pbClose) pbClose.onclick = () => closePath()
4148
+ // 星云(2D) → 星系(3D 力导向) → 时间(3D 螺旋) → 星云
4149
+ const MODE_ORDER = [
4150
+ { key: 'nebula', label: T('星云'), tip: T('平面星云:看清连接与证据') },
4151
+ { key: 'space', label: T('星系'), tip: T('三维力导向星系:结构由真实连接决定,重要度越高越贴核心') },
4152
+ { key: 'spiral', label: T('时间'), tip: T('时间螺旋:越新的记忆越靠中心,每个工作区一条旋臂') },
4153
+ ]
4154
+ function applyModeLabel() {
4155
+ const m = MODE_ORDER.find((x) => x.key === state.modeKey) || MODE_ORDER[0]
4156
+ const btn = $('#btn-mode')
4157
+ if (!btn) return
4158
+ btn.textContent = m.label
4159
+ btn.title = m.tip
4160
+ }
4161
+ state.modeKey = 'nebula'
4162
+ $('#btn-mode').onclick = () => {
4163
+ const i = MODE_ORDER.findIndex((x) => x.key === state.modeKey)
4164
+ const next = MODE_ORDER[(i + 1) % MODE_ORDER.length]
4165
+ applyMode(next.key)
4166
+ }
4167
+ applyModeLabel()
4168
+
4169
+ window.addEventListener('load', boot)
4170
+ })()
4171
+
4172
+ /* 拖动窗口大小时保持画面锐利 */