dsh-macro-memory 0.0.0-stage → 0.3.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 (130) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +457 -2
  3. package/cordis.patch.yml +6 -0
  4. package/lib/client.js +3623 -0
  5. package/lib/index.js +469 -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 +439 -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 +145 -0
  16. package/lib/macro/defs/remember.js +213 -0
  17. package/lib/macro/defs/search.js +661 -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/tokencost.js +90 -0
  33. package/lib/macro/tools.js +67 -0
  34. package/package.json +54 -4
  35. package/vendor/VENDOR.json +23 -0
  36. package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
  37. package/vendor/dsh-memory-nebula/LICENSE +21 -0
  38. package/vendor/dsh-memory-nebula/README.en.md +203 -0
  39. package/vendor/dsh-memory-nebula/README.md +253 -0
  40. package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
  41. package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
  42. package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
  43. package/vendor/dsh-memory-nebula/lib/client.js +105 -0
  44. package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
  45. package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
  46. package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +317 -0
  47. package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
  48. package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
  49. package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
  50. package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
  51. package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
  52. package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
  53. package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
  54. package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
  55. package/vendor/dsh-memory-nebula/lib/host/graph.js +1663 -0
  56. package/vendor/dsh-memory-nebula/lib/host/graphcache.js +282 -0
  57. package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
  58. package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
  59. package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
  60. package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
  61. package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
  62. package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
  63. package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
  64. package/vendor/dsh-memory-nebula/lib/host/recall.js +451 -0
  65. package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
  66. package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
  67. package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
  68. package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
  69. package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
  70. package/vendor/dsh-memory-nebula/lib/index.js +759 -0
  71. package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
  72. package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
  73. package/vendor/dsh-memory-nebula/lib/web/app.js +4159 -0
  74. package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
  75. package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
  76. package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
  77. package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
  78. package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
  79. package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
  80. package/vendor/dsh-memory-nebula/locale/en.json +7 -0
  81. package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
  82. package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
  83. package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
  84. package/vendor/dsh-memory-nebula/market/index.json +101 -0
  85. package/vendor/dsh-memory-nebula/package.json +87 -0
  86. package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
  87. package/vendor/meow-memory/LICENSE +21 -0
  88. package/vendor/meow-memory/README.en.md +192 -0
  89. package/vendor/meow-memory/README.md +174 -0
  90. package/vendor/meow-memory/README.pt-br.md +180 -0
  91. package/vendor/meow-memory/cordis.patch.yml +7 -0
  92. package/vendor/meow-memory/lib/client.js +3344 -0
  93. package/vendor/meow-memory/lib/client.js.map +7 -0
  94. package/vendor/meow-memory/lib/index.js +9567 -0
  95. package/vendor/meow-memory/lib/index.js.map +7 -0
  96. package/vendor/meow-memory/lib/prompts/README.md +65 -0
  97. package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
  98. package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
  99. package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
  100. package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
  101. package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
  102. package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
  103. package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
  104. package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
  105. package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
  106. package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
  107. package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
  108. package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
  109. package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
  110. package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
  111. package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
  112. package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
  113. package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
  114. package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
  115. package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
  116. package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
  117. package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
  118. package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
  119. package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
  120. package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
  121. package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
  122. package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
  123. package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
  124. package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
  125. package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
  126. package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
  127. package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
  128. package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
  129. package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
  130. package/vendor/meow-memory/package.json +64 -0
