Skip to content

Commit 8c9a87c

Browse files
committed
merge origin/main into feat/622-peak-hours-observability
#630 合入后 main 再前进,重新 merge。冲突两处: - CHANGELOG.md:#622 条目与 #630/#557 条目都是新增段,拼接保留双方。 - test/client.test.js:两侧各追加了一整个 test() 块(#622 的错峰可见性锁、 #558 的引导任务存活锁),块之间无共享变量,两个都保留。 验证:npm test 3231 用例 / 3230 通过 / 0 失败 / 1 跳过。
2 parents 0d1c48a + 60c2139 commit 8c9a87c

19 files changed

Lines changed: 641 additions & 149 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,32 @@
1111
- **单一口径(`src/peak-hours.js`)**:新增 `PEAK_SPEC_KEYS` + `invalidPeakSpecs(cfg)`——告警点与提示点认同一份键表,helper 只转述 `parsePeakSpec` 的话:等价类归一(PR #621,评审中)落地后救得了的写法自然不再告警,两批无需联动。
1212
- **验证**:`test/peak-hours-observability.test.js` 新增 3 条(helper 只报「非空且解析失败」+ 接线锁:启动告警读装配后的 cfg 且不改写它 + 解析语义原样未动);`test/api.test.js` 新增 1 条(GET/PUT 的 `invalidPeakHours` 与 helper 同源、合法/空串不报);`test/client.test.js` 新增面板锁(提示行走服务端字段、反拷贝锁匹配调用形态、i18n 双语键)。全量 3159 用例 / 3158 通过 / 0 失败 / 1 跳过;check-sync 通过。
1313

14+
15+
- **记忆面板的「共 N 条」与分类 chip 改读服务端真分布(#597)**。浏览页被 type 筛过又分了页,页内现数两头都数不出真分布:页头「共 N 条」用 `visible.length`(滚动一次后恒停在 200),分类 chip 从已加载页现数——选中任一类后其它类计数为 0 被整条滤掉,分类栏塌剩两枚、数字从 5 跳到 200。
16+
17+
- **服务端**:`store.count()` 的 WHERE 构造抽成共用的 `pushCountFilters`,新增 `countByType(opts)`(同一份筛选、**不带 type**,一次 GROUP BY 拿全库分布);宿主内 `/api/dsh-mneme/list` 与 Bearer `/memories` 两张面同口径补 `typeCounts` 格(按 id 取单条的答复不带——分布无意义,客户端据此降级)。
18+
- **客户端**:页头 = 服务端 `total`(搜索态的 total 本就是命中数);chips = `typeCounts` 全库分布、缺类补 0(选中一类后分类栏恒定不塌);「全部」chip = 分布合计(不再从 5 跳到 200)。老服务端没有 `typeCounts` 时退回页内现数——功能不炸,只是回到旧的「只数已加载页」行为。
19+
- **验证**:`test/store.test.js` +1(分布合计恒等于 `count(undefined)`、筛选同口径);`test/api.test.js` / `test/standalone-api.test.js` 各 +1(带 type 请求下分布仍全量、合计 = total);`test/client.test.js` +1 源码断言(服务端源 + 降级路径同时在)。顺带一提:状态页 `MemoriesStatusCard` 的每类一次请求(N+1)是同一痛点的另一处,可后续切到 `typeCounts`,不在本 PR。
20+
21+
- **仓库地志侧栏入口改旗标门控:`chorographyEnabled` 关着(默认)时侧栏不再常驻那一格(#598)**。此前侧栏座位无条件注册(P11),从没用过地志的用户侧栏永久多一个图标、点进去只有一句「未启用」。
22+
23+
- **成对规则拆成两半**:`main`(key `"dsh-mneme-wiki"`)**无条件保留**——#562 那堵墙(布局存着 `activePanelId="dsh-mneme-wiki"` 时少注册 main,宿主 selectPanel 直接抛);侧栏 glyph 的登记挪进座位闸,与 M.O.(v0.9.0)/日记(v0.13)同一形态——读一次 `/features`、fail-closed(读不到就不注册,不猜)、开关改动重启生效。
24+
- **提示文案跟着说准**:两语言 hint 的「关着时它们全部不存在」现在包括侧栏入口(此前这句与实现不符,正是 #598 的另一半)。
25+
- **kb 座位刻意不动**:契约 §3.6 选的是「入口常驻 + 空态自解释」(#607 的另一种写法),两种形态并存是 #598 评论区 §四的拍板;独立开关(issue 建议②)是已排期的 D2 形态,不在本 PR。
26+
- **验证**:`test/client.test.js` 座位闸断言重写(main 无条件 / glyph 在闸内 / fail-closed / panellist 清理扫帚少了 wiki glyph);panellist 结构测试更新(无条件集合只剩记忆 + kb 两对 glyph,main 仍三份)。
27+
28+
- **引导请求不再被 tab 关闭吞掉:任务态搬到模块级,重开标签页回放结果(#558)**。面板「⋯ → 从目录引导」的请求在飞时关掉整个 better-sidebar 标签页,MemoryExplorer 与引导弹层随标签页体一起卸载——keepMounted 覆盖隐藏与切视图、**不含关闭**(它自己的设计文档写明「记录的寿命只由原生 tab 关闭与会话消失回收」)。请求照样跑完、行照样落库(三元组去重 + _overwrite 刷新,重复执行不写坏数据),但成功/失败提示没地方显示、忙碌态也丢了,重开还能再提交一次。
29+
30+
- **状态住模块级(`lib/client.js`)**:新增 `bootstrapJob` store(phase: idle/running/done/failed + dir/result/error)与 `useBootstrapJob` 订阅钩子——就是 `overlayListeners`/`setOverlayOpen` 的现成形状。busy/msg/err 全部从 store 派生,弹层只是任务态的视图;prop 钻孔链(弹层 → explorer → overlay 的 `onBusyChange` 三段)整条拆掉,MemoryOverlay 的 Esc/背板/✕ 三条关闭守卫改为直接订阅——**顺带修掉 tab 注册路径守卫为空的老缺口**(那条路径没有 onBusyChange,busy 从来报不上去)。
31+
- **存活规则一条:「只存活用户没来得及看的那一份」**。卸载发生在 running 时(tab 关闭 / 切视图),结果还没人看过——terminal 化发生在卸载之后,这份留给重开回放;卸载时已是 done/failed(用户见过),explorer 的卸载兜底把它回 idle,保持「重开是干净弹层」的既有行为。人看得见的关闭(取消 / 自动收口 / ⋯ 菜单收起)都显式回 idle 并保留目录(重试同目录是最常见的下一步,输入框从上次的 dir 播种)。
32+
- **弹层的两处跟随调整**:① terminal 化只写 store——tab 关闭后结果落地时组件已卸载,写 store 才有人接(这正是要修的路径);② fresh done 的 900ms 阅读窗锁提交钮但**不锁取消**——旧实现靠 busy 连 cancel 一起锁,那时 busy 是本地 state 必然随组件解锁;现在 done 是 store 态、可能被重开回放,取消若也锁死,旧结果会把弹层永久焊住。
33+
- **同步性顺带变强**:旧链的「同步报 busy」靠回调在渲染提交前追那一拍(#4452539705);现在 `setBootstrapJob(running)` 一落,三处订阅者同步被唤醒,那一拍不存在了。
34+
- **验证**:`test/client.test.js` 更新两条旧锁到新形状(⋯ 收起连带回 idle、overlay 从 store 派生 busy)+ 新增 #558 专项锁(模块级 store、弹层为视图、存活规则、fresh-done 与回放的按钮差异、terminal 只写 store);全量 3155 用例 / 3154 通过 / 0 失败 / 1 跳过;check-sync 通过(client.js 是 lib-only 手写件,无 src 对应物)。
35+
36+
- **选择性遗忘 × 事实更正的根因定案:失效关系在 dream 第一次运行之前不存在(#532,分析文档 + 行粒度警示)**。#532 的现象——更正两个事实、只忘一个、保留的那个答回更正前的旧值——不是某一行写错,而是三段契约的接缝:更正由蒸馏落成**新行**(`(type,title,scope)` 三元组不命中;清理并存的 dream 冲突裁决是阈值门控的,现场 0 次)→ `memory_forget` 是**行粒度**的(接口契约:按 ID 翻 `forgotten` 标志)→ 合流在新值行里的其他事实连带退出可见面,旧值行成了唯一幸存载体。三个确认请求在 `docs/FORGET.md` 逐条给出源码级回答:**Q1** 更正/遗忘的推荐操作顺序(update 原行 / archive 旧行 / 遗忘前先 get 看行里还装着什么);**Q2** 旧行与新行之间没有任何持久链接——失效关系今天只存在于 document supersede(#230)与 dream 冲突裁决两处,普通蒸馏行在 dream 首跑前无失效关系,历史回溯与当前答案也无法机械区分;**Q3** 配置无遗漏,现象在当前 main 上结构成立。修复方向(蒸馏拆分粒度 / 写侧更正失效关系 / dream 触发前移 / 遗忘回执带同侪提示)的取舍涉及 LLM 判断进哪条路径,按 R2/R3 纪律列表待拍板,本 PR 不擅自实现。
37+
38+
- **本 PR 落地两件零争议的**:① `memory_forget` 工具描述补行粒度警示(抑制的是一行——合流事实连带退出;请求只针对一个事实时先 `memory_get` 看行、`memory_update` 拆分或在回复里说清连带)——这是 #532 对话 5 模型误用的直接对策,模型无从得知语义粒度与能力粒度的落差,除非描述告诉它;② `docs/FORGET.md`(已挂 README 文档表)含**零 LLM 的最小合成轨迹**(议主要求的最小复现:`test/forget-corrections.test.js` 四步断言,存储层等价物,机制修复落地时第 ⑤ 条翻转——注释写明翻转条件,防止被当成「永远该绿」的现状锁)。
39+
- **验证**:`test/forget-corrections.test.js` 新增 2 条(合成轨迹 + 描述锁锁语义不锁逐字);全量 3156 用例 / 3155 通过 / 0 失败 / 1 跳过;check-sync 通过。
1440
- **dream 审计行输入快照瘦身(#557 建议 2,opt-in 默认关)**。`dream_runs.input` 的单行体积随记忆量涨(#557 实测平均 40-79 KB/轮,绝大部分是 content),轮数又随天数涨,两者相乘超线性增长(报告库占 43% 的页;`recall_runs` / `llm_audit_logs` 都有保留期与回收口,这张表只有手动 reclaim 一个口)。新增 `dreamInputSummaryEnabled`(默认 false = 审计行逐字节一致):开启后 auto 轮的快照只落骨架(id/type/title/importance/updated_at,不含 content)。
1541

1642
- **判定与回执不受影响**:巩固的 LLM 输入由记忆库现算、`snapshot_hash` 在内存里对含 content 的快照计算,两者都不经过落库副本——prompt 与 receipt 完整性不变;变的只是离线回放(原文不在库里就重算不出 hash,#512「每一行都能回放一次巩固」对瘦身轮降级为骨架级)。

‎dsh-mneme/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -765,6 +765,7 @@ npm run sync # 把 src/ 同步到 lib/(发布时由 prepack 钩子自动
765765
- [连续性抢救(#249 N3):触发器口径与事件契约](docs/CONTINUITY.md)
766766
- [Sleep Mode:空闲四阶段深度维护](docs/SLEEP.md)
767767
- [存储与回收:表结构、保留期、`dsh-mneme reclaim`](docs/STORAGE.md)
768+
- [选择性遗忘与事实更正:行粒度契约与失效关系缺口(#532)](docs/FORGET.md)
768769
- [记忆分享包:出包与收包的口径、信任边界与实测(`dsh-mneme share` / `receive` / `undo-share`)](docs/SHARE.md)
769770
- [独立服务 daemon(`dsh-mneme-serve`)](docs/DAEMON.md)
770771
- [与 Zep / Graphiti / Mem0 / Letta / Hindsight 的能力对比](../docs/COMPARISON.md)

‎dsh-mneme/docs/FORGET.md‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# 选择性遗忘与事实更正(#532)
2+
3+
> 这篇回答 #532 的三个确认请求:现象的根因链、当前机制能承诺什么、以及修复方向需要维护者拍板的取舍。全部结论出自 `main`(514d238)源码逐行核实与一个**零 LLM 的合成轨迹**——不需要真实用户库,任何人按 §4 的步骤能在空库上重现同一结构性结果。
4+
5+
## 1. 现象与根因链
6+
7+
#532 的观察:更正两个事实(颜色 + 整理时间)→ 只要求忘掉颜色 → 新对话里颜色确实不知道,**但整理时间答回了更正前的旧值**。
8+
9+
根因是三段机制的接缝,每一段单独看都符合自己的契约:
10+
11+
1. **更正落成新行,旧行保持活跃。** `autoSummarize` 写入走 `saveWithDedupe` 的 `(type, title, scope)` 三元组去重——更正行的标题与原行不同(蒸馏器按内容起标题),去重不命中,于是**同一事实的两个版本同时活跃**。会清理这种并存的是 dream 的冲突裁决(loser 归档)——但它是阈值门控的(`dreamThresholdCount` 默认 100,#532 现场 13 条、`dream_runs` 0 行,裁决从未运行)。`summarizeDedupeMode`(#127,默认 off)帮不上:它只在**同会话**的时间窗内并(`findSessionDuplicate` 按 `type+source+时间窗` 找候选),而 #532 的更正发生在另一个会话。
12+
2. **`memory_forget` 是行粒度的。** 它按 ID 翻 `forgotten` 标志(抑制注入/检索/列表,原文留存可恢复)——这是接口契约,**不是**「忘掉某个事实」:事实散在几行里,它就只管被点名的那一行。#532 的更正把两个新值合流在一行(蒸馏器把「颜色改成浅橙色 + 时间改成周六 09:00」写进同一条),忘掉「颜色」的操作抑制了这一行,**新的整理时间跟它一起退出可见面**。
13+
3. **旧值行成了唯一幸存的载体。** 旧值(雾蓝色 + 周三 20:00)至少还活在另一行里(6 次蒸馏 × 每次 ≤3 条 = 13 行的库完全装得下独立的旧时间行)。新值行被抑制后,检索/注入面只剩旧值行——模型如实回答了它唯一能看到的东西。旧值行里同样有旧颜色,模型答「不知道颜色」是因为该行也已被抑制(或未入召回窗)——两半行为各自都有解释,合起来才是「保留的更正事实答回旧值」。
14+
15+
**一句话定性:这不是某一行写错了,而是「更正的失效关系」在 dream 第一次运行之前根本不存在。** 旧行与新行之间没有任何持久链接,任何一方的隐藏都不会波及另一方;趁虚而入的是结构,不是某个 bug 的触发。
16+
17+
## 2. 三个确认请求的源码级回答
18+
19+
**Q1:更正两个事实、只忘一个时,推荐怎样保住另一个?**
20+
21+
当前机制下的推荐做法(不需要新配置):
22+
23+
- **更正时点名旧行**:用 `memory_update` 直接改原行的内容(同标题走 `saveWithDedupe` 的更新分支,`content_history` 留痕),或用 `memory_archive` 归档旧行后再让新事实自然入库——归档可恢复,且两行不再并存。
24+
- **遗忘时按行操作并核对行内容**:`memory_forget` 之前先 `memory_get` 看这一行还装着什么;一行装着多个要分开处置的事实时,`memory_update` 先拆、再对单行遗忘。
25+
- 工具描述已补一句行粒度警示(本 PR):模型在「忘掉 X」的请求下,应当先意识到一行可能载着多个事实,并在回复里说清它抑制的是哪一行、连带了什么。
26+
27+
**Q2:更正所取代的旧事实,有没有持久失效关系,使隐藏新条目后旧值不会重新成为当前答案?**
28+
29+
**没有——这是插件层面的真实缺口,不是配置遗漏。** 失效关系今天只存在于两处:① `memory_register_document` 的同路径/同标题 supersede(#230,只覆盖 document 行);② dream 冲突裁决的 loser 归档(阈值门控)。普通蒸馏行在 dream 第一次运行之前,旧行与新行之间**没有任何链接**。历史回溯与「当前答案」也因此无法区分:检索面对两行一视同仁,先后关系只体现在 `updated_at` 的排序权重里——模型答对(如 #532 对话 C)靠的是模型自己对比两行,不是机制保证。
30+
31+
**Q3:配置是否遗漏了该语义必需的原生设置?**
32+
33+
没有。`lightMode` / 阈值配置都在正常范围内;0.9.5 的已发变更(溯源读出口 #509、蒸馏围栏 #501、merge 逃生门 #521 等)都不触碰这条接缝。**#532 报告的现象在当前 main 上结构性地成立**,与 0.9.4 还是 0.9.5 无关。
34+
35+
## 3. 修复方向的取舍(需要维护者拍板,本 PR 不擅自实现)
36+
37+
| 方向 | 能修掉什么 | 代价 / 风险 |
38+
|---|---|---|
39+
| **A. 蒸馏提示词拆分粒度**(一事实一条) | 合流行被整条遗忘的连带伤 | 提示词级、行为面全变;行数增多(注入预算/检索排序全受影响);LLM 遵从度不确定 |
40+
| **B. 写侧更正失效关系**(蒸馏窗口内识别「同主题改值」→ 归档被取代行) | Q2 的缺口本体 | 「同主题」判据是 LLM 判断(dream 冲突裁决同款),放写入热路径要配阈值与误杀面测量——正是 dream 已经在做的事,重复建一套不如把 dream 的触发条件前移 |
41+
| **C. dream 触发前移**(更正类写入直接计 dream 优先级 / 降低阈值) | 让现成的裁决机制更早介入 | dream 有成本(LLM 调用);「更正类写入」的确定性判据同样不存在 |
42+
| **D. 遗忘回执带同侪提示**(`memory_forget` 答复列出同 type+scope 的高相似活跃行) | 让模型在遗忘当下看到「别处还有旧值」 | 相似度判据要么依赖嵌入(可能未配)、要么是弱启发(误报面要测);对已发生的遗忘只是事后提示 |
43+
44+
本 PR 只落地了零争议的一小块(工具描述的行粒度警示,见 §5);A–D 的取舍涉及 LLM 判断进入哪条路径、误杀面怎么量,按 R2/R3 纪律停下等人拍板。
45+
46+
## 4. 有界复测的最小合成轨迹(零 LLM)
47+
48+
不依赖任何模型行为,直接用存储/服务层复现「更正落新行 → 遗忘新行 → 旧值行幸存」:
49+
50+
```js
51+
// 空库;严格 scope 不影响本现象,默认配置即可
52+
const store = createStore(":memory:");
53+
const service = createService({ store, mirror: null, config: {} });
54+
// ① 原始陈述(模拟对话 A 的蒸馏产物:颜色 + 时间合流一行)
55+
const r1 = service.saveWithDedupe({ type: "preference", title: "纸模工具的收纳与整理",
56+
content: "纸模工具放在雾蓝色收纳盒,每周三晚上八点整理一次", importance: 3 });
57+
// ② 更正(模拟对话 B:标题由蒸馏器另起 → 三元组不命中 → 新行)
58+
const r2 = service.saveWithDedupe({ type: "preference", title: "收纳盒颜色与整理时间的更正",
59+
content: "收纳盒换成浅橙色,整理时间改为每周六上午九点", importance: 3 });
60+
// ③ 结构断言:两行同时活跃,二者之间没有任何失效链接
61+
const activeCount = () => store.db.prepare(
62+
"SELECT COUNT(*) AS n FROM memories WHERE forgotten = 0 AND archived = 0"
63+
).get().n;
64+
assert.equal(activeCount(), 2);
65+
// ④ 「忘掉颜色」= 按行遗忘新值行(模型在 R1/R2 里看到的颜色载体)
66+
service.setForget(r2.memory.id, true);
67+
// ⑤ 现象复现:新值行退出注入/检索面后,旧值行仍是唯一幸存载体
68+
assert.equal(store.getById(r1.memory.id).forgotten, false, "旧行从未被任何机制波及");
69+
assert.match(store.getById(r1.memory.id).content, /每周三晚上八点/, "旧值仍在召回面");
70+
```
71+
72+
完整可跑版本见 `test/forget-corrections.test.js`(本 PR 附),其中 ④⑤ 两条断言就是 #532 现象的存储层等价物——机制修复(§3 的 B/C)落地时,这条测试的 ⑤ 应当翻转:更正行写入后,旧行要么被记上失效关系、要么退出活跃面;遗忘新行不应让旧值重新成为「当前答案」。
73+
74+
## 5. 本 PR 落地的零争议部分
75+
76+
- **`memory_forget` 工具描述补行粒度警示**(`src/tools.js`):「抑制的是**一行**——多个事实合流在同一行里时,它们会一起退出可见面;请求只针对其中一个事实时,先看行内容、用 `memory_update` 拆分或在回复里说清连带了什么」。这是 #532 对话 5 里模型误用工具的直接对策:请求的语义粒度(一个事实)与工具的能力粒度(一行)之间的落差,模型无从得知,除非描述告诉它。
77+
- **本文档**与 §4 的合成轨迹测试。

‎dsh-mneme/lib/api-standalone.js‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -478,7 +478,10 @@ export function createStandaloneApi({ service, store, config = {}, logger, setti
478478
const listFilters = { includeArchived, ...(occurredFrom ? { occurredFrom } : {}), ...(occurredTo ? { occurredTo } : {}) };
479479
const items = service.toApiList(service.list({ type, limit, offset, order, minImportance, source, ...listFilters }));
480480
// Total honors the same filters so pager math stays correct.
481-
sendJson(res, 200, { items, total: service.count(type, { minImportance, source, ...listFilters }) });
481+
// #597:typeCounts 与宿主内 /list 同口径(同一份筛选、不带 type 的全库分布),
482+
// 两张面只许剩鉴权与路径不同。
483+
const countFilters = { minImportance, source, ...listFilters };
484+
sendJson(res, 200, { items, total: service.count(type, countFilters), typeCounts: service.countByType(countFilters) });
482485
return;
483486
}
484487

0 commit comments

Comments
 (0)