Skip to content

Commit 8f256dd

Browse files
committed
Merge origin/main into fix/532-forget-stale-facts
CHANGELOG 保留 main 的 #557/#582/#653 条目与本分支 #532 条目;lib/ 与 src/ 对齐。
2 parents 1dcf83c + 71c5c11 commit 8f256dd

18 files changed

Lines changed: 2217 additions & 1451 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@
33
## [Unreleased]
44

55
- **取代链与遗忘的接缝修好了:继任者被 `memory_forget` 之后,被取代的旧值不再回潮成为「当前答案」(#532 存储层半边)**:#532 主楼的现象是「更正两个事实、只忘一个,保留的那个答回更正前的旧值」。`docs/FORGET.md` 的定案把根因拆成三段接缝(更正落新行且旧行活跃 / `memory_forget` 行粒度 / 旧值行成了唯一幸存载体),其中第二、三段的交互有一个**确定性**缺陷:`#650` 给 `supersededIds()` 加的守卫把「继任者归档、遗忘、删除」统一当成「继任者退场」,于是继任者一旦被遗忘,被它取代的旧行就重新回到注入面——而 `memory_forget` 的语义恰恰是「我不要再记得这个内容」,让用户明确抛弃的旧答案借继任者的退场回潮,正是本报的现象。现在两种情况分开:**遗忘继任者**不再恢复旧行可见性(旧行仍留在 suppressed 集合里、注入面不选它,但显式搜索照旧读得到——`fuseRecall` 只降权 0.5,不是沉默的不可逆失效);**归档继任者**维持 #650 原语义恢复可见(归档是整理面退场、可恢复、且常是合并落点,旧行可能是唯一载体),并加回归锁防止这条修正顺手改掉它。`memory_forget` 的回执同时报出连带面:新增只读 `store.supersedeContext(id)`(`{ supersededBy, predecessors }`)经 service 透传,抑制一行时若它取代过 N 条更早的记忆,回执明写「它们保持隐藏(显式搜索仍可达)、不应被当成当前值」——模型不必自己猜;恢复与无链行不渲染那句话。**明确没修的部分**(写进 `docs/FORGET.md` §5,别读成闭环):没有取代链的库(dream/sleep 未运行或 `conflictLedgerMode` 关着)里 `memory_forget` 依旧行粒度,§4 合成轨迹的「旧值幸存」断言依旧成立——写侧自动识别「同主题改值」需要 LLM 判断进热路径,仍按 R2/R3 等排期。回归测试 7 条(遗忘继任者旧行保持抑制且不入注入面 / 显式搜索仍可达 / 恢复继任者后仍抑制 / 归档继任者按 #650 恢复 / 回执报连带面且恢复时不报 / `supersedeContext` 空行返回 null 与计数只认指向本行的行 / **旧装配缺 `supersedeContext` 时回执降级、遗忘本身照常完成**)。最后一条补齐了审计发现的一处健壮性缺口:工具层原本裸调 `service.supersedeContext`,旧装配或手写测试替身没有该方法时会抛 `TypeError` 把整条遗忘操作打掉——回执增强不该有否决权,现按「无链信息」降级(与 `service.js` 的 store 层守卫对称)。变异自证 5 例(把 `forgotten = 0` 条件加回去 → 1 红;去掉 `archived = 0` 守卫 → 1 红;回执 `predecessors` 恒 0 → 2 红;恢复时也渲染连带面 → 1 红;删掉工具层 `typeof` 守卫 → 1 红),恢复后全绿。**评审补丁(PR #681,两条 Minor)**:回执只承诺「现在真的成立」的事——`supersedeContext` 增 `chainActive`(与 `supersededIds` 同判据:继任者被归档 ⇒ 旧行已恢复可见,不再声称被压住)与 `activePredecessors`(仍活跃的前序条数);渲染句改成「不计为当前值」,可查承诺只给活跃的那部分(`the N that remain active`),全退场时不作可查承诺。变异自证 3 例(归档后仍称链生效 / 可查计数不筛活跃 / 渲染不看 `chainActive`)逐条变红。
6+
- **设置页加搜索:一张框扫全部组,两层折叠里的行也够得到(#653)**:设置页攒到 30+ 个开关后,「新增功能找不到入口」成了反复出现的抱怨(#607 的知识库、#653 的原话「浏览器的搜索功能在设置页面也搜不到『知识库』」)。浏览器 Ctrl+F 搜不到的机理很具体:**收起的组根本不在 DOM 里**——「全部设置」与「高级」两层折叠把不渲染的行藏在了 React 树之外,页内查找无从谈起。修法是在设置页顶部加一个常驻搜索框:有词时目录(#518)让位(跳转目标多半已被过滤掉,留着只会点到没反应),五组卡片按节过滤——**组标题或该组任一卡标题命中则整节原样显示**(搜「连接」应该看到全节而不是几行),**功能开关卡则切成命中行平铺**,两层折叠被绕开:折叠里的行恰恰是搜索最该够到的地方。行目录从六张常量表拼出来(`FEATURE_GROUPS` / `FEATURE_CHILDREN` / `FEATURE_ADVANCED_BOOLS` / `FEATURE_ENUMS` / `FEATURE_STRINGS` / `FEATURE_NUMBERS`),刻意不立第二份清单——任何一张表被绕开,那一层的行就从搜索里消失;四个没有通用渲染器的枚举键(embedProvider / 思考强度×2 / 地志档位)经 `SEARCH_ENUM_SOURCES` 补登记,取值直接引用各自已有常量。搜索分支的行渲染器与正常视图**同一份**(`boolRow`/`enumRow`/`strRow`/`numRow`,`enumRow` 为此加了 `valuesOverride` 形参而不是被克隆一份)——搜索路径改的行与正常路径逐字一致。子行在搜索结果里不缩进、不带 gate 标注:搜索结果是「这个键存在、可在这里改」,父子关系留给正常视图讲。全搜无果时有明确空态(点名搜索范围是名称/说明/键名),不是白屏也不是空卡。无新配置键(搜索不改任何行为,是纯视图过滤)、无新 CSS 色声明(布局走内联样式与既有类,#178 的对比度锁不受影响)。回归测试 9 条:索引必须走全六张表、**索引里每个键在双语词典各有一条标签**(76 键全量核对,缺一侧就会有一侧把键名当标签渲染)、目录让位与空态在场、`FeaturesCard` 唯一调用点且搜索分支复用四类渲染器、四条 i18n 键恰好中英各一条,以及评审补的四条:**每个用字面量渲染的行键都必须登记进某张可搜表**(`injectRotationTurns` 此前漏登记——它挂在自己的总闸下、不在任何组项数组里,只断言「索引引用了六张表」抓不到这一类)、搜索结果分支必须渲染 `saveError`(PUT 失败时控件回滚,不显示就成了「改了没反应」)、组内每张卡片标题都要在 `SECTION_TITLE_KEYS` 里(`configKeys.title` 此前缺席)、搜索框与空态文案必须分清「开关按行匹配」与「分组/卡片按标题匹配」。变异自证 8 例(索引删 `FEATURE_ADVANCED_BOOLS` / 删 `FEATURE_ENUMS` / 目录不让位 / enumRow 不传 valuesOverride / 漏登记 `injectRotationTurns` / 搜索分支不渲染 saveError / 漏登记 `configKeys.title` / 文案回退 → 各自变红),恢复后全绿。
7+
- **wiki 面板三处「给人看」的口径修正:机器标记不再露、文件 status 与库同步、树的缩进看真父子(#582)**:chorography 的价值主要在「人看」,但面板把三件「给程序看的东西」也摆了出来。**① `<!-- CHORO:T1:START/END -->` 等机器标记原样显示**——`renderWikiMarkdown` 没有 HTML 注释分支,t0/t1 用来剥段与回填的段落边界成了一行行裸文本;现在渲染层跳过「整行以 `<!--` 开头」的行,且**挂在代码围栏分支之后**(``` 块里的 HTML 注释是内容不是标记,先剥了它示例就缺行);`choro_read_page` 的工具回执与磁盘文件原样不动——真源纪律只约束数据面,渲染层另有一层口径。**② frontmatter 的 `status` 在 T1 之后不回写**——T1 成功只改库(`markChoroPageEnriched`),文件里那行永远停在 T0 写的 `skeleton`:11 个已富化模块页的文件与数据库状态全部不一致,看文件的人会以为从没富化过。现在 T1 成功路径(`enrichPageFile` → `markChoroPageEnriched` 同一条)把 `status: enriched` 一起写进 frontmatter(键名进 `render.js` 的 `FM_STATUS`,与 verified 两键同住——frontmatter 的形状属于页面格式);失败路径不写,文件停在 skeleton 与「首次失败不标 failed(骨架仍是有效产物)」的库侧口径一致;重富化幂等覆写、不重复插行。**存量已富化页的文件不做批量回填**(那些文件有用户手写的 HUMAN 保留区,机器批量改写内容文件不可逆),重跑一次 T1 即自然对齐。**③ 左侧模块树的缩进按 slug 连字符数算**——slugify 把路径分隔与一切非字母数字都变成 `-`,目录名自带的连字符与去重序号(`-2`)都会冒充层级,`packages-computer-use-src` 被画成三层深而 `docs`/`root` 顶格;现在用 `moduleMap` 本来就返回的 `id`/`parent_id` 建真父子序:根(无父或父不在表里)按 slug 序先出、孩子紧跟父后,环成员防御性归入根层兜底(宁可用根层平铺也不能静默丢行——树少一页等于入口没了)。回归测试 5 条:T1 成功把文件 status 推进到 enriched / 重富化幂等且 status 只有一行 / 失败路径不动文件 / 渲染器跳过分支必须挂在围栏分支之后 / 树构建必须用 parent_id 且连字符计数彻底退场。变异自证 4 例(删标记跳过 → 红;树退回连字符 → 红;撤 status 回写 → 红;回写错值 skeleton → 红),恢复后全绿。
8+
- **`dream_runs` 第一次有了保留期:`dreamRunsTrimDays`(opt-in 默认 0)裁掉窗口外轮次的重载列,行与骨架一个字节都不动(#557)**:这张表是四个 `*RetentionDays` 都不覆盖、也没有任何 `DELETE` 路径的唯一一张——单行 `input` 快照体量随记忆数涨、轮数随天数涨,两个因子**相乘超线性**(报告库占约 43% 的页),再叠加热快照 `VACUUM INTO` 是整库副本,它同时放大库与备份两处开销。issue 的建议 1(加保留期键 + 启动期清理)方向对,但按 11-04 的评论对齐口径落地:维护者 2026-09-23 拍板 3 是「**裁列同意、删行不同意**」,而 `dream_runs` 的每一行能回放一次巩固是 `distill_runs` 不复用它的理由——所以这里**不删行、不判「最近 N 轮」**(那三处读最新行的消费者 `lastDreamRunAt` / `lastDreamBaseline` / `getLatestPolicyEpoch` 读的全是骨架列,不受裁剪影响,自然也不必为它们保尾)。裁的是三列重载:`input`(记忆库快照,可由库重建)、`decisions`(原始 LLM 决策)、`outcome`(action 映射)——issue 评论实测列文本 13.26 MB 里 50.1% + 30.5% + 17.8%;`snapshot_hash` / `status` / `provider` / `receipt` / `policy_epoch` / `store_count` 等骨架列与行本身永远保留,窗口外轮次的离线回放降级为**骨架级**(与 `reclaim` 清 input、`dreamInputSummaryEnabled` 的瘦身同一条口径,`docs/CONFIGURATION.md` 写明三处互不冲突)。**`organize` 行整体豁免**:它的 `input` 是 apply 的重放载荷、`outcome` 挂着 `dry_run_id` / `applied_at` 链,裁了会让 apply 静默空转并锁死报告——谓词与 `clearDreamRunInputs` 同一条边界。**opt-in 默认 0 = 不裁**:升级后行为逐字节不变,键的形态对齐 `recallRetentionDays` 一族(顶层扁平键、只从配置文件改、`settings.js` 白名单同族现状一样不进——族里还没人开「进面板」这个头,要开得同时补 `api.js` 的 NESTED 表与 `client.js` 的面板行)。启动期执行(与其余四张表同策略:读装配后的 cfg、失败只 warn 不挡启动),**真裁到了才出一行 info**——常态一个字都不出,别把启动日志刷成心跳。`dreamRunsTrimStats` 与 `trimDreamRunPayloads` 共用同一谓词,报告数字与执行数字同源。回归测试 7 条(窗口外裁三列且骨架列逐列不变 / 行永不删 / organize 整体豁免 / 重跑 changes 为 0 / stats 与执行同口径 / 空表与无命中不抛 / 配置键默认 0 与边界 + 文档面列出该键 + 接线锁「0 不裁、读 cfg、失败只 warn」)。变异自证 4 例(删 organize 豁免 → 2 红;`> 0` 改 `>= 0` → 1 红;默认改 90 → 1 红;裁剪 SQL 漏掉 `outcome` → 3 红),恢复后全绿。
9+
10+
## [0.14.0-beta.3] - 2026-11-12
11+
- **品牌视觉换新:README 头图与插件列表图标**。三处 README(根、`dsh-mneme/`、`mcp/`)顶部改用 `images/mneme-banner-hero.webp`(1672×941,282 KiB)——原图 2.1 MiB 的 PNG 会让 `images/` 目录体积翻倍。根目录用相对路径,两个子目录用 raw 绝对地址:npm 详情页不解析相对图片路径,`../images/...` 在 npmjs.com 上必然裂图。
12+
- **插件列表图标从手绘 SVG 换成位图**:`package.json` 的 `icon` 改为 `assets/icon.png`(256×256 RGBA、圆角透明、120 KiB,仍在宿主 `iconOf()` 的 256 KiB 上限内);`assets/icon.svg` 删除。列表图标不再要求与客户端内联 mark(`MNEME_MARK_D`)同形,`test/client.test.js` 的图标用例改验 PNG 魔数、IHDR 边长、位深与 RGBA 通道——宿主对坏文件是静默回落成通用插画,不报错。
613

714
## [0.14.0] - 2026-11-12
815

‎dsh-mneme/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -523,6 +523,7 @@ dsh web
523523
| `sleepReasoningEffort` | 未配置=最低档 | sleep 各阶段 LLM 推理档位(同 dreamReasoningEffort 语义,v0.7.26) |
524524
| `recallRecordDefault` | `true` | recall_runs 记录默认开(显式传 `recordRecall:false` 的调用方不受影响);注入同样落账(`mode='inject'`,随本开关,#217) |
525525
| `recallRetentionDays` | `90` | recall_runs 滚动清理保留天数 |
526+
| `dreamRunsTrimDays` | `0` | dream_runs 重载列(input/decisions/outcome)的启动期裁剪窗口(天);0 = 不裁。裁列不删行(#557),organize 行豁免,窗口外回放降级为骨架级 |
526527
| `hotMemoryRounds` | `5` | 会话级短期热记忆轮次(v0.5.0):最近 N 轮对话滚动注入,从会话事件日志无状态重建、不落库 |
527528
| `hotMemoryMaxTokens` | `2000` | 热记忆 token 预算(v0.5.0,200-32000),超出滚动截断 |
528529
| `selectiveInjectEnabled` | `true` | 选择性注入(v0.5.0):query 向量可用时注入候选按主题相似度重排,替代固定规则序 |

‎dsh-mneme/docs/CONFIGURATION.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,7 @@
306306
| `evalPersistTestResults` | `false` | 检索评测快照落 `recall_evals` | 生产检索恒只进 `recall_runs`,与此键无关 |
307307
| `recallRecordDefault` | `true` | `recall_runs` 记录默认开 | 显式传 `false` 的调用方不受影响 |
308308
| `recallRetentionDays` | `90` | `recall_runs` 滚动清理保留天数 | — |
309+
| `dreamRunsTrimDays` | `0` | `dream_runs` 重载列(input / decisions / outcome)的启动期裁剪窗口(天) | opt-in,`0` = 不裁(#557:该表单行体量随记忆数、轮数随天数,相乘超线性,是四个保留期键都不覆盖的无界大户)。**裁列不删行**(拍板 3):骨架列与 receipt 永远保留,窗口外轮次的离线回放降级为骨架级;`organize` 行整体豁免(input 是 apply 的重放载荷)。与 `dreamInputSummaryEnabled`(写入期瘦身)、`dsh-mneme reclaim`(手动回收)互不冲突:三处都只是把对应列置空 |
309310
| `trustEpistemicWeighting` | `false` | 来源可信度(observation/subjective/inferred)参与排序与标注 | opt-in;关时 epistemic_status 只是惰性数据 |
310311

311312
### 重排层

0 commit comments

Comments
 (0)