# 更新日志（Changelog） ## [0.26.33] — 2026-11-04 - **根治 3D 记忆海「闪一下变暗」：不是掉帧，是 `resize()` 清空 canvas 位图后，空帧被合成器取样** > 先说结论：前一轮「每帧重绘太贵 → 掉帧 → 分层缓存 + 空闲停摆」的修复方向是错的，`0.26.33-local.1..4` 的四次本地迭代都治的是另一个病。真正的机制是——给 `canvas.width` 赋值这个动作本身会清空整张位图（规范行为），而 `ResizeObserver` 回调落在渲染步骤的 **layout 之后、paint 之前**：此刻清空、本帧就 paint，擦白的那一帧必然上屏，下一 rAF 才补画回来。所以观感是「闪一下」，且只在外部尺寸事件触发时出现，与单帧耗时无关。 - **像素级取证（推翻多模态观察）**：多模态逐帧描述前后三轮互相矛盾（有说 t=7s 黑屏的、有说全片无黑屏的），改用 `ffmpeg signalstats` 拉全片 **324 帧（30fps / 10.8s）** 客观统计——整片 YAVG 只有 **两个离散值**：`49.20` 与 `40.46`；**22 张暗帧完全同参**（YAVG=40.46 / SATAVG=7.29 / SATMAX=75），说明它们是**同一张图反复出现**，不是渐进掉元素。 - **定位到「位图透明」而非「元素缺失」**：暗帧下画布三个区域全部塌到同一个纯色——黄簇 `28.69→22.00`、青簇 `26.13→22.00`、空白星空区 `30.95→22.89`，饱和全落到 `≈4.00`。Y=22 是 limited-range，换全范围 luma ≈ 7，而 canvas 元素 L779 的 inline background `#04070f` 实测 luma = **6.99**——对上了：看到的是 canvas 自己的背景色透出来，不是背景层或点层画了一半。 - **排除合成器/GPU/整窗级问题**：同帧内左侧栏 `61.94→61.81`（-0.2%）、顶部图例条 `100.52→100.52`（**像素零差异**）。窗体重排、resize 抖动、掉驱动都会被这一条否掉。 - **修复一（幂等 resize）**：`resize()` 改成返回布尔——尺寸与 DPR 都未变时整段跳过，不碰 `canvas.width`。RO 在布局抖动/滚动条出现时的重复触发从此是零成本，不再反复擦白。 - **修复二（RO 内同步出帧）**：新增 `presentNow()`，RO 里 `if (resize()) presentNow()`——真擦了就**当场画完上屏**，把「清空 → paint 空帧 → 下一 rAF 补画」压成同一渲染步骤内的原子操作。原来那句 `wake()` 只排下一 rAF，本帧照旧 paint 空位图，这是闪烁的直接成因。 - **修复三（帧句柄自清）**：`frame()` 入口 `raf = 0`。它现在会被 `presentNow()` 同步调用，留着旧句柄会让后续 `wake()` 以为还有链在跑而漏排帧。 - **附带（非闪烁，每帧税）**：`getComputedStyle` 解色从「每帧 4 次」改为脏标记缓存（`refreshColors()`，仅 resize 与本 effect 重建时置脏）。原实现每帧强制同步样式重算，是纯白交的开销；语义不变——令牌解析时机仍是「主题/尺寸变化」。 - **为什么分层缓存没能解决**：那套改动只降低单帧重绘成本、减少 rAF 次数，但闪烁发生在「可见 canvas 被清空」这条独立通路上，三层缓存（edgeCv / nodeCv / buffer）再快也救不了本帧已经 paint 出去的空位图。反过来说，分层缓存本身是有效的性能优化，保留。 - **未改任何对外契约**：无新配置键、无端点变化、无默认值变化；仅 `client/src/explorer/Scene3D.tsx` 内部渲染调度。 - **验证口径（可复现）**：重录 30s 后跑 `ffmpeg -i -vf "signalstats,metadata=print:file=signalstats.txt" -f null NUL`，**暗帧计数必须为 0**（修复前同一口径为 22/324 帧）。本机已核对：`desktop` profile 装的是 `v0.26.33-local.4`，`dist/client.js` 哈希 `A6879304…` 与源码构建一致——闪烁不是「没装上新代码」，是代码里还在。 - **测试**：全量 **2048 passed / 1 skipped**（200 文件）；client typecheck 0、`eslint client/src/explorer/Scene3D.tsx` 0 error；`npm run build` 0。产物核对：`dist/client.js` 新哈希 `98DD1061…`，与装入 `desktop` profile 的副本逐字节一致（`v0.26.33-local.5`）。 ## [0.26.31] — 2026-11-03 - **回填 0.26.30 的测试缺口 + 让 npm 产物与 main 对齐（无运行时行为变更）** > 0.26.30 发布后，Spec 的「测试与门禁」里还有一条只有「不回归」、没有专项断言：`tests/l1-receipts*` 要证明「本条被批内哪条吸收」。本版把它补成真断言，并把映射抽成纯函数 `receiptItemsForAbsorbed()` 供管线与用例共用。 - **凭证可审计补全**：吸收项 → `kind='merge'` + `candidateIds=[代表 id]`，`input_digest` 指向代表项；空映射零额外行（特性关闭时凭证与 0.26.30 逐字节一致）。用例：`tests/l1-receipts.test.ts`「§B 批内吸收关系入凭证」。 - **行为零变更**：本版只做纯函数提取 + 新增用例；`dist/pipeline/l1.js` 的输出与原内联映射同参同果，0.26.30 的运行时行为完全保留。 - **对齐**：`v0.26.30` 的 tag 停在 `673d033`，之后 main 多了一个测试提交；本版把 tag / npm 产物 / main 重新对齐，避免「装到的其实是 tag 前代码」这类误判。 - **测试**：全量 **1976 passed / 1 skipped**（195 文件）；typecheck 0、lint 0 error；CI（Linux）七步全绿。 - 未改任何对外契约：无新配置键、无端点变化、无行为分支。 ## [0.26.30] — 2026-11-03 - **#22 机理刀三层防线 + 同会话批内去重 + DRSC 提示 + 锁文件修复** > #22 机理刀：前几版只修了 token 护栏的**截断面**（把进模型的 token 压到 1536），机理本体未动——相邻两次大推理的 T² 张量在 BFCArena 高水位不回落时**共存叠加**（m=2），且崩一次就停摆到宿主重启。本版把防线从「只截」扩成**三层**：① token 帽 1536（既有）② 关 memPattern 压低共存峰（新）③ 崩溃有界自愈 respawn（新，默认开可关）。**诚实边界**：三层都在 Windows/纯 node 侧证峰值/状态机/续试；SIGTRAP 的消除只能由报告人在 macOS 回验裁决，#22 是否关闭取决于那次回验。 - **第二层：`resources/embedding-child.cjs` / `embedding-worker.cjs` 的 pipeline 加 `session_options:{enableMemPattern:false}`**。ORT 默认按图形预分配、把输入绑定驻留 BFCArena，连发时新旧 T² 张量共存把峰值叠成 m×T²；关掉后同形状连发峰值本机实测 **1597MB→1264MB（−333MB，m:2→1 方向）**、稳态 infer 零代价。关键——**同输入改前/改后向量 bit 级全同**（真 bge-m3 `--equivalence` 实测 `maxAbsDiff=0`，短文本+致死长文本两样本），所以**不触发重嵌**（库里向量不失效）。边界：对 macOS 分配器 trap 的消除效果本机不可证，**不得据此宣称「不再崩」**；决定性实验是报告人用 `scripts/repro` 在 macOS 重跑 `--budget 2048` 连发看是否仍 trap。 - **第三层：崩溃有界自愈 respawn（`src/store/local-embedding.ts`）。⚠ 有意翻转 `0.26.25` 公告的「本刀声明不做自愈」**——那是当时边界，本轮把 bound 面逐条补齐后开。默认**开**，新键 `embedding.respawnOnCrash`（`.boolean().default(true)`，只增不改键）可关回旧语义（崩一次停摆到重启）。做法：通道工厂化（`createChannel`）→ `crashCb` 为**唯一** respawn 发起点（消 warmup/embed/reindex 三入口的 fork 风暴，`respawnPromise` 单点合流）→ 复用 `loading` 态（**不加新契约态**，`contract.ts` 不动，现有 vectorsReady 门天然接管半成品窗口）→ 重建通道 + await warmup。**速率上限 60s 窗内 ≤2 次**，超限回 `failed`（旧终局）。 - **崩批断点续试（协议加 `ack`，只增不改）**：子进程对多条目批逐条实时上报 `embedProgress{cid,done}`，父侧记断点位；子进程被硬杀时最后的 `done` 就是重试切片位，`texts.slice(ack)` **仅续一次**，再败走既有 reject。**诚实边界（表述红线之二）**：头段 `ack` 条的向量随崩溃子进程一起丢失、本批不返回（返回位为空洞，交后台 backfill 逐条补）——所以自愈**不保证不丢向量**，只把「重做面」从整批压到尾部未完段，且毒输入最多吃 2 批不成活锁（`l1.ts` 重嵌腿已加 `undefined` 守卫，把空洞当「本轮未取到」跳过）。 - **第一层口径留痕（还 `0.26.25/27` 欠下的「无声混叠」债最小形态）**：生效 `tokenBudget` 写入 `embedding_meta` 新键 `embedding_token_budget`（`MemoryDb.recordEmbeddingTokenBudget`，**只记录不比对、不进 providerInfo drop 判据**——调档不重嵌，1536 仍是**实测经验值、不是证明**）。`index.ts` 在 db.init 后落一次。 - **worker 逃生门通道**同法接入（`RealWorkerChannel` 进度也按 cid、`lastProgressFor` 对齐），既有 worker 用例零回归。`smoke` 补三条产物/配置断言（child 含 memPattern、local-embedding 含 respawn 代码、`Config.embedding.respawnOnCrash` 默认 true）。 - **复现件收编 `scripts/repro/`（报告人 gist 三件，不进 `tests/`）**：`embedding-repeat-crash.repro.mjs`（独立 CLI，`--budget` 从 `dist` 读 `HARD_CAP_TOKENS` 不写死）、`embedding-repeat-crash.test.ts`（vitest 包装，三重门 darwin+开关+本机模型/宿主）、`README.md`。理由：CI 只 ubuntu-latest、三重门恒跳=负债件；macOS 每次崩会记 `.ips` 并弹「意外退出」污染维护者机器。跨平台可证的崩溃状态机走 `tests/embedding-respawn.test.ts`（SIGKILL 代替 SIGTRAP）。 - **L1 批内自去重（同轮/同会话）——修掉「同会话内容撑在一起再让 LLM 合并」的笨办法**：实测根因是候选池**只来自库**（`store.searchCandidates`），同批 `extracted[]` 之间从不互比，于是同一段对话抽出的多条碎片全进同一条 ≤20 条的 LLM 去重 prompt，只能由模型产出 `merged_content` 把内容拼成一条。现新增 `src/pipeline/intra-dedupe.ts`（纯函数）：归一（trim/NFKC/空白折叠/去零宽）→ 精确合并 → **同 family+同 type** 内按余弦 ≥τ 贪心聚类；代表项正文原样保留（所以它的向量可直接复用），被吸收项的 `timestamps`/`source_message_ids` 取并集、`priority` 取最大。新键（只增不改键）：`extract.intraBatchDedupe`(默认 `true`)、`extract.intraBatchCosine`(0.85–0.99，默认 0.92，越界 clamp+warn——不卡窄区间到配置树)。日志一行 `raw→exact→vector→effective`。**收益边界（诚实）**：只减**条数与总时长**，对 #22 的单次推理峰值 O(T²) 无任何降低。 - **同一条记忆不再嵌两次**：去重期 `searchCandidates` 已算过查询向量，写侧 `appendNew` 又 `helper.batch` 一遍。现 `appendNew(records,{vectors})` / `upsert(record,{vector})` 命中即复用（merge 产出的**新正文**仍实嵌，长度不匹配整批回落实嵌）。`searchCandidates` 增可选 `queryVector`，不再内部重嵌。实测（记账型 embed 注入）：3 条新记忆只复用 2 条时**只触发一次单条嵌入**。 - **DRSC 依赖提示到位（设置面板 banner）**：`dsh.pluginDependencies` 在运行时不产生任何行为（宿主 boot 层 0 处引用），记忆插件只是 collector 的消费者、无权挂载它——于是「只开了记忆」的部署里蒸馏背景窗与跨会话检索**静默为空**且无任何提示。现新增探针 `probeDrscHealth()`（五态 ok/missing/not-running/stale/unknown；**不经 `moduleOf`、不写 `facadeMisses`**、复用 `storeHandle`，否则会污染读路径或每 60s 重开 185MB 库）→ 端点 `dsh-memory/drsc-health`（白名单/计数器 66→67）→ `DrscHealthBanner`（`ok` 与首帧不渲染；四态文案 + 影响说明 + 可复制指引）。文案明写「**只开启记忆不会自动启用参考会话库**」与 desktop 只能手改 profile + `pnpm install` + 重启三步。 - **修掉发布链阻塞：`package-lock.json` 与 `package.json` 脱同步**。锁文件停在 `0.2.0-rc.1` 一代（最后更新 2026-10-22），而 devDeps 已到 `0.2.1-rc.3` → `npm ci` 直接 `ERESOLVE`，CI 与 `publish.yml`（二者都以 `npm ci` 起手）**连续多轮必红**；本地因复用既有 `node_modules` 而假绿。现重生成 lock（根 0.26.30、`@deepseek-ai/dsh-*`＝`0.2.1-rc.3`、371 包）并验证 `npm ci --dry-run` 在仓库内与**隔离目录**（等价 CI checkout）均通过。 - **测试**：新增 `tests/embedding-respawn.test.ts` 7 例（真 fork 无模型 stub：kill→respawn→ready→下一条成功、ack 断点续试一次、毒输入≤2 批不活锁、60s 速率上限超限转 failed、禁 respawn 变异对照、close 后 terminated 不复用、崩溃归因含 signal）；`embedding-token-guard.test.ts` +2 例（两条通道 memPattern session_options 哨兵、respawnOnCrash 默认开可关）；`memory-db.test.ts` +1 例（预算留痕写读且正交于重嵌判定）；`intra-dedupe.test.ts` 14 例（归一/精确层/向量层/tau 边界/跨族跨类不合并/缺向量直通/关闭透传/嵌入失败降级）；`l1-vector-reuse.test.ts` 5 例（复用位不嵌、未命中位实嵌、长度不匹配回退、upsert 复用、merge 新正文实嵌）；`drsc-health.test.ts` 7 例（五态 + 句柄复用 + 门面抛错不误报）。全量 **1974 例 / 195 文件**全绿；typecheck 0、lint 0 error、build/build:smoke/smoke/verify-catalog 均 0。配置面**只增键不改键**（`embedding.respawnOnCrash` / `extract.intraBatchDedupe` / `extract.intraBatchCosine`）。对外表述红线三条：不写「消除崩溃」、不写「自愈不丢向量」、不写「批内去重降内存峰值」；1536 保持「经验值非证明」。 ## [0.26.29] — 2026-11-02 > #22 报告人（DESXIE）回验 `0.26.28`：**自动档预算 = 1536、`5×5000` 串行全过**，且用同脚本换 `--budget 2048` 作对照组仍在第 2 条 SIGTRAP——说明“全过”不是环境变了，是 1536 真拦住了。同时他拓出一个真 bug。 - **修：`tokensMax=未知` 在真实链路上根本到不了**（报告人实测发现）。子进程侧 `tokensMax` **初值是 0**，而累加用严格大于（`if (cut.seq > tokensMax)`），所以永远量不出 seq 的情形（tokenizer 不可达、预算为 0、护栏被关）得到的 `-1` **永远赢不了 0**；而主线程 `>= 0` 判据会把残留的 0 当有效值印出来——正好印成这行日志本想避免的「一条也没进」。现初值改为 `-1`，“不可证”与“真的零”不再撞同一取值。一行修复，但它使能了整条取证链：`tokensMax` 仅在“护栏被关/tokenizer 不可达”这种最需要告警的时刻才有价值，之前那时它说谎。 - **为什么没被自己的测试抓到**（比修复本身更值得记）：`describeEmbedBatch(…, -1, …)` 的用例只测了**纯函数收到 -1 时印什么**，从来没测**子进程会不会送来 -1**。现已补 3 例：① 哨兵钉死子进程侧初值必须为 -1（结构改动时会提示同步）；② 复现归并语义本身（初值 0 吃掉了不可证、初值 -1 不会，且任一有效值仍能抬高）；③ 端到端走真 `shrinkToBudget`（预算 0 时）→ `-1` → 印「未知」。已反向验证：把初值改回 0，哨兵即转红。 - **报告人的其他三项标注（无需改动，但记下来防重复讨论）**：`code/signal` 归因与「停摆 warn + 带 record id 的失败日志」与 `0.26.25` 逐字相同，属**既有实现而非本批新增**（他说得对，我之前的行文容易让人误读成每版新修）；`tokensMax` 独立复核与自报值一致（1535/2047 两档均双路吻合），护栏真截了。 - **采纳他的口径澄清**：`graph` 投影那串「连发」是**连续多次单条 `priority` 请求**（所以日志里 `n` 常见为 1），真正成批多条的只有 reindex（`CHUNK=16`）；这不影响护栏结论，但读 `tokensMax` 时应知道 `n` 的含义。机理本身仍未动（1536 是实测经验值，不是证明）。 - 全量 **1938 例 / 191 文件**全绿（+3）；typecheck 0、lint 0 error、build/build:smoke/smoke/verify-catalog 均 0。公开配置面无变更。 ## [0.26.28] — 2026-11-02 > 本版只修一个错：**我在 `0.26.26`/`0.26.27` 的 CHANGELOG 与 issue 留言里说「子进程上报本批实测进模型的最大 token 数」，但那个值从来没进过日志**。它只被本地验证脚本的探针读到，插件自己的 `memory.log` 里一行都没有——而 #22 这类问题事后能核的只有日志。计划本身是要求这一行落盘的（每批 info 记 `n / 最大tokens / inferMs`，fork 时记 `pid`），是我执行时漏了两项。 - **每批推理现在真会落一行 info**（`describeEmbedBatch()`）：`[memory] 本地嵌入一批完成:model= n=<条数>,进模型 tokensMax=<实测值>,耗时=`。三个细节：① `tokensMax` 是子进程按库口径**实测**回来的值，不是推算；② 不可证（子进程给 -1）时印「未知」而不是 0，避开「一条也没进」的误读；③ 用 `info` 而非 `debug`（`src/util/filelog.ts` 只镜像 info+，debug 根本进不了 `memory.log`）。这样报告人按我给的清单回验时，「日志里每批 `tokensMax ≤ 预算`」这一条才真的可验。 - **fork 后补记子进程 `pid`**（`RealChildChannel` 新增 `onForked` 回调）：#22 的归因本来就是靠「系统崩溃报告 ↔ 插件日志」对时间戳，有 pid 才能把一份 `.ips` 对上哪个子进程，`taskkill /T` 的进程树也因此可核。原先只有 `execPath/release/model/tokenBudget`，没 pid。 - **协议类型同步**：`EmbedWorkerReply` 的 `embedded` 分支加上可选 `tokensMax`，让这个值在主线程类型可见（不再是只存在于未声明字段的 JSON 里）。 - **验证**：`scripts/verify-token-guard-realmodel.mjs` 的端到端段现在**直接断言真落盘的日志行**（而不只是内存里取个值）：拉起行含 `execPath`+`tokenBudget`、另有一行 `pid=\d+`、每批一行 `tokensMax` 且均 ≤ 预算。实测：`pid=37384`、两批 `tokensMax=1535,1535`（预算 1536）、混批与同文本长批均正常返回 1024 维向量。新增 CI 用例 2 例（每批日志内容断言 + 「不可证记未知」边界），本刀累计 31 例。 - 全量 **1935 例 / 191 文件**全绿；typecheck 0、lint 0 error、build/build:smoke/smoke/verify-catalog 均 0。无配置面变更，无破坏性变更。 ## [0.26.27] — 2026-11-02 > #22 报告人在 macOS/M5 上回验了 `0.26.25`：**三个原致死档不再 SIGTRAP、护栏确实接上**（这验证了主线结论），但翻出一个**比原缺陷更贴近真实负载**的问题，本版纳入他的二分实测。 - **`HARD_CAP_TOKENS` 2048 → 1536：预算原本只对了「单发」，而本仓真实负载是「连发」**。报告人二分实测（Electron-node，`5×5000` 中文字符串行）：**512/1024 全过、1900/1960 全过、1990/2000/2010/2016/2020/2040/2048 均「第 1 条成功、第 2 条 SIGTRAP」**；而单发致死线是 ≈2700。两者不同源的机理止得住我的原分析：**BFCArena 高水位不回落**（我先前已测到 6 轮大推理后 RSS plateau 不降），第二条进来时第一份 T² 张量尚未回收完，**新块与旧块共存瞬间的峰值**才是真正的天花板。 - **为什么这条要紧（已实地核实，不是直按报告人的话）**：`src/pipeline/graph.ts:134-137` 正是 `for (const n of touched) { … await embed(nodeEmbedText(n)) … }` —— 逐条串行且**单条请求**，一个投影批里常有 5～8 个节点，其中两条长就命中。所以原issue 的「每次投影必崩」在 2048 下只降到「命中≥2 条长文本时崩」，而**本刀已声明不做自愈**，命中仍是崩一次废到重启。1536 在连发线（≈1960）下留 ≈21% 余量（报告人建议值，他也给了 1024 选项；取 1536 是为了不一刀牺牲 bge-m3 长文本的召回语义）。 - **T1 脚本新增「连发」维度**（`scripts/verify-token-guard-realmodel.mjs --serial N`）：同一段 5000 字符在**同一 pipeline 实例**里串行喂 5 次，断言**每一轮实测 seq 均 ≤ 预算且各轮一致**。本机（Windows/纯 node）不会 trap，所以这只能证「预算对连发一致成立」，不能证「连发不崩」（后者只能 macOS）。实测：`seqs=1535,1535,1535,1535,1535`（预算 1536）；T3 峰值从 1469MB 降至 **1235MB**（无护栏仍 4168MB）。 - **收干自己造下的魔数漂移面**（这是 `0.26.25/26` 留下的）：测试与脚本里原本**把 2048 当字面量贴了 8 处**，改常量时全变成假红/假绿。现一律从 `HARD_CAP_TOKENS` 推导，真模型脚本也从 `dist/model-catalog.js` 读默认值；哨兵断言同时禁止 `1536|2048|2700` 出现在子进程/主进程层。**诚实记录：改完从常量推导后，我立刻发现自己两处算错而实现的断言**（用魔数时我把错误算成了和实现一致的值，所以“看起来绿”），现在改成断**契约性质**（收到预算内 + 真的截了 + 首轮不多试）而不是断精确切片长度。 - **文档同步**：9 语 README 的 `embedding.maxInputTokens` 行由「硬上限 2048」改为 1536；`src/config.ts` 对该键的描述不含具体数字（避免下一处漂移）。 - 另接受报告人一个诊断修正：他指出 `tokensMax` 在 `0.26.25` 恒为 0、且 `Array.isArray(shape)` 分支「永远进不去」——与我在 `0.26.26` 独立查到的同一缺陷一致（他比我先跑出这个结论，他是从外部拿真 tokenizer 量的）。 - **测试**：`tests/embedding-token-guard.test.ts` 保持 **29 例**（断言形式从魔数改为常量推导）；全量 **1933 例 / 191 文件**全绿，typecheck 0 error、lint 0 error、build/build:smoke/smoke/verify-catalog 均 0。公开配置面无破坏性变更（仅默认推导出的预算从 2048 收紧到 1536，显式设过 `maxInputTokens` 的用户不受影响）。 ## [0.26.26] — 2026-11-02 > `0.26.25` 把 #22 的 token 护栏落地了，但把**最关键的那条验证当成了「已接上报」而非「已实测」**。本版用真 bge-m3 把它跑完，跑出了三个真实缺陷并逐个修掉。 - **T1 从「上报机制」补成「真模型实证」**（新增 `scripts/verify-token-guard-realmodel.mjs` + `scripts/_t3-runner.mjs`，可选跑、不进 CI——需本机 runtime 与 bge-m3）。在真 bge-m3 上实测：**5000/4000/3800 中文字符（报告里全部 SIGTRAP 的那三档）截断后进模型的序列长度均为 2047 ≤ 预算 2048**；无护栏时实测 **5003**；截断前后向量不同（排除「只报了个数、实际没截」）。护栏留位从「假设」变成「事实」。 - **修掉三个被真模型才抓得出的缺陷**（桩测试永远测不到）： 1. **`tokensMax` 恒为 -1，等于没上报**——原实现从输出张量取 `.shape`，而实测发现 transformers 的 Tensor **根本没有 `.shape`**（叫 `.dims`），且池化后输出是 `[1024]` 一维、里面**不存在 seq** 这个维度。现改为截断时按库自己的口径（`padding:true, truncation:true`）实测并上报，脚本还拿两个独立取法互验（实测 2047 == 2047）。 2. **「预算留 2 位」是侥幸不是保证**——真测：切 2046 个 id → decode → 重分词得 2045 token，+2 special = 2047，预算 2048 **只剩 1 位余量**；BPE/Unigram 的切片→解码→再编码不保证同序列，换一段文本就可能多漂而越界。现改为**由实测超出量逐轮递降收紧**（每轮重编码取真 seq，严格变短，至多 3 轮；量不出来就报 -1 而不是猜）。 3. **基准不能只看 encode 的 id 数**——5000 中文字符的 `encode` 长 5000，而 pipeline 实际会送进 5003；已改为取两者较大值作基准。 - **消除一个我自己引入的测试污染**：本为取 `shrinkToBudget` 而让测试 `require('embedding-child.cjs')`，会把它的顶层 `process.on('uncaughtException')`（处理器会 `process.exit(1)`）与 `message` 监听装进 vitest 的 worker——**实测同 worker 的 `tests/memory-md-sync.test.ts` 因此无端转红（单跑绿、全量红）**。现恢复 child 的 fork-only 契约（只加一条文件头说明为何不可被 require），截断逻辑住在无副作用纯模块，对 child 仅做字面接线断言 + 产物 smoke，真行为由真模型脚本负责。 - 另记一条**既有偶发失败**（非本次引入、本次未修）：`memory-md-sync.test.ts` 在全量并行下会间歇红（恢复活跃时 `.md.disable` 后缀未及时消失）。已用基线 worktree 对照：**不含本批改动的 `f3c1c07` 连跑 5 次也红过 1 次**，而本树连跑 3 次全绿，故不属本刀回归；具体原因是该用例的异步写盘与 `existsSync` 同步断言竞速，待另案。 - smoke 的两条产物断言从「贴字面量」改为「断意图」（上一版贴了 `module.exports = { shrinkToBudget }` 与 `maxTokens - 2`，实现一改就误报）。 - **测试**：`tests/embedding-token-guard.test.ts` 24 → **29 例**（新增逐轮递降、量不出来降级报 -1、`seqLenOf` 同时吃数组/张量两形等）；全量 **1933 例 / 191 文件**全绿（连跑 3 次），typecheck 0 error、lint 0 error（4 条既有 warning）、build/build:smoke/smoke/verify-catalog 均 0。公开配置面无破坏性变更（`maxInputTokens`/`maxInputChars` 语义与默认值未动）。 ## [0.26.25] — 2026-11-02 - **#22 根治：本地嵌入新增 token 维度护栏**。报告实测同一 5000 中文字符（≈3651 token）在纯 node 跑通（峰值 RSS **4.7GB**）、在宿主 Electron-node 被 **SIGTRAP 静默打死**（796ms、峰值仅 1.05GB），且崩溃瞬间 writable resident 只 3381K、机器 24GB 未吃满——**不是 OOM，是「单笔大块对齐分配被拒」**。本轮在本机（Windows/纯 node）实测内存峰值严格 **O(T²)**（750/1500/3003 token → ΔRSS +106/437/1635 MB，比 1:4.1:15.4 对应 T² 的 1:4:16），机制是 attention 张量 `[1,heads,T,T]`；外推 3651 token ≈4.6GB，与报告的 4.7GB 跨平台互证。**T 是唯一可控自变量，降 token 预算同时是崩溃护栏和内存护栏。** - **护栏早就在子进程，错的是单位**（实读校正了一处长期误解）：`resources/embedding-child.cjs` 一直在子进程内截断，但按**字符**截。bge-m3/embeddinggemma 是 Unigram/BPE，中文≈1 字/token 而 emoji/泰文可 >1.5，所以 5000 字符既可只 750 token 也可近 8192——**字符帽与崩溃条件不同源、不可换算**；库自带 `truncation:true` 只截到 `model_max_length=8192`，本身就在致死线 ≈2700 之上，**等于没兜**。另证：`src/util/context-occupancy.ts` 的 `CHARS_PER_TOKEN = 4`（官方同值）对中文低估 4 倍，很可能就是「5000 字符看着安全」长期未被怀疑的成因，**已明令禁止用于嵌入预算**。 - **新增 `embedding.maxInputTokens`（默认 `0`=自动）与唯一真值来源 `HARD_CAP_TOKENS = 2048`**（`src/store/model-catalog.ts` 的 `deriveTokenBudget`）。生效预算 `= min(模型 contextTokens, HARD_CAP_TOKENS)`：bge-small-zh(512) 不受影响、bge-m3(8192) 被压到 2048；用户显式超限只 **clamp + warn**，不抛错。`contextTokens` 原注释「仅 UI 展示」已升格为推导真值并同步改注释（不改就是下一轮声明漂移）。 - **配置面只加键不改键**：`maxInputChars` 的键名/边界（`min(100).max(100_000)`）/默认值 5000 **完全不动**。实测 schemastery **未知键静默透传不报错**，改名或换单位会让已部署 YAML 的值**无声失效并回落 `?:5000`**（新主进程 + 旧 `dist/embedding-child.cjs` 错配时同理）；而收窄边界会让已部署 YAML **解析直接抛错**，故障半径是整个配置树。字符帽继续只管远程档与 IPC 粗筛、token 帽只管本地推理——**各自单一实施点，不做同层双旋钮**。 - **截断执行留在子进程**（新增 `resources/embedding-token-guard.cjs`，无副作用纯模块）：tokenizer 只在加载后的 pipeline 对象上可达，且 ORT `run()` 同步阻塞、单条内部不可中断，预检只能放推理前；而子进程隔离本身是 #11（同进程 `libvips-42.dll` 撞名）的修复，不得为省一次 IPC 拆开。tokenize 成本实测占单次推理 ≈2.4%（121-136ms vs 5427ms）。旧逃生门 `embedding-worker.cjs` **有意不同步**并在文件头写明理由（硬同步 = 维护两份口径）。 - **实现期三个实测陷阱**（不避开就是静默错位）：`encode()` 缺省返回 `_Tensor`（`.length === undefined` 且**不报错**，须显式 `return_tensor:false`）；`decode()` 缺省 `skip_special_tokens=false`，slice→decode→re-encode 会 **+2 token**；`tokenizer.model_max_length` **只读**（实测 `has only a getter`），不能当旋钮。**主动删掉一个自己写出的缺陷**：初版带了「`raw.length * 0.5 < 预算` 即跳过 tokenize」的省开销优化，但 3800 中文字符×0.5=1900 会跳过、其实际≈2774 token 正落在致死档，属未验证跳跃 → 改为无条件实测。 - **可见性修复（#22 归因链路的前置）**：`child.on('exit',(code)=>…)` 只接 code、**丢弃 signalCode**，使 SIGTRAP / OOM-kill / 自然退出在日志里同为 `code=null`（本轮就是靠 macOS 4 份崩溃报告对毫秒时间戳才归因上的）；现由 `describeExit()` 同时输出 `code` 与 `signal`，一处修三处可见（crashed 串 / warn / `getLoadError()`），worker 旧通道同型修正。子进程另上报本批**实测**进模型的最大 token 数（`tokensMax` 取输出张量 `[1,seq,hidden]` 的 seq，不用推断值）；fork 时一条 info 记录 `execPath`/`process.release.name`/pid/模型/生效预算——之前仓内没有任何地方记录 execPath 差异，而那正是「同代码纯 node 能跑、Electron 崩」的唯一区分量。 - **补齐停摆不再静默**：`reindex` 首行 `if (!vectorReady()) return {0,0,0}` 与「本轮无事可做」不可区分，且 `index.ts` 的 `failed>0` / `missingAfter==0` 两分支都不进 → **一行日志都不打**（崩后熔断也不在环上，环上是 `isReady()` 短路）。现补齐链分流出「缺失数统计失败」与「本轮未写入且仍差 N 条」两条 warn；reindex 批次的 `catch {}` 补上日志并**带 record id**（否则无从定位是哪条长文本致崩）。**已收回一条调研结论**：`markEmbeddingSynced` 的「缺失全落 skip 集」并非假成功——`l1.ts` 注释明确写明 skipped 有意不阻塞同步标记（否则永不收敛、周期性全量重嵌死循环），照误报去改会引入新缺陷。 - **本版本不含崩溃自愈**：`startReindex` 前置 `vectorsReady()` 门使自愈在崩溃态根本进不去，而 respawn 的真实半径含六处长期引用重绑、状态机新分支、三腿 thundering herd 与 60s 冷却叠乘；且本刀目标是「不让毒形成」而非「毒已形成怎么办」。也不自动全库重建（该腿无超时无熔断、成本不可量化，且新帽只缩不扩、语义退化有界）；历史向量口径如需严格一致可手动触发重建。 - **测试**：新增 `tests/embedding-token-guard.test.ts` 24 例（预算推导 4 组 + 精截与降级路径 + 两个实测陷阱 + 配置面回归 + 退出归因）。**红绿对拍已逐条验证有效性**：断开接线→1 红、不留 special 位→2 红、塞回字符启发式→4 红、预算不写进 cfg→1 红。过程中查出并修掉自己的两个测试缺陷：直接调纯函数**测不到调用点**（接线整行删掉时 19 例全绿）→ 补接线/产物哨兵；对拍脚本把 vitest「收集期报错」误读成「无失败」→ 判据改为区分 `Test Files failed`/`Tests no tests`。**跨平台限制如实声明**：`malloc_zone_memalign` 是 macOS 分配器符号，Windows 既不能复现 SIGTRAP 也发不出该信号（`EINVAL`），故本仓可证的是「进模型的 token 数受预算约束」与「被信号杀可归因」，崩溃是否消失需报告人在 macOS 回验。全量 **1923 例 / 191 文件**，typecheck/lint(0 error)/build/build:smoke/smoke 全 0；smoke 新增 3 条产物断言钉住 `dist/embedding-token-guard.cjs` 存在、child 相对 require 可达、guard 导出正确（漏拷是子进程起不来的硬故障）。 ## [0.26.24] — 2026-11-02 - **修掉 `0.26.23` 自己引入的回归：读面可能被永久堵死**。上一版规定「对端已升版但 `drsReadFacade()` 返回 undefined 时抛可重试错、不回退自开库」，用意是避免把自开库结果永久缓存。但**未就绪是无法与「本进程根本不会有人 activate collector」区分的**，两类真实场景落进后者：① 宿主外跑本仓读面做校验的脚本（新进程 import collector，`apply()` 从未运行，门面永远 undefined）；② collector 装了但未进当前 profile 的装载清单。它们会每次读都报错，比 `0.26.21` 的直接自开库更糟。 - **改法：有界重试后再回退**（`src/clients/drsc-inproc.ts`）。预算 `FACADE_RETRY_BUDGET = 3`：前 3 次读抛可重试错且不缓存（给宿主内 collector 的 `setImmediate` 初始化留出窗口，保住「优先用门面」）；第 4 次仍拿不到门面即认定本进程等不到，回退自开只读库。两条路径都读的是同一个 WAL 库、句柄只读，不存在读到错数据的风险，差别只是是否多占一份常驻 `summaries`。门面一旦就绪，计数器归零。 - **测试**：`tests/drsc-inproc.test.ts` 相应改为断言完整状态机——预算内逐次抛错（错误文本含 `1/3`、`2/3`、`3/3`）且期间**绝不**调用 `openProjectionStore`；第 4 次回退成功打开自有句柄并返回正常结果；`resetCollectorReadState()` 后门面就绪能拿回门面。全量 **1904 例 / 190 文件**，typecheck/lint/build/build:smoke/smoke 全 0。 - **验证口径提示**：宿主外脚本按设计走的是**回退路径**（会开自己的只读句柄），因此「脚本里出现自开库」不是缺陷；宿主内的判据是日志无「背景窗拉取失败」且蒸馏/`conversation_search` 出真数据。 ## [0.26.23] — 2026-11-02 - **方案 B：DRSC 读面改走 collector 的正式门面（`drsReadFacade`）**。`0.26.21` 的进程内直调虽然绕开了宿主鉴权，但代价是**耦合 collector 的五个内部导出名**（`openProjectionStore`/`createQueryContext`/`search`/`sessionDetail`/`listSessions`），并且**自己另开一份投影库**——多占一份常驻 `summaries` 内存与一个读事务。现在 collector `0.2.5` 导出 `drsReadFacade()`，返回绑它**自己活 QueryContext** 的只读对象；本仓优先用这个门面，只认一个稳定符号，也不再开第二份库。 - **三条路径的优先级与降级**（`src/clients/drsc-inproc.ts`）：① collector ≥0.2.5 且库已就绪 → 走门面；② collector 是新版本但库还在 `setImmediate` 初始化 → **本轮抛可重试错、且不缓存**，让下一次读重取门面。这一点是本轮自查出的真设计缺陷：若此时回退自开库，会把自开库结果**永久缓存**，把「优先用门面」变成只在首轮赌运气。降级走既有链路（背景窗当轮空窗、工具面显式报错），语义与旧 HTTP 遇 `503 initializing` 一致；③ collector 是旧版（无该导出）→ 回退自开只读库（保留 `0.26.21` 行为）。 - **参数映射不分叉**：门面对象被适配成与兼容路径同一个「模块形」，所以 `op`/`q`/`tail`/`limit`/`redact` 的解析口径、非法值整键缺席、`session` 缺 id 返回空行等语义只有一份实现，两条路径共用。 - **依赖下限抬到 `>=0.2.5 <0.3.0`**（`package.json` dependencies；`dsh.plugin.json` 的 `pluginDependencies` 只列包名不带区间，无需改）。低于该版仍可用，只是走兼容路径。 - **测试**：`tests/drsc-inproc.test.ts` 新增 3 例——门面可用时绝不调用 `openProjectionStore`；未就绪时报错且不缓存、对端就绪后下一次读拿到门面；旧版 collector 仍回退自开库。全量 **1904 例 / 190 文件**，typecheck/lint/build/build:smoke/smoke 全 0。 ## [0.26.22] — 2026-11-02 - **#27 真机通过**：用户在 desktop 上 `register(work/dsh-host)` → `list` 显示「**现有 59 条**」，与注册前自生长清单里的 `work/dsh-host(59)` 逐位一致；`?? 0` 分支也未被误伤（有绑定即显示真数）。 - **修掉这次验证顺带查出的口径缺陷**（`memory_room_admin` 的 `action=list`）：`grownOnly` 原先用 `roomRegistry.list()`（**含 retired**）排除自生长项，而归类词表面（`room-review.ts`）用 `listActive()`。两侧口径不一致的后果是——**一个 slug 退役后，它既不在注册表活跃词表里、又被从「自生长未注册」清单排除，若它还挂着记录，那些记录的 Room 归属就在两个面上同时隐形**，且没有任何动作能把它找回来（工具面只有 `retire`，无 un-retire；恢复只能走 RPC `dsh-memory/room-admin` 的 `action=retire, active:true`，工具没暴露该参数）。现改为按 `activeSlugs` 排除，退役项回到自生长面继续可见可计数。 - **额度显示同步**：`注册表 N 条(上限 200)` 原先把 retired 条目也计入 N（占额度视觉位），现 N = 活跃条目数，并在存在退役项时追加「已退役 M 条（不占额度、可用面板「恢复」切回 active）」。退役条目本身仍列在明细里并标 `[source/retired]`，便于恢复。 - **测试**：新增 `tests/room-admin-list.test.ts` 3 例（注册项真计数 / 退役后两侧口径一致 / 零绑定仍显示 0）。**红绿已验**：把排除集退回修复前的 `registry.some(...)` 写法后 1 例转红，恢复即全绿。全量 **1901 例 / 190 文件**。 - **冒烟脚本去钉版**：`scripts/verify-desktop-smoke.mjs` 的版本断言从等值改为 `0.26.` 族前缀（上一版每发一次就得改脚本，是自我制造的维护债）；同时清掉两个未使用变量使 lint 归零。 ## [0.26.21] — 2026-11-02 - **#20 追加修复：DRSC 读面从 HTTP 改为进程内直调**。桌面宿主在**任何**注册路由之前有一道 pre-dispatch 鉴权（`isAuthenticated` 只认由 `requestAudience(Host)` 派生的签名 cookie，豁免分支仅 `GET /?token=` 与已认证的 `GET /`），而插件服务端 `fetch` 既无 cookie 也无可取用 launch token 的服务面（该字段是宿主 `BrowserAuth` 私有）。真机实测确认：基址修对后请求确实发出、参数形状正确，但仍被回 `401` —— 即上一版只解决了「打错端口」，没解决「打不通」。本版新增 `src/clients/drsc-inproc.ts`，直调 collector 导出的只读查询面（`resolveIndexDir` → `openProjectionStore` → `createQueryContext` → `search` / `sessionDetail` / `listSessions`），全程不碰 `ProjectionSync` 写侧引擎，故不会与 collector 自身的同步器抢水位、也不会多挂一个 interval；索引库为 WAL（实测同目录有 `-wal`/`-shm`），宿主持写连接时本侧只读句柄可并发读，且句柄只开一次（常驻 summaries 是内存 Map，每请求重开等于重扫全表）。 - **传输分流规则**：只有「显式 HTTP 意图」才走 fetch —— 即配了 `baseUrl`（跨机/自托管 collector）或调用方注入 `fetchImpl`。两者皆未给时走进程内。四个读点仍汇聚在 `getJson`，查询串形状与旧 HTTP 逐字一致，因此字段映射、「`session=null` → 空数组」「limit 钳位」「`redact` 硬臂」这些口径全部不变；进程内读失败同样包成 `DrscClientError`，调用方的「显式报错 vs 空窗降级」分面处理不受影响。 - **真数据端到端自证**：以真实 collector 模块 + 真实索引库驱动，直调与走适配器的 `tail:4` / 全量两条臂返回**逐位一致的 seq 序列**（4 行 / 1770 行）；`DrscClient.sessionTail` 得到 4 行且 `role/kind/time/text` 映射正常，`search('端口')` 命中 3 条含 snippet，`listSessions` total=103。新增 `tests/drsc-inproc.test.ts`（参数映射 + 句柄单次开启 + 载入失败不缓存 rejection 以自愈）与 `drsc-client.test.ts` 的传输分流用例，合计 12 例；全量 **1898 例 / 189 文件**。 - **过程中修掉两处自身缺陷**：① `{ limit: undefined }` 会让 `'limit' in opts` 为真，而 collector 可能据此走钳位分支 —— 改为非法/缺省时整个键缺席；② 适配器误把 `openProjectionStore` 的返回值丢弃、试图从模块上读一个不存在的属性取句柄 —— 已改回持有返回值。 ## [0.26.20] — 2026-11-02 - **内部命名与计划对齐**：共用取数助手按其计划原名 `mergeRoomCatalog()` 落地（0.26.18/0.26.19 线上产物里叫 `roomCountsBySlug()`，功能与形状不变，纯内部导出名，无外部消费方）。同时重写该函数的文档注释：原先「四处同形中三处已正确」的表述不准确，现按实证写明 rooms-export / room-admin list / 候选词表三处已接，而 rooms-get 端点除计数外还要把注册表 `source`/`label` 覆盖回已存在条目，属不同形状，有意不接（该处就地留了说明注释）。 - **真机启动自证（新）**：在隔离的一次性 profile `t44probe`（`--from-default-profile web` 新建，不触碰任何现有 profile）上安装 `dsh-prime-memory@0.26.19` 与 `dsh-reference-session-collector`，以 `dsh --profile t44probe` 启动宿主：正常起立于 `http://127.0.0.1:3080/`，token 换 cookie 后根路径 200，装载全程无 compat 报错、无拒载（该线 `engines.dsh` 0.2.0-rc.2 在声明内）。**注意边界**：本自证只覆盖「装载与启动不异常」，#20 的随机端口探针分支仍未在此验证 —— web 线宿主端口是固定默认 3080，随机监听口只存在于桌面端宿主，该分支仍待桌面端装机冒烟。 ## [0.26.19] — 2026-11-02 - **#20 加固（属性测试 + 形状一致）**：新增 `resolveDrscBaseUrl` 优先级的确定性属性测试（固定种子 mulberry32，400 + 300 组随机组合），钉住四条不变式：显式值恒为终值、有非空 trustedHosts 条目时 origin 不得抢位、origin 只替换那句 8080、前两档之外的来源一律不回显 Host 头。**该测试首遍即抓出一处真实形状不一致**：显式值/条目分支会给裸 authority 补 `http://` 前缀，而新增的 origin 分支原样透传不补——若调用方递的是 `127.0.0.1:` 这类 authority（而非宿主 `getOrigin()` 返回的全 URL），就会拼出无 scheme 的基址。已抽单一 `withScheme()` 让三档共用同一规范化。 - **有效性已红绿验证**：临时把 origin 抬到 trustedHosts 之上（正是计划里判为回归的那个错误改法）后，5 例转红；恢复即全绿。全量 **1886 例**/188 文件。 ## [0.26.18] — 2026-11-02 > **Room 词表真计数修复(issue #27)：注册条目不再显示「现有 0 条」。本版会改变 LLM 归类分布，独立成版以给回滚位与观察窗。** ### 修复 - **注册条目的计数从 `listRooms()` 回查**：候选预标记(`annotateOrphanCandidates`)合并词表时，注册表条目被写死 `count: 0`，而未注册的自生长项带真计数。归类器被要求「优先从现有 Room 词表里选」，而计数是它唯一能看到的规模证据——证据方向与规则**恰好相反**：按推荐用法先 pre-register 一张词表，这张词表里每一项就立即变成空壳，历史上自生长出来的碎片 slug 反而看着像主仓。净效果正是 annotate 本来要防的那件事：词表碎片化。`?? 0` 保留原语义——只有「注册了但库里确实零绑定」的新 Room 才显示 0（那正是这个 0 本来想表达的意思）。 - **取数口径单点化**：同一句「注册表条目的真实计数」本仓写了四处，其中三处已是对的形态（`stats.ts` rooms-export、`tools` room-admin list、以及候选词表本该有的形态），只有候选词表这处写死成 0——有本地定义就有分叉位。抽 `roomCountsBySlug()` 供 annotate / room-admin list / rooms-export 三处共用，顺手消除 room-admin list 里对每个注册条目的线性 `find`（上限 200 条注册表 × N 个 Room）。`stats.ts:1044` 的 rooms-get 条目形态带 `source`、排序 grown 优先且计数本就没丢，与词表不同形，故未强并以免改到面板输出形状。 - **补 count 路径测试两例**：`tests/room-review.test.ts` 原先两个 annotate 用例都注入自己的 annotator 且忽略 catalog、`io()` 默认不带 registry，**count 路径零覆盖**——这是写死 0 能活过 5 个版本的直接原因。新增「注册条目回查真计数」（修复前必红，实测报 `expected +0 to be 1`，与报告人自述的红绿结果逐字一致）与「注册零绑定仍为 0」（锁住不误伤原语义），另加 `roomCountsBySlug` 口径一例。 ### 行为边界（说清它不只是个计数） - 本修复会改变发给归类器的 prompt 内容，因而**可能改变归类分布**：大 Room 拿到更强信号后可能更抑新 slug 生长（冷启动无处归）。这是修复目的而非纯 bug，故独立成版；若观察到新 Room 实在挂不上，revert 本版单个 commit 即可，不牵连 0.26.17 的三条声明面修复。 - **未一并做**（另立案，原因记在计划产物里）：把注册表的 `label`/`description` 渲染进 prompt、调 `.slice(0, 40)` 窗口。annotate 是逐条一次 LLM 调用且无 prompt 前缀缓存（同一张词表作为 system 被重复发 40 次），把窗口抬到 120 并塞 label+description 会让每轮仅词表就吃掉 14-24 万 input token，需先有归类分布的可观测指标。 - 全量 **1883 例**/188 文件绿（本版在 0.26.17 的 1880 例之上加 3 例）。 ## [0.26.17] — 2026-11-02 > **三条声明面修复：`memory:profile` 显式关插值(issue #24)、`memory_conflicts` 补两笔成熟度声明(issue #23)、DRSC 基址不再写死 8080(issue #20)**，并把「改视图忘改 schema」从注释纪律改成 CI 闸。无配置变更、无默认行为变更、`engines.dsh` 不动。 ### 修复 - **`memory:profile` 关插值(#24)**：宿主对 systemPrompt 贡献项的 `interpolate` **缺省按 true 处理**，而画像正文由蒸馏产出、库里可能存着宿主自己发的字面 `{{TYPE_id}}` 脱敏 token——不合 `/^[a-z][a-z0-9_]*$/` 即在 prompt 组装期抛错、**整轮报废**。该正文从来不含宿主变量，插值只有风险没有收益，故注册时显式 `interpolate: false` 按原文注入。全 `src` 实测 `systemPrompt.context/section` 只有这一处注册点。 - **`memory_conflicts` 补声明(#23)**：Phase 3 arm-2/arm-3 给视图加的两笔成熟度旁注(`maturityOf`)没同步到输出 schema，而该 schema 是 `additionalProperties: false`——宿主无损校验对每条返回逐字段拒结，工具自 0.26.11 起**任何调用都读不出**（`memory_resolve_conflict` 的描述还在把人往它指，公示的「先看后裁决」工作流事实上断链）。补 `winner_maturity`/`loser_maturity` 两键（用 `enum ['low','mid','high']` 钉死 `computeMaturity` 的三档值域）。该文件自己就写着「schema 必须跟视图同步」——纪律在注释里，闸在运行期，两者此前没有任何机械约束连着。 - **DRSC 基址取宿主真实监听口(#20)**：`trustedHosts` 为空时回退写死 `http://127.0.0.1:8080`，而 DSH Desktop App 走随机端口 → `conversation_search` 与蒸馏背景窗在**默认配置下必坏**（0.26.x 的 L0 正文已停写、历史面完全依赖 DRSC，这条链是 load-bearing 的，不是可选增强）。现在第三档兜底取宿主监听 origin，取数逻辑抽到 `src/clients/web-server-origin.ts`（两条取数路径 + 三个抛错入口，需被单测钉住，而不是靠人肉真机核对）。**优先级与降级面钉死四件事**：① origin 只替换那句 8080，不抢 `trustedHosts` 位——现状 `explicit` 是死分支（插件没有该设置项），唯一真实旋钮是宿主 trustedHosts，放上去会把靠 `--trusted-host` 已能工作的用户改到另一个 authority，那是回归；② **优先 `getOrigin()`、再退 `port`**——两条宿主线不同形，已逐线实测取证，别拿一条线当事实：0.2.0-rc.2 源码仓的 webServer **没有** getOrigin（只有 `get port()`/`get host()`），而 0.2.1-rc.5 装机宿主（app.asar 类体）**已有** `getOrigin()`，返回 `${protocol}//${bindUrlHost(host)}:${listenedPort}`，protocol 认 TLS、bind host 走 URL 形式转换，这两个细节插件自己算不出；③ Host 头只在存在非空 trustedHosts 条目时回显（与旧版逐字同口径）——collector 信任门精确匹配 authority，拿条目原串去配带真实端口的 URL 只会把「端口不对」换成「Host 不被信任」；collector 把路由注册在宿主 webServer 上（同监听口），所以宿主 origin 就是正确基址；④ `getOrigin()` 在未 listen / 绑定地址带 zone id 时**主动抛错**（宿主类体原话：`origin read before the listener bound a port`），退 `port` 时又必须 `typeof port === 'number' && port > 0`（`listenedPort` 未 listen 读到 undefined，naive 拼接会产出 `http://127.0.0.1:undefined` 这种能发出但永远错的 URL）——取不到/抛错一律返回 undefined = **逐字节等价旧行为**。`inject` 未动（`webServer` 已在声明里），故老线零变更、`engines.dsh` 不动。 ### 纪律 - 新增 `tests/tool-output-view-sync.test.ts`：对读工具**真实执行一次**，把返回对象的键路径拿去对照它自己声明的 `output.schema`，多一个键即红（`additionalProperties: false` 下这正是宿主的拒绝判据）。同文件另扫每个 `systemPrompt.context({`/`section({` 入参块必须显式含 `interpolate`。两条守卫均已做**红绿验证**：临时撤掉 #23/#24 的修复 → 分别报出 `$.items[0].winner_maturity` 与 `src/hooks/recall.ts:892`。 - 覆盖面边界（文件头已如实标注）：只守「未声明的多余键」这一种（即 #23 的形状），不校验值类型/枚举，不含会改库的写侧工具。 - 全量 **1880 例**/188 文件绿（基线 1863 例/186 文件；本版新增 ests/tool-output-view-sync.test.ts 10 例与 ests/web-server-origin.test.ts 7 例）。 ## [0.26.15] — 2026-10-28 > 真宿主验证（1197 条 L1 / 380 条 `work_method` 的真实库副本）发现 0.26.14 的**写放大**缺陷，本版修掉。单测没抱住它，因为夹具只有几条记录。 ### 修复 - **证据整批落盘**：`absorbGroup` 原先逐条 `await appendEvidence()`，而每次调用都是一次全文件重写 → 首轮回灌 379 条证据 = 379 次落盘。新增 `SkillStore.appendEvidenceBatch(rows)`（整批一次 persist），生产者改走该入口。 - **空跑不写盘**：对已存在候选原先无条件 `update({ steps })`，导致一轮回灌即使 `created=0 / appended=0` 仍把 sidecar 全量重写 240 次（实测 `rev` 从 1262 跳到 1742）。现在先 `sameSteps` 比对，未变则跳过。 - **晋升时序修正**：`tryPromote` 改到证据**整批落盘之后**逐个判，否则 `sessionCount` 看不到本轮新会话。 - 新增用例「空跑不写盘」（spy 断言 `update`/`appendEvidenceBatch` 零调用）；全量 **1859 例**/186 文件绿。 - 功能面与 0.26.14 一致（生产者 + backfill + 诚实化），无配置变更、无默认行为变更。 ## [0.26.14] — 2026-10-28 > 修复 issue #15：「技能结晶」自上线以来**根本没有生产者**——`detectCandidates` 与 `SkillStore.create()` 在全仓**只有测试调用点**，所以 `skills.json` 永远不会被生成，看板恒为 0。用户打开 `skillsEnabled` 开关后拿到的是一个空盒子，而且不报错、不提示，只能翻源码才知道功能没接上。 ### 修复 - **接入生产者（新增 `src/skills/producer.ts`）**，两条路径共用一套分组语义： - **稳态增量**：挂在 `runner.runTurn` 的 L2 攒批块之后，吃本轮新出的 `work_method` 记录 + 本轮 `sessionId`。0 全表扫描、0 LLM、0 token，不新增 timer。 - **一次性回灌**（`backfill`）：分页 `allLite` 扫存量→`getByIds` 取正文→从 `metadata.dsh_source_anchors` 复原会话归属，让老库不必再跨 N 个会话才见第一条技能。**缺锚点的记录直接跳过并计数，绝不伪造会话**（那会虚增 distinct-session 骗过晋升门）。 - 两条路径共用 `crystallize.ts` 导出的 `groupKey`/`fnv1a`（新增单测直接断言两路算出的候选 id 逐字相同）——否则同一组会结晶出两个候选，幂等崩。 - **`sessionCount` 只数 `evidence` 行**（不看 `evidenceRecordIds`）——所以上线版只 `create()` 不投证据的话，即使 `allowPromote` 打开也永不晋升。生产者逐记录 `appendEvidence`，去重键是 **(skill, session, record) 三元组**而非二元组：一条历史记录可映射到多个会话，按二元组去重会抹掉第 2、3 个会话。 - **失败隔离**：技能写库异常全部内化为 `summary.errors` + `logger.warn`，**不得抛穿蒸馏轮次**；`MemoryStores.skills` 为可选字段，未装配时整条路径跳过（既有 186 个测试文件的 store 桩都不带该字段，全绿即零回归证据）。 - **诚实化（issue 建议 2/3）**： - 面板空态拆三态（旧宿主无 `producer` 字段 / 池里没原料 / 有原料但未达阈），不再用一句「暂无技能」糊过去；未启用文案去掉「重复工作流会固化为技能候选」这句当时做不到的承诺。 - `skillsEnabled=true` 但 `skills.json` 从未生成时，启动日志留一条可 grep 的 warning。 - 新增 `dsh-memory/skills-detect` RPC（需「高权限模式」，与 `skills-action` 同门）与面板「立即检测历史」按钮；`skills-list` 附 `producer` 健康态。 - **`minEvidence` 首次真实生效**：此前三处（store / RPC / 检测）都没消费它。现在自动晋升需 distinct-session ≥ `minSessions` **且** 证据条数 ≥ `minEvidence`；人工晋升仍只卡会话数（人审是人的判断）。 - **不变量保留**：`body`（人编辑区）不被机器侧覆盖，二次检测只重写 `steps`；技能仍不是 memory `type`（不碰 `ADD_TYPES` 与蒸馏 prompt 词表）；不给 `l1_records` 加列。 - **默认行为不变**：`skills.enabled` 与 `allowPromote` **仍默认关**。本版只保证「开了开关就有生产者」；候选需人工审阅晋升（自动晋升需显式开启）。 - **已知局限（另立轨 3 issue）**：分组键是精确 `(hall, scene_name)` + 字面去重，语义等价但措辞不同的方法会散到不同组（假阴性）。要修得靠 LLM 判同/命名，会破坏轨 2 的可解释性与 `skx-` 幂等 id 保证，因此独立演进。 - 测试：新增 `tests/skill-producer.test.ts` 15 例（磁盘真落盘 + 证据非空、幂等、双阈两档、body 不被覆盖、backfill 分页/缺锚点/与增量不重复、失败隔离）；全量 **1858 例**/186 文件绿，三配置 typecheck 与 lint 零新增错。 ## [0.26.13] — 2026-10-28 > 修复 issue #19：单条 L1 priority 越界（如 LLM 回 `-1`）经无夹取写点落库后，`memoryRecall` 投影的 `viewSchema` 严格校验（判非负整数）抛错 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据打死整个会话历史**。 ### 修复 - **双防线**： - **写侧夹取（防新增）**：新建 `src/util/priority.ts` 单源 `clampPriority`（非有限→回落缺省、小数 `Math.round`、夹到整数 `[0,100]`），L1 抽取/合并构造（`pipeline/l1.ts` 两处）、upsert 绑定层（`store/sqlite.ts`，保留历史缺省 50）、MD 导入解析（`store/memory-md-parse.ts`）统一走同一夹取。 - **读侧兜底（自愈存量）**：投影 `makeView` 遇脏 priority 就地夹取并 `warn`（带 record id + 原值），绝不让单条脏字段打死整会话。因升级必重启宿主、`viewMemo`（进程内 WeakMap）随之清空，脏行读时被夹取 → **存量脏数据无需手动改库、无需迁移**。 - 保留 `viewSchema` 严格校验（纵深防御仍在，只是喂进去的已是干净值）；合法 0–100 整数读写逐字不变；`slots.ts` 的同名私有 `clampPriority`（floor/50，memorySlots 另一条链）不受影响。 - 本版叠加在 0.26.12（DSH 0.2.1-rc.4 适配）之上，`latest` 与 `dsh-0.2.1-rc.4` dist-tag 同指本版。 ## [0.26.12] — 2026-10-28 > 0.26.12: host enumeration addendum for DSH 0.2.1-rc.4 (declaration-only bump; contract plane zero diff). `engines.dsh`/`dsh.plugin.json`/README 同串补 `0.2.1-rc.4` 枚举行（19 档）。 ## [0.26.11] — 2026-10-27 > 本版闭环三条外部 issue：#12（两级 Room slug 写不进）、#13（默认路由表硬编码作者本机路径）、#14（重建以已写停的 L0 为事实源）、#16（图谱投影只有配置文件开关）。 ### 修复 - **`memory_room_review` 写不进两级 Room slug（#12）**：`parseRoomCandidateItems` 与 `confirmReview` 两处仍用单级 `isTag()` —— 注册表收得下的 `mpu/qos` 在候选阶段被静默丢弃、在 confirm 时被判非法并返回 `null`（错误文案又把三种原因混成一条）。两处改 `isRoomSlug()`，形状约束不变（`a/b/c`、`/qos`、`mpu/` 仍拒）。 - **两级 slug 的另一半：候选标注提示词**只写「小写字母/数字/连字符」，模型被教成只产单级 —— 即使写回修好，两级仍只能靠人工补。已补明「两级制写成 `大类/子类`，全串至多一个斜杠」。 - **`rooms-export kind=records` 的 `tag` 零校验**：与 `list-records` 的严格口径不一致，非法 slug 会静默返回空 CSV。改为同口径校验。 - **重建会丢「L0 停写之后」的记忆（#14）**：`planPreserve` 只按「有无 `source_message_ids`」判可重蒸，而 L0 正文自 T8.4 起已停写 —— 停写后新增的 L1 记录**有**来源 id、但那些消息在本地已查不到，清库后蒸不出来，等于事实丢失。新增保留理由 `post-watermark`：用**集合判据**（来源 id 是否全部落在本次 L0 快照内）判定，而非时间差。 - **`workspace-relink` 空路由表的静默空转（#13 连带）**：`routes.length===0` 时旧行为返回全零报告，面板显示「扫 0 / 剩 0」看起来像「已完成」。改为显式报错「未配置任何内容路由规则」。 ### 新增 - **知识图谱投影面板开关（#16）**：`live.graphEnabled`（概览 → 知识图谱 → 知识图谱投影），与部署 `graph.enabled` **取或**。过去的入口只住 YAML，而面板上「图谱投影」四个字其实是**蒸馏预算的分层标签**（点它改的是 token 预算）。 - **首次开启前的成本确认**：开启时先查待投影条数（新增 `GraphStore.countMissing`，与 `queueMissing` 同一段 WHERE），给出条数/作业数/预计耗时再让人决定。投影是逐批走 LLM 的（每批 8 条、单批约 2 分钟）。 - **重建面板的三行真相**：确认弹窗新增「事实源覆盖到 X 时间」，运行态新增「可重造 N 条 / 原样保留 M 条」。旧界面只报 L0 体量与预计调用数，看不出「这次重建只覆盖到某时刻」。 ### 变更（行为） - **默认 `workspaceSource.routes` 由两条改为 `[]`（#13）**：旧默认写死了 `E:\test\rewrite-agently` 与 `E:\test\agent-no-dsh` —— 装好即生效，凡正文含 `dsh`/`cordis`/`prime-memory` 等词的记忆都被写上了别人机器上的路径；`scope: workspace` 时这些记录在真实工作区里按 workspace 过滤**不可见**，表现为“记忆莫名其妙丢了”。 - `enabled` 仍为 `true`；空表时归属列留空、全部落单根，写路径行为与 `enabled:false` 等价。 - **存量用户若依赖旧默认归类**，需在配置里自行写下自己的 `{path, anyOf}` 规则；否则新记录一律落 `/memories`，仓内 `.agents/memory` 成为冻结旧树。 - **重建的两道门（#14）**：① 硬拒——本地 L0 一条消息都没有而检索库有记录（那种形状下重建只会清空）；② 提示——检索库里晚于 L0 水位的记录占比 > 50% 时要求带 `force` 二次确认（**不是**永久拒绝：L0 停写后这个比例只会上涨，硬拒等于把重建锁死）。 - **图谱投影的开关判据统一为 `graphFeatureOn(cfg, live)`**：五处（启动补投影 / 周期泵 / enqueue / reproject / maybeQueue）+ 两个写面工具同一判据。以前只改一半就会出现半开态（队列只涨不取 / 运行时开启后存量永不进图）。 - **两个图谱 timer 改为无条件注册、tick 内判门**：否则运行时开启后存量要等重启才补。另加 `loader/volatile-update` 监听，热开启即时补一批。 - **关闭期写入会抹「已投影」凭证**：`graph_projected_records` 只按 `record_id + projector_version` 记账、不记内容版本，关闭期改过的记录若不抹凭证，重开后 `queueMissing` 会认为投过了而**永不补**，图谱内容永久陈旧。 - **三处图谱文案单源化**（`client/src/copy.ts`）：开关＝「知识图谱」、封印行＝「图谱读工具」、预算行＝「图谱投影预算」。旧的「图谱工具」与「图谱投影」撞名是 #16 的根因。 ### 测试 - 新增 17 个用例：`post-watermark` 各分支（全部⊆快照/部分缺失/跨 `drsc:` 域/空来源/已退场/空内容/中文摘要）、重建两道门（硬拒含 force 不豁免 / 水位超阈值的拒绝与放行）、`graphFeatureOn` 四象限 + live 抛错、`countMissing` 与 `queueMissing` 同口径、`invalidateProjected` 幂等。 - 全量：183 文件 / 1822 用例全绿；`tsc` 三配置零错；`eslint` 0 error。 0.26.10: host enumeration addendum for DSH 0.2.1-rc.3 (declaration-only bump; contract plane zero diff). ## [0.26.9] — 2026-10-23 > 本版汇总自 0.26.6 起的「蒸馏分块分载与调度健壮性」工作（计划 distill-load-balance，[ADR-0023](./docs/adr/0023-distill-load-balance-and-secondary-route.md)）。0.26.7/0.26.8 仅本地装机、未发布，版本号并入此条。 ### 新增 - **抽取块级容错 + 部分消费（R1′）**：`runExtraction` 每个抽取块独立 try/catch——单块超时/JSON 崩只丢该块并留待重试、下轮重投，成功块照常进去重+落库。旧行为是任一块崩整批抛穿、整片退回待重试（"114 条永不清零"的主因之一）。全块失败仍等价旧"整抛"（不误当零产出成功）。 - **L2 场景整合分块（R1）**：`runSceneConsolidation` 按字符预算（24k 硬顶）切块逐块整合，单块路径与改前逐字一致（零漂移）；多块时跨块合并判断为近似（诚实降级）。治"大库整族 backlog 单调用必超时"。 - **二线大容量兜底（R3）**：`llm.secondary{provider,model,reasoningEffort,triggerChars}`——单次调用输入 ≥ `triggerChars`（默认 20000）才前置二线，肥调用走能吞大输入的二线、小调用走一线。未配则不启用、绝不静默改选任意模型。 - **fail-closed 显式路由（R4）**：`llm.requireExplicitRoute`（默认 false 灰度）开启后，一线+二线+回退链皆空 → 抛 `NoDistillRouteError`、蒸馏顺延并告警、**不记退避**，不再蹭宿主 `agentDefaultModel`（区分"没配"与"模型慢"）。 - **路由健康学习（R9，本版已接线）**：`RouteHealthStore`（`distill-route-health.json` sidecar，读 fail-open、只降不升、陈旧过期）记某路由跑通的最小块长，`runExtraction` 读它收紧 perChunk、成功块回记，跨进程免重付退避风暴。 - **面板可调蒸馏超时（R10）**：设置 → 记忆 → 蒸馏参数 → **蒸馏超时(ms)**（`distillTimeoutMs`，运行时 volatile 覆盖 `llm.timeoutMs`，即时生效）。仅治"慢但未被网关掐"的路由；供应商网关侧固定掐断（如某些免费路由 60s）抬此值无效，须换路由。 - **整轮抽取墙钟预算 + 模型上限（R5）**：`llm.extractTimeBudgetMs`（默认 0=不限）超预算把剩余块留待重试下轮续，防一个慢模型独占后台串行泵；`llm.modelMaxInputChars`（默认 0=未声明）声明模型真实输入上限，perChunk 取 `min(24k, 本值−42k)`。 - **反刍豁免退避（R6）/ live flush 队列去重（R7）**：反刍与 rebuild 同为用户显式动作，越过抽取退避；同一 `(session,mode)` 未消费的 force-flush 任务去重，治"一次长阻塞→积压排空刷屏"。 ### 变更 - **默认输入闸门 `llm.maxInputChars` 700000 → 200000（schema 上限 1000000 → 256000）**：旧默认是远超本地/免费模型窗口的盲值；新默认让 `callLLM` 那道"最后截断闸门"符合本地模型可参与区间。注意 L1 抽取/L2 分块另有 24k 硬顶，不受此值影响；改默认主要防"下一批大调用噎住本地模型"，不改变分块大小。 - **`engines.dsh` 去重**：package.json 尾部误加的重复 `|| 0.2.1-rc.1 || 0.2.1-rc.2` 已删，与 dsh.plugin.json 及各 peer 串逐字同串（跨宿主 6 条 RC 线兼容面不变）。 ### 已知限制 / 预留 - **去重批容错与 checkpoint 续跑（R1″）未做**：去重阶段某批崩仍是整轮抛穿（整片保留 + 下轮从抽取重跑，无数据丢失但重付抽取成本）。当前治法是为去重/大输入换一条不被网关掐的路由（如二线）。 - **L3 分块（R2）/ sinceL2 连续失败停攒（R8）未做**：persona 单文档整合分块伤连贯性、收益低于风险；L2 分块后慢性重面积压已缓解。 - **`llm.chunkShrinkFactor` / `chunkShrinkMaxSteps` / `adaptiveChunk` 为预留配置，当前版本未接线生效**（同轮内超时 ×0.6 缩块尚未实现）——设了不影响行为，请勿依赖。 ## [0.26.6] — 2026-10-22 ### 新增 - **图谱确定性写面（计划 graph-write-plane）**：写面从"add/delete/import"补齐"改、重投、迁"三语义。 - `memory_update`（高权限）：修订一条既有记忆——就地产新版本（version+1，新 id），旧版经退场汇流口 `superseded` 软删（可恢复），随后对 [旧,新] 强制重投让图谱边跟随；extKey 不随血缘走（幂等索引由旧行占位）。 - `memory_reproject`（需 `graph.enabled`）：抹掉"已按当前版本投影"凭证、按高优先级重新入队——绕开 `projector_version` 永久跳过；幂等（在途任务不堆重）。手加/导入的记忆长期不出现在图谱里的纠正通道。 - `memory_migrate_relation`（高权限）：源导式关系迁移——硬校验来源全部"现存未退场"（判据单源 `classifyValidity`）→ 显式边提案经 `applyGraphProjection` 纯函数校验落库（同 (起点,关系) 换目标自动闭旧边 出新边）→ 新增承载新关系的 L1 源记录留可回溯根据（metadata `proposal_source='tool'` + 决策凭证）。 全程不提供、也不会提供绕过投影直写 `graph_*` 表的入口（零无源事实不变量）。 - **非蒸馏写入自动入投影队**：`memory_add`/`memory_import` 与蒸馏产出同优先级（`GRAPH_PRIORITY_NEW`）进队—— 闭合"只有蒸馏才投影"的旁路缺口（手加记录 projected=None 的真根因）。图谱向量路缺陷同步修复： 嵌入启用时投影收尾为落库的 active 节点补写 `graph_node_vec`（旧版本该调用生产零落点、全库 0 行）。 - **记忆时效三档与工具反查（计划 expiry-tiering，ADR-0022）**：退场方式/有效性定性/持续性/现实有效期 四轴正交，六态（current/historical/expired/expired_suspect/superseded/retired）判据单源 `classifyValidity`（查询期谓词， 不落库翻态）；`dsh_validity` metadata 标注落写侧汇流口（证据链 activity_*→evidence、工具直填→llm_inferred、 兜底→unknown）。门2 灰度闸 `validity.tieringEnabled`（默认关）：开时被动注入剔 `expired`、`expired_suspect` 保留带"疑似失效"标注，召回卡显示 `validity`/`validUntil`。门3：`memory_search` 新增 `include_expired` / `as_of`（有效期回放，不复活退场）/ `follow_supersede`（顺/逆取代链）三参数，全缺省时输出与改前逐字一致。 存量标注由零 LLM 的 `validity-backfill` 低频补齐（启动 3 分钟首轮、6h 续跑；改过的记录顺手重投图谱保鲜）。 ### 修复 - **门1 解耦：合法历史 valid_to 不再被静默遮蔽**（bugfix，不受灰度门控）：退场判据全仓改为只认取代标记 （`retiredL1Sql`/`isRetired`/md 投射层同口径一对）；`retire()` 不再闭合 valid_to，它回归纯现实有效期。 升版后首启自动做一次 FTS 全量回灌收敛误遮蔽历史（`gate1.retire-decoupled.v1` 戳幂等，日志报回灌/跳过数； 向量面由增量重嵌自动补齐或设置页手动重建加速）；面板"已退场"区/删除线/计数随之只认真退场行。 - **退场→图谱退役传播补腿（R9）**：软删/取代后按"来源是否全部退场态"重算清扫——全退场的 active/disputed 节点·边标 archived 墓碑（保留行 expand 可见），来源全部复活（restore）则拉回 active；多源支撑的节点不误杀。 - **md 同步退场收敛**：`.disable` 回灌的"已退场"判据换 marker 单源，修复同批翻转波及的"第二轮重复计数、 永不收敛 same"。 ## 0.26.2 (2026-10-18) - hosts: 追加 0.2.1-rc.2 声明面枚举（34/34 @deepseek-ai/* 宿主 peer 逐包 npm 实测 rc.2 在版；本插件不触 ctx.web provider 与 conversation.input.model.label 槽，代码零改动，纯元数据发版；农场 rc.2 格挂账待命） 本文件记录 dsh-prime-memory（0.5.0 前名为 dsh-memory-plugin）的显著变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)， 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。 > **UI 截图约定**：带界面变化的条目在 `assets/changelog/<版本号>/<两位编号>-<简述>.png` > 存真机截图，并在条目内以相对路径引用，读者可在更新日志里直接看到新版本 UI 的样子。 ## [Unreleased] — 长任务模式 ### 新增 - **长任务模式(`longTask.*`,默认关)——「长跑会话」的三件套:上下文计量、任务参考、尾部压缩。** - **上下文使用量(`store/context-usage.ts`)**:监听 `assistant/message` 官方 `usage` 的输入侧(input + cache 读/写),取**最近值**语义(每轮输入侧已含全部历史,不累加);`compaction/summary` 后归零重计。纯内存 per-session Map——重启后首条 assistant 消息即可重建,持久化只会让过期样本诈尸。 - **todo 参考(`store/todo-ref.ts` + `hooks/long-task.ts`)**:监听宿主结构化 `todo/write` 事件(全量快照;包类型到 0.2.0-rc.1 未声明,插件以 declare module 自扩充——同 §E 的 dsh-compaction 先例)。**仅长任务会话**:快照刷进一张 pinned `todo` 槽位(`SlotStore.refreshByTitle` 受管刷新——同一主体反复写必须原地更新,否则 ≤8 槽上限里堆出关闭槽位尾迹),经 slot-recall 常驻注入——压缩把旧上下文逐出后,任务北极星仍在。相邻快照做词面 Jaccard 漂移检测(同快照重复写入不稀释信号);body ≤512 字节,截断明示。 - **尾部 turn 压缩(`longtask-compress-tail` 端点 + `compressTailTurns`)**:把(压缩水位线, 最新已捕获轮] 内最近 N 轮立即 `enqueue(force:true)` 蒸馏入记忆——立即把尾部对话落成可检索记忆,而不是等蒸馏阈值。水位线(`SessionModeStore.lastTailCompressedTurn`)只前进,重复按压天然幂等;off 档完全隐身;无锚点老数据只在首次压缩(水位线 0)时纳入——宁少收不重蒸。 - **建议状态(`longtask-hint-get`)以纯端点提供**:判定 = 上下文占用达 `contextThresholdPct` 或 todo 漂移达 `driftThreshold`(部署配置可调);配合 `longtask-compress-tail` 作手动压缩入口。 - **撤下浮动球 UI(`client/src/longtask-fab.ts`;beta.1 起曾随包发布)**:悬浮建议面板的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——2026-10-02 用户裁定撤下。撤下不违座位契约(settings.section 恰一个 + 输入栏 pill,body 单例不占座位),但全应用级 overlay 会与其他插件的悬浮 UI 抢占屏幕角落;长任务开关与手动压缩入口待长任务定版时落记忆设置分节。 - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。 ### 修复 - **嵌入推理子进程隔离,根治 libvips DLL 撞名(`fix #11`)**:旧路径把 transformers 推理放在 worker_threads 子线程,与宿主 Electron 同进程——插件 runtime 的 sharp/libvips 与宿主 sharp/libvips 同名不同路径时在 OS LoadLibrary 层冲突(切大模型 bge-small→bge-m3 时崩溃)。现在默认改走 `child_process.fork()` 独立子进程(`resources/embedding-child.cjs`,主线程侧 `RealChildChannel` 协议代理),DLL 表物理隔离;配置经 env `DSH_EMBED_CFG` 传递,向量经 number[][] 序列化回传(512d×32 条 ≈64KB,<5ms,实测 batch32 含序列化 91ms、单条中位数 5ms),零拷贝 transfer 降级为可忽略开销。旧 `RealWorkerChannel` 与 `embedding-worker.cjs` 保留一版作回滚逃生门(`opts.useWorker=true`,下版删);`RuntimeInstaller.isReady()` 兼验 sharp 平台原生件就位(--ignore-scripts 半装状态检出即触发重装)。真机 worker↔child 32 对向量 cosine=1.0(IEEE754 float32 往返无损)。用户无感知,非 breaking。 ## [0.26.1] — 2026-10-15 ### 新增 - **回填面板「自动恢复进度 + 扫描进度 + 诚实摘要」**：三个回填端点同时是「触发器 + 状态查询」，空闲时裸调用会**真的开跑**。新增请求体 `BackfillTriggerRequest { probe?: boolean }`——`probe:true` 只回当前快照、绝不启动；`BackfillSection` 挂载时以 resume 探测三个端点，在跑就接回轮询（离开概览区再回来不再需要手动重点）。`BackfillProgress` 加 `scanned/scanTotal`，扫描段显示「正在扫描存量 1252/1252 行…」；候选 0 时报「没有缺关键词的记录，无需回填」等**诚实摘要**（不再报“成功 0 条”被读成失败）。 - **三个批量动作「中止」开关（有界强杀）**：契约加 `cancel?: boolean`、`BackfillProgress.cancelled`；三个模块各带 `cancelXBackfill()`。中止**有界**：置信号后起一次性宽限表，到期 `runAbort.abort()` 当场捻断在飞请求；硬界由 `backfill.cancelGraceMs`（schema max 30_000、默认 15s）钳住——无论 YAML 怎么写都越不过。 - **技能工具组封印 `toolSkills`**：`memory_skill_*` 四件并入宿主封印机制（`reg('skills', …)`），与功能总开关 `skillsEnabled` 取 AND；两者都随 `loader/volatile-update` **热更**（面板拨开关即时注册/反注册，无需重启）。此前技能工具只在注册期判一次，开启后无条件常驻模型工具列表，且拨开关不热更。 ### 变更 - **全部 LLM 批处理统一「逐条串行」**：补齐 wing（`labelWingOne`/`tagOne`）、`pipeline/relabel.ts`、`room-review.ts`（`roomCandidateOne`）三处合并批——至此 5 个批处理站点全部「一个请求只装一条记忆、跑完一条再发下一条」（`concurrency` 默认 1）。依据：单条 35B 实测 ~2.6s，而一批多条一旦截断/空输出就带走整批。 - **整形排除判据改为「版本戳」**：`dsh_reshape_ver`（=2）+ `isReshapedAtCurrentVersion(meta, content)`——**仅成功写回**时盖戳；未过闸留原文**不打标记**、下轮仍可重试（旧布尔 `dsh_reshape_tried` 只作存量兼容读取）。整形规则升级时递增版本号即自动重跑旧产物。 - **`backfill.maxRecords` 默认 300**（此前误设 40，导致真机 251 条目标一次只动 40）。 ### 修复 - **轮询裸调用死循环（“不开始”真因）**：UI 的 tick 对「触发器 + 状态查询」二合一端点用裸调用 → 空闲时每 3s 又开一轮，面板永远停在“正在扫描”。tick 改 `{ probe: true }`。 - **批扫全部空输出真因：把思考模型当直答模型用**：`LlmCallOptions` 加**调用级 `reasoningEffort` 覆盖**，五个批扫标注器显式传 `'off'`——此前路由档位为 `""`（自动）时思考模型默认开思考，预算被 reasoning 吃光、正文 0 字符（真机 162 次失败中 156 次是 `local-9b` 空输出）。 - **`client/src/ui/MarkdownBody.tsx` typecheck 红**：0.26.0 带入的 4 处 `string | undefined`（正则捕获组）在 `noUncheckedIndexedAccess` 下报错，加非空断言。 ## [0.26.0] — 2026-10-14 ### 新增 - **存量记忆重蒸馏整形（`redistill`）**：新增独立回填批扫 `src/redistill-backfill.ts`（镜像 wing/keyword 回填：单飞/后台/有界/失败原记录不动），把**活跃且骨架不齐备**的存量 L1 正文按 G2 分类型「前因后果」骨架重排，并顺带产 `metadata.dsh_keywords` / `metadata.dsh_usage_scenario`。新端点 `dsh-memory/redistill-backfill`（立即返回 `{started,running,enabled,updated,skipped,failed}`）、面板（WingWheel）加「重蒸馏整形」按钮。配置 `redistill.enabled` **默认关**——关时不整形、content/FTS/投射逐字不变（零漂移）。 - **质量闸**：只有整形后 `scoreSkeleton` 骨架命中数**严格更优**才写回，并盖整形版本戳 `dsh_reshape_ver`（下轮不再入列）；未过闸的留原文**不打标记**、下轮仍可重试——绝不为「看起来有格式」贴假标签或编造。 - **只碰活跃**：已退场/被取代的记录不补做优化。 - **改正文的持久写回路径**：整形写回走 `L1Store.appendNew`，一次完成 JSONL 事实源追加 + 重算 embedding + `l1_fts` 重索引 + `.memory.md` 投射覆盖（导出器按库重渲染、不同即覆盖），保证「库改了、检索/向量/磁盘同步跟上」。入口要求 `vectorsReady()`——嵌入未就绪时整轮跳过，避免改正文静默丢向量。 - **`dsh-memory/records-meta` 端点**：按 `record_id` 批量（≤50）取单条记忆的全量元数据与正文（name/type/priority/content/maturity/createdAt/updatedAt/scene/scope/workspaceId/keywords/usageScenario/filePath/retired），走 `stores.l1.getByIds` 直读 SQLite。记忆查看器因此**不需要读 `.memory.md` 文件**——旧方案（伪装文件名的 fileViewer）会被宿主 EditorHost 当物理路径 fsRead，必报 ENOENT。契约入 `contract.ts`，端点集 62→63（`tests/contract-keys.test.ts` 同步钉数）。 - **展示标题不再从正文猜**：召回投影 `memoryRecall` 与槽位 `refViews` 的 title 优先取 `name`（名称蒸馏产出的短标题），无 `name` 才回落正文首行。`firstLine()` 改为 markdown 感知：H1（`# xxx`）是文档标题保留作标题，H2+（`## 结论/事实`）是分节标记一律跳过——此前 `## 结论/事实` 会被当成「记忆名称」显示，而它明显是正文。 - **投射路径单一事实源 `relPathFor()`**：`renderRecord` 写盘、`records-meta` 的 `filePath`、槽位 `refViews.filePath` 三处收敛到同一算法。此前投影里另抄了一份清洗正则，同一条记忆会算出两个不同文件名——「投影给的地址」与「磁盘上的真文件」对不上，而这三处本就是给人核对同一事实的。`refViews` 同时透出 `filePath`/`workspaceId`，消费方按 `/.agents/memory/`（workspace 范围）或投射根（global）拼绝对地址。 - **检索面板正文 markdown 化**（client）：RecordsTab 展开详情走新增的 `client/src/ui/MarkdownBody.tsx`（heading 层级 / 粗体 / 行内代码 / 列表，零外部依赖），`## 结论/事实` 不再是一行裸文本。 ### 修复 - **`client-session-recalled-bundle` 回归守卫**：0.25.0 把「本会话召回」pill 渲染移交 dsh-brief-sidebar 后，该测试仍断言 pill 含召回串（发版时漏更）。改为断言 prime-memory pill **不**再重复渲染召回，保留投影接线断言。 ## [0.25.0] — 2026-10-14 ### 新增 - **关键词蒸馏回填（`metadata.dsh_keywords` 产出方）**：此前 `l1_fts` 预留的 `keywords` 检索轴因无产出方而休眠。新增独立回填批扫 `src/keyword-backfill.ts`（镜像 wing 回填：单飞/后台/有界/失败原记录不动），对缺 `dsh_keywords` 的存量 L1 逐块送 LLM 提炼关键词与使用场景，经 `normKeywords`（≤5、去重、长度钳）归一后写回。端点 `dsh-memory/keyword-backfill`（立即返回 `{started,running,enabled,updated,failed}`），面板（WingWheel）加「关键词回填」按钮。配置 `keyword.enabled` **默认关**——关时不回填、`l1_fts` 逐字不变（零漂移）。 - **`patchMetadataAndReindex`（关键词轴真能生效的关键）**：`patchMetadata` 只改 `l1_records`、不碰 `l1_fts`，回填若走它则写了关键词但 BM25 永远看不到。新增按行重索引（贯穿 MemoryDb→L1Store→backend 接口→InProc/Worker→worker 分派），回填写完元数据顺带重跑该行 fts 插入，新关键词立即进检索轴。测试含反向对照（纯 patchMetadata 不命中 / AndReindex 命中）。 ### 变更 - **输入区弹窗不再渲染本会话召回列表**：WingWheel 移除 `SessionRecalledArea`——召回展示已由 brief-sidebar 接管，输入区弹窗再渲染一份属重复（组件文件保留以备回滚）。 ## [0.24.2] — 2026-10-14 ### 新增 - **检索面板投射身份字段**：RecordsTab 卡头新增「名称」「作用范围」徽标，展开详情新增三行（名称 / 关键词 / 作用范围），帮助用户直观核对「记忆↔投射文件名」的对应关系。UiRecord 契约（`contract.ts`）加 `name`/`scope`/`workspaceId`/`keywords` 四个可选字段，`stats.ts::hitToUiRecord` 从记录本体和 `metadata.dsh_keywords` 保留键读出。 - **FTS 关键词独立检索轴（预留、休眠）**：`l1_fts` 排列改为「keywords → content」两列索引，关键词作为独立 BM25 命中轴、不与正文词频混淆；当前无关键词蒸馏产出方 ⇒ 该列恒空、检索行为与改动前逐字相同（零漂移），将来蒸馏上线无需再改表（FTS5 不能 ALTER）。 ### 变更 - **挂钩收口注释清理**：`src/` 内不再残留旧工厂名 `makeSuffixSync` 字面量（验收 grep 归零），收口结论只留一处事实源。 ## [0.24.1] — 2026-10-14 ### 新增 - **投射后缀不变式收敛（`convergeDisabledSuffix`）**：`.memory.md` / `.memory.md.disable` 只由「这条记录在库里是否退场」决定，与 `name` 无关、与「是哪条路径把它退场的」也无关。逐条按「文件存在性 + 当前后缀 + 指纹一致性」三项检查对齐；人手造的 `.disable` 是文件侧退场凭证（P2 关着时库里不知道），只报 `both` 不动盘。 - **库→文件挂钩收口到 `L1Store`（`store/memory-md-sync.ts`）**：`appendNew` / `retire` / `restore` / `rename` 四个汇流口注入 `setFileSyncHook`，取代此前散布在 8 个调用点的事件挂钩——真机 920 条退场记录只有 8 个 `.disable`，全部来自召回面板那一条路径。机器侧自动退场（合并取代、冲突判负）与模型 `memory_add` 从此自动跟随，新增调用点不会漏。 - **改名跟随**：`rename()` 之后投射文件搬到新名（`.disable` 兄弟一起走）、账本跟着换键；旧路径本就没这份时按新名补写，目标已被占用时只报不覆盖。 - **投影长任务滚动执行 + 进度条（`store/memory-md-run.ts`、新端点 `dsh-memory/mem-run-status`）**：一次点击自己把导出游标推到表尾、再把后缀收敛游标推到表尾（跨轮另有 `maxPasses` / `totalBudgetMs` 两道总闸），滚不完如实写进 `notice` 而不是停在半路；面板复用反刍/重建那根进度条。 ### 变更 - **单次文件更新预算**：`memExport.maxRecords` 默认 300 → **2000**，并新增运行时旋钮 `live.mdExportMaxRecords`（0 = 跟随部署默认，改完不必重启）。面板上名不副实的「单次动作护栏」改成 **「单次文件更新预算」**，单位说成「个文件/次」，结果行回显取自服务端**实际生效**的 `appliedMaxRecords`。 ### 修复 - **护栏数的是「遍历」而不是「碰盘动作」**：判为「未变」的条也吃配额，第二次点击扫的还是同一批前 N 条——装机量级 1210 条意味着回填要点 4 次。 - **批量落盘 O(n²)**：收敛器原本每条改名都 `ledger.flush()`（账本是整本 JSON 的原子重写），300 条 = 300 次整本重写，被墙钟 `timeBudgetMs` 拦成好几次点击。现统一「循环里只记脏、收尾落一次」。 - **紧邻两次点火互踩**：投射联动改为**后台串行**。旧写法每次点火自己开一个 promise，于是「先 `appendNew` 再 `retire`」会重叠——第二个任务的收敛器在第一个还没写出文件时判「盘上没这份」(`absent`)，退场记录就永久停在 `.memory.md` 上，直到下次全量导出才被抬回来。 - **恢复活跃后永久双份**：有效记录的「两份都在」格子原先只报账不动盘。现只在「账本同 id + `.disable` 自写下后未被手改 + `.memory.md` 那份正是当前渲染」三条同时成立时删掉那份陈年凭证，任一不成立仍交人裁决。 ## [0.24.0] — 未发布（本地线 `0.24.0-local.0…3`，2026-10-13） ### 新增 - **类型词表单一真源（`src/memory-types.ts`）**：宿主记忆分类 29 类原名 + 插件旧 7 类 + `unclassified` 兜底，共 37 类。投射目录白名单、`memory_add` 写入白名单、面板标签、抽取与去重 prompt 的枚举串、memport 的 TS/Python 双实现类型码**全部由它派生**。此前「类型全集」手抄在四处各自演化：`memory_add` 把外部分类**静默改写**成 `episodic`，而 memport 文案承诺「按原样透传」——同一件事两套口径。 - **名称蒸馏（`cfg.naming`）**：抽取当场产出 `title`，与 `content` **分离定义**（title 是回答「这条讲的是什么」的名词短语，content 是完整叙述正文）；去重 merge 一并产出 `merged_title`。落库时 `title` 只是**名字候选**，必须过 `validateTitle` 形状闸，不合格仍交给起名器——名字唯一性的真源不因多一个来源就分两套判据。 - **few-shot 标准格式示例集（`src/prompts/examples.ts`）**：分类型止例 + 反例，总长有预算上限（示例是每轮蒸馏都付的固定成本）；止例自身必须过闸门且骨架齐备，用例直接吃 `auditFewShot()` 而不是手抄判据。 - **骨架判据可执行化（`SKELETON_ELEMENTS` + `scoreSkeleton`）**：把「没有前因后果、写不全就不算可用」从提示词里的愿望变成能测、能用来定默认值的判据。声明局限：关键词启发式，只能用于同输入两臂相对比较，不是绝对质量分。 - **目录骨架 + 每类 `_index.md`（`memory-md-skeleton.ts`）**：每个类型目录放一个索引文件（类名 + 库里条数）。空目录会被 git 与压缩包吐掉，而「没这个目录」与「这类 0 条」在人眼里长得一样。幂等：内容不变零写入不刷 mtime；投射面关着时零动作。 ### 变更 - **三处默认值按 A/B 实测翻开**（`narrativeTemplates.enabled` / `naming.enabled` / `naming.fewShot`）。依据是两条**方向相反**的实测：真会话蒸馏路径无示例时骨架齐备 **0.000**（0/23）、有示例 **0.703**（26/37）；而存量改名的命名任务加了示例反而 **−0.113**（漏答 18/160）。结论：**示例不能跨任务用**，它只进抽取提示、不进命名脚本。 - **md 投射默认开**（`memExport.enabled`）：整个计划的前提是「文件为内容权威 + 库为索引」，默认关等于默认不用。`mdSync.enabled` **仍默认关**——它写库，风险不对称。 - **workspace 归属配置面改名 `workspaceHints` → `workspaceSource`**：硬改名不留兼容别名（该键从未随任何发版外发，加别名等于养第二个事实源）。默认开；路由 `path` 改存 **workspace 根**（旧值写成 `E:\test\rewrite-agently\.agents`，而 `targetFor` 会再拼 `.agents/memory` → 得到 `.agents\.agents\memory\` 孤儿树，「根不存在才退回单根」的护栏拦不住这种形状）。真机存量回填 **724/1166** 条拿到归属，`hashRecords` 逐字不变。 ### 修复 - **账本加载器把绝对键覆写进 `relPath`**：N10 之后账本键是绝对路径，而加载时那句「不一致就以键为准重写」每次加载都必然触发，实测污染 **1167/1241** 条；下游症状是孤儿归档拼出含冒号的非法目录、75 条搬家全 ENOENT。改为按 `root` + 键推导（新增 `deriveRelPath`），归档侧不再信任存下来的 `relPath`。 - **`--revert` 未兜底 hooks**：`findArchivedOld` 直接摸 `deps.hooks.exists`，而 `runCli` 调 revert 时不传 hooks（apply 侧有 `deps.hooks ?? defaultHooks`，revert 侧漏了）。沙箱第一次跑回滚就 74 条全报错。重点在危害不对称：apply 出事靠 `--revert` 退回，**回滚本身是坏的等于备份是唯一退路**。 - **跨根重复文件绕过「两边都变就不动」**：`roots = 记录落点根 ∪ 账本记过的根`，同一条记录可在两个根下各有一份文件；判定拿旧根那份、写盘走 `targetFor` 算的新根那份，于是旧根里人写的编辑把权威那份覆盖掉，而报告看起来完全合规。现只承认当前落点根，其余计入新字段 `staleRootFiles` 并显示到面板。 - **撞名把整条记忆挤出检索库**：`{ ...旧记录, id: 新 id }` 的写法会带着「已属于另一行的名字」去写库 → 撞部分唯一索引 → 批量写回退逐条仍失败 → 该条合并产物**静默消失**（旧记录已退场，这次取代什么都没留下）。起名判据由「name 为空」改为「**这个名字不属于它**」。 - **向量「待补 N 条」永不归零而「重建索引无事可做」**：展示面 `missing = total − embedded` 的分母含退场行，而退场行按设计合法地无向量；驱动补齐的两条 SQL 都排除退场行，于是同一屏同时出现「待补 114」与「无事可做」。分母口径统一为活跃行。 - **投射护栏数的是「遍历」而不是「动作」**：`maxRecords` 把判为「未变」的条也计入配额，第二次点击扫的还是同一批前 N 条——面板那句「再点一次继续」是谎话（真机症状：`已写 9 · 未变 291 · 剩余 866` 恒定不变）。改为只数碰过磁盘的条，扫描总量由 `timeBudgetMs` 兜底。 - **账本落盘 O(n²)**：`set()` 每条排一次整本 JSON 原子重写。1200 条同盘实测 **9442ms → 1954ms**（脏标记 + 合批窗口 + `flush()` 强制）。 - **`NAME_MAX`(40) 与 `NAME_CLIP_MAX`(28) 拆成两个数**：字符计数把 ASCII 与汉字同价，`dsh-agent-teams` / `Python-3.13` 一个词吃掉 15 个额度，语义上只有一两个词的正当名被判 `too-long`；而统一放 40 会让 `deriveName` 把叙述句抄成句子尾巴（实测过）。顺带修掉 `validateTitle` 里硬写的 28（同阈值两个事实源）。 - **名称闸门三处误杀**：剥引子表与拒名字表**分家**（裸主语「用户/团队」不再把「用户npm账号用户名」这类名词短语误杀，真机 10 条）；`has-id-fragment` 收窄为「非 ASCII 字符后的 4+ 位数字」（`ADR-0006`、`Han-1413141` 放行，真机 4 条）。 ### 已知边界 - 反刍收尾增量投射靠 `id→updatedAt` 基线 diff，而 relabel / 退场走 `patchMetadata` 不碰 `updated_time` ⇒ **metadata-only 改写不当轮重投**。 - P2 反向同步仍欠两项：启动自动钩子（已改为只给端点 + 按钮）、`pending` 那批未进 `conflicts` 待裁决面。 - **8 语译本自 0.20.0 起未跟进**（本次只把 0.22.0 起的条目补进去，0.20/0.21 的空档仍在，另记）。 ## [0.23.0] — 未发布（本地线 `0.23.0-local.1…8`，2026-10-12…13） ### 新增 - **md 权威投射面（P0/P1/U/N10/N11）**：`l1_records.name` 列（文件身份键 + 部分唯一索引）；`renderRecord` + 双指纹账本（`dbDigest`/`fileDigest`）+ `mem-export` / `mem-reconcile` 端点；面板「外部存档」节；投射根改为 **workspace 优先**（`/.agents/memory/<类型>/<名>.memory.md`）；判过时联动 `.memory.md.disable`。 - **P2 反向同步（文件 → 索引）**：按账本双 digest 做**三方象限**——仅文件变回灌入库并重写成规范渲染（消写回环）、仅库变复用 `exportRecords` 重写文件、**两边都变则两侧都不动**只挂 `pending`；`.disable` 走退场不删文件；来路不明的新文件只计数不入库（导入须过写入内核）。端点 `dsh-memory/mem-sync`。 - **P3 归档 + 物理删**：`exportThenPurge` 门禁由整库哈希改**批次级投影**（并发蒸馏只要改过与本批无关的任何记录，旧实现就让清理永远删不动）；删后写给人读的 `retired.md` + 把该批投射文件（含 `.disable`）搬进快照目录；`cleanup-retired` 干跑回**待删清单预览**；图投影索引表新增 `forgetRecords`（此前全仓只增不减——从快照恢复的记录因投影行仍在而被当「已投影」，**永不重投影**，检索图静默缺一条不报错）。 - **P4.1 默认类 `unclassified` + P4.2 正文版式标准化**（`normalizeContentMd`）。幂等是硬要求：不幂等就会让账本 `fileDigest` 每轮都变，写回环由渲染器自己引入。只做版式不做语义（不 bullet 化散文、不插 H1、不往正文塞元数据）。 - **孤儿投射文件归档 `dsh-memory/mem-orphans`**：只搬「账本记着我们写过、且现在没有任何记录认领这个路径」的文件；账本里没有的来路不明文件**一律不动**（那可能是人放进投射目录等着被同步回来的输入）。不删只搬，保住相对形状与原文。 ### 行为修复（召回显示面） - 召回条目不再瞬时消失：view 带 `body` / `retired`，停止摘除 `session_recalled` 行，pill 显示「已判过时」删除线旁注。 - 启动清理存量退场残留（本机实测 725 行仍脏在 `l1_fts`）；退场不变量补齐两条旁路写路径（修「标失效后检索面复活」）。 - 召回打分端到端：`-1..5`（0..5 相关度；`-1` 声明过时并退场），打分进成熟度指标（`-1/1/2` 拉低并沉底、`4/5` 抬高并上浮）。 - workspace 内容路由首次落地（dsh 生态 → `rewrite-agently`，非 dsh → `agent-no-dsh`；**只写 `workspace_id`、不动 `scope`、不动 `updated_time`**，并同步 `l1_fts` 行自带的归属列）。 ### 纪律 - memport 两个巨型函数两轮拆分（Extract Function，行为保持，CLI 金标准逐字节回归）。 - 端点契约**五处齐改**纪律持续生效（`MEMORY_ENDPOINTS ≡ switch ≡ contract 双 map ≡ contract-keys 计数 ≡ config`），计数链 55→56→57→58→59。 ## [0.22.2] — 2026-10-12 ### 新增 - 皮肤三态（auto/light/dark）+ 令牌覆写块；面板 11 Tab 单行收紧。 - `memory_import` 的 `ext_key` 幂等（`l1_records.ext_key` + 部分唯一索引 + `deduped` 回执）。 - **Memport Connect**：`.mem` 解析 / 预筛 / 扫描 + 来源注册表 + Connect Tab（跨实现 sha256 金标准对齐）。 - **技能结晶**：skill-store（JSON sidecar）+ 候选检测 + 技能召回注入 + 看板开关 `skillsEnabled`。 - G4 图谱因果边（导致 / 因为 / 修复了 / 取代，不 bump `projectorVersion`）。 - G3 成熟度读时派生（记录卡徽标 + 矛盾裁决视图旁注，不参与自动裁决）。 - G1 `usageScenario` 门控端到端（抽取 → 落 `metadata.dsh_usage_scenario` → 召回细排；off 逐字不变）。 - G2 类型叙述模板（门控 prompt 变体；off 是 on 的前缀）。 - wing / 认知 hall 两轴不串（正交访问器 + 值域不相交回归锁）。 - **G-live 本会话活召回集**：持久 sidecar + `session-recalled` 只读端点 + pill 只读列表。 - `memoryRecall` 会话感知投影（brief 侧栏「本会话召回」分区数据源，`init(header).id`）。 - `cfg.slots.migrateLegacy`（默认关）：把「钉成常驻、内容已由活 L1 承载」的 rule 槽位软退场。 ### 修复 - 反刍回灌致待处理计数还原 / 变多（ruminate 改传空消息，与 `enqueueSessionSlices` 同语义）。 - 反刍 finalize 与 `doLightRefresh` 的 L3 强制真跑 + 计数清零 + `state.save()` 落盘（修「待 L2/L3 反刍后不清、重启又弹回」）。 ### 纪律 - 全部新能力默认关，off 态产物与注入逐字不变；跨插件展示契约（`memorySlots` 投影）保持接线。 ## [0.22.1] — 2026-10-09 ### 修复 - **浮层底面改为不透明**：输入栏的记忆浮层（`.dsh-mem-popover`）与下拉 / 筛选面板（`.dsh-mem-pop`）原先跟随宿主的 `--dsw-specific-menu`，而宿主把它解析成半透明玻璃值 ⇒ 面板透出背景。现改为在**不透明 `bg-primary` 底**上叠别名层（underlay 手法），无论宿主 alpha 如何面板都是实的。 ## [0.22.0] — 2026-10-09 ### 变更 - **声明面适配 15rc**：9 条 dsh peers 覆盖全部已发布宿主 rc（`0.1.0-rc.2..0.2.0-rc.2`，逐条 `npm view` 取证且各线集合一致），全部 optional；`engines >= 0.1.0-rc.2` 作粗栅栏（精确闸门是 peers），`package.json` 与 `dsh.plugin.json` 同步。 - **双清单版本回正**：`dsh.plugin.json` 此前漂移在 `0.20.0-beta.6-dsh0.2.0.1`，本批与 `package.json` 逐字对齐（V1 门禁）。 - **`dsh.client.inject` 收缩到 `ui-primitives` only**：`dsh-client-connection` 从 0.1.2 起才作为包存在，声明它会让整个 client 入口在 0.1.0/0.1.1 上挂起（`rpc.ts` 早已惰性 `ctx.get` 该连接）。 ### 纪律 - 所有 build 型仓注入 `prepack: npm run build`——`npm pack` 只触发 prepack，不触发 `prepublishOnly`；这是 stale-build 冤案的三层防线之一。 ## [0.21.0] — 2026-10-04 ### 新增 - **工具分组封印（记忆库面板 → 记忆 → 工具封印）**:5 组开关(room 管理 / graph 图谱 / ruminate 反刍 / conflict 冲突 / mutate 写删,覆盖 13 个工具)。关闭 = 该组工具**不注册**,从模型工具列表直接消失(不是执行期拒绝);翻转经 volatile 热更即时生效,无需重启。核心读(memory_search / memory_read_scene / memory_receipts / conversation_search)与槽位三件不受控。背景:多数分组工具(如 Room 治理、反刍)日常使用频率极低,常驻工具列表徒占注意力并诱导模型误调用。 - **memory_slot_write 的 mem_ 引用存在性校验**:refs 中 `mem_*` 形态的 L1 record_id 写入前经 `getByIds` 存在性校验,幻觉/拼错的 id 直接拒绝并提示走 memory_search——保证"search 激活的记忆"进入槽位引用的必然是真实记录(brief 侧的名称简述解析因此有可靠输入)。文件路径/URL 类 refs 不校验。 ## [0.20.4] — 2026-10-04(本地构建,未发布) ### 修复 - **投影 refViews 解析全面容错**:`resolveRefViews` 内部对 L1 `getByIds` 的调用加 try/catch——registry 的 drive 无异常保护,解析层任何抛错(sqlite 忙/后端降级/记录态异常)都会带崩整条会话事件驱动乃至宿主进程。失败降级为本次帧不带 refViews(前端回落原始 refs)。 ## [0.20.3] — 2026-10-03 ### 修复 - **`memory_search` 的渲染文本补上 id**:v0.20.2 把 record_id 加进了输出 JSON 与 schema,但模型看到的是 render 产物而非原始 JSON——渲染行没带 id,对模型等于没返回(真机复测发现)。现在每条结果以 `— id: mem_xxx` 结尾,可直接写入槽位 refs。 ## [0.20.2] — 2026-10-03 ### 修复 - **投影 `memorySlots` 判脏放宽到任意事件**:此前仅在 `tool/result`(settled、非 error)时按 store rev 判脏——写入后依赖"恰好再来一条工具结果"才刷新,跨会话查看更要等查看会话自己的工具调用;真机暴露出写入后侧栏长期停在空帧。改为任意已提交事件做 O(1) rev 比较,rev 变即重建推送;isError 守卫移除(rev 只在真实变更后递增,事件只是触发器,不是数据源)。 - **常驻注入改 `` 标签帧**(对齐 dsh-agent-instructions 的 AGENTS.md 注入 house style):user 角色承载不变,但以标签框 + 权威性声明(免回应/勿复述/不覆盖系统提示与用户直接指令)呈现——修掉弱模型把槽位内容当用户发言原样复述、干扰正常回复的问题;槽位正文中的闭合标签转义(``),防止槽位内容伪造帧边界。 ### 新增 - **`memory_search` 结果透出 `id`(L1 record_id)**:解除"检索拿不到 id → 无法写槽位 refs / 喂 memory_receipts"的死锁;schema 描述注明 id 的两个去向。 - **wire view 透出 `refs` + `refViews`**:`mem_*` 类引用在投影帧构建时经 L1 `getByIds` 解析为 `[type] 名称简述`(content 首行,80 字截断),brief-sidebar(≥0.5.0-beta.2)直接渲染,路径/URL 类引用保持字面;缺失/已退场记录不产生条目。解析发生在帧构建时——引用集在写槽位时即冻结,L1 记录事后编辑不回灌旧帧。自实现 schema 对附加字段"存在才校验",旧 checkpoint 行整条通过(stateVersion 不动)。 ## [0.20.1] — 2026-10-03(转正;beta 渠道自 beta.1 起的全部能力定版) Hall·Room 分类管理全链(两级注册表/merge/rename/retire/update/收编/退场带记录/ 未注册退场补条目)、Hall 与 Room 独立管理页(搜索过滤、默认折叠、指针拖拽归类、 退场筛选)、老化权重展示 + 召回使用统计(进 topN 才算 used)。转正前最后 beta 为 0.20.0-beta.26,内容与 0.20.1 一致;`dsh-0.2.0-beta` 渠道继续收后续 beta。 ## [0.20.0-beta.26] — 2026-10-03 ### 新增(Hall/Room 增长后的可用性) - **Hall/Room 名称搜索过滤**:Hall 页新增搜索框(slug、显示名、别名,大小写不敏感) —— hall 自身命中显示全部子 room,否则只留命中的子 room,整组无命中即隐藏; 搜索时匹配组自动展开(折叠态不再藏住结果);自生长未注册区同滤。 Room 页同款搜索框,与退场筛选 chips 叠加生效。 - **Hall 分组折叠,默认全折叠**:hall 头只显示「合计 N 条 · M 个 room」,点头部或 ▸/▾ 钮展开/收起子 room;「展开全部/收起全部」批量钮;展开状态 localStorage 记忆 (`dsh.memory.halls.open`)。归类点选(点 hall 头完成归类)优先级不变。 ## [0.20.0-beta.25] — 2026-10-02 > 自生长 room 退场后状态不可见修复 + Hall 子 room 显示规则(用户裁定)。 ### 修复/变更 - **自生长未注册 room 退场即变「已退役/恢复」**:此前退场只软删记录,词表无条目可变,按钮永远是「收编/退场」。现 retire withRecords 对未注册 slug **自动补一条 grown 注册条目并置 retired**——面板行即时切到「已退役」态,「恢复」(active:true)后词表回归。持久化,重启不丢。 - **Hall 页子 room 只显示 active**:retired/退场的 room 不再出现在 hall 分组下(去 Room 页看,含「已退役」筛选);分组聚合计数随之只含 active 子类。 ## [0.20.0-beta.24] — 2026-10-02 ### 修复 - **Hall 页展开/退场与 Room 页对齐**:Hall 页 room 行展开同样只拉活跃记录(`retired:false`);退场确认后若该 room 展开中自动刷新展开区。(beta.23 仅补齐了 Room 页,Hall 页漏同步——用户实测"按退场看不到效果"的另一处。) ## [0.20.0-beta.23] — 2026-10-02 > **Room 页退场筛选补齐**(beta.22 的筛选 chips 因补丁脚本中途失败未落盘,仅徽标进了包——本次逐项 Edit 落盘并全绿验证)。 ### 修复/新增 - **退场筛选 chips**(Room 页,注册表单上方):全部 / 活跃(词表未退役)/ 已退役。 - **退场效果立现**:展开条目只拉**活跃**记录(`retired:false`)——退场后展开区即「暂无记忆条目」;退场确认后若该 room 展开中**自动刷新**;[已退场] 徽标 + 置灰兜底(beta.22 已含)。 ## [0.20.0-beta.22] — 2026-10-02 > 退场效果可见性 + Room 页退场筛选(实测反馈:退场确认后界面无变化、无从筛选)。 ### 修复/新增 - **退场效果立现**:Room 页展开条目只拉**活跃**记录(`retired:false`)——退场后展开区即显示「该 Room 暂无记忆条目」;退场确认后若该 room 正展开则**自动刷新**其条目;混排兜底:已退场条目显示 [已退场] 徽标并置灰。 - **退场筛选**:Room 页新增「全部 / 活跃 / 已退役」chips(词表退役态过滤)。 ## [0.20.0-beta.21] — 2026-10-02 > **退役带记录**:room 退役时可选**连同其下全部活跃记忆一并退场**(此前只有动词表,自生长 room 尤其没有处理手段)。 ### 新增 - **`retire withRecords`**(Room/Hall 页「退场」按钮,红色):词表退役 + 该 room 下全部**活跃**记录分批软删(每批 ≤200,与 records-delete 同原语;reason=manual)——记录可在记忆页「已退场」区逐条恢复。自生长未注册行同样有「退场」(仅退场记录,无词表条目可动)。响应带 `retiredRecords` 条数。 - 「导出孤儿」按钮回迁**记忆查询面板**(孤儿筛选行内)。 ### 修复 - recall-usage 测试隔离(持久化回环用例并行竞态);RoomTab 退役确认框的字面 `\n` 显示修正。 ## [0.20.0-beta.20] — 2026-10-02 > **Room 独立标签页**(与 Hall 分离):room 的存在、名称、条目各有其管理面;记忆页不再堆 Room 标签。 ### 新增 - **「Room」标签页**(Hall 之后):扁平列出全部 room(注册条目 ∪ 自生长未注册)——**存在**(注册两级 slug / 收编 grown / 退役·恢复)、**名称**(编辑显示名+归类说明;改名可两级 slug,记录随迁)、**条目**(▸ 展开浏览该 room 的记忆条目,默认收起,首次拉前 10 条);孤儿导出/高权限开关随页。 - **注册后可重编辑**:新 `room-admin update`(label/description 改写,未提供字段不动)+ store `RoomRegistryStore.update` + 工具 `memory_room_admin action=update` + 面板「编辑」入口——此前注册后 label/说明只能补空不能改写。 - **room 行内容展开**(Hall 页 room 行同款):默认收起,▸ 展开看条目。 - **记忆页 Room 区块分离**:移除 slug chips/分页/展开块(与 Hall/Room 页重复),仅保留「无绑定 · N」孤儿筛选与指引文案——room 标签浏览/管理归 Hall/Room 页。 ### 变更 - 合并/归类/改名表单与预览 sticky 跟随滚动(hall 多时不再需要上下滑动找确认框)。 - 指针自制拖拽(ego-browser 同款 pointer 方案,部分 webview 的 HTML5 DnD 不触发的兜底)。 ## [0.20.0-beta.19] — 2026-10-02 > 归类交互重做(实测反馈:HTML5 拖拽在部分 webview 不触发;点 hall 后预览被埋在源行里像"没反应")。 ### 变更 - **指针自制拖拽**(ego-browser 同款纯 pointer 方案):按住 room/自生长 slug → 浮动幽灵 chip 跟手 → 悬停 hall 头虚线高亮 → 松手归类。不依赖 HTML5 DnD,任何 webview 都生效。点选归类(「归类」/「归」→ 挑选态 → 点 hall 头)保留。 - **全局操作栏**:合并/归类/改名的表单与 dryRun 预览**常驻页首**(红色确认框不随行滚动、不再被埋在源 room 行里)——点 hall 后一定看得见。 - **room 行布局**:按钮固定一行不再折行(导出不再孤行);名称/别名在左侧信息区自然换行(别名可断词)。 ## [0.20.0-beta.18] — 2026-10-02 ### 维护 - lint 清账:beta.17 的 isTag→isRoomSlug 替换遗留 stats.ts / rooms-registry.ts 两个死 import(发布门漏检——管道后 `$?` 取的是 tail 退出码,D2 坑复犯)。无功能变更。 ## [0.20.0-beta.17] — 2026-10-02 > **重启后 hall/room 关系丢失修复**:`rooms-registry.json` 的加载器仍在用 `isTag` 过滤 slug——重启读盘时所有 `major/minor` 两级条目被当非法**静默丢弃**(单段 hall 能通过所以留存)。这是 isTag/isRoomSlug 混用的第三处;同批扫掉了 `normTags` 的同款雷。 ### 修复 - **加载器丢两级条目**(`store/rooms-registry.ts` init):过滤改 `isRoomSlug`。**你磁盘上的 rooms-registry.json 数据完好**(两级条目一直在文件里,只是启动时被丢)——升级重载后关系自动恢复,无需任何修复操作。 - **normTags 洗掉 slash 标签**(`metadata-validators.ts`):"所有 tags 写回点都必须过这里"的闸用 isTag,归类写回的 `hall/minor` 标签在下次蒸馏/重标触及时会被静默剥掉。现放行两级 room slug(三级仍拒);`isRoomSlug` 事实源就近移入该文件(避免依赖环),rooms-registry re-export 兼容。 - **list-records 两级 tag 过滤被误拒**(stats.ts tagSel 同款):改 `isRoomSlug`——Hall 页点两级 room 的记录筛选此前会 400。 - 红测试先行 ×3(持久化回环两级保留 / normTags 放行 / 集成两级 tag 过滤),验红后修复回绿。 ## [0.20.0-beta.16] — 2026-10-02 > **自生长未注册 slug 直接归入 hall**:底部「自生长未注册」区的每个 chip 现在可拖到 hall 头上——收编 + 归为其子类一步完成。 ### 新增 - **grown chip 拖拽/点选归类**:把未注册 slug(如 `git-commits`)拖到 hall 头(或点 chip 上「归」按钮进入挑选态,再点目标 hall)→ dryRun 预览 → 确认实跑。语义 = **原地收编(from,source=grown)→ rename 到 `hall/子类`**:记录 tags 随迁、旧名进目标别名、条目 active 且不戴 ⭐(收编身份)。落回自己 hall 的两级 slug(如 `dsh-plugin/xxx`)= 原地收编。 - 组合顺序钉死在集成测试(markMered 对未注册 from 会早退——必须先收编 from 再 rename);execMerge 对未注册 from 自动补收编。 ## [0.20.0-beta.15] — 2026-10-02 > 归类实测反馈两连修:①改名后的条目误带「已退役」(会掉出标注词表);②HTML5 拖拽在部分 webview 不生效 → 新增**点选归类**主路径。 ### 修复 - **归类(改名)后条目误标 retired**:renameRoom 复用 merge 编排,`markMerged` 的"旧条目转退役"被带了过来——归完类的新 room 显示「已退役」并**掉出标注器词表**(listActive 过滤)。现 rename 收尾恢复先前状态(active 条目改名后仍 active);真 merge(并集语义)不受影响。红测试先行(unit + HTTP 面集成)。 ### 变更 - **点选归类为主路径**:点 room 行「归类」→ 进入挑选态(按钮变「选 hall…」,所有 hall 头虚线高亮)→ 点目标 hall 头 → 出 dryRun 预览 → 确认实跑。拖拽保留(支持的環境仍可用),但不再依赖。 ## [0.20.0-beta.14] — 2026-10-02 > 记忆卡片新增**老化权重**与**召回使用**展示,并开始为"老化权重效果统计"积累数据。口径(用户裁定):**进 topN(被注入上下文)才算被使用**;参与尝试未进 = 仅计尝试。 ### 新增 - **卡片字段**:「老化 N%」chip(读路径衰减系数 `max(0.5, 0.5^(Δ天/半衰期))`,与召回排序同式同源;≤60% 标红=偏老)+「用 used/attempts」计数(title 含最近使用/尝试时间)。工具条新增汇总「召回使用 used/attempted(rate%)」。 - **统计面**:`RecallUsageStore`(recall-usage.json sidecar,与 rooms-registry 同族纪律——损坏只读降级、绝不阻塞召回读路径);每轮召回在注入/全压制/预算清零三个终态记录(候选 attempts++、注入 used++,时间戳取最新);内存即时 + 去抖 5s 原子落盘,5 万条按最近尝试淘汰;未装配 = 零成本旁路。 - 契约:UiRecord 增 `agingWeight`/`usage`,ListRecordsResponse 增 `usageSummary`(可选字段,旧客户端零断裂);契约键数不变。 ### 效果统计口径(后续分析用) - usageSummary:tracked(有统计的记忆数)/ attempted(Σ尝试)/ used(Σ使用)/ rate(使用率%) - 细粒度分析(按类型/年龄段的使用分布、半衰期调参依据)数据自本版起积累,分析视图另议。 ## [0.20.0-beta.13] — 2026-10-02 > 补全归类逻辑:把 room 归到已有 hall 下(此前只能新增 hall,或合并进别的 room 抹掉身份)。面板支持**拖拽归类**——拖 room 放到 hall 头上即可。 ### 新增 - **Hall 页拖拽归类**:room 行可拖(hiPriv 开启时抓手光标),hall 头为放置目标(虚线高亮);松手 = 预填改名(major/minor)并直接出 dryRun 预览,确认后实跑——记录随迁、旧名进别名、分组视图即挂到该 hall 下。触屏/不支持拖放的环境用 room 行「归类」按钮或改名表单里的 hall 快选 chips 兜底。 - 后端修复:`renameSlug` 目标校验 `isTag` → `isRoomSlug`——此前两级目标(major/minor)被误拒,「归类到 hall 下」这条路实际不通(且 rename 编排会先重写记录再在注册表改名时抛错,留下半程状态)。按 C3 卸除/变更纪律:红测试先行(unit + HTTP 面集成各一),验红后修复回绿。 ### 修复 - 同上:`renameSlug` 两级目标校验(beta.5 引入的缺口)。 ## [0.20.0-beta.12] — 2026-10-02 > lint 清账 + 卸除纪律成文(ENGINEERING-NOTES 新增 C3)。**无功能变更**。 ### 维护 - **eslint 清账(13 error → 0)**:longtask 撤除残渣(stats.ts 死 import ×2、RecordsTab 死 state)+ 更早批次欠账(recluster.ts 死接口与 let、rooms-registry.ts / ruminate.ts / room-review.ts / 两个测试文件的死 import 与 let)。余 4 个 warning 为基线既有(primitives/tools 的 any)。 - **ENGINEERING-NOTES 新增 C3「卸除也是 TDD」**:卸除先改测试表达新预期(红)→ 卸实现(绿);lint 是删除型改动的必跑门(unused import = 没卸干净的自动探测器)。 ## [0.20.0-beta.11] — 2026-10-02 > Hall·Room **集成测试**入库(`tests/hall-room.integration.test.ts`:HTTP 面全链 × 真实存储的用户旅程,9 用例),集成首跑即抓到一个单测盲区并修复。 ### 修复 - **rooms-get 合并视图 source 硬编码 `pre-registered`**(beta.4 引入):注册表条目并入计数列表时来源写死,收编(source=grown)的条目在面板计数 chips 上恒戴 ⭐ 预注册角标——身份失真。现用条目真实来源(⭐ 只归预注册;收编显示 grown)。单测盲区成因:rooms-registry 单测只测 store 层,端点合并行无人断言 grown 条目的 source。 ### 测试 - `hall-room.integration.test.ts`:空表自生长计数 → 两级注册/非法 slug 拒绝 → 收编 → 导出三 kind → merge dryRun 零写入→实跑(备份落盘/退场行重写/metadata 保全/场景重算入队 source='room-merge')→ rename 别名 → retire/恢复 → 大类 200 上限+小类不占额 → 损坏只读降级红线(rooms-get 不阻塞、磁盘不回写)。 ## [0.20.0-beta.10] — 2026-10-02 > **longtask(长任务模式)全量撤除**:该族功能的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——beta.8 撤浮动球、本版撤完剩余后端。pm 回归纯记忆域。将来若需要「立即蒸馏尾部」等能力,以 pm 本位重新设计再立项。 ### 移除 - **端点 `longtask-hint-get` / `longtask-compress-tail`**(契约键 48 → 46)及 `compressTailTurns`/去抖 ruminate 闭环:上下文计量(`ContextUsageStore`)、todo 漂移检测(`TodoRefStore`)、建议判定随之一并撤除,`hooks/long-task.ts`、`store/context-usage.ts`、`store/todo-ref.ts` 三文件删除(含 todo/write 事件的 declare module 扩充)。 - **`cfg.longTask.*` 配置块**(默认值 + 两处 Schema):旧配置文件里的 longTask 键由 schema 忽略,无需迁移。 - **会话级 `longTask` 旗标与尾部压缩水位线 `lastTailCompressedTurn`**(session-modes):旧 session-modes.json 里的遗留键由载入过滤自然忽略。 - **`session-mode-set` 的 `mode` 恢复必传**(该可先化专为 longTask 二选一而生);`longTask` 请求/响应字段删除。 - 保留:beta.9 的 roomRegistry RPC 接线修复(独立成立);Hall 管理页与 Room 分类管理面不变。 ## [0.20.0-beta.9] — 2026-10-02 > 修复面板 RPC 全链路的 deps 漏带:`roomRegistry` 与 `longTaskDeps` 在 rpcHandler 组装 sources 时丢失,面板侧 Room 管理/长任务端点恒"未装配"(工具面直传不受影响,故 beta.4 起工具可用而面板注册一直报错)。 ### 修复 - **`registerMemoryRpc` 的 rpcHandler 漏带 `roomRegistry`/`longTask`**(beta.4 引入):HTTP 分发统一走 `buildEndpointDeps`,但 sources 只带了 7 项——`rooms-get` 不下发 registry、`room-register`/`room-admin` 抛「Room 注册表未装配(需要插件重载以初始化)」、`longtask-hint-get`/`longtask-compress-tail` 恒 disabled。现随 sources 下发;回归测试钉死 HTTP 面全链路(register → rooms-get 合并 → room-admin,rpc.test.ts)。 ## [0.20.0-beta.8] — 2026-10-02 > 撤下浮动球 UI:悬浮建议面板的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——beta.1 起随包发布的 FAB 至本版移除。 ### 移除 - **浮动球 + 建议卡片(`client/src/longtask-fab.ts`,beta.1 起随包)**:整个撤下,客户端恢复两座——`settings.section`(记忆面板)+ `conversation.input.left`(档位 pill),不再有全应用级悬浮 UI。长任务模式本体(上下文计量/todo 参考/尾部 turn 压缩)不受影响;`longtask-hint-get`/`longtask-compress-tail` 端点保留为后端面,长任务开关与手动压缩入口待定版时落记忆设置分节。 ## [0.20.0-beta.7] — 2026-10-02 > Room 分类管理第三船(**管理面板档**):专用「Hall」标签页,hall(大类)+ room(小类)一起管理 —— 手动查看/管理 Room 从此不用借道 agent 工具。 ### 新增 - **「Hall」管理标签页**(「场景」之后):hall 分组树 —— `major/minor` 归其前缀大类,standalone slug 自成 hall(既是 hall 又是其下唯一 room);hall 头行聚合计数 + 一键「+小类」(预填 `hall/`);room 行展示 ⭐预注册/source/状态/别名/计数,retired 灰化。UI 术语 Hall/Room 为分组视图,与 Wing(`metadata.hall` 域)及认知 hall 无关(ADR-0020 §7 消歧)。 - **全操作 UI 入口(高权限 memoryMutate 门)**:两级 slug 注册(受控表单,placeholder `dsh-plugin` / `dsh-plugin/merge`);自生长 slug **收编**(`source=grown`);**改名/合并**走新 RPC —— dryRun 预览(影响条数+样例)→「确认执行」实跑,与 memory_room_admin 工具同一编排(执行前自动备份 + 完成入队场景重算);退役/恢复一次点击(恢复不二次确认,退役确认);每 room 记录清单 CSV 导出;词表/孤儿导出收拢进本页;合并/改名带「反刍空闲时执行」提示。 - **新端点 `dsh-memory/room-admin`**(merge/rename/retire;memoryMutate 门,端点侧抛错语义):契约键 47 → 48。`rooms-export` 增 `kind='records'`(按 Room 导出记录清单,`tag` 必传);`room-register` 增可选 `source`(收编传 `grown`)。 - 记忆 Tab Room 块瘦身:管理子面板移除(孤儿导出上移头部行),提示指向 Hall 页。 ### 修复 - `rooms-export` records 分支 kind 类型收窄(TS2322)与历史乱码报错文案;CHANGELOG beta.1-beta.5 重复标题行修复。 ## [0.20.0-beta.6] — 2026-10-01 ### 修复 - **标注器词表接入注册表(beta.5 漏项补齐)**:beta.5 的 merge/rename/retire 已落,但候选标注器(`annotateOrphanCandidates`)的词表仍是纯自生长聚合——预注册的 Room 根本进不了候选。现 OrphanAnnotateIO 带 registry:合并词表 = 注册表条目排前(count=0,附 label/description)+ 自生长目录,封顶 120;ruminate 与 memory_room_admin annotate 两条路径都传参。**预注册 Room 从此真实影响候选标注**。 ## [0.20.0-beta.5] — 2026-10-01 > Room 分类管理第二船(**破坏性面**)。dryRun 默认 true——merge/rename 先预览影响面,确认后才实跑;执行前自动备份到 `rooms-merge-backups/`。 ### 新增 - **Room 注册表两级制**:slug 支持 `major` 或 `major/minor` 两级(如 `dsh-plugin`、`dsh-plugin/merge`);**大类上限 200**,小类细分不占大类额度(总量保险 2000)。isTag 词表不放宽(slash 仅注册表层允许)。 - **merge/rename/retire(工具 `memory_room_admin`,高权限)**:merge 游标重写全部匹配记录的 tags(写前重读-合并-写回,roomCandidates/roomReview/hall/anchors 等键保全;含已退场行,与计数口径一致);rename = merge 1:1 + 注册表改名(aliases 收旧名);retire 仅词表退役(存量不动)。merge/rename 与反刍并发会相互覆盖——请错峰执行(工具提示与 ADR-0020 均已声明)。 - **重写安全三件套**:dryRun 默认只返 affected+预览零写入;执行前自动备份匹配记录到 `rooms-merge-backups/-.json`;完成自动 `invalidateRooms` + 按受影响 (family, scene) 入队场景重算(`source='room-merge'`)。 - **面板 Room 管理子面板**(高权限开启后出现):注册表单(slug/名称/说明,走新 RPC `room-register`)、孤儿清单导出;合并/退役建议走 agent 工具(dryRun 预览更详细)。 - 端点面 46 → 47(`room-register`)。 ## [0.20.0-beta.4] — 2026-10-01 > Room 分类管理第一船(**零漂移面**):注册表空 = 与 beta.3 行为逐字一致。merge/rename/retire 破坏性面将随 beta.5(dryRun 默认 true 保留一版)。 ### 新增 - **Room 注册表(`rooms-registry.json` sidecar)**:预先注册策划好的 Room(slug/label/description);损坏/为空 → 降级回退纯自生长目录,绝不阻塞面板与标注器;上限 200 防刷。`rooms-get` 端点层合并:注册条目 count=0 也进词表并带 `source`/`label`,响应新增 `registry` 全量字段(客户端可选读)。 - **导出端点 `dsh-memory/rooms-export`**(kind=rooms|orphans,CSV 直出):rooms = 注册表∪自生长词表带计数;orphans = 无 Room 绑定的活跃记录清单(含候选/复查状态列)。 - **工具 `memory_room_admin`**(action=list|register):list 列注册表+自生长总览;register 预注册 Room(高权限门,幂等补全)——配合 `memory_room_review` 的逐个复查,agent 有了「注册→预标记→逐个确认」的完整分类管理入口。 - 客户端:Room chip 带「预注册/自生长」来源标示;孤儿 chip 带待复查语义。 ## [0.20.0-beta.3] — 2026-10-01 ### 新增 - **记录面板 Room 分类改进**:①展开/收拢(收拢 = 头部 + 前 8 个高频 Room 预览,开合状态持久化);②展开态全量分页(每页 40,◀▶ 翻页),替代原先「仅显示前 40」的硬截断;③**孤儿记忆筛选**——首位「无绑定 · N」chip 只看没有任何 Room 绑定的记忆(`list-records` 新增 `untagged` 过滤通道,`rooms-get` 新增 `orphanCount`,与 Room 计数同口径);④筛选条件即时可见 + 一键清除。检索路径同款孤儿过滤。 ## [0.20.0-beta.2] — 2026-10-01 > dsh-0.2.0-beta 渠道 +1:反刍完整 context 优化(repo 软围栏/场景按项目迁移/闭环)。与 longtask(见 beta.1)同包,真机反馈合并收口。 ### 新增 - **repo 软围栏(ADR-0015,`recall.scopeFence.*`,默认关)**:repoKey=basename(归一 cwd) 写时算定进 L1 metadata(repo_key_name/repo_key_owner/applicability,DEFAULT 零回填,不进 FTS 与快照哈希);召回与 memory_search 出口按 `this-repo`/`cross-project` 软减权重排(×0.2 可调,**只降权不排除**,chat 族与未归属记录不围栏,去重路径哨兵防误入)。零漂移:默认关时召回序 sha1 对拍一致。 - **场景按项目迁移(L2 repo 感知 + 重聚类)**:L2 整合 prompt 可见 repoKeyName/applicability——this-repo 记录不再并入跨项目场景;`scene_recluster_jobs` 作业队列 + ruminate 空闲档消费器(快照→删摘要投影→失败整体回滚,零新 LLM 通道);repo 归属修补后自动按 repoKey 反查受影响场景入队重算。 - **压缩闭环**:尾部压缩入队成功后 10 分钟去抖触发一次反刍(冲刷→L2→L3→relabel→重聚类消费),修掉「压缩记录滞留蒸馏桶」的断点。 ## [0.20.0-beta.1] — 2026-10-01 > dsh-0.2.0 线首个 beta 渠道发布(`dsh-0.2.0-beta` tag):长任务模式真机预览。除下述内容外,本版同时携带此前 parked 于 `[Unreleased]` 的全部 main 改动(激活槽位/来源锚点/证据读取器/记忆退场闭环/三轴冲突等)——它们已随 0.1.7 线发布,但 main 线尚无对应版本号。 ### 新增 - **长任务模式(`longTask.*`,默认关)——「长跑会话」的三件套:上下文计量、任务参考、尾部压缩,以及一个非阻断的浮动建议面板。** - **上下文使用量(`store/context-usage.ts`)**:监听 `assistant/message` 官方 `usage` 的输入侧(input + cache 读/写),取**最近值**语义(每轮输入侧已含全部历史,不累加);`compaction/summary` 后归零重计。纯内存 per-session Map——重启后首条 assistant 消息即可重建,持久化只会让过期样本诈尸。 - **todo 参考(`store/todo-ref.ts` + `hooks/long-task.ts`)**:监听宿主结构化 `todo/write` 事件(全量快照;包类型到 0.2.0-rc.1 未声明,插件以 declare module 自扩充——同 §E 的 dsh-compaction 先例)。**仅长任务会话**:快照刷进一张 pinned `todo` 槽位(`SlotStore.refreshByTitle` 受管刷新——同一主体反复写必须原地更新,否则 ≤8 槽上限里堆出关闭槽位尾迹),经 slot-recall 常驻注入——压缩把旧上下文逐出后,任务北极星仍在。相邻快照做词面 Jaccard 漂移检测(同快照重复写入不稀释信号);body ≤512 字节,截断明示。 - **尾部 turn 压缩(`longtask-compress-tail` 端点 + `compressTailTurns`)**:把(压缩水位线, 最新已捕获轮] 内最近 N 轮立即 `enqueue(force:true)` 蒸馏入记忆——立即把尾部对话落成可检索记忆,而不是等蒸馏阈值。水位线(`SessionModeStore.lastTailCompressedTurn`)只前进,重复按压天然幂等;off 档完全隐身;无锚点老数据只在首次压缩(水位线 0)时纳入——宁少收不重蒸。 - **建议状态(`longtask-hint-get`)+ 浮动球(`client/src/longtask-fab.ts`)**:ego-browser 式 vanilla overlay(FAB+面板,拖拽/位置持久化/视口夹紧),**建议不阻断**——仅当「上下文占用达 `contextThresholdPct`」或「todo 漂移达 `driftThreshold`」且长任务未开启时点亮呼吸光晕;面板内:长任务开关(临时,per-session,**不带 mode**——切开关不重置用户档位)、占用/漂移进度条、手动尾部压缩按钮(长任务开启才可用)、任务计数。轮询忙 2s/闲 5s,RPC 失败静默;座位契约不变(settings.section 恰一个,body 单例不占任何座位)。 - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。 ## [0.19.0] — 2026-09-29 ### 变更 - **DSH 0.2.0 适配（compat/0.2.0）**：peerDependencies 与 engines.dsh（package.json + dsh.plugin.json）整体换代到 `>=0.2.0-rc.1 <0.2.1-0`（单段替换，0.1.7 线由 compat/0.1.7 分支继续服务）；devDependencies 9 个 dsh-* 精确钉 0.1.1-rc.2 → 0.2.0-rc.1 并新增 type-only 依赖 `@deepseek-ai/dsh-compaction`。代码层适配 0.2.0 宿主 API 漂移：`agent/session-start` 事件并入 `agent/created`（监听器改为 async 以满足 serial 契约）；Session 事件读取 `session.events` → `session.snapshotEvents()`（宿主已弃用同步全量读取，保留降级链）；测试桩同步更新（projection 游标 offset 语义）。 - **发布元数据**：版本 0.18.4 → 0.19.0；publishConfig.tag `dsh-0.1.7` → `dsh-0.2.0`；dsh.plugin.json version → `0.19.0-dsh0.2.0.1`。 ## [0.18.4] — 2026-09-28 ### 新增 - **崩溃恢复（§A）**：宿主在轮次中途崩溃时，该轮对话此前会随内存缓冲永久丢失（resume 的冷启动地板丢弃全部历史）。现在 resume 时从宿主持久化事件日志对账：以 L0 已落盘的最大 turn 为水位线，补收其后的完整轮次（上限 2 轮；崩溃孤儿轮由宿主补写 `turn/end{reason:'interrupted'}` 闭合，本机实测 98 处）。幂等 = 水位线 + 逐轮存在性检查；宿主读日志服务不可用时逐级降级（`sessionQuery.readSession` → `sessionPersistence.readFrom` → 维持现状 + 一次性提示），全程 fail-open 不阻塞会话启动。 - **载荷脱敏（§C，`capture.redactSecrets`，默认开启）**：捕获写入边界把 8 类密钥（PEM 私钥 / Authorization 头 / Bearer 与 JWT / Cookie / 厂商 API key 形态 / 邮箱 / ≥9 位长号（排除日期）/ 高熵 ID）替换为 `[REDACTED:]` 类型化占位符——单点覆盖 L0 JSONL、L0 SQLite、蒸馏输入与手动 `memory_add`/`memory_import`（两条 L1 写入边界同词表）。安全值（`example` / `$VAR` / `${{…}}` 等）不脱；占位符保留类别语义、可被检索命中。注意：开启后 L0 原文自此改变（重建不可得原文），`false` 一键回明文。 - **蒸馏提示词防注入（§B）**：六处蒸馏 prompt（L1 抽取 ×3 / L1 去重 ×3 / L2 场景 ×2 / L3 画像 ×2 / 图谱投影 / 核对器）全部加入"内容边界（防注入）"总声明与数据插槽界定——对话原文、既有记忆池、场景全文等嵌入内容一律是数据不是指令，防止对话携带的指令性文字劫持蒸馏、去重与裁决。判定词表与输出契约零变化。 ### 改进 - **注入确认（§D）**：召回注入不再在返回瞬间标记去重，改为"pending → 日志回执"两段式——宿主把注入消息真实写入会话日志（`user/message` 带 `plugin:memory` 署名与稳定 id）时才 `dedupe.mark`。被覆盖/取消的注入不再误压制记忆（下轮可重注）；5 分钟未回执降级为照常标记（防确认链路故障导致去重失效），未确认即弃。 - **压缩精确再注入（§E）**：`compaction/end`（无 error）后，该会话下一轮做一次定向增强召回——跳过去重压制（压缩已把旧注入逐出上下文）、画像立即重注入、占用账本归零；消费即清。原有 compact/clear 会话级全量重置保留为回退路径，双路径幂等。 - **结构化追踪（§F，`trace.*`）**：召回与蒸馏事件按天 JSONL 落盘（`/trace/`，保留期默认 14 天，单日 5MB 停写 + marker）。召回事件含 query 指纹（默认 metadata-only：长度 + sha256，`trace.captureContent` 才存原文 ≤200 字符）、命中/注入 id、分数、耗时与四种结局（injected/suppressed/timeout/off）；蒸馏事件含 runId、六值决策聚合（与 `l1_receipts` 同源可交叉审计）、耗时与成败。新增 `dsh-memory/trace-tail` 端点；设置页"日志"Tab 新增 系统日志 / 召回追踪 / 蒸馏追踪 三数据源切换。 ## [0.18.2] — 2026-09-27 ### 修复 - **会话格式 v4 署名适配（宿主 ≥0.1.7-rc.1）**：两处记忆召回注入（跨会话召回 `hooks/recall.ts`、槽位常驻注入 `hooks/slot-recall.ts`）不再使用 v4 宿主拒绝的旧署名 `source: { kind: 'plugin', plugin: 'memory', form: 'recall' }`（触发 `SessionFormatError` 整轮失败——即"调用记忆时报错"的来源），改为 producer-owned 署名 `{ kind: 'plugin:memory', form: 'recall' }`。`form` 与注入内容、时机均不变。取证依据：`@deepseek-ai/dsh-session-format-v3-to-v4@0.1.7-rc.2` 的 `source()` 只查 kind 非空且 ≠ `'plugin'`，不校验伴随字段。 - **读侧双形状兼容**：召回份额估算的署名判据 `isOwnRecallSource` 同时接受新署名与 v3 旧行——只改写侧会让占用面板"记忆召回份额"静默归零（无异常无报错）。`MessageSourceMap` 经模块增强登记 `plugin:memory`（dsh-llm 0.1.7 的 map 为 `user|model|tool|'system-prompt'`，无 plugin catch-all，merge-extensible per-producer）。 - **tool-result v4 native 适配（N1）**：`store/evidence-source.ts` 的取证文本读取新增 native 分支（v4 一等 `role:'tool'` 消息：content 直接为 text/reasoning 块、`isError` 在 message 顶层；宿主 `assertBlock` 硬拒旧 `tool-result` wrapper 块），旧块下钻路径保留作历史兼容——否则 v4 下取证文本静默恒空。`projection/slots.ts` 的 isError 守卫同步 native 化。 ## [Unreleased] ### 新增 - **激活槽位（Active Slot）——把「每次都该生效的约定」从语义召回里拿出来，变成可跨会话持久的常驻上下文。** 起因是一次真实失效：网络访问总则（上传走官方、下载走镜像）已写进记忆，下一轮对话里却**没有被召回**，于是旧的错误习惯继续生效。语义召回是概率性的，而这类规则需要的恰恰是确定性——所以给它们一条机械通道。 - **存储**：`/slots.json`，独立于 `state.json`（槽位是高频小改，不能把 checkpoint 的原子写拖着变频），复用 `util/io.ts` 的 `atomicWriteJson`；内存态只原地改，`list()/open()/alwaysOn()` 一律返回副本（对齐 `StateStore.reset()` 的活引用教训）。 - **工具面三件**：`memory_slot_write` / `memory_slot_list` / `memory_slot_close`。写入与关闭受既有的高权限门控 `live.memoryMutate`（默认关）——状态变更强风控；读取受会话档位门控，与 `memory_search` 同语义。新 registrar 独立成文件，`tools/index.ts`（1156 行）零侵入。 - **常驻注入**：`hooks/slot-recall.ts` 独立注册 `agent/pre-step`（waterfall prepend），与既有 `recall.ts` 可组合（两段注入顺序有测试钉住）。`pinned && open` 槽位按 priority 降序、按字节预算截断；超预算的以 `… 另有 N 个` 明示并给出找回路径——**截断不静默**。`validUntil` 由注入前的一次机械清算转 `expired`（纯时间戳比较，不引入任何 LLM），否则「有效期」只是装饰。 - **服务端投影 `memorySlots`**：经 `ctx.inject(['sessionProjections'])` 注册——宿主没有该服务时**静默不注册**，而不是让整行 profile 加载失败。`apply` 闭包 `SlotStore` 并以 `revision()` 判脏：**只在 `tool/result`（settled、非 error）且 rev 变化时重建**（`tool/call` 提交在 `execute()` 变更 store 之前，按 call 折会读到 stale），无关事件返回**同引用**；`view` 用 `WeakMap` 保引用稳定，且**不含 body**（判定与生成正交，正文按需再取）。本轮不含任何 client 代码：展示留给下一轮 brief。 - **schema 零新依赖**：`stateSchema` / `viewSchema` 自实现 `parse`（注册表运行时只调这一个方法），合法态**原样返回同一引用**、非法态抛错；不引 zod（`package.json` 与锁文件不在本轮改动白名单内）。 - 上限：≤8 槽（可配）/ 常驻 ≤2048 字节 / body ≤512 / title ≤60。 - **来源锚点（R7）——记忆现在能追回会话里的**真实位置**。** 在此之前溯源链是断的：L1 带着 `source_message_ids`，但那些是 **L0 消息 id**（`msg__`），而 L0 表没有 `turn`/`step` 列；且该 id 列表**根本没写进检索库**（写入侧只取 `metadata`，字段被静默丢弃）。结果是**任何一条记忆都无法定位到原文**。 - `l0_conversations` 补 `turn`/`step` 两列（幂等 `ALTER TABLE`；旧行保持 NULL = 无锚点，**绝不猜测回填**），并新增 `(session_id, turn)` 索引。 - 捕获侧新增 `step/start` fold：`user/message` 在内核负载里**不带** `step`，靠同轮 `step/start` 推出；`assistant/message` 用事件自带的 `{turn, step}`。**首个 `step/start` 之前的消息 step 留空**——缺坐标时不编坐标，这是红线。 - 锚点存在 `metadata_json` 的保留键 `dsh_source_anchors`（UI 显示为 `t12 s3`）。不加列、不动磁盘契约。**新建与「合并/更新」两条写入路径都带锚点**——否则合并一次就丢坐标，而合并是长会话里最常发生的动作。 - 新增宿主取数接口 `MemoryDb.l0ByAnchor(sessionId, turn, step?)`：**按坐标**（而非按时间）取 L0 消息，是后续「证据读取器」的唯一入口。 - **记录面板显示来源锚点**（此前该行永远是「-」）。 - **证据读取器（R1）——把锚点还原成会话原文。** 取原文走**内核 `ctx.sessionQuery`** 直连（`readSession` / `listEvents`），不再等外部索引插件的 HTTP 端点：本插件是宿主插件，手里就有 `ctx`，少一层进程边界与失败点。本轮落地**纯函数层**（装配接线与真机实调见后续条目）。 - 会话 id **两种形态都试**：实测索引里 `session_id` 有带 `session-` 前缀与纯 uuid 两种，只试一种会**静默漏掉 124 个会话**（不报错，只是永远查不到）。 - `foldEventAnchors` 在读取侧复用**与捕获侧同一条 fold 规则**，保证写入的坐标与读回的坐标是同一套语义。 - **忠实投影**：不 `stripCodeBlocks`、不按长度截断、不做「值不值得记」筛选——**捕获可以为省 token 丢东西，取证不行**。唯一保留的过滤是「插件注入的上下文不算用户发言」。 - **失败可分类**（这是本节的重点）：`no-service` / `no-anchor` / `session-unreadable` / `anchor-not-found` / `timeout` / `error`。前四类的区分是必需的——把「读不到」当成「没谈过」会让已归档会话的记忆被系统性误判。 - **记忆退场（软删）与清理闭环：删除不再等于丢数据。** 此前"删除"是**物理删除**——一次误删只能去 `records/*.jsonl` 事实源里手工捞。现在删除分两档，**可逆的那档是默认**，不可逆的那档需要显式要求且自带导出物。 - **退场（软删）**：保留主表行 + 闭合 `valid_to` + 写取代标记（`metadata` 保留键 `dsh_superseded`，含时刻 / 原因 / 裁决结论 / 冲突对 id），只撤掉 `l1_fts` 与 `l1_vec` 行。**检索侧 SQL 一字未改**——不引入任何查询漂移。三条退场路径（裁决判负 / 去重取代 `update`·`merge` / 人工删除）**共用同一个原语**，否则迟早出现"某条路径还在硬删"的不一致语义，而那种不一致只在误删发生时才暴露。 - **端点 33 → 38**：`records-retired`（已退场列表）/ `records-restore`（找回）/ `cleanup-retired`（物理清理）/ `snapshots-list`（快照清单）/ `snapshot-restore`（从快照回灌）。三处清单（`contract.ts` 映射表 / `stats.ts` 的 `MEMORY_ENDPOINTS` 白名单 / 分发 `case`）与端点总数断言同步更新——少改任一处都会让端点恒返 404，而客户端 `rpc` 的 catch 会静默吞掉异常、面板整块消失。 - **`memory_delete` 默认只退场 1 条**（原为 3），并新增 `ids` **精确路径**（跳过语义匹配）。原实现用语义 top-N 批量删，实测**误删过两条无关的真实记忆**——"删得准"必须由精确 ID 保证，而不是靠相似度。 - **物理清理默认干跑**：省略 `dryRun` 即视为 `true`。即便显式执行，也先落**全库快照**并**按内容哈希**校验，不一致即中止且一条不删。为此把 `deleteL1Batch` 收敛到**唯一调用方**（`exportThenPurge`），并由源码守卫测试钉住——"没有绕过导出的物理删除路径"由此成为结构事实，而不是一句约定。 - **补上回程票**：`restoreL1Snapshot` 此前**只有测试在调用**，于是"先有导出物再清理"只成立了一半——导出物在、回灌出口不在，真出事只能人工解析 `l1-records.json`。现接上 `snapshots-list` / `snapshot-restore`：只收快照**目录名**（拒绝路径与 `..`）、默认干跑、并如实报出 `stillRetired`。这一条是必需的：清理只清理**已退场**记录，而快照拍在删除**之前**，所以找回的每一条都带退场标记——**写回主表 ≠ 回到召回**，不说明就会让人以为"恢复完了"。要一步完成真正的回滚用 `unretire: true`（复用既有 `restore`，不新开写路径）。 - **面板**：记录页新增「已退场（可恢复）」区（默认折叠、展开时才拉取，不让它拖慢正常浏览）；删除确认文案改为明确"可恢复"。**物理清理刻意不做面板入口**——不可逆动作只留 RPC / 模型出口。 - **§C 矛盾冻结：同批次矛盾现在也能冻结（修掉"模型唯一会说的话恰好被拒收"）。** 取证发现 `validateConflictPair` 的第③条硬性要求"另一方必须是候选池里的已知记录"，而**同批次新记忆的 id 不在其中**（它们是本轮刚生成的、尚未入库）。于是"本轮两条新记忆互相矛盾"这种最典型的"机器判不了"情形，模型即便正确 emit 了 `conflict`，也**必然被判不成对而回落 `store`**。证据：模型层 7/7 会 emit，但那一跳从未落库（`conflict_pending` 建库以来 0 行、`l1_receipts` 里 `conflict` 凭证 0 条，而 `store 381 / merge 204 / update 172 / skip 7`）。修法：`validateConflictPair` 新增可选 `batchIds`（缺省 = 旧行为），仍要求"恰有一方是本条记忆"以保证配对唯一；并补队列满护栏——**败方属本轮新记忆时不做自动了结**，否则刚抽取的产出会立刻退场且没有任何人被告知，改为不停放、照常入库。 - **§C 矛盾冻结现在看得懂「三轴时间」——内容矛盾但时间上有先后的,不再一律塞给人工。** 记忆记录本就有三条互不替代的时间轴(记录时刻 `createdAt/updatedAt`、事实有效期 `validFrom/validTo`、持续性 `persistence`),但矛盾检测只用了记录时刻:检测器判 `conflict` 时看不到有效期与持续性,往往把「旧事实被新事实取代」误判成需要人裁决的对;裁决面板也只显示双方正文,人看不到有效期对比只能盲判。本轮把三轴接进冻结的两端: - **检测侧**:统一候选池**在冻结开启时**向检测器透传每条记忆的 `valid_from_ms` / `valid_to_ms` / `persistence`;`conflict` 动作条款新增「三轴辅助判定」——内容矛盾时先比有效期/持续性,一方已过期或明显更晚的,引导走 `update`/`merge` 而非 `conflict`。**三键与条款一律受 `conflictFreeze` 门控**:关闭态 user prompt 与升级前**逐字节相同**(见下方「修复」与 [ADR-0012](./docs/adr/0012-conflict-3axis-advisory-time-axes.md))。 - **裁决侧**:`ConflictPairView` 新增可选的 `winner_*` / `loser_*` 三轴字段(向后兼容);待裁决列表与渲染为每条对附上「有效期起/止、持续性」对比,帮人一眼看出谁更新、谁已过期。 - 机器**仍不自动裁决**:三轴只是辅助事实,最终结论仍由人工(或安全阀超时/满队列自动了结)写——`ConflictResolution` 取值不变。 - **§C 三类冲突 + claim 分组 + 丢弃留痕（Phase 3-4）。** 冲突不再只有一种"硬矛盾"——LLM 现在能判定 `hard`（事实互斥）、`conditional`（前提不同才矛盾）、`supersession`（新旧取代）三类。面板按三类分段显示，每段有独立标题与说明；`defer` 按钮支持"看过但暂不裁决"（重置超时、累计复看次数）。`claim_key` 列允许标记同一主题的多对冲突，面板据此分组。被丢弃的不合法冲突决策可通过 `memory_conflicts_rejected` 工具与 `dsh-memory/conflicts-rejected` 端点查询。 - `conflict_pending` 新增 `conflict_type` / `claim_key` 两列（幂等 `ALTER TABLE` 迁移）。 - 额度计数只计 `hard`：`pendingHardTotal` 按类型过滤；`conditional` / `supersession` 不占额度。 - 投影哈希冻结：7 字段列投影 `projectConflictsForHash` 不含新列，存量快照校验不变。 - 面板：`ConflictsTab` 三类分段 + defer 按钮 + 三轴文案 + 复看次数 + claim 键显示。 ### 修复 - **关闭态 prompt 曾悄悄多出三轴字段(默认关闭的部署受影响)。** 首版把 `valid_from_ms` / `valid_to_ms` / `persistence` **无条件**注入候选池,而这条 LLM 调用只对 system prompt 读了开关 ⇒ `conflictFreeze=false`(部署默认)时,模型每条候选多看 3 个**没有任何条款解释**的键:既费 token,又改变了输入。现已把三键纳入 `conflictFreeze` 门控,关闭态 user prompt 与升级前**逐字节相同**;判据同时从「不含某子串」升级为 **sha1 golden 锚 + 反向验证**(改坏门控该用例必红)。 - **面板说"矛盾冻结未开启"，而开关明明是开的。** `conflicts` / `conflict-resolve` 端点读的是**部署静态配置** `cfg.conflictFreeze.enabled`，而面板写入的是**运行时设置**（live）。部署默认恒 `false`，于是开关已开、`settings.yaml` 已落 `true`，本页仍报未开启。改走 `effectiveCfg(cfg, live)`，与去重管线同一套解析——开关只有**一个**事实源，读端与写端必须看同一份状态，否则会出现"列表说开着、裁决说没开"的自相矛盾。 - **`dsh-memory/embedding-reindex` 声明了却恒返 404。** 端点写在契约里，但既缺席 `MEMORY_ENDPOINTS` 白名单、也没有分发 `case`；同时 `startReindex()` 是**死代码**，设置页「向量索引」区块因此只有"取消"没有"开始"。补白名单 + `case` + 用例。 - **`UiRecord.sourceMessageIds` 是死字段。** 它读的是 `l1_records` **从不存在的列**，永远回退 `[]`，于是记录面板的来源行**从未渲染过**。已替换为读真实数据的 `sourceAnchors`。 ## [0.17.0-dsh0.1.7.1] — 2026-09-25 > 宿主 **0.1.7** 兼容线首发（dist-tag `dsh-0.1.7`，基于 main @ 85d9b05）。**仅适用于宿主 ≥0.1.7-rc.1**； > 0.1.5 / 0.1.6 宿主请继续使用 `dsh-0.1.5` tag 的版本线。内容 = main 全量 + 以下适配。 ### 变更 - **运行时开关迁入 Config volatile 节（0.1.7 声明式设置面）。** 宿主 0.1.7 删除了 `settings.register` / `installSection` 两代命令式注册 API，运行时开关（总/捕获/蒸馏/召回、蒸馏路由链、远程嵌入覆盖、写删门等 20 键）改为 `memorySchema.live` 整节 `.volatile()` 承载：宿主把 volatile 字段自动投影成设置表单，运行时变更经 `ctx.settings.update` → configEditor 落 profile patch → loader volatile-only 提交（不 remount 插件）。`LiveSettingsHandle` 契约不变，RPC 与消费方零改动。**自带自定义设置页 → 已关掉宿主自动表单页**（`suppressAutoSettingsForm`）。 - **⚠️ 旧设置值不自动迁移**：旧 `settings.yaml` 的 `dsh-memory` section 是顶层扁平键，与新 `live.*` 路径不匹配（且 `conflictFreeze` 布尔与新 Config 同名对象节冲突），宿主导入器会整段拒收——升级后请把旧值手工写进 profile patch 的 `- id: dsh-memory / config: { live: {…} }`（键名与旧 namespace 完全一致，仅多一层 `live.` 前缀）。 - devDeps 升 0.1.7 系（cordis 4.0.4 / schemastery 3.18.4 / cordis-plugin-loader 1.0.5），不随包发布。 ### 修复 - **首写静默丢失回归**：锁文件先于写入创建，目标父目录未建时 `open('wx')` ENOENT 被各 store `persist()` 吞成 warn → 首写静默丢失。`rmwJson` 拿锁前 `ensureDir`（随 main 线修复一并包含）。 - 另含 main 线全部内容：文件层工程加固（原子写/读侧分类/版本 fail-closed/文件锁/路径安全，详见 [0.16.1] 与 Unreleased 各条）。 ## [0.16.1] — 2026-09-24 ### 新增 - **记录面板「退场筛查」**：软删记录按设计不隐藏（可恢复），但与活跃记录混排不便分辨——现在列表工具行加了三态筛选「**全部 / 仅活跃 / 仅退场**」。后端 `listL1` 补同口径三态过滤（缺省全量，快照/重建不受影响；`retired:true` 与 `listRetiredL1` 同一判据，两份视图看到同一批行）；契约 `ListRecordsRequest.retired?: boolean`。筛查仅浏览路径生效——关键词检索只覆盖检索面，已退场记录本就不在其中。「加载更多」与删除/恢复后的自动刷新都会保持当前筛查态。 ### 修复 - **面板「删除记忆」确认后看似毫无反应——退场态没有透传给 UI。** 软删（retire）在服务端一直正常（`valid_to` 闭合 + 撤出检索面 + 可恢复），但按设计活动列表**保留**退场记录（`l1-retire` 测试钉死「面板浏览路径不隐藏退场记录」），而 `UiRecord` 契约里根本没有"是否已退场"字段、活动列表的记录行也没有任何视觉差异，"已退场"区又默认折叠——用户确认删除后看到的是**一条一模一样的记录**，自然以为"删除没生效"。 - 契约补 `UiRecord.retired` / `retiredReason`：`hitToUiRecord` 从 `valid_to` + 取代标记推导，活动列表与检索命中统一透传。 - 活动列表对退场记录渲染**「已退场 · 原因」徽标 + 整卡置灰**，行内按钮从「✕ 删除」换成「恢复」（走 `records-restore`，成功后自动刷新）——删除的瞬间界面立刻可见变化，且二次点删的困惑（幂等 no-op）不复存在。 - 新增 `tests/ui-retired-flag.test.ts` 钉死映射行为（活跃 / 人工退场 / 取代退场 / 无 `validTo` 形态各一）。 ## [0.16.0] — 2026-09-24 ### 修复 - **重标定/一键回填的 Wing 打标整段是废的**：提示词要求模型返回 `{"id":…,"wing":…}`，解析却读 `item.hall` → 永远取不到 → 整批静默丢弃**（实测 `wingLabeled=0 / tagged=0 / llmSkipped=60`，而日志里 LLM 明明成功）。这是 hall→Wing 改名的**第 3 次同类误伤**（前两次 `cfg.hall`、session-modes 的 `hall`）——提示词里的 JSON 字段名属于 **wire 协议**，不该跟着 UI 文案改名。现解析读 `wing` 并加枚举校验；**丢弃必须留日志**（id 配对失败 / 非法值各一条 warn），删掉永不触发的死 `catch`。 - **`embedding-state-get` 从 2.5–3.1s 降到毫秒级**。它每次现场跑 6 次 COUNT，其中两次是 `l1_records LEFT JOIN l1_vec … IS NULL`——`l1_vec` 是 **vec0 虚拟表(1024 维)**，普通谓词下退化成逐行 probe。改为「总数 − 已嵌入 − skip」相减（实测 L1 55ms→0ms、L0 371ms→3ms），并加**分级 TTL 缓存**（忙时 1s / 空闲 30s + 重建/切换/补齐收尾显式失效）。 - **重标定机械段不再一次性全量加载** `l1.all()`。改游标分页 + 只取 `id/type/metadata` 三列（`getAllL1Lite`），每批 200 条后让位；写回走 `patchL1Metadata`（**只改 metadata，绝不动正文**，有测试钉死）。 ### 新增 - **Room 层：标签类自生长分类**。MemPalace 五层里 Room 位于 Wing/认知 hall 之下，由 `metadata.tags` **动态派生**（`json_each` 聚合，零 schema、零注册表）——新 tag 落库即成为新 Room。新增 `rooms-get` 端点与记录面板的 Room 分类区块（点击按该 tag 筛选，`list-records` 新增 `tag` 过滤通道）。实测本机已有 **78 个 Room**（聚合 2ms）。 - **共享校验模块 `src/metadata-validators.ts`**：`isWingId` / `isCognitiveHall` / `isTag` / `normTags` 集中一处。此前 Wing 侧**完全没有校验**（任何非空字符串都能写进 `metadata.hall`），而认知 hall 侧有 `isCognitiveHall()` 严格校验——两处枚举不对称是数据完整性缺口。 - **后台处理 worker 隔离（B 窄切）**：抽出 `MemoryBackend` 边界，后台批处理（反刍/回填/重标定）的 SQLite 访问搬进 `worker_threads`，不再占住宿主主事件循环；起不来自动退回进程内并留 warn（**隔离失败绝不让后台处理失效**）。热路径（召回/捕获）一行未动——它们每轮调 DB，线程化会付 IPC 税。 - **批次进度可按段区分**：机械巡检 / 补 Wing / 提炼标签各带独立 label 与批次进度（此前 `sub` 只在 LLM 段有值，机械段 1439 条写回期间面板全空白）。 ### 变更 - 重标定的 metadata 写回从 `l1.upsert` 改为 `patchMetadata`。**只改 metadata 原本就不该重算嵌入**——此前每条记录写回都在跑一次 embedding，单次重标定最多浪费 900 次嵌入调用。 ## [0.12.0] — 2026-09-17 ### 新增 - **手动重建向量索引（端点 `dsh-memory/embedding-reindex` + 设置页「向量索引」区块）**。此前重建只有两条路：启动时的 `db.init` 变更检测链，与周期 backfill 的缺失补齐——**用户没有任何手动入口**。设置页里能看到的只有「取消」（且只在重建进行中才出现），既看不到「开始」，也看不到当前嵌了多少、还缺多少。现在补齐： - **端点面 31 → 32**。新增 `EmbeddingReindexStartResponse`（`{accepted:true}`），**受理即返回，进度不在此回传**——客户端照旧轮询 `embedding-state-get` 的 `reindex` 字段。两套进度语义各说各话是迟早要出事的，所以刻意只留一套。三处清单（`contract.ts` 映射表 / `stats.ts` 的 `MEMORY_ENDPOINTS` 白名单 / 分发 `case`）与端点总数断言同步更新；这四处**少改任何一处都会让端点恒返 404**，而客户端 `rpc` 的 catch 会静默吞掉异常、面板整块消失。 - **`EmbeddingStateView` 新增 `vectors`**：L1 / L0 各自的 `embedded` / `total` / `missing` / `skipped`。「已嵌入 X / 总 Y」由此而来。db 层的 **`-1` 哨兵原样透传**——「向量能力不可用」与「一条都没嵌」在界面上必须是两句不同的话；折叠成一个数字，用户就会去点一个永远没反应的按钮。 ### 修复 - **拒绝「受理了但根本不会跑」的重建请求**。`L1Store.reindex` / `L0Store.reindex` 首行在向量能力未就绪时**静默短路**成 `0/0/0`。入口若不设门槛，UI 会显示「重建完成、零条待补」——而真相是它**根本没开始**。该陷阱在 `src/index.ts:240` 早有注释，但那只覆盖启动链，手动入口是新开的破口。`startReindex()` 现将五道门槛全部前置，且各自给出**可行动的**文案：已卸载 / 重建已在进行中 / 嵌入源切换占用 / **嵌入源已关闭**（`currentInfo` 为空）/ **嵌入服务未就绪**（「先启用」与「再等等」是两句不同的话，不能合并成一句）。为此给两个 store 补了 `vectorsReady()` 访问器——`helper` 是私有的，外部无从询问。 - **`embedding-subsystem.test.ts` 的 `db` 桩件不完整**。它只有 `swapProvider` / `markEmbeddingSynced` 两个方法，靠 `as never` 绕过类型检查，因此从未被检出；`snapshot()` 开始附带向量计数后即崩（`getVecSkipSet is not a function`）。**补桩件，而不是把 `vectorCounts` 改成防御式**：类型签名声明的是完整 `MemoryDb`，把缺失方法吞掉，等于把真实接线错误一并藏起来。 ### 测试 - 新增 5 个用例：关闭态拒绝 / 未就绪拒绝 / 受理并驱动 L1+L0 且并发第二次立即被拒 / 卸载后拒绝 / `snapshot` 计数口径。**每条拒绝路径都同时断言「抛错」与「下游一次都没被调用」**——只断言抛错的话，一个「先调用下游、再抛错」的实现照样能过。 - **反证**：临时摘除就绪守卫后，`向量能力未就绪 → 拒绝，不谎报「已受理」` 确实变红（`expected [Function] to throw an error`），还原后复绿。 - 全量 **39 文件 / 403 用例**通过；`typecheck`（三份 tsconfig）、`build`、`smoke` 均绿。 ## [0.11.0] — 2026-09-13 ### 兼容性（按 DSH 插件框架文档适配） - **settings 注册跨版本兼容（0.1.1-rc.2 ~ 0.1.5-rc.2）**。`src/settings.ts` 此前从 `@deepseek-ai/dsh-settings` **值导入** `settingsNamespace()`，而 v0.1.3+ 已移除该导出符号——在 0.1.3+ 的宿主上模块加载即抛 `Failed to load plugins`，整棵插件树被拖垮。现改为： - 命名空间用字符串字面量 `'dsh-memory'`（浏览器半只看原始字符串，新旧宿主等价）；仅保留类型导入（编译后擦除，无加载风险）； - 注册走运行时三分支：优先 `settings.register()`（全部目标版本存在，返回 get/watch/update scope，live 开关与 UI 写入全走它）；回退 `settings.installSection()` 桥接（v0.1.2+ 服务面，仅 register 缺失时；运行时写入显式报业务错误）；两者皆无则降级为恒开——"settings 缺失绝不拖垮宿主"的铁律不变； - `SettingsScope` 改为本地结构类型，不再依赖包级类型导出。 - **新增 `dsh.plugin.json`**（DSH 发现清单：id / engines.dsh `>=0.1.1-rc.2 <0.2.0-0` / components 指向 `dist/` 产物），对齐 `dsh-plugin-template` 标准文件结构。 - **`@deepseek-ai/dsh-*` peerDependencies 转 optional 并放宽版本范围**（`^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-rc.1 || ^0.1.5-rc.2`），`@deepseek-ai/cordis` 保持必选——对齐 awesome-dsh-plugin 投稿要求 B.3。 - **新增 `screenshots.json`**（8 张，引用 `assets/img/`），投稿卡片可展示。 ### 变更 - `package.json` `version` 升至 0.11.0；npm `files` 补 `dsh.plugin.json`（`screenshots.json` 按 awesome-dsh-plugin 探测约定仅存于 git 仓库，不入 npm 包）。 ### 待实测 - v0.1.5-rc.2 上 `conversation.input.left` / `settings.section` 槽位与 Session V3 `session.surface.nodes` 语义（occupancy 估算）尚未实测，兼容矩阵见 README。 ## [未发布] > 📘 **踩坑与修复方向手册**：本轮及前两轮实际踩过的坑、走错过的方向已系统沉淀到 > [`ENGINEERING-NOTES.md`](./ENGINEERING-NOTES.md)（一页速查表 + 逐条「现象 / 根因 / 正确做法 / 如何验证」 > + 交付前验证清单）。涵盖：`nullable` 崩溃整棵插件树、deps 漏注入被降级分支掩盖、 > 重复解析器必然腐烂、守卫标志位放 `finally` 等于没放、长任务不置 `running` 导致界面无进度、 > 可选字段让 `tsc` 抓不到未定义标识符、空数据测试掩盖必崩缺陷、`vitest` 只转译导致契约漂移、 > 沙箱 `spawn EPERM`（含 `ESBUILD_BINARY_PATH` 为何无效）、PowerShell 管道捕获让 `tsc` 错误数变 0、 > 编码 BOM/乱码/行号漂移，以及 `git amend -m` 清空提交正文等 Git 陷阱。 ### 新增 - **§E 存储作用域 `scope`（可见范围，与 `family` 正交）**。此前所有项目共用一份记忆库：项目 A 沉淀的 `work` 族记忆在项目 B 的会话里同样被召回。新增 `scope` 配置（`global` 默认 / `workspace`），与既有 `family`（内容类型）**正交**——`family` 问"这是什么内容"，`scope` 问"它该在多大范围内可见"，四象限都存在。「`workspace` 模式下按工作区隔离 `work` 族、`chat` 族默认仍全局」是**默认值不是推导规则**（个人记忆本应跨项目，而污染面恰在项目之间）。 - **零漂移是构造性的，不是比对出来的**：`cfg.scope` 非 `workspace` 时统一的 `scopeFilterOf` 恒返回 `undefined`（= 不过滤），任何调用点都不可能意外传进一个工作区标识。既有部署（不传该键）行为与改动前**逐字一致**。 - **隔离落在与族隔离同一层**：不只是检索出口——**去重候选召回**同样过滤。候选池决定新的去重决策，此处跨工作区会产出「项目 B 里看不见、却已经决定了项目 A 记忆去向」的记忆，比不隔离更糟（[`ADR-0008`](./docs/adr/0008-storage-scope-vs-family.md)）。图谱路按**来源记录**的归属在同层过滤；写入路径（抽取管线 / `memory_add` / `memory_import`）共用同一个 `resolveRecordScope`。 - **工作区标识取 canonical cwd，而非宿主 `dsh-workspace` 的 `WorkspaceId`（uuid）**：与 §A 的 `parentSession` 同一条 header 通路、同步可得；声明 `inject` 会让缺该服务的宿主整树加载失败；宿主自己的成员判据本就是「session header 的 canonical cwd == workspace path」；uuid 需要"已注册的工作区"，未注册目录下隔离会静默失效。已知边界：**不解析符号链接**，后果是过度隔离（安全方向）而非泄漏（[`ADR-0009`](./docs/adr/0009-workspace-identity-source.md)）。 - **迁移只标注归属，不搬运不删除**：`l1_records` / `l1_fts` 各补 `scope` + `workspace_id` 两列，存量数据由 `ALTER` 的 `DEFAULT` 直接标为 `global`——条数、id、content、created_time 逐字不变。 - **执行期抓到两处真问题**：① **FTS 重建回灌漏带 scope 会静默抹平隔离**（`backfillL1Fts` 参数与 insert 语句不对齐时会被它自己的逐行 `catch` 吞掉，症状是 `count=0` 的空索引）；② **写入侧漏做形态归一 → 记忆写进去却再也查不出来**（检索侧传归一后的小写路径，写入侧原样存调用方的大写字符串，字符串相等判定必然落空）。两者均由端到端测试与变异探针抓出并修复。 - **§F 图谱节点向量列 `graph_node_vec`（存储与降级地基）**。图谱此前只有词法加权打分，无向量列——"云深处"与"DeepRobotics"这类**语义等价但字面不同**的实体无法互相消解。新增与 `l1_vec` **同模式**的 vec0 虚拟表（同一份编码、同一种 `float[N] distance_metric=cosine` 声明），维度**复用**既有能力探测结果，不新增一套。 - **降级内层消化**：vec0 缺失时建表会抛，若冒到 `GraphStore.init` 外层那层 `catch`，图谱会从"向量路不可用"退化成"**整个图谱域不可用**"——词法检索、投影、裁决全部陪葬。故向量列自带窄 `try/catch`。接口在停用态一律 no-op 返回，调用方无需判断能力位（[`ADR-0011`](./docs/adr/0011-graph-node-vector-storage-and-degradation.md)）。 - **本波只有门，没有生产者与消费者**：投影管线尚未接线去算嵌入。如实登记为未完成——它是 §F 的起点而非终点。 - **§B L1 决策凭证链（可追溯性基础设施）**。`memory.db` 里每条 L1 记录都是**去重决策的结果**（store / update / merge / skip），但决策本身不留痕——事后只能看到"结果长这样"，看不到"当时基于什么做的判断"。新增 `l1_receipts` 表：每次去重决策留一条凭证（`run_id` / `record_id` / `kind` / **候选池有序序列的 sha256 摘要** `input_digest` / `decided_at`），配套新工具 **`memory_receipts`** 与 RPC 端点 **`dsh-memory/receipts`**，按记录或按批次**双维回溯**（同给为 AND）。凭证必须在事件**之前**存在——输入快照**无法事后补录**，故本能力前置落地、不设症状触发条件（[`ADR-0006`](./docs/adr/0006-l1-decision-receipts.md)）。 - **`input_digest` 三项刻意设计**：**顺序敏感**（候选池是有序的，"当时看到哪些候选、按什么序"正是要复原的输入）、**重复不折叠**（候选池里的重复本身是事实）、**长度前缀编码**（否则 `['a|b']` 与 `['a','b']` 会碰撞——序列化不是单射，摘要就失去指纹意义）。 - **保留策略**：按 **run 数**裁剪（`RECEIPTS_MAX_RUNS = 1000`）——时间窗口**给不出行的上界**（阈值与写入速率无关，高频用户 90 天能写进任意多行，无界增长只是被**推迟**）；裁剪**粒度是 run 而非行**——按行裁剪会切出"半截批次"，让"这一轮都判了什么"给出**看似完整、实则遗漏**的结论，危害**高于查不到**。 - **红线**：裁剪**只碰 `l1_receipts`，绝不碰 `l1_records`**——前者是可丢弃的观测数据，后者是用户的事实源，为省几 MB 而波及记忆本体是把容量优化做成了数据丢失。 - **失败隔离**：凭证是旁路设施，写失败只记 `warn`、**绝不中断 L1 蒸馏**。 - **§C 矛盾冻结（可选，默认关）**。此前去重**决策词表**只有 `store` / `update` / `merge` / `skip`——"冲突检测器"（`CONFLICT_DETECTION_SYSTEM_PROMPT`）检测到矛盾后**由 LLM 直接裁决落盘**（`update` 覆盖或 `merge` 合并），**没有"停下来等人裁决"这个选项**。开启 `conflictFreeze.enabled` 后词表新增 `conflict` 动作：LLM 判定"两边都像是对的、机器判不了"时，把冲突对**停放**到 `conflict_pending` 队列——**新记忆照常入库，双方内容都不被改写**，由新工具 **`memory_resolve_conflict`**（RPC：`dsh-memory/conflict-resolve`）交人裁决，结论 `winner` / `loser` / `both`。 - **冻结不是"拦住写入"，而是"不自动裁决"**——实现成前者会丢信息，比它想解决的问题更糟。 - **安全阀**：`maxPending`（队列上限）/ `timeoutDays`（超时降级）。语义是"**不收新的**"而非"偷偷删旧的"：被自动了结的对**仍写入队列留痕**，`resolution` 记为 `auto` 以区别于人工结论。没有安全阀的两个后果都是确定的：队列无界增长；"两条互相矛盾的记忆长期并列召回"永久留在库里。 - **图谱侧**：被冻结的记录，其**来源命中的图谱节点**标为 `disputed`（复用既有状态；该状态仍在检索候选内，是"照常召回、但状态可见"的中间态）。该标记是**派生同步**而非单向标记——裁决会**撤销**争议，单向标记会让已裁决的节点永远停在 `disputed`，那是**派生图谱在说谎**。 - **零漂移**：关闭时去重 prompt 与改动前**逐字节相同**——这是**构造性**保证（关闭态直接 `return base`），不是人工比对出来的（[`ADR-0010`](./docs/adr/0010-conflict-freeze-default-off-and-timeout.md)）。 ### 变更 - **新增配置** `conflictFreeze.enabled`（默认关）/ `conflictFreeze.maxPending`（100）/ `conflictFreeze.timeoutDays`（30，`0` = 不做超时降级）；**新增端点** `dsh-memory/receipts` 与 `dsh-memory/conflict-resolve`（端点面 26 → 28）。 - **`L1ReceiptKind` 新增 `conflict`**。扩词表时必须同步检查**所有消费该词表的地方**（凭证归一、统计日志、渲染文案、schema 描述）——执行期实测：漏登记会把"模型**明确**说判不了"记成 `skip_missing`（= "模型**没答**"），而 §C 的裁决可审计性**完全**依赖凭证链，审计结论与事实**正好相反**（比缺一条凭证更糟：缺了是"查不到"，错了是"查到了错的"）。 - **`GraphStore.markSourcesDisputed`（单向标记）→ `syncDisputed`（派生同步）**：`active` 且来源命中 → `disputed`；`disputed` 且来源不再命中 → 复原 `active`；`archived` 墓碑不动。管线侧传的是**当前全部未裁决对的记录集**，而非本轮新增那一对。 - **裁决顺序刻意为之**：先打 `resolved_at` 再退场败方——反过来的话，"记录已消失、队列里那条仍在待裁决"要等人再点一次才发现无据可依；打标用 `WHERE resolved_at = ''`，**二次裁决不覆盖第一次结论**。 ### 测试 - **§B 新增 5 个测试文件**（凭证建表与摘要、写入点与失败隔离、保留策略、双维查询、端到端回溯），含**变异探针**：把裁剪表换成 `l1_records` 后红线用例确实失败。 - **§C 新增 7 个测试文件**（词表 / 建表 / 开关 / 冻结语义 / 安全阀 / 裁决 / 闭环），均按 TDD 先观察 RED。三条**区分性**判据值得一提：`version===0`（区分 store 语义与 merge/update 语义）、端到端抓真管线实际送出的 prompt（静态函数全绿**证明不了**管线把开关传了下去）、`both` 分支变异后用例确实变红。 - 全量 **34 文件 / 341 用例**；CI 七步链（`typecheck` / `test` / `lint` / `build` / `build:smoke` / `smoke` / `verify-catalog`）全绿。 - 闭环实测留档：真 `runExtraction` × 2（仅 LLM 传输层打桩）→ 真裁决端点，原始 JSON 存档于计划域 `evidence/`。 ### 修复 - **未识别动作被兜底分支静默承接**。`pipeline/l1.ts` 的应用循环只对 `store` / `skip` 显式分支，**其余动作一律落到 update/merge 分支**。conflict 决策按设计不带 `target_ids`，于是 `targets=[]` → 记录被当成"替换了 0 条"的合并产物追加，`version` 被算成 `1`。**不报错、不丢数据，唯一痕迹是一个 version 数字**——即"conflict 被静默降级为 merge/update"，正是 §C 要消灭的行为。**修复**：显式 `conflict` 分支；校验不过或开关关闭时**回落 `store`**，绝不落到兜底分支。 - **端点门禁是手抄副本**。`tests/contract-keys.test.ts` 的 `ENDPOINTS` 是真实注册表（`src/stats.ts` 的 `MEMORY_ENDPOINTS`）的**手抄副本**，两条断言只在该副本内部自洽（`ENDPOINTS.length === 26`）。§B 新增 `dsh-memory/receipts` 使真实注册表升到 27 时，副本**没有跟着更新**，而数量断言仍停在 26——于是"断言与副本一致、副本与事实不符"让它**一路绿灯**；本次新增 `conflict-resolve` 后**依然全绿**。**门禁测的是自己的影子**：被测系统换成什么都不会变红。**修复**：新增 `expect([...ENDPOINTS].sort()).toEqual([...MEMORY_ENDPOINTS].sort())`——本地清单必须与唯一事实源**逐项一致**，数量断言保留作为变更时的显式路标。 - **插件树加载失败：工具输出 schema 使用了 DSL 不支持的 `nullable` 关键字**（回归修复，会导致 DSH 完全无法启动）。`memory_ruminate` 与 `memory_ruminate_status` 的输出 schema 在 `startedAt`/`finishedAt`/`error` 上声明了 `nullable: true`，而 DSH 的 value schema DSL 只接受一组白名单作者键（`description`/`title`/`default`/`examples`/`required`/`enum`/`const` 及各类型的 `type`/`properties`/`additionalProperties`/`items`/`oneOf`）。`defineTool()` 编译 schema 时抛 `JsonSchemaError: schema.properties.startedAt.nullable is not supported by the value schema DSL`，loader 随之判定 `dsh-memory (dsh-prime-memory)` 条目加载失败，整个插件树 apply 中止，进程以未捕获异常退出。 **修复**：删除 4 处 `nullable: true`。语义不变——该 DSL 中属性默认即为可选，仅显式 `required: true` 才必填；且运行时校验对 `undefined` 做跳过处理，`execute` 返回的 `startedAt: undefined` 依旧合法。校验步骤：`tsc` 编译通过 + dist 产物已无该关键字 + 新增工具注册回归用例。 - **反刍（ruminate）RPC 端点全部不可达：控制器从未注入端点 deps**。`dsh-memory/ruminate-status` 恒返 `{supported:false,running:false,phase:'idle'}`，`ruminate-start`/`ruminate-cancel` 恒抛「反刍控制器未初始化」。根因是 `EndpointDeps.ruminate` 虽已声明、三个端点实现也已写好，但 `registerMemoryRpc` 组装 deps 实参时未把控制器注入，`deps.ruminate` 恒为 `undefined`，端点被永久钉在降级分支上。 **用户可见影响**：反刍面板（`RuminatePanel.tsx`）依据 `supported === false` 整块 `return null`，因此表现为"功能不存在"而非报错，故障因此长期未被察觉；修复后面板首次实际渲染。 **修复**：把 deps 组装抽为可测接缝 `buildEndpointDeps()`（单一所属者），由它显式把控制器写入 `ruminate` 字段；`rebuild`/`embedManager`/`sessionInfo` 由此与 `ruminate` 走完全同一条注入路径，不再有第二条位置形参。 **校验**：`dsh-memory/ruminate-status` 在注入 stub 后返回 `supported !== false`。 - **反刍必崩：`pending.json` 被二次解析且漏解包 `buckets`，`TypeError: messages is not iterable`**。`RuminateController.start()` 用自带的 `readPendingBuckets()` 把 `JSON.parse(readFileSync(file))` 直接断言成 `PendingBuckets`（`{auto,chat,work}`），但磁盘真实形状是 `PendingFile`（`{version,buckets:{auto,chat,work},warmup}`）——**漏了一层 `buckets` 解包**，于是 `buckets[mode]` 恒为 `undefined`，在 `groupPendingBySession` 的 `for (const m of messages)` 抛错。 **用户可见影响**：**该功能从未成功过一次**。错误只在"文件不存在"时才被 `catch` 兜成空桶走通；而 `persistPending` 每轮都会写这个文件，所以在任何有缓冲的真实部署里点反刍必然失败，面板显示红字。**注意与直觉相反**：抛错与桶里有没有数据**无关**，空桶同样抛——此前"三桶为空所以未暴露"的判断是错的，真实原因是反刍从未被触发过（`memory.log` 无 `反刍开始` 记录）。 **修复**：删除 `readPendingBuckets()` 与 `readFileSync`，改为复用 `store/pending.ts` 的 `loadPending()`——它是桶形状的**唯一权威**，并免费带来形状校验、逐桶 `Array.isArray` 校验、`isMessage` 坏行丢弃计数、旧格式 `LEGACY_SESSION` 归组与 `warmup` 校验。**不在 `pending.ts` 新增第二个入口**（那正是本缺陷的成因：同一语义两条实现路径，其中一条腐烂且无人察觉）。 **校验**：新增控制器级用例先红后绿（红：`TypeError: messages is not iterable` @ `pending.ts:104` ← `ruminate.ts:75` ← `:139`；绿：`total` == 会话组数、`mode` 由桶键推导）；`dist/pipeline/ruminate.js` 已无 `readPendingBuckets`。 - **反刍失败后状态与界面自相矛盾**。失败路径从不写 `this.status`（原 `:149-155` 仅成功路径赋值），于是 `ruminate-status` 仍返回 `phase:'idle'`/`error:null`，UI 的 `failed` 分支永不亮——用户看到报错红字，状态端点却说一切正常。**修复**：catch 内写入 `phase:'failed'` 与 `error`，并 `logger.warn` 后再抛出。 - **反刍进度与产出恒为 0，导致修复效果无法判定**。`totalL1` 只被声明/归零/读出而**从不累加**，`status.done` 无任何自增点，因此 `recordsBuilt` 恒 `0`，完成日志恒为 `0/N 会话, 产出 0 条记录`。**修复**：`PipelineTask` 增加 `onDone` 完成回调（`drain` 内调用且回调异常不影响管线），`enqueue` 透出 `onTurnDone`，反刍据此累加真实记录数；`doEnqueue` 收尾时置 `status.done = index`。 - **三处静默失败点**：`loadPending` 的 `catch` 与 `doLightRefresh` 的 `.catch(() => {})` 把"文件不存在（正常）"、"不可读/损坏（需告警）"、"形状不符（需告警）"压成同一个静默降级，与"合法空 pending 的轻量刷新"在日志和状态上完全不可区分，用户看到 `phase:'done'` 误判成功。**修复**：`loadPending` 区分 `ENOENT`（静默）与其余（`warn` 含文件路径与原因），形状不符亦 `warn`；`doLightRefresh` 改为 `await` 且**仅在成功后归零** flag，失败记 `warn`（原先失败也归零，等于吞掉重试机会）。 - **反刍"轻量刷新"期间谎报空闲、无进度、无取消**（用户实测反馈）。`start()` 在无 pending 切片时 `return await this.doLightRefresh()`，而该分支**从不置 `running`**——于是等待期间 `ruminate-status` 仍返回 `phase:'idle'`/`running:false`。但这里的 L2/L3 是**真实 LLM 调用**（实测单次 70 秒以上），期间 `start()` 一直挂在 await 上占住守卫。 **用户可见影响**：点反刍后界面只有一句静态说明，**无进度条、无取消按钮、无阶段、无耗时**；此时再点一次就得到「反刍已在进行中」——正确但毫无信息量，无法判断"在跑"还是"卡死"。 **修复**：轻量刷新改为**如实上报**——先按 L2/L3 待办族数登记 `total`，逐步骤自增 `done`，并新增 `RuminatePhase='refreshing'` 与 `detail` 描述当前动作（如「L2 场景整合(chat)」）；完成日志由静默改为 `反刍轻量刷新结束:2/3 步,耗时 84s`。面板相应显示阶段名、`已完成/总步数(百分比)`、**实时已用时长**与当前动作，并把 `refreshing` 视为运行态。 - **反刍进行中不显示已用时长**：L2/L3 单次调用可达分钟级，只显示"运行中"无法区分"在跑"与"卡死"。**修复**：运行期间每秒重算并显示 `已用 X分Y秒`。 ### 变更 - **`RuminateStatus` 新增 `detail`；`RuminatePhase` 新增 `refreshing`**：为分钟级步骤提供可观测性（向后兼容：新增可选字段 + 联合类型新增成员）。`detail` 在蒸馏阶段给出「会话 （第 i/N 个）」，在收尾/刷新阶段给出当前 L2/L3 动作。 - **`DshMemoryRequestMap` 补上反刍三键**（契约修复，恢复 CI 类型门禁）：响应映射表早已声明 `dsh-memory/ruminate-status|start|cancel`，而 `DshMemoryEndpoint = keyof DshMemoryResponseMap` 因此把它们纳入端点联合类型，但**请求映射表漏了对应三键**——于是 `client/src/rpc.ts` 的 `DshMemoryRequestMap[K]` 报 `TS2536`，`tsc -p tsconfig.client.json` 恒失败，**CI 的 `npm run typecheck` 必红**。修复为与 `rebuild-*` 同形的三行 `Record`（三个端点均无入参）。验证：三份 tsconfig 全部 exit 0，`npm run typecheck` 完整链路 exit 0。 - **`registerMemoryRpc` deps 组装抽为 `buildEndpointDeps()`**：为"哪个控制器落入哪个字段"提供可测接缝，并以 `EndpointDepsInput` 类型约束注入面，使漏注入字段在编译期即可暴露（此前该缺陷是运行时静默降级）。`handleEndpoint` 与 `EndpointDeps` 一并导出以供测试直调。 - **反刍增加启动锁 `starting`**：`loadPending` 使 `start()` 在守卫与 `status.running` 置位之间多出一个事件循环让出点，双击/连发 RPC 可双双穿过守卫、两套 `sessions` 互相覆盖。新增标志位封住该窗口。**注意**：该标志在 distilling 分支末尾显式复位，而非放在 `finally`——因为 `doEnqueue` 是异步入队，`finally` 会立刻清旗使守卫失效；跨 `await` 的持久守卫是 `status.running`。 ### 测试 - 新增 RPC 层「控制器端点注入护栏」5 例：`rebuild` 与 `ruminate` 两族各自覆盖「已装配 → status/start/cancel 可达」与「未装配 → status 降级、start/cancel 报未初始化」，另含 `rebuild-start` 的存储降级守卫分支。两族共用同一范式（可选控制器 + 降级响应 + deps 注入），`rebuild` 注入本就正确，作为对照组锁住范式形状。测试用例数 194 → 199。 - 新增 `tests/ruminate.test.ts` 5 例，钉死**控制器真实读取路径**这条此前零覆盖的契约：三桶含真实消息时不抛且 `total`/`mode` 正确、手写磁盘形状 JSON（**不经 `savePending` 往返**，避免"读写两侧同时改错仍通过"）、三桶皆空走轻量刷新、文件缺失走轻量刷新（ENOENT 正常路径）、并发 `start()` 仅一次通过。测试用例数 199 → 204。 - **顺手清理 `tests/` 的 10 个既有 lint error**（未使用导入/变量、`require()` 改为顶层 ESM 导入、恒真条件），使 `lint` 范围得以纳入 `tests`。**此前测试目录完全游离于 lint 之外**。 - **`npm test` 与 `npm run lint` 首次接入 CI**：`.github/workflows/ci.yml` 原先只跑 `typecheck → build → build:smoke → smoke → verify-catalog`，**从不跑测试**——测试写了等于没写。现已补入门禁。 ### 已知限制 - **`tests/` 类型门禁仅部分开启（ratchet）**：新增 `tsconfig.test.json` 并纳入 `npm run typecheck`，但因 8 个既有测试文件存在约 60 个类型错误（`MemoryConfig` 模块错位、`DistillBudgets` 缺 `graph`、`UserMessage.turn`、只读数组赋值、`rpc.test.ts` 大量裸 `as` 等），当前只纳入 `tests/ruminate.test.ts` 与 `tests/stores.test.ts`。详见 `pending-issues.md` P8——**这反映测试已与类型契约漂移，而 vitest 只转译不检查，故运行时全绿却无人察觉**。 - **反刍存在磁盘/内存双事实源**：会话清单取自磁盘 `pending.json`，但实际抽取在 `runner.ts:667` 从**内存桶**按 `sessionId` 取消息，故传入的 `session.messages` 对结果无影响。窗口内可能漏蒸馏或空转（`total` 虚高）。建议由 runner 暴露内存只读视图根治，见 `pending-issues.md` P9。 - **反刍收尾竞态**：`setImmediate` 链不等队列排空，单会话也会立刻 `finalize`，使 L2/L3 对着陈旧 L1 白跑一次（记录经 `l1.ts:264` 后续补整合，**非丢失**）。见 `pending-issues.md` P10。 - **反刍进行中的单次 LLM 调用不可中断**：点「取消整理」只会在**当前那一步完成后**停止后续步骤。L2/L3 单次可达分钟级，这是取消延迟的成因。 ## [0.10.0] — 2026-09-06 ### 新增 - **知识图谱投影**(L1 的可重建投影,回答"人物/项目/组织/工具/地点现在是什么状态"):L1 蒸馏产出的记录按批喂给模型提案实体与有向关系,`applyGraphProjection` 硬校验落库——**零无来源事实**:每个节点/fact/边的 `sourceRecordIds` 必须全部属于本批认领的记录,越批提案整条静默丢弃,任何图谱结论都能沿 `节点 → sourceRecordIds → L1 记录 → JSONL 事实源` 回查。实体消歧(NFKC 归一 + 类型一致合并,别名累积)、状态历史(supersede + validTo 闭合,`currentState` 只由 active facts 重建)、时间锚四级链(`activity_start_time → activity_end_time → timestamps → createdAt`,无证据不猜日期)。图谱表族可随时 drop 重造,不作事实源。 - **投影任务队列**(GraphStore,独立降级:初始化失败仅图谱 no-op,不传染主存储):持久化 job 状态机 pending → running → completed/dead,去重下推 SQL(在途 mapping + 投影台账两张索引表,不做全 job 扫描);优先级不倒挂(新蒸馏 10000 > 存量补投影 100);attempts 封顶转 dead、指数退避 `nextAttemptAt`、启动回收 running→pending;`deleteL1Batch` 后删除传播(来源全失效的节点/边惰性标 archived)。LLM 调用永不进事务(claim 与 complete 是两个事务缝,complete 单事务原子提交)。 - **图谱检索与工具**:字段加权检索(name×6/aliases×5/tags×5/currentState×4/facts×4/relations×3/type×2),仅关系词命中的邻接噪声过滤,`matchedFields` + 中文 `matchReason` 可解释输出;新工具 `memory_search_graph`(紧凑节点卡)与 `memory_expand_graph_node`(facts 全量含历史 + 关系边),受与 `memory_search` 同款的档位/注入拒读门约束,并按会话族过滤(纯档只见本族衍生节点)。 - **RPC 端点 24→26**:`dsh-memory/graph-search`(检索)与 `dsh-memory/graph-node-get`(详情展开;悬挂 id 返回 `node=null` 不解析);契约单一事实源同步,client 泛型调用面零改动自动获得新端点类型。 - **预算键扩容**:`DistillBudgets` 加 `graph` 键(默认 8000,设置页图谱行可编辑);`layerKeyFor('graph')` 显式回全局解析,绝不落入 l1 层链;图谱投影成本进总额与按模型分组,不进 l1→l2→l3 分层表与趋势(旁路豁免)。 ### 变更 - **新配置**:`config.graph.enabled`(部署级,默认 **false**——开启后还需运行时蒸馏开关同时为真;泵护栏:每轮 drain 至多一个图谱任务、永远让位实时蒸馏轮次)。 - 插件版本 0.9.0 → 0.10.0(端点面变化)。 ## [0.9.0] — 2026-09-01 ### 新增 - **Hall 粗分类通道**：与 `family`/`type` 正交的粗属性面。`types.ts` 定义 `HALL_CATALOG`（唯一事实源：主线 `work`/`relationships`/`general` 默认启用，实验性 `finance`/`journey` 带 `experimental` 标记）；`config.hall.enabled` 控制参与打标的 Hall。L1 抽取阶段按启用列表自动给 `metadata.hall` 打标（无法明确归类时省略该字段，不强制 General）；`ListRecordsRequest.hall` 与 `UiRecord.hall` 扩展契约，记忆浏览新增 Hall 筛选下拉与卡片 Hall 标签。 - **远程嵌入运行时覆盖**：嵌入 `baseUrl`/`apiKey`/`model`/`dimensions` 改为**设置页可编辑**，运行时覆盖部署 YAML（`effectiveCfg` 注入 `cfg.embedding` 子树，与 llm 通道独立）；`EmbeddingManager` 增 `getEff()` 读取运行时覆盖后的生效配置，使设置页编辑即时生效。 - **高权限写删工具**：注册 `memory_add`（显式"记得 X"→直接落库一条 L1，可选 `hall`）与 `memory_delete`（语义检索命中后删除，最多 10 条），受 `live.memoryMutate`（设置页高权限模式）门控；记忆浏览新增高权限开关（二次确认）与单条删除按钮。 - **多语文档**（对标 `multilingual-docs-skill`）：`README`/`INSTALL`/`CHANGELOG` 覆盖 `zh`/`en`/`ja`/`ko`，每页顶部语言切换互链（母语书写），`ja`/`ko` 页附 DSH 兼容性说明。 - **工具链**：接入 ESLint 9 扁平配置与 Vitest，新增 `npm run lint`/`npm run test`，并补 `HALL_CATALOG` 与 Hall 抽取 prompt 的首批单测。 ### 变更 - **远程嵌入 `apiKey` 改为可选**：接受免 key 自托管 `/embeddings` 服务（`remoteCeiling` 不再强制 `apiKey`）；无 key 时不注入 `authorization` 头，避免空 `Bearer` 被拒。 ### 修复 - 远程嵌入在 `apiKey` 为空时不再发送空 `Bearer` 头。 ### 已知限制 - `EmbeddingManager` 构造点（`src/index.ts`）尚未传入 `getEff`，运行时覆盖暂未流入管理器内部嵌入服务，待后续补齐接线。 ## [0.8.11] — 2026-08-29 ### 修复 - **会话档位控件手机端适配**：pill 与滑动选择器此前只按桌面 Web 布局考虑——浮层以 pill 中心为轴向上悬浮，而 pill 位于输入栏左侧，手机窄视口下浮层左半会被屏幕裁掉。 现在浮层做水平视口夹持：打开时量一次，被裁（含侧边栏开合把输入区挤向屏幕边缘 这类布局位移）即自动贴边，桌面端天然在界内，零行为变化； 点按外部关闭从 `mousedown` 换 `pointerdown`（iOS 触点纯文本区不合成 mouse 事件， 原实现在手机上会漏关）；pill 与滑轨的命中区按触屏 44px 标准上下扩出隐形热区 （视觉一像素不变、浮层几何零变化，全端统一——桌面点中目标同步变大）。滑动选择器 交互逻辑（点按设档、拖拽动量投影吸附）不变。 ## [0.8.10] — 2026-08-28 ### 新增 - **会话级「只写不读」（Issue #38）**：某些会话希望记忆系统「只进不出」——继续 捕获对话、参与蒸馏，但不向当前会话注入任何记忆。此前 off 档是完全隐身（连捕获 都关、未蒸馏切片挂起），召回开关又只有全局粒度，表达不出这个组合。现在悬浮板 新增**「注入」三态开关（跟随全局 / 开 / 关）**：设为「关」即只写会话——L0 捕获 与 L1→L2→L3 蒸馏照常，召回注入、画像/导航稳定区、工具指南一并停止， `memory_search` 等读工具返回只写提示（写入走捕获钩子不经工具，语义无洞）。 pill 面文随状态换作 `记忆·只写`（注入态优先上脸，族名收进滑轨）；覆盖按会话 持久化、与档位正交（切档不丢），「跟随全局」即清除；「全局关 + 个别会话开」 反向组合同样成立。优先级链：部署上限 > 全局开关 > 会话覆盖 > off 档（完全隐身 语义不变）。悬浮卡「召回命中」停用原因同步细分（新增「会话只写」一因）。 适合调试/评测、敏感/一次性、长期后台等「只吸收不干扰」的会话。 ![只写会话：pill 面文换字与注入三态开关](assets/changelog/0.8.10/01-write-only-pill.png) ## [0.8.9] — 2026-08-27 ### 新增 - **蒸馏按层独立路由（Issue #34 / ADR-0005）**：蒸馏各层对模型诉求不同（L1 高频要便宜快稳、L3 低频大输入要强能力），现在可以**按层各配一条完整回退链**。 双入口：部署 YAML `llm.layerRoutes`（层键 l1/l2/l3，头行必须显式供应商+模型） 与设置页运行时 `distillLayerChains`；层内优先级**运行时层链 > 静态层链 > 全局 默认链**逐级兜底，非空即完整替换该层（覆盖层降级绝不落全局链），未配置层行为 一个比特不变；部署 pin 只锁运行时侧（静态层链照常生效）。设置页「蒸馏参数」 重构为**分段面板**（全局默认 / L1 / L2 / L3）：分段状态点总览（蓝实心 = 运行时 自定义 / 空心 = 静态 YAML / 灰 = 跟随全局）+ 一行图例提示（优先级关系挂 tooltip） + 全局面板「在用：哪些层」标注 + 分层预算随层归组（语义零改）。分层输出预算的 high/xhigh/max ×4 放大触发跟随层档位（层链头候选 > 全局候选）；记账零改动（token_cost 行级 已按 层+实际服务路由 归因）。 ![蒸馏参数分段面板 · 全局默认](assets/changelog/0.8.9/03-layer-segmented-panel.png) ![L1 层面板 · 跟随全局只读预览与分层预算](assets/changelog/0.8.9/04-layer-l1-panel.png) - **上下文占用指示器（官方环外圈记忆光晕弧 + 明细面板分项）**：插件注入的记忆 内容此前混在官方上下文环的大类里不可见，现在——输入栏官方环外侧多一条品牌蓝 **发光细弧**（长度 = 记忆占窗口比，与官方环同帧）；点开官方面板，底部多一节 「记忆占用」，列**召回片段 / 记忆稳定区**两行分项（官方同款 `~5.5K` 格式与 亮色数值）。数字与官方 token-meter 同一固定密度启发式（`ceil(chars/4)+开销`， UTF-16 制式），分母为主对话模型的官方声明窗口；旧会话照常支持（live 会话 surface 现扫 + 持久化服务读存储前缀回填），重启不丢（occupancy.json 写穿）， OFF 后既定事实继续可见、随压缩自然衰减。纯附加实现：移除全部新增节点后界面 逐比特还原原生形态。 ![明细面板记忆占用分项](assets/changelog/0.8.9/01-panel.png) ![官方环外圈记忆光晕弧](assets/changelog/0.8.9/02-halo.png) ## [0.8.8] — 2026-08-26 ### 新增 - **RPC 契约单一事实源 `src/contract.ts`**：23 个 `dsh-memory/*` 端点的请求/响应 类型集中为 types-only 模块（零运行时代码），host 侧（stats.ts 的 case 表）与 client 侧共享同一套形状——契约漂移在编译期暴露，而不是等 UI 渲染出 undefined。 各 host 模块的纯数据类型（MemoryStats / RebuildStatus / CostSnapshot 族 / EmbeddingStateView / MemoryLiveSettings / RecallSessionStats 等）迁入契约并在 原处保留 re-export；`EFFORT_CHOICES` 经 `satisfies` 反向锁定词表漂移。 - **client 半边迁移 TS/TSX + esbuild 打包**：`client/client.js`（3433 行手写 ES5 单文件）重写为 `client/src/` 多文件 TSX（按底座/控件/pill/tabs 分层）， 经 `scripts/build-client.mjs`（esbuild，cjs 体包进 factory wrapper，与官方 dsh-client-ui-* 包同构）产出单文件 `dist/client.js`。react / react/jsx-runtime / @deepseek-ai/* 全部 external（宿主 require 注入，防双 react 实例）；**行为零 变更**（UI 逐像素等价、RPC 端点与载荷不变、handoff 协议不变）。新增 `npm run typecheck`（主 tsconfig + tsconfig.client.json 双检）；smoke 第 21 节 改为对**产物** dist/client.js 的断言（协议形状 + external 接线 + 既有令牌/ 圆角/粒子场断言等价迁移）。 - **蒸馏路由链编辑器（设置页 UI，统一列表）**：一张有序列表取代旧「蒸馏思考」 全局切换器与「蒸馏模型」单路由选择器——第 1 行主路由（徽标「主」，可留空 跟随默认模型），后续行按序降级；**档位逐路由设置**（缺省「跟随部署配置」， 仍过能力钳制）。运行时新键 `distillChain`（≤8 条；主路由行双空或双全、回退行 必显式、重复条目拒收；空数组 = 跟随部署配置）。RPC：llm-providers 增 `chain` 块（current 含旧键投影 / static / effectiveChain / source）、llm-models 每模型 附 `efforts` 档位表。位置即优先级：第 2 行可与主路由互换 / 顶替（空主路由被 顶替不保留）；pinned 只读；跟随态「编辑为运行时链」一键拷贝静态链。设计 spec 见 `design/settings-spec.md`（RouteChainEditor 节）。 - **蒸馏回退链（#31 方案 1）**：`llm.fallbacks` 对象列表（条目 = provider + model + 可选 `reasoningEffort`）——主路由失败（报错/被掐断/网络异常/空输出）后按条目 顺序自动降级，某条路由成功即返回；与主路由完全相同的条目跳过；每条路由各享 全额 `llm.timeoutMs`；条目档位非空覆盖全局档位（旧运行时键 `reasoningEffort` 的整体接管——含给条目盖章——在未配置 `distillChain` 时仍对存量值生效）；调用方 主动取消不降级原样上抛；全部失败抛最后一个错误交既有按会话 指数退避。token 成本与蒸馏用量逐次尝试记账、成功记实际服务路由；降级切换 info 日志 + 单路由持续失败一次性告警。缺省空数组 = 单路由行为不变。中英 README 新增"蒸馏回退链与慢 TTFT 模型"章节（含配置示例与三层缓解策略）。 ### 变更 - **设置页删除「蒸馏思考」全局切换器与「蒸馏模型」单路由选择器**：并入统一路由 链编辑器（档位逐路由化）。旧运行时键 `reasoningEffort`/`distillProvider`/ `distillModel` 语义逐比特不变（effectiveCfg 只认显式 `distillChain`，存量值 兼容读取），UI 不再写入。 - **空输出改判为调用失败**：`callLLM` 对"流正常结束但 0 字符输出"从返回空串 （warn 日志）改为抛错（完整诊断日志保留）——原行为只是把失败推迟到下游 JSON/Markdown 解析且诊断更差；未配置回退链的部署同样生效，蒸馏各层的既有 失败兜底路径（只记日志不阻塞管线）天然兼容。 ## [0.8.7] — 2026-08-25 ### 新增 - **token 成本看板（#30，贡献者 @Irvington258）**：每次蒸馏 LLM 调用 （l1-extract / l1-dedup / l2 / l3）的 token 成本按 `provider/model` 复合键写入 SQLite `token_cost` 明细表（含旧表 provider 列迁移），设置页新增「成本」Tab： 按模型分色的趋势折线（`--dsh-mem-chart-1..8` 图表系列令牌，日/周/月粒度 + 近 N 天窗口强制日粒度 + L1/L2/L3 层级过滤）、层级 × 时间窗口表格（调用数 / 输出与思考 token / 均值 / 中位数，median 在 JS 侧计算）、按模型累计列表， 经 `dsh-memory/token-cost` 只读 RPC 拉取、5s 轮询。数据口径：输入按字符 （dsh 流式 usage 不含输入 token，沿用 llm-usage 口径），输出/思考按 token； 记账挂在 callLLM 出口、成功/失败双路都记，记账失败只 warn 绝不阻塞蒸馏； 语句构造期 prepare 缓存；插件卸载清理模块引用。 - `tokenCost.retentionDays` 配置项（默认 `365`，`0` = 永久保留）：成本明细保留 天数，写入时滚动清理；成本看板「近 N 天」窗口上限同此值（保留期放开后 client 输入上限放宽到 3650，真实上限由后端按配置校验）。 ### 变更 - design spec 回写：`global-spec.md` 新增「图表系列色」节（数据可视化编码色类目—— 单强调色锁的功能性豁免，先例同档位色；8 档双主题令牌 + AA 对比度复算值， 浅色全档 ≥3:1 / 暗色全档 ≥4.29，第 1 档锚定品牌蓝、第 8 档中性灰收"其他"）； `settings-spec.md` 新增「成本 Tab（CostTab）」节；README 中英同步功能说明与 配置表行；smoke 新增 retentionDays 默认值/边界断言与图表令牌接线断言。 ## [0.8.6] — 2026-08-24 ### 新增 - **召回时效衰减加权（#29 建议 B）**：召回排序按 `相关度 × max(0.5, 0.5^(Δ天/半衰期))` 软加权（Δ 按记忆 updated_at）——相关度相近的候选之间新鲜记忆优先，长会话中召回名额 随使用自然轮转，陈年条目不再霸占 top-N。设计要点（对照 Generative Agents 与生产级 RAG 实践的取舍）：**乘法而非加法**——时效只能在相关度相近的候选间微调名次，永不 僭越相关性（加法会让不相关的新记忆靠 recency 上位）；**衰减地板 0.5**——老记忆最多 损失一半排序分，长期事实（"三年前写的咖啡偏好"）永不沉底，这让半衰期成为不敏感旋钮； 缺 updated_at 的记录按最老处理（地板接管，零特判）。挂载在检索唯一缝 （`L1Store.search()` 三路阈值后、截断前），召回注入与 memory_search 工具自动一致； **去重候选召回（searchCandidates）明确不应用**——写路径找同语义旧记录要无视新旧， 衰减会让去重漏检。`recall.decayHalfLifeDays` 默认 30 天、0=关闭（bench 基线可比性 可 pin 0）；hit 的 score 字段不被改写（排序用加权分，展示仍反映检索相关度）； idf 不单列（BM25 路内建，向量路无此概念）；importance（priority）暂不启用（当前 抽取输出近常数，参与排序收益趋零，公式预留位置）。 - **召回去重（省 token）**：同会话内已注入过的记忆不再重复注入——用户追问相关/ 类似问题时，检索会再次命中相同记录，而模型上下文里已有这些内容，重复注入纯属 浪费（每轮最多 ~2000 字符 ≈ 1000 token）。纯过滤语义：剩几条新鲜命中注几条， 全量压制（0 条）是正确状态而非未命中。粒度 = L1 记录 id：去重合并更新会换新 id， 内容变化过的记忆天然解除压制重新注入。上下文被 `/compact` 压缩或 `/clear` 清空时 （`agent/session-start` 事件）重置记录——注入内容已从模型上下文丢失，记忆可重新 注入；`resume` 不重置（历史仍在）。记录持久化在数据目录 `recall-dedupe.json` （写穿串行化原子写，session-modes 同款；会话 LRU 200 条 / 单会话 id 上限 512 / 90 天过期，任何 I/O 失败降级内存态绝不阻塞召回路径——热路径新增成本仅 O(hits) 的内存 Set 查询）。统计新增 `suppressedRecalls` 累计计数（session-stats RPC 可查）， 压制发生时打 debug 日志；悬浮卡口径保持连续（全量压制轮计入 hitTurns——相关记忆 已在上下文里，本质是命中）。 ### 修复 - **旧版 records.jsonl 导入永久卡死（#28）**：旧代写入器产出的记录缺 `type`/`priority`/ `scene_name` 任一字段时，`undefined` 进 node:sqlite 绑定层被拒——逐条回退也系统性全挂 （同一代写入器产出的缺字段是同批的），文件保留导致每次启动重试、数据永不入库。修复： **绑定层字段兜底**（`upsertL1InTx`/`upsertL0Batch` 归一化局部变量，主表/向量/FTS 共用 同源值；默认值取 schema 列默认 `type='' / priority=50 / scene_name=''`，L0 侧 `sessionId='default' / role='' / recordedAt='' / timestamp=0`）——一处修覆盖旧版导入、 reindex、backfill 与常规写入全部调用方；附带消除 `familyForType(undefined)` 的 TypeError 隐患（归一化后回落 chat 族）。L0 旧版导入同时补最小有效性门（缺 id/content 坏行读取时丢弃计数，此前零过滤）。注：报告所指"无行级隔离"不成立——逐条回退早已 存在（报告日志自证），真正缺的是字段兜底；`.failed` 熔断按共识跳过（已知循环成因 已根治，未知形态留待真实出现再做）。 - **本地嵌入冻结整页（性能事故级）**：transformers.js 的模型加载与 ONNX 推理原先在 host 主线程同步执行——onnxruntime-node（v1.24.3）的 `run`/`loadModel` 是 setImmediate 回调里的同步调用（Promise 包装不卸载计算），启用本地嵌入 （embeddinggemma-300m 实测单条推理 ~0.3-1.3s）后每轮对话的 L0 落盘、召回 query、 蒸馏落库、reindex 批次都会冻结事件循环数秒——dsh 页面一切交互无响应。修复： 推理整体移入 worker 线程（`resources/embedding-worker.cjs`，主线程只留协议代理 `LocalEmbeddingService`）：逐条推理 + 条间让路，单条请求（召回 query）插队不被 reindex 批次堵队尾；实测 8 条批量嵌入（旧路径 ~10s 连续冻结）期间主线程采样 超期 0.0ms。附带语义增强：召回路径的 `embeddingTimeoutMs` 内层钳制对本地嵌入 从"忽略"变为真实生效（race 放弃、迟到回复丢弃）。worker 崩溃不自愈（转 failed 态走 FTS 降级链，换源/重启恢复）；`close()` = terminate，terminated 不可复活 语义保持。 - **蒸馏重试风暴（LLM 故障期间连环烧调用）**：L1 抽取失败（如网关 120s 超时）后， 闲置兜底每 30s 继续入队 force 蒸馏任务，在 LLM 等待期间堆积成无限连环调用 （memory.log 2026-08-24 实证：每 2 分钟一轮 120s 调用不收敛）。修复：按会话 指数退避（60s 起步翻倍封顶 30 分钟，成功消费清零；重建轮豁免——用户显式动作 有自己的失败/取消 UI），退避期间闲置兜底与阈值触发均跳过该会话。 - **附带安全加固（语义零变化）**：bench 工具与 smoke 测试的全部文件读写边界改为 内联 containment 写法（resolve 后 startsWith 根目录校验 / SAFE_NAME 白名单； 目录类环境变量契约断言：绝对路径且无 `..` 段）。 ## [0.8.5] — 2026-08-23 ### 修复 - **判卷口径修正**（bench）：①带 stale 的题（update/连锁更新/遗忘）FAIL 条件从 "旧值出现"改为"旧值**当作现状陈述**"——单纯交代演变过程且终值正确不判负 （2026-08-23 lifecycle 回归实测：连锁更新题答对铂钻但提及豆腐砂演变轨迹被 整批误杀）；②拒答题 FAIL 仅限"把被问的具体内容当已知事实说出"，引用真实 背景解释"为什么不知道被问点"判 PASS（"只知道 A 和 B、没有 C 的记录"此前 被误杀）。work-project-stack 的 update 题由 contains-all 换 llm 判卷（程序 判无法区分现状陈述与演变交代，全库不再有 contains-all+stale 组合）。 - **auto 档族错标：个人"计划性"事实被吸进 work 族**（lifecycle 赛道首跑实测发现）： 抽取输出的 type 前缀隐式决定 family，而「驱虫方案/疫苗安排/猫砂选择」这类规则态 个人事实在 chat 词表没有贴合句式、被 work_fact/work_method 的形状语义吸走 → 族 错标 → 同一事实双族并存（去重永不跨族 → 旧值复活、连锁更新题失败）+ 分族门控 泄漏（chat 档会话能答出 work 事实，lifecycle 实测 2/2×2）。修复：auto 档抽取 Prompt **每条记忆显式输出 family 字段**（判定只看语境不看形状——职业/团队/项目 → work，家庭/宠物/健康/个人行程 → chat；family 决定 type 词表不许交叉）；工程侧 三级兜底链 `resolveRecordFamily`（纯档强制 → 抽取显式 → type 前缀）。与 MemoryCore 上游的分叉已在 prompt 头注释注明。**存量错标库需升级后 rebuild 一次 治愈**（L1 清空重导；注意 rebuild 会从 L0 复活已"遗忘"的事实——既有语义）。 ### 新增 - **效率三角补全**（bench + 插件）：「记忆的开销」与工作流赛道已测的"记忆节省" 配成完整 ROI——①**注入开销**（注入轮 vs 无注入轮的轮次响应差分——事件时间戳 在步骤派发时统一落盘，注入钩子自身耗时不可直接观测，实测取证后改差分口径； A 组内自成基线）；②**注入占比**（探针轮注入字符/该轮输入 token，中文 1 字≈1 token 折算）；③**蒸馏记账**（新增 `src/llm-usage.ts` 常开计数器，callLLM 按 l1-extract/l1-dedup/l2/l3 层累计输入字符/输出/思考 token，经 bench 控制服务 `getDistillUsage` 读取，摊到每条捕获消息；lifecycle 的 rebuild 另有前后差分 专属用量）。patch-arm-on 同步开启 benchControl；旧运行无新字段时报告自动跳过。 另修复 run.mjs 链接守卫漏洞：主树之下的兄弟 worktree（.worktree/…）此前被 放行——2026-08-23 实测链接指向 .worktree/dev 的旧 runner 静默跑完全程。 - **生命周期赛道**（bench `--track lifecycle`，只跑 A 组）：考只有本架构能测的 生命周期不变量——**分族门控**（chat 档会话问不出 work 族事实、镜像亦然， 异族泄漏非 0 即"写入与召回同档"被打破）、**off 档捕获**（off 会话教的 nonce 事实双断言：auto 探针须拒答 + records/conversations JSONL 全文缺席，rebuild 后复验）、**rebuild 保真**（触发全量重建后探针轮 2 对照轮 1，显著回退即 rebuild 链路丢信息）、**遗忘请求**（自然对话要求删记忆 → L1 冲突检测的删除 路径 → 原题重问须拒答且不复述旧值；rebuild 从 L0 复活旧事实为已注明的现状 语义）。零新场景文件，复用对话场景库。 - **规模退化曲线**：①离线灌水（`retrieval-metrics.mjs --flood N1,N2`）——复制 基准库灌 N 条确定性合成记录（主题域错开、全文零数字防误撞数值 gold）重算 recall@k，零运行成本出「检索质量 vs 库容」曲线（0.8.3 存档库实测 +400 条时 recall@5 70.2%→65.8%）；②运行时噪声（run.mjs `--noise k`）——对话场景间插 入填充会话（`fillers.json` 25 会话，装载期断言不撞 marker）测端到端退化， report 新增「规模位置分析」节（前/中/后段三桶）；填充不改 scenarioFiles 清单，跨 noise 档 compare 不触发环境告警。 - **bench 控制服务**（插件 `benchControl` 配置，默认关）：进程内 cordis 服务 `dsh-memory-bench`（rebuild 触发/状态轮询/会话档位设置），供 lifecycle 赛道 使用——宿主侧 connection.rpc 只有 handle 没有 call，这是唯一干净的进程内 通道；生产部署不开此配置，零表面积。 - **基准检索层离线指标**（bench）：report/compare 自动计算 + 独立 CLI （`bench/harness/retrieval-metrics.mjs`）——recall@5 / gold 覆盖 / MRR 分题型表 （探针问题原文在 rep 最终记忆库上受控复现 keyword 检索，候选池/阈值/小语料 例外与运行时逐项一致，分词与索引共用 dist 的 search-utils）+ 注入精度 （含 gold 要点的注入行占比）+ 注入含已作废信息计数（update 类 stale 进注入， 更新失败在注入层直接可见）。runner 补落盘 `recall.lines`（注入记忆行明细）。 端到端准确率是钝器的问题从此有了不依赖判卷与采样的直接信号。 - **基准四种新题型 + 前瞻记忆工作流场景**（bench，借鉴 MemoryAgentBench / GoodAI LTM / BEAM）：`accretive`（增量积累：完整事实拆多会话考拼装）、 `update-chain`（连锁更新 v1→v2→v3，含回摆链）、`ordering`（事件排序）、 `paraphrase`（同义改写压测词法缺口）——对话场景库 15→20（新增场景全 10 题制， 90→140 题/rep），场景可带 reinforce 补强教学会话（0~2 个，夹在 teach 与 change 之间）；工作流新增 `wf-preflight`（教学立常设约定"生成前先写预检文件"， 探针只给模糊任务，A 组须凭记忆主动补步骤）。 ### 变更 - 对话场景校验器规则更新：探题数 6→6~10（六核心各恰 1 + 扩展题型各至多 1）、 允许 reinforce 会话（顺序强制 teach → reinforce → change）、 `update-chain` 必须带 stale；更新专项口径并入连锁更新题。 场景清单变化使旧基线 compare 告警"环境不一致"——属预期，重跑基线或用 `--scenarios` 指向同子集对比。 ## [0.8.4] — 2026-08-22 ### 修复 - **设置页新思考档位词汇被写入门拒绝**（0.8.3 引入）：档位表扩至八词表时 `settings-set` 的 RPC 白名单漏同步（仍只认 `''/off/high/max`），设置页选 `none/minimal/low/medium/xhigh` 一律报"非法思考档位"并回滚。现白名单与 schema/settings 同源——词汇表收敛为 `config.ts` 的 `EFFORT_CHOICES` 单一 事实源（此前同一列表在 4 处字面抄写）。 - **显式 `xhigh` 输出预算被双重放大 ×16**（0.8.3 引入）：阶段侧 `layerMaxTokens` 与 `callLLM` 自动档防线各自持有高档位字面量表且分叉（防线漏 `xhigh`）， 配置 `xhigh` 且模型声明支持时先 ×4 再 ×4。现两侧共用 `HIGH_EFFORT_TIERS` 单一常量，配置本身就是高档位时防线不再放大。 - **思考档选择器补「自动」项**：0.8.3 删除"跟随配置"选项后选择器只剩模型声明 档位，选过显式档位便无法从 UI 回到自动。现首项固定「自动」（key=''，点击 回写空串），同时把选项构造的重复三元收敛为单次计算。 - 文档漂移：README 中英两版 `llm.reasoningEffort` 值列表补 `minimal`（与 schema 对齐）；设置页预算提示与代码注释的"high/max ×4"补全为 high/xhigh/max。 ### 变更 - **宿主运行时升级 0.1.0-rc.8 → 0.1.1-rc.2**（devDeps 精确钉死、peers 换线 `^0.1.1-rc.2`）：9 个直依赖包 tarball 逐文件比对——7 包代码零变更， dsh-llm / dsh-client-connection 纯增量（多模态图片卸载 / Files API / adapter `prepareCall` / RPC `doFetch` 可选参数），本项目使用的 GenerateOptions/StreamChunk/createUserMessage/installModelSelection/ rpc.handle|call 逐字节相同，零适配改动。验证：build/smoke/双 profile dump-config/bench fixture 冒烟全过。跨预发布族升级的 npm ERESOLVE 用 `--legacy-peer-deps` 过渡（口注已记入 AGENTS.md）。 ### 基准 - **DSH-MemBench 工作流赛道扩至 7 场景**（`bench/`），新增三类考法： 流程知识更新（`wf-heap-update`——教学 v1 → 变更会话宣布改版 v2 → 探针考 "现在生效的流程"，旧流程专属产物不得再出现，L1 去重更新的操作化度量）、 相似工作流消歧（`wf-twin-runbook`——双胞胎 runbook，改错服务的配置由负检查 判负）、风格规范延续（`wf-report-style`——命名/结构/千分位/页脚约定跨会话 落地）。完成度校验从单一正检查扩为四型判据（`contains`/`notContains`/ `absent`/`exists`），检查器抽为可独立单测的 `checks.js`；runner 支持可选 `change` 会话；场景库校验同步收紧（判据恰选其一、marker 须出现在教学文本）。 正式基线（`bench/baseline/`）仍为 4 场景版，扩库后首次回归跑需重建基线。 ### 基准加固（漏洞审计后修复批次） - **AB 双组并行**：`run.mjs --arm AB` 双进程并发跑两组（对照互不依赖），父进程 收尾自动出联合报告；子进程免清扫免自动报告防互扰。 - **跨运行考古通道封堵**：每次运行开始前清扫 `%TEMP%/dsh-mem-bench/` 历史沙箱与 `~/.dsh/sessions` 中 bench 命名空间的会话目录（只匹配 `dsh-mem-bench`，用户自身 会话/数据不受影响）。 - **对话赛道 B 组下线**：Harness 会话彼此独立，无记忆的 B 组探针必然失败（历史 实测 17.8% ≈ 地板），对照无信息量——`--track dialog --arm B` 拒跑，只保留 A 组。 - **代码指纹与链接守卫**：结果头 environment 增记 `gitSha`；run.mjs 启动校验 bench profile 两个 link: 依赖指向被测仓库（旧工作树代码会静默污染结果，2026-08-21 实测事故）。 - **越界读取双档审计**（工作流赛道）：严格档命中（`~/.dsh` 记忆/会话库、memory.db、 records/conversations/scenes 存储路径）→ 涉事场景全部检查判负；宽松档仅提示复核； 修复 `.MemoryMappedFiles` 子串误报；合法记忆工具调用（memory_read_scene 等参数即 路径）不进审计。 - **场景去自明化**：`wf-heap-update` 改 `target.env + apply.sh` 两步约定、 `wf-twin-runbook` 改同构 `svc-a/svc-b` 文件（映射只存教学文本）——修复"B 组翻沙箱 文件即可逆向流程"的判别力漏洞（实测 B 探针曾 12/12、11/12 逼近满分）。 - **工作流污染实测**：工作流探针的召回注入纳入 contamination 统计（此前字段缺失 被报告显示为 0）；report 新增**探针段完成度**单列（教学/变更段两臂都有现场上下文， 探针段才是纯记忆窗口）。 - **场景库校验收紧**：marker 全库唯一、同 kind 会话查重、contains-all 的 gold 必须 出现在教学文本（无记忆不可答即坏题）、gold 不得泄漏进问题文本；求助检测补英文 模式；fixtures 按赛道分 `dialog/`、`workflow/` 子目录（对话 patch 下工作流场景 无工具必挂，混装冒烟会误报）。 ### 基准易用性（bench.env 模型配置） - **模型三角色集中配置**：`bench/harness/bench.env`（模板 `bench.env.example` 复制 使用，含 API key 已 gitignore）统一配被测 Agent / 判卷 / 蒸馏三个模型—— `BENCH_PROVIDER/BENCH_MODEL`、`BENCH_JUDGE_*`、`BENCH_DISTILL_*`；命令行参数 优先于 env 文件。新增 `--distill-provider/--distill-model` 命令行参数，蒸馏模型 从 patch 硬编码改为环境变量化（缺省回落 official/flash）。 - **自定义 OpenAI 兼容网关**：bench.env 填 `BENCH_TEST_BASE_URL + API_KEY`（判卷 可另配一对）后，run.mjs 自动生成 llm-pi-ai patch 注册 `bench-gw` / `bench-judge-gw`（判卷/蒸馏复用被测网关时模型表自动聚合去重），API key 经 apiKeyEnv 引用并只注入子进程环境。配置网关后本次运行的自定义供应商完全由 bench.env 决定（用户 settings.yaml 的网关不参与，隔离可复现）。 - **被测模型缺省回落移除**：不配 `--provider/--model` 也不配 bench.env 直接拒跑 （原回落命中 settings.yaml 默认模型、bench profile 无 adapter 时启动即炸）。 - 解析与网关 patch 构造抽为纯函数模块 `env-config.mjs`（22 项单测 + dump-config 结构验证全绿）。 - **思考强度三角色可配**：`BENCH_REASONING_EFFORT`（被测）/ `BENCH_JUDGE_REASONING_EFFORT` （判卷）/ `BENCH_DISTILL_REASONING_EFFORT`（蒸馏，缺省 off）+ 对应 `--effort/ --judge-effort/--distill-effort` 命令行参数；经 `ModelSelection.reasoningEffort` （installModelSelection 官方入口）与判卷 GenerateOptions 下发，留空 = 不传跟随 provider 默认；结果头 environment 记录两侧 effort（可复现性）。 ### 基准实测数据更新（README 中英同步） - **工作流赛道扩至 7 场景后的新数据**（v4-flash@high、判卷 glm-5.3、插件 0.8.3）： 探针段完成度 A 组（记忆开，3 轮）**85.5%**（59/69）对 B 组（记忆关，1 轮） **43.5%**（10/23）；B 组每场景输入 token 为 A 组 **6.8 倍**（1.81M vs 266k， high 档下无记忆的重新探索代价被显著放大）；风格规范场景探针 B 组 0/4（约定 只存记忆，判别力天花板）；流程更新场景 B 组仍可读脚本逆向（判别力受沙箱 可供性限制，README 如实标注）。`bench-workflow.svg` 图表随数据重制；对话 赛道旧数据标注为 0.8.0 留档基线（B 组已下线）。 - **B 组成本护栏**：`--repeats` 只作用于 A 组，B 组固定只跑 1 次（无记忆长任务 的 token 消耗过高，用户决策）。 - **实时进度面板**：跑基准时 `run.mjs` 自动拉起 `panel.mjs`（零依赖、只绑 127.0.0.1）并打开浏览器——A/B 双臂卡片、场景/阶段/消息粒度进度、累计成本、 事件尾巴；心跳（5s）与活动新鲜度双指标直判"卡住 vs 进程挂了"。数据源为 runner 向 `rep-N/progress.json` 的原子增量写（≥1s 节流）+ `run.mjs` 启动时 的 `plan.json`（rep 循环在父进程手里，子进程不知道总轮数）。`--no-panel` 关闭；面板随运行退出自动收割（子进程 unref，否则吊住父进程事件循环）。 ## [0.8.3] — 2026-08-21 ### 变更 - **蒸馏思考档位改为模型感知（修复非 deepseek 模型蒸馏必炸）**：此前插件把蒸馏 思考档位（默认 `off`）原样发给任何模型——`off` 是 deepseek 适配器层概念， pi-ai/openai-responses 网关不认（qwen 本地拒绝、上游 400 Invalid reasoning.effort）。现发送前按 `resolveModelInfo` 探询模型能力（按路由缓存， 拓扑变化失效）：声明支持→照发；`off` 遇 OpenAI 系词汇表→别名 `none`；不支持 或未声明→不传 + 告警一次；**"跟随配置"选项删除**，'' = 自动（模型默认档 → high）；设置页可选档位表跟随当前模型实时显示（未声明只显示 high）；档位表 词汇扩至 off/none/minimal/low/medium/high/xhigh/max；自动档解析为高档时输出 预算 ×4 防线同步生效。 - **蒸馏模型切换自动选模型**：切换供应商后模型自动落到该供应商的第一个模型 （成对写覆盖），模型下拉不再有"跟随默认"（跟随默认 = 供应商下拉首项清空覆盖）； 模型列表按供应商缓存 + 面板加载时后台预取（切换即时渲染无真空期，未命中显示 "加载模型列表…"占位而非过期模型名）。**按钮文本即时切换修复**：`writeLlm` 的 乐观更新此前把 settings 键 `distillProvider/distillModel` 直接合并进 `info.current` 而显示层读 `current.provider/model`——键不匹配导致乐观更新对按钮文本是空操作， 只能等 5s 轮询刷新（体感"等几秒才变"）；现映射成视图键同步写 `current` 与 `effective`，写入在途丢弃轮询旧响应（防闪回），成功后立即拉一次服务器真值。 - **下拉选择器整件自绘，对齐 dsh MenuDropdown 观感**：原生 ``。 - **设置页场景块可折叠**：场景 Tab 的场景卡默认收起（只显头部 + 摘要行）， 点击头部展开/收起正文，折叠箭头展开态旋转 90°（respect reduced-motion）。 - **日志 Tab 默认滚到最底**：看日志的意图是最新尾部（tail 语义），加载/刷新后 自动贴底，不再默认停在最顶。 - **部署 pin 时给出解锁指引**：蒸馏模型被 profile 静态 pin（`llm.provider`+ `llm.model` 双字段）锁死、选择器不出场时，静态文本补充"如何移除 pin 恢复 页面切换"的提示（此前只显示固定路由，用户无从得知为何不能切换）。 全面代码审查（安全 + 健壮性 + 文档一致性）后的修复批次。 ### 修复 - **畸形代理配置不再拖垮插件加载**（高危）：`embedding.proxy` 写成无 scheme 形态 （如 `127.0.0.1:7890`）或代理环境变量本身无 scheme 时，`ProxyAgent` 构造器同步 抛 TypeError → apply 失败。现与畸形 mirror 同款容错：捕获后降级直连 + warn。 - **代理 URL 日志脱敏**：下载走代理的日志此前原样输出代理 URL（可能带 user:pass 凭据）并持久化到 `memory.log`，现剥离 userinfo 只留 `scheme//host`。 - **`NO_PROXY=*` 通配生效**（此前 `*` 条目永不匹配，设置了仍走代理）。 - **双写失败的可见性闭环**：L0/L1 的"JSONL 事实源已写、检索库批量写失败" 此前静默（记录从此不可检索、去重候选缺失），现升 error 日志并提示可用 「重建记忆」从事实源全量重导修复。 - **原子写耐久性**：state/pending/场景/persona 的 tmp+rename 原子写补上 fsync 数据块（此前断电可能留下空文件/半截）；tmp 名加随机段防同毫秒碰撞，失败 路径清理孤儿 tmp。 - **运行时安装器取消语义**（Windows 主平台）：ci 阶段被取消后不再误入 "ci 失败"回退分支白跑一次 install；ci 退出与回退起跑之间的间隙里取消同样 生效；`shell:true` 下 kill 改用 `taskkill /T /F` 按进程树终止（此前只杀 cmd.exe，npm 孙进程继续跑，超时与取消都只是表面停止）。 - **本地嵌入截断读配置**：`embedding.maxInputChars` 此前只对远程嵌入生效， 本地路径硬编码 5000，现两路同源。 - **场景文件名加固**：Windows 保留设备名（CON/NUL/COM1…带扩展形态）加 `_` 前缀避让；超长名截断到 120 字符（ENAMETOOLONG 防御）。 - **旧版 L1 迁移判据**：旧 `records.jsonl` 混入坏行时迁移永不完成（每次启动 重复导入同一批），判据改按过滤后的有效行数。 - **RPC 入参上限**：sessionId ≤512 / query ≤4096 / provider·model·activeModel ≤200、 分页 offset ≤100 万——防 loopback 面畸形超长载荷（session-modes.json 膨胀、 jieba 全量分词 CPU 峰值）。 - **FTS/向量检索 limit 守卫**：三个 search 入口拒绝 `limit ≤ 0`（SQLite 负 LIMIT = 无界；当前调用面已钳制，纯防御未来新增调用方）。 - **工具调用缺 agent 标识告警**：`exec.agent` 未传递时档位过滤退化为全族检索， 现告警一次（fail-open 行为保持，不拒绝工具调用）。 ### 文档 - 中文 README 补齐英文版独有的「日志与故障排查」整节（违反中英同步铁律的缺口）， 两版同步补 JSONL 耐久性边界说明；pin 示例版本 0.8.0 → 0.8.2。 - **修正 0.8.2 条目两处事实错误**：① peer 范围实际保持 `^0.1.0-rc.6`（rc.6~rc.8 兼容），"peer 要求随之变为 dsh ≥ 0.1.0-rc.8" 与 package.json 不符；② 引用的 `docs/dsh-dev-experience.md` 不随仓库分发（gitignored），对外是悬空引用。 ## [0.8.2] — 2026-08-20 宿主依赖跟进 dsh 0.1.0-rc.8。 - **宿主依赖钉死升级 0.1.0-rc.6 → 0.1.0-rc.8**（devDependencies 精确钉死，用于 开发/测试；peerDependencies 保持 `^0.1.0-rc.6` 范围——rc.6→rc.8 实测**零 API 漂移**，类型编译/冒烟/真机启动全过）。rc.8 起 dsh 本体改为**全局安装**布局 （`profiles/node_modules` 由 heal 机制维护为符号链接农场），旧"实体树"装法 会启动失败。 - bench `run.mjs`：dsh CLI 入口改为解析链（`DSH_BIN` → npm 全局前缀 → 旧布局兜底）， 去除硬编码个人路径，其它机器可直接运行。 ## [0.8.1] — 2026-08-20 蒸馏模型运行时切换 + 模型下载抗污染重试 + DSH-MemBench v3 自动化基准。 ### 新增 - **蒸馏输出预算运行时调整**（设置页 → 记忆 → 概览 → 蒸馏参数 → 输出预算）： 抽取 / 去重 / L2 场景 / L3 画像四层各自的 token 上限改为 UI 可调（此前是代码 常量，调整须改配置文件重装）；留空或 0 = 跟随内置默认（16k/8k/32k/16k）， 思考档 high/max 的 ×4 放大在生效值之上照常应用。设置页开关面板同时重组为 「记忆模式 / 蒸馏参数」两组，配置项分组更清晰。 - **蒸馏输入预算运行时调整**（同组 → 输入预算）：单次蒸馏调用的输入字符上限 （`llm.maxInputChars`，默认 70 万）UI 可调，留空/0 = 跟随静态配置；L1 抽取 分块、L2/L3 截断与重建调用数估算全链按生效值。 - **蒸馏模型运行时切换**（设置页 → 记忆 → 概览 →"蒸馏模型"选择器）：从宿主 **已配置的供应商路由**（含 dsh 设置 → 模型里添加的自定义 OpenAI 兼容供应商） 中选择蒸馏用的 provider/model，即时生效、无需重启、重启后保持。优先级： 部署静态 pin（`llm.provider`+`llm.model` 双字段齐，防用户选择把对话外送） > 运行时选择 > 默认模型。新增 RPC 端点 `dsh-memory/llm-providers` （供应商目录 + 默认选择 + 当前覆盖 + 实际生效路由 + 所选供应商是否仍注册） 与 `dsh-memory/llm-models`（按供应商列模型；适配器不提供目录时 UI 降级手输）； 供应商/模型被删后 UI 明示"已不在列表"并提示重选。 ### 修复 - **EmbeddingGemma 无法安装**（真实根因）：目录里 `generation_config.json` 的 sha256 抄写错了一个字符（`a736d1b3` 误作 `a736b1b3`）——镜像从未返回过错误 字节，是完整性契约本身错了，下载必败且报"sha256 校验失败"无从下手。已按 实测修正，并对全目录 19 个文件做了权威核验（LFS 文件对照 HF tree API 的 oid，小文件实测哈希）——其余全部吻合。新增 `npm run verify-catalog` （`scripts/verify-catalog.mjs`）在升级目录时一键复验，杜绝同类抄写事故。 - **模型下载连不上/慢**（伴随问题，同一场景实测）：镜像直连在国内网络间歇 不可达（TCP 连接超时与可达窗口交替），而 Node fetch 不读代理环境变量—— 下载器现在支持代理（新增 `embedding.proxy` 三态配置：默认自动探测 `HTTPS_PROXY`/`ALL_PROXY` 等环境变量并尊重 `NO_PROXY`，`none` 强制直连， 或显式指定代理 URL；走 undici `ProxyAgent`，与 curl/npm 同语义）。 - **下载器韧性**：单文件失败自动重试（默认 2 次，间隔 1s/3s）且每次重试追加 `?dshmem-retry=N` 换缓存键——镜像 CDN 层的坏缓存对象窗口内同一 URL 会 确定性拿到坏响应，换键另取对象才能自愈。校验失配从零重下（污染断点已删）、 数量不吻合/网络错误保留断点续传；取消不受影响；跨进程断点续传语义不变。 ### 基准与文档 - **DSH-MemBench v3 自动化基准**（`bench/`）：对话赛道（15 场景 × 6 题型 × 3 次 = 270 题/组）+ 工作流赛道（4 个真实工具沙箱场景）双轨 A/B 对照——**A 组（记忆 开）vs B 组（记忆关）**同场景库、逐字相同输入，无头自动驱动（dsh headless profile + 本地 runner 插件）、程序/LLM 双级判分；完整性指标齐备：跨场景污染 检测（场景标记词扫描）、工具越界审计、稳态缓存率（剔除会话首请求）、知识 更新专项（改口后答旧记 0）与拒答专项（编造记 0）。`run.mjs` 一条命令跑 A/B，`report.mjs` 出结构化报告，`compare.mjs` 供改插件前后的回归对比； 正式基线（两赛道 × A/B × 3 次全量结果）留档 `bench/baseline/`。上一代 手动 agentic 剧本（v2）已移除。 - **README「实测对比」回填实测数字**（中英同步）：对话赛道总准确率 A 组 92.6% （250/270）vs B 组 17.8%（48/270）、两组均 0 编造；召回双通道拆解（被动注入 命中 75.1% + 84 题主动查询、60 题靠记忆工具兜底答对）；工作流赛道 B 组多付 +49% 步骤 / +61% 工具调用 / +43% 输入 token、登录场景 +88% 输入（凭据只存 在记忆里，B 组每轮反问用户）。实测表格升级为 SVG 图表（`bench-dialog` / `bench-workflow`），README 全部 SVG 图示统一为金黄/深蓝新视觉（`flow` / `storage` 同步）。 ## [0.8.0] — 2026-08-18 记忆优化包（决策记录 ADR-0001/0002/0003）： 召回消息侧注入 + 蒸馏触发改造（渐进阈值 + 全链路会话隔离）+ 分层输出预算 + FTS 写路径修复。 ### 新增 - **召回消息侧注入**（ADR-0001）：相关记忆以带插件来源的合成消息（`form: 'recall'`， 宿主 UI 显示为**"上下文注入 · memory"**署名行）排在每条新的用户消息之前注入会话流 ——用户能直接看到"记忆生效了"。`` 标签 + "仅供参考"引导语；纯工具步 / reject 决策透传；只在有新用户消息的步骤触发 （轮首 + steering 插话）。工具指南注明受限环境（如仅允许代码执行入口的 code-runtime 档）须经该环境的调用机制间接使用记忆工具。系统提示只保留稳定内容 （画像/导航/门控指南），`memory:recall` 动态槽撤除； - **召回预算**：`recall.maxCharsPerMemory`（默认 500）/ `recall.maxTotalRecallChars` （默认 2000）——超限截断并以 `…（已截断；可用 memory_search 或 conversation_search 查看详情）` 引导模型用工具查全文（截断是引流：工具路径返回完整记录）；总量超限丢 低分尾部；code point 安全截断； - **召回超时**：`recall.timeoutMs`（默认 5000，0 不限时）总预算，超时跳过本轮注入； 远程嵌入 fetch 内层钳制 3000ms（给 FTS 降级留时间），本地推理不钳； - **蒸馏渐进阈值**（ADR-0003）：生效阈值 1→2→4→稳态爬坡（`extract.minMessages` 语义 升级为稳态阈值，默认 1→6）——新用户首轮即出记忆，稳态攒批省调用；爬坡状态随 pending.json 持久化； - **闲置兜底**：`extract.idleSeconds`（默认 300，0 关闭）——会话静默达标后未蒸馏切片 自动落袋，off 档会话挂起跳过； - **档位切换切片同步**：非 off 档间切换 → 该会话切片立即按捕获档位蒸馏；切到 off → 挂起；从 off 切回 → 挂起片按捕获档位落袋（切片永不跨档位混装）； - **分层输出预算**：抽取 16k / 去重 8k / L2 32k / L3 16k；思考档 high/max 自动 ×4 （reasoning 吃光预算的历史事故防线）；`llm.maxTokens` 默认 256k→65536 降为兜底总闸。 ### 修复 - **跨会话污染**（现存缺陷）：抽取背景消息原为全局内存数组（A 会话内容给 B 会话当 背景且重启即丢），现按会话从 L0 现查（走会话索引）并剔除切片自身；蒸馏触发按会话 切片计数、只抽取达标会话的切片——五条通道（阈值/idle/背景/档位切换/重试残留） 全部会话隔离（ADR-0003）； - **FTS 写路径 O(N²) 放大**：防御性 FTS 删除改主表存在性点查预判（record_id 在 FTS 表 UNINDEXED，按 id DELETE 是全表扫描——重建/重嵌/导入等全新增路径原为每条记录白付 一次全扫）。外部行为逐项不变（ADR-0002；rowid 映射方案因陈旧映射静默错删风险否决）。 ### 变更 - 工具指南改三条件门控（`tools 开启 && 画像 ∥ 导航 ∥ 本轮召回命中`）：空库用户与 关闭工具的用户不再每步支付这份固定 token； - pending.json 持久化条目增加 `sessionId` 字段（旧格式自动归入 legacy 会话组）， 另随桶持久化渐进阈值状态； - 启动补跑改为按会话切片分组入队； - **中文检索分词从 CJK 二元组升级为 jieba 词级分词**（与 MemoryCore 官方实现对齐）： `@node-rs/jieba`（Rust napi 预编译二进制）产出 **jieba 词元 ∪ 拉丁词 ∪ CJK 二元组** 有序去重并集——词元给 BM25 高 idf 整词命中，二元组保子词召回底线；加载失败自动回退 纯二元组（进程内模式定死不漂移）；FTS 分词器版本戳（`fts_tokenizer`：`jieba-v1` / `bigram-v1`）戳不符时自动 drop 重建回灌，无戳旧库视同 `bigram-v1` 首启自动迁移。 ## [0.7.1] — 2026-08-17 全量审查（2026-08-17）修复批次：文档补正 + 存储性能 + 运行时安装供应链加固。 ### 性能 - **`PRAGMA synchronous=NORMAL`**（WAL 官方推荐档）：批量写从每事务一次 fsync 降为每 checkpoint 一次，重嵌入/导入提速；代价仅是断电时丢最后若干已提交事务（只丢不损）； - **reindex 向量写事务化**：L1/L0 重嵌入的逐行裸写改为按块（16/32 行）单事务批量 （整批失败回退逐条，好行不丢），配合上一条大幅缩短大库重嵌耗时。 ### 安全 - **本地嵌入运行时改 `npm ci` + 随包 lockfile**：`resources/runtime-package-lock.json` （构建期拷入 dist/）把 `@huggingface/transformers` 的完整传递依赖树冻结在作者侧—— 原 `npm install pkg@精确版本` 只锁直接依赖，传递依赖按 semver 浮动，registry 端后续 发布/投毒会随安装时间漂移。ci 失败（lock 漂移等）自动回退 install（可用性优先）。 ### 文档 - CHANGELOG 补 [0.5.3] / [0.5.4] 条目（此前缺失，npm 已发版）； - README 中英配置表补 5 项：`recall.includePersona` / `recall.includeSceneNav` / `embedding.maxInputChars` / `embedding.timeoutMs` / `llm.timeoutMs`； - 修正中文版"间族"错别字（应为"跨族"）；开发经验文档的旧存储布局路径 （`l0/ l1/` → `conversations/ records/`）；CONTEXT.md 的 persona 文件名更新为分族形态。 ## [0.7.0] — 2026-08-17 本地嵌入模型与活切换（最大特性）、Light/Dark 双主题、全量代码审查修复（issue #1-#24）。 ### 新增 - **本地嵌入模型**（#20-#24）：**三态嵌入源**（关闭 / 远程 / 本地）运行时可切， 状态持久化 `embedding-source.json`，生效 = 部署上限 AND 运行时选择； - **内置模型目录**（白名单，锁定 revision + 每文件 sha256）：BGE small 中文 （512 维 / ~25MB）、EmbeddingGemma 300M（768 维 / ~330MB，上游 MemoryCore 同款）、 BGE-M3（1024 维 / ~590MB，8192 上下文）；默认镜像 `hf-mirror.com` 可配 （`embedding.mirror`），`.part` 断点续传 + 下载后流式 sha256 校验； - **按需推理运行时**（transformers.js 4.2.0）：首次切本地档才 npm 安装进数据目录 `runtime/`（自带 package.json 锚定，不进插件依赖树）；模型落盘 `models//`， 设置页可删（使用中的模型受保护）； - **活切换链**：预热加载 → 换服务 + swapProvider（维度变化 DROP 向量表）→ meta 立即同步 → 后台全量重嵌（L1/L0 计数进度、可取消）→ 成功才持久化状态； 失败保持旧源（重启仍按原源），重嵌取消/部分失败由 30 分钟周期 backfill 补齐； - 新配置：`embedding.allowLocalModels`（部署禁本地档）、`embedding.mirror`； - **设置页与输入栏 Light/Dark 双主题适配**（#15-#19）：两层令牌（链 dsw 宿主别名 + 自有语义令牌整组覆盖），主题切换 CSS 变量就地换值无需 React 重渲染； - **档位选择器 UI 重做**：档位中文化（日常 / 工作 / 智能 / 关闭）、悬浮板重做、 滑块填充（左浅右深、拖拽恒显）、拖动气泡（倒三角双叠尖角）、**粒子层** （点阵粒子场，档位分级场强：日常稀疏 / 工作水波 / 智能满场，浅色 multiply 混合）； 设计系统落档 `design/` 目录（global / pill / slider / settings 四份 spec）。 ### 修复（全量代码审查 #1-#14 + 独立复审 F1-F4 + 装配缝） - store：FTS 写入失败随事务整体回滚（杜绝静默索引空洞，#2）；嵌入补齐改增量 + 零向量记 skipped（修复每 30 分钟全量重嵌死循环，#3）；批量失败回退逐条 + 语句缓存随 DROP 失效 + skip 集上限（F2-F4）； - 生命周期：停机顺序先停任务/冲刷 L0 链再关库（#5）；捕获缓冲/重建快照/pending 三处引用释放（#4）； - recall：查询只取末尾 8 条 + 2000 字上限，空查询清缓存（#6）； - settings：fiber 重启复用进程内 scope，开关不再被静默忽略（#8）；按服务实例判活 缓存 scope，服务重启自动重挂（F1）； - rpc：connection 服务下线/替换后自动重挂 RPC 注册（#9）； - client：三面板错误态 + 概览降级 badge（#7）；列表请求序列号丢弃过期响应（#10）； - tools：off 档三工具统一返回提示；搜索分页显式截断标记（#11）； - log：log-tail 反向分块读 + 轮转连续失败截断兜底（#12）； - config：数值边界 + pending 持久化截断 + 扩展开关复位（#13）； - **stats 装配缝**：`/rpc` handler deps 漏传 `embedManager`——嵌入管理 UI 恒显示 "存储降级"（可选字段缺失 TS/冒烟均无法拦截，已修复）。 ### 性能 - 检索热路径预编译语句复用 + IN 分块 + L1 批量事务（#14）。 ### 文档 - README 大改：新增"语义检索（嵌入源）"章节（三态表 / 模型目录表 / 下载与活切换）； Hero / 分层记忆 / 会话档位换用 image2 生成图；新增界面预览（深浅双主题真实截图）； storage.svg 补嵌入源三态与新文件形态；配置表补两行； - 开发上下文补"嵌入与检索"术语表；归档 2026-08-17 全量代码审查报告。 ## [0.6.1] — 2026-08-17 - `llm.maxTokens` 默认 20000 → **256000**：v4-flash 默认 high 思考档可吃光任意 输出预算导致正文 0 字符，给足预算配合思考档位默认 off。 ## [0.6.0] — 2026-08-17 蒸馏思考档位 + 记忆选择器 UI 重做 + 可靠性补强。 ### 新增 - **蒸馏思考档位**：`llm.reasoningEffort` 配置（`off`/`high`/`max`/空串，默认 `off`） + 设置页概览 Tab 运行时切换（选"跟随配置"回退部署默认，走 settings 服务持久化）； 推理模型默认思考可吃光输出预算致正文 0 字符，故蒸馏默认关思考； - **未蒸馏缓冲持久化**：失败待重试 + 攒阈值中途的消息按档分桶暂存 `pending.json` （每次蒸馏尝试后原子落盘），重启不丢，启动 20 秒后自动补跑； - **记忆全量重建**（设置页 → 记忆 → 概览 → 重建记忆）：以 L0 为事实源重导全部派生层， 旧产物整体归档不删除，低优先级分块（让位正常对话），带确认弹窗/进度/取消； 统一按智能档（auto）重蒸馏、按会话分块（会话按首条时间排序），重建期间新对话走正常轮次。 ### 变更 - 记忆选择器 UI 重做：auto 档边缘 conic 冷蓝流光、Apple 玻璃浮层（三层结构修 Chromium backdrop-filter 采样失效）、滑块拖拽 1:1 跟手 + 松手动量投影吸附； 线/停点/标签颜色主题化。 ## [0.5.4] — 2026-08-16 发布工程化：npm Trusted Publishing（GitHub Actions OIDC）上线——push `v*` tag 自动发布， 免 token / 免 2FA；tag 与 package.json 版本一致性校验仅 tag 触发时生效（`workflow_dispatch` 手动试跑可走到 publish 鉴权链路，用于验证 OIDC）。无用户可见变更。 ## [0.5.3] — 2026-08-16 ### 修复 - L1 抽取后立即持久化阈值计数（进程中途退出不回滚，重启不重复抽取）； - 蒸馏输出预算统一走 `llm.maxTokens`（默认 20000，防推理模型的 reasoning 吃光预算致正文 0 字符）。 ### 新增 - auto 档画像/场景导航注入结构化：按类别归组 + `` 分域标签，替代两族粗暴拼接。 ### 文档 - README 安装方式改为 npm 优先（GitHub / 本地路径为备选），`files` 附 hero 资源。 ## [0.5.2] — 2026-08-16 修复 Linux/macOS 上"任何工具调用都报 `Cannot read properties of undefined (reading 'prepare')"`的严重 bug （WSL 真实事故：bash 工具一调就崩，turn 级失败）。 ### 根因 插件把宿主运行时包（`@deepseek-ai/cordis`、`dsh-tools` 等）声明成了普通 `dependencies`——安装器为插件装入**私有拷贝**，与宿主自己的模块图形成 **双 `dsh-tools` 实例**。`ToolRuntime` 服务由插件侧拷贝实例化，而 `dsh-agent-loop` 用宿主侧拷贝的 `Symbol(@deepseek-ai/dsh-tools.scheduler)` 去读调度器——Symbol 身份不等（同名不同实例），读取落空 → 每次工具调用 在 `scheduler.prepare` 处抛 TypeError。Windows 上恰好两图解析顺序一致而 侥幸可用，Linux（pnpm hoisted + symlink 布局）必现。 ### 修复 - **宿主运行时包改为 `peerDependencies`**（对齐官方插件约定，如 `dsh-bash-local`：cordis / dsh-agent / dsh-home-paths / dsh-llm / dsh-session / dsh-settings / dsh-system-prompt / dsh-tools，`^` 范围）， 安装不再产生私有拷贝，插件与宿主共享同一模块图； - 本地开发所需版本移入 `devDependencies`（构建/冒烟不受影响）； - 纯库依赖保留 `dependencies`（schemastery、sqlite-vec）。 ## [0.5.1] — 2026-08-16 修复 0.5.0 改名的客户端注册 bug（真实事故：从 GitHub 安装后浏览器端报 `client-modules: bundle ... loaded without registering "dsh-prime-memory"`， 设置页与输入栏记忆控件全部不可用）。 ### 修复 - **client bundle 注册 id 随包名更新**：`client/client.js` 的 `window.__ModuleLoader__.load({ id: ... })` 从旧名 `dsh-memory-plugin` 改为 `dsh-prime-memory`——0.5.0 改名时只改了 host 侧与打包声明，漏掉浏览器半边， 导致 loader 条目名与注册名不一致、bundle 加载即失败。host 侧插件名 `dsh-memory-plugin`、配置键 `dsh-memory`、RPC 端点 `dsh-memory/*` 均保持不动 （改它们会破坏既有配置与数据通道）。 ### 文档 - README 视觉美化（beautify-github-readme）：新增项目原生 hero（`assets/readme/hero.svg`， L0→L3 分层管线 SVG，宽度递减表数据精炼）；重排为"价值 → 机制 → 首步使用 → 细节" 顺序，合并重复段落，嵌入方式 `