@@ -0,0 +1,426 @@
1
+ /* 宏记忆 · 星图 —— API 客户端
2
+ *
3
+ * 默认打宿主自己的 /api/memory-nebula(同源)。
4
+ * 宿主进程如果还跑着旧代码(/ping 里没有 build 指纹),页面会自动切到
5
+ * 本机的独立引擎 http://127.0.0.1:7890 —— 这样不用重启 DSH 也能用最新算法。
6
+ */
7
+ ;(function () {
8
+ // 口令只用于第一次换取 cookie;换完就从地址栏/历史里拿掉,避免截图或 shell 历史泄露。
9
+ try {
10
+ const here = new URL(location.href)
11
+ if (here.searchParams.has('token')) {
12
+ here.searchParams.delete('token')
13
+ history.replaceState(null, '', here.pathname + (here.search ? here.search : '') + here.hash)
14
+ }
15
+ } catch {}
16
+ 'use strict'
17
+ /** 中文即源文:英文模式查 i18n.js 的表,查不到就原样返回中文。 */
18
+ const T = (zh, vars) => (window.NebulaI18n ? window.NebulaI18n.t(zh, vars) : zh)
19
+ const DEFAULT_BASE = '/api/memory-nebula'
20
+ const FALLBACK_BASE = 'http://127.0.0.1:7890'
21
+ let BASE = DEFAULT_BASE
22
+ /** 选中的那条腿的 /ping 元信息(版本、构建、能力清单、模式)。 */
23
+ let META = null
24
+
25
+ // 离线快照:导出的单个 HTML 会先把数据塞进 window.__NEBULA_SNAPSHOT__。
26
+ // 一旦有它,客户端就不再发网络请求 —— 双击文件也能看、搜索、点开节点。
27
+ const SNAP = typeof window !== 'undefined' ? window.__NEBULA_SNAPSHOT__ : null
28
+ const IS_SNAPSHOT = Boolean(SNAP && SNAP.graph && Array.isArray(SNAP.graph.nodes))
29
+
30
+ // 示例星系:数据在服务器内存里(不读盘、不写盘),每个请求带 demo=1。
31
+ let DEMO = false
32
+
33
+ // 允许 ?api=http://127.0.0.1:7890 手动指定
34
+ const forced = new URL(location.href).searchParams.get('api')
35
+ if (forced) BASE = forced.replace(/\/$/, '')
36
+
37
+ function url(path, params) {
38
+ const u = /^https?:/.test(BASE)
39
+ ? new URL(BASE + path)
40
+ : new URL(BASE + path, location.origin)
41
+ if (params) {
42
+ for (const [k, v] of Object.entries(params)) {
43
+ if (v !== undefined && v !== null && v !== '') u.searchParams.set(k, v)
44
+ }
45
+ }
46
+ return u
47
+ }
48
+
49
+ // 请求不能无限等:宿主卡住、引擎半死时,人至少能看到「超时」而不是一直转。
50
+ // 12s 也是首屏失败的判据——超过它就算这一路不通,交给失败态与换腿。
51
+ const TIMEOUT_MS = 12000
52
+
53
+ // 重建星图是唯一一个「本来就该慢」的接口:5 万条全量建图 6–8 秒,
54
+ // 首屏那次自己也在建图时(并发 join)叠起来会超过 12 秒——那不是失败,
55
+ // 报「重建失败:请求超时」是界面在说假话。给它 60 秒。
56
+ const REFRESH_TIMEOUT_MS = 60000
57
+
58
+ async function request(u, init, timeoutMs = TIMEOUT_MS) {
59
+ const ctl = new AbortController()
60
+ const timer = setTimeout(() => ctl.abort(), timeoutMs)
61
+ try {
62
+ const res = await fetch(u, Object.assign({ signal: ctl.signal }, init))
63
+ if (!res.ok) {
64
+ // 带上状态码:分页时 409 表示「图变了,从第一页重来」,跟普通失败不是一回事
65
+ const err = new Error('HTTP ' + res.status + ' ' + u.pathname)
66
+ err.status = res.status
67
+ throw err
68
+ }
69
+ return await res.json()
70
+ } catch (err) {
71
+ if (err && (err.name === 'AbortError' || err.code === 20)) {
72
+ throw new Error(T('请求超时(') + timeoutMs / 1000 + 's):' + u.pathname)
73
+ }
74
+ throw err
75
+ } finally {
76
+ clearTimeout(timer)
77
+ }
78
+ }
79
+
80
+ function get(path, params) {
81
+ return request(url(path, params), { headers: { accept: 'application/json' } })
82
+ }
83
+
84
+ function post(path, body, timeoutMs) {
85
+ return request(
86
+ url(path),
87
+ {
88
+ method: 'POST',
89
+ headers: { 'content-type': 'application/json' },
90
+ body: JSON.stringify(body || {}),
91
+ },
92
+ timeoutMs,
93
+ )
94
+ }
95
+
96
+ /** 探测两条腿的构建时间,取代码更新的那一条(宿主没重启就自动用独立引擎)。 */
97
+ async function resolveBase() {
98
+ if (IS_SNAPSHOT) {
99
+ META = snapPing()
100
+ return BASE
101
+ }
102
+ const probe = async (base) => {
103
+ try {
104
+ const ctl = new AbortController()
105
+ const timer = setTimeout(() => ctl.abort(), 3000)
106
+ let res
107
+ try {
108
+ res = await fetch(base + '/ping', { headers: { accept: 'application/json' }, signal: ctl.signal })
109
+ } finally {
110
+ clearTimeout(timer)
111
+ }
112
+ if (!res.ok) return null
113
+ const meta = await res.json()
114
+ if (!meta || typeof meta.build !== 'number') return null
115
+ return { base, build: meta.build, meta }
116
+ } catch {
117
+ return null
118
+ }
119
+ }
120
+ if (forced) {
121
+ META = (await probe(BASE))?.meta || null
122
+ return BASE
123
+ }
124
+ // 独立引擎自己的页面:同源已是 standalone,没必要再去敲宿主 7890 的门(浏览器会在控制台记一条连接失败)。
125
+ const host = await probe(DEFAULT_BASE)
126
+ if (host && host.meta.mode === 'standalone') {
127
+ BASE = DEFAULT_BASE
128
+ META = host.meta
129
+ return BASE
130
+ }
131
+ const side = await probe(FALLBACK_BASE)
132
+ // 两边都能用就选新的:宿主往往还跑着安装那一刻加载的旧代码
133
+ let picked
134
+ if (host && side) picked = side.build > host.build ? side : host
135
+ else picked = host || side || null
136
+ BASE = picked ? picked.base : DEFAULT_BASE
137
+ META = picked ? picked.meta : null
138
+ return BASE
139
+ }
140
+
141
+ // v2 的图用「节点下标」传边(省 600KB+),这里还原成 id,下游代码完全不用改。
142
+ // 幂等:已经展开过的边原样返回,所以可以放心在多层重复调用。
143
+ // 1.9.0 起分页会让同一批边混着两种编码(页内 s/d、跨页 a/b),所以逐条判断,
144
+ // 不能再「看第一条决定整批」——那样跨页边会永远展开不了。
145
+ function normalizeGraph(g) {
146
+ if (!g || !Array.isArray(g.nodes) || !Array.isArray(g.edges) || !g.edges.length) return g
147
+ const ids = g.nodes.map((n) => n.id)
148
+ g.edges = g.edges.map((e) => {
149
+ if (typeof e.s !== 'number' || typeof e.d !== 'number') return e
150
+ return { a: ids[e.s], b: ids[e.d], w: e.w, t: e.t, curated: e.curated, why: e.why }
151
+ })
152
+ return g
153
+ }
154
+
155
+ /** 示例模式下所有请求都带 demo=1;快照模式没有请求,原样返回。 */
156
+ function modeParams(params) {
157
+ if (!DEMO || IS_SNAPSHOT) return params
158
+ return Object.assign({ demo: 1 }, params)
159
+ }
160
+
161
+ /** 快照里没有写接口:明确报一句人话,调用方会把它当普通错误提示出来。 */
162
+ function snapshotNo(what) {
163
+ if (!IS_SNAPSHOT) return false
164
+ throw new Error(T('这是一份离线快照,「') + what + T('」不可用;回到 DSH 里打开实时星图即可'))
165
+ }
166
+
167
+ /* ---------------- 离线快照的本地引擎 ---------------- */
168
+ // 大快照的节点与边按列存(省掉重复键名),这里展开成对象。
169
+ function expandSnapshotNodes(g) {
170
+ if (!g || !Array.isArray(g.nodeColumns) || !Array.isArray(g.nodes) || !g.nodes.length) return g
171
+ if (!Array.isArray(g.nodes[0])) return g
172
+ const cols = g.nodeColumns
173
+ g.nodes = g.nodes.map((row) => {
174
+ const node = {}
175
+ for (let i = 0; i < cols.length; i++) if (row[i] !== null) node[cols[i]] = row[i]
176
+ return node
177
+ })
178
+ delete g.nodeColumns
179
+ return g
180
+ }
181
+
182
+ function expandSnapshotEdges(g) {
183
+ if (!g || !Array.isArray(g.edgeColumns) || !Array.isArray(g.edges) || !g.edges.length) return g
184
+ if (!Array.isArray(g.edges[0])) return g
185
+ const cols = g.edgeColumns
186
+ g.edges = g.edges.map((row) => {
187
+ const e = {}
188
+ for (let i = 0; i < cols.length; i++) if (row[i] !== null) e[cols[i]] = row[i]
189
+ return e
190
+ })
191
+ delete g.edgeColumns
192
+ return g
193
+ }
194
+
195
+ let snapCache = null
196
+ function snapData() {
197
+ if (snapCache) return snapCache
198
+ const graph = normalizeGraph(expandSnapshotEdges(expandSnapshotNodes(SNAP.graph)))
199
+ const byId = new Map(graph.nodes.map((n) => [n.id, n]))
200
+ const adj = new Map()
201
+ for (const e of graph.edges || []) {
202
+ if (!e || e.a == null || e.b == null) continue
203
+ if (!byId.has(e.a) || !byId.has(e.b)) continue
204
+ let la = adj.get(e.a)
205
+ if (!la) adj.set(e.a, (la = []))
206
+ la.push({ e, other: byId.get(e.b) })
207
+ let lb = adj.get(e.b)
208
+ if (!lb) adj.set(e.b, (lb = []))
209
+ lb.push({ e, other: byId.get(e.a) })
210
+ }
211
+ snapCache = { graph, byId, adj }
212
+ return snapCache
213
+ }
214
+
215
+ function snapPing() {
216
+ const g = SNAP.graph
217
+ return {
218
+ ok: true,
219
+ snapshot: true,
220
+ version: SNAP.version || 'snapshot',
221
+ build: SNAP.build || 0,
222
+ startedAt: SNAP.builtAt || 0,
223
+ mode: 'snapshot',
224
+ capabilities: [],
225
+ sig: SNAP.sig || 'snapshot',
226
+ builtAt: SNAP.builtAt || g.builtAt || 0,
227
+ stats: g.stats || {},
228
+ buildMs: g.buildMs || 0,
229
+ error: '',
230
+ }
231
+ }
232
+
233
+ function snapNode(id) {
234
+ const { byId, adj } = snapData()
235
+ const node = byId.get(id)
236
+ if (!node) return null
237
+ const list = (adj.get(id) || []).slice().sort((x, y) => (y.e.w || 0) - (x.e.w || 0))
238
+ const neighbors = list.map(({ e, other }) => ({
239
+ id: other.id,
240
+ label: other.label || other.title,
241
+ ws: other.wsTitle || other.ws,
242
+ level: other.level,
243
+ importance: other.importance,
244
+ type: e.t,
245
+ weight: e.w,
246
+ why: Array.isArray(e.why) ? e.why : e.why ? [String(e.why)] : [],
247
+ }))
248
+ return { node, neighbors, degree: neighbors.length, cluster: node.cluster != null ? node.cluster : null }
249
+ }
250
+
251
+ function snapRecall(query, opts) {
252
+ const { graph } = snapData()
253
+ const q = String(query || '').trim()
254
+ const limit = Math.max(1, Math.min(50, Number(opts && opts.limit) || 12))
255
+ if (!q) return { query: '', seeds: [], unknown: [], hits: [], scanned: graph.nodes.length }
256
+ const terms = q
257
+ .toLowerCase()
258
+ .split(/[\s,,。;;、·|/]+/)
259
+ .filter((t) => t.length >= 2)
260
+ .slice(0, 6)
261
+ const needle = q.toLowerCase()
262
+ const hits = []
263
+ for (const n of graph.nodes) {
264
+ const title = String(n.title || n.label || '').toLowerCase()
265
+ const content = String(n.content || n.preview || '').toLowerCase()
266
+ const kws = (n.keywords || []).map((k) => String(k).toLowerCase())
267
+ let score = 0
268
+ const why = []
269
+ if (title.includes(needle)) {
270
+ score += 5
271
+ why.push(T('标题命中'))
272
+ }
273
+ for (const t of terms) {
274
+ if (kws.some((k) => k === t || k.includes(t))) {
275
+ score += 2.5
276
+ why.push(T('关键词「') + t + '」')
277
+ } else if (title.includes(t)) {
278
+ score += 2
279
+ why.push(T('标题含「') + t + '」')
280
+ }
281
+ if (content.includes(t)) score += 0.8
282
+ }
283
+ if (score <= 0) continue
284
+ hits.push({
285
+ id: n.id,
286
+ uid: String(n.id).split(':').pop(),
287
+ ws: n.wsTitle || n.ws,
288
+ level: n.level,
289
+ label: n.label,
290
+ title: n.title,
291
+ preview: String(n.preview || n.content || '').slice(0, 220),
292
+ importance: n.importance,
293
+ project: n.project,
294
+ status: n.status,
295
+ keywords: (n.keywords || []).slice(0, 8),
296
+ score: Math.round(Math.min(1, score / 8) * 1000) / 1000,
297
+ direct: 1,
298
+ spread: 0,
299
+ why: why.slice(0, 2).join(' · ') || T('内容命中'),
300
+ across: false,
301
+ chain: [],
302
+ })
303
+ }
304
+ hits.sort((a, b) => b.score - a.score)
305
+ return { query: q, seeds: [], unknown: [], hits: hits.slice(0, limit), scanned: graph.nodes.length }
306
+ }
307
+
308
+ function snapPath(a, b, hops) {
309
+ const { graph, byId, adj } = snapData()
310
+ const maxHops = Math.max(1, Math.min(8, Number(hops) || 6))
311
+ if (!byId.has(a) || !byId.has(b)) return { found: false, error: T('找不到这两个节点:') + a + ' / ' + b }
312
+ const dist = new Map([[a, 0]])
313
+ const prev = new Map()
314
+ const queue = [a]
315
+ for (let head = 0; head < queue.length; head++) {
316
+ const cur = queue[head]
317
+ if (cur === b) break
318
+ const d = dist.get(cur)
319
+ if (d >= maxHops) continue
320
+ for (const { e, other } of adj.get(cur) || []) {
321
+ if (dist.has(other.id)) continue
322
+ dist.set(other.id, d + 1)
323
+ prev.set(other.id, { from: cur, e })
324
+ queue.push(other.id)
325
+ }
326
+ }
327
+ if (!dist.has(b)) return { found: false, hops: 0, score: 0 }
328
+ const ids = [b]
329
+ const edges = []
330
+ let cur = b
331
+ while (cur !== a) {
332
+ const p = prev.get(cur)
333
+ if (!p) return { found: false, hops: 0, score: 0 }
334
+ edges.push({
335
+ a: p.from,
336
+ b: cur,
337
+ w: p.e.w,
338
+ t: p.e.t,
339
+ why: Array.isArray(p.e.why) ? p.e.why.join(' · ') : p.e.why || '',
340
+ })
341
+ cur = p.from
342
+ ids.push(cur)
343
+ }
344
+ ids.reverse()
345
+ edges.reverse()
346
+ const score = edges.reduce((acc, e) => acc * (e.w || 1), 1)
347
+ const field = (n) => ({ id: n.id, label: n.label || n.title, level: n.level, ws: n.wsTitle || n.ws, importance: n.importance, kind: n.kind })
348
+ return {
349
+ found: true,
350
+ hops: edges.length,
351
+ score: Math.round(score * 1000) / 1000,
352
+ nodes: ids.map((id) => field(byId.get(id))),
353
+ edges,
354
+ }
355
+ }
356
+
357
+ function snapOverview() {
358
+ if (SNAP.overview) return SNAP.overview
359
+ const g = SNAP.graph
360
+ return { stats: g.stats || {}, workspaces: [], inventory: SNAP.inventory || {}, hygiene: null }
361
+ }
362
+
363
+ window.NebulaAPI = {
364
+ get base() {
365
+ return BASE
366
+ },
367
+ /** 当前 base 的版本/构建/能力清单;没探测过就是 null。 */
368
+ get meta() {
369
+ return META
370
+ },
371
+ /** 这个页面是不是一份离线快照(没有后端,全部靠内嵌数据)。 */
372
+ get snapshot() {
373
+ return IS_SNAPSHOT
374
+ },
375
+ /** 现在看的是不是示例星系。 */
376
+ get demo() {
377
+ return DEMO
378
+ },
379
+ /** 进 / 出示例星系。返回切换后的状态。 */
380
+ setDemo(on) {
381
+ DEMO = Boolean(on)
382
+ return DEMO
383
+ },
384
+ resolveBase,
385
+ /** 图的形状收口:所有拿到整图的地方都过它(幂等,重复调用无害)。 */
386
+ normalizeGraph,
387
+ /** 当前 base 挂了就试着换一条腿(宿主 ↔ 独立引擎)。变了返回 true。 */
388
+ async failover() {
389
+ if (forced || IS_SNAPSHOT) return false
390
+ const other = BASE === FALLBACK_BASE ? DEFAULT_BASE : FALLBACK_BASE
391
+ try {
392
+ const res = await fetch(other + '/ping', { headers: { accept: 'application/json' } })
393
+ if (!res.ok) return false
394
+ const meta = await res.json()
395
+ if (!meta || typeof meta.build !== 'number') return false
396
+ BASE = other
397
+ META = meta
398
+ return true
399
+ } catch {
400
+ return false
401
+ }
402
+ },
403
+ graph: (opts) =>
404
+ IS_SNAPSHOT
405
+ ? Promise.resolve(snapData().graph)
406
+ : get('/graph', modeParams(opts)).then(normalizeGraph),
407
+ ping: () => (IS_SNAPSHOT ? Promise.resolve(snapPing()) : get('/ping', modeParams())),
408
+ node: (id) => (IS_SNAPSHOT ? Promise.resolve(snapNode(id)) : get('/node', modeParams({ id }))),
409
+ recall: (q, opts) => (IS_SNAPSHOT ? Promise.resolve(snapRecall(q, opts)) : get('/recall', modeParams(Object.assign({ q }, opts)))),
410
+ path: (a, b, hops) => (IS_SNAPSHOT ? Promise.resolve(snapPath(a, b, hops)) : get('/path', modeParams({ a, b, hops }))),
411
+ overview: () => (IS_SNAPSHOT ? Promise.resolve(snapOverview()) : get('/overview', modeParams())),
412
+ // 建图进度:快照/演示里没有后台建图这件事,直接给空。
413
+ progress: () => (IS_SNAPSHOT ? Promise.resolve(null) : get('/progress')),
414
+ // 记忆体检:图上最贵的一步(20 万条要十几秒)。概览先回来,这一份算完再补上。
415
+ hygiene: () => (IS_SNAPSHOT ? Promise.resolve(null) : get('/hygiene')),
416
+ mutes: () => (IS_SNAPSHOT ? Promise.resolve({ mutes: [] }) : get('/mutes', modeParams())),
417
+ link: (a, b, note) => snapshotNo(T('连线')) || post('/link', { a, b, note }),
418
+ unlink: (a, b) => snapshotNo(T('断线')) || post('/unlink', { a, b }),
419
+ mute: (a, b, note) => snapshotNo(T('屏蔽')) || post('/mute', { a, b, note }),
420
+ unmute: (a, b) => snapshotNo(T('解除屏蔽')) || post('/unmute', { a, b }),
421
+ // 重建也返回整张图,必须走同一条展开路径——否则 v2 的 {s,d} 下标边会原样流到渲染层,
422
+ // 下游按 e.a/e.b 找节点全部落空,表现就是「点重建后连线全没了」(真实踩过的坑)。
423
+ refresh: () =>
424
+ snapshotNo(T('重建')) || post('/refresh', {}, REFRESH_TIMEOUT_MS).then(normalizeGraph),
425
+ }
426
+ })()