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,439 @@
1
+ import { TEXT_OUT, pick } from '../shared.js'
2
+ import { NOT_READY_MARK } from '../contract.js'
3
+ import { brandText } from '../brand.js'
4
+ import { GUIDE_TEXT, buildFullGuide, NAV_TEXT, clampGuide, guideBudget } from '../prompt.js'
5
+ import { readCost } from '../cost.js'
6
+ import { readDreamPanel, workspaceOfExec } from '../dreamledger.js'
7
+ import { describeMs, pendingReport } from '../links.js'
8
+ import { cardTitle, limitOf, panelText } from '../panel.js'
9
+
10
+ // 动作表:一行一个面板(0.2.22)。
11
+ // 这张表同时是三样东西的唯一出处:参数的 action 枚举、execute 里的分发、以及
12
+ // 「这个动作到底要不要外部服务」。以前它是一条 if/else 链 + 一份手写枚举,
13
+ // 两处各改各的,最容易出的坏法是「枚举里列了、一调就掉进未知 action」——
14
+ // 模型照着 schema 选,选到就报错,而自检全绿(枚举没人核对)。
15
+ //
16
+ // 每行只能有一种实现:
17
+ // kind: 'call' —— meow 自己的工具,必须成功;失败=这个面板没有意义
18
+ // kind: 'graph' —— 星图侧的工具,缺席时降级说明,不许把内部错误甩给模型
19
+ // kind: 'local' —— 本地计算(成本账本 / 待补队列 / 手册),不碰外部服务
20
+ // params 只列这个动作真正读的参数,其余参数一概不往子工具里传。
21
+ // [macro-fusion 0.2.68] 但「不往下传」不等于「可以不说话」:schema 八个参数对每个
22
+ // action 都合法,用户给 cost 配个 kind 时,那个 kind 就这样消失了。所以下面另有一张
23
+ // PARAM_OWNERS 反查表 + strayNote(),把「这个面板不读的那几个」在抬头里点出来。
24
+ //
25
+ // 0.2.25 起每行还带三样「口径」:label(面板的中文名,抬头与卡片标题都用它)、
26
+ // hint(工具描述里那一句)、defaultLimit(条数上限的默认值)。名字只写这一遍。
27
+ export const ACTIONS = {
28
+ home: { kind: 'call', label: '记忆库位置', hint: '记忆库位置/切换', call: 'memory_home', params: ['target'] },
29
+ stats: { kind: 'graph', label: '星图概况', hint: '星图概况', graph: 'nebula_stats', params: ['hubs'], what: '星图概况', miss: '星图概况这会儿看不了' },
30
+ hygiene: { kind: 'graph', label: '记忆体检', hint: '记忆体检(重复/该更新/关系凑数/超重/没人读/孤立)', graph: 'nebula_hygiene', params: ['kind', 'limit'], what: '记忆体检', miss: '记忆体检这会儿做不了', guard: guardHygiene },
31
+ sources: { kind: 'graph', label: '记忆来源', hint: '记忆来源', graph: 'nebula_sources', params: ['verbose'], what: '记忆来源', miss: '记忆来源这会儿看不了' },
32
+ ingest: { kind: 'graph', label: '外部记忆推入', hint: '推入外部记忆', graph: 'nebula_ingest', params: ['provider', 'items'], what: '外部记忆推入', miss: '这批外部记忆一条都没推进去', guard: guardIngest },
33
+ cost: { kind: 'local', label: '成本账本', hint: '成本账本', params: ['limit'], defaultLimit: 200 },
34
+ // [macro-fusion 0.2.97] dream 的账本原来只有写口(dream_log),没有读口:整理完看到几条、
35
+ // 点出几对、缺几个词,全躺在 sqlite 里。这一行把它摆上面板——数字念的是账本,不是现算。
36
+ dream: {
37
+ kind: 'local',
38
+ label: '整理留痕',
39
+ hint: '最近几次整理看到几条、点出几对、缺几个词(可按项目筛/引用回指)',
40
+ params: ['limit', 'page', 'id', 'project'],
41
+ defaultLimit: 5,
42
+ },
43
+ links: { kind: 'local', label: '待补连线', hint: '待补连线队列(写记忆时没连上的连线,读记忆时会自动补)', params: ['limit'], defaultLimit: 20 },
44
+ // wrap: false —— 全表唯一豁免:手册是长文,没有「条数/时间窗」这种口径可报,
45
+ // 而且要让它第一行就是门牌(「宏记忆有三个面」),多加一行抬头反而把它埋了。
46
+ guide: { kind: 'local', label: '完整手册', hint: '完整手册全文(含星图规则)', params: [], wrap: false },
47
+ }
48
+
49
+ /** 工具描述:面板清单由表生成,少写一遍就少一处能漂的地方。 */
50
+ export const PANEL_SUMMARY =
51
+ '宏记忆的运维面板:' + Object.entries(ACTIONS).map(([action, spec]) => `${action} ${spec.hint}`).join(';') + '。'
52
+
53
+ /**
54
+ * [macro-fusion 0.2.68] 参数归属反查表:一个参数名 → 哪些 action 真的读它。
55
+ *
56
+ * 这张表和 ACTIONS 是同一份数据算出来的,不是又抄一遍。它存在的理由只有一句:
57
+ * 面板收到不认识的参数时,能顺手告诉用户「这个参数是谁的」,而不是只丢一句「没用上」。
58
+ */
59
+ export const PARAM_OWNERS = (() => {
60
+ const map = new Map()
61
+ for (const [action, spec] of Object.entries(ACTIONS)) {
62
+ for (const name of spec.params ?? []) {
63
+ if (!map.has(name)) map.set(name, [])
64
+ map.get(name).push(action)
65
+ }
66
+ }
67
+ return map
68
+ })()
69
+
70
+ /**
71
+ * [macro-fusion 0.2.68] 「这个面板不读的那几个参数」要说出来。
72
+ *
73
+ * 八个参数(target / limit / kind / hubs / verbose / provider / items)在 schema 上对
74
+ * 每个 action 都合法,执行时却只取 spec.params 里列的那几个——以前剩下的就这么没了:
75
+ * 用户给 `action='cost'` 配 `kind='dup'`,看到一份完整账本,会读成「按 dup 筛过的账本」;
76
+ * 给 `action='stats'` 配 `limit=5`,看到十个枢纽,会读成「这五个就是全部」。
77
+ * 面板本身没算错,错的是它一个字都没提这事。
78
+ *
79
+ * 所以这里返回一句抬头尾注:点名每个没被读的参数、它归谁管,并明确「这次一点没参与」。
80
+ * 只报用户真的给了的(undefined 不算),一个都不给时返回空串——正常调用一个字都不多。
81
+ */
82
+ export function strayNote(action, spec, args) {
83
+ const own = spec?.params ?? []
84
+ const stray = Object.keys(Object.fromEntries(PARAM_OWNERS)).filter(
85
+ (name) => !own.includes(name) && args?.[name] !== undefined,
86
+ )
87
+ if (stray.length === 0) return ''
88
+ const parts = stray.map((name) => `${name} 是 ${(PARAM_OWNERS.get(name) ?? []).join(' / ')} 的`)
89
+ const it = stray.length > 1 ? '它们' : '它'
90
+ return `${parts.join(';')}——${action} 不读${it},这次一点没参与(别读成「结果已经按${it}收窄过」)。`
91
+ }
92
+ /**
93
+ * [macro-fusion 0.2.70] 卡片细节:把这一轮**真给了**的参数写成 `k=v`。
94
+ *
95
+ * 卡片标题的细节位从 0.2.60 起就有(`cardTitle(label, detail)`),七个工具都在用:
96
+ * `检索记忆:本地检索 · 部署`、`读取记忆:0m1abc`。只有运维面板一直空着——
97
+ * `action='hygiene'` 和 `action='hygiene', kind='dup', limit=5` 的卡片一字不差,
98
+ * 两轮并排放在会话里,用户分不清哪张是只看重复、哪张是全量体检。
99
+ *
100
+ * 三条约定:
101
+ * 1. 只列用户真给了的(`undefined` / `null` / 空串不算),没给就返回空串,不留悬空冒号。
102
+ * 2. 顺序按 PARAM_OWNERS 的键序(那张表由 ACTIONS 算出来,不是又抄一份)。
103
+ * 3. 数组说条数(`items=3 条`),不许把 `[object Object]` 贴上卡片。
104
+ * 描述的是**输入**而不是执行:stray 参数也照列,面板抬头那句会说明它没参与。
105
+ */
106
+ export function cardDetail(args) {
107
+ const parts = []
108
+ for (const name of PARAM_OWNERS.keys()) {
109
+ const v = args?.[name]
110
+ if (v === undefined || v === null || v === '') continue
111
+ if (Array.isArray(v)) {
112
+ parts.push(`${name}=${v.length} 条`)
113
+ continue
114
+ }
115
+ if (typeof v === 'object') {
116
+ parts.push(`${name}=${JSON.stringify(v)}`)
117
+ continue
118
+ }
119
+ parts.push(`${name}=${String(v)}`)
120
+ }
121
+ return parts.join(' ')
122
+ }
123
+
124
+
125
+ // nebula_ingest 原本 provider/items 都是必填;合并进 action 枚举后 schema 收不住,
126
+ // 只能在运行时守(守不住的话星图那边只会回一句听不懂的报错)
127
+ function guardIngest(args) {
128
+ if (typeof args.provider !== 'string' || args.provider.trim().length === 0) {
129
+ throw new Error('memory_admin:action="ingest" 需要 provider(来源名,例如 hindsight / openviking)。')
130
+ }
131
+ if (!Array.isArray(args.items) || args.items.length === 0) {
132
+ throw new Error('memory_admin:action="ingest" 需要 items(记忆条目数组,每条至少给 title 或 content)。')
133
+ }
134
+ }
135
+
136
+ /**
137
+ * [macro-fusion 0.2.64] 体检的类别是枚举,给错不许「照跑一遍全部再挑一类空结果」。
138
+ *
139
+ * 星图那边收到不认识的 kind 不会报错:它按 key 去取条目,取不到就是空数组,
140
+ * 于是回执里那一行会变成「(0)」——而抬头还写着「共 N 项」。用户要查「孤立」,
141
+ * 看到的是「共 12 项 + 一行 0」,会读成「孤立这一类是 0 条」,真实是「这一类根本没查」。
142
+ * 所以在入口按白名单校验并归一(大小写、前后空格),不认识的一次都不往下发。
143
+ */
144
+ const HYGIENE_KINDS = ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan']
145
+
146
+ /**
147
+ * [macro-fusion 0.2.91] 体检里的「相似 N」和工具里的「逐字重复度」不是同一个量。
148
+ *
149
+ * 实测(同一条前言 + 两个不同核心,两条各 40 余字):
150
+ * 星图体检 → `疑似重复(1)…(相似 1)`;
151
+ * memory_search 的 similar → `相似度 0.624(逐字 0.42)`,写侧也没判重复。
152
+ * 两个数差 0.58,方向还是「面板说完全重复、工具说只有四成」,照着面板去归档就等于删掉一件
153
+ * 独立的事。原因不在谁算错了:星图为了能扫全库,用的是**稀有词签名**(每条约留最稀有的
154
+ * 24 个词,且只算在两条以上出现过的词),门槛 0.86;库里条数少时这个签名会退化成
155
+ * 「两边共有的词」,于是 Jaccard 顶到 1。工具侧的 repeat 是全文词集,跟写侧合并门槛同源。
156
+ *
157
+ * 所以这里不重算(融合层拿不到正文),只把两把尺子摆到抬头里:说清这个 N 是什么、
158
+ * 什么时候会顶格、要判「同一句存了两层」该看哪个数。
159
+ * 只在真列出了对子时说——没对子(0 条 / 星图缺席)时这句话就是噪音。
160
+ */
161
+ export function hygieneRulerNote(body, args) {
162
+ const asked = typeof args?.kind === 'string' ? args.kind.trim().toLowerCase() : ''
163
+ if (asked !== '' && asked !== 'dup') return ''
164
+ const text = String(body ?? '')
165
+ if (!text.includes('(相似 ')) return ''
166
+ return (
167
+ '这里的「相似 N」是星图的稀有词签名估算(每条约留最稀有的 24 个词,只算在两条以上出现过的词),' +
168
+ '跟 memory_search 报的「逐字重复度」不是同一把尺子——库里条数少的时候签名常顶到 1,' +
169
+ '而全文逐字可能只有四成。判「同一句存了两层」看 memory_search 的 repeat(≥0.80 写侧就判重复);' +
170
+ '判「两条在说同一件事」看这里。'
171
+ )
172
+ }
173
+
174
+ /**
175
+ * [macro-fusion 0.2.100] dream 面板的两个数字参数:page(第几页)、id(展开第几近)。
176
+ *
177
+ * 都不许静默退回默认——这是和 0.2.68 那条「不往下传不等于可以不说话」同一个理由:
178
+ * 用户写了 page=3 却看到第一页,会读成「账本只有这一页」;写了 id="abc" 却看到整本账,
179
+ * 会读成「展开失败但账本长这样」。所以脏值直接打回,并说清这次什么都没按你说的做。
180
+ * id 收 "#3" 和 "3" 两种写法:面板上印的就是 #k,人照着抄最省事。
181
+ */
182
+ function pageOf(raw) {
183
+ if (raw === undefined || raw === null || raw === '') return 1
184
+ const n = Math.trunc(Number(raw))
185
+ if (!Number.isFinite(n) || n < 1) {
186
+ throw new Error(
187
+ `memory_admin:action="dream" 的 page 只认从 1 起的整数(每页 limit 条),给的是「${String(raw)}」。\n` +
188
+ '要第一页就不传 page。这次没有列账——别把「没列」读成「账本里只有这几条」。',
189
+ )
190
+ }
191
+ return Math.min(100000, n)
192
+ }
193
+
194
+ function idOf(raw) {
195
+ if (raw === undefined || raw === null || raw === '') return 0
196
+ const text = String(raw).trim()
197
+ // [macro-fusion 0.2.104] 两种写法都认:r<N> 是账本引用(不挪),#k / k 是第几近(会挪)。
198
+ // 引用原样往下传(面板按 r 前缀分流),数字归一成整数——打回时把两种写法都写进错误里。
199
+ const byRef = /^[rR](\d{1,9})$/.exec(text)
200
+ if (byRef !== null) {
201
+ const n = Number(byRef[1])
202
+ if (Number.isFinite(n) && n > 0) return `r${n}`
203
+ throw new Error(
204
+ `memory_admin:action="dream" 的 id 引用要从 r1 起(r0 不存在),给的是「${String(raw)}」。\n` +
205
+ '这次没有展开任何一条——别把「没展开」读成「这条账不存在」。',
206
+ )
207
+ }
208
+ const n = Math.trunc(Number(text.replace(/^#/, '')))
209
+ if (!Number.isFinite(n) || n < 1) {
210
+ throw new Error(
211
+ `memory_admin:action="dream" 的 id 只认两种写法:「3」/「#3」这种「第几近」编号(1 = 最新,和列表里的 #k 一致),` +
212
+ `或「r128」这种账本引用(每行末尾那个号,新账来了也不挪),给的是「${String(raw)}」。\n` +
213
+ '这次没有展开任何一条——别把「没展开」读成「这条账不存在」。',
214
+ )
215
+ }
216
+ return Math.min(1000000, n)
217
+ }
218
+
219
+ /**
220
+ * [macro-fusion 0.2.101] 项目名:按 changes.plan.projects 里的原样筛,不去大小写、不做模糊匹配。
221
+ * 名字给成长句/带换行,多半是把整段话当项目名塞进来了——当面打回,别把它当「没匹配到」。
222
+ */
223
+ function projectOf(raw) {
224
+ if (raw === undefined || raw === null) return ''
225
+ const text = String(raw).trim()
226
+ if (text === '') return ''
227
+ if (/[\r\n]/.test(text) || text.length > 80) {
228
+ throw new Error(
229
+ `memory_admin:action="dream" 的 project 只认一个项目段的名字(原样写在 changes.plan.projects 里,80 字以内),给的是「${text.slice(0, 40)}…」。\n` +
230
+ '这次没有筛任何账——别把「没筛」读成「这个项目没有账」。',
231
+ )
232
+ }
233
+ return text
234
+ }
235
+
236
+ function guardHygiene(args) { if (args.kind === undefined || args.kind === null) return
237
+ const raw = String(args.kind)
238
+ const name = raw.trim().toLowerCase()
239
+ // 空串=没给:星图那边只判真假,空串会走「全部概览」,与缺省同义。
240
+ if (name === '') return
241
+ if (!HYGIENE_KINDS.includes(name)) {
242
+ throw new Error(
243
+ `memory_admin:action="hygiene" 的 kind 只认 ${HYGIENE_KINDS.join(' / ')}(大小写不敏感,前后空格会去掉),给的是「${raw}」。\n` +
244
+ '不传 kind 就返回全部六类概览。\n' +
245
+ '这次体检没有跑——别把「没跑」读成「这一类没有问题」。',
246
+ )
247
+ }
248
+ args.kind = name
249
+ }
250
+
251
+ export function createAdmin({ flow, bridge, config = {}, meowDir = () => '.dsh-meow' }) {
252
+ // 本地面板:不依赖外部服务,也就不该有降级分支。
253
+ // 返回 { body, note }:抬头由 panel.js 统一加,这里只负责正文和口径说明(0.2.25)。
254
+ const local = {
255
+ cost(args) {
256
+ const lim = limitOf(ACTIONS.cost, args)
257
+ // [macro-fusion 0.2.76] 抬头以前无条件写「最近 N 次调用」,正文却只算了账本里剩下的那几条。
258
+ // 现在口径由 cost.js 的 costScope() 一处产出:真算了几条、你要几条、更早几条没进、几行读不出来。
259
+ const c = readCost(lim.value)
260
+ return { body: c.body, note: [c.scope, lim.note].filter(Boolean).join(' · ') }
261
+ },
262
+ // [macro-fusion 0.2.97] 整理留痕:正文与口径都在 dreamledger.js,这里只负责把「这次是谁在问」
263
+ // (工作区)和「读到哪本账」(meow 现在生效的 projectDir)交进去。
264
+ dream(args, exec) {
265
+ const lim = limitOf(ACTIONS.dream, args)
266
+ const dir = typeof meowDir === 'function' ? meowDir() : meowDir
267
+ // [macro-fusion 0.2.100] 翻页与单条展开:两个数字参数各有各的「不许悄悄退回默认」。
268
+ // page / id 给脏了就说清这次没按你说的做——静默退回第 1 页最容易让人以为「账本就这几条」。
269
+ const page = pageOf(args.page)
270
+ const id = idOf(args.id)
271
+ const project = projectOf(args.project)
272
+ // [macro-fusion 0.2.105] 按日期筛账:解析只写一份,就在面板里(本机时区、按整天、两端都含)。
273
+ // 这里原样交过去,免得「admin 认一种写法、面板认另一种」——两套解析迟早各说各的。
274
+ const since = String(args.since ?? '').trim()
275
+ const until = String(args.until ?? '').trim()
276
+ const panel = readDreamPanel({
277
+ workspace: workspaceOfExec(exec),
278
+ dir: typeof dir === 'string' && dir.length > 0 ? dir : '.dsh-meow',
279
+ limit: lim.value,
280
+ page,
281
+ id,
282
+ project,
283
+ since,
284
+ until,
285
+ })
286
+ return { body: panel.body, note: [panel.scope, lim.note].filter(Boolean).join(' · ') }
287
+ },
288
+ async links(args, exec) {
289
+ const lim = limitOf(ACTIONS.links, args)
290
+ // 面板不写数(0.2.33):预算与条数都在 linkflow 的配置里,面板和后台走同一条出口。
291
+ // 以前这里传 { budgetMs: 1500, limit: 20 },改了默认值面板不知道,两处各说各的。
292
+ const round = await flow.flushNow(exec)
293
+ const panel = pendingReport(lim.value)
294
+ const notes = []
295
+ if (round.linked > 0) notes.push(`这一轮补上 ${round.linked} 条`)
296
+ if (round.dropped > 0) notes.push(`清掉 ${round.dropped} 条永远连不上的(记忆已合并/删除)`)
297
+ // 0.2.54:撞车与没查成一律不摘队列,面板要说清它们还在,别让人以为「那一轮把它们清掉了」
298
+ if (round.ambiguous > 0) {
299
+ notes.push(`另有 ${round.ambiguous} 条短 id 不止一条记忆,没连也没摘——把 id 补到 8 位以上再说`)
300
+ }
301
+ if (round.unavailable > 0) {
302
+ notes.push(`另有 ${round.unavailable} 条这次没查成(读记忆的工具没接上),原样留着下次再试`)
303
+ }
304
+ if (round.stopped === 'unavailable') notes.push('星图这次没接上,队列原样留着')
305
+ // 预算是真的(0.2.28):掐断了就说清还剩几条,别让面板看起来像「补完了一轮」
306
+ if (round.stopped === 'budget') notes.push(`这一轮预算用完,还剩 ${round.left} 条下次读记忆时接着补`)
307
+ // 0.2.36:note 里带上这一轮真正用了多少预算、几条上限(来自 config,不是面板自己写的数)。
308
+ // 以前只说「最多列 N 条」,用户看到「还剩 12 条」时分不清是被 1.5 秒掐的还是被 20 条掐的。
309
+ const cap = `这一轮补连最多 ${describeMs(round.budgetMs)}、${round.limit} 条`
310
+ // 0.2.61:limit 被换成默认值时要说出来(0 照办 0、负数与非数字回默认、半条抹掉半条)
311
+ const note = [`最多列 ${lim.value} 条`, cap, lim.note].filter(Boolean).join(' · ')
312
+ return { body: notes.length > 0 ? `${panel}\n(${notes.join(';')})` : panel, note }
313
+ },
314
+ guide() {
315
+ // 门牌在前、vendor 原文在后:手册里全是子插件自己的话,读者光看正文不知道命令和面板也还在
316
+ // (0.2.16)。所以先讲三个面,再把两段原文原样接上。
317
+ // 0.2.63:末尾补一行「L0 现在多少字 / 上限是多少」。上限被配置写坏时那句话也一起带出来——
318
+ // 否则 `guideMaxChars: 0`(或写成 `"4k"`)会让整段注入消失,而在这里看一切正常。
319
+ const budget = guideBudget(config.guideMaxChars)
320
+ const fit = clampGuide(GUIDE_TEXT, budget.value).length
321
+ const tail = `L0 注入:现在 ${fit}/${budget.value} 字${budget.note ? `。${budget.note}` : '。'}`
322
+ return {
323
+ body: brandText(`${NAV_TEXT}\n\n---\n\n${buildFullGuide(bridge)}\n\n---\n\n${tail}`, { aliases: config.compatAliases === true }),
324
+ }
325
+ },
326
+ }
327
+
328
+ return {
329
+ name: 'memory_admin',
330
+ description: PANEL_SUMMARY,
331
+ parameters: {
332
+ type: 'object',
333
+ additionalProperties: false,
334
+ properties: {
335
+ // 枚举和执行表是同一份数据:加一行 ACTIONS 就多一个能选的 action,
336
+ // 不存在「schema 里有、分发里没有」的缝。
337
+ action: { type: 'string', enum: Object.keys(ACTIONS), description: '要看的运维面板。' },
338
+ target: { type: 'string', description: 'action=home:目标位置(预设名 default/dsh-storage/plugin-root 或绝对路径)。' },
339
+ limit: { type: 'integer', description: 'action=hygiene/cost/dream/links 的条数(默认:cost 200、links 20、dream 5,hygiene 由星图定)。' },
340
+ kind: { type: 'string', enum: ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan'], description: 'action=hygiene 只看某一类。' },
341
+ page: { type: 'integer', description: 'action=dream 翻到第几页(从 1 起,每页 limit 条;越过最后一页会退到最后一页并说出来)。' },
342
+ id: { type: 'string', description: 'action=dream 展开一条账。两种写法:"3"/"#3" 是第几近(1 = 最新,随新账往下挪);"r128" 是账本引用(每行末尾那个号,不挪,回指某一轮用它)。摊开摘要、备注、项目段、对子、库规模与 changes 原文。' },
343
+ project: { type: 'string', description: 'action=dream 只列某个项目段的账(按 changes.plan.projects 里的名字原样匹配;不列出项目分布,编号改为「筛出来那几条里的第几近」)。' },
344
+ since: { type: 'string', description: 'action=dream 只看这一天或之后的账,写 "2026-11-18"(本机时区算整天,含当天 00:00 起)。和 until 一起用就是一段日期;写坏了会打回并告诉你怎么写。' },
345
+ until: { type: 'string', description: 'action=dream 只看这一天或之前的账,写 "2026-11-20"(含当天 23:59:59)。' },
346
+ hubs: { type: 'integer', description: 'action=stats 列几个枢纽记忆,默认 10,上限 40。' },
347
+ verbose: { type: 'boolean', description: 'action=sources 是否列出适配器字段说明。' },
348
+ provider: { type: 'string', description: 'action=ingest 的来源名。' },
349
+ items: {
350
+ type: 'array',
351
+ description: 'action=ingest 的记忆条目数组。',
352
+ items: {
353
+ type: 'object',
354
+ additionalProperties: true,
355
+ properties: {
356
+ uid: { type: 'string' },
357
+ title: { type: 'string' },
358
+ content: { type: 'string' },
359
+ level: { type: 'string' },
360
+ keywords: { type: 'array', items: { type: 'string' } },
361
+ project: { type: 'string' },
362
+ importance: { type: 'number' },
363
+ status: { type: 'string' },
364
+ ws: { type: 'string' },
365
+ createdAt: { type: 'number' },
366
+ },
367
+ },
368
+ },
369
+ },
370
+ required: ['action'],
371
+ },
372
+ output: TEXT_OUT,
373
+ async execute(args, exec) {
374
+ const action = String(args.action)
375
+ const spec = ACTIONS[action]
376
+ if (!spec) throw new Error(`memory_admin:未知 action=${action}`)
377
+ // 星图侧的面板:缺席时说清「这次看不了」而不是把内部错误甩给模型(以 meow 为主,但 meow 的
378
+ // 本地功能不依赖星图;只有这些面板本身是星图的)
379
+ // [macro-fusion 0.2.72] 两种「没结果」必须分开说:
380
+ // - 装配没完成(星图没装 / 这项被配置关掉)→ 等一等有用,但一直这样就要去看配置;
381
+ // - 星图那边出错(引擎崩、文件读不出来)→ 等和重试都没用,原因必须原样带出来。
382
+ // 以前两种情形共用一句话,还许诺「等一等就好」,顺手把 ENOENT 这类原因吃掉,
383
+ // 于是「库文件读不出来」被读成「等会儿就好」。
384
+ const graphPanel = async (name, payload, what, miss) => {
385
+ const r = await flow.tryCall(name, payload, exec, what)
386
+ if (r.entry) return r.text
387
+ const said = String(r.text ?? '')
388
+ if (said.includes(NOT_READY_MARK)) {
389
+ return `星图这次没接上:${what}要的那个能力还没装配好(星图插件没装,或这一项被配置关掉了)——${miss},但这不是「星图里没有数据」。装好之后再问一次;一直是这句就别再等了,去看星图插件的配置。`
390
+ }
391
+ const pre = `${what}未完成:`
392
+ const reason = said.startsWith(pre) ? said.slice(pre.length) : said
393
+ return `星图这次答不上来(${what}):${reason}——${miss},但这不是「星图里没有数据」,也不是你问错了。重试之前先看这条错误:它是星图那边出的。`
394
+ }
395
+ // 三种 kind 走同一个抬头(0.2.25):面板名只从表里取,正文原样。
396
+ // wrap:false 的那一行(手册)不加抬头,理由写在那行注释里。
397
+ // [macro-fusion 0.2.68] 手册例外只免「抬头」,不免「说话」:它拿到不认识的参数时
398
+ // 一样要在末尾补一句,否则 `action='guide', limit=5` 就成了全表唯一的静默角落。
399
+ const wrap = (spec, { body, note }) => {
400
+ if (spec.wrap === false) {
401
+ const text = String(body ?? '')
402
+ const extra = String(note ?? '').trim()
403
+ return extra.length > 0 ? `${text}\n\n${extra}` : text
404
+ }
405
+ return panelText(spec.label, body, note)
406
+ }
407
+ // [macro-fusion 0.2.68] 这个面板不读的那几个参数:一声不吭地丢掉,用户会把结果读窄。
408
+ const stray = strayNote(action, spec, args)
409
+ if (spec.kind === 'call') {
410
+ const r = await flow.call(spec.call, pick(args, spec.params), exec)
411
+ return wrap(spec, { body: r.text, note: stray })
412
+ }
413
+ if (spec.kind === 'graph') {
414
+ // 参数校验也挂在表上(guard 字段),分发这边不认识任何具体 action 的名字
415
+ spec.guard?.(args)
416
+ const text = await graphPanel(spec.graph, pick(args, spec.params), spec.what, spec.miss)
417
+ // [macro-fusion 0.2.91] 体检的「相似」是近似签名,不是工具里的逐字重复度;两把尺子要摆到抬头里
418
+ const ruler = action === 'hygiene' ? hygieneRulerNote(text, args) : ''
419
+ return wrap(spec, { body: text, note: [ruler, stray].filter(Boolean).join(' · ') })
420
+ }
421
+ const impl = local[action]
422
+ if (typeof impl !== 'function') throw new Error(`memory_admin:action=${action} 在表里但没有实现`)
423
+ const out = await impl(args, exec)
424
+ return wrap(spec, { body: out.body, note: [out.note, stray].filter(Boolean).join(' · ') })
425
+ },
426
+ presentCall(args) {
427
+ // 卡片标题用表里的中文名:模型读到的 action 是 home/cost 这类键,用户看到的是面板名,
428
+ // 两套写法各走各的时候,卡片会变成「记忆运维:stats」这种谁也不认识的东西(0.2.25)
429
+ // [macro-fusion 0.2.60] 标题统一走 cardTitle():空细节不留悬空冒号。
430
+ // [macro-fusion 0.2.70] 前缀只放面板中文名——0.2.60 写的就是「prefix 是中文名」,
431
+ // 这里却塞了品牌在里头(卡片上多了两个字),全表唯一一处;品牌本该只在抬头那一行,
432
+ // 那几个字白占了 40 字的细节预算。细节位改成这一轮真给了的参数(cardDetail)。
433
+ const shown = typeof args?.action === 'string' ? args.action.trim() : ''
434
+ const spec = ACTIONS[shown]
435
+ if (!spec) return { card: 'generic', title: cardTitle('未知动作', shown), kind: 'read' }
436
+ return { card: 'generic', title: cardTitle(spec.label, cardDetail(args)), kind: 'read' }
437
+ },
438
+ }
439
+ }
@@ -0,0 +1,24 @@
1
+ import { TEXT_OUT } from '../shared.js'
2
+ import { cardTitle } from '../panel.js'
3
+
4
+ export function createDream({ flow }) {
5
+ return {
6
+ name: 'memory_dream',
7
+ description: '触发一次本窗口的记忆整理(dream):把本窗口建立/提取过的记忆逐轮封存成跨会话记忆。',
8
+ parameters: { type: 'object', additionalProperties: false, properties: {} },
9
+ output: TEXT_OUT,
10
+ async execute(_args, exec) {
11
+ const r = await flow.call('memory_dream', {}, exec)
12
+ const said = String(r.text ?? '').trim()
13
+ // [macro-fusion 0.2.48] 上游一个字都不给时这里不能沉默:空串会被读成「整理过了,没什么可说」,
14
+ // 而真实是「这次没算成」。同一句缺陷在子插件里修过一次,融合层这层也要自己守。
15
+ if (said.length === 0) {
16
+ return '整理任务这次没有任何回执(既没说启动了,也没说为什么没启动)——这不是「没有需要整理的记忆」,重试一次或看看宿主日志。'
17
+ }
18
+ return said
19
+ },
20
+ presentCall() {
21
+ return { card: 'generic', title: cardTitle('整理本窗口记忆', ''), kind: 'write' }
22
+ },
23
+ }
24
+ }