`。 ## [0.5.0] — 2026-08-16 公开发布改造：包更名为 **`dsh-prime-memory`**（旧名 `dsh-memory-plugin` 在 npm 已被 同类插件占用），并按官方组合包（bundle）规范完成打包。 ### 变更 - **声明 `dsh.bundle`**（根目录新增 `cordis.patch.yml`）：`dsh plugin --profile add` 一条命令安装后**自动挂载插件行**，不再需要手改 profile 的 patch.yml； `files` 同步补入该文件； - **依赖去本机化**：`@deepseek-ai/*` 从 `file:` 绝对路径（指向本机 profile）全部改为 npm 精确版本（`0.1.0-rc.6` 一档、cordis `4.0.1`、schemastery `3.18.1`）——任何机器 `npm install` / `dsh plugin add` 均可解析（rc.6 挂在 `next` dist-tag，勿用 `^` 范围）； - 仓库卫生：MIT LICENSE、`.gitignore`（忽略 `node_modules/`、`dist-smoke/`、`.zcode/`）、 README 安装段重写（一条命令安装 + 卸载 + 安全提示 + 源码开发），修正重复标题。 ## [0.4.2] — 2026-08-16 蒸馏 LLM 空输出诊断增强（真实事故：L1 去重/抽取连续两轮输出 0 字符，日志只有 `原始输出前 400 字符:` 空摘录，无任何现场证据）。 ### 根因排查价值 `callLLM` 原先只记输入/输出字符数；流"正常结束但一个字没吐"时无法区分 "模型只产出了 reasoning（text 为空）" vs "服务端返回空响应"。失败的那两次 （35~38s、0 字符、输入 1.3 万字符）远未到超时（120s）与 maxTokens（4096）预算。 ### 变更 - `callLLM` 收集流内**块级统计**：finish 原因（stop/max-tokens/tool-calls/error/aborted）、 usage token 计数（outputTokens/reasoningTokens）、text-delta 块数与字符数、 reasoning-delta 字符数（带 300 字符摘录）、各 block-end 类型分布； - **输出为空时打 warn 诊断日志**，携带上述全部统计——下次再空输出可直接判定 reasoning 是否吃光预算、finish 原因、服务端是否空响应； - 常规 `LLM 调用` 日志追加 finish 原因（非空输出时零额外开销）。 ## [0.4.1] — 2026-08-16 修复长回复轮次丢失 user 消息的 L0 捕获缺陷（真实事故：4 轮对话中第 3 轮丢 user 消息、第 4 轮丢 user + 首条 assistant）。 ### 根因 导出的 session.jsonl 是**压缩后**的日志；实时 `session/event` 流里每个流式响应还携带大量 text-delta/reasoning chunk 事件。长回复轮次（长文本 + 推理 + 联网搜索）的实时事件数超过 捕获缓冲的 `MAX_BUFFER=500`，头部队列裁剪（`splice(0, len-500)`）把一轮中**最早**的 `turn/start` 和 user 消息裁掉了——`findTurnStart` 找不到轮次起点，捕获退化为 "整段缓冲当本轮"，只剩轮次尾部消息。短回复轮次事件数不达上限，故 1、2 轮完整。 ### 修复 - **缓冲只收 4 类事件**（user/message、assistant/message、turn/start、turn/end）， 流式 chunk 在入口直接丢弃（`isCaptureRelevant`）——缓冲量从数百/轮降到个位数/轮； - **裁剪铁律**：进行中轮次（未闭合 turn/start 之后）的事件绝不裁，只裁其之前的已完成前缀 （`trimBuffer`，防御性、基本不可达）； - **L0 即时落盘**：turn/end 立刻经独立串行链写入（`capture.ts`），不再排蒸馏队列—— 原先 L0 会被慢 LLM 调用阻塞（实测延迟 26s），dsh 在蒸馏中途退出时排队中的 L0 直接丢失； runner 不再负责 L0 落盘。 ### 验证 - smoke 新增第 12 节：4 类事件白名单、chunk 排除、600 事件 + 进行中轮次的裁剪场景 （turn/start + user 不丢）、无进行中轮次按 500 上限、未超限不裁。 ## [0.4.0] — 2026-08-16 会话级记忆档位：四态控件（自动/chat/work/关闭）+ 写入召回同档隔离 + L2/L3 分族存储。 ### 新增（UI） - **输入栏档位控件**（`conversation.input.left`，模式选择器右侧）：pill 显示当前档 （`记忆·自动` 等，按档着色），点击在上方浮出 **macOS 风格滑动选择器**—— 横向轨道 + 四个停靠点（关闭 · chat · work · 自动），线条从圆球中心穿过， 拖拽圆头（带阴影）、**松手吸附最近停靠点**后经 RPC 乐观提交（失败回滚 + 红提示）； 当前档由下方标签高亮指示（上方无文字）；点停靠点标签直接跳档，点外部/Esc 关闭； 会话切换组件自动重挂载并拉取该会话档位； - 设置页浏览器保持两族**混合视图**（场景/画像端点拼接展示），概览的"Prompt 家族" 改为"默认档"。 ### 新增（语义：写入与召回同档） - **档位四态**（`MemoryMode = auto | chat | work | off`），每会话独立，按 sessionId 持久化到 `session-modes.json`（>90 天/超 500 条自动清理，写串行化）： - `chat` / `work`：窄 prompt 蒸馏本族 → 只入本族库；召回只查本族记忆 + 本族画像/场景导航； - `auto`（**新会话默认**）：合并词表 prompt 单次抽取（个人三类 + 工作四类，7 类全开）， 每条记忆按 type 前缀落族标签；召回两族全开（画像/导航两族拼接）； - `off`：本会话对记忆系统完全隐身——不写 L0、不蒸馏、不召回，三个模型工具返回提示； - 新会话默认档 = 配置 `family`（union 扩为 `auto|chat|work`，默认 `auto`，语义降级为 "默认档"；旧部署显式配置的 chat/work 仍有效）；中途切档下一轮生效，已提取记忆留在原族； - 与全局开关叠加：全局开关是总闸，会话档位在总闸之下细分。 ### 变更（存储分族隔离） - **memory.db 仍是单库**：`l1_records`/`l1_fts` 加 `family` 列（存量按 type 前缀回填， FTS 表自动重建）；检索三策略（FTS/向量/hybrid）全部支持族过滤（vec 路径过度召回 + 回查过滤）； - **L2/L3 拆分族文件**：`scenes/chat|work/`（旧 `scenes/*.md` 自动迁入 chat）、 `persona-chat.md` / `persona-work.md`（旧 `persona.md` 自动改名）、`state.json` 升 v2 分族 checkpoint（旧平铺内容归 chat 桶）；L2/L3 阈值计数、情境链、prompt 变体各自独立； - 去重候选只在同族内召回（去重永不跨族）；L1 待重试缓冲按档分桶； - 模型工具按调用会话的档位过滤（`exec.agent.id === sessionId`）； `memory_read_scene` 在两族目录按名查找，persona 参数改 `persona-chat.md|persona-work.md`。 ### 新增（RPC） - `dsh-memory/session-mode-get {sessionId} → {mode, defaultMode}`、 `dsh-memory/session-mode-set {sessionId, mode}`（四值白名单校验）。 ### 迁移（全部 init 内自动执行） 1. `l1_records` ALTER 补 family 列 + 按 type 前缀回填；`l1_fts` 缺列则 drop 重建回灌； 2. `state.json` v1 平铺 → v2 分族（旧数据归 chat）； 3. `scenes/*.md` → `scenes/chat/`；`persona.md` → `persona-chat.md`； 4. **部署同步**：web profile 的 `cordis.patch.yml` 删除 `family: chat` 行（否则默认档仍为 chat）。 ### 验证 - smoke 新增第 11 节：族标签推断 / 档位存储持久化与默认档 / FTS 族过滤 + 候选族隔离 + list 族过滤 / 真实旧库（无 family 列）迁移回填 + FTS 重建 / 旧场景与画像文件迁移 / state v1→v2 / 合并词表 prompt 含 7 类 / RPC 档位端点（含非法值拒绝）； - `Config['~standard'].validate({})` 默认 family=auto 验证通过。 ## [0.3.0] — 2026-08-16 记忆浏览器 + 记忆模式开关：设置页"记忆"从纯文字计数表升级为多 Tab 内容面板。 ### 新增（UI） - **多 Tab 记忆浏览器**（设置 → 记忆）： - **概览**：运行计数 + 记忆模式开关面板 + 每 5 秒自动刷新； - **记忆**：L1 记忆卡片列表——关键词搜索（BM25，与召回同源）+ 类型/情境筛选 + 相关度展示 + 点击展开详情（时间戳链/版本/来源消息）；默认更新时间倒序，分页加载； - **场景**：L2 场景块全文（含热度/摘要 META）； - **画像**：L3 persona 全文； - **日志**：memory.log 尾部 200 行滚动。 - **记忆模式开关**（总开关 + 捕获/蒸馏/召回三个分项，总开关关闭时分项置灰）： 走官方 settings 服务（命名空间 `dsh-memory`，live 生效、官方持久化）， 页面 switch 经 loopback RPC 写入；语义 = 静态 config（部署上限）AND 运行时开关。 ### 新增（Host） - RPC 新端点（沿用 `/rpc` loopback 通道）：`dsh-memory/settings-get` / `settings-set` / `list-records`（浏览分页 + 关键词双路径 + 场景 facet）/ `scenes` / `persona` / `log-tail`； - `L1Store.list()`（SQL 按更新时间倒序 + 类型/情境过滤 + 分页）与 `distinctScenes()`； - 三处运行时门控：capture 事件入口、runner 蒸馏步骤、recall 注入文本函数； - settings 服务晚于插件就绪时自动补挂（`internal/service` 监听），缺失时保持全开并提示。 ### 验证 - smoke 新增：浏览接口分页/过滤、开关 schema 默认值、RPC 端点分发端到端 （fake connection 逐端点断言，含开关写透与未知端点拒绝）； - 真机 boot：`记忆模式开关就绪（settings 命名空间 dsh-memory）` 日志确认，HTTP 200。 ## [0.2.4] — 2026-08-16 可诊断性完善：全管线关键节点入日志，出 BUG 时凭 `memory.log` 单文件即可还原执行路径。 ### 新增 - **LLM 调用统计**：每次蒸馏调用记录 `provider/model、输入/输出字符数、耗时`， 调用失败记录原因 + 耗时（此前失败只有裸 message，无路由上下文）； - **JSON 解析失败带原文摘录**：L1 抽取 / L1 去重 / L2 场景操作解析失败时， 记录模型原始输出前 400 字符（模型输出漂移排查的关键信息）； - **去重决策统计**：`抽取 N 条 → 候选召回 M 条 → 决策 store/update/merge/skip=x/y/z/w` 单行日志，无决策记录按 skip 计； - **管线阶段耗时**：蒸馏管线开始/结束（含本轮新增数与总耗时）、L0 落盘、L1/L2 阶段耗时； - **L0 捕获明细**：turn 级捕获从 debug 提升为 info（含 user/assistant 条数分布）； - **召回命中**：召回命中时记录条数 + query 摘录（debug → info）； - **启动信息增强**：数据目录行附带插件版本号；新增蒸馏模型路由解析行 （路由错误启动期即暴露，不再等到第一次抽取失败）； - L2 跳过原因（阈值进度）、L3 未触发原因（阈值进度）入 debug 日志； - 所有管线失败 warn 携带错误堆栈首帧（`errDetail`）。 ## [0.2.3] — 2026-08-16 可诊断性修复：真机两轮对话后 L0 有数据但 L1 无产出，且 dsh 宿主无持久化日志，无法定位原因。 ### 新增 - **文件日志**：info 及以上级别镜像写入数据目录 `memory.log`（超 2MB 轮转为 `.1`）， 写入失败静默忽略——dsh 宿主只把插件日志打到控制台，现在蒸馏管线问题可事后排查。 - **L0 捕获跳过原因入日志**：被冷启动保护拦截的 user 消息、非用户来源（`source.kind≠user`） 的消息各记一条 info——用于诊断"整轮只剩 assistant 消息"这类捕获缺口。 ### 修复 - **L1 "成功但零产出" 与 "失败" 状态可区分**：抽取成功但没有可提取记忆时， `state.lastExtractAt` 也会推进（此前保持 0，与抽取抛错无法区分）。 - **召回上下文热重载泄漏**：`systemPrompt.context()` 的 disposer 此前未挂到插件 生命周期，热重载后旧注册残留、新实例撞名（`"memory:recall" is already registered`）； 现在插件卸载时主动注销全部 agent 上的 `memory:recall` / `memory:profile`。 ## [0.2.2] — 2026-08-15 代码审查修复批次。 ### 修复（高危） - **MemoryDb 构造自降级（S1/P5）**：开库/建目录/PRAGMA 任一失败不再抛出，而是进入 degraded 模式（全部读写安全 no-op），`init()` 对已降级实例直接短路——**任何存储故障都 不再可能拖垮 dsh 宿主启动**（storage-degrade 不变量恢复成立）。 ### 修复（检索语义，对齐官方） - **hybrid 融合前不再做阈值过滤（P6）**：官方 hybrid 对各路完整列表直接 RRF 融合， `scoreThreshold` 仅对 keyword/embedding 单路策略生效（文档已注明）； - **hybrid 融合分归一化到 0~1（P6）**：双列表 rank1 命中 = 1.0、单列表命中 ≤ 0.5， 修复 memory_search 向模型报告 0.02~0.03 分数的语义破碎； - **过度召回系数对齐官方（P1）**：候选池固定 = limit × 3（官方 tool 路径同款）， 移除 type 过滤的额外放大（此前误写为 ×5 的文档一并修正——0.2.0 的描述失实， 实际代码是 ×9）。 ### 修复（健壮性） - **embedding_meta 延迟写入（P7）**：只在重嵌入完全成功（或空库无历史向量）后才持久化 meta；失败则下次启动重新触发——修复"meta 过早写入导致向量表永远空着且能力位报 true"的漏洞； - **周期性向量补齐（P3）**：向量能力启用时每 30 分钟（启动 1 分钟后首跑）比对 向量行数与元数据行数，缺量自动重嵌入补齐——嵌入失败的批次不再需要手工干预； - **旧数据迁移真实化（P8）**：只有全部记录成功入库才改名 `.imported`，rename 失败/部分 导入会打真实日志并在下次启动重试（upsert 幂等）； - **L1 去重决策改精确查询（S3）**：`pipeline/l1.ts` 按候选/目标 id 并集 `getByIds()` 取记录， 不再每轮全表 `all()` 扫描。 ### 修复（状态面板） - stats 版本号从 `package.json` 读取（此前硬编码 0.1.0）；`message` 反映降级态； `pendingExtract` 接入 runner 真实的待重试计数（P4）；数据目录显示统一走 `resolveDataDir`。 ### 清理（审查判断项） - `EmbedHelper` 收敛 L0/L1 重复的嵌入降级/告警逻辑；`EmbeddingProviderInfo` 统一由 `embedding.ts` 导出；场景导航标题统一引用 `persona.ts` 的 `NAV_HEADER`； - 死代码移除：`Bm25Index.add`/脏标记/`snippet` 字段、`makeSnippet`、`readTodayCount`、 recall 的未消费导出、`reindex` 未使用的 onProgress 参数（返回值改为 `{written, failed}` 供 meta 时机判断）； - `[DELETED]` 语义文档对齐（LLM delete → 工程侧删除文件；list 对遗留标记容错）。 ## [0.2.1] — 2026-08-15 ### 新增（输入 token 预算控制） 蒸馏模型上下文 1M token，日常按 ~700k 预算使用（`llm.maxInputChars`，默认 700_000 字符， 按中文 1 字 ≈ 1 token 保守折算）： - **L1 抽取分块**：待抽取消息超预算时自动按块切分、链式多次抽取（情境名逐块衔接，`chunkByCharBudget`）， 消息不丢失——覆盖超长 agent 轮次与抽取失败重试堆积（最坏 ~840k 字符）两条路径； - **callLLM 兜底截断**：任何蒸馏调用的用户 prompt 超预算时截断并标注（L2/L3 与异常场景的最后一道网）； - 单条消息仍在捕获侧截到 `capture.maxMessageChars`（4000 字符），L2/L3 输入被场景文件尺寸天然限住。 ### 配置 - 蒸馏模型显式固定为 `deepseek-official / deepseek-v4-flash`（`cordis.patch.yml`）， 不随 dsh 默认模型切换变化。 ## [0.2.0] — 2026-08-15 存储与检索层按 [MemoryCore](https://github.com/TencentDB-Agent-Memory)（TencentDB Agent Memory） 官方 sqlite 后端架构重构：**JSONL 双写事实源 + SQLite 主检索引擎 + 三策略混合检索**。 动机：旧实现的 L0 检索每次查询重读近 30 天文件并现建内存 BM25 索引、L1 全量载入内存且 每次去重全量重写文件——数据量增长后性能与召回率都会崩。 ### 变更（存储架构） - **新增 `memory.db` 检索库**（`src/store/sqlite.ts`，`node:sqlite` 内置模块 + WAL + FTS5 + `sqlite-vec` vec0 余弦向量表），PRAGMA 组合照搬官方（busy_timeout/WAL/cache_size/mmap/wal_autocheckpoint）。 - **双写语义（官方同款）**：JSONL 追加文件降级为备份/恢复的事实源，**只增不改**； 全部检索走 SQLite——L0 不再扫文件建索引，L1 不再全量载入/重写。 - **数据布局对齐官方**：L0 `l0/*.jsonl` → `conversations/YYYY-MM-DD.jsonl`； L1 `l1/records.jsonl`（单文件全量重写）→ `records/YYYY-MM-DD.jsonl`（按天追加）。 旧布局在插件启动时自动导入检索库并改名 `.imported`（`l0/` → `l0.imported/`， `l1/records.jsonl` → `l1/records.jsonl.imported`），无需手工迁移。 - **去重/合并写路径重写**：`pipeline/l1.ts` 的应用决策从 `all() + replace(next)` 全量重写 改为官方语义——合并结果作为**新记录追加**（版本号 +1），被替换目标 `deleteBatch` 只从检索库删除。 - L1 记录字段对齐官方：新增 `version`、`source_message_ids`、`metadata` （version/metadata 落检索库；source_message_ids 仅存于 JSONL 事实源）。 ### 变更（检索） - **三策略检索**（`recall.strategy`，默认 `hybrid`）： - `keyword`：FTS5 BM25 全文检索（`bm25()` rank → 0~1 分数，公式照搬官方）； - `embedding`：sqlite-vec vec0 余弦 KNN（score = 1 − cosine distance），可选能力； - `hybrid`：双路并行 + **RRF 融合（k=60）**，官方混合检索同款。 - **官方检索参数移植**：过度召回倍数（候选池 = limit × 3）、vec KNN 零向量 补偿缓冲（+10）、召回分数阈值 `recall.scoreThreshold`（默认 0.3，含 FTS 小语料例外—— 结果数不超过 maxResults 时保留低分命中）、type 后置过滤（工具路径不过阈值）。 - **去重候选召回升级为官方 3 级**：空库跳过 → 向量优先 → FTS 兜底（原为内存 BM25 单级）。 - FTS 查询构造：token 引号化 OR 连接 + 中文停用词过滤（官方小表）；分词用项目自带 CJK 二元组 + 英文词分词器（读写两侧同一分词器保证对齐），**不引 jieba 原生依赖**。 - **召回行格式**升级为官方样式：`- [type|scene] content`。 ### 新增（embedding，可选能力，默认关闭） - `embedding.*` 配置组：任意 OpenAI 兼容 `/embeddings` 服务（`baseUrl/apiKey/model/dimensions` 等；DSH 的 `ctx.llm` 无 embeddings 端点，需自备）。向量客户端 L2 归一化（官方同款）。 - `embedding_meta` 持久化 provider/model/维度；配置变化自动 drop 向量表并**后台全量重嵌入** （`reindex()`，不阻塞启动）。 - 关闭 embedding 时等价官方 `provider="none"` 纯 FTS 模式——**默认零外部依赖即可运行**。 ### 降级链（degrade-don't-crash 全程保持） - sqlite-vec 加载失败 → 纯 FTS 模式（capability 位降级，warn 一次）； - FTS5 建表失败 → `ftsSearch=false`；schema 初始化失败 → 检索库 degraded → 记忆功能停用 但 **dsh 宿主照常启动**（沿用 storageOk 降级链）； - embedding 单次调用失败 → 该次检索降级 FTS + 告警一次，写入侧跳过向量（可 reindex 补齐）； - 插件卸载时关闭 DB 连接（WAL 落盘），注册于 `ctx.effect`。 ### 依赖 - 新增运行时依赖 `sqlite-vec@0.1.7-alpha.2`（与 MemoryCore 同版本；预编译原生扩展， 仅此一个原生依赖）。 - `node:sqlite` 为 Node ≥ 22.13 内置模块（engines 已要求 ≥ 22.16，无新增运行时要求）。 ### 破坏性变更 - 数据布局：`l0/` → `conversations/`，`l1/records.jsonl` → `records/`（旧数据自动导入， 原文件保留为 `.imported`，可手工清理）。 - `L1Store.search` / `searchCandidates` 由同步改为 **async**（向量路径需远程调用）， 第三参数从 `type?: string` 改为 `{ type?, scoreThreshold? }` 选项对象（仅插件内部 API， 对外工具/召回行为不变）。 ### 验证 - 冒烟测试新增/重写存储与检索断言：SQLite 双写、FTS 中英检索、type 过滤、阈值与小语料例外、 merge 追加/删除语义、**vec0 向量 + hybrid + reindex**（确定性假嵌入）、旧布局迁移、 RRF/bm25RankToScore/buildFtsQuery 纯函数——全部通过。 - Config Standard Schema 默认值填充验证通过（`embedding`/`recall.strategy`/`scoreThreshold`）。 - 真机启动验证：`dsh --profile web` 正常拉起，`~/.dsh/memory/` 生成 `memory.db`（含 WAL）+ `conversations/` + `records/`，表结构完整（l0_conversations/l1_records/l0_fts/l1_fts/embedding_meta）， 停止干净。 ## [0.1.0] — 2026-08-14 首个可用版本。 - L0~L3 分层蒸馏管线（捕获 → L1 抽取/去重 → L2 场景整合 → L3 画像蒸馏），Prompt 移植自 MemoryCore（chat/work 双家族）。 - agent/pre-step 自动召回 + agent 作用域上下文注入（`` / `` / `` / 工具指南），capture 侧剥离注入标签防反馈循环。 - 模型工具：memory_search / conversation_search / memory_read_scene。 - 设置页状态面板（client bundle，Connection RPC 数据通道）。 - 修复致命 bug：配置 schema 导出名从 `schema` 改为 `Config`（cordis 只读 `plugin.Config`， 导错名会导致整个 profile 启动失败）；LLM 流式文本收集改为 block-end 权威（修双倍输出）。