dsh-macro-memory 0.3.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -17
- package/lib/index.js +34 -1
- package/lib/macro/defs/admin.js +12 -9
- package/lib/macro/defs/read.js +16 -1
- package/lib/macro/defs/remember.js +201 -3
- package/lib/macro/defs/search.js +214 -4
- package/lib/macro/supersede.js +197 -0
- package/lib/macro/tools.js +2 -2
- package/package.json +1 -1
- package/vendor/VENDOR.json +5 -5
- package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +4 -1
- package/vendor/dsh-memory-nebula/lib/host/entities.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/graph.js +101 -2
- package/vendor/dsh-memory-nebula/lib/host/graphcache.js +9 -1
- package/vendor/dsh-memory-nebula/lib/host/recall.js +75 -2
- package/vendor/dsh-memory-nebula/lib/index.js +26 -3
- package/vendor/dsh-memory-nebula/lib/web/app.js +15 -2
- package/vendor/meow-memory/lib/index.js +248 -13
package/README.md
CHANGED
|
@@ -2,22 +2,27 @@
|
|
|
2
2
|
|
|
3
3
|
> 一个记忆插件,接管全部记忆能力:**8 个工具、一段 1,235 字符的常驻注入**,主库仍是 meow 的七层 SQLite,星图退成可重建的索引。
|
|
4
4
|
>
|
|
5
|
-
> 适用:DeepSeek Harness(DSH)。版本 **0.
|
|
5
|
+
> 适用:DeepSeek Harness(DSH)。版本 **0.4.1** · 许可 MIT · 内置 meow-memory 与 dsh-memory-nebula 的完整副本(均为 MIT,见[第三方声明](#第三方声明与来源))。
|
|
6
6
|
|
|
7
|
-
| 指标 | 融合前(三插件并存) | 现在(0.
|
|
7
|
+
| 指标 | 融合前(三插件并存) | 现在(0.4.1) | 变化 |
|
|
8
8
|
| --- | --- | --- | --- |
|
|
9
|
-
| 工具 schema 合计 | 17 个工具 / 56,759 B | **8 个工具 / 13,
|
|
9
|
+
| 工具 schema 合计 | 17 个工具 / 56,759 B | **8 个工具 / 13,567 B** | **−76.1%** |
|
|
10
10
|
| 常驻注入 | 4,085 字符(meow 3,396 + nebula 689) | **1,235 字符(1 段)** | **−69.8%** |
|
|
11
11
|
| 每轮固定开销 | 约 14–16K token | **约 2.2K token** | **−85%** |
|
|
12
12
|
| 单次检索(1200 条库) | 107.2ms(p50) | **2.9ms(p50)** | **−97.3%** |
|
|
13
13
|
| 面板 / 工具来源 | 三个插件各一套 | 一个插件两个面板 | 口径统一 |
|
|
14
14
|
|
|
15
|
-
> **0.
|
|
15
|
+
> **0.4.0 里程碑**:这一版不换引擎、只把「账」和「刀」都做实——六件事全部带开关、带回滚、带能红证明:**口径单**(新建 `docs/EVAL-CLAIMS.md`,把可引用的与过期的分成两张表)、**查询分解** `multiQuery`(默认 `off`)、**写入端巩固** `consolidate`(默认 `suggest`,一个字不写库)、**写入端通胀体检**(`selfecho` / `unused` / `inflate` 三类)、**自动取代** `autoSupersede`(默认 `suggest`)、**实体星图**(四类硬事实成层,顺带修掉「两跳从来没跑过第二跳」的沉默 bug)、**共现自学习扩词**(词源取每条的 `keywords`,不靠人手枚举)。读数:**30 支自检 / 3,511 条可执行断言 / 约 220 秒**;gold 宽池 146 条 **照抄 1.000 / 换说法 1.000(14/14)**、关掉共现即退回 0.929(增量可归因);窄池 40 条换说法 0.929、时间锚 1.000;真库 635 条 40 问 hit@1 0.925、MRR 0.963。以上全部无 LLM,端到端 judge 仍未重测(口径见 `docs/EVAL-CLAIMS.md`)。
|
|
16
|
+
|
|
17
|
+
> **0.4.1**:只修文档口径——npm 上的 0.4.0 是在补完英文段之前打的包,包内 README 还停在 `13,372 B` 与「21 支 / 2,198 条」。0.4.1 不动任何代码逻辑,只让 GitHub 与 npm 上的 README 同 `tools/probe-host.mjs` 的 D3 实测对齐(13,567 B / 30 支 / 3,511 条)。
|
|
18
|
+
|
|
19
|
+
> **0.3.0 里程碑**:从 0.1 的「把三套记忆插件合成一套」走到这里,它已经是一条能自证的流水线——180 个补丁版本、**24 支自检 / 3,323 条可执行断言**(约 200 秒跑完;这是 0.3.0 发布那一刻的读数,现状见 §六 与 [`docs/EVAL-CLAIMS.md`](docs/EVAL-CLAIMS.md) 表 A),每次调参都留下读数、否决记录和阴性对照;检索三档在 146 条宽池上的读数是**照抄 1.000 / 换说法 0.929 / 时间锚 0.889**(每档配一条「关掉这把刀就变差」的对照)。到这里接口面已经冻结:**8 个 `memory_*` 工具、一段 1,235 字符注入、7 层 SQLite 主库、format-1 市场索引**——0.3 之后只加字段不删字段、只加工具不改名,旧调用原样能用。同时首发到 npm(`npm i dsh-macro-memory`)、GitHub 与 awesome-dsh-plugin 目录。
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
19
23
|
## 目录
|
|
20
24
|
|
|
25
|
+
- [一眼看懂(0.4.0,全部可复核)](#一眼看懂040全部可复核)
|
|
21
26
|
- [它解决什么问题](#它解决什么问题)
|
|
22
27
|
- [它是怎么搭起来的](#它是怎么搭起来的)
|
|
23
28
|
- [记忆怎么工作](#记忆怎么工作)
|
|
@@ -34,6 +39,37 @@
|
|
|
34
39
|
|
|
35
40
|
---
|
|
36
41
|
|
|
42
|
+
## 一眼看懂(0.4.0,全部可复核)
|
|
43
|
+
|
|
44
|
+
| 维度 | 数字 | 怎么来的 |
|
|
45
|
+
| --- | --- | --- |
|
|
46
|
+
| 工具面 | **8 个 `memory_*` 工具 / 13,567 B schema**(三插件并存时 17 个 / 56,759 B,**−76.1%**) | 17 个原工具的能力压进 8 个,参数级覆盖审计逐条钉住(`tools/coverage-audit.mjs`) |
|
|
47
|
+
| 常驻注入 | **1,235 字符 / 1 段**(原来 4,085 字 / 3 段,**−69.8%**) | 每轮固定开销约 14–16K token → **约 2.2K token** |
|
|
48
|
+
| 检索延迟 | 1,200 条库 **p50 2.9ms**(三插件并存时 107.2ms) | 纯本地词法 + 索引缓存,不调网络、不调模型 |
|
|
49
|
+
| 自证规模 | **30 支自检 / 3,511 条可执行断言**,全跑约 220 秒,少一条就判红 | `node tools/check-all.mjs`;断言数与基线逐支对账 |
|
|
50
|
+
| gold 召回(146 条宽池) | **照抄 1.000 / 换说法 1.000 / 时间锚 0.889** | `node tools/probe-gold.mjs`,关掉共现扩词换说法立刻退回 0.929 |
|
|
51
|
+
| 真库召回(635 条 / 40 问) | **hit@1 0.925 / hit@5 1.000 / MRR 0.963** | 本地全量库实测,无 LLM |
|
|
52
|
+
| LoCoMo 1,536 题(无 LLM) | hit@20 **0.7546**(旧口径 0.651)、MRR **0.4953**(旧 0.3768)、平均取回 17.77 条(旧 19.99) | 给得更少、命中更高;口径与命令见 [`docs/EVAL-CLAIMS.md`](docs/EVAL-CLAIMS.md) A2 |
|
|
53
|
+
|
|
54
|
+
**它比「再装一个记忆插件」强在哪**——四条,每条都有对照:
|
|
55
|
+
|
|
56
|
+
1. **省的是每轮都要重付的钱。** 工具 schema 与注入是每一轮请求的前缀,省下来一次就是每一轮都省。schema −76.1%、注入 −69.8% 不是压缩文案,是把三个工具面合并成一套(原 17 个工具的能力仍在,参数级审计证明没克扣)。
|
|
57
|
+
2. **每一把刀都能关回去,且关掉会变差。** 查询分解 `multiQuery`、写入巩固 `consolidate`、自动取代 `autoSupersede`、实体层 `entity`、共现扩词 `coocLearn`、同义词桥 `synBridge` 全是配置项,默认最保守;每条都有「关掉这把刀 → 读数掉」的阳性对照(例:关共现扩词,宽池换说法 1.000 → 0.929)。
|
|
58
|
+
3. **判据只有一份实现,而且每条都证明过「能红」。** 同一件事不许 verify 和 doctor 各写一遍(宽严会分叉,绿的那份才是你唯一会自己跑的);每条判据都配一个「只该弄红这一条」的输入,造坏了没红就算它不成立。
|
|
59
|
+
4. **新加的东西不许说谎。** 写入端有通胀体检(关键词自证率 `selfecho`、召回闭环 `unused`、层通胀 `inflate`),读的时候会把「这条是历史结论,现状在 <id>」顶到第一句——取代与巩固都不静默发生。
|
|
60
|
+
|
|
61
|
+
自己复核(三条命令,全部离线):
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
node tools/check-all.mjs # 30 支自检 / 3,511 条断言,约 220 秒
|
|
65
|
+
node tools/doctor.mjs # 两棵树字节一致、账本指纹、加载面、备份
|
|
66
|
+
node tools/probe-gold.mjs # gold 三档 + 开关对照
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
**不说满的地方**(详见[§七](#七不说满的地方)):gold 是自建语料、不是公开榜单;真库数字随库增长不可跨时间比;端到端 LLM-judge 在 0.4.0 之后没重跑过,任何「端到端涨了多少」的说法本仓库不认。
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
37
73
|
## 它解决什么问题
|
|
38
74
|
|
|
39
75
|
记忆插件通常各干各的:一个存长期记忆、一个建关系图谱、一个做性格画像。装三套的代价不是磁盘,是**每一轮都要重付的上下文税**:
|
|
@@ -161,7 +197,7 @@ MEOW_VEC_CACHE=<记忆家目录>/dense-cache.json
|
|
|
161
197
|
|
|
162
198
|
| 项 | 融合前 | 现在 | 说明 |
|
|
163
199
|
| --- | --- | --- | --- |
|
|
164
|
-
| 工具 schema | 56,759 B(17 个) | **13,
|
|
200
|
+
| 工具 schema | 56,759 B(17 个) | **13,567 B(8 个)** | `tools/probe-host.mjs` 实测 D2/D3 判据(D3 会拿这张表的数字和实测对账) |
|
|
165
201
|
| 常驻注入 | 4,085 字符 | **1,235 字符** | 同一支探针 E2 判据,上限 1,400 |
|
|
166
202
|
| 旧工具名残留在注入里 | 有(`nebula_recall` 等) | **0** | E4 判据 |
|
|
167
203
|
| 别名工具 | — | 默认关闭 | 打开后 19 个工具,供老会话/老脚本过渡 |
|
|
@@ -262,6 +298,16 @@ git clone <THIS_REPO> dsh-macro-memory
|
|
|
262
298
|
这一节只放读数和对照。所有数字都能在本仓库跑出来(每段末尾写了是哪个脚本),跑不出来的不写;
|
|
263
299
|
读数是自建 gold 上的,不是公开 benchmark,边界也一并写在最后一小节。
|
|
264
300
|
|
|
301
|
+
> **数字的出处与时效**:本节所有读数都是**仓库回归闸门**(`tools/probe-*.mjs`),跑一遍就能复现,有效期跟着 commit 走。
|
|
302
|
+
> 端到端 LLM-judge 那类需要模型判分的数字不在这里——它们属于历史读数(最近一次是 2026-11-20 / omni3 / 0.2.x 时期),
|
|
303
|
+
> 口径、日期与「什么情况下才能重跑」写在 [`docs/EVAL-CLAIMS.md`](docs/EVAL-CLAIMS.md)。引用任何数字前,先看那张单子。
|
|
304
|
+
>
|
|
305
|
+
> **本地 LoCoMo 检索 gold(2026-11-22,全程无 LLM)**:hit@5 **0.6159** / hit@10 **0.6953** / hit@20 **0.7546**、
|
|
306
|
+
> recall@20 `0.6822`、MRR `0.4953`、nDCG@10 `0.5029`(1,536 题剔 category 5,固定 top-20,`avg_retrieved 17.77`、`avg_context_chars 5947`);
|
|
307
|
+
> 对照 2026-11-20 的 0.2.x 旧检索基线(`avg_retrieved 19.99`):hit@20 `0.651 → 0.7546`、MRR `0.3768 → 0.4953`、nDCG@10 `0.3933 → 0.5029`。
|
|
308
|
+
> **给得更少、命中更高**;但这是命中率不是准确率,端到端 LLM-judge 自 2026-11-20 起仍未重测。
|
|
309
|
+
> 口径与复核命令见 [`docs/EVAL-CLAIMS.md`](docs/EVAL-CLAIMS.md) A2。
|
|
310
|
+
|
|
265
311
|
### 一、检索准确率:自己出题、自己判卷
|
|
266
312
|
|
|
267
313
|
`tools/probe-gold.mjs` 拿真库造了一套 gold 语料:40 条做题干(层与状态都真,五层俱全,关键词平均 9.3 个,
|
|
@@ -322,7 +368,7 @@ git clone <THIS_REPO> dsh-macro-memory
|
|
|
322
368
|
| 项 | 数值 | 闸门 |
|
|
323
369
|
| --- | --- | --- |
|
|
324
370
|
| 常驻注入 | **1,235 字符 / 1 段** | ≤ 1,400,余量 165 |
|
|
325
|
-
| 工具 schema(8 个) | 原始参数 **4,714 B**;宿主投影后 **
|
|
371
|
+
| 工具 schema(8 个) | 原始参数 **4,714 B**;宿主投影后 **13,567 B** | 投影 ≤ 16,000 |
|
|
326
372
|
| 工具整字面量(含 render) | **107,583 B** | ≤ 110,000 |
|
|
327
373
|
| `memory_search` 单项 schema | 6,851 B | ≤ 7,500 |
|
|
328
374
|
| 每轮固定开销 | 约 **2.2K token**(融合前 14–16K) | — |
|
|
@@ -331,17 +377,20 @@ git clone <THIS_REPO> dsh-macro-memory
|
|
|
331
377
|
`budget` **五路都吃**(本地 / 星图 / 补邻居 / 相似 / 读),砍的顺序是「先砍每条的字、再砍条数」,
|
|
332
378
|
并且每砍一刀都写清砍了什么——装不下时给的是**实测**最小值,不是估的。
|
|
333
379
|
|
|
334
|
-
### 六、自证:3,
|
|
380
|
+
### 六、自证:3,511 条可执行断言,少一条判红
|
|
335
381
|
|
|
336
382
|
| | |
|
|
337
383
|
| --- | --- |
|
|
338
|
-
| 自检支数 | **
|
|
339
|
-
| 断言总数 | **3,
|
|
384
|
+
| 自检支数 | **30 支**(1 支 verify + 25 支探针 + 4 支契约/体检) |
|
|
385
|
+
| 断言总数 | **3,511 条**,全跑约 220 秒 |
|
|
340
386
|
| 基线 | `tools/baselines.json` 记下每支的条数与耗时上限 |
|
|
341
387
|
| 反面证据 | 每支都带**阴性对照**:机制删掉、判据要能红。删了还绿,那条判据就是注释 |
|
|
342
388
|
|
|
343
|
-
|
|
344
|
-
召回、合并、去重、相似、面板账本、gold 准确率、成本、客户端 bundle、注入、YAML
|
|
389
|
+
30 支覆盖:检索融合、星图、宿主装配、客户端 UI、判据覆盖审计、参数审计、工具体积、工具面、词表、
|
|
390
|
+
召回、合并、去重、相似、面板账本、gold 准确率、成本、客户端 bundle、注入、YAML、市场索引、加载面、星图面板、
|
|
391
|
+
查询分解、写入端巩固、写入端通胀体检(自证率 / 召回闭环 / 层通胀)、自动取代(五类硬事实 / suggest 只建议)、
|
|
392
|
+
实体层与动态跳数(四类硬事实 / 层不进图 / 第二跳按词面收 / 硬边照走)、
|
|
393
|
+
共现自学习扩词(词源取 keywords / 同条 2 跨文档 1 / 三道门 / 库越大越连得上)、体检。
|
|
345
394
|
|
|
346
395
|
断言数写进基线之后,「改坏」不再靠人发现:少一条、慢一截、读数掉下闸门,都会在 `check-all` 里变成红。
|
|
347
396
|
|
|
@@ -359,17 +408,19 @@ git clone <THIS_REPO> dsh-macro-memory
|
|
|
359
408
|
## 质量:怎么证明它没坏
|
|
360
409
|
|
|
361
410
|
```bash
|
|
362
|
-
node tools/check-all.mjs #
|
|
411
|
+
node tools/check-all.mjs # 30 支自检,3,511 条断言,约 220s
|
|
363
412
|
node verify.mjs # 单支:宿主契约 + 浏览器装配
|
|
364
413
|
node tools/doctor.mjs # 体检:两棵树字节一致、加载面、注入长度、队列、账本
|
|
365
414
|
```
|
|
366
415
|
|
|
367
|
-
- **
|
|
416
|
+
- **30 支自检 / 3,511 条断言**,全部可执行,覆盖:宿主装配契约、真 vendor 端到端联动(含星图缺席降级)、真 meow 库 + 真 nebula 引擎的节点/边/生命周期、真 cordis + 真 ToolsService + 真 SystemPrompt、浏览器侧 UI 注册、17 个原工具 → 8 个统一工具的参数级覆盖审计、查询分解量尺(20 题双实体:切开 20/20、原榜前 3 不动、救回 1 题)、写入端巩固量尺(桩 flow 数调用:`off` 不发检索 / `suggest` 不写库 / `write` 恰多 1 条)、写入端通胀量尺(九类体检同序 / 自证率与层通胀的阳性与阴性对照 / 真 sqlite 数 `read_count`——检索不冒充读、老库自动补列)、自动取代量尺(五类硬事实 / 两道门槛分开 / `off` 零检索 / `suggest` 一个字不写库 / `apply` 才标 stale / 人点名的不重复建议 / 与 meow 判据同结论)、17 个原工具的清单与 schema 体积(render 闭包另设粗胖线)、工具账本(每个脚本有归属)、口径总账(手册/schema 常量/对外文案同源)、召回校准(相关度优先 + 重要度进分数 + 相关度下限 min_rel)、合并账本(关键词并集 / 归属不搬 / 变短默认不换 / overwrite 才换)、跨层重复(写时点名另一层 / 检索折叠逐字级重复 / dedupe: false 看全量)、相似检索(基准与候选同一把尺子 / 本会话刚写的也算候选 / 端过的不再端)、两把尺子(相似度 cosine 与逐字重复度 Jaccard 并报 / 与写侧合并判据同源 / 长文嵌一句要点名)、记忆体检口径(「相似 N」是稀有词签名估算、判「同一句存两层」看 repeat、两把尺子靠一句口径说明指路)、dream 重复对(整理清单里点名逐字重复的对子 / 没对子一个字不加 / 短 id 在清单内互不撞前缀)、dream 跨轮次重复(同一句话一条 fact 一条 topic 也点名 / 一对只说一次 / 半边标「另一组」并说清怎么处置)、dream 重复详写(短摘录 + 长详写也算同一件事 / 覆盖度 ≥90% 且短条至少 8 个词 / 与逐字重复块互斥不重复点)、dream 合并处方(每个重复详写对下面点名短条里长条没有的词、最多 6 个 / 无损时明说「没有长条之外的词」/ 三把尺子各管一段:重复合并、相似不许合并)、dream 整理留痕(回执先说这一轮看到几轮几条 / 几对逐字重复 / 几对重复详写 / 几个词要补;收尾把同一份数字写进 dream_log 的 changes.plan 与 summary;念完即清 meta,下一轮读不到旧账)、整理留痕面板(`memory_admin(action="dream")` 照账本念,不现算;没工作区 / 还没建库 / 库读不开 / 账本为空四种来路各说各话;0.2.96 之前的老记录明说「比 0.2.96 早」,不冒充有规模)、整理走向(每条账带 `#k` 序号与「落库 是/否」,末尾一行趋势给最近几次的重复对/缺词合计与「在变多/在变少/持平」;可用记录不到 2 条不出这一行,不到 4 条自带「样本太少别当走势」,老记录跳过时点明几条没参与),都含阴性对照、整理中那一轮(dream 正在跑时面板第一行就报这一轮多大——规模读的是 `dreamdigest`,不是账本;不给这轮编 `#k`、也不进趋势;只有 lease 活着才算「进行中」,lease 一放掉第一行立刻消失;只有 lease 没有摘要就说「规模还没落 meta」,不拿当前清单现算;SSE 的 `dreaming` 事件同时带上这份规模,老消费方只认 `state` 照样工作)、整理留痕的翻页与单条展开(账本长了要能翻:`page` 从 1 起、编号「第几近」跨页连续、总数来自 `COUNT(*)` 不是本页条数、页越界退到最后一页并说清;`id` 摊开某一条的摘要 / 备注 / `changes` 原文,超长截断并报真实长度,老记录明说没有规模,坏行只说读不出来不拿摘要凑;`page`/`id` 给脏了当面打回,不静默退回默认;趋势与「整理进行中」只在第 1 页出)、账本按项目段翻账(`changes.plan.projects` 以前只被数了个数:第 1 页没筛时多一行「项目段:Alpha 3 次 · Beta 1 次」,只列前 5 个并说「还有 N 个没列」;`project=` 筛在 SQL 里做(`json_valid` + `json_each`),页面与总数共用一个筛子,坏行不许算成匹配、也不许带崩整本账;筛着时不再给分布、编号明说「是筛出来这几条里的第几近,不是全账本序号」,导航写「共 M 条(项目段「X」)」;筛空说「账本里没有项目段「X」的整理记录(全账本 N 条)」而不是「账本还是空的」,并点明项目名要按原样写;展开时补一句属于/不属于这个项目段,编号仍是全账本第几近;`project` 给成长句当面打回;写侧存名字不存个数——`changes.plan.projects` 从 0.2.102 起是真名字(trim / 去空 / 去重保序),个数另存 `projectCount`,老账本照个数念而不念成 0;`changes.plan.pairs` 把「跟谁撞了」也落账(短 id 与整理清单同一套,能直接 `memory_read` / `memory_update`;`cover` 带「合并会丢哪几个词」),一条账最多存 6 对明细,而「这一轮共几对」是真数不被上限截断;老账本「有数无明细」与「真没撞上」分开说)、账本记库规模(开工那一刻按层数一遍 `status = 'active'` 的条数,写进 `changes.plan.store`:只数在用、零层不写进 JSON、收尾不再数;面板展开多一行「库规模:开工时 N 条在用(fact 1 · lesson 1 · topic 1)」,老账明说「它写在 0.2.103 之前」且不许念成「0 条在用」,没有 plan 的账不再叠一层告示;趋势行给「库 开工时 2 → 3 条(多了 1 条)」,至少两次有数才敢讲,缺的几次单独提示「库规模只有 K 次有数」;探针 L9–L11 用真库验写侧数字、D37–D39 验面板真念,含「老账不补 0」「无 plan 不叠告示」两条阴性对照)、账本行的稳定引用(`#k` 是位置、会随新账往下挪,`r<N>` 是这一行自己的号:`dream_log.id` 是 AUTOINCREMENT,只增不减、删了也不复用,所以 `r128` 永远指同一轮整理——面板每行末尾印 `· 引用 r<N>`(老账行也印,否则最早的几轮永远回指不了),第 1 页只说一次「要回指就用 `id=r<N>`,`#k` 只是此刻排第几」;`id=r128` 按引用展开,正文照账念、另起一段说「它现在排第 K 近」,引用打不开时明说「这个号从来不会发给新账」并给按位置找 / 按内容搜两条路;「第几近」那条路也顺手回一句引用,省一次翻列表;`dreamRankOf` 与账本列表共用一把尺子(`run_at` 相同再比 id),否则引用和编号会静默指向不同的行;探针 L12–L14 用真 writer 验「再跑一轮:第几近 1→2 而 `runAt` 不变」,D40–D42 验面板真念,含「ref=0 不猜行」「每页都印提示」两条阴性对照)、账本按日期筛(`run_at` 是毫秒、人说的是日期,中间这座桥现在有了:`since` / `until` 写 `"2026-11-18"` 这种日期,**闭区间**——当天 `00:00:00.000` 与 `23:59:59.999` 都算在内,前 1 毫秒后 1 毫秒都在外;**本机时区**——按 `new Date(y, mo-1, d, …)` 解并回读年月日校验,绝不用 `Date.parse`(那是 UTC,东八区整体错 8 小时),`2026-02-31` 这种被 JS 滚到下个月的写法当面打回「这种写法不敢猜」;**行与总数同一把筛子**——筛留在 SQL 里,`recentDreamsPage` 与 `dreamCountOf` 共用一份 `parts`,否则翻页漏条、条数虚高;`since > until` 也打回,且打回发生在第一次读库之前。筛空时说「这段时间里没有整理记录——账本覆盖 A → B(本机时区 UTC+08:00)」并报「全账本 N 条都在这个区间外面」,不把「这段里没有」说成「账本里没有」;展开一条时补一句它不在区间里(写在几点),引用照旧展开、明说「日期筛选也不影响引用」;只按项目筛时老句式一字不变,日期是加上去的一层。探针 L15–L17 直接插 `run_at` 量边界与覆盖范围,D43–D45 验面板真念,含「旧账不混进来」「坏日期一次库都不查」两条阴性对照)、账本记整理前后的库规模(只念开工那一眼,永远算不出「这一轮让库变轻还是变重」:`finalizeDream` 收尾时再数一次 `dreamStoreScale(db)` 落进 `changes.plan.storeEnd`,并算出 `storeDelta = 收尾 - 开工`,只在两个点都有数时才算——老账没这一格就不猜,不拿 `NaN` 或负数当 0;收尾数只能在写侧取,面板渲染时库早变了,重算出来的是「看账那一刻」而不是「整理结束那一刻」;落库日志补 `store=A->B`,`summary` 上就能对账;面板展开念「库规模:开工时 2 条在用(fact 1 · topic 1) → 收尾 3 条在用(fact 2 · lesson 1),比开工多 1 条」,老账只念开工一眼、不编收尾也不补 0;差与因分开写成两句——`storeDelta` 是「库变了多少」,`stamped` 才是「这一轮封存/完结几条」,口径句明说这一点;趋势行补「收尾净增/净减 N 条(K 次有收尾数)」,缺收尾数的账不参与合计但要说几次;文案上把两层括号叠在一起的 `(fact 1)(-2)` 改成「层数进括号、差进句尾」,趋势 caveat 也改用破折号。探针 L18–L20 真开工→中途加两条归档一条→两次 `advanceDream` 真收尾(`store=2->3`、`delta=1` 是净变化不是新写条数、归档层不进收尾层数、老账两个字段都是 `undefined`),D46–D48 验面板真念,含「只有开工数不编收尾」「不叠两层括号」两条阴性对照)、账本分清收尾方式(以前只记「这行摘要怎么写」、记不住「这件事怎么结束的」:`window dream (done|aborted):` 里那一个词既是数据也是文案,`changes` 里没这一格;`groups` 只有分子没分母,「走了 1 组」说不出本来几组;补记账被念成「这条记录比 0.2.96 早」;连续失败止损封存只写调试日志、账本上等于没发生过。现在写侧落结构化 `changes.kind` 五态:`done` / `aborted`(带 `groupsDone` + `groupsTotal`,摘要印 `groups=1/2`)/ `recovered`(带 `groupsDone`)/ `gaveup`(带 `fails`)/ `sealed`(带 `fails`,首次进账本),`groupsDone` 取 `groupsCount - 1` 因为 `abortDream` 传的是「进行到第几组」;分母必须在 `finishDream` 删 `dreamplan` 之前读(收尾动作自己就把账要吃的数据删了);`sealed` 与 `dream-debug.log` 两处都写、不互相替代(一个给排查、一个给回看)。读侧 `kindOf` 优先认 `changes.kind`(`stored: true`),认不出才退回摘要首词并明说「这一格是认出来的」,缺值是 `null` 不是 0(「走了 0 组」是假话);`reasonOf` 跳过 `(interrupted)` / `(turn-failed)` 修饰语;行上与展开各念自己的话(`走了 1/2 组就停下`、`收尾方式:连续失败已封存(连续失败 3 次)`),只有真老账才念「比 0.2.96 早」,没跑完的轮在规模段与对子段两处改口;趋势与「比更早一条」只吃跑完的一轮(半轮的 `dup/cover/missing` 是扫到那儿的中间值,加进合计等于把半张成绩单当满分算),趋势另说「K 次没跑完,不进合计」,比对遇到半轮只回「数字不可比」。探针 L21–L24 用真引擎验四种收尾——`sealed` / `gaveup` 都先 `touchWindow` 钉住 `last_event_time`,否则 `recordDreamFailure` 每轮凭 `Date.now()` 开新范围、失败次数永远从 1 重数;D49–D53 + D11b 验面板真念,含「补记账不冒充老账」「半轮不比数字」两条阴性对照)、层走向(总条数的净变化只说「库重了多少」,说不出「哪一层在膨胀」:fact 一直涨、topic 一直掉,总分可能是 0 而库的结构在烂——一轮把 2 条 topic 降成 fact、lesson 掉一条、fact 涨两条,账本念「比开工多 0 条」,读的人松一口气。现在每轮收尾时的 `storeEnd.byLevel` 摊成一条走向:只认收尾层数(0.2.103~0.2.105 只有开工数,拿它占位等于把整理前的库贴到整理后的位置上,图整齐但全是假的)、写侧零层不写进 `byLevel` 所以「写了却没有那一层」= 那轮那层 0 条在用(缺 ≠ 没记,这句写进口径)、只吃跑完的轮(半轮的层数是扫到那儿的中间值);每层念 `fact 2 → 3 → 3(+1)`/`topic 0 → 1 → 2(+2)`/`lesson 1 → 1 → 1(没变)`,按变化幅度排序只列 4 层(多的说「还有 N 层没列」),结论分涨/掉/都没变三支——没涨就不许编「涨得最多的是 fact(+0)」,那是把噪声讲成走势;少于两轮不出(一次是快照,不是走向),只在第 1 页出(它说的就是最近这几条)。探针 L25–L26 验写侧尺子按 `status='active'` 数、归档立刻掉出、零层不出现(两条 fact 的内容与关键词要刻意错开,否则写侧去重会把它们并成一条),D54–D57 验面板真念,含「单轮不出」「每层没变就说没变」两条阴性对照)、回执成本与预算(以前只说「查到了什么」、从不说「这一趟花了多少」,于是省 token 全靠调用方猜 `k`——给多了怕漏、给少了怕不够,最后总是给多:回执够大(≥500 token)时代价自带一行「≈N token(CJK 一字算 1、其余 4 字符算 1,是量级不是账单)」,1200 token 以上才缀「只想看骨架就加 budget=400」,小回执一个字不加;`budget=N` 让工具自己收紧——**先砍每条的字**(`content_max` 减半到 60)、**再砍条数**(`k` 减半到 1),每级都真改参数重查而不是截字符串(截断等于把一条记忆拦腰砍断,读者看到一句没有下半句的话,工具还说「收紧了」,那是骗人),装下就交代「收紧了 N 次、k A→B、content_max A→B」,四级之后仍装不下就**真取一次** `k=1、content_max=60` 的最小一份并写「实测」,不拿第四级的估计冒充最小;收紧排在星图段之前(顺序反了等于把邻居段落加在预算外,尾注说「按 400 收紧了」而回执仍超),星图退回本地兜底的两条路也照收;预算四态分开说(没给静默 / 不是数字 / 小于 80 / 超过 20000 按 20000 算),**给了却没生效绝不静默**,星图 / 相似两路明确说「体量由引擎的 limit / chars 决定,这次没缩」。探针 L27–L28 钉估算口径与预算四态(含可复算),D58–D61 钉出口收敛与「装不下」两条阴性对照)、预算贯通四路(`budget` 从「本地检索的参数」升级成「这次回执的约束」:本地先砍 `content_max` 再砍 `k`、星图先砍 `limit` 再砍 `hops`、补邻居先砍 `chars` 再砍 `limit`、相似先砍 `content_max` 再砍 `k`,顺序都是「先动只是少看一点细节的,再动真会少看到东西的」;预算传进来是对象,入口先摊成数字再比——拿对象比恒 false,会一路滑到「装不下」还印出「预算 [object Object]」;只报真动过的旋钮(`hops 2→2` 等于谎言),报「最小」之前把所有旋钮压到下限再量一次;本地 `expand` 的扩散段按 `remain = budget - 本地那一段`算,剩余不够就不拿并告诉读者两条出路;尾注不再声称「只有本地能收紧」。探针 D62–D66 钉四路各自收哪个旋钮与「装不下要量到下限」,D61 改成「没给预算就不缩也不说废话」两条阴性对照)、项目走向(层走向只说「哪一层在涨」,说不出「是谁在涨」:Alpha 加 3 条、Beta 删 3 条,fact 的净数没变,层走向念「fact 没变」而实际上一个项目在长肉、另一个在被清空——所以按项目再摊一条走向:只数带项目归属的 5 层(`project` / `fact` / `lesson` / `topic` / `rules` 有 `project` 列,`soul` / `user` 只有 `COMMON_COLS` 没这一格,口径句里明说,免得读者拿总条数一减以为 soul 的条目丢了)、跨层同名相加(读者问「这个项目多大」,不是「它的 fact 多大」)、NULL 与空串不算一个项目(否则每个全局条目都变成一个叫 `null` 的项目)、一个项目都没有时整格不写(空对象落进 JSON 会被读成「数过,零个项目」)、只认收尾那一刻的 `storeEnd.byProject`(0.2.111 之前的账没有这一格就不进走向,不补 0 让线看起来连续)、名字按写入时原样存所以改过名的会算成两行(口径句明说,不偷偷猜改名)、三支结论涨/掉/都没变——没涨就不许编「涨得最多的是 Alpha(+0)」,那是把噪声讲成走势。探针 L29–L31 用真库验跨层相加、全「全局」库不出现空名、归档后整个键消失,D67–D70 验面板真念,含「单轮不出」「每个项目都没变就说没变」两条阴性对照)、读也吃预算(read 是唯一一支回执里带「caller 点名要的东西」的工具,所以它不能像别的工具那样砍内容:正文一个字节都不截,能缩的只有邻居**条数**——给了 `budget` 就先从你要的条数往下试 6 / 3 / 1 / 0,每档都真取一次真量一次(估算与真实体量之间没有稳定比例,最多试三档,且绝不超过你自己要的数),装下就写「邻居 12→6 条才装下」;一条邻居都砍光了还装不下,就只给**骨架**:正文第一行(≤120 字)+ 缺口与三条出路(正文共多少字≈多少 token / 你给的预算是多少 / 把 budget 提到 ≥ 体量,或者先 `memory_search` 看摘要挑一条),因为「截一半给你」比「不给你」更坏——读者会把半条当成全文;连骨架那一行都超预算时再加一句「连上面那一行标题都超过你给的预算了」,宁可超几点 token 也不让形态被误认。尾注自己也要装进预算:砍过邻居必须交代(优先于预算),没砍就只在装得下时才加这一行;`budget` 给的不是数字或比 80 还小时照不限额给,但那句话一定带出来。探针 D71–D77 钉骨架不调星图、砍邻居真发生、装得下只问一次、`neighbors=0` 不问星图,含「非数字照给不限额」与「骨架那行也超预算」两条阴性对照)、项目走向的时间信息(净差只说「变了多少」,说不出「第几次才冒出来、哪一轮归零」:`Alpha 3 → 4 → 6(+3)` 里看不出它是第三次才出现、也看不出 Beta 从第二次起就没了——所以每个项目多两句点名,`firstLive` 找第一个大于 0 的位置念「第 N 次起有数,现在 M 条」(第一格就有数的是「一直在」,不许当新出现;数组下标 0 要换成人读的第 1 次),`lastLive` 倒着找最后一个大于 0 的位置,若它后面还有格子就念「第 N 次是最后的数:M 条」——报最后一次的数,不重复写「现在 0 条」;两类各最多点 3 个,多的写「还有 N 个没列」,两种同时出现时补一句「一存一失如果条数对得上,很可能只是改名——这条走向不替你猜,要确认就翻那一轮的账看项目段名字」,因为改名与「清空一个另起一个」在条数上一模一样,区别只在内容;序列本身也要省——`compactSeq` 在超过六轮(`SEQ_HEAD 2 + SEQ_TAIL 3 + 1`)时折成「头 2 … 尾 3」,阈值卡在「折一次至少省掉两个数」,否则省略号比它省下来的还长,折了几次必须报数(`序列太长,中间 3 次用 … 省略`),不然省略号会被读成「这几次没数」;顺序固定为抬头 → 序列 → 涨/掉/都没变 → 新出现 → 消失 → 改名线索,caveats 另起(还有 N 个项目没列 → 折了几次 → 没跑完的轮 → 常驻口径),先「看到了什么」再「没看到什么」。探针 D78–D82 验八轮折叠、新出现点名、消失点名、改名提示三要素,含「平稳走向不加戏」阴性对照)、疑似冲突(关键词至少共用两个而数字/版本不同 / 不合并不自动改 / 计数与明细分开 / 0 与没查分开)、冲突跨轮追踪(往回翻十条账认老账 / 新报与重提分开 / 连报三次点名催处置 / 读不到就不表态)、冲突去向(上一轮报的、这一轮不报了——已归档 / 正文改过 / 查不到 / 两条都没动过四种去向分开说,一次只摊三对)、取代关系(写新的同时把被顶掉的旧的降格:`memory_remember` 加 `supersedes`,旧条目只标 stale + 正文留一句「(已被取代:<新 id>「<新内容前 24 字>」,日期)」,不删、还读得到、可改回 active;找不到 / 已归档 / 已标过 / 短 id 多命中 / 写库失败五种「像成功」的失败各说一句,一次最多 5 条、超出的原样报回、来源一行(读一条记忆时一并念出来路:整理封存 / 会话直写 / 老库迁移 / 没记来源会话,外加被读过几次、有没有被主人纠正过;四种来路不许合成一句,近似要写明「那次整理里封存」,读元数据不许顺手 markAccessed,没库 / 没工作区 / 找不到这条时一个字不写且不替你建空库))、检索融合(本地检索与星图扩散两路名次合成一张榜 RRF k=60:同一条只占一个位置、三种来路分开说、两路都命中的排最前;本地命中带全文、星图独有只带「为什么相关」+ 摘要;截断报「另有 N 条没展开」;预算紧时先砍星图独有那几条;本地零命中 / 星图回执解析不出 / 预算装不下都退回原来的两段式,不硬凑半张榜)、准确率量尺(40 条真实样张 × 45 条自然问句,hit@1 / hit@3 / MRR 三档聚合 + 两次阴性对照 + 可选稠密层的三态与「拆掉它逐位不变」)、注入体、加载器判据、组合产物、YAML 接线、市场索引、体检。
|
|
368
417
|
- **按句改 + 改前留一版**(0.2.157):`memory_update` 只改一句不必重发整段正文——`patch: [{find, replace}]` 的 `find` **必须唯一命中**,0 次(这版正文里没有这段)与多次(定位不到唯一一处)都**一个字都不写**并把理由原样说出来;`append` 在末尾补一段(空行分隔);改完比原文短三成以上且没带 `allowShrink: true` 就拒绝写(防「按句改」变成「整段删」,40 字以下短文本不设闸);写之前把旧正文留底(同一条最多 3 版、逐字相同的旧正文不重复记、没库不建表),`restore: 1` 退回到改之前那一版,退回时把当前这版再留一次底——退回去也是一次可退的改动;来源一行顺带念「改过几次(最近什么时候)」,只在真留过底时出现。四个参数只在融合层消费(vendor 的 schema 是 `additionalProperties: false`),不进 `pick` 白名单。
|
|
369
418
|
- **星图面板层:引力可调 + 局部图 N 跳 + 标签随距离淡出**(0.2.158):三维星图多了两组控件,**零 token**——面板是 iframe 里的静态文件(`host/http.js` 按文件服务),工具 schema 与常驻注入一个字节没动,改完刷新即生效、不用重启。**引力四个滑杆**(斥力 1200–20000 / 弹簧长度 30–200 / 项目向心 0–0.08 / 阻尼 0.6–0.96):拖动只改数字、松手才重排(每像素触发一次收敛就是把画面卡成幻灯片),参数存 `localStorage` 的 `nebula.force`;改完先丢掉那份缓存的布局再收敛,否则滑杆动了画面纹丝不动;默认值只有一份(读渲染器导出的 `FORCE_BASE`),渲染器尚未加载时的那份兜底镜像由探针逐位比对,漂了当场红。**局部图滑杆 0–4 跳**:以选中的那颗星为中心只留 N 跳以内的邻居(`neighborhoodIds` 是纯函数,0 跳=回全图,回全图传的是 `null` 而不是空集合——空集合的意思是「什么都别画」),没选中就拖会说一句「先点一颗星」;裁剪只在 `visible()` 这一处收口,检索、计数、导出照旧吃全图,「看得见」和「算得到」不打架。**标签**原来只有簇名:现在悬停/选中的那颗永远写名字,其余按重要度→度数取前 14 颗,透明度随相机距离在 1100→1900 之间线性淡出(离散阈值会在缩放时「啪」地跳一下),长标题截 18 字。三个纯函数与面板共用同一份实现,`tools/probe-nebula.mjs` 在纯 window 沙箱里真跑一遍边界值。
|
|
370
419
|
- **时间锚:问句自带版本号/日期,就按那一刻排**(0.2.159):问「0.2.146 加了什么」,答的该是那次的记录,哪怕它现在已经 stale——可打分器一直按「今天」折新鲜度与状态,于是正解被乘了 0.6 挤到第二(实测 bm25 只差 0.015,是折扣定的胜负,不是证据)。现在问句里出现 `0.2.146` / `2026-11-21` / `2026年11月` 就认一次锚,**逐条**看该条正文/标题/项目里到底有没有那个日期,有才免这两样折扣:词分、覆盖度、分档一个都不动,`status` 也不会被洗成 active(免的是排序折扣,不是「它没过期」这件事实)。读数:照抄池 45 问 hit@1 **0.911 → 0.933**、MRR 0.944 → 0.956,换说法池三项不变(口径只补时间不补词汇),锚点组 10 问 hit@3 1.000,代价是「2026-11-21 **之后**主线停在哪一版」这类区间问句从第 1 滑到第 2(仍在 hit@3 内,已知边界)。开关是 `search(q, docs, { timeAnchor: false })`,探针里就靠关掉它变差来证明这条判据没白写。**请求前缀 0 字节**。
|
|
371
420
|
- **稠密只补盲区,不并列投票(词法不想说话的时候才轮到它)**(0.2.166):词法这一族量到平台之后,剩下的错分几乎都是「词面根本没沾上」——真库换说法池里 7 道没进 top3 的题,榜首覆盖度全在 **0.072–0.142**(命中题中位 1.00),而同样的题稠密向量能把其中两道直接顶到前两名。先试了 0.2.154 的老路(并列 RRF 融合),**全面变差**:词法 0.798 的换说法池掉到 0.738、锚点 0.883 → 0.825、真库自找 0.997 → 0.954——通道之间不是「多一票更民主」,弱的一方只会给强的一方加噪,旧结论的正确性绑在当时的词法能力上。改成**先量「它自己承认不行」长什么样**:查询 top1 的覆盖度 < `DENSE_RESCUE_COVER = 0.2` 才允许稠密介入(复用 9.171/9.172 同一个覆盖度,不另立阈值),词法前 `DENSE_RESCUE_HEAD = 4` 名原样不动,其后按余弦重排且 `DENSE_RESCUE_COS = 0.45` 以下不进来,词法找到的尾巴按原序接回末尾(兜底不许把已有的弄丢)。零损失形态:**hit@1 与 hit@3 一条不动,top5 三池各 +1**——照抄 44 → 45、换说法 13 → 14(MRR 0.798 → 0.810)、真库换说 11 → 12(0.524 → 0.538),真库自找 149/150/150 不动,五池 233 题**没有一题变差**。验收时抓到一个设计错:第一版只在低覆盖时 rescue、其余仍走 RRF,于是「装了模型」这件事本身就改回执(真库自找 149 → 138);改成**词法有把握就闭嘴**,老融合保留成显式开关 `denseFuse: true`——能力不砍,只是不再默认。四道门都可收回(`denseRescue: false` / `rescueCover: 0` / `rescueHead` / `rescueCos`),收回后与没有这个功能时逐位相同;没装模型时整条路径一次都不触发。探针 **G24** 九项判据 + 四条行为 + 阴性对照,验收块 **HZ** 七条。
|
|
372
421
|
- **同一串字,有时是坐标,有时是主语**(0.2.178):真库里问「0.2.148 的时候基线收敛了两轮吗」,答案那条词分 22.29 却排第 2,被一条词分只有 8.54 的「0.2.148 已交付」压住——赢的不是词,是 `bandize()` 里的 -1 特权档:谁把版本号写进 keywords 首位,在任何提到 0.2.148 的问句下都排第一。这一版把「时间状语里的标识符」判成坐标:档位、词分加成、加法补分三条路一起关(只关一条会被另两条顶回去);判据只认结构词(的时候/那会儿/当时),泛时间词一个都不许进。宽池时间锚档 0.778 → **0.889**,照抄/换说法/真库三处零漂移。同轮试了因果证据、长度封顶、新鲜度不看重要度三个机制,读数全部否决,三道否决记录进文档——否决也是产出。
|
|
422
|
+
- **0.4.0:先把账算清,再动检索和写入两头**(0.4.0):这一版七件事,全部带读数、全部有回滚开关(另有一次 **2026-11-22 的本地 LoCoMo 检索重测**:不算这一版的功能,但读数记在 [`docs/EVAL-CLAIMS.md`](docs/EVAL-CLAIMS.md) A2——hit@20 `0.651 → 0.7546`、MRR `0.3768 → 0.4953`,全程无 LLM)。①**口径单**——新建 `docs/EVAL-CLAIMS.md`,把「现在能引用的」与「已过期不得当现状的」分成两张表:表 A 是仓库闸门读数(30 支自检 / 3,511 条断言 / 两棵树 181 个文件字节一致),表 B 是 2026-11-20 那次 LoCoMo 端到端(71.95、recall@20 0.672 等),**表 B 一条都不许当现状引用**——2026-11-20 之后检索层又动了上百个版本,这期间没有重跑过端到端评测。②**查询分解**(`multiQuery`,默认 `off`)——复合问句按「跟 / 和 / 还是 / 哪个」切成 ≤3 段子查询,各补 ≤2 行到**原榜尾部**;原榜前 N 名一个字不动(append-only 是硬约束,不是优化项),所以这条改动能给的收益是「召回别漏」而不是「名次变好」:20 题双实体实测切开 20/20、救回 1 题、hit@3 `0.900→0.900`(数学上不可能涨,补充只落尾部)、命中率 `0.950→1.000`、MRR `0.777→0.784`、延迟 p50 `0.13→0.39ms`;gold 四档两态**逐题相同**,即「关了没损失、开了没退化」。③**写入端巩固**(`consolidate: 'off' | 'suggest' | 'write'`,默认 `suggest`)——写记忆时按三个信号判断这批材料该不该收成一条事件摘要:同项目关键词交集 ≥2 的近 7 天 ≥3 条(重复模式)、该层语义条目 < 8 条(慢路有空位)、这批里还没有巩固句(未巩固)。`suggest` 只把材料端给你,**一个字不写库**;`write` 才落一条 `topic` 摘要并在被合并条目尾部加一句 `(已巩固进:…)`——`status` 一个字不动,巩固不等于作废。判据是「桩 flow 数调用」而不是「看回执好不好看」:`off` 零次检索且回执逐字节不变、`suggest` 两次检索零次写入、`write` 恰多 1 条。顺带修掉一个真退步:巩固检查的两枪检索带 `internal: true`,不写「本会话已端给你看过」的账、也不抬召回次数——否则写完一条紧接着问「跟这条像的有哪些」会得到「候选一条都没有」。④**写入端通胀体检**——`memory_admin(action="hygiene")` 从六类扩到九类,新三把尺子都量**比值**(绝对量得跟「库里应该有多少条」比,那个数没人知道):`selfecho` 关键词自证率(`keywords` 里有多少逐字出现在正文里,>0.7 报——那些词靠 BM25 本来就能命中,等于没扩召回面;关键词少于 3 个不判)、`unused` 召回闭环(命中过却一次没读过:为此在 `memory_read` 路径上新记一个 `read_count`,**只加在读路径,不加在检索路径**,否则「排进候选」会被当成「被读过」;老库从 0 起算所以刚升级会偏大,这写进了 hint)、`inflate` 层通胀(近 30 天 `fact` 条数 > 结论层 3 倍就报「写得多、收得少」,6/2 恰好 3× 不报)。`memory_read` 同时多一句抬头:正文里有巩固句时先说「这条是历史材料,没作废,但要看现在的口径读那一条」——巩固是归档(`status` 不动),与取代的退位(`status` 变 stale)必须分开说。⑤**写入端自动取代**(`autoSupersede: 'off' | 'suggest' | 'apply'`,默认 `suggest`)——meow 早就会认「同一件事的另一种说法」,但只印一句提醒,标不标 stale 全靠人;而长期库里最伤的不是「有条过期的」,是**旧结论冒充现状**。这一版把「判」与「处置」接起来:判据只吃五类硬事实(版本号不同 / 日期不同 / 状态词反转 / 同一单位的数值不同 / 同一文件名换目录),优先级也按这个序;不吃「读起来像」——代价不对称,漏报只少一条建议,误杀会安静地丢掉一条真结论。两道门槛分开:相似度 `0.3` 决定够不够格当候选,数值与路径两类另要逐字重复度 `0.5`(`3 条`、某个脚本路径这种 token 满库都是);版本/日期/状态不吃第二道。三态与巩固同一条纪律:`off` 连那一枪检索都不打,`suggest` 只把建议贴在回执尾部、**一个字不动库**并给可照抄的 `supersedes: [...]`,`apply` 才真走 0.2.117 的 `markSuperseded`,写错的值一律当 `off`(这开关会改别人记忆的状态,配错必须退到最保守)。判据是数真调用而不是看回执:`off` 零检索、`suggest` 一枪 `internal` 检索且 `memory_update` 0 次、`apply` 才 `status: 'stale'`;能红证明两条——把 `suggest` 也接上写库 → S2 红,去掉 `repeat` 门槛 → S7 红。⑥**实体层与动态跳数**(`entity` / `dynamic_hops`,默认都开;回滚另有 `NEBULA_ENTITY_LAYER=0` / `NEBULA_DYNAMIC_HOPS=0`)——星图原来只连「记忆↔记忆」,实体(项目名、文件路径、工具名、版本号)在图里**没有位置**,问「这条路径出现在哪些记忆里」既问不出也没法从查询直接跳过去。这一版把实体抽成**独立一层**(`graph.entityLayer`)而不是塞进节点:`nodes` 的口径是「记忆」,节点数、度数、孤立、聚类、召回结果位全按它算,混进 400 个实体这些读数一起改写。只收四类硬事实,四个上限防它长成第二个图(`minMembers=2` / 上限 400 / 每条最多 6 个 / 标签 ≥4 字);缓存是 JSON、`Map` 存不住,读回来按 `list` 现建索引自愈。第二件事是**动态跳数**:`hop >= 1` 时每条软边先问「这个邻居与本次查询还有没有词面关系」,低于 `0.2` 就跳过,有关系也只给 `0.45 + 0.55 × 匹配度`,而 `explicit` / `entity` / `project` 三条**硬边照走**(人工策展、同一标识、同一项目名都不是「读起来像」)。顺带修掉一个既有沉默 bug:`hops: 2` **从来没真正跑过第二跳**——`energy[]` 只在种子阶段写过,第二跳的 `e0` 恒为 0,被 `if (e0 < 0.06) continue` 整片跳过,于是 `MAX_HOPS = 2` 与「二跳再打一次」的注释一直是空的,而没有任何一条判据发现过它(探针都只问「一跳能不能捞到」)。回执三数齐报(问到几跳 / 走了几跳 / 砍掉几条邻居)——只报「省了」会掩盖「变笨了」。诚实读数:纯共激活边权重封顶 `0.440`,两跳衰减到 `≈0.049`,正好卡在合成门槛 `0.05` 下面,所以「拦掉串味邻居」省的是计算不是结果;第二跳真能产出条目靠强链路。能红证明三条:`e0` 回退 → E21/E22/E24/E31 红;去掉硬边白名单 → E23/E24 红;关层开关失效 → E29 红。⑦**共现自学习扩词**(`coocLearn`,默认开;`coocLearn: false` 退回手工表口径,`synBridge: false` 整层关)——换说法档 0.929 里有多少是人手写出来的?把同义词桥关掉只剩 **0.714**,也就是说那十八组手工词表补了 **+0.215**,而表没覆盖到的新说法一个字都不沾。这一版不再扩表,改成**跟着库自己学**:词源取每条记忆的 `keywords`(人写的真词,不是滑窗切出来的碎片),两级证据——同一条里出现的一对词记 +2,同一项目里**跨文档**各出现一次记 +1(不把项目内的并集直接两两配,否则「同条」与「同项目」会互相凑分,共享汉字的降权等于没降);三道门(出现 ≥2 次、条件概率 ≥0.25、共享汉字的对子权重降到 1)加一道形态门(2–8 字、非纯数字、英文要像标识符)。学出来的表与手工表在 `synExpandOf` 第四参合流,**只扩 query 不扩库**。第一版拿 `tokenize` 的 bigram 当词源,真库 635 条、22,956 个 token 里只有 223 个词学到扩词,全是 `地全→门读` 这种碎片,14 道换说法题零增量——那段失败读数留在源码注释里。修好之后实测:窄池换说法 0.929 不动,**宽池照抄 0.977 → 1.000、换说法 0.929 → 1.000(14/14)**,把 `coocLearn` 关掉退回 0.929 —— 增量可归因,不是池子变大的运气;真库 hit@1 0.925 不动。这里还有一个必须说的边界:桥词得先在库里出现过(`df > 0`)。「自测 / 反省 / 远端 / 仓库」这类从没被写下来的说法,任何「从库里统计」的机制都学不到——那是词典问题,不是检索问题。能红证明四条:把词源换回 `tokenize` → K1 红;项目层改回「整份并集两两配」→ K2 红;去掉条件概率门 → K3 红;关掉共现后宽池仍 1.000 → G-W4 红。
|
|
423
|
+
|
|
373
424
|
- **0.3.0:把「能自证」收成可发布的东西**(0.3.0):这一版不动检索算法,做的是把 0.2.x 一百八十轮攒下的东西收口成对外承诺。三件事:①**接口冻结**——8 个 `memory_*` 工具的名字与必填参数、1,235 字符的常驻注入、7 层 SQLite 主库布局、`plugin-market/index.json` 的 format 1,从 0.3 起只加不删(只加字段不删字段、只加工具不改名,旧调用原样能用);②**读数封版**——146 条宽池三档(照抄 44 问 **1.000** / 换说法 14 问 **0.929** / 时间锚 9 问 **0.889**)连同 24 支自检的 **3,323 条断言**一起作为发布基线,`tools/baselines.json` 记每支条数,少一条判红;③**发布面收窄**——npm 包只带 `lib` / `vendor` / `cordis.patch.yml` / `README.md`(约 2 MB,`verify.mjs` 与 24 支探针留在仓库里),装包的人拿到运行面而不是开发面;`repository` / `homepage` / `bugs` 三个字段指向 GitHub,`dsh.bundle.patch` 指向 `cordis.patch.yml`,所以 `dsh plugin add dsh-macro-memory` 免构建授权直接装。
|
|
374
425
|
- **折价要乘在分档上,不只乘在分数上**(0.2.180):0.2.179 把规矩条在缘由句里折到 0.6,照抄档打到 1.000,换说法档还停在 0.857。剩下那条最刺眼的错题是「那个跑榜单的评测台还能不能用」——正解折后 14.31、压制者折后 7.70,**分数差 1.86 倍,名次倒着**。根因在分档:`bandize()` 按 `_raw` 分档、档位优先于分数,只折 `score` 等于在一个看不见的账本上打折,折到 0.1 也翻不过去(实测那条只剩 2.385 分,仍排在 9.131 前面)。现在折价做成 `ruleFoldOf(di)` 一个 helper,三处引用同一个乘子(`_raw` 分档 / `score` 排序 / explain),两档常量:缘由句 0.6、现状句 0.3(问「还能不能用」时规矩条连问题的形状都不对)。换说法 **0.857 → 0.929**、hit@3 **0.895 → 0.952**,照抄档与时间锚档一位不动。顺带一条:讲「开个小门」的词原本躺在噪声组里,把它从噪声组挪到例外组,这一题直接翻成第一——**同一个词放进两组,会把两道题一起搅坏**。
|
|
375
426
|
- **问「为什么」和问「该怎么做」不是同一件事**(0.2.179):真库里问「评测台为什么封存」,正解那条 611 字、覆盖度 1.00、词分 10.76;压住它的是一条 102 字的规矩(「评测台禁止无预算花主人的 key…」),词分 18.45——**它一个字都没答「为什么」**,只因为同一个实体而词面全中。这一版:缘由/现状问句里规矩层折到 0.6 倍、新鲜度不折,「上限怎么设」这种问句一刀不切。宽池照抄 **0.955 → 1.000**,`causeAware:false` 一键回旧口径逐位相同。顺带留下「长度惩罚按覆盖度打折」——它扫参时读数一动不动,撤掉却掉一条(1.000 → 0.977):**判一个值该不该留,看撤掉之后的读数,不是看加上它的时候读数有没有动。**
|
|
@@ -444,12 +495,26 @@ docs/ INTERNAL.md 逐轮开发日志、images/ 配图
|
|
|
444
495
|
|
|
445
496
|
**Macro Memory** (DSH plugin, MIT) folds several memory plugins into one surface: **8 tools + a single 1,235-character standing injection**, while the storage engine stays meow-memory's seven-layer SQLite and the graph becomes a rebuildable index.
|
|
446
497
|
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
-
|
|
498
|
+
Headline numbers (v0.4.0, all reproducible offline):
|
|
499
|
+
|
|
500
|
+
- Tool schemas: 17 tools / 56,759 B → **8 tools / 13,567 B** (−76.1%).
|
|
501
|
+
- Standing prompt: 4,085 chars → **1,235 chars** (−69.8%); per-turn fixed cost ~14–16K → **~2.2K tokens**.
|
|
502
|
+
- Retrieval latency on a 1,200-memory store: **p50 2.9ms** (vs 107.2ms with three plugins stacked).
|
|
450
503
|
- Nothing was dropped: every original tool is reachable through the unified surface (audited by `tools/coverage-audit.mjs` and `tools/param-audit.mjs`).
|
|
451
504
|
- Writes land in the main store first; graph links that cannot be written are **queued, not lost** (500 entries, 7-day TTL, auto-flushed).
|
|
452
|
-
-
|
|
505
|
+
- **30 self-check suites / 3,511 executable assertions / ~220s**, and the assertion count itself is pinned per suite — deleting an assertion turns the run red.
|
|
506
|
+
- Self-built gold set (146 memories, no LLM): verbatim **1.000**, paraphrase **1.000** (0.929 with co-occurrence expansion off), time-anchored 0.889.
|
|
507
|
+
- Real local library (635 memories, 40 questions): hit@1 **0.925**, hit@5 **1.000**, MRR **0.963**.
|
|
508
|
+
- LoCoMo 1,536 questions (no LLM): hit@20 **0.7546** (old pipeline 0.651), MRR **0.4953** (old 0.3768), 17.77 average retrieved memories (old 19.99).
|
|
509
|
+
|
|
510
|
+
Why it beats stacking another memory plugin:
|
|
511
|
+
|
|
512
|
+
1. **It cuts the cost you re-pay every turn** — tool schemas and the standing injection are request prefix, so a byte saved is a byte saved on every single turn.
|
|
513
|
+
2. **Every feature has an off switch with a proven on/off gap** — query decomposition, consolidation, auto-supersede, entity layer, co-occurrence expansion, synonym bridge (`multiQuery`, `consolidate`, `autoSupersede`, `entity`, `coocLearn`, `synBridge`); default is the most conservative setting.
|
|
514
|
+
3. **One criterion, one implementation, and every criterion is proven able to fail** — no criterion is written twice with different strictness, and each one ships a fixture that must turn exactly that one red.
|
|
515
|
+
4. **Nothing new is allowed to lie** — write-side inflation checks (`selfecho`, `unused`, `inflate`) and supersede/carry-forward notes, so a stale conclusion never silently outranks the current one.
|
|
516
|
+
|
|
517
|
+
Honest limits: the gold set is self-built, not a public leaderboard; real-library numbers move as the library grows and are not comparable across time; no end-to-end LLM-judge run has been repeated since 0.4.0, so we claim no end-to-end gain.
|
|
453
518
|
|
|
454
519
|
Bundled third-party code is MIT: `meow-memory` © 2026 Phant0Meow ([source](https://github.com/Phant0Meow/dsh-meow-memory)), `dsh-memory-nebula` © 2026 the authors. See `THIRD-PARTY-NOTICES.md` for the exact list of modifications.
|
|
455
520
|
|
package/lib/index.js
CHANGED
|
@@ -24,7 +24,7 @@ import { withCost } from './macro/cost.js'
|
|
|
24
24
|
import { NEIGHBOR_DEFAULT_CHARS, NEIGHBOR_DEFAULT_MAX, createNeighborInjector } from './macro/neighbor.js'
|
|
25
25
|
|
|
26
26
|
export const name = 'macro-memory'
|
|
27
|
-
export const version = '0.
|
|
27
|
+
export const version = '0.4.1'
|
|
28
28
|
export const inject = ['tools']
|
|
29
29
|
|
|
30
30
|
/** 融合层自己的默认值;配置里可写在顶层,也可写在 macro: 段下。 */
|
|
@@ -43,6 +43,23 @@ export const MACRO_DEFAULTS = {
|
|
|
43
43
|
neighborMax: NEIGHBOR_DEFAULT_MAX,
|
|
44
44
|
/** 邻域注入那一块最多多少字符。 */
|
|
45
45
|
neighborChars: NEIGHBOR_DEFAULT_CHARS,
|
|
46
|
+
/**
|
|
47
|
+
* 查询分解(0.4.0 P1 / PLAN-0.4 §5 P1):off = 一个字都不变;conservative = 原榜不动,
|
|
48
|
+
* 只在并列/多问号句子上多查一遍,按空位补几条。写别的值(含大小写写错)一律当 off。
|
|
49
|
+
*/
|
|
50
|
+
multiQuery: 'off',
|
|
51
|
+
/**
|
|
52
|
+
* 写入端巩固(0.4.0 P2 / PLAN-0.4 §5 P2):off = 一个字都不变;suggest = 三条件成立时
|
|
53
|
+
* 在写入回执尾部贴一段「巩固材料」,**一个字不往库里写**;write = 才自动落那条摘要。
|
|
54
|
+
* 写别的值(只认这三个词,大小写与前后空格不敏感)一律当 off:配置写坏时必须退到最保守那一档。
|
|
55
|
+
*/
|
|
56
|
+
consolidate: 'suggest',
|
|
57
|
+
/**
|
|
58
|
+
* 写入端自动取代(0.4.0 P3 / PLAN-0.4 §5 P3):off = 连检索那一枪都不打;suggest = 认出「库里那条
|
|
59
|
+
* 是同一件事的旧说法」只在回执里给建议,**一个字不动库**;apply = 真把那几条标 stale。
|
|
60
|
+
* 只认这三个词,写别的值一律当 off:这个开关会改别人记忆的状态,配错必须退到最保守那一档。
|
|
61
|
+
*/
|
|
62
|
+
autoSupersede: 'suggest',
|
|
46
63
|
}
|
|
47
64
|
|
|
48
65
|
const MACRO_KEYS = [
|
|
@@ -53,6 +70,9 @@ const MACRO_KEYS = [
|
|
|
53
70
|
'neighborInject',
|
|
54
71
|
'neighborMax',
|
|
55
72
|
'neighborChars',
|
|
73
|
+
'multiQuery',
|
|
74
|
+
'consolidate',
|
|
75
|
+
'autoSupersede',
|
|
56
76
|
]
|
|
57
77
|
|
|
58
78
|
/** 宿主设置页写入后的去抖窗口(毫秒):连点几下只重建一次工具面。 */
|
|
@@ -108,6 +128,19 @@ export const Config = z.object({
|
|
|
108
128
|
neighborInject: z.boolean().default(MACRO_DEFAULTS.neighborInject),
|
|
109
129
|
neighborMax: z.number().default(MACRO_DEFAULTS.neighborMax),
|
|
110
130
|
neighborChars: z.number().default(MACRO_DEFAULTS.neighborChars),
|
|
131
|
+
/**
|
|
132
|
+
* 用 string 不用 enum:宿主设置页要把「默认值 / 用户值」两栏分开落盘,
|
|
133
|
+
* 枚举会给它一个固定候选列表,反而写不下自己那栏。合法值只有 off / conservative。
|
|
134
|
+
*/
|
|
135
|
+
multiQuery: z.string().default(MACRO_DEFAULTS.multiQuery),
|
|
136
|
+
/**
|
|
137
|
+
* 同上:string 不用 enum。合法值只有 off / suggest / write,写别的当 off。
|
|
138
|
+
*/
|
|
139
|
+
consolidate: z.string().default(MACRO_DEFAULTS.consolidate),
|
|
140
|
+
/**
|
|
141
|
+
* 同上:string 不用 enum。合法值只有 off / suggest / apply,写别的当 off。
|
|
142
|
+
*/
|
|
143
|
+
autoSupersede: z.string().default(MACRO_DEFAULTS.autoSupersede),
|
|
111
144
|
})
|
|
112
145
|
Object.assign(Config.meta, { default: {}, volatile: true })
|
|
113
146
|
|
package/lib/macro/defs/admin.js
CHANGED
|
@@ -25,9 +25,11 @@ import { cardTitle, limitOf, panelText } from '../panel.js'
|
|
|
25
25
|
// 0.2.25 起每行还带三样「口径」:label(面板的中文名,抬头与卡片标题都用它)、
|
|
26
26
|
// hint(工具描述里那一句)、defaultLimit(条数上限的默认值)。名字只写这一遍。
|
|
27
27
|
export const ACTIONS = {
|
|
28
|
-
home: { kind: 'call', label: '记忆库位置', hint: '
|
|
28
|
+
home: { kind: 'call', label: '记忆库位置', hint: '库位置/切换', call: 'memory_home', params: ['target'] },
|
|
29
29
|
stats: { kind: 'graph', label: '星图概况', hint: '星图概况', graph: 'nebula_stats', params: ['hubs'], what: '星图概况', miss: '星图概况这会儿看不了' },
|
|
30
|
-
|
|
30
|
+
// [macro-fusion 0.4.0] hint 是工具描述里的一句话摘要,九个类目在这里只留可认的缩写:
|
|
31
|
+
// 全称在 HYGIENE_META 与面板详情里,说明超 200 字会被卡片折成碎片(probe-words 的可读性尺)。
|
|
32
|
+
hygiene: { kind: 'graph', label: '记忆体检', hint: '记忆体检(重复/该更新/凑数/超重/没人读/孤立/自证/召回没读/写多收少)', graph: 'nebula_hygiene', params: ['kind', 'limit'], what: '记忆体检', miss: '记忆体检这会儿做不了', guard: guardHygiene },
|
|
31
33
|
sources: { kind: 'graph', label: '记忆来源', hint: '记忆来源', graph: 'nebula_sources', params: ['verbose'], what: '记忆来源', miss: '记忆来源这会儿看不了' },
|
|
32
34
|
ingest: { kind: 'graph', label: '外部记忆推入', hint: '推入外部记忆', graph: 'nebula_ingest', params: ['provider', 'items'], what: '外部记忆推入', miss: '这批外部记忆一条都没推进去', guard: guardIngest },
|
|
33
35
|
cost: { kind: 'local', label: '成本账本', hint: '成本账本', params: ['limit'], defaultLimit: 200 },
|
|
@@ -36,14 +38,14 @@ export const ACTIONS = {
|
|
|
36
38
|
dream: {
|
|
37
39
|
kind: 'local',
|
|
38
40
|
label: '整理留痕',
|
|
39
|
-
hint: '
|
|
41
|
+
hint: '整理账:看到几条、点出几对、缺几个词(按项目/日期筛)',
|
|
40
42
|
params: ['limit', 'page', 'id', 'project'],
|
|
41
43
|
defaultLimit: 5,
|
|
42
44
|
},
|
|
43
|
-
links: { kind: 'local', label: '待补连线', hint: '
|
|
45
|
+
links: { kind: 'local', label: '待补连线', hint: '待补连线队列(写时没连上、读时自动补)', params: ['limit'], defaultLimit: 20 },
|
|
44
46
|
// wrap: false —— 全表唯一豁免:手册是长文,没有「条数/时间窗」这种口径可报,
|
|
45
47
|
// 而且要让它第一行就是门牌(「宏记忆有三个面」),多加一行抬头反而把它埋了。
|
|
46
|
-
guide: { kind: 'local', label: '完整手册', hint: '
|
|
48
|
+
guide: { kind: 'local', label: '完整手册', hint: '完整手册(含星图规则)', params: [], wrap: false },
|
|
47
49
|
}
|
|
48
50
|
|
|
49
51
|
/** 工具描述:面板清单由表生成,少写一遍就少一处能漂的地方。 */
|
|
@@ -141,7 +143,7 @@ function guardIngest(args) {
|
|
|
141
143
|
* 看到的是「共 12 项 + 一行 0」,会读成「孤立这一类是 0 条」,真实是「这一类根本没查」。
|
|
142
144
|
* 所以在入口按白名单校验并归一(大小写、前后空格),不认识的一次都不往下发。
|
|
143
145
|
*/
|
|
144
|
-
const HYGIENE_KINDS = ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan']
|
|
146
|
+
const HYGIENE_KINDS = ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan', 'selfecho', 'unused', 'inflate']
|
|
145
147
|
|
|
146
148
|
/**
|
|
147
149
|
* [macro-fusion 0.2.91] 体检里的「相似 N」和工具里的「逐字重复度」不是同一个量。
|
|
@@ -233,7 +235,8 @@ function projectOf(raw) {
|
|
|
233
235
|
return text
|
|
234
236
|
}
|
|
235
237
|
|
|
236
|
-
function guardHygiene(args) {
|
|
238
|
+
function guardHygiene(args) {
|
|
239
|
+
if (args.kind === undefined || args.kind === null) return
|
|
237
240
|
const raw = String(args.kind)
|
|
238
241
|
const name = raw.trim().toLowerCase()
|
|
239
242
|
// 空串=没给:星图那边只判真假,空串会走「全部概览」,与缺省同义。
|
|
@@ -241,7 +244,7 @@ function guardHygiene(args) { if (args.kind === undefined || args.kind === null
|
|
|
241
244
|
if (!HYGIENE_KINDS.includes(name)) {
|
|
242
245
|
throw new Error(
|
|
243
246
|
`memory_admin:action="hygiene" 的 kind 只认 ${HYGIENE_KINDS.join(' / ')}(大小写不敏感,前后空格会去掉),给的是「${raw}」。\n` +
|
|
244
|
-
|
|
247
|
+
`不传 kind 就返回全部 ${HYGIENE_KINDS.length} 类概览。\n` +
|
|
245
248
|
'这次体检没有跑——别把「没跑」读成「这一类没有问题」。',
|
|
246
249
|
)
|
|
247
250
|
}
|
|
@@ -337,7 +340,7 @@ export function createAdmin({ flow, bridge, config = {}, meowDir = () => '.dsh-m
|
|
|
337
340
|
action: { type: 'string', enum: Object.keys(ACTIONS), description: '要看的运维面板。' },
|
|
338
341
|
target: { type: 'string', description: 'action=home:目标位置(预设名 default/dsh-storage/plugin-root 或绝对路径)。' },
|
|
339
342
|
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 只看某一类。' },
|
|
343
|
+
kind: { type: 'string', enum: ['dup', 'stale', 'thin', 'oversize', 'unread', 'orphan', 'selfecho', 'unused', 'inflate'], description: 'action=hygiene 只看某一类。' },
|
|
341
344
|
page: { type: 'integer', description: 'action=dream 翻到第几页(从 1 起,每页 limit 条;越过最后一页会退到最后一页并说出来)。' },
|
|
342
345
|
id: { type: 'string', description: 'action=dream 展开一条账。两种写法:"3"/"#3" 是第几近(1 = 最新,随新账往下挪);"r128" 是账本引用(每行末尾那个号,不挪,回指某一轮用它)。摊开摘要、备注、项目段、对子、库规模与 changes 原文。' },
|
|
343
346
|
project: { type: 'string', description: 'action=dream 只列某个项目段的账(按 changes.plan.projects 里的名字原样匹配;不列出项目分布,编号改为「筛出来那几条里的第几近」)。' },
|
package/lib/macro/defs/read.js
CHANGED
|
@@ -16,6 +16,21 @@ const SKELETON_HEAD = 120
|
|
|
16
16
|
const NEIGHBOR_LADDER = [6, 3, 1, 0]
|
|
17
17
|
const LADDER_TRIES = 3
|
|
18
18
|
|
|
19
|
+
/**
|
|
20
|
+
* [macro-fusion 0.4.0] 正文里带巩固句时,抬头先说清「它是材料,不是现状」。
|
|
21
|
+
*
|
|
22
|
+
* 与 successionNote 的区别是「退位」和「归档」的区别:取代会改 status(读到它基本是走错门),
|
|
23
|
+
* 巩固不改 status(这条还活着,细节只在这里,只是结论已经收到别处去了)。所以两句话不能合并:
|
|
24
|
+
* 把巩固说成「已作废」会让人不敢用这条的细节,把取代说成「已归档」会让人以为结论还在原处。
|
|
25
|
+
*/
|
|
26
|
+
const CONSOLIDATED_RE = /(已巩固进:([0-9a-z]{8})(?:「([^」]{0,40})」)?,(\d{4}-\d{2}-\d{2}))/i
|
|
27
|
+
export function consolidatedNote(content) {
|
|
28
|
+
const m = String(content ?? '').match(CONSOLIDATED_RE)
|
|
29
|
+
if (!m) return ''
|
|
30
|
+
const target = m[2] ? `${m[1]}「${m[2]}」` : m[1]
|
|
31
|
+
return `这条是历史材料(${m[3]} 被收进 ${target}):它没作废,细节只在这里;但要看现在的口径,读那一条。`
|
|
32
|
+
}
|
|
33
|
+
|
|
19
34
|
export function createRead({ flow, meowDir = () => '.dsh-meow' }) {
|
|
20
35
|
return {
|
|
21
36
|
name: 'memory_read',
|
|
@@ -58,7 +73,7 @@ export function createRead({ flow, meowDir = () => '.dsh-meow' }) {
|
|
|
58
73
|
dir: typeof meowDir === 'function' ? meowDir() : '.dsh-meow',
|
|
59
74
|
id: args.id,
|
|
60
75
|
})
|
|
61
|
-
const extras = [prov, chain].filter(Boolean).join('\n')
|
|
76
|
+
const extras = [consolidatedNote(main.value?.content), prov, chain].filter(Boolean).join('\n')
|
|
62
77
|
if (extras.length > 0) said = `${said}\n\n${extras}`
|
|
63
78
|
// [macro-fusion 0.2.62] 以前这里先把 neighbors 塞进 Number(),再拿「不是有限数、或者
|
|
64
79
|
// 小于等于 0」做一句提前返回:非数字、负数、你自己要 0 三种情况压成同一个结果——
|