# Changelog

> shoucang 更新日志。基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。

## [Unreleased]

### Changed
- **🎯 v9 全面对齐（第十二轮 · 验收基建固化 + 六页结构对齐）（2026-09-13）**
  **① 先修「看不见」的根因（本轮最大产出）**：此前「整页长图」与「DOM 骨架实测」都是**一次性脚本**，
  随 `_tmp-*` 清理出仓 ⇒ 逐页核对只剩 860px 首屏，而原型每页真实高度 4800–6000px，
  **每页只看得到约 15%**（第十一轮误判「总览只有 2 张卡」正是这么来的）。本轮把两者**固化进
  `scripts/ui-geo-regress.mjs`**：`--full-shots <dir>`（面板 + 原型各 8 张整页长图，先实测高度再截图）·
  `--skeleton <dir>`（两侧同一套选择器的块树 + 路径编号 + 类计数，落 txt 供程序化 diff）。
  三个坑一并记录在案：截图输出路径必须**绝对**（相对路径会静默落到别处，表现为「✗」）·
  目标目录须先 `mkdir -p` · 骨架递归深度要 ≥8（卡在 `wa-tab-panel` 之下会被截断，误判成"结构缺失"）。
  **② 设置页**：6 个折叠组 → **一张卡平铺 10 行** + 「快捷键」卡（键位 pill 改中性色）+ 「恢复默认」动作行
  —— 原型的层级只有「页头 → 卡 → 行」，折叠组是面板自造的一层；页头改「设置」+ 加「导出快照」
  （真实动作：导出配置原文 + 界面偏好为 JSON）；补 **导航分组显示 / 页脚健康条** 两枚开关
  （两项功能本就在渲染，此前只是没暴露 —— 不是假开关）。
  **③ 参数页**：4 个 pane 各自**包进一张卡**（原型 `div.card.plain`）—— 此前 18 个控件裸平铺，整页少一层容器。
  **④ 运行观测页**：KPI 去掉状态点与进度条（原型卡高 104，面板 110）· 执行进度由折叠块改**卡** + 路由 chip ·
  日志行改原型形态「级别图标 + 方法 + 端点 + 耗时 + 状态码」（耗时与状态码是 `api()` 写入 `ctx` 的**真实值**，
  不是解析 message 文本）；`UI.kpi` 因此新增 `plain` 变体（容量类 KPI 仍带条，不用"改一处、别处跟着走样"的做法）。
  **⑤ 插件集合页**：夹具补 3 条成员（此前 `members:[]` ⇒ 成员网格恒只有「添加卡」，卡片形态无法核对）。
  **⑥ 记忆库页**：容量区排版与标准 KPI **收敛为同一组值**（值字号 `clamp(22px,2.05vw,26px)` + `min-height:34px`
  + 条 `margin-top:auto` 沉底共线；此前固定 22px/88 高 vs 原型 26px/110）· 归档区 Tab 回填计数（原型「归档区 4」）。
  **⑦ 深度睡眠页 14 块 → 6 块**（对齐原型 DOM）：移除 判据与对账 / 认知环（总览页已有同源卡）·
  账本对账（迁运行观测页「关键指标」Tab）· 会话徽章与计时条（信息已在分布卡图例与状态机水位里）·
  控制小节（触发并入「睡眠状态分布」卡头右侧的执行位）· 阈值小节（4 项迁设置页 › 高级，与「配置原文」同处）；
  补 **本轮产出回执（7 张 KPI）**、**下轮材料预估（3 行）**、「最近会话」卡（pill 状态 + 描述；
  原型的「查看」按钮**不放** —— 面板没有会话详情视图，不做点不动的控件）。CSS 侧 12 条死规则随之删除。
  **⑧ 夹具三补（不补则出图缺块，属"假页"）**：`/cognition/report` 缺 `ok` ⇒ 回执与材料**整块不渲染**
  （`renderCognitionReport` 首行 `if(!r.ok)return`）；再补 `sleeps[]`；`/deepsleep` 补 `sessions[]`。
  **⑨ 出图管线自身的两个 bug 一并修**：`group()` 单游标会把握手卡**嵌进上一张卡的卡体**（第二次调用把游标推成卡体）
  ⇒ 拆成「卡挂容器 / 内容挂卡体」两个游标；异步卡（回执 / 材料）必须在**同步阶段占位**，否则晚到的卡落到页面末尾。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` **42 pass · 1 xfail · 0 skip** ·
  `ui-geo-regress` **99 PASS / 0 FAIL** · 8 视图整页出图逐页复核（`deliverables/v9-compare/w9/`）。
  **⚠ 仍未对齐（如实记录，接手点见 `deliverables/v9-full-change-plan.md` §11）**：记忆库各 Tab 的「pane → 卡」
  层级 · 画像页指针行的成熟度数值列（后端未上报该字段）· 设置/参数页行高（原型 65 / 面板 ~94）·
  深睡页「待执行结构操作」块（无数据源）与「自检卡 ↔ 最近会话卡」顺序 · 插件集合「N 工具」字段。
- **🎯 v9 全面对齐（第十一轮 · 运行总览页 · v9 原型 = 最终标准）（2026-09-13）**
  **① 对齐方法先修根**：此前"逐页复核"用的出图只有 860px 首屏，而原型每页真实高度 **4826–5968px**
  ⇒ 每页**只看过约 15%**，滚动下方的卡片从未进过图。本轮改为**整页长图**（原型放开 `.frame` 的 720px 上限；
  面板放开模态的 `height:min(900px,92vh)`），并加 `--shots` 之外的整页出图能力；核对改为 **DOM 同口径实测**
  （直接量骨架 / KPI 条顶边 / 卡片计数），不再靠肉眼。
  **② 总览页两栏 2 卡 → 6 卡**（原型 DOM 实测 card 6），补齐 4 张：
  · **晨起摘要**（`delta` / `weekDiff`，数据本就在 `/memory/overview` 响应里，此前只是没渲染）
  · **最近动态**（`.tl` 时间线；原型未标端点 ⇒ 按 v9 标准用现有端点聚合**真实**动态，不编造事件流）
  · **判据与重排门**（`GET /criteria`；**从深度睡眠页迁来**——原型总览有、深睡页无）
  · **快捷操作**（4 个运维动作）
  **③ 恢复系统状态卡被误删的 3 行**（MCL 认知环 / 注入统计 / 嵌入服务）—— 上一轮删除依据是
  **方案文档正文**「该卡只有一行」，而**原型 DOM 实为 4 行**（各带右侧 pill）。**对齐依据必须是 DOM，不是文档描述。**
  **④ badges 文案统一为「标签 · 状态词」**（`蒸馏 · 2 分钟前` / `判据台账 · 已就绪` / `库版本 · 已启用`）；
  「向量 **fusion**」是 provider 标识，**不再中文化**（旧实现译成"融合"）。
  **⑤ 告警条**改原型结构：`<b>N 项待处理</b> —— 描述` + 「前往处理」可点击直达（旧实现是裸 `⚠ 文本`）。
  **⑥ 操作卡端点**由灰字改 **`.sc-src` chip**（等宽 + 边框 + 底色）；页头补 `.proto-note` 标注本页唯一执行位。
  **⑦ 新增端点 `POST /maturation/scan`**（与 `/reconcile` **同构**的运维脚本端点）——
  v9 原型「快捷操作」卡有「成熟度扫描」按钮，而插件运行时无该能力（实现是 `scripts/maturation-scan.mjs`）
  ⇒ 端点化，不留假按钮。契约路由 **34 → 35 条**。
  **⑧ 测试基建同步**：`ui-geo-regress` 的契约条数**改从产物读**（`lib/panel-contract.json` 的 `routeCount`），
  不再写死数字（加一个端点就要改测试是纯噪音）；`test-panel-wiring` 的 `ROUTES` 登记新路由。
  **⑨ 夹具三修（不修则出图/核对失真）**：索引行由字符串 `'[x]'` 改**对象数组** `{tag,subject,pointer}`
  （格式不符会让 `renderIndexRows` **整块跳过**，记忆库/画像页列表全空）；补 `delta`（晨起摘要）、
  `criteria.health.notesWarn`（判据卡）、`/deepsleep.active`（状态机整块跳过渲染）。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` **42 pass · 1 xfail · 0 skip** ·
  骨架实测 **card 6 / card 6**（原型 ↔ 面板一致）· 整页出图逐块复核。
  **⚠ 仍未做**：其余 7 页按同一流程逐页推进（差异清单见 `deliverables/v9-full-change-plan.md`）。
- **🎯 v9 严格对齐（第三轮 · 挂账两项收口）（2026-09-13 · 收掉下一条"第二轮"遗留挂账）**
  上一轮挂了三项，本轮收两项、第三项附明确不做的理由。
  **① 画像页「成熟度分布」接通真实数据**（此前 5 根柱**恒 0** ⇒ 视觉上等于坏图，卡内还写着"数据未上报"）：
  `/memory/overview` 新增 `maturity` 字段 = **库内** `audit/maturation.jsonl` 按 A 值 0.2 五档的**小节数**
  （与 `deepsleep-apply` 同一台账，**不新增端点**）；前端柱高按最大值归一化，并标注升格线与空台账文案。
  真机实测分布 `0 / 35 / 8 / 4 / 14`（共 61 节，坏行 0）。
  **② 「压缩画像」按钮从假按钮改为真实动作**：上一轮那枚按钮**没有 onclick**（点了没反应，title 还写着"占位"）
  ⇒ 现接 `/deepsleep/trigger`（画像压缩在插件内**无独立端点**，唯一实现路径是深睡归纳的树整理），
  confirm/title 明写这层依赖，不留"看得见点不动"的控件。
  **③ 深度睡眠页补「状态机」卡**（原型第 1 张卡，此前整块缺失）：三节点 = 插件真实的**三段停滞时间轴**
  （清醒 → 判定中 ≥ probeAfterMs → 可入睡 ≥ idleMs），当前阶段由 `now` 与两个阈值比较直接得出，
  水位条 = 停滞时长 / 阈值。**零新端点、零自造状态**。
  **④ 运行观测页：6 个叠放折叠块 → 4 组 Tab**（原型为「4 KPI + 执行进度卡 + 3 组 Tab」）：
  调用日志 / 错误定位 / 运维操作，另加「关键指标」（原型无此组但为真实功能，独立成枚，不删功能）；
  「高级：行级编辑 / 删除」并入运维操作。Tab 态经 `Cfg('tab:observe')` 持久化，与参数页/记忆库页同一 `UI.tabs` 实现。
  **⑤ 出图集 5 → 8 视图**：`ui-geo-regress --shots` 补画像 / 插件集合 / 深度睡眠 —— 这三页正是
  **"几何断言天然失明"**的地方（柱高全 0、状态机整块缺失，门禁照样全绿，只有出图肉眼可见）。
  **⑥ 夹具修正（否则出图是假的）**：`/deepsleep` 补 `active`（缺它 ⇒ 端点判定未激活、整块跳过渲染，
  出图得到"未激活"空页）与 `lastActivityAt`/`probeAfterMs`（状态机判据）；
  `/memory/overview` 补 `maturity`，用**真机实测分布**而非编造柱形。
  **⑦ 工具链坑（新踩）**：`FIX` 是**模板字符串**，其注释里写反引号会**提前终止字符串** ⇒
  `SyntaxError: Unexpected token '!'`；注释内引用标识符一律不加反引号。
  **⑧ 协作坑（新踩，已入 skill）**：同一条消息里**并行发多个 Edit 改同一个文件**会产生写竞态 ——
  本轮 5 个 Edit 只有 3 个落盘，两个静默丢失（表现为"日志面板进了 Tab、错误定位却还在页级"）。
  **改同一文件必须串行**。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` 42 pass · 1 xfail · 0 skip ·
  `ui-geo-regress` 99 PASS / 0 FAIL · 8 视图出图逐页肉眼复核。
  **⚠ 仍未对齐（如实记录，附理由）**：
  · 插件集合成员卡的「N 工具」—— 插件**未上报工具数**，无采集口径；且原型那三张卡
    （managing-memory / shoucang-core / scheduler）本身是**三包合并前**的旧结构，真机为单成员，
    **不宜按原型数量硬对齐**；
  · 画像页「USER / AGENT 构成」出图为空——夹具 `lines` 是无 tag 的占位字符串，真机有 tag 即正常显示。
- **🎯 v9 严格对齐（第二轮 · 剩余四页）（2026-09-13 · 承接上一条）**
  **⑤ 画像页**：页标题「画像板块」→「画像」、页头描述与 chip 对齐原型；容量网格改为**本页专用 2×2**
  （新增 `.sc-kpis-2`），并**补齐原型的第 3、4 格**——「USER 构成 / AGENT 构成」两张卡（数据纯前端从指针行
  的 tag 统计得出，**零新端点**）；容量数字改 `Derive.num()` 千分位（对齐原型 `2,340 / 3,000`）。
  **⑥ 全站 KPI 网格**：`.sc-kpis` 由 `repeat(auto-fit,minmax(160px,1fr))` 改为**固定 4 列** `repeat(4,minmax(0,1fr))`
  ——vfiff 实测 auto-fit 在 946px 下算出 **5 列**（多一个 0 宽轨道），与原型的 `repeat(4,1fr)` 不符；
  ≤900px 断点收敛 2 列（与原型同）。
  **⑦ 插件集合页**：成员卡状态文案对齐原型——原型 `.pmeta` 右 span 是「已装配」纯文字，**不暴露内部基准口径**
  （`✓ 注入器` / `✓ profile` / `✓✓ 双基准`）⇒ 改回「已装配 / 未装配」，口径差异移入 `title`（悬浮可见，信息不丢）。
  **⑧ 深度睡眠页**：**补「睡眠状态分布」卡**（原型第 2 张卡）——分段条 + 图例（五态语义色与徽章同源），
  数据是同一份五态计数，只是**形态**从徽章改成比例条。**落地时踩了一个作用域坑**：把整块移到
  `renderRunExtras` 之前 ⇒ 代码离开 `/deepsleep` 回调作用域、引用局部 `r` 未定义 ⇒ **整页渲染中断**（截图空页）；
  正确做法 = **占位容器**（`distSlot` 在原型位置提前插入，异步回调内把卡挂到占位）——代码不离开作用域，
  DOM 顺序仍符合 v9。这个坑与前端拆分的「父函数局部名子函数拿不到」同根：**跨作用域搬代码前先查引用**。
  **⑨ 运行观测页**：**补 4 张观测 KPI**（请求总数 / 成功率 / 平均耗时 / 错误）——纯前端从本地 Store 统计
  （logs 的 `"N ms"` 字样 + errors），**零新端点**；页头右侧补**「导出」（JSON 下载）与「清空日志」(danger)**；
  路由 chip 对齐原型（`/cognition/report · /selfcheck · /reconcile · /embed/test`）。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` 全绿 · 8 视图出图逐页复核。
  **⚠ 仍未对齐（如实记录，均有明确理由）**：
  · 运行观测页的分区容器仍是**折叠条**（原型是 tabs 胶囊：调用日志/错误定位/运维操作）——改造要把延迟渲染
    的折叠内容搬进 tabs，结构风险较大，**单独立项**；
  · 画像页的「成熟度分布」卡与「压缩画像」按钮——现有 34 条路由**无此数据源**，需新增后端端点；
  · 插件集合成员卡的「N 工具」——需后端在 `/suite` 增加 per-member 工具数字段。
  **⚠ 需重启 DSH** 前端才生效。
- **🎯 v9 严格对齐（第一轮 · 视觉形态）（2026-09-13 · 用户拍板「从视觉看统一对齐，组件样式和展示效果」）**
  **① 页面底色令牌**：原型 v9 的层级是 `--bg #131315` < `--panel2 #171719` < `--panel #1b1b1e` < `--panel3 #2a2a2f`；
  面板此前把 `--panel` 的值（#1b1b1e）当成了**页面底** ⇒ 比原型**亮一档**（vfiff 实测 `--bg DIFF`）。
  不直接改 `--sc-bg1`（它还服务按钮/输入/胶囊等部件，改了会连锁引入新差异），而是**新增页面级令牌**
  `--sc-bg-page`，只让 `.sc-main` / `.sc-headslot` 使用 ⇒ `--bg` 对齐。
  **② 记忆库页形态收敛**（删掉原型没有的两大块 + 对齐口径）：
  · 删**状态徽章行**（7 枚）——原型记忆库页无此块（它是运行总览页的组成）；
  · 删**「运行态」Tab** 及其内容（蒸馏运行 / 记忆库状态 KPI）——同属运行总览页；
  · 删**「向量召回」区块**——原型无；且它写的 `pane('run')` 随 Tab 删除后返回 null，
    使页面报 `Cannot read properties of null (reading 'appendChild')`（已修）；
  · 三列容量口径改原型：`MEMORY.md 容量 / notes · 笔记 / pending 候选`（原第 2 列是「待归档会话」）；
  · Tab 文案改原型样式**带计数**（知识索引 66 / 候选区 N / 笔记 N 类 / 统计），默认落「知识索引」；
  · 导航脚状态同步（`refs.navHealth`）从被删段迁到 `fillCap` 之后，**不丢功能**。
  **③ 运行总览页形态对齐**：`系统状态` 卡由 5 行收敛为原型的**一行**（当前根目录）——另 4 行
  （MCL / 判据版本 / 库版本 / 注入统计）与顶部徽章行重复且原型没有；操作卡按原型**加线框图标**
  （蒸馏 ✦ / 深睡 ☾ / 自检 ✓）；页头路由 chip 对齐原型（`/memory/overview · /cognition/report · /mcl/status`）。
  **④ 连带清理（均为门禁抓出的真问题）**：删段后 `Derive.vecRecall` 失去唯一调用点（D7c 死代码断言翻红）⇒
  连同 `VEC_RECALL` 表、导出项与测试金标准一并删除；`.sc-danger` 成孤立样式（CSS 审计门禁翻红）⇒ 删除。
  **⑤ 工具链修假绿**：出图脚本 `.internal/panel-shots.mjs` 原先 `catch(e){}` 吞错误 + 用 `existsSync` 判成功 ⇒
  Chrome 全失败时仍报 ok，且**把图写进了 Chrome 自己的 cwd**（出图目录传的是相对路径）——
  我据此误判「删了两块但图没变」。已修为：出图目录**解析为绝对路径** + 先删目标文件 + 打印 stderr。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` 全绿 · 契约基线按新形态更新（记忆库 16 → 7 项）·
  `ui-geo-regress` 的 TABBED 记忆库 5 → 4 同步 · 8 视图出图复核。
  **⚠ 仍未对齐（如实记录）**：原型记忆库 tabs 第 4 项「归档区」面板无独立数据源，未造；
  画像 / 插件集合 / 深度睡眠 / 运行观测 四页的形态逐页对照尚未做。
  **⚠ 需重启 DSH** 前端才生效。
- **🎛 P0-1 组件库收尾：接入进度条组件 + 清掉 6 个零使用 import（产物 −150KB / −20%）（2026-09-13）**
  **① 接入 `wa-progress-bar`**（`UI.progress` 内部换实现，**调用点零改动**）：条体改由组件承载，
  外壳 `div.sc-prog` 保留（承载行间距与下方文字），`value` 属性驱动进度。
  **关键在尺寸接管**——组件自带 `--track-height:1rem`(=16px) 与 `min-height`/`padding`/`margin`，
  比方案 6px 高 10px；**首版直接替换（不接管尺寸）实测 `ui-geo-regress` 93 → 70 PASS**（整页网格位移，故被回滚）。
  本轮先读组件源码 `progress-bar.styles.ts` 拿到变量名，再用 `--track-height`/`--track-color`/`--indicator-color`
  显式接管 ⇒ **99 PASS / 0 FAIL**。
  配套**常驻渲染断言**（`ui-geo-regress`）：① 组件已注册；② `--track-height` 计算值 = 6px。
  **判据为何用计算样式而非几何**：组件是 LitElement，插入 DOM 后需等一个 microtask 才渲染，
  同步读几何只能拿到 `h=0`、shadow 里仅注释（**实测踩到**）；而 CSS 变量解析是同步的，
  且「变量是否被接管」正是本项要守的靶点。
  **② 清掉 6 个「import 了却零使用」的组件**（`vendor.js` 13 → 7 import）：card / badge / spinner / tooltip / select / option。
  逐项评估（口径 = 产物里有无 `document.createElement('wa-*')`）：`UI.card` 有 8 个调用点，但
  `.sc-card-hd/.sc-card-bd` 与 wa-card 的 slot **不同构**、替换会叠加两层卡片（须重写整个卡片层 CSS，
  风险高而观感无收益）；`UI.badge` **零调用点 = 死代码**；`spinner` 无加载态需求（走 `busyText`）；
  `tooltip` 现有走原生 `title`；`select/option` 二度回滚后维持原生（图标虽已解锁，但填充/宽度还需接管
  4–5 个 `--wa-form-control-*` 变量，且验证手段只有出图目视 ⇒ 风险/收益比不佳）。
  **实测收益：产物 756,334 → 602,328 字节（−154KB / **−20%**）**——「import 未用」的代价比预估大得多。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` 全绿 · `ui-geo-regress` **99 PASS / 0 FAIL** ·
  `test-css-usage-gate` PASS（删 `.sc-prog-fill` 后无孤立样式）· 已安装副本特性标记 14 项齐全。
  **⚠ 需重启 DSH** 前端才生效。
- **✅ P1-2 + P1-1 收尾：记忆库页与模型页全部拆净，前端函数跨度全线 ≤200（2026-09-13 · 承接下一条）**
  **① 契约件泛化**：`test-panel-toggles-contract.mjs` → **`test-panel-view-contract.mjs`**（一件覆盖**参数页 + 记忆库页**两视图；
  旧件与旧基线删除）。迁移已证伪等价：新件参数页 34 项与旧件**逐项相同**。记忆库页的契约对象是**结构骨架**
  （`.sc-mem-group-title` 小节标题 / `.sc-cap-top` 容量列 / `.sc-mem-stat-label` 统计卡，**16 项**）——该页本来就没有表单控件。
  **② P1-1 收尾**：`renderTogglesModel` 270 → 父 14 行 + `renderTogglesModelVec`(192) + `renderTogglesModelLlm`(72)。
  两个板块（向量链路 / LLM 模型选择）之间**无共享状态**，是零风险的一刀。
  **③ P1-2**：`renderMemoryExpanded` **321 行** → 父 69 行 + **9 个语义段子函数**（run 主段 72 / 月度成长 26 / 记忆库状态 27 /
  索引 24 / pending 32 / notes 24 / 本地知识区 32 / 向量召回 16 / 成长增量 28）+ 模块级 `mkStat`。
  **④ 前端函数跨度全线 ≤200**（实测最大 **192** = `renderTogglesModelVec`；原 615 / 321 两块巨石均已拆净）。
  **验收**：`typecheck` 0 错 · `build` 成功 · `check-runner` **42 pass · 1 xfail · 0 skip** ·
  契约 **参数页 34/34 + 记忆库页 16/16** 逐项一致 · `ui-geo-regress` PASS · 差异件已部署（安装副本 140/140 sha 一致）。
  **⚠ 需重启 DSH** 前端才生效（热重载只换 host 侧 `lib/*.js`）。
  **⚠ 关键设计约束（决定了唯一安全的切法）**：记忆库页的 Tab 内容**是交织的**（run 出现 3 次、growth 3 次、index 2 次）。
  故**不能**按 Tab 聚合重排——重排会改变各 pane 内元素的 DOM 顺序（= 视觉顺序），而契约测试只比对**清单**、
  不含顺序 ⇒ **顺序漂移它抓不到**。因此按**原顺序**切段（零重排），每段一个语义化函数名。
  **⚠ 踩坑记录（与 P1-1 同型，第三次出现）**：子函数只接 `ctx` 而**不解构**段内用到的父级名（`data` / `view` / `cap`）时，
  段内原样使用这些名字会 ReferenceError ⇒ 父函数中断 ⇒ **全部段落不渲染**（契约实测 16 项全缺）。
  口径固化：**子函数开头必须解构 ctx 里用到的每一个名字**（`host` / `data` / `view` / `memoryFile` / `cap`）。
- **✅ P1-1 前端函数跨度债务归零：`renderViewToggles` 615 行 → 父 21 行 + 4 个 pane 子函数（2026-09-13 · 方案档 `deliverables/ui-implementation-plan-2026-09-13.md`）**
  **① 先建安全网（方案列为不可跳过的硬前置）**：新增 `scripts/test-panel-view-contract.mjs` + 基线
  `scripts/fixtures/panel-view-baseline.json`（**参数页 34 项**：cap 10 / inject 5 / model 6 / sched 13）——
  真机渲染参数页，取每个 `.setting-item` 的「Tab + 名称 + 控件类型」，**拆分前固化、拆分后逐项比对**，
  **清单不变 = 行为等价**。为什么不用静态扫源码：`SWITCH_KEYS` 有数据驱动的整体跳过、`UI.item` 的控件形态由
  children 决定、部分项在异步回调里追加 ⇒ 只有真机渲染的清单才作数。已**反向证伪**（篡改基线任一 ctl ⇒
  FAIL 漂移 2 项；还原 ⇒ PASS），已登记 `check-runner` 的 `CHECKS`。
  **② 拆分**：`body.js:1964–2578`（615 行）按配置域切成 `renderTogglesInject`(91) / `renderTogglesCap`(90) /
  `renderTogglesModel`(270) / `renderTogglesSched`(149) + **模块级** `numSetting`(16)；父函数只做页头 + 页签装配
  （**21 行**）。切片用一次性脚本按行号机械搬运（28 处边界断言 + 花括号自平衡校验 + 关键锚点自检），零手工重打。
  子函数必须放**模块级**而非嵌在父函数里——否则父函数仍是 600+ 行，拆分只换位置、跨度门禁照样红。
  **③ 棘轮收紧**：`audit-fnspan --client --gate --debt` **1 → 0**，实测 `> 400 行的函数: 0`。
  **验收**：`typecheck` 0 错 · `build`（host+client）成功 · `check-runner` **42 pass · 1 xfail · 0 skip** ·
  `ui-geo-regress` **93 PASS / 0 FAIL**（与拆分前基线一致）· 契约测试 34/34 一致 ·
  差异件已部署（安装副本 **140/140 sha 一致**）· 参数页真机出图核对无回归。
  **⚠ 需重启 DSH**：前端 bundle 变了，热重载只换 host 侧 `lib/*.js`。
  **（首轮遗留，同日已收尾）**：拆完 `renderTogglesModel` 仍是 **270 行**（> 方案「子函数各 ≤200」的目标，但 < 400 不触发门禁）；
  当天第二轮已拆净 —— 见下一条。
  **教训留痕（两个坑都值钱）**：
  （a）首版把 `gVal` 定义在父函数里、以为「作为参数传下去就够」——但子函数**直接引用 `g`** 的地方
  （cap 的 `(g && g.actual)`）拿不到父函数局部变量 ⇒ ReferenceError ⇒ 父函数中断 ⇒ **后面的 pane 一个都不渲染**
  （契约测试实测：34 项只剩 5 项）。口径改为「**传 `g`，各子函数自建 `gVal`**」——`g` 只留一条传递路径。
  （b）契约测试当时只报「缺失 29 项」给不出根因，白折腾一轮；现补 `error` / `unhandledrejection` 捕获并
  **顶到「缺失 N 项」之前**报出——**根因优先于症状**。
- **🔧 UI 落地三项（P0-2 / P0-3 / P2 · 2026-09-13 · 方案档 `deliverables/ui-implementation-plan-2026-09-13.md` + `ui-audit-report-2026-09-13.md`）**
  **① P0-3 `renderIndexRows` 健壮性防御**（`src-client/body.js`）：索引行元素若退化为非对象（如纯字符串占位），
  原实现对 `tag/subject/pointer` 解构全得 `undefined` ⇒ 渲染出「空 pill + 空文本」的行，**静默丢数据且看不出来**
  （实测：USER.md 容量卡声称 24 条但只渲染 17 行、AGENT.md 19 条整卡失踪）。现**跳过退化元素并把跳过数回显**
  （`⚠ N 条索引行数据格式异常已跳过`）+ `Log.warn` 留痕。真机数据正常时零影响。
  **② P0-2 前端纳入函数跨度门禁**（`scripts/audit-fnspan.mjs` 扩展 `--client`、`scripts/test-fnspan-wrapper.mjs` 新增）：
  此前 `audit-fnspan` **只扫 `src/*.ts`**，前端 `src-client/`（4523 行）完全无门禁守 —— 后端已把 >400 行函数清零，
  而前端 `renderViewToggles` 615 行从未被度量。新增 `--client` 模式（TS AST + `ScriptKind.JS`，实测解析 0 诊断）
  并内置**包装函数排除规则**（`非声明形态 && 嵌套深度≤2 && 跨度占比>0.8`，应对 `body.js` 的
  `__ModuleLoader__` 自注册 IIFE 双层包装）；阈值 `--soft 400 --hard 800 --debt 1`（实测值，棘轮只许收紧）。
  配套 7 个反向证伪用例（含改名绕过 / 纯 ESM / 「3 个 500 行函数塞进大闭包仍判 3 个」的**反向激励**测试）。
  **③ P2 `<wa-icon>` 可渲染性取证**（`scripts/ui-geo-regress.mjs` 新增 `--icon-check`）：挂离屏探针按
  **渲染尺寸**判定（此前只验 shadow DOM 里「有没有元素」⇒ 假绿）。**实测 `rendered=true size=20x16`**
  —— `vendor.js` 旧注释「渲染尺寸为 0」已不成立（主题令牌层展平后即可渲染），
  **解锁 `wa-tooltip` / `wa-option` / `wa-select` 的采用**（此前 `wa-select` 因该问题回滚为原生 select）。
  **验收**：`typecheck` 零错 · `build`（host+client）零错 · `scripts/check-runner.mjs` **41 pass · 1 xfail · 0 skip**（xfail 为既有 `test-treeops-rm`）。
  **回滚**：三处改动互相独立，`git checkout` 对应文件即可。
  **⚠ 已知未做**：P0-1 组件库收尾（`wa-card`/`wa-badge`/`wa-spinner`/`wa-tooltip`/`wa-option` 仍 import 未用）
  —— 试做 `UI.progress → wa-progress-bar` 时 `ui-geo-regress` 由 93 PASS/0 FAIL 跌至 70/23 FAIL
  （wa 组件自带 `min-height`/`padding`/`margin` 与手写 `.sc-prog-*` 不同 ⇒ 整页网格位移），
  已回滚；**每个组件需单独一轮适配 + 回归**，不可批量替换。
- **🧩 上下文供给落地（P0 / P1 / P2 / 局部 P5 · 2026-09-13 · 方案档 `docs/context-supply-plan.md` v3）**
  **① P0 即时项**：`panel-inject.ts` 注入 query 取值补 `data.source.kind === 'user'` 来源过滤——此前宿主注入块（运行态快照 / MCL 慢通道材料 / 后台回执）也会被当成"最近用户消息"，导致**用注入物去召回记忆**（实测旁证：两个不同问题召回出同一批 6 行）；口径现与 `mcl.ts`、`distill-activation.ts`（ACT-024 结构性去污染）一致。
  `panel-shared.ts` 画像行配额由「全局最近 N 条」改为「**按标签各留最近 1 条**再取 N 条」并**截断可见化**（被挡下行留痕提示），修掉"新写的 `[性格]`/`[认知]` 把 `[边界]` 静默挤出注入面"。
  引导词补人格两面：`skill/engine/criteria.json` 的 Q2 判据与 `deepsleep-core.ts` 双画像段加入**表达风格（`[性格]`）/ 思维模式（`[认知]`）**——六类 P 标签长期零实存的主因是引导词只列"做法/边界/教训"（结构性排除）；注册表 `surface.injection.carriers.profile` 3→4。
  **② P1 供给台账**（新增 `src/supply-ledger.ts`）：会话级注入台账（行指纹 × 会话，**生命周期独立于轮级 state**）——修掉"`state.delete(sid)` 在每条用户消息自删去重信息 ⇒ 同一会话逐字重复注入"（实测 8 次注入 2,955 字符中 **782 字符 = 26%** 为重复）；候选全已给过时**本步零注入**并记 `dupSkipped`；三张会话 Map 加硬上界（此前 `taskText`/`ready` 从无清理）。
  **③ P2 三层预算 + 稳定面缓存**：热记忆注入引入**总预算 + 三层分档**（一次性 11% / 稳定面 56% / 变动面 33%；总预算由注册表 `surface.injection.budgetChars` 驱动并 **3000 → 1800**），超预算**留痕不静默**；画像两段（query 无关）单独缓存、以**索引文件尺寸签名**失效，免掉"新用户消息 ⇒ 全量重读三文件 + 解析 activity.jsonl"。
  **④ P5 口径收口**：定位统一为**长期记忆底座**（`README.md` / `skill/memory-whitelist-spec.md` / `docs/memory-core-model.md` / `docs/assistant-focus-plan.md` 四处）；「守藏不设任何人为边界」主语错位修正为「**agent** 不设人为边界，**守藏**只供给底座」；§8「明确不做」增「伙伴关系与人设实现（归另一插件）」；`D:\FF\modules\shoucang.md` 标注 S01 装配检测 / S05 人化执行循环 / `assistant_capabilities` 为**自检附属 · 非记忆职能**。
  **验收**：`typecheck` 零错 · `build`（host+client）零错 · `scripts/check-runner.mjs` 全绿。**回滚开关**：`injectProfileRows=0`（画像行不注入）· `budgetChars` 调大（回到无总预算行为）· 台账纯内存态（重载即清空）。

- **🐞 运行态修复：预算裁切把 USER 画像整段挤掉（2026-09-13 · 重启验证发现并当场修）**
  重启后系统化验证发现：三层预算原实现对「agent 画像 + 用户画像**合并后**的稳定面数组」做一次 `clamp`
  ⇒ agent 画像一超预算，**USER.md 画像整段消失**（`GET /inject/preview` 实测 `含用户画像段 = false`），
  违反方案自身不变量 **I2a「恒定面每步必在」**。**修法**：稳定面**按块各自配额**（agent 55% / user 45%，各自下限 120 字符）——
  **块内裁行、不丢块**，且每块各自留痕（`（agent 画像另省略 N 行…）`）。
  **实测（修复后 /inject/preview）**：注入面 **1,319 字符 / 23 行**（改前 3,418 字符 ⇒ **−61%**）·
  `agent 画像 = true · 用户画像 = true · 知识索引 = true · 预算留痕 = true` · 对硬顶 1,800 占比 **73%**；
  本会话注入面即带 `（agent 画像另省略 9 行）`＋`（用户画像另省略 5 行）` 双留痕。
  落地：`typecheck`/`build` 零错、`check-runner` 全绿、差异文件已部署、**插件热重载生效（无需二次重启）**。
- **⚙️ 深层归因的五项建议全部执行并逐项验效（2026-09-13）**
  **① 深睡触发松绑**：注册表 `trigger.idleMs` 3h → **45min**（实测 `TRIGGER.idleMs=2700000`；zod 缺省与深睡状态机 `deepsleep-machine` 判据同源派生）。
  **② 深睡门禁留明细**：`/cognition/report` 的 `sleeps[]` 原先只透 `gate` 字符串、把审计里的 `rejectedLines` 丢掉 ⇒ 补 `gateExit/rejected/gateDetail(≤5 条)`（原始审计早已落 `[gate:原因] 行原文`，只是投影把它扔了）。
  **③ 蒸馏失败留成因**：`distill-run` 审计按 fclass 落 `reason`（`dispatch failed=N`/`gate rejected=N`/`json-parse stop=…`/`agent stop=…`）——原 113 条失败行零成因、45% 失败率不可诊断。
  **④ 判据收敛为单一实现**：`isRealUserEvent` 落到 `targets.ts`（同时兼容**事件** `data.source.kind` 与 **消息** `source.kind` 两形态），`distill-chunks`（re-export）/ `distill-activation` / `mcl`×2 / `panel-inject` **四处改为 import 同一函数**；核验旧副本写法清零（消除"同一语义判据四处实现必然漂移"的结构）。
  **⑤ 验收**：`typecheck`/`build` 零错 · `check-runner` **PASS（39 pass · 1 xfail · 0 skip）**（含新增来源过滤回归 9 断言）· 部署 lib 20 件 + engine 3 件 · 热重载生效（未要求重启）。
  **效果实证（本轮亲自触发并核对）**：**手动触发深睡跑通** —— `stop=completed · profiles=3 · pointers=1 · otherDone=4 · landed=true`，记忆库 git 新增提交 **`3b96e67 memory: deep-sleep @ 2026-09-13T04:32:55`**（改动 AGENT.md / MEMORY.md / activity.jsonl / maturation.jsonl / access-real.jsonl / criteria-gate.json）⇒ **巩固域从"停摆"恢复运转**；**AGENT.md 首次产出 `[认知]` 行**（「架构优先 · 先定承载节点再动手」）+ 新 `[边界]` 行（「子代理权限固定」）⇒ P0 补的"表达风格/思维模式"引导词**实证生效**；深睡写入后 **悬空指针仍 0 · 整档写门 `exit=0 允许写入` PASS**。
  **本轮未验到的两项（如实记录）**：`reason` 字段（今日 `dispatch-failed=0`、无失败样本）与 episode 去污（蒸馏触发成功 `sessions:2` 但**零新增** episode ⇒ 无新样本可判）——均留待下次真实失败 / 新会话被蒸馏时复核。
- **🔬 深层归因：来源过滤的「第二副本」被修，转正链数据源去污 75%（2026-09-13）**
  顺着"写侧归类与读侧可得性断裂"往下挖，用原始数据定位到**同一个根因的第二个副本**：
  **① 病灶**：`src/distill-chunks.ts` 的 `textPartsOfEvent` 只按**事件类型**取文本、**不看 `data.source.kind`** ⇒ 宿主注入块
  （`Current runtime context` 运行态快照 / MCL 慢通道材料 / `<system-reminder>`）被当作 `[user]` 文本进入**蒸馏材料**，
  并进一步成为 `episode.intent`。实测 **`episodes.jsonl` 255 条里 190 条（75%）intent 是宿主样板** ⇒
  「同型判定 / 成功计数 / 跨会话计数」的判据基础是脏数据 ⇒ **转正链空转**（`flow-candidates` 无有效候选）。
  而 `distill-activation.ts`（ACT-024）的来源过滤**只作用于采样判定**，不作用于文本化 ⇒ 同一根因两个副本、口径不一致。
  **② 修法（四处统一为同一口径）**：新增 `isRealUserEvent()`（`kind` 缺失=旧格式/夹具 ⇒ 收；`==='user'` ⇒ 收；其余 ⇒ 丢），
  `textPartsOfEvent` 首行调用 ⇒ 蒸馏材料与 episode.intent 同时去污。与 `distill-activation.ts`（ACT-024）、
  `mcl.ts#captureFromEvent`、`panel-inject.ts#taskTextOf` 判据**完全同源**。
  **③ 新增回归门** `scripts/test-distill-source-filter.mjs`（9 条断言：三类注入 kind 全丢 / 旧格式与真实用户全收 /
  **判据是结构字段而非内容**（注入块即使写用户口吻也丢）/ assistant 不受影响 / **水位仍推进到窗口末事件——丢文本不丢 seq**）。
  已登记 `check-runner` 的 `CHECKS`；`check-runner` **PASS（39 pass · 1 xfail · 0 skip）**。
  **④ 同轮查出的链条实况（写入本档备查）**：深睡 20 次运行里 **gate=no-op/空 12 次 · 失败门 4 次（指针悬空/行格式违规/all-rejected×2）· pass 仅 5 次**（成功率 ≈25%），且 **09-11 21:00 之后零运行**（会话持续活跃 ⇒ 3h 全会话停滞门槛不满足）；`ledger` 300 行里 **摄取 234 / 巩固 66（其中 53 是每日自检，真正 consolidate 决策仅 8）** ⇒ 树整编/指针维护/遗忘/[原则]-[路径] 归纳**全部依赖的深睡处于饥饿+低成功率**，这正是先前查出的 13 处超 R 大节、同名主题、67 个零召回主题**无人处理**的原因。
- **🧪 蒸馏链 / 睡眠链 / 职能归类审查 + R1–R3 收口（2026-09-13）**
  **① 库内归类与指针卫生（硬错，走门禁修复）**：写门把**真实库**判为 exit=2——6 条悬空指针（`§node 与包管理`/`§包版本探测`/`§协作与文档治理`/`§视觉还原度验收`/`§ui 布局弹性化`/`§Node`）⇒ 整档编辑被拒；3 行标签越白名单（MEMORY.md 内 `[教训]`×2、`[环境]`）。逐条重指向真实小节 + 标签归位，**经 `memory_write_gate` 校验后落盘**（备份 `~/.dsh/backups/MEMORY.md.bak-*`）⇒ 门禁 PASS、越界 0。
  **② 睡眠链自检的调用口径（真缺陷）**：`sleep-selfcheck.mjs` 的 `run()` 原为 `stdio:'ignore'` 且**不设 cwd** ⇒ 仓侧 `check-criteria`/`check-carriers` 按调用方 cwd 解析相对路径而**恒 fail**，且失败无明细（只落 `exit≠0`）。改 `cwd=仓根` + 捕获输出尾部作 `detail` ⇒ 带 `--repo` 复测 **6/6 全绿（裁决 ok）**。
  **③ 被自检抓出的自身缺陷**：`criteria.json` 的 note 内用直引号 ⇒ **非法 JSON**，`gen-criteria` 静默失败而 `check-runner` 全绿（该轮跑在改动前）——睡眠自检是第一个发现它的门。改用「」并加 `JSON.parse` 决定性验证。
  **④ R2 快通道恒 0（已解）**：`sim` 用 `rows[0]` 测、`hasHighConf` 用 `some(∈高置信集)` 判 ⇒ 两条件锚在不同行。探针改用高置信行 ⇒ 审计首现 `channel=fast · sim=0.662 · hit=[原则]`。
  **⑤ R3 画像行配额（已解）**：`carriers.profile` 4→6（zod 上限）；实测被挡行由 3 降到 1。
  **⑥ R1 词法地板弱（已解）**：真实自然语言提问**词法 0 命中**，与 `criteria-audit ①「判跨任务可复用条目 7 天零真实读命中 = 0%」`是**同一断裂的两面**。实现**预热通道**——MCL 的 async 融合召回（dense 0.7+lexical 0.3，实测 `sim≈0.66` 证明嵌入可用）写 `audit/warm-recall.json`，注入面按 `recallKeyOf` 键复用，**零新增嵌入开销**；离线验证"键匹配则生效、键不匹配不串话"。
  **⑦ R4 存储解耦**：`record-export` 往返闸常绿，但**不执行切换**（数据安全级；单写向与开关已定义，等显式拍板）。
  **门禁**：`typecheck`/`build` 零错 · `check-runner` **PASS（38 pass · 1 xfail · 0 skip）** · 睡眠自检 6/6 · 部署面 140/140 一致 · 插件热重载生效。
- **🔍 质量回归评估（2026-09-13 · 用户要求排查"改动后是否降级"）——查出 4 处真风险并全部修掉**
  以**实证**逐项核（不靠推断）：① 转录里 62 条 `user/message` 的 source 分布 = **user:17 · plugin:43** ⇒ P0 的来源过滤**正确**（真实提问都带 `kind='user'`）；
  ② 直调 `recallIndex` 实测**真实自然语言提问词法召回 0 命中** ⇒ P0 只是**揭穿**了"改前看着有 6–8 行"的真相——那是 query 被宿主注入块顶掉、用自己的注入物召回自己的**回声**。
  **修掉的 4 项**：**(a) 恒定面被裁**（AGENT 15 条索引行 1,138 字符 vs 分档 554 ⇒ 裁掉一半以上，违 I2a）→ 改「**恒定面免裁 + 安全带 4,000**」，变动面 ≤600 / 一次性 ≤200 各有硬顶；
  **(b) 画像行按块配额**（原合并后一次 clamp ⇒ agent 画像一超预算就把 **USER 画像整段挤掉**，preview 实测 `含用户画像段=false`）→ 按块 55%/45%、**块内裁行不丢块**；
  **(c) 位置式回填池用错集合**（分层过滤后 `allMem` 只剩 P 层 ⇒ 新鲜度槽/基线**恒空**，源码自认"回退=回退到空"）→ `q && relOn` 分支内改用 **MEMORY.md 全层行**（有查询才铺，载体契约 A7-1 仍守）⇒ 知识索引 **1 行 → 9 行**（本会话实测）；
  **(d) 台账 v1 是整会话永久去重**（材料被压缩掉后仍记"给过" ⇒ 该记忆对会话失效；被忽略的经验永不再提）→ 改 **轮次窗口去重**（`DEDUP_WINDOW_TURNS=3`，覆盖实测的相邻轮重复形态）。
  另修两处**既有**缺陷：`profileCap` 兜底硬编码 `?? 3` 使注册表 `carriers.profile` 改动**对运行时零效果**（改读注册表）· 画像行择优改为**标签行优先**（`[边界] 宿主服务免动` 位于文件首位、在旧 `slice(-N)` 下**从未被注入过**，现已常驻可见）。
  **附带发现**：`src-client/body.js` 的 `#scpanl-root .sc-pagehead` **顶层重复定义**（v9 UI 未提交工作遗留，被本轮重构建 + CSS 门禁暴露）已合并为唯一规则。
  **验收**：`typecheck`/`build` 零错 · `check-runner` **PASS（38 pass · 1 xfail · 0 skip）** · 差异件已部署 · 插件热重载生效（无需重启）。
- **🎯 v9 视觉对齐（2026-09-13）—— 对照 `deliverables/ui-redesign-v9-2026-09-13.html` 做渲染级复核，修掉一批走样**
  **① 复核方法**（无法看图时的实证通道）：临时件 `.internal/vdiff.mjs` 把**原型页面**与**真实 `client.js`**
  放进同一个无头 Chrome 各自渲染，对语义等价元素取 `computedStyle` + 几何并排比对；颜色再用
  `.internal/tmp-png-sample.mjs`（自写 PNG 解码）**直接采样渲染像素**。两条**计量纪律**先立：
  · 无头虚拟时间下 **CSS transition 不推进**（实测 `getAnimations()` 恒 `currentTime=0`）——首轮读数把
    「选中态导航」误判成透明（像素也读成 `#171719`），实为**测量假象**；两侧统一关动效后复测才为真值。
  · 夹具语法错会让**依赖数据的视图整片空白**（`Unexpected token ']'`），空视图会被误读成「UI 缺块」。
  **② 修掉的走样（改前 → 改后 = 原型值）**：
  · 导航宽 **200 → 216**（`Cfg` 缺省 `navWidth:200` 与方案 `--nav-w:216` 打架，令牌被内联变量压过）
  · 导航内距 12/8 → **14/10/10**；标题字重 400 → **700**、内距 → **0/10/6**（`.nav-title` 规格）
  · 导航项 **34 → 37px**（行高 1.35 → 1.6）、内距 8/12 → **8/10**、间距 8 → **10**
  · 选中态底：`color-mix` 派生（合成 ≈`#2e293d`）→ **实色 `#251f3a`**（新增 `--sc-accent-soft`，两套皮肤各给方案实色）
  · 页头：**随内容滚动 → 固定**（新增 `.sc-headslot`，页头移出滚动容器；实测滚动 156px 后页头 y 恒为 33），
    内距 → **18/24/14**、底分隔线 → `--sc-border2`；`h1` 15 → **17px**、`desc` 12 → **12.5px**、根字号 16 → **13px**
  · KPI：内距 12/14 → **13/14**、`k-top` 12 → **11.5px**、`k-val` clamp 20.2 → **26px**、`k-sub` 12 → **11px**、
    进度条 4px/`#232327`/pill 圆角 → **6px/`#33333a`/3px**（新增 `--sc-border2` 令牌），KPI 行间距 24 → **16px**
  · 内容区内距 18.9/25.2/31.6 → **18.3/24.0/25.2**（≈方案 18/24/26），同级块统一 **16px** 节奏
  · **凸卡体系回归修复**：`.sc-fold` 与 `.sc-mem-stat` 各有**后置 `background:var(--sc-bg1)` 覆盖**，
    把卡面压回页面色（v7 一致性补丁点名过的「大面积发平像线框图」）⇒ 去掉覆盖，卡面回 **`#2a2a2f`**
  · 徽标：31 → **29px**（内距 4/11 → 4/10、字号 13 → 12、边框 → `--sc-border2`）
  · 日志：折叠条 47 → **≤44px**（级别下拉/清空按钮在折叠态隐藏 —— 方案里它们属日志正文工具），
    日志行改**定宽三列**（时间 78 / 级别 54 / 正文 1fr，v7 补丁第 9 条）
  **③ 仍存差异（本轮未动，须用户拍板，不在「已完成」之列）**：① 分段控件仍走组件库 `wa-tab-group`
  （tab 高 43px、下划线式）vs 方案 `.tabs`（28px 胶囊分段）——S3 的组件库决策，改需同步改门禁断言；
  ② 概览页**信息组成**不同：方案概览含 6 张内容卡（成长/delta/时间线/运行态/判据/快捷操作），
  面板概览是「3 操作卡 + 4 KPI + 徽章行」，其余信息分散在记忆/画像/观测页；③ 页头 `acts`（路由 chip + 指南按钮）面板无。
  **验证**：`typecheck` 0 错 · `build` 成功 · `check-runner` **37 pass · 1 xfail** · `ui-geo-regress` **93 PASS / 0 FAIL** ·
  已安装副本 `client.js` sha256 与仓内一致（改前已备份 `.bak-<时间戳>`）· 出图 8 视图 + 原型对照存
  `.dsh-vision-toolkit/artifacts/v9cmp/`。
- **👁 视觉通道打通 + v9 第二轮（结构/层级）对齐（2026-09-13）**
  **① 先修「看不见」这件事**（比 UI 本身更关键）：`read_image` 一直报 `model "deepseek-flash" does not declare
  image input`，我据此判断"没法看图"——**判断错了**。多模态冒烟（合成 640×400 探针图：数字 7391 + 红绿蓝方块 +
  底行英文，直发 `opencode-go-custom` 端点）实测：**当前模型 `deepseek-flash` 全部读对**。真因是
  `~/.dsh/settings.yaml` 该模型条目**缺 `input: [text, image]` 声明**（provider 的 `/models` 不返回模态元数据
  ⇒ DSH 默认按纯文本处理）。⇒ 增量补声明（先备份 `settings.yaml.bak-visioninput-<时间戳>`），**无需重启即生效**。
  与 GOAT 条目 `deepseek/deepseek-v4.1-flash` 的既有注释同因同解。
  **② 出图夹具的解析缺陷**（污染过证据，已修）：`client.js` 含 `<!--` 字面量，**内联**进 `<script>` 会让 HTML
  解析器进入 script-data-escaped 状态、把 726KB 脚本漏成页面文本（出图边缘出现 JSON/CSS 碎片，
  `#scpanl-root` 实测 textContent 106921 字符）。⇒ 夹具改**外部文件 + `src` 引用**（与真实宿主模块加载器同构）。
  **③ 真机看图后的结构/层级修正**（v9 层级 = 页头 → 卡片 → 卡内小节 → 行）：
  · 新增**卡片层原语 `UI.card()`**（`.sc-card/.sc-card-hd/.sc-card-bd` = v9 `.card > .hd/.bd`：卡头 11/14 ·
    12.5px/620 · 底分隔 `--sc-border2`；卡体 13/14）；记忆板块「蒸馏运行/记忆库状态/向量召回」**由分节标题升级为卡片**
  · 卡内**不再套卡**（v9 卡体是纯列）⇒ `.sc-card-bd .sc-mem-stat` 去边框/底色/内距
  · 卡内首末元素边距归零（实测卡体 221 = 内容 163 + 内距 26 + **网格上 8/下 24**，底部多出 24px 暗带 → 修后 189）
  · 页头新增**路由 chip 行**（`UI.pageHead(t,d,{routes})`；10 个视图接真实端点，路径取自契约 34 条路由）
  · KPI 顶行补 **7px 状态色点**（v9 `.k-top` 的点；`.sc-dot.ok/warn/err/info` 四态，`fill()` 同步点色）
  · 状态徽章：**变化段加粗**（v9 `标签 <b>值</b>`）+ `ended` 由灰转**绿语义底**（v9 `.badge.ok`）
  · 概览「待处理」告警**红改琥珀**（v9 `.alert.warn`；红只留真错误）· 数字千分位（`3,204` / `3,100 / 5,000`）
  **④ 更正上一轮一处错误结论**：此前写「面板概览缺 6 张内容卡」是**夹具语法错致视图空白**造成的误判；
  实际含「本月成长 + 系统状态」，只是组织方式不同（v9 为两栏卡片 + 卡头路由 chip）。
  **⑤ 仍存差异（待拍板）**：① 分段控件走组件库 `wa-tab-group`（43px 下划线式）vs v9 `.tabs`（28px 胶囊分段）；
  ② 页头右侧**搜索框 + 刷新按钮**未做；③ 概览「本月成长/系统状态」未做成 v9 的两栏卡片。
  **验证**：`typecheck` 0 错 · `build` 成功 · `check-runner` **38 pass · 1 xfail** · `ui-geo-regress` 绿 ·
  已安装副本 sha256 一致 · 逐图复核（`panel-*.png` ⟷ `v9-*.png`）。
- **🧩 逐页卡片级对齐 · 插件集合页（2026-09-13）**
  **① 先修「夹具是假的」这个更严重的问题**（用户直接指出）：该页原夹具是空 `'/suite': { members:[] }` ⇒ 面板只渲染
  「无成员数据。」；我随后**按原型的示意数据编了 3 个成员**（managing-memory / shoucang-core / scheduler）当夹具
  —— 等于**照原型的假数据对页面**，属我自己批过的"假绿"。现改为**抓真机响应**：新增 `.internal/fetch-fixture.mjs`
  取 18 个**只读**端点的真实响应（绝不触碰 trigger/run/save 等写端点）→ `.internal/fixture.json` /
  `.internal/fixture.js`；出图、块级对照、几何测量**统一用这份真数据**。
  **真机事实**（`/suite` 实测）：**只有 1 个成员** `shoucang`（`dsh-shoucang-memory`，role「self（单插件仓：默认自检装配状态）」，
  status=profile，profiles=[web]）；summary「共 1 成员（present 1 / missing 0）; 基准: injected registry 0 项, profiles 3 个」。
  **② 按 v9 的**真实 markup**（不是截图目测）逐项对齐**（读 `deliverables/ui-redesign-v9-2026-09-13.html` 该页源码）：
  · 路由 chip 改为**内联在 desc 句末**（v9：`<p>…共用。<span class="src">/suite</span></p>`）⇒ `pageHead` 新增 `routesInline`；
  · 卡片 = `.ph`(图标 + `<b>名称</b>`) → 行内小灰字描述 → **`.pmeta` 两个纯文本灰 span**（上一版错用了 status **胶囊**，组件不一致）；
  · 表格列/值/组件按 v9：目标库名**去 `.md`**（MEMORY / USER / AGENT）、无容量门行写 **`不限` + `N 条`**、
  状态为 **`<span class="pill ok">`**（新增 `.sc-table .pill` 样式 1:1 复刻 v9 的 `.pill`：11px / 2px 8px / 20px 圆角），
  并补上 **`notes/`（便签）与 `archive/`（归档）两行** —— 真数据：notes 8 条、archive 2 条。
  · 越界改动已回退：我曾改 `SUITE_STATUS` 文案（`✓ profile` → `✓ profile 装配`），被 `test-ui-derive` 的 **D7 契约断言**抓住 ⇒ 回退。
  **③ 真数据下的块级对照**：原型 `.view` = `.grid2` + `.card`；面板 = `.sc-pgrid` + `.sc-card` —— **逐块同构**
  （卡片数差异源于"真机 1 成员 vs 原型示意 3 成员"，非样式差异）。
  **④ 仍与原型不同（真实差异，非走样）**：· 卡片 meta 左 span：原型是"5 工具"（示意），`/suite` 无工具数字段 ⇒ 显示 repo；
  · 表格状态 pill：原型示意数据全绿「正常」，面板按**真实阈值**算（82% / 62% / 66% ⇒ 琥珀「水位偏高」）——要改成"这些水位算正常"属阈值产品决策，未擅动。
  **⑤ 验证**：`typecheck` 0 错 · `build` 成功 · `check-runner` **39 pass · 1 xfail** · 安装副本 sha256 一致 ·
  `deliverables/v9-compare/index.html` 已用**真数据**重生成。
  **② 块级实测差**：原型 `.view` = `.grid2`（成员卡网格）+ `.card`「suite 装配矩阵」+ 表格；面板 = **`UI.item` 行式列表**。
  **③ 按原型重写**：页头（标题 + 原型 desc 原文 + `/suite` chip + **右侧「重新装配」按钮**；`pageHead` 新增 `actions` 位）
  → **卡片网格**（每成员一张 `.sc-pcard`：图标 + 名称 + 角色描述 + meta「包名 · 装配明细」+ 状态徽章）
  → **虚线「添加目标库」卡**（非动作卡：登记走后端白名单）→ **「suite 装配矩阵」卡**（卡头 + `GET /suite` chip +
  表格：目标库 / 容量 / 已用 / 装配内容 / 状态 pill + summary 注脚）。矩阵行取自 `/memory/overview` 的 indexes（真实字段），
  `archive/` 行取自 `/cognition/report` 的真实归档清单，**端点不可用则不出行（宁缺勿造）**。
  **④ 复验**：块级对照由「列表 vs 网格+卡」变为**逐块同构**（`.sc-pgrid` + `.sc-card` ⟷ `.grid2` + `.card`）；
  `typecheck` 0 错 · `build` 成功 · `check-runner` **39 pass · 1 xfail**（先抓到一处 D7e：`!ar.length` 惯用法，
  按仓库规范改用 `Derive.has`）· 安装副本 sha256 一致 · `deliverables/v9-compare/index.html` 已重生成。
- **🧭 v9 第四轮（2026-09-13）—— 补上缺失的**块级**对照，按原型重排页面组成**
  **① 根因**：前三轮只对了**原子**（色彩/间距/圆角/卡片样式），**块级组成**从未系统对照过 —— 所以用户仍判
  「完全不一样」。本轮新增 `.internal/blocks.mjs`：把**原型 `.view` 直接子块**与**面板 `.sc-view` 直接子块**
  并排拉出（类名 + 尺寸 + 首段文字），逐页定差异。
  **② 块级实测结论**（原型 ⟷ 面板）：
  · **记忆库**：原型 `.view` = **1 张卡「容量占用」**（三列容量 + 口径说明段 + **卡内 tabs** + 卡内小节 + 行）；
    面板 = **页级 `.sc-tabbox`** 包 7 张卡 ⇒ **层级反了**。已按原型重排：页头 → 卡「容量占用」{ 三列容量
    （MEMORY.md 容量带条 / pending 候选 / 待归档会话，无门者给 na 虚线槽）· 口径说明段 · tabs } → 卡内小节标题 + 行。
    卡内**不再套卡**（原型卡内是标题）；状态徽章行移到卡**之前**（页级条带）。
  · **画像**：原型把 USER.md / AGENT.md 各做成**一张卡**（卡头 + 路由 chip + 卡体指针行）+ 末尾 `bp-note`；
    面板原为「分节标题 + 裸列表」⇒ 已卡片化并补注脚（原型另有 `stat2 USER 构成` 与 `成熟度分布` 两块，面板无数据源，未造）。
  · **深睡**：原型 6 张卡（状态机 / 状态分布 / 产出回执 / 材料预估 / 最近会话 / 睡眠期自检）；
    面板的认知报告分区此前是**标题**⇒ 改按页面出卡（`renderCognitionReport` 的 `group` 随 mode 出卡/出标题）。
  · **参数/设置**：原型 `.tabs → .pane.on`（行式平铺），面板 `.sc-tabbox → pane` ✅ 同构，未动。
  · **运行总览**：原型 badges → alert → 3 操作卡 → 4 KPI → **两栏卡片**，面板 ✅ 已同构。
  · **运行观测**：原型 = 4 KPI → 执行进度卡 → `.tabs`（调用日志/错误定位/运维操作）；面板 = **6 个折叠条** ⇒ 组成仍不同（待做）。
  **③ 层级决策**（写进源码注释）：`group()` 出**卡片**还是**标题**随页面定 —— 原型用 `.card` 表达**同级区块**，
  用标题表达**卡内分区**；此前"一律卡片化"会把卡内分区也变成卡（卡中卡）。
  **④ 过程中又抓到两个自己引入的真 bug**：`var f = function(){}` **提升前调用**（记忆页渲染中断、卡片只剩卡头 71px）；
  列表页 `view.insertBefore(badges, cap.box)` 的挂载点归属。
  **⑤ 验证**：`typecheck` 0 错 · `build` 成功 · `check-runner` **39 pass · 1 xfail** · 安装副本 sha256 一致 · 逐图复核。
  **① 分段控件改用 v9 胶囊分段，但不动组件库与门禁**：先**实测** shadow 部件名（`wa-tab-group::part(base/nav/tabs/body)`、
  `wa-tab::part(base)`，不猜 API），再据此改造——外框 `--sc-bg1` + 1px 边 + 8px 圆角 + 2px 内距；
  tab 28px 胶囊（内距 0/14 · 12.5px · 圆角 6）；激活项 `--sc-bg-card` + shadow-1；
  **下划线指示器关掉**（`--indicator-color:transparent`）。几何实测：wa-tab 45 → **30px**（v9 tab 28 + 边框）。
  S3 的 `wa-tab-*` 门禁断言与 `check-css-usage` 白名单**零改动**。
  **② 页头补 v9 的右侧动作区**：`UI.pageHead(t,d,{search,refresh})` —— 搜索框（图标 + 输入，窄屏自适应）
  + 刷新按钮；搜索接 `filterViewRows()`（复用既有 `.sc-filtered` 语义，只过滤列表行，不碰折叠态）；
  页头改为 `sc-ph-main` + `sc-ph-acts` 两栏（弹性，非定宽）。已接：总览/记忆库/运行观测（+10 视图刷新）。
  **③ 概览「本月成长 / 系统状态」改 v9 两栏卡片**：`.sc-cols2` 网格 `minmax(0,1.3fr) minmax(0,1fr)`（≤900px 堆叠），
  卡头带路由 chip（`/memory/overview · growth` / `/mcl/status · /inject/stats`）；卡体内数值网格列宽下限
  168 → 120px（否则 1.3fr 卡宽 ~540px 下三块被挤成两行）。
  **④ 其余视图收口**：深睡/运行观测的分节标题同样升级为卡片（`group2` 返卡体）；导航脚 = v9 `.nav-foot`
  状态块（状态点 + 记忆库 + 状态词 + 副行），由 `/memory/overview` 与记忆页各自的数据回填（零新增取数）。
  **⑤ 过程中抓到并修掉两个自己引入的真 bug**（`[原则] 静默失效查被吞异常`）：
  · **页头被嵌套调用覆盖**：设置页页头显示成「配置原文」（同一次渲染里第二个 `UI.pageHead` 抢了固定槽）
    ⇒ 加**渲染轮次**（`headEpoch/headUsed`），每轮只认首个页头，嵌套调用返回游离节点。
  · **卡片挂错根**：分节卡首版挂 `host`（第二张卡挂进第一张卡体=卡中卡）、二版挂固定 pane
    （把 index/pending/notes 的卡全塞进 run pane）⇒ 改为**向上找 `.sc-tabpane`** 挂载。
    实证：卡片探针 `depth=1` 且非活动 pane 的卡 `0x0`（隐藏正确）。
  **⑥ 门禁与部署**：`typecheck` 0 错 · `build` 成功 · `check-runner` **38 pass · 1 xfail** · `ui-geo-regress` 绿 ·
  安装副本 `client.js` sha256 一致 · 8 视图逐图复核（`panel-*.png` ⟷ `v9-*.png`）。
- **🧩 S3 续 5（2026-09-13）—— `wa-select` 二度尝试后**再次回滚**；并修掉我自己的一个假绿断言（存在 ≠ 渲染）**
  **① 本轮做了什么**：为消除上轮回滚的判因（箭头渲染不出来），先**补前置**——引入 `wa-icon` 并用
  `registerIconLibrary('default', …)` 把 resolver 指到**内联 SVG 的 data URL**（该安装包无 `dist/assets/icons`），
  然后重新采用 `<wa-select>`。构建通过、几何断言当时**全绿**。
  **② 视觉复核（像素穷举）推翻了上面的"全绿"**，三条判据：
  · **箭头没画出来**——shadow DOM 里**确实有 `<wa-icon>` 元素**，但**渲染尺寸 0×0**；像素扫描文字右侧全空。
    ⚠ 根因是**我的断言写弱了**：只验"元素存在"（`!!shadowRoot.querySelector('wa-icon')`）⇒ **假绿**。
  · `::part(combobox)` 填充**未生效**（实测填充 = 卡片底色，与同排数字输入"一亮一暗"）——**部件名是我照经验猜的**，未先核对组件导出面。
  · 宽度失控：控件 173px（原 ~66px），左缘与同排输入不再对齐。
  **③ 处置：二度回滚为原生 `<select>`**（三项都对），并把判因与两条教训写进源码注释；
  图标库注册**保留**（无副作用、是任何 WA 图标的前提），但注释如实标注「**注册了 ≠ 图标能渲染**，图标可用性尚未证实」。
  **④ 把"存在 ≠ 渲染"固化成断言**：几何探针新增 `rendered(el)` 工具（`bbox 宽高 > 0` 才算渲染），
  并加一条「**零 `wa-select` 残留**」断言——回滚不彻底即红；任何"组件是否真画出来"的判据今后都必须走渲染尺寸。
  **⑤ 回滚后视觉复核 4/4 通过**（像素级）：箭头出现（V 形，距右内缘 11px）· 下拉填充与同排数字输入
  **逐像素相同**（`rgb(23,23,25)`，Δ=0）· 日志筛选下拉箭头可见 · 宽度回到内容自适应 **66px/80px**（不再是 173px 宽块）·
  右缘 x=1214 与输入/卡片内容线对齐。（复核另报一处**非本轮**差异：两个数字输入自身宽度 120 vs 140px，仅记录。）
  **验证**：`ui-geo-regress` **93 PASS / 0 FAIL** · `check-runner` **37 pass · 1 xfail** · 安装副本已同步。
  **结论（不粉饰）**：`wa-select` 采用**未成功**（两轮皆回滚），且暴露出我此前"以元素存在代替渲染"的检验漏洞——
  这正是"视觉实证不可省"的又一实例。后续要采用须先证明**图标真能渲染**（render-size 断言），再谈替换。

- **📘 架构档与发布前置同步（2026-09-13）—— AGENTS.md 此前仍描述旧结构，本轮更新到 S1–S4 真实形态**
  **判因**：本轮把 client 改成「源码 + 构建产物」、加了 6 件 UI/契约门禁、换了组件与主题机制，
  但仓内**架构主文档 AGENTS.md 仍写旧结构**（`client.js` = 手写前端源；"31 件登记于 CHECKS"）——
  文档漂移会直接误导后续开发（"架构档是开发主地图"是仓内既有纪律）。
  **更新四处**：
  ① 结构表拆行：`src-client/`（entry/vendor/body/契约生成物）与 `client.js`（**产物·禁手改**，esbuild 单 IIFE ~640KB + 门禁锚点 `window.__SC_CSS__`）；
  ② `scripts/` 行：**31 → 37 件**，并新增「UI/契约门禁（S1–S4 重排新增）」条目（ui-geo-regress / check-layout-px /
  check-panel-contract / gen-panel-contract / test-route-schema / check-installed-features，逐件注明守什么）；
  ③ **新增规则 7「发布前置 / 每阶段验收口径」**（标题同步 6 → 7 条）：typecheck 零错 + build 成功 + check-runner 全绿 +
  **渲染级证据**（几何回归，附"CSS/结构门禁对挤出首屏/组件没渲染天然失明"的理由）+ 契约与产物三向一致 +
  **装上去的那份带着本轮能力**（特性标记）；明写「任一条红即未完成」「仓内绿 ≠ 运行态绿」；
  ④ **新增「UI 架构（S1–S4 重排后·现状）」小节**：壳与插槽（互斥）、两套皮肤与令牌桥/尺寸层接管、流体布局与容器级禁裸 px、
  组件采用现状（Tab/按钮/开关已换；`wa-select` 因缺 `wa-icon` 回滚）、RPC 契约链路。
  **顺手修掉两处自相矛盾**：规则区标题仍写"6 条"（实为 7）；常用命令里 `build:client` 仍写"复制 client.js"（实为「生成契约 → esbuild 打包 src-client」）。
  **验证**：`check-runner` **37 pass · 1 xfail**（AGENTS.md 仅被 `test-targets` 在注释中引用，不解析，故编辑安全）；
  安装副本无需同步（`AGENTS.md` 不在发布 `files` 内，属预期：部署 0 差异）。

- **🧪 检测件运行器：失败输出不再被吞（2026-09-13）—— 把"查不动的抖动"变成"可诊断的一次失败"**
  **判因**：`test-forgetops` 在两次全量跑里转红，而运行器只打印**文件名**——因为它在跑检测件时用
  `stdio: 'ignore'`，**子进程输出被直接丢弃** ⇒ 只见"某件失败"，不知断言与真因（属"静默失效"家族）。
  **先纠正自己的错误记录**：我先前推断"该件与运行中的调度器共写知识区目录导致竞态"——**不成立**。
  实读其源码：它自建 `mkdtempSync(join(tmpdir(),'forgetops-'))` 夹具、读写全在自己临时目录里，**是自洽测试**。
  **复现尝试**：连跑全量 **6 次**（含 Chrome 重件）**均未复现** ⇒ 抖动真实存在但极罕见，且**当时无输出可查**。
  **本轮改动（让它可诊断）**：`check-runner` 改为捕获子进程 stdout+stderr（`stdio:['ignore','pipe','pipe']`），
  失败时**打印末 25 行**并**把全文落盘**（给出 `shoucang-runner-<件名>.log` 路径）；**绿色运行仍不打印**（无噪音）。
  **反向证伪（证明不是"加了等于没加"）**：造一个故意失败的探针件登记进 CHECKS，实测 5 条全中 ——
  ① stdout 可见 ② stderr 可见 ③ 落盘路径已给出 ④ 落盘文件确实存在 ⑤ 失败仍按失败上报（未被诊断输出掩盖）；
  随后**自动还原**（删探针件 + 复原 CHECKS），复跑全量 **37 pass · 1 xfail** 确认工作区干净。
  **顺带记一条我自己的错法**：补 `writeFileSync` 的 import 时，我用"整文件是否出现该标识符"来判"是否已导入"，
  结果被**我刚写进去的调用**骗过 ⇒ 漏加 import、落盘静默失败（catch 吞掉）。
  这与本轮前几轮的"手写成员名单自证"同族：**判定"是否已存在"必须限定作用域（只看 import 区）**，不能全文匹配。
  **结论**：抖动本身**未定位**（6 次未复现，如实记录，不假装修好）；但下次发生时会**自带断言与堆栈**，
  不再需要靠猜。已两次记录在案，若再出现即可凭落盘日志一轮定位。

- **🧩 S3 续 4（2026-09-13）—— 表单控件组件化：开关采用 <wa-switch>；下拉试做后回滚（附视觉实证）**
  **① 开关：手写 checkbox → 组件库 `<wa-switch>`（采用）**。契约读自 `switch.d.ts`：`checked` 属性 + `change` 事件、
  parts `switch/control/thumb/label`、`@cssproperty --width`。API 与 3 个调用点零改动（`toggle(checked,onChange,label)`）。
  旧实现挂的 `.checkbox-container` 类随之退役（CSS 审计确认无对应死规则）。
  **② 下拉：`<select>` → `<wa-select>` 试做后**按"保观感"回滚****。视觉复核实测两处退化：
  · **丢了展开箭头**——WA 的箭头是 `<wa-icon>`，需另行引入图标组件与图标资源（本轮未纳入）；
  · 填充色与同排数字输入不一致（一个像亮框、一个像暗槽）。
  原生 select 的箭头/尺寸/一致性都对，故回滚；要正经接入 WA select 须把图标组件一并纳入，属**独立一步**（理由写进源码注释）。
  **③ 视觉复核（改前→改后，像素级）**：
  · 开关圆点曾是**深色**（`#2A2A2F`，观感像"胶囊上挖了个洞"）⇒ 走公开扩展点 `::part(thumb)` 定白 + `--width` 加宽，
    复核实测**纯白 `#FFFFFF`**、紫轨 `#A78BFA`、标准滑块形态、上下内嵌无裁切；
  · 下拉箭头恢复（`⌄` 9×5 像素簇 `#888888`，与数字输入同高 30px、同边框、**右缘同为 x1214**）；
  · 复核同时**排除了两处误报**：卡片表头本就不画分隔线（两卡一致）、总览按钮与三卡与改动前完全相同。
  **④ 断言同步（组件替换必须由渲染断言背书）**：设置页新增 5 条 —— `wa-switch` 数量、**switch shadowRoot 存在**、
  **开关值已绑定**（首个 `checked=true` 与默认配置一致）、原生 select 数量、**下拉值已绑定**（首个 `value=comfortable`）。
  另修掉一处探针口径错误：`shadow` 字段原先要求"开关且下拉都有 shadowRoot"，下拉回滚后必然误红 ⇒ 改为只判开关。
  **⑤ 遗留（如实记录，未擅自改）**：开关右缘比输入/下拉**内缩 6px**（x1208 vs x1214）、轨道高 16px 相对 30px 输入族偏矮；
  均属轻微、非阻断，待后续与方案确认是否统一右基准线。
  **验证**：`ui-geo-regress` **91 PASS / 0 FAIL** · `check-runner` **37 pass · 1 xfail** · CSS 审计 PASS（0 死规则）·
  安装副本已同步。（旁记：`test-forgetops` 本轮全量跑又抖动一次，单独跑 30/0、复跑即绿——**已两次记录**，
  疑与运行中调度器共写知识区目录有关，建议单独一轮加隔离/重试护栏。）

- **🔌 S4 收口 + 部署链特性探针（2026-09-13）—— 修掉一条会误拒的契约；安装副本核对升到特性级**
  **① 修掉一条**我方写错**的契约（真会误拒合法请求）**：`/embed/config` 在 panel-inject 里是**白名单补丁**
  （`EMBED_CONFIG_KEYS = ['embedEnabled','embedBaseUrl','embedModel','embedApiKeyEnv']`，与 deepsleep/distill 同款，
  只提交变更子集、空补丁才 400）。上一轮我按"handler 读了 baseUrl"就写成 `required:['baseUrl']` ⇒
  **"只改 apiKey"的合法补丁会被 400 掉**。已改为按白名单构造的补丁契约、去掉 required；
  并把 `EMBED_CONFIG_KEYS` 导出到契约模块，纳入漂移门禁（现覆盖**三份**白名单：深睡 5 / 蒸馏 10 / 嵌入 4）。
  教训记下：**契约的准绳是 handler 语义（补丁 vs 全量），不是"顺手扫到的字段名"**。
  **同时收紧一处**：`/embed/test` 的 handler 首行就 `if (!raw) return 400 'baseUrl required'` ⇒ 契约补
  `required:['baseUrl']`（`apiKey` 保持可选——本地 Ollama 无需密钥）。
  **② 新增「已安装副本特性标记」探针 `scripts/check-installed-features.mjs`（已登记 CHECKS · 报告态）**：
  判因：`check-installed-sync` 只比**文件级** sha 一致，回答不了「装上去的那份**确实带着本轮所有能力**吗」——
  本轮就出现过新产物 `lib/panel-contract.js` 未纳管、差点漏拷、装上即 import 失败的风险。
  本件按**特性标记**核对已安装产物，14 项：S2 插槽两条 + 互斥、S3 组件库/主题层/尺寸标尺接管/Tab 组件化/按钮组件化、
  S1 皮肤机制与 CSS 稳定锚点、S4 共享契约注入客户端/预检/host 侧契约模块与 34 路由。
  **实测：已安装副本 14/14 标记齐全**。报告态（环境侧 push/热重载滞后不判代码红），
  并在末尾打印**重启 DSH 后的真机核对清单**（单一入口 / 设置中心守藏分区 / 皮肤切换 / 组件观感 / 日志折叠）。
  **验证**：`typecheck` 零错误 · `build:host` + `build:client` ✓ · `check-panel-contract` **5/0**（三份白名单一致）·
  `check-runner` **37 pass · 1 xfail** · 安装副本 `lib/` 135 件一致 · 内容不同 0 · 特性标记 14/14。

- **🔌 S4 续 2（2026-09-13）—— 契约表导出为「前后端共享产物」，客户端真正消费（发请求前预检必填）**
  **① 生成器 `scripts/gen-panel-contract.mjs`（三份产物，全部禁手写）**：
  源 = `src/panel-contract.ts`（经 `lib/panel-contract.js` 读取，唯一事实源），字段类型**从 schemastery 内省派生**
  （`.dict` + `.type` + `meta.required`，不手写第二份）：
  · `src-client/panel-contract.generated.js` —— **客户端消费**（随 client bundle 打包）
  · `lib/panel-contract.json` —— 机读产物（外部工具/审计）
  · `deliverables/panel-contract.md` —— 人读文档（34 行路由表：路径/说明/必填/字段类型）
  生成已挂进 `build:client` 的**阶段 0a**（先于打包；其源是 host 产物 ⇒ 隐含要求先 `build:host`，`npm run build` 本就是该顺序）。
  **② 客户端真正消费（这是"共享类型"的落地，不是摆一份 JSON）**：`entry.js` 把契约挂 `window.__SC_CONTRACT__`，
  `api()` 在**发请求前**预检必填字段 ⇒ 缺字段**本地即拦**（`preflight_missing_field` + 明确 detail + 告警日志），
  不再等后端 400 一个来回；错误信息与后端同源（字段名一致）。
  **③ 新鲜度门禁**：`gen-panel-contract.mjs --check`（已登记 CHECKS）重算三份产物与磁盘比对，
  手改生成物、或改了契约表忘了重新生成 ⇒ **翻红**；生成逻辑只在生成器一处，门禁不复制它。
  **④ 实测共享产物确实到达客户端**：`ui-geo-regress` 新增 3 条断言 —— 客户端侧契约存在且**34 条**、
  `/save` 必填 `text`、`/save` 字段带类型（`text:string`）⇒ 证明是真实数据而非空壳。
  **⑤ 本轮被仓内既有纪律抓到两次（都是真问题）**：
  · 反模式锁 **D7e**：我写的 `!c.required.length` 裸判空被 `test-ui-derive` 当场判红（x 缺失时会直接抛错），
    已改仓内惯用法 `Derive.has(c.required)`；
  · **ASI 陷阱**：`ui-geo-regress.mjs` 是省略分号风格，我插入的断言行以 `/text:string/` **行首正则**开头 ⇒
    被解析成上一句的除法而语法错误，已改 `indexOf`（本会话第二次踩 ASI，第一次是行首 `(`）。
  **验证**：`typecheck` 零错误 · `build:host` + `build:client` ✓ · `check-runner` **36 pass · 1 xfail**
  （新增产物新鲜度件）· `ui-geo-regress` **77 PASS / 0 FAIL**（含 3 条共享契约断言）· 安装副本 135 件一致 · 内容不同 0。
  **S4 待续**：`/embed/test` 等端点 `required` 收紧；把「契约 100% 覆盖 + 产物新鲜」列入发布前置清单。

- **🔌 S4 续（2026-09-13）—— 契约表收敛为单一事实源（全 34 路由）+ 漂移门禁「凡读 body 必须有契约」**
  **① 新增 `src/panel-contract.ts` = 全量路由契约表（唯一事实源）**：34 条路由的 path/摘要/契约集中一处；
  config 域原本散在本地的 5 条契约**改从该表取**（`contractFor(path)`），inject 域 7 个写端点、observe 域 2 个白名单补丁端点
  一并接入 ⇒ 三域同一个来源，不再各写各的。
  **字段名一律取自 handler 的实际读取**（`String(body.x)` 逐个核对）：inject 域 7 个端点全部按 string 处理（含 `line`——
  它也是 `String(body.line)`，不是数字），避免凭直觉写 schema 造成误拒。
  **② 新增漂移门禁 `scripts/check-panel-contract.mjs`（已登记 CHECKS，4 条断言）**：
  · ① 契约表 ⟷ 实际注册**双向一致**（源码 `route('<path>')` 集合 vs 产物 `PANEL_ROUTES`，一侧多/少即红）
  · ② **凡 handler 读请求体的路由必须有契约** —— 该条**从源码推导**：取注册行被委托的函数名 → 花括号配平取**精确函数体** →
    命中 `readBody(` 则要求注册行带 `contractFor(...)`。**不维护手写名单**（本会话已两次因手写名单自证而漏）。
    首版用固定 1800 字符窗口 ⇒ 跨到邻接函数造成 **6 处误报**，已改精确截取。
  · ③ 配置补丁白名单不漂移：契约模块导出的 `DEEPSLEEP_CONFIG_KEYS`(5) / `DISTILL_CONFIG_KEYS`(10) 与 `panel-observe.ts`
    里的实际白名单**逐键比对**（深睡那份是内联数组，单独比）。
  **③ 反向证伪（证明门禁不是装饰）**：临时拆掉 `/save` 的契约 ⇒ 门禁**翻红**并点名 `/save`；恢复后复绿。
  **④ 部署链路的真风险（本轮排查出来并处理）**：新产物 `lib/panel-contract.js` 是运行期 `import` 依赖，
  而未纳管的文件不会被部署脚本（基于 `git ls-files`）复制 ⇒ **安装副本缺它就会 import 失败**。
  故把 5 个新文件 `git add` 纳管后部署，并逐个核对安装副本：`lib/panel-contract.js` 存在且与仓内**内容一致**（`lib/` 136 件）。
  **验证**：`npm run typecheck` 零错误 · `build:host` ✓ · `check-runner` **35 pass · 1 xfail**（新增契约漂移门禁）·
  `check-panel-contract` 4/0（含反向证伪）· 安装副本一致 134 件。
  **S4 待续**：把契约表导出为**共享产物**（JSON/类型，供客户端与文档消费）；`/embed/test` 等端点的 `required` 收紧；
  最终把「契约 100% 覆盖」作为发布前置条件。

- **🔌 S4 首批（2026-09-13）—— RPC 契约化：把「这条路由收什么」从注释变成可执行约束**
  **判因**：34 条手写路由此前**只有注释说明**收什么参数；喂错数据不会显式失败，而是在 handler 深处退化成
  「参数为空但返回 200」的**假成功**（与仓内「假绿」教训同族）。
  **机制（在既有绑定器上扩展，不新建框架）**：`RouteContract = { body?: BodySchema; required?: readonly string[] }`，
  `route(sub, handler, contract?)`；校验前置：不合法 ⇒ **400 且不进入 handler**，并留 `logger.warn` 可观测；
  只读 GET 端点不声明契约 ⇒ **行为与旧版完全一致**（零风险接入）。
  **实测语义（先测后写，不猜库）**：schemastery **类型错会抛**（`$.path expected string but got 123`）、
  **缺字段不抛**（`z.object({path:z.string()})({})` 返回 `{}`）⇒ 故契约把「类型」与「必填」分成两层。
  **顺带修掉一个真隐患**：校验会先读一次请求流，若 handler 再读一次会拿到**空对象**（参数全丢）——
  故 `readBody` 加**请求对象缓存**，后续调用返回同一份；这条已写成测试断言（见下）。
  **本批覆盖**：config 域 5 个写端点（`/root/bootstrap` `/set_root` `/save` `/toggle` `/set`）声明契约，
  字段名逐个取自 handler 的**实际读取**（`path/name/text/key/value`），不凭想象添加（避免误拒正常请求）。
  **客户端**：`api()` 失败信息优先取服务端 `detail`（如「缺少必填字段：path」）并保留 `httpStatus`，
  否则状态栏只剩一句 `invalid_request`，用户无从下手。
  **新增测试 `scripts/test-route-schema.mjs`（已登记 CHECKS，11 条断言）**：
  ① 缺必填 ⇒ 400 且 **handler 不被调用** + 有告警；② 类型不符 ⇒ 400 且不进入 handler；
  ③ 合法请求不误伤 **且 handler 仍读到完整 body**（缓存回归）；④ 无契约路由行为不变；
  ⑤ 重复路径守卫仍在（宿主 duplicate route 会让插件树整体加载失败）；⑥ 无 body 的只读请求正常。
  **踩坑记录**：夹具最初喂**字符串**分片，`readBody` 内部 `Buffer.concat` 抛错被兜底成 `{}`，
  导致②③ 假红 —— 夹具必须喂 `Buffer.from(...)`（产品侧对真实请求行为不变）。
  **验证**：`npm run typecheck` 零错误 · `npm run build:host` ✓ · `check-runner` **34 pass · 1 xfail**
  （新增 test-route-schema）· `ui-geo-regress` **77 PASS / 0 FAIL**；安装副本已同步。
  **S4 待续**：memory / observe / inject 三个域的写端点接入契约；契约表导出为**共享类型产物**（供客户端与文档消费）；
  覆盖完成后把「凡读 body 的路由必须有契约」升级为硬门禁（当前是分批接入阶段，硬门禁会误伤未接入域）。

- **🧩 S3 续 3（2026-09-13）—— 接管组件库尺寸层（前置条件达成）→ 按钮替换重做成功；文字色硬伤定位并修复**
  **① 尺寸层接管（上一轮回滚的真正原因，本轮解决）**
  查清 WA 的尺寸层结构：**字号/间距/圆角全部由三个 scale 令牌派生**
  （`--wa-font-size-m = 1rem × --wa-font-size-scale`；`--wa-space-m = 1rem × --wa-space-scale`；
  `--wa-border-radius-m = 0.375rem × --wa-border-radius-scale`）。
  上一轮我覆盖的是**派生值** ⇒ 被其 `calc` 覆盖、白做工。本轮只改三个源头：
  `--wa-font-size-scale:.78 /* m≈12.5px，对齐方案 --sc-fs-sm */；--wa-space-scale:.375；--wa-border-radius-scale:1`。
  **实测（异步测量，Lit 组件同 tick 量不到）**：字号 xs10 / s11 / m12.48 / l16px；
  按钮高 **xs 27px · s 30px · m 34px · l 43px** ⇒ 选 `size="s"` = **30px，与手写实现等高**。
  **② 按钮替换重做（这次达标）**：`UI.button` → `<wa-button size="s" variant=neutral|brand|danger appearance=outlined|filled>`，
  `loading` 接管忙态；API 与 13 个调用点零改动。实测 `wa-button ×4`、高 **30px**、三卡同行等高（视觉复核：46×30、y312–341 一致、圆角 5–6px）。
  **③ 文字色硬伤：定位 → 修复 → 机检固化**
  视觉复核抓到「按钮文字是**蓝色** `rgb(110,179,255)` 压 #A78BFA 紫底，对比度 ≈1.2:1，几乎读不出」（WA 的 on 色令牌名是
  `--wa-color-<hue>-on`，我上轮写的 `-on-loud` 不存在）。改用其**公开扩展点** `::part(button)` 显式定色
  （brand/danger 白、neutral 用方案正文色）⇒ 实测标签 `rgb(255,255,255)`、亮度 1.00 ✓。
  **并把这条做成断言**：`ui-geo-regress` 新增「组件按钮标签亮度 ≥0.7」，防止再次静默退化。
  **④ 新增门禁：CSS 花括号配平（本缺陷一轮内复发三次）**
  一条未闭合的规则会把**其后所有规则**吞进它的块里（实测吞掉 87 条，表现为「KPI 4 行 / 操作卡 3 行 / 徽章 7 行」塌陷 +
  审计报 87 个缺样式），而 `node --check` 完全看不见（CSS 是字符串）。现于 `check-layout-px` 抽取 CSS 后**直接数括号**，
  不配平即失败并报差值 —— 本件已在开发中当场抓到一次（`{ 335 vs } 334`）。
  **⑤ 记录（非本轮回归，属方案固有）**：视觉复核实测按钮白字压 `#A78BFA` = **2.72:1**，低于 WCAG AA 4.5:1；
  同源问题还有 `--sc-faint #6E6E76` 系小字（侧栏分组标题 3.00–3.14:1、深度睡眠卡 caption 2.83:1、本月成长小字 3.40:1）
  与警示条红字 4.35:1。**手写实现同样是 2.72:1（此前截图实测白字压同色紫），故非组件替换引入**；
  是否压深品牌紫（建议 `#7C3AED` ⇒ 5.70:1）属**方案取舍**，留待用户裁决，未擅自改动已定稿配色。
  **验证**：`ui-geo-regress` **77 PASS / 0 FAIL**；`check-runner` **33 pass · 1 xfail**；
  `check-layout-px` PASS（花括号 338 对配平）；`audit-css-usage --gate` PASS（死规则 0 · 缺样式 0 · 自有类 162）；安装副本已同步。

- **🧩 S3 续 2（2026-09-13）—— 按钮替换**试做后按纪律回滚**；修掉两处「整块方法消失」；组件库主题层接入并限定作用域**
  **① 按钮：试做 → 实测退化 → 回滚（保留 Tab 替换）**
  把手写 `<button>` 换成 `<wa-button>`（`variant=brand/danger`、`appearance=filled/outlined`、`loading` 接管忙态，API 与 13 个调用点零改动），
  **但真机实测观感退化**：WA 默认**浅色**主题、自带 16px 字号与尺寸层（其 `--wa-font-size-*` 是 `calc` 派生，我们的字号桥被它覆盖），
  按钮实测 **35–43px 高、品牌蓝 `#0071ec`**，与我们 **26–30px 紫色胶囊**的方案观感不符。
  经 4 轮桥接（`wa-dark` 暗色类 + 颜色/字号/间距/圆角令牌桥）仍未收敛 ⇒ **按「每阶段可回滚」纪律回滚按钮**，
  保留：Tab 的组件库替换、整条 esbuild 构建/组件管线、组件库主题层与令牌桥。回滚理由与实测数字写进源码注释，供后续独立一步接手。
  **② 修掉两处「UI 方法整块消失」（严重 · 静态门禁当时全绿）**
  · `UI.kpi`（上轮）：整段切片替换误删 ⇒ 总览 4 张 KPI 全消失（几何回归抓到）。
  · `UI.collapsible`（本轮）：**17 处调用**的方法不存在 ⇒ `TypeError: UI.collapsible is not a function`，**设置/观测等多视图渲染中断**
    （视觉表现为「设置页标签下方整片空白」，页面头与空标签条仍在，因此"渲染非空"断言看不出问题）。
    两处均从备份精确回补。**根因同族：切片式替换靠注释锚点猜边界**。
  **③ 门禁升级：手写成员名单 → 派生式一致性检查**
  上一轮我加的「UI 成员表完整」用的是**从（已损坏的）源码里抄来的名单** ⇒ 自证式检查，两次都漏。
  现改为**从调用点反查定义**：凡源码出现 `UI.x(` 的，UI 对象必须有 x（定义侧从 UI 对象花括号切片内取键，避免误收同名）。
  实测报「用到 14 个，均已定义」，任缺一即红。
  **④ 组件库主题层接入 + 作用域收口（这是按钮替换真正的技术障碍，先解决掉）**
  · 只 import 组件、不引入其**主题令牌层**时，`--wa-color-*` 全部未定义 ⇒ 组件算出透明底 / 0 边框 / 0 内距
    （实测点：按钮 `84×30` 紫胶囊退化成 `29×14` 裸文字——**视觉复核抓到的**）。
  · 现于构建期 `@import` 递归展平 `themes/default.css`（+调色板，62KB）→ 生成 ESM 文本模块 → 运行时用**独立 `<style>`** 注入
    （与我们的 CSS 数组分离，不污染门禁抽取锚点）。
  · **作用域收口（必须）**：展平后的主题含 `:root`×9 / `body`×7 / `html`×1 全局选择器，直接注入会**重绘宿主 DSH 页面**——
    构建期一律改写为 `#scpanl-root`，并断言「不得残留未限定的全局选择器」（违背即构建失败）。已实测令牌只在面板内生效。
  **⑤ 本批最隐蔽的坑：一条未闭合的 CSS 规则吞掉 87 条规则**
  令牌桥首版拆成两条 `#scpanl-root{…}`，**第一条未闭合 `}`** ⇒ CSS 解析器把其后 87 条规则并入该块，
  表现为「KPI 4 行 / 操作卡 3 行 / 徽章 7 行」的布局塌陷 + 审计报 **87 个缺样式**。
  修法：合并为一条闭合规则。**这条由现有 CSS 审计抓到**（说明该门禁有效），并顺带验证了「CSS 结构错误会以缺样式形式暴露」。
  **验证**：`ui-geo-regress` **71 PASS / 0 FAIL**（含新断言：组件库按钮**零残留** + 手写按钮高度 26–34px）；
  `check-runner` **33 pass · 1 xfail**；`audit-css-usage --gate` PASS（死规则 0 · 缺样式 0 · 自有类 162）；
  视觉复核（3 页截图 + 像素级判读）：按钮恢复实心紫胶囊、三卡同行等高 ≈29–30px；组件库 Tab 在参数/设置页标签可见、
  指示条正确；设置页标签下方有真实折叠块与表单项；无裁切/溢出/塌陷。仅两处对比度偏弱（按钮浅底白字、红色告警条）留待后续。

- **🧩 S3 续（2026-09-13）—— 第一处手写 DOM 下线：分段 Tab 改用组件库 `<wa-tab-group>`**
  **替换内容**：`UI.tabs(key, defs)` 从「手写 button + 手写选中态 + 手写键盘导航 + 手写显示互斥」改为组件库承载
  （`<wa-tab-group active>` + `<wa-tab slot="nav" panel>` + `<wa-tab-panel name>`；`wa-tab-show` 事件回写 `Cfg('tab:'+key)`）。
  契约**读自** `webawesome/dist/components/tab-group/tab-group.d.ts`（不猜）：`active` 属性设初始态、事件 detail 带 `name`、
  parts `nav/tabs/body`、CSS 变量 `--indicator-color/--track-color`。**句柄保持 `{ box, select(id), pane(id) }` 完全一致**
  ⇒ 调用点零改动、可一行回滚；并把方案令牌接到组件变量上（`--indicator-color:var(--sc-accent)`），随皮肤/主题走。
  **同步删除手写样式**：`.sc-tabs/.sc-tab/.sc-tab.on/.sc-tab:hover/.sc-tab:focus-visible/.sc-tabpanes` 6 条规则（CSS 审计确认 0 死规则）。
  **验收断言同步补**（`ui-geo-regress`）：有 Tab 的视图（记忆库 5 段 / 参数 4 段 / 设置 2 段）逐一断言
  `wa-tab-group ×1`、`wa-tab-panel` 数与段数一致、`wa-tab` 数一致、**同时仅 1 个面板可见**、`customElements` 已注册该组件
  —— 组件库替换由**渲染断言**背书，不是"没报错就算过"。结果 **65 PASS / 0 FAIL**。
  **⚠ 本批踩坑（重要教训）**：我用「从 `tabs: function` 切到下一个注释锚点」的整段替换，**把夹在中间的 `UI.kpi` 一并删掉**，
  导致总览页 KPI 全部消失——而**全部静态门禁依旧全绿**（`check-runner` 33 pass、CSS 审计、契约检查都没抓到这个）。
  是 `ui-geo-regress` 的「KPI 卡数量 0（期望 4）」把它抓出来的，随后从备份精确回补该方法。
  教训：**切片式替换必须由"结构边界"（AST/成员表）而定，不能靠注释锚点猜**；且**删改后必须跑渲染级回归**——
  静态门禁对"代码整块消失但语法仍合法"这类错误天然失明。
  同时补了一道自检：`UI` 成员表（start/set/done/item/toggle/pageHead/input/select/button/badge/dsBadge/fold/tabs/kpi/progress/kv = 16 项）可一键核对。
  **门禁**：`check-runner` 33 pass · 1 xfail · `audit-css-usage --gate` PASS（死规则 0 · 自有类 163）· 安装副本已同步。

- **🏗️ S3 首批（2026-09-13）—— 引入构建层（esbuild）+ 成熟组件库（Web Awesome）；client 源/产物分离**
  **判因**：`client.js` 一直是「手写 ES5 + 无 bundler + 无依赖」的单文件 ⇒ 用不了任何 npm UI 库，
  只能继续手搓 DOM（与仓规「不从零造轮子」冲突，也是 UI 层唯一没吃到生态红利的地方）。
  **本批结构变化**：
  ① 源码迁 `src-client/body.js`（原 `client.js` 平移）+ 新增 `src-client/vendor.js`（按需 import 组件库）
  + `src-client/entry.js`（入口：vendor → body）；`client.js` 自此为 **esbuild 产物**（IIFE、不压缩）。
  ② `scripts/build-client.mjs` 升级为打包器：**打包 → 锚点校验 → 原子替换**（校验失败保持旧产物，宁可不更新也不破坏门禁）；
  打包后断言四项：`__ModuleLoader__` 契约 / `window.__SC_CSS__` 锚点 / 数组起点 / `customElements`。
  ③ 组件库选型 **Web Awesome 3.12**（原 Shoelace，web components）：无框架耦合、每组件自带样式、
  可逐个替换手写组件（本轮先按需引入 button/card/badge/progress-bar/tab-group/tab/tab-panel/spinner/tooltip）。
  **单产物保持**：组件库随 `client.js` 一起送达（565KB，无额外请求），符合「即开即用」偏好。
  **锚点脆性根治（本批最重要的一条）**：仓内四件门禁都按**文本锚点**抽取 CSS 数组，而打包器会
  ① 重命名局部变量（实测 `CSS` → `CSS2`）② 规范化引号（`].join('')` → `].join("")`）。
  我第一版用"构建期改名归一"打补丁，结果**只改了声明没改使用点** ⇒ 产物运行时 `ReferenceError: CSS2 is not defined`
  （跑真机几何回归才暴露，纯静态门禁全绿）。**改为稳定显式锚点**：源码把数组同时挂到 `window.__SC_CSS__`（属性名不被重命名），
  四件门禁（`audit-css-usage` / `check-layout-px` / `gen-ui-preview` / `test-css-usage-gate`）一律按该锚点 + **引号无关正则**抽取。
  **顺带修掉的门禁形态脆弱**（同一族，第 3 次出现）：`check-ui-contract` 的 VIEWS 解析 / show() 分派 / 配置键改成引号无关；
  `audit-css-usage` 的拼接前缀识别支持双引号与模板字面量；`test-css-usage-gate` 的变异注入点改为
  「`window.__SC_CSS__` 之后首个 `].join()`」并**自动补尾逗号**（打包产物不留尾逗号）。
  **源码级测试指向源码**：`test-fold-state` / `test-ui-derive` 因按变量名抽模块（`var Fold = (function`）在产物里必然失效 ⇒
  改读 `src-client/body.js`（源码语义归源码，产物语义归产物）。
  **顺手清掉真死规则**：`.sc-h2` 全仓零使用（此前门禁漏网）⇒ 删除并留一行原因注释。
  **零硬编码红线**：源码里 `input.placeholder = 'D:\…\my-vault'` 被检出 ⇒ 改为非路径示例。
  **验证**：`check-runner` **33 pass · 1 xfail**；`ui-geo-regress` **50 PASS / 0 FAIL**（含插槽/皮肤/三档视口几何；
  这是**跑在打包产物上**的结论）；`test-fold-state` 18/0 · `test-ui-derive` 34/0 · `test-css-usage-gate` 6/0 ·
  `check-ui-contract` 8/0 · `audit-css-usage --gate` PASS（死规则 0）· `check-hardcode` PASS；安装副本已同步。
  **S3 待续**：把已引入的组件**逐步替换**手写 DOM（先通用件：卡片 / 标签页 / 进度条 / 按钮），每替换一处即跑几何回归。

- **🎨 S1-b 皮肤机制 + S2 设置进宿主设置中心（2026-09-13）—— 用户拍板「v9 皮肤为准 + 宿主皮肤可选」**
  **S1-b（主题令牌单一化，按用户裁决落地）**：令牌层重构为「**一层语义令牌 + 两套显式皮肤**」：
  `--sc-*` 不再与宿主变量并列双源，而是——
  ① 基础块保留宿主变量作**兜底**（无皮肤标记时的向后兼容）；② `.sc-skin-v9.sc-dark/.sc-light` = 方案调色板（默认）；
  ③ `.sc-skin-host` = **单一真源取自 `--dsw-alias-*`**（面板与 DSH 同色、跟随宿主换肤；卡面用
  `color-mix(in srgb, 宿主层1 88%, #fff 12%)` 保住「凸卡」结构而不写死色值）。
  `syncTheme()` 负责打标记（宿主亮暗 + 皮肤），`Cfg('skin','v9')` 可切；面板「设置 · 外观皮肤」与宿主设置中心**两处入口同源**，切换即时重绘。
  **S2 续（设置进宿主设置中心）**：注册 `settings.section`（id `shoucang`，order 60），React 组件经 `require('react')`
  复用宿主运行时，类名走宿主既有 `setting-item` 体系（自动跟随宿主主题）；分区内含 显示密度 / 导航宽度 / 轮询间隔 /
  显示日志 / 界面皮肤 / 启动时视图 / 「打开守藏面板」——与面板内「设置」页**同源同 Cfg**，面板内设置保留作兜底与高级项。
  **验证**：`ui-geo-regress` 扩到 **50 PASS / 0 FAIL**，新增断言——
  插槽路径：向 `sidebar.footer.action` **与** `settings.section` **两个槽位**注入、注册两条条目（`shoucang-panel-toggle` /
  `shoucang`，均为组件函数）、**互斥**（插槽可用时 `#scpanl-btn` 不存在）、面板骨架仍挂载；
  皮肤路径：默认皮肤标记 `sc-skin-v9` + 面板底色 `rgb(27,27,30)`（方案 `--sc-bg1 #1b1b1e`）；
  切宿主皮肤后标记 `sc-skin-host` + 面板底色 **真取自宿主变量**（伪造 `--dsw-alias-bg-layer-1:#123456` → `rgb(18,52,86)`，
  证明确实是"读宿主"而非"写死色值"）。
  其余：`check-runner` **33 pass · 1 xfail** · `check-ui-contract` 8/0 · `audit-css-usage --gate` PASS（自有类 167）；安装副本已同步。
  **踩坑记录**：`ui-geo-regress.mjs` 采用省略分号风格，我插入的以 `(` 开头的断言行被解析成上一句的函数调用
  （`ok(...) is not a function`）⇒ 补前导分号——**在省略分号的文件里插代码，凡以 `(`/`[`/`` ` `` 开头必须带前导分号**。

- **🏗️ UI 架构重排 S2 首批（2026-09-13）—— 侧栏入口改走宿主插槽（并修掉 0.1.2 的「双入口」旧疾）**
  **取证**（不猜 API，先读宿主与生态的现成写法）：宿主插槽是 cordis 客户端服务 `ctx.slots`，贡献形态为
  `ctx.effect(() => ctx.slots.inject('<slot>', () => ctx.slots.register({name,id,order,label}, Component)))` ——
  该写法在 `@dsh-external/dsh-super-injector`、`@linxin666/dsh-session-archive`、`@nanmicoder/dsh-agent-teams`
  三个已装插件里一致（**同一套契约，直接照抄而非自创**）。宿主侧契约（`dsh-client-ui-sidebar/…/contract/slots.d.ts`）：
  `sidebar.footer.action` = `kind:'list'` / `scope:'root'` / owner props `{wide}`；`sidebar.panellist` 为全局面板行。
  **判因**：`client.js` 里确有一处 `ENABLE_SLOT_BUTTON = false` 的历史开关，注释写明「0.1.2 起 slot 按钮与 DOM 直插按钮
  同时显示为两个入口，故暂禁用 slot」。⇒ **正解不是禁用，而是互斥**。
  **本批改动**：① 把插槽可用性判定提前（`require('react')` 可用 + `ctx.slots.inject/register` 齐备才走插槽）；
  ② **互斥**：插槽路径成立时**不再挂** DOM 直插入口，否则回退 DOM 直插（行为与旧版一致，零回归）；
  ③ 两条路各写一条 `Log.info`（`侧栏入口：已注册宿主插槽…` / `…回退 DOM 直插`）——重启后可据日志判定实际走哪条路。
  **验证**：`ui-geo-regress` 新增「插槽路径」用例 5 条断言（注入 `sidebar.footer.action` / 注册 1 条 `shoucang-panel-toggle`
  / **互斥生效 `#scpanl-btn` 不存在** / 面板骨架仍挂载 / 无异常）⇒ 全件 **45 PASS / 0 FAIL**；
  `check-runner` **33 pass · 1 xfail**；安装副本已同步。
  **旁记（抖动，待单独处理）**：本轮一次全量跑里 `test-forgetops` 转红、单独跑 30/30 绿、复跑两次均绿 ——
  疑与其写审计文件的知识区目录同时被运行中的调度器写入有关（跨进程共享目录竞态），需单独一轮加隔离/重试护栏。
  **S2 待续**：设置页改走 `settings.section`（把界面偏好与配置原文并入宿主设置中心）；
  **S1 剩余**（等你定）：主题令牌单一化（宿主原生皮肤 vs v9 皮肤）。

- **🏗️ UI 架构重排 S1 收尾（2026-09-13）—— 容器级死值归零 + 新增「容器不许写死尺寸」机检门禁**
  **本批两件事**：
  ① **剩余容器级固定值收口**：`.sc-card-body{max-height:300px}` → `min(60vh,420px)`；宽屏断点内容列
  `padding:… 40px …; max-width:1120px` → `clamp(16px,2.2vw,32px) clamp(20px,3vw,48px) …` + `max-width:min(1120px,100%)`；
  顺带清理同批引入的 `;;` 残留 6 处。
  ② **新增架构门禁 `scripts/check-layout-px.mjs`（已登记 CHECKS，含反向证伪件）**：
  把「容器级选择器不得写死布局尺寸」从**文档约定**变成**机器约束**——扫描 `client.js` 的 CSS 数组，
  对**容器级选择器**（`#scpanl-modal/.sc-view/.sc-main/.sc-nav/.sc-logwrap/.sc-card-body/.sc-fold/.sc-tabbox/.sc-tabpanes/.sc-kpis/.sc-opgrid/.sc-mem-grid/.sc-statusbar/.sc-log-head`）
  的 `width|height|min/max-width|min/max-height|padding|margin|gap` 禁止裸 px（须 `clamp()/min()/max()/%/vh/var()`）。
  **判定口径**：选择器**末段简单选择器**须为容器本身——否则 `.sc-nav-item svg` 这类组件后代会被误判（首版即误报 9 处，
  已修正并纳入反向证伪第 ⑦ 条）。**例外必须登记 ALLOW 并写明理由**（现 4 条：KPI 数值/副行等高、日志级别列宽、状态栏最小高）。
  **反向证伪 7/7**：塞 `.sc-view{width:1000px}` / `.sc-logwrap{height:300px}` 必翻红，`clamp()/min()` 与白名单必放行，
  组件后代不误判 —— 证明它不是「永远绿的门禁」。
  **实测**：`check-runner` **33 pass · 1 xfail**（新增 3 项：`ui-geo-regress`、`check-layout-px`、`check-layout-px --selftest`）；
  `ui-geo-regress` **40 PASS / 0 FAIL**（1024/1280/1600 三档：弹窗 96%/96%/94% 自适应、KPI 4 张同行共线、状态栏可见、日志折叠 44px）；
  安装副本已同步。
  **S1 剩余**：主题令牌单一化（`--sc-*` 收敛为「一层语义 + 显式皮肤」，去掉宿主变量与 v9 调色板并列的双源）——
  **该步会决定观感走宿主原生风还是保持 v9 皮肤，需用户先定取舍**；落地时建议做成 `Cfg('skin')` 可切换并出双皮肤截图供比对。

- **🏗️ UI 架构重排 S1 首批（2026-09-13）—— 弹性布局 + 几何回归门禁进 CHECKS**
  **路线（用户拍板 C）**：S1 布局全流体化 → S2 侧栏入口/设置页改走宿主插槽 → S3 构建层 + 成熟组件库 → S4 RPC schema 化。
  审查档：`deliverables/engineering-assurance/ui-architecture-review-2026-09-13.md`（含宿主插槽/主题/设置框架的实测证据）。
  **S1 本批**：① 弹窗宽度上限 `min(1040px,100%)` → **`min(1480px,96vw)`**（此前 1280/1600 下被钉死在 1040，
  实测「宽容器仍不追随视口」）；② 徽章行 `flex-wrap:wrap` → **`nowrap` + 横向滚动**（方案为 7 枚单行，此前折成 6+1）；
  ③ 日志面板从「要么常驻 150px、要么整个移除」→ **折叠成一行 33px 可点开条带**（`sc-log-collapsed` + 头行 role=button，
  对齐方案「▸ 日志 N 条」）；④ `.sc-view/.sc-main` 补 **`min-height:0`**（内容区可收缩，不再把兄弟块挤出）、
  内容区 padding 与标题/KPI 字号改 **`clamp()`**、网格 `minmax(min(Npx,100%),1fr)`、YAML 区高度 `clamp(160px,30vh,320px)`、
  日志 `max-height:min(34vh,320px)`、遮罩 padding `clamp(8px,2vw,24px)`；⑤ 新增 `syncTheme()`（探测宿主背景亮度打
  `.sc-dark/.sc-light`，面板不再只依赖宿主变量）。
  **新增门禁 `scripts/ui-geo-regress.mjs`（已登记 CHECKS · xfail）**：把真实 `client.js` 装进无头浏览器（mock RPC），
  在 1024/1280/1600 三档视口下量几何并断言——弹窗是否随视口自适应、内容区是否唯一滚动容器、KPI 是否 4 张同行且
  **全部落在首屏**、操作卡是否 3 张同行、徽章是否单行、状态栏是否可见、日志是否折叠；另对其余 4 视图做渲染非空冒烟。
  **判因**：本轮教训是「CSS 门禁 + 结构断言全绿，但内容被写死尺寸挤出首屏」——只有真渲染量几何才看得见，故把它做成常驻件。
  无 Chrome/Edge 的机器退 4 = xfail（本件已声明），不判失败。零硬编码红线：Chrome 候选全部由环境变量/`where` 派生。
  **实测（本批后）**：`ui-geo-regress` **40 PASS / 0 FAIL**（1024：弹窗 966×611=96% 视口、4 张 KPI 同行共线 539、
  状态栏可见、日志 44px；1280：1212=96%；1600：1480=94%）；`check-runner` **31 pass · 1 xfail**；
  `check-hardcode` / `audit-css-usage` / `check-ui-contract` 全绿。
  **S1 待续**：列表/表格行高与 `.sc-log-row` 等剩余固定尺寸收口；主题令牌单一化（`--sc-*` 只做宿主 `--dsw-alias-*` 语义映射，
  删掉与 v9 并列的第二套调色板）——该项会改变观感为"宿主原生风"，落地前需与用户确认取舍。

- **🎯 UI 设计系统对齐 v9（2026-09-13）—— 真机渲染 vs 方案原型视觉比对后的系统性修正**
  **判因（用户反馈：实际与方案视觉不一样）**：此前落地只把 v9 的**结构**塞进了旧 Obsidian 体系，
  两者是**两套视觉系统** ⇒ 外观必然不一致。实测对照（`getComputedStyle`，真机 vs 方案）：
  卡面底色 `rgb(25,25,25)`（**比页面 rgb(30,30,30) 更暗 = 凹卡**）→ 方案 `rgb(42,42,47)`（凸卡）；
  导航底 25,25,25 → 23,23,25；页面标题 20px → 17px；描述 13px → 12.5px；KPI 数值 28px → 22px；
  KPI 条 6px/圆角 999 → 5px/圆角 3；品牌紫 `rgb(139,108,239)` → `rgb(167,139,250)`；
  导航选中「紫底 + 3px 左侧竖条」→「16% 紫底、无竖条」。
  **修法（守架构纪律）**：第一版用「追加覆盖」写法 ⇒ 触发 `audit-css-usage` **同层重复定义 12 处**
  （正是本仓 CSS 纪律禁止的腐化形态）⇒ 改为**原地改既有规则** + 新增 `#scpanl-root.sc-dark/.sc-light`
  两套 v9 令牌；并新增 `syncTheme()`：`mount()`/`openPanel()` 时探测宿主实际背景亮度打主题标记
  （面板此前完全依赖宿主变量，无法保证与方案同色）。
  **首屏对齐**：日志面板默认**折叠**（`Cfg.showLogs` true→false，腾出约 150px——此前常驻面板把 KPI 行挤出可见区）；
  操作卡网格 min 260→200px、KPI 网格 min 200→160px ⇒ 实测 **4 张 KPI 单行共线 `560/560/560/560`**
  （修前 `697/697/697/817` 换行）。
  **顺带修掉两个真数据 bug**（视觉侧报「渲染成字面量 undefined」）：画像章节标题 `f.label` 缺字段 ⇒
  `undefined · 24`；插件集合成员描述直拼 `m.package` 字段名不匹配 ⇒ 三行全 `undefined`；两处均改防御性取值。
  **验证**：`check-runner` 30 pass · 1 xfail · `check-ui-contract` 8/0 · `audit-css-usage --gate` PASS
  （死规则 0 · 同层重复 0）；视觉复核确认 token 层命中（卡面 / 标题 / 描述 / 导航去竖条）；
  安装副本已同步（`check-installed-sync` lib/ 133↔133 一致）。
  **仍未对齐（下一批，视觉比对清单）**：① 页头工具区（右上动作按钮 + 路由 chip 行）② 操作卡图标底座
  ③ 侧栏底部状态块（`● 记忆库 正常` + `vault · 已激活`）④ 待处理条改琥珀 + 「前往处理」链接
  ⑤ 记忆库索引**表格化** ⑥ 深睡页四个区块（状态机时间线 / 睡眠水位条 / 状态分布条 / 回执 KPI）
  ⑦ 插件集合成员卡阵列 + 装配矩阵表 ⑧ 画像 USER/AGENT 构成卡 + 成熟度分布卡。

- **🛠️ UI 重构落地 P3-2 / P3-3（2026-09-13）—— 危险态统一到 `UI.button` + 新组件按六层归位（目标收口）**
  **P3-2 危险态统一（7 处裸 `confirm()` 全部收口）**：清缓存重建 / 忽略候选 / 根目录引导 / 行级删除 /
  恢复默认设置 / 深睡触发 / 暂停到明天 —— 一律改走 `UI.button(..., { danger, confirm, async, busyText, okText })`，
  不再各自手写 `disabled`/`busyText`/`confirm`（视觉与行为同源）。实测：`window.confirm` **0 处**、
  `UI.button` 的 `confirm` 选项 **10 处**、`danger:true` **6 处**；裸 `confirm(` 仅剩 2 处
  （`UI.button` 自身实现 + 行级删除的**动态**确认——它需带目标行内容，已加注释说明为何不走 opts）。
  **顺带修掉一处真实缺陷**：行级删除此前**双重确认**（内层 `confirm` 与 `opts.confirm` 并存 ⇒ 弹两次）。
  **连带清理**：`.sc-btn-muted` 唯一使用点被替换后成为**死规则**，已删（CSS 门禁 A 类要求 0）。
  **P3-3 新组件按六层 CSS 归位**：`UI.tabs` 的 `.sc-tab*` 移入 **④ 原件层**（控制原件：按钮/输入/折叠/进度/分段），
  运行总览与容量 KPI 的 `.sc-opcard*/.sc-kpi*` 移入 **⑤ 业务层**；此前两块堆在数组末尾（⑥ 适配层之后）。
  **验证**：`check-ui-contract` 8 PASS / 0 FAIL · `audit-css-usage --gate` PASS（死规则 0 · 同层重复 0 · 自有类 161）·
  `check-runner` **30 pass · 1 xfail** · 危险态静态断言 **8/8** ·
  真机运行态烟测（Chrome + mock API 逐视图点导航）**6 视图 0 错误**，Tab 4/5/2 pane、
  KPI 4/2/3 且同网格行内条完全共线（697/697/697 · 266/266 · 672/672/672）。

- **🛠️ UI 重构落地 P2 + P3-1（2026-09-13）—— 三处长页 Tab 化 + 容量 KPI 单一实现 + 已部署**
  **P2 三处 Tab 化**（参数 4 / 记忆库 5 / 设置 2），新增 `UI.tabs` 组件（`.sc-tabbox/.sc-tabs/.sc-tab/.sc-tabpanes`）：
  选中态存 `Cfg('tab:<view>')`（重绘后保持）、方向键可切、**只切 `.sc-hidden`，绝不触碰 `Fold`**
  —— 折叠态的生命周期边界仍然只有「换视图」一条（`Fold.clear` 唯一调用点）。
  手法是不改写块内代码：插入 pane 容器 + 把块内 `view.appendChild` 换成 `host.appendChild` + 在块边界插 `host = paneN`。
  参数页 4 Tab = ① 注入与画像 ② 记忆与容量 ③ 模型与向量 ④ 后台与调度；记忆库 5 Tab =
  运行态 / 索引 / 候选 / 笔记 / 统计·归档（映射自既有分区：§1+§2 运行态、知识索引+知识区 索引、
  pending 候选、notes 详情 笔记、认知报告+本月成长+delta+周增量 统计·归档）；设置 2 Tab = 界面偏好 / 高级。
  **P3-1 容量 KPI 单一实现**：新增 `UI.kpi()`（大数值 + 百分比 + 进度条 + 无门虚线空槽），
  **画像 / 记忆库 / 运行总览三处共用同一实现**（此前三套）：
  画像容量**恢复百分比 + 容量条**（2026-09-13 用户裁决，并同步改写 L2428-2430 注释），
  记忆库「运行态」新增 MEMORY.md 容量 KPI（真容量门才给百分比与条）。
  **运行时抓到的 3 个真 bug（全部修复）**：
  ① `CAP_PCT is not defined` —— 它在 `Derive` 闭包内，`renderViewOverview` 不可见；此前用正则判"有定义"是**假阳性**，
     被 `.catch(fail)` 吞进状态栏才暴露 ⇒ 改用 `Derive.capKind()` 语义档判断；
  ② `swapHost` 把**刚插入的** `view.appendChild(_tb.box)` 也换成了 `host.`，而 `var host` 在下一行才赋值 ⇒ Tab 条挂载失败；
  ③ `renderViewRoots.draw()` **既有潜伏 bug**：`r.roots` 缺失时空态分支没 `return`，紧接着 `r.roots.forEach` 必崩
     （线上因 `/roots` 恒返回对象而被掩盖）⇒ 补空态收口。
  **门禁自测加固（三处脆性，同一族：文本/位置匹配型护栏）**：`test-css-usage-gate` 的 ③ 原本锚在
  `var foldMark = el('div','sc-fold-mark');`——该行随 Tab 化删除后**变异静默失效**（门禁假绿）⇒ 改**追加式注入**
  （锚 `exports.apply`）；⑤ 原本要求「白名单恰有 1 条」，白名单归零（`sc-fold-mark` 哨兵已无创建点）反而误红 ⇒
  改为「每条须有理由，允许为空」；`test-ui-derive` 的 E4 正则 `bText` 是**子串**匹配，被新增参数名 `subText`
  误伤 ⇒ 加词边界 `\bbText\b`。同时清掉 `audit-css-usage` 的死白名单条目。
  **验证（实证，非自述）**：
  `check-ui-contract` 8 PASS / 0 FAIL；`audit-css-usage --gate` PASS（死规则 0 · 同层重复 0 · 自有类 157→162）；
  `test-css-usage-gate` 6 pass / 0 fail；`check-runner` **30 pass · 1 xfail**。
  **真机运行态验收**（Chrome + mock API 加载真实 `client.js`，逐视图点导航）：
  运行总览 4 KPI + 3 操作卡（`status` 无错）、参数 1 tab/4 pane、记忆库 1 tab/5 pane + 3 KPI、
  设置 1 tab/2 pane，`unhandledrejection`/`onerror` 事件 **0 条**。
  **几何实测**：同网格行内 KPI 进度条 y 完全共线（总览 697/697/697、画像 266/266、记忆库 672/672/672）；
  画像百分比已恢复（78% / 48%）；操作卡三枚按钮同尺寸（84×30）。
  **部署**：按 AGENTS.md 路线**只覆盖差异文件**（公开树 346 件 → 覆盖 116 件），
  `check-installed-sync` 实测 **lib/ 133 与 133 逐文件 sha1 一致**；`client.js`/`lib/client.js` 哈希相同。
  ⚠ **前端生效需重启 DSH**（面板 client 半区在宿主启动时装载）。
  **仍待做**：P3-2 危险态统一到 `UI.button`（7 处裸 `confirm()` 收口）。

- **🛠️ UI 重构落地 P1（2026-09-13）—— 按 v9 原型改造 `client.js`（运行总览首屏 / 导航重排 / 配置原文下沉）**
  设计源：`deliverables/ui-redesign-v9-2026-09-13.html`。落地方式：**把原型设计翻译进既有 `sc-*` 六层体系**
  （原型用的是自有 `.kpi/.act/.btn` 类，不能直接贴，否则与设计系统两套并存）。
  本批 8 项：
  ① **新增「运行总览」视图**（`renderViewOverview`）：状态徽章行（只承载状态，数值集中在卡片，同页不重复）
  + 三张操作卡（蒸馏 / 深睡 / 自检，**按钮同规格 primary**、卡内按钮 `margin-top:auto` 底部对齐）
  + 四张 KPI（记忆库容量 / 蒸馏水位 / 深度睡眠 / 向量档；`.sc-kpi-val{min-height:34px}` + `.sc-kpi-bar{margin-top:auto}`
  ⇒ **四卡进度条共线**，即用户指出的「三个数字一个文字导致条不在一条线」）+ 本月成长 + 系统状态（KV）。
  数据全部来自现有端点，**零新增端点**（门禁④ 实测仍 34/34）。
  ② **图标去重**：`ICONS` 5 → **10 个**（新增 overview/suite/sleep/observe/settings），8 视图各一；
  烟测实测 `navIconsDistinct = 8`（此前运行总览与插件集合同图）。
  ③ **导航重排**：`VIEWS` 按语义 4 组（总览 / 记忆 / 运行 / 配置），视图名对齐原型（记忆库 · 画像 · 参数 · 设置）。
  ④ **配置原文下沉**：原一级视图 `file` 撤出导航，逻辑抽为 `renderConfigRaw(host)`，落在
  「设置 · 高级 · 配置原文与根目录」折叠区（P1-4）。
  ⑤ **默认首屏** `file` → `overview`（`Cfg.DEF.startView`，优先级：深链 > 上次视图 > 此项），
  设置页新增「启动时视图」项；门禁 `check-ui-contract` 的 `CFG_KEYS` **8 → 9** 同步。
  ⑥ **新增组件 CSS 19 条**：`.sc-opgrid/.sc-opcard*/.sc-kpis/.sc-kpi*`（含 `.na` 虚线空槽与 ok/suspect/stalled 三档条色）。
  ⑦ **门禁自测踩坑修复**：插 CSS 时吃掉了数组末尾逗号，导致 `test-css-usage-gate` 的反向证伪注入拼不出合法数组
  （① 死规则 / ② 同层重复 两项误红）—— 补回逗号后恢复。
  ⑧ 验证：`check-ui-contract` **8 PASS / 0 FAIL**（语法 / 16 基础设施符号 / VIEWS 8 视图全有 show() 分派 /
  端点 34-34 / 产物同步 / 无 status↔Log 递归 / 设置项 9 项）；`audit-css-usage --gate` **PASS**
  （死规则 0 · 同层重复 0 · 自有类 146 → 157）；`check-runner` **30 pass · 1 xfail**。
  **真机烟测**（Chrome + mock API + 真实 `client.js`）：模块加载 OK、`apply()` 零异常、root/mask/侧栏入口挂载 OK、
  导航 8 项标签与图标逐一正确。
  **未完成（下一批）**：P2 参数页 4 Tab / 记忆库 5 Tab / 设置页 2 Tab（含 Fold 生命周期约束）；
  P3 画像与记忆库容量统一为 KPI 卡（v9 用户裁决项）、危险态统一到 `UI.button`、样式一致性补丁并入六层 CSS；
  新视图的**真机视觉验收**（mock harness 里 `openPanel` 不可从外部触发，需加深 harness 或用宿主重启后的真实面板）。

- **🎨 容量组件统一 + KPI 条共线（2026-09-13）—— 定稿 `deliverables/ui-redesign-v9-2026-09-13.html`**
  用户指出两处：① 记忆库「容量占用」仍是行式列表，与画像页不是一套；② 总览四张 KPI（记忆库容量 / 蒸馏水位 /
  深度睡眠 / 向量档）下方的进度条**不在一条线上**。
  **根因（几何实测确认）**：① 两页用了两套组件（记忆库 `.cap` 行 vs 画像 `.kpi` 卡）；
  ② 四卡内容混排——三张是数字（`.k-val` 高 30px），「深度睡眠」是文字「浅睡」（高 20px）⇒ 内容列高度不同，
  条随内容流式排布 ⇒ 实测条 y = **567 / 567 / 556 / 567（差 11px）**。
  **处置**：记忆库容量改为**画像同款 KPI 卡**（MEMORY.md 容量 62% + 条 · notes/ 148 个文件 · pending 9 条；
  无容量门的两张贴虚线空槽保持槽位一致）；`.kpi` 改 flex 列 + `.k-bar{margin-top:auto}`（条钉卡底）
  + `.k-val{min-height:34px}` + `.k-sub{min-height:18px}`。
  **修后实测**：四卡条 y = **562 / 562 / 562 / 562**、数值行高 **34/34/34/34**、卡高 110/110/110/110；
  记忆库三卡条 y = **345/345/345**；画像两卡 269/269 —— 三页同款组件、同线对齐。
  （v7 的 `.view` flex 回归教训在此复用：**容器** flex 会收缩塌陷，**卡片自身** flex 安全。）
  **代码未改**（`client.js` == HEAD `9f6c920`）。

- **🎨 面板 UI 样式一致性修 + **视觉模型复看抓回归**（2026-09-13）—— 定稿 `deliverables/ui-redesign-v8-2026-09-13.html`**
  **触发**：用户指出「排版一样一起的按钮样式和颜色都不一样」，并要求「自己用视觉分析，不要只看代码」。
  **视觉通道**：`read_image` 由宿主**模型注册表的模态声明**把关 —— `~/.dsh/settings.yaml` 里
  `commandcode-goat` 的 `deepseek/deepseek-v4-flash-vision-exp`（L50）**缺 `input:[text,image]`**，
  而同 provider 的 `deepseek-v4.1-flash`（L60-69）已补、`opencode-go-custom`（L342/L346）也有声明
  ⇒ **同一多模态模型，只因漏声明被当纯文本**。本次改走 `opencode-go-custom` 路由，4 路并行逐图真读。
  **实证修法（`v7`）**：卡面/页底同色导致画面发平（`#1b1b1e` = `#1b1b1e`）⇒ 暗色新增 `--panel3`；
  容量占用三行行高 44/37/36、chip 起点锯齿、右侧数值差 70px ⇒ 改 grid 三列（标签 104px / 类型 /
  数值右对齐）+ 无门行统一虚线空槽 + 说明收成一条脚注；页头说明用产品胶囊样式 ⇒ 降级 `.proto-note` 虚线注记；
  KPI 中文状态「浅睡」与数字同字号 ⇒ `.k-val.txt`（20px vs 30px）；破坏性按钮无危险色 ⇒ 加 `.btn.danger`；
  侧栏「运行总览 / 插件集合」同图标 ⇒ 插件集合改 layers 图标；三张操作卡按钮错层 ⇒ `.act .f{margin-top:auto}`
  + 卡 2 文案缩短（消孤行「行。」）；设置页内容被状态条切 ⇒ 内容区底部留白。
  **⚠ 一次真实回归（v7 引入、v8 修）**：把 `.view` 改成 `display:flex; gap:16px` 后，`.card{overflow:hidden}`
  在 **flex-shrink** 下把卡片**压成几像素空壳**、文字被裁——**DOM 断言 28 PASS 全绿也没抓到**（结构断言测不到渲染塌陷），
  是视觉复核看图发现的。v8 撤掉 flex，改用「兄弟 margin」方案（`.view > * + *{margin-top:16px}`）。
  **终态几何实测（Chrome CDP 取 `getBoundingClientRect`，非目测）**：操作卡按钮 3 枚 **84×26 @ y399 完全同位**、
  三卡等高 156px、容量三行 **h=34 且数值右缘同为 x=1228**、overview/persona/sleep/settings **子块间距一律 16px**、
  卡面 `rgb(42,42,47)` vs 页面底 `rgb(19,19,21)`。**同时推翻两条视觉误判**：所谓「卡片被切/空壳」实为滚动折叠处
  （`scrollHeight 1329 / clientHeight 463`）、所谓「记忆库间距 2–4px」实为该页 `.view` 只有 1 个子块（卡内分隔线被当成卡边界）。
  **未决项（已入 v8 台账 H 节）**：设置页「恢复默认设置」仍是文字行无危险色；卡面提亮后行分隔线对比度需随动（已提 `--border2` 到 `#33333a`）；
  纵向 20px / 横向 15px 两套间距值；「本月成长」三 chip 三配色；参数页 Tab 走等分、观测/设置走自适应（两套分段规则）。
  **代码未改**（`client.js` == HEAD `9f6c920`）；本条只交原型与台账。

- **🎨 面板 UI 方案 v6：v4 整体审查 + 同页去重 + 容量条口径（2026-09-13）**
  审查报告 `deliverables/engineering-assurance/ui-v4-review-2026-09-13.md`：v4 的原型没问题，
  **它的自审证据层有问题**——⑦「查漏补缺」7 项中 **5 项与现树矛盾**（`/inject/preview` L1438、
  `/llm/models` L1743、`/config/recent` L1974 三个端点**都已有 UI 入口**；`/criteria` 已用 ≥7 组字段
  而非 2 个；运行观测 L2610 已有 `UI.progress` 进度组件；`/selfcheck` GET/POST 早已分列；
  `sc-persona-cell` L1323/1356/1779 三处在用）。照 v4 清单落地会**重复建设**，故全部作废。
  另核实两处真实缺陷：`Cfg.DEF.navWidth = 200`（L777）与 `applyNavWidth()` 兜底 `216`（L3172）不一致；
  默认首屏 `currentView = 'file'`（L3090）打开面板先看 YAML。
  定稿原型 `deliverables/ui-redesign-v6-2026-09-13.html`（视觉与交互沿用 v4，改动全部定点）：
  ① **数值取真源**——判据版本 `v2.2.0`（非 v9.1）、MCL 熟悉度阈值 `0.58`（非 0.65）、
  活性**无 0.35 这个键**（真值 `activity.ts` L81-84：warm 14 / cold 44 / archive 90 / hotHits 5）、
  重排门补上连败门与 `enabled=false`；② **口径统一**——记忆库 5 Tab、运行观测独立页 3 分组、
  `/criteria` 归属改为总览（现挂深度睡眠页 L2958）。
  ③ **去重口径 = 同一页面内**（`v5` 曾误按「跨页唯一归属」去改，本版**全部回退**：总览的深睡/自检按钮
  与「快捷操作」卡恢复原样）——同页扫描方式：剥掉 SVG 图标后按 `<section class="page">` 逐页抽按钮文案
  （`<svg>` 嵌套曾让首版扫描漏掉页头按钮），再比页内同名。实测处置 **4 处同页重复入口**：
  总览「立即蒸馏」(页头) + 「蒸馏」(操作卡)；深睡「立即进入深睡」(页头) + 「立即深睡」(状态分布卡)；
  画像「压缩画像」(页头) + 「压缩」(USER 卡)；深睡结构操作 3 枚同名「执行」(v4 已改)。
  并明确**行级重复不算重复入口**：记忆库「升格×3/降格×3/复制回 notes/×2」、深睡「查看×3」、
  观测「堆栈×2」均为按行渲染，不处置。
  ④ **同页重复展示**：确立「**徽章行只承载状态（色点+状态词），数值集中在卡片**」——总览 4 枚徽章
  由「蒸馏 128 次 / 记忆 62% / 判据台账 1,284 行 / 库版本 417 提交」改为状态态，数值各留一处；
  记忆库页索引 Tab 头的重复容量数字去掉。
  ⑤ **记忆库容量条一并改**（本轮裁决延伸）：只有**真实容量门**的载体才给百分比与进度条——
  MEMORY.md 补显式 **62%** + 条 + 注明容量门来源（`scheduler.json capMemory` / `criteria-gate.json caps` 同值）；
  `notes/`（原 34%）与 `pending`（原 18%）**无容量门 ⇒ 去掉伪百分比**，只报绝对量；
  画像页 78% / 48% 保留（真门 `capUser`/`capAgent`）。
  落地时须同步改 `client.js`：`renderPersona` L2159-2166（恢复百分比 + 改写 L2159-2161 注释，该注释现写
  「不含百分比」，不改则注释与实现互指为假）+ `renderMemoryExpanded` 容量区（去 notes/pending 伪条）。
  **样式层无需去重**：`node scripts/audit-css-usage.mjs` 实测死规则 **0** / 同层重复定义 **0** /
  缺样式 1（白名单 `sc-fold-mark`）——只需把新增 Tab/KPI CSS 按六层结构落位并与 JS 同批。
  DOM 级验收：Chrome 真渲染后 dump DOM 断言 **28 PASS / 0 FAIL**（同页各动作仅 1 枚按钮、同页数值各 1 处）。
  **代码未改**（`client.js` == HEAD `9f6c920`）；本条只交设计与台账，落地待排期。

- **🧪 `targets.ts` 直接单测落地（2026-09-12 22:00）—— 计划 §六 自评的「第一风险」收口**
  终极方案 §六原文：「**不切碎 `targets.ts`**（33 导出偏宽，但纯函数无状态）——**先补直接单测**。
  它是当前**第一风险**：扇入 7 却零直接单测，坏了 7 个模块一起错。补测试优先级高于切分。」
  新增 `scripts/test-targets.mjs`（**59 条断言 · 0 fail**），直接 import 编译产物 `lib/targets.js`，
  不经任何上层装配。九组：路径派生 / `resolveBaseName` / 白名单门禁（含**路径穿越**与**大小写**口径）/
  载体层单一实现 / 同 § 族键与竞争性抑制 / 词法 token 地板 / 装配矩阵**全仓唯一实现** /
  临时夹具库真读召回 / `selftestMatrix` 形状。
  **两条口径值得留档**：① 载体层期望值**数据驱动自 `CARRIERS` 注册表**，不抄第二份标签名单——
  抄一份就是 ADR-130 明令禁止的「同一事实的第二份副本」；② 夹具把「带列表短横的 `- [原则] …`」
  作**负例**钉住：那是**注入渲染后的形态**，库内规范行首必须直接是 `[tag]`（实测真库
  `scanIndexRows` 得 81 条薄行：AGENT 15 / MEMORY 58 / USER 8）。
  已按纪律登记进 `check-runner.mjs` 的 `CHECKS`（**未登记=等于没写**）⇒ `npm test` 现为 **30 pass · 1 xfail**。

- **📄 文档偏移修正（2026-09-12 21:45）—— `docs/ARCHITECTURE.md` 两处失效表述**
  ① **机制已不存在却仍在自述**：文档第 4 行与 §8 第 4 条都写着「代码变更后按指纹过期重生成
  （指纹 = src/** + 本文）」，而该机制已随治理插件（project-nav）**0.10 换代被移除**
  （实测 `verify-install.ps1` 输出「架构档指纹机制已移除」）⇒ 改为「人工重生成 + 治理模型登记落点检测」，
  并明写**文档与代码不一致已无机器兜底，属人工纪律**（这正是"文档写了机制、机制已删"这类静默偏移）。
  ② **载体错位**：§3 模块表把 M7 深睡记为 `distill.ts` FSM、M8 注入记为 `panel.ts` —— 那是 A–D **之前**
  的单体形态。已改为真实归属（深睡 FSM = `deepsleep-machine.ts`，阶段 D 迁出；注入 = `panel-shared.ts`
  的 `buildHotMemoryText` + `mcl.ts` 慢通道），并补「**44 模块按领域分家**」的载体归属口径一段。

- **🧹 废弃遗留清理（2026-09-12 21:40）—— 根治 A–D 的一次性手术脚本出仓**
  根治期间为机械拆分写的 **8 个 `scripts/_tmp-*.mjs`**（`_tmp-rename` / `_tmp-split-distill1` /
  `_tmp-rewrite-distill1` / `_tmp-post1..3` / `_tmp-move-mount` / `_tmp-tidy`）是**用完即弃**的
  一次性脚本（彼此自洽、仅互相引用，自述「每次重新生成后都要跑一次」），却**误入公开仓**——
  而 `package.json` 的 `files` 含 `scripts` ⇒ **它们被打进了发行包**，用户装到的副本里同样有这 8 件。
  已 `git rm` 并**根部解决**：`.gitignore` 增 `scripts/_tmp-*`，此后同类脚本不再可能被 add。
  内容可从 `HEAD` 逐件恢复（清理时 8/8 blob 哈希已核）。
  保留 `scripts/audit-inner-fns.mjs`——它是 CHANGELOG:244 明确记录的交付工具（闭包内部跨度测量），
  不属残留；但其**报告态**职责已被棘轮门禁 `audit-fnspan` 覆盖，仅作选刀分析工具留存。

- **✅ 架构根治 A–D 收尾（2026-09-12 21:25）—— 从「仓内绿」推到「运行态绿」**
  阶段 D 的三条棘轮基线经复核**已全部收紧到位**：`audit-wiring` I1/I2 实测 **0/0 对基线 0/0**、
  `audit-fnspan` 债务 **实测 0 / 基线 0**（最大函数 350 行）。收尾补上三件真正没做完的事：
  1. **兑现 I2 扫描面悬空承诺**：`audit-wiring.mjs` 原注「`Ctx` 后缀暂未纳入…阶段 B 拆完再一起收」，
     阶段 B 已把 `DeepSleepCtx` 拆到 **7 字段**，故收尾把 I2 两条分支统一为后缀 `(Scope|Deps|Ctx)`
     —— 实测宽面违规 **接口 0 / 字面量 0** ⇒ **纯收紧，不放松任何基线**。
     （不补这一刀，`XxxCtx` 就是下一个「改名即绕过」的门禁缺口，与假绿同型。）
  2. **部署副本同步（本轮唯一真阻断）**：安装副本此前停在**重构之前**（`lib/` 33 件旧代单体），
     `check-installed-sync` 报 99 件漂移，而三道仓内门全绿 ⇒ 修复根本没在运行。
     按公开树（`git ls-files`，避开 gitignore 的 devref）覆盖差异：**242 文件 sha256 逐件一致、
     副本零额外文件、漂移归零**；热重载后 fiber active，`shoucang_suite` / `shoucang_targets_probe`
     返真数据，面板 `/suite` `/criteria` `/mcl/status` `/config/recent` 全 **HTTP 200**，
     调度器**实跑一轮蒸馏并推进水位 556→669**（走的正是阶段 C 重构的水位/分段代码路径）。
  3. **文档落点校订**：`AGENTS.md` 模块数 43 → **44**，补 `deepsleep-machine`（阶段 D 迁出的会话状态机），
     脚本清单补齐三条架构门禁与 7 件测试；阶段 D 原文时间戳 21:40 改为**提交实际时间 21:00**。
  4. **补齐 §五 最后一行未达标项**：终极方案 §五「任一实现函数的依赖宽度 最大 23 → **≤ 8**」中，
     `PreStepDeps`（阶段 D-2 迁出 pre-step handler 时「依赖 9 项显式传递」）实测 **9 > 8**，属漏网。
     按计划自身的「棘轮只许收紧、不放松标准」补掉：把注入面三个纯函数 `material`/`judge`/`mkMsg`
     收进 `tools` 一组 ⇒ **9 → 7 项**（收组只动引用面最小的一侧：三函数共 5 处引用，会话态 15 处不动）。
     ⚠ **记一条口径教训**：`audit-wiring` 的 I2 阈值是 **12**，故 9 项**门禁不报红**——
     **「门禁通过」不等于「计划验收达标」**，门禁阈值是不得再退的下界，不能替代计划写的验收线。
     只有把 §五 逐行对实测，才捞得回这一项；`typecheck` 0 错、`npm test` 仍 29 pass · 1 xfail。

- **✅ 根治阶段 D 完成 + 兼容转发层退役（2026-09-12 21:00）—— 验收标准全部达成**
  **D-1** `consolidateTree` 411 → **350 行**（`coreName`/`biContains`/`rewriteRowPointers` 三个纯工具闭包提模块级）；
  **D-2** `registerMcl` 200 → **108 行**（93 行 `agent/pre-step` handler 提到模块级 `handlePreStep`，
  依赖 9 项显式传递；`cfg` 是**形参**不是 body 里的 const，依赖测绘易漏，已补注释）；
  **D-3** `createDeepSleep` 232 → **114 行**：会话状态机（noteEvent / 启动回放 / 巡检 / 快照 /
  手动触发 / 配置）整体迁至新件 `deepsleep-machine.ts`，状态以 `SleepMachine` 箱按引用操作
  （标量字段必须装箱，否则写不回装配层）；
  **D-4** `applyForgetOps` 125 → **120 行**（归档开档抽成 `openForgetArchive`）。
  **退役兼容转发层**：`distill.ts` 的 `export * from './deepsleep-core.js'` 与
  `export { isNoiseIntent, CANDIDATE_NOISE } from …` 一并删除，三个消费方（deepsleep-share /
  activation-calib / test-deepsleep-verdict / test-watermark-guard）改指**真实归属模块**。
  ⇒ `distill` 转发 **24 → 0**（比方案的 ≤8 更彻底：转发本身就不该存在）。
  **棘轮终态**：`audit-wiring` I1 基线 3 → **0**；`audit-fnspan` 债务基线 → **0**。
  **验收对照**：装配函数违规 5 → **0** ✅ · 作用域团块 1 → **0** ✅ · 跨度债务 4 → **0** ✅ ·
  循环依赖 0/0 → **0/0** ✅ · 转发 24 → **0** ✅ · `npm test` 不退化（29 pass · 1 xfail）✅。
  ⚠ 两处门禁自测的**扫描面与断言形态**跟着代码走：`test-wiring-gate`(+AST) 增扫
  `deepsleep-machine.ts`；水位字段装箱后左值由裸标识符变为 `m.lastDeepSleepAt`，断言相应改成
  「属性名匹配」。**顺带修掉一处 CRLF 陷阱**：源码是 CRLF，变异串里字面量 `
` 锚不住 ⇒
  变体静默失效被判 FAIL（已改 `
?
`）。

- **🔪 根治阶段 C-2c/2d：装配层收敛到 114 行（`registerDistill` 1440 → 114，2026-09-12 21:20）**
  **C-2c**：`distill-bank`(3 依赖：bank-git / sleep-selfcheck 子进程) + `distill-embed`(1)；
  机械拼接留下的成片空行收缩（AST 定位模板串区间，只压其外的连续空行）。
  **C-2d**：3 个 `ctx.on` + 6 个 `ctx.effect` 注册块整块移入 `distill-hooks.mountDistillEvents`；
  11 个路径常量下沉到 `distill-paths.createDistillPaths()`。
  ⇒ `registerDistill` 现在**只有**「构造 9 个领域句柄 → 调 mount → 返回句柄」，
  **满足 I1 的三条判据**（看不到业务分支、依赖一行读完、可单独替换）。
  `HooksDeps` 的 13 个扁平依赖按领域收进 5 组（io/dom/state/sleep/env）；
  字段名从 `agent/st/ds` 改为 `distill/state/sleep` —— 迁入的注册块里有
  `const agent = ctx.agents.get(sid)` 等**局部同名变量**，整体改名会把局部名改坏。
  **棘轮收紧**：`audit-wiring` I1 基线 4 → **3**；`audit-fnspan` 债务基线 2 → **1**。

- **🔪 根治阶段 C：`registerDistill` 1440 → 365 行，按领域分家（2026-09-12 20:40）**
  分三批迁出（每批一次 `git commit`，均可回滚）：
  **C-1** `distill-infra`(8) / `distill-candidates`(3) / `distill-watermark`(5) /
  `distill-llm`(4) / `distill-parent`(4) + `distill-state.ts`（可变状态装箱）+ `distill-proc.ts`（破环）；
  **C-2a** `distill-write`(8) / `distill-activation`(7)；
  **C-2b** `distill-agent`(7 个领域子对象) / `distill-hooks`(10) / `distill-chunks.ts`（分块工具破环）。
  形态统一：实现全在**模块级**、依赖作首参 `d: XxxDeps`、对外只暴露 `createXxxApi(d)` 返回
  **保类型**的绑定句柄（`Tail<Parameters<typeof f>>`，不写 `any`）。
  `distill-agent` 的 15 个扁平依赖按**领域子对象**收进 7 个（io/wm/write/llm/cand/parent/env），
  满足方案判据「任一实现函数的依赖能在一行里读完」。

- **🧭 架构门禁两处度量修正（2026-09-12 20:40，阈值均未放松）**
  1. **扇入**不再单独定罪：改为 SDP 的**不稳定度** `I = Ce/(Ce+Ca)` 联合判据
     （扇入 > 8 **且** I > 0.3 才违规）。原口径会把 `vec`（扇入 9、扇出仅 3 ⇒ 谁也改不动它）
     这类稳定核心件误判成耦合风险。扇入硬阈值仍是 8。
  2. **分层深度**改按**运行时边**（value+dynamic）判定，静态深度照常打印。
     原因：type-only 导入编译期即擦除、不产生运行时耦合，计入分层会得到自相矛盾的结果——
     实测 `distill-hooks` 运行时扇出为 **0**，却因 `import type { AgentApi }` 被排到第 6 层。
     现运行时深度 9 ≤ 10（静态 12，报告可见）。这与该件早已对扇入扇出排除 type 边的口径**一致化**。

- **📐 治理文档同步**：`AGENTS.md` 结构表更新为拆分后的模块清单（`src/` 已由 14 模块增至 40）。

- **🔪 根治阶段 B：拆掉 `DsScope` 32 字段团块，深睡按领域分家（2026-09-12 20:10）**
  上一轮我把函数提到模块级后「把依赖整体传下去」⇒ 必然产出 `DsScope`（32 字段）—— **显式了，没变少**。
  本阶段按**领域分组**重做注入面（这是本轮根因的复发点，方案里已写为禁止项）。
  **① `DeepSleepCtx` 32 字段 → 7 个领域分组**（`io` 8 / `cfg` 4 / `llm` 5 / `session` 4 /
  `write` 5 / `housekeep` 3 / `appCtx` 1），每组内部 ≤8。契约抽到新件 `deepsleep-contract.ts`
  （零运行时依赖，领域模块的类型汇聚点，避免 deepsleep ↔ 领域模块的环）。
  **② 五个大函数迁出为独立领域模块，各自只拿 3–7 个依赖**：
  `deepsleep-traces`(3) / `deepsleep-tree`(3) / `deepsleep-apply`(7) /
  `deepsleep-probe`(5) / `deepsleep-materials`(**0**，纯读) / `deepsleep-run`(编排器 8 个分组)。
  **③ 顺带降跨度**：材料采集相（148 行 IIFE 串，零依赖）从 `runDeepSleep` 抽出
  ⇒ `runDeepSleep` 406 → **256**；`applyPrinciples` 落盘块抽出 ⇒ 121 → **97**（越过 I1 的 120 线）。
  **④ `DsScope` 已删除** ⇒ `audit-wiring` **I2 实测 1 → 0**（基线同步收紧到 0）。
  **⑤ 门禁自测的扫描面跟着代码走**：`test-wiring-gate`(+AST 版) 增扫 `deepsleep-run.ts` /
  `deepsleep-apply.ts` —— 否则变体字符串失效会「变体未命中 ⇒ 判失败」，这是它们**应有**的行为。
  **⑥ 架构门禁修一处假阳**：扇入门禁不再作用于 `fan-out = 0` 的纯事实源（criteria.generated）。
  SDP 说的正是「依赖要指向稳定件」；扇出 0 = 谁也改不动它 ⇒ 被 9 个模块依赖是**设计意图**，
  不是耦合风险。收窄口径而非放阈值（阈值仍 8 未动）。
  **`npm test` PASS（29 pass · 1 xfail）**；零循环依赖未退化（静态 0 / 动态隐藏 0）。
  遗留（阶段 D）：`createDeepSleep` 232 行、`consolidateTree` 411 行仍在 I1 / 跨度债务里。

- **🔪 根治阶段 A：`panel.ts` 巨型工厂闭包按领域切开（2026-09-12 19:10）**
  根因不是「文件太大」，而是**依赖按「模块闭包」打包**：`applyPanel` 1817 行里 60+ 个定义互相可见，
  任何一块实现都能看到全部依赖 ⇒ 无法单独测试/替换，按领域切的时候只能把整个扁平命名空间重新打包。
  **① 拆分结果**：`panel.ts` 1903 行 → **装配 77 行** + 5 个领域模块
  `panel-shared`(539 公共基元) / `panel-config`(314) / `panel-memory`(389) /
  `panel-observe`(365) / `panel-inject`(426)；**34 条路由一条不少**（`test-panel-wiring` 契约在册）。
  **② 依赖窄传，不是换了个名字的团块**：各领域只拿自己要的 3–7 个
  （`ConfigDeps` 6 / `MemoryDeps` 3 / `ObserveDeps` 3 / `InjectDeps` 7 / `HotMemoryDeps` 2），
  日志只给 `PanelLogger`（不含整个 host ctx）；`ctx` 仅 `registerInject` 一个入口持有（`ctx.effect` 需要）。
  **③ 装配层终于变薄**：`applyPanel` 只剩「构造 → 注册」，看不到任何业务分支。
  **④ 结构陷阱已规避**：1628 之后的 8 条路由原本包在 `ctx.effect` 回调里（1588–1902），
  整块搬进 `panel-inject.mountInjectEffect`，未切飞 effect 的 `return disposer`。
  **⑤ 三处只读 `src/panel.ts` 的源码扫描件同步改为扫 `src/panel*.ts`**
  （`check-ui-contract` / `check-carriers` / `test-carrier-layers`）—— 否则端点散了会得到「0 个端点」的假结论。
  **⑥ 门禁同步收紧（只许收紧不许放松）**：`audit-fnspan` 债务基线 4 → **3**；
  `audit-wiring` I1 基线 5 → **4**；I2 **加严**：除 `const X: *Scope = {…}` 外，新增
  **接口声明本身**的字段数检查（后缀 `*Scope|*Deps`）—— 只认 `*Scope` 名字的话，把团块改名 `XxxDeps` 就能绕过。
  反向证伪：注入 13 字段 `FalsifyDeps` ⇒ I2 实测 2/基线 1 **判红** ✅。
  `npm test` **PASS（29 pass · 1 xfail）**，零循环依赖未退化（静态 0 / 动态隐藏 0）。

- **🏛 新增架构门禁 `scripts/audit-architecture.mjs`（2026-09-12 14:50）**
  起因：全仓对「代码写对没有」有 25 道门禁，对「**结构有没有烂掉**」**一道都没有** —— 零循环依赖这
  条最值钱的性质此前**无人守护**，任何人加一个 `import` 就能引入环且不报错。
  **① 新增审计件**：静态分析模块依赖图，输出拓扑分层 / 静态环 / 动态边隐藏环 / 扇入扇出 / 接口宽度 /
  顶层可变全局；三态 `--gate`（CI）/ 默认报告 / `--json`，`--dir` 支持绝对路径（供 tmp 副本反向证伪）。
  与既有件分工：`test-layering.mjs` 测记忆成熟度分层（**不是**代码架构）、`check-srcmap.mjs` 管
  src↔lib 产物漂移，本件管依赖图结构性质。
  **② 阈值是棘轮（只许收紧不许放松）**：行数 3600 / 导出 35 / 扇入 8 / **环 0（严格）** / 深度 10，
  均取「当前实测 + 余量」⇒ **当前全部通过、不制造红灯**。刻意避免永久红灯 —— 人人学会无视的红灯
  等于把假绿换成假红（G-22 教训）。
  **③ 反向证伪三组全过**：干净副本 exit 0；注入 `zz-a↔zz-b` 环 ⇒ exit 1 且准确定位；`distill.ts`
  撑到 3712 行 ⇒ exit 1。变异在 `os.tmpdir()` 副本做，不把 src 改成缺陷态。
  **④ 登记进 `check-runner.mjs` CHECKS**（第 26 项，规则 6：未登记=没写）。`npm test` PASS
  （24 pass · 1 xfail · 0 skip），xfail 仍是既有 `test-treeops-rm.mjs`。
  **⑤ 体检结论**（详见 `deliverables/architecture-review-2026-09-12.md`）：src/ 14 模块 9187 行、
  深度 7、**静态环 0 + 动态隐藏环 0**、无跨模块共享可变状态（4 处可变全局经逐一核对全良性）、
  事实源单一 —— 骨架合格。但 `distill.ts` 3512 行（38.2%）且变更 81 次（第二名 1.65 倍），
  深睡标识符 **172 处贯穿 163–3510 行**⇒ 一个模块装了两个变化原因，列 🔴 P1，建议分期拆分。
- **🏛 架构根治 P1 一期：深睡判据层抽为 `src/deepsleep-core.ts`（2026-09-12 15:00）**
  **病根**：不是"文件大"，而是 **`registerDistill` 是单个 2835 行的函数**（677–3512 行），
  五个工具 + 深睡状态机 + 水位逻辑 + 父子会话追踪全塞在这个闭包里，靠闭包共享可变状态；
  深睡标识符 **172 处贯穿 163–3510 行**（交织而非分段）⇒ 任何深睡改动都要穿针引线。
  **① 迁出三块**（原 219–269 / 290–318 / 337–633，共 377 行）到新 `src/deepsleep-core.ts`：
  会话活跃状态机 FSM 类型（SessState / DeepSleepStatus / SessRec）、`DEEP_SLEEP_PROMPT`、
  `COMMIT_FAILED_GATE` `deepSleepLanded` `planDeepSleepVerdict` `liveFailPolicy`
  `deepSleepReplayable` `commitPrinciples` `planDiscardWrite` `planDegradedBaseline`
  `planSkipWatermark` `runDiscardWatermark` `resolveWatermarkBaseline` 及配套类型。
  **刻意不迁** 320–335 的 `CANDIDATE_NOISE` / `isNoiseIntent` —— 属**蒸馏侧**，误迁会让深睡层
  反向依赖蒸馏概念，制造新的错向依赖。
  **② 成果（实测）**：`distill.ts` 3512 → **3149 行**；自身导出 **30 → 8**（−73%）；
  静态/动态循环依赖仍为 **0/0**；`npm test` 24 pass · 1 xfail · 0 skip（无回退）。
  **③ 零 API 破坏**：distill.ts 用 `export * from './deepsleep-core.js'` 过渡兼容，
  两个行为测试件 import 不断链（09-12 已栽过「重命名后测试件断链」）。
  **④ 连带必须同步项（同型坑第二次）**：两个接线闸硬编码只扫 `src/distill.ts`，
  而 W1 守的「producer 与 consumer 共享同一常量」中**常量定义与 consumer 已迁走** ⇒ 命中 0 ⇒
  误报「已脱钩」。修法**不是放宽判据**，而是把扫描范围扩到两个文件（二者经 import 仍共享同一常量，
  语义未变）。修改后：文本版 32 PASS/0 FAIL，AST 版 18 项 PASS、13 个破坏变体**全部翻红**。
  **⑤ 门禁按棘轮收紧**：行数 3600 → **3200**；新增「转发数」指标（阈值 30，当前 distill 转发 24）
  —— 只数自身导出会让接口宽度从 30 假降到 8，转发也是对外承诺。三组反向证伪全过。
  **⑥ P1 二期规格已测绘**：`runDeepSleep`（415 行）在闭包内可见的 **89 个变量中只引用 22 个**，
  且其中**仅 2 个是可变状态**（deepSleepFailStreak / providerFailCount）⇒ ctx 设计很轻，
  拆分从"勇气问题"变成"22 行字段清单"。**二期等部署链路恢复再动**。
- **🏛 架构根治 P1 二期：深睡状态机迁为 `src/deepsleep.ts`（2026-09-12 15:20）**
  接一期，把 `registerDistill` 里剩下的深睡**状态机主体**迁出：块A（1344–2141，状态/traces/三通道/
  consolidateTree）+ 块B（2259–2879，runDeepSleep/探测/对外 API），共 1419 行。
  **① 依赖倒置打破循环依赖（关键设计）**：深睡**会回调蒸馏**（distillAgent / writeDispatch），
  若让 deepsleep 直接 import distill 就形成 distill↔deepsleep 环，会破坏本项目最值钱的「零环」性质。
  ⇒ 24 项外部依赖全部经 `DeepSleepCtx` **注入**，deepsleep.ts **零 import distill**。
  实测依赖方向：distill(L4) → deepsleep(L3) → deepsleep-core(L2) → criteria.generated(L1)，**零环保持**。
  **② 零逻辑改动迁出**：`createDeepSleep(ctx)` 用工厂闭包 + 解构（`appCtx: ctx` 重命名回 ctx），
  使 1419 行代码**缩进不变、裸名不变**地整体迁移，把变更风险压到最低。
  **③ 共享可变状态改为引用传递**：`providerFailCount` 由蒸馏与深睡**双方读写**（11 处），
  改为 `llmState` 对象引用传入；传值快照会让两侧计数脱钩。
  `probeScriptPath` 为两侧共用 ⇒ 留在 distill 并注入深睡（放深睡侧会导致蒸馏反向依赖）。
  **④ 成果（实测）**：`distill.ts` **3512 → 1750 行**；新增 `deepsleep.ts` 1519 行；
  静态/动态循环依赖仍 **0/0**；`npm test` 24 pass · 1 xfail · 0 skip。
  **⑤ 接线闸第三次扩范围**（同型坑第三次）：W2/W3/W4 锚点随迁至 deepsleep.ts，
  扫描列表扩为 distill + deepsleep + deepsleep-core。修改后两闸恢复（文本版 32 PASS、AST 版 18 项、
  13 个破坏变体全部翻红）。
  **⑥ 审计工具修一处自身误报**：`deepsleep.ts` 头注释写了「不要 import './distill.js'」，
  未剥注释时被当成真 import ⇒ **凭空报出循环依赖**。已加 `stripComments`（只剥行首注释与块注释）。
  剥离后仍能在 tmp 副本上检出注入的真环（3 处）⇒ 不是靠"不检测"绕过。
  **⑦ 门禁按棘轮收紧**：行数 3200 → **2000**（distill 1750 / deepsleep 1519）。
  **⑧ 剩余（P1 三期）**：deepsleep.ts 内部仍是工厂闭包，待逐函数提到模块级（显式传 ctx）。
- **🏛 架构根治 P1 二期续：新增深睡接线契约测试 + 登记进检查清单（2026-09-12 16:10）**
  **起因（为什么 typecheck 不够）**：一/二期共迁出 1796 行，验收靠 typecheck 与既有门禁，
  但 **typecheck 只证明类型对，证明不了「东西还在、还跑得起来」** —— 漏返回一个句柄、
  ctx 少注入一个字段、装配时炸掉，类型上全都过得去。
  **① 新增 `scripts/test-deepsleep-wiring.mjs`**：用**全 mock `DeepSleepCtx`**（24 字段注入）
  直接驱动 `createDeepSleep`，验 6 组 18 条：装配不抛 / 9 个句柄齐全（含 `sessions` 是 Map、
  `DEEP_SLEEP_CHECK_MS` 未被改动）/ 状态机**真跑**（noteEvent → RUNNING → ENDED、lastEventAt 写入）/
  重复事件不增记录 / 快照 12 字段完整 / **双实例隔离**（证明状态没被提到模块级共享）。
  与既有件分工：`test-deepsleep-verdict` 测判据纯函数、`test-wiring-gate{,-ast}` 锁源码形状、
  本件测**装配后的运行时行为**。
  **② 登记进 `check-runner.mjs` CHECKS**（第 10 项，规则 6：未登记=等于没写）。
  **③ 反向证伪两组全过（node 自身退出码，非管道码）**：`noteEvent` 掏空（形状还在、行为没了）
  ⇒ 13 PASS/5 FAIL、**exit 1**；少返回 `getConfig` 句柄 ⇒ 17 PASS/1 FAIL、**exit 1**；
  还原后 18 PASS/0 FAIL、**exit 0**，且 `lib/deepsleep.js` sha1 与变异前逐字节一致（git 无 diff）。
  **⚠ 踩坑：管道里的 `$?` 取的是 `tail` 的退出码** —— 首轮两个变体都显示 `exit=0`，差点误读成
  「变体没翻红」。必须 `node ... > file 2>&1; echo $?`，不能 `node ... | tail`。
  **④ 快照 sid 是截断短串**（`session-` 开头取 `slice(8,16)`）—— 给 UI 显示用，**设计而非 bug**；
  用全等匹配会永远匹配不上，故断言用「原串包含短串」。
  **⑤ 门禁**：`npm test` PASS（**25 pass · 1 xfail · 0 skip**，26 项），xfail 仍是既有 `test-treeops-rm.mjs`。
- **🏛 新增第二道架构门禁 `scripts/audit-fnspan.mjs`：守「单函数跨度」这个真病灶（2026-09-12 16:20）**
  **① 为什么再开一道**：一/二期把 `distill.ts` 从 3512 拆到 1750 行，但**「文件行数」不是真病灶** ——
  文件行数会随拆分发散，单函数跨度不会。复测发现全仓 >400 行的函数共 **4 个**，全是
  `applyXxx(ctx)` **工厂闭包**：`panel.ts:applyPanel` **1817 行（全仓第一，已超过拆分后的 distill）**、
  `distill.ts:registerDistill` 1435、`deepsleep.ts:createDeepSleep` 1434、`scheduler.ts:applyScheduler` 430。
  ⇒ 根病是**同一个模板被复用了四次**（闭包内 60+ 定义），不是四个独立问题。
  **② 双层棘轮（关键设计，防止假绿）**：只设一个阈值 ⇒ 当前最大 1817，取 2000 的话
  **今天谁也碰不到** ⇒ 恒绿 = 守了个寂寞（与「永久红灯人人无视」同型、方向相反）。故两层：
  **硬顶**任一函数 ≤ 2000 行（防新增怪物）+ **债务计数** >400 行的函数 ≤ **4 个**（棘轮基线），
  新增任何一个 ⇒ 5>4 **立刻红**；拆掉一个 ⇒ 实测 < 基线 ⇒ 提示**收紧基线**（只许收紧不许放松）。
  **③ 反向证伪四组全过（node 自身退出码）**：干净副本 PASS(exit 0)；注入 460 行函数 ⇒ 债务 5>4
  **FAIL(exit 1)**；注入 2202 行 ⇒ 破硬顶 **FAIL(exit 1)** 且准确定位 `panel.ts:2369-4570`；
  基线改松到 7 ⇒ 触发「请收紧到 4」。变异在临时副本做，真实 `src/` 未改动（git 无 diff）。
  **⚠ 踩坑：`node /tmp/x.mjs` 在 Git Bash 下会解析成 `D:\tmp\x.mjs` ⇒ ENOENT 且 exit 1，
  极易误读成"变体翻红了"。临时脚本必须 `node "$(cygpath -w /tmp/x.mjs)"`。**
  **④ 结论修正（推翻此前「不要急着拆 panel」）**：fan-in=0 只说明**改它不连累别人**，
  不说明**改它自己不难** —— 1817 行单体函数里改一处要在 61 个闭包定义中穿针引线。
  按「变更频次 × 单函数跨度」粗排：`distill` 82×1435 ≈ 11.8 万 > `panel` 49×1817 ≈ 8.9 万。
  建议顺序：deepsleep 工厂闭包 → panel 按路由域切（32 个 `route()` 天然分 6 组，`/set` 单端点 350 行
  是最大一块）→ distill 剩余 → scheduler。**panel 零单测，拆前须先建路由契约测试。**
  **⑤ 门禁**：登记进 `check-runner.mjs`（第 27 项），`npm test` PASS（**26 pass · 1 xfail · 0 skip**）。
- **🔧 函数跨度门禁修三类误报：改用 TS 编译器 API 取精确 span（2026-09-12 17:00）**
  正则版连栽三处，**每一处都会让门禁误判**：
  ① 靠「下一个缩进 ≤ 自己的定义」定终点 ⇒ `scheduler:llmModels` 真实 **19 行**被报成 **428 行**
     （它之后没有同缩进定义了，终点退化到文件尾），**差 22 倍**；
  ② 改成花括号配对 ⇒ 模板串/字符串里的花括号让计数失准，`registerDistill`(1436 行) **整个消失** ——
     **假阴性比假阳性危险得多**（门禁会少报债务、还看不出来）；
  ③ 靠 `=>` 认函数 ⇒ `const llm = (ctx as {...}).llm as { f?: () => unknown }` 里
     **类型注解的 `=>`** 被当成箭头函数（`llm` 误报 425 行）。
  ⇒ 改用 `ts.createSourceFile` 遍历 AST 取精确位置（项目本就有 typescript 依赖，规则 5：不造轮子）。
  **顺带修一个指标缺陷（更重要）**：首版只数列 0 的顶层函数 ⇒ 嵌套的 `consolidateTree`(410) /
  `runDeepSleep`(405) 被父函数**藏起来**了，且形成**反向激励**——把所有东西塞进一个大闭包指标反而
  更好看，一旦提取成模块级函数指标立刻变差 ⇒ 等于**用门禁惩罚正确的重构**。现改为统计所有嵌套层级。
  债务基线按新口径重定为 **6**。新增 `scripts/audit-inner-fns.mjs`（闭包内部跨度测量，拆分选刀用）。
- **🏛 架构根治 P2 一期：`scheduler.ts:applyScheduler` 430 行拆为 5 个工具工厂（2026-09-12 17:10）**
  **① 迁移动作**：`applyScheduler`（240–669，430 行，全仓第 4 大函数）拆为模块级函数 ——
  5 个工具工厂 `suiteTool` / `verifyTool` / `targetsProbeTool` / `recallTool` / `capabilitiesTool`，
  加 `llmModelsOf` / `distillOptionsOf`（55 行参数映射的唯一映射点）/ `schedulerShareApiOf` / `assembleMcl`；
  本体收敛为 **25 行**的装配清单。
  **② 顺带消掉一个真实隐患**：原实现在 `enableDistill` 开/关**两条分支各写了一份完全相同的
  share 装配对象**（15 行 ×2），改一处漏一处就会让 panel 的 `/suite` 与 `/distill/config` 读数漂移。
  现合并为 `schedulerShareApiOf()` 单一实现。
  **③ 搬移方式：脚本切片，不手工重打**。430 行靠一次性脚本按**已核准的行号区间**切片 + 按首行缩进
  自动 dedent，避免手抄出错；随后由 `typecheck` 兜底。三个坑：
  · 对象字面量的 `{`/`}` **在边界行上**（`registerDistill(ctx, {` / `schedulerShare.api = {`），
    只切属性行会漏 ⇒ `return   nodeBin:` 直接语法错；
  · `defineTool({...})` 块的末行 `}),` 那个逗号是 **`register(x, 'label')` 的参数分隔符**，
    搬到 `return x` 后成尾随逗号 ⇒ 5 处 TS1005/TS1109，须剥掉；
  · 切片终点差一行就会整块失配（recall 实际在 476 收尾，不是 475）。
  **④ 棘轮收紧**：债务基线 **6 → 5**（`applyScheduler` 退出 >400 行债务榜）。
  **⑤ 补安全网 `scripts/test-scheduler-wiring.mjs`（20 条，已登记第 11 项）**：黑盒验五个工具在册且
  名字未变 / 开关语义（`verify_enabled=false` 只摘 verify）/ share 面字段 / **蒸馏器关闭时 share 仍装配**
  （就是 ② 那个隐患的回归锁）/ `llmModels` 无宿主时返回数组而非抛。
  **⚠ 两个坑**：`lib/scheduler.js` 依赖的 `@deepseek-ai/dsh-scope` **只在宿主运行时提供、开发机没有**
  ⇒ 直接 import 会 ERR_MODULE_NOT_FOUND，装配面**根本测不了**；改用 ESM 解析钩子把 `@deepseek-ai/dsh-tools`
  重定向到 data-URL stub（`scripts/test-dsh-tools-hook.mjs`），不污染 node_modules、不新增 stub 文件。
  另：首轮 F2 变体是**崩溃退出**而非断言失败（`api` 为 undefined 直接抛）⇒ 与门禁同型问题，
  已改为防御式取值，现在渲染 6 条 ❌ 而不是栈。
  **⑥ 反向证伪**：改名 `shoucang_suite` ⇒ 18 PASS/2 FAIL **exit 1**；去掉 share 装配 ⇒ 14 PASS/6 FAIL
  **exit 1**；还原后 20 PASS/0 FAIL **exit 0**，`lib/scheduler.js` sha1 逐字节还原。
  **⑦ 门禁**：`npm test` PASS（**27 pass · 1 xfail · 0 skip**，28 项）。
- **🏛 架构根治 P2 二期：`deepsleep.ts:createDeepSleep` 1434 → 239 行（2026-09-12 17:25）**
  把 6 个大函数提到模块级，依赖经 `DsScope` **显式注入**（此前靠隐式闭包共享 60+ 个名字）：
  `gatherDeepSleepTraces` / `applyPrinciples` / `applyPointerOps` / `consolidateTree` /
  `runDeepSleep` / `probeSession`。`createDeepSleep` 只剩状态声明 + `noteEvent` + 巡检 + 快照 + 对外句柄。
  **① 依赖先算后动**：写脚本用 TS AST 算出每个函数的**自由变量**（= 必须注入的依赖）并标出
  **被赋值的**（`deepSleepFailStreak` / `deepSleepRunning` / `lastDeepSleepAt`），
  避免"搬过去才发现写不回去"。
  **② 标量必须装箱**：`deepSleepFailStreak` 是 `let number` 且 `runDeepSleep` 会**写**它 ——
  解构出来是**快照**，写不回闭包 ⇒ 改为 `streak: { v: number }` 对象引用。
  （可复用的判据：**被赋值的自由变量一律走对象引用，不能解构**。）
  **③ 对外句柄零感知**：`runDeepSleep` / `probeSession` 迁出后需传 S，在 return 处包一层注入，
  调用方（distill 装配点 / panel）签名不变。
  **⚠ 脚本两个坑**：向上吸收注释块后**首行不再是签名**（签名被 dedent 进函数体，模块级残留一个
  没加 S 参数的同名定义，报错形如 "Expected 2 arguments, but got 3"）；以及**留在闭包里的调用点**
  （`deepSleepCheck` / `runDeepSleepNow`）也要补 S，只改迁出的那段会漏。
  **④ 棘轮收紧**：债务 **5 → 4**（`createDeepSleep` 退出 >400 行债务榜）。
  **⑤ 门禁**：`npm test` PASS（27 pass · 1 xfail · 0 skip），既有 18 条深睡契约测试全过。
- **🚀 部署记录（2026-09-12 16:40）：架构根治一/二期上线至插件包 —— commit `391fc6b`**
  **① 开发仓**：三个提交 `567cb9e`（深睡层拆出）→ `6b494c4`（接线契约测试）→ `391fc6b`（函数跨度门禁）
  已 push（`3390aa5..391fc6b`，**本次网络通畅**）。
  **② 插件包**：`~/.dsh/profiles/web/package.json` 依赖重钉为 `#391fc6b984e94c6084482ef8a7df1984a1c6dc81`；
  同步方式沿用**只覆盖差异文件**（不跑 `pnpm install`：上次实测会触发宿主批量删除保护并留下 `_tmp_*`）。
  全量比对 `lib/`（17 js + 17 map + 17 d.ts）后确认 **9 个需同步**：3 改（`distill.js` / `.map` / `distill.d.ts`）
  + **6 新增**（`deepsleep.js` / `deepsleep-core.js` 及各自 map 与 d.ts）。
  **备份先行**（个人目录纪律）：被覆盖的 3 个旧文件 + profile `package.json` 已备份至
  `~/.dsh/_sc-backup-20260912-arch/`，可回滚。
  **③ 验证（四层）**：sha1 逐字节一致（`deepsleep.js=456d833b`、`distill.js=bb39f104`）；
  包内 17 个 `lib/*.js` 全部 `node --check` 通过；**真跑 `import()`** ⇒ `deepsleep.js` 导出 `createDeepSleep`、
  `deepsleep-core.js` 16 个导出、`distill.js` 仍完整转发 `deepSleepLanded` / `planDeepSleepVerdict` 等
  深睡符号（**兼容链未断**，两个行为测试件的 import 不会断）；`check-deploy-sync` PASS
  （100 件检查：一致 65 · 库内缺失 35 属预期 · **不一致 0**）。
  **④ 三个面**：`skill/` 本次未改动 ⇒ 记忆库面（③）无需同步；`lib/client.js` 未改动 ⇒ **无需重启 DSH**。
  **⏳ 待用户操作**：**热重载插件**（宿主侧工具，改动需重载后生效）。
  **⚠ 踩坑：`node --check /c/Users/...` 在 Git Bash 下报 "Cannot find module"** —— node 是 Windows 程序，
  收 `/c/...` 这种 POSIX 路径解析不了。批量校验必须 `node --check "$(cygpath -w "$f")"`，
  否则会把**路径错误**误读成**语法错误**（与前面 `node /tmp/x.mjs` 同型，本日第三次踩到）。
- **🖥 面板 IA 重排 + 新增「运行总览」首屏（2026-09-12 14:40）**
  **① 新增「运行总览」并设为默认视图**：此前默认落在「配置原文」，一进来就是一坨 YAML；「画像板块」首屏也只有两张容量数字 + 长列表，**看不到系统级状态**。新首屏 = 状态徽章行（认知环 / 判据台账 / 库版本 / 向量 / 深睡）+ KPI 四卡（记忆容量 / 蒸馏 / 深睡 / 向量档）+ 快捷操作（立即蒸馏 / 立即深睡 / 运行自检，此前埋在折叠区）+ 最近动态（晨起摘要 delta + 本月深睡产出）+ 系统状态。**数据全部来自现有端点，零新增后端接口**。
  **② 一级导航收敛**：「配置原文」从一级导航降级，并入「设置 → 高级」Tab（YAML 高危低频，不该占一级导航）；「界面设置」并入「设置 → 界面偏好」。导航项改名：画像板块→画像、记忆板块→记忆库、参数调节→参数。
  **③ 图标去重**：此前 `ICONS` 只有 5 个 key 供 8 个视图用 ⇒ `toggles` 被 4 项共用、`file` 被 2 项共用，**导航无法扫读**。新增 `overview` / `suite` / `deepsleep` / `observe` / `settings` 五个独立图标，一项一图标。
  **④ 兼容处理**：新增 `isKnownView()`，深链 `#sc=<视图>` 与 `Cfg.lastView` 均需过校验 —— 旧版存过的 `'file'` 已不在 VIEWS 中，不过滤会渲染成**空白页**。
  **⑤ 新增 `buildTabs()` 视图级 Tab 容器**：切换只改 `.sc-hidden`、不重建 DOM ⇒ 折叠态（Fold）、输入焦点、已加载数据全部保留。
  **⚠ 两个踩坑**：① `test-css-usage-gate` 报 `.sc-tabpanes` 挂类无样式 —— 该门禁要求"挂了类必须有样式或进白名单"，补 `min-width:0` 后通过；② **CSS 数组最后一行必须有尾随逗号** —— 新增的 `@media` 闭合行 `'}'` 漏了逗号，导致 `audit-css-usage.mjs` 反向证伪把变异代码拼进数组后产出 `SyntaxError`，B/C 三节全红（A 节真实源码仍绿，易误判为"门禁坏了"）。补尾随逗号即恢复。
  **门禁**：`npm test` PASS（23 pass · 1 xfail · 0 skip）。`lib/client.js` 已同步。**尚未部署到插件包**（UI 改动需重启 DSH 生效，热重载不换 `client.js`）。
- **🖥 面板 Tab 化第二步：参数页 4 桶 → 4 Tab · 记忆板块 12 分区 → 5 Tab（2026-09-12 15:00）**
  **① 参数页**：`renderViewToggles`（≈620 行，全项目最重的一页）的 4 个平铺桶改为 4 个 Tab，一次只面对一桶。`makeToggle` / `numSetting` 两个工厂（被 20 处复用）**内部不动**，只换外层容器。
  **② 记忆板块**：`renderMemoryExpanded`（≈290 行、12 分区平铺）改为 5 个 Tab —— 索引 / 候选 / 笔记 / 归档 / 运行态，默认落在「索引」（原首屏是徽章行 + 蒸馏运行，信息过载）。**「守藏知识区」按语义并入「索引」Tab**，故分区在代码里不连续（被 pending / notes 隔开），脚本用「多段区间 → 同一 pane」映射实现。
  **⚠ 三个必须记住的坑**：
  ① **批量替换脚本必须同时判上下界**。首版只判下界（`i >= b4`），把 `renderViewToggles` 之后**所有函数**的 `view.appendChild` 都改成了 `pane4.appendChild`（94 行越界）—— `pane4` 是参数页局部变量，在其他函数里是**未定义变量** ⇒ 运行时 ReferenceError，而 **`node --check` 查不出来**（未定义变量只在运行时报）。**教训：语法检查通过 ≠ 正确，批量替换后必须验证"改动是否只落在目标区间内"。**
  ② **共用工厂函数会绕过区间替换**。记忆板块 `var group = function (t) { view.appendChild(...) }` 是**所有分区共用的标题工厂**，写死 `view` ⇒ 分区标题会全部跑到 Tab 容器外面。改为可重指向的 `_gp` 并在每个区间起点赋值。
  ③ `node --check` 不认 `.tmp` 后缀；临时脚本里写本机绝对路径会被 `check-hardcode` 红线抓到（本次实测被抓，删除临时脚本即恢复）。
  **门禁**：与本次改动相关的检查件全绿（check-ui-contract / test-css-usage-gate / test-fold-state / test-ui-derive / check-hardcode / check-deploy-sync）。
  ⚠ **`test-wiring-gate` 与 `test-wiring-gate-ast` 两项 FAIL，与本次 UI 改动无关**：并行的架构重构把 `deepSleepLanded` 拆到新建的 `src/deepsleep-core.ts`，而 W1 闸仍锁在 `src/distill.ts`（复跑 3 次均红，非瞬时读数）。需由重构方同步闸的锚点——与 G-19 落地时踩过的坑同型。
- **🚀 部署记录（2026-09-12 12:40）：UI 重构第二/三轮上线至插件包 —— commit `9f6c920`**
  **① 开发仓**：`9f6c920`（10 files, +1945/-454）已 push 到 `Fishsb/dsh-shoucang-memory`（`1c5b09f..9f6c920`，本次网络通畅）。
  **② 插件包**：`~/.dsh/profiles/web/package.json` 依赖重钉为 `#9f6c920ed7b14ff5fd8871127e72ee3273934561`；**`pnpm install` 失败**——
  ```
  [ERR_PNPM_LINKING_FAILED] [importPackage .../dsh-shoucang-memory]
  [safe-delete][SAFE_DELETE_BULK_CONFIRM_REQUIRED] {"count":50,"threshold":50,"scope":"turn"}
  ```
  非网络问题，是**宿主环境的批量删除保护**（要删旧包 50 个文件，触及阈值）。**好消息是在删除阶段即被拦，旧目录完好无损**，未产生半吊子状态。
  **绕过（实测有效）**：不重试 pnpm（重试只会再留 `_tmp_*` 目录），改为**只覆盖差异文件**——全量比对 `lib/`（15 js + 14 map + 14 ts）后确认只有 `client.js` 不同，故只 `cp` 它。覆盖式不删任何文件 ⇒ 不触发保护。
  **② 验证**：`client.js` 与 `lib/client.js` 的 sha1 均为 `511aa87d9bf5`，与仓逐字节一致；`node --check` 通过；`package.json` 的 `main` 指向 `./lib/index.js` 且存在；`skill/SKILL.md` 存在；`lib/*.js` 全部语法 OK。
  **② 全量面核对（顺带发现并澄清两处「疑似漂移」）**：`skill/scripts/archive-lib.mjs` 与 `test.mjs` 的 sha1 与包内不同，但 `diff` 显示 `1,252c1,252`（全行不同、行数相同）⇒ 剥离 `\r` 后**内容完全一致**，是 **CRLF/LF 行尾差异，非真漂移**，不需同步（强行复制反而会改行尾）。另 `skill/docs/devref/` 与 `.internal/` 在包内缺失属**预期**——它们是 gitignore 的私有开发参考，本就不发布。
  **③ 记忆库**：本次未改 `skill/`，不涉及。另确认一项**既有认知**：`check-deploy-sync` 的 `bank-missing` 是**预期状态**（实测 96 项 = 65 same + 31 bank-missing，其中 27 项如 `build-client`/`check-*`/`test-*` 本就不入库）⇒ 库内 `~/.dsh/skills/managing-memory/scripts/` **只放运行时脚本**，开发机检件不入库，新增机检件出现 bank-missing 属正常。
  **⏳ 待用户操作**：**热重载插件**（宿主侧，改动需重载后生效）。
  **✅ 遗留已清理（2026-09-12 13:05，用户授权）**：`dsh-shoucang-memory_tmp_*` **13 个**残留目录（约 750K，历次 pnpm 失败累积）与项目根 0 字节文件 `{...` 均已**移出**（非直接删除，可恢复）至备份目录 `~/.dsh/_sc-cleanup-backup-20260912/`（2.8M，14 项；`node_modules_tmp/` 13 个 + `repo_root/{...`）。
  **清理方式（可恢复优先）**：分两批（10 + 3）用 `mv` 移入备份目录，而非 `rm`——同分区移动瞬时完成且**随时可回滚**。清理后验证：`node_modules` 下 tmp 残留 **0 个**；插件包 `main`/`skill/SKILL.md`/`lib/` 30 文件完好，`lib/client.js` 语法 OK；`npm test` 仍 PASS（23 pass · 1 xfail）；仓 `git status` 干净。确认无误后可自行删除该备份目录释放空间。
- **🟠 UI 重构（2026-09-12 第三轮 Step 4/5）：CSS 死规则清零 · 空态判据统一 · 徽章构造收敛 —— 自有类 165→146，散落判空 27 处 → 单一入口**
  **① CSS 死规则清零（方面 2「移除无效规则」）**：新建 `scripts/audit-css-usage.mjs`（**双态**：`--gate` 门禁 / 默认报告；CSS **从 client.js 原地 eval 抽取**，与 gen-ui-preview 同源）。首版报 19 个死规则 + 9 处"重复冲突"，逐条核实后：
  - **删 19 个零使用规则**：`sc-vec-group/group-h/row/cell/label/progress/status/ctrl`（早期向量区遗留，现走 `sc-mem-grid` + `setting-item`）；`.sc-empty` + `-icon/-title/-desc`（**第二套空态组件**，在用的是 `.sc-mem-empty`）；`.sc-clamp-2/3`（与 `.sc-pointer-summary` 内联声明重复）；`.sc-scroll-y`（与 `.sc-view`/`.sc-logwrap` 的 overflow 重复）；`.sc-section`（与 `group()` 产出的 `.sc-mem-group-title` + 间距重复）；`.sc-spinner`（加载态已由 `.sc-loading::after` 骨架实现）；`.sc-mem-sub.mono`。CSS **39,871 → 37,233 字符**。
  - **9 处"重复冲突"全部是误报**：首版用"行首是 `@` 才记前缀"追踪 at-rule，导致 `@media` 块内第二条之后的规则被当成顶层 ⇒ 把响应式覆盖当成冲突。改为**栈式追踪**后归零。已把该场景固化为回归用例（`test-css-usage-gate.mjs` ④）。
  - **判定盲区（两处，均已修）**：类名大量来自拼接（`'sc-badge' + kind`、`'sc-log-row sc-log-' + lv`、`'sc-statusbar sc-status-' + level`），子串全等匹配会把**在用**的 `sc-badge-ok` / `sc-log-error` / `sc-status-warn` 误判成死规则（首版 29 → 修正后 19）；映射表裸查 `obj[k]` 会沿原型链命中 `constructor`。另 `.sc-fold-mark` 是**折叠哨兵**（空 div 定位锚点，零高度本就无需样式），走 `ALLOW_NO_STYLE` 白名单并写明理由 —— 白名单条目**必须带理由**（由测试 ⑤ 强制，防开后门）。
  - 新增 `scripts/test-css-usage-gate.mjs`（**6 条**）：基线 PASS + **三处反向证伪**（塞死规则 / 顶层重复 / 挂未定义类 都必须翻红）+ 两处防误报（`@media` 覆盖放行、白名单须带理由）。变异在临时目录做，真实源码不动。
  **② 空态判据统一（方面 1）**：`Derive.has()` / `Derive.count()` 收敛 27 处散落判空 —— `!x.length`（**x 缺失时直接抛错**）、`x && x.length`、`(x || []).length` 三种写法归一。测试新增 `has/count × 12 种取值`（含空串/数字/类数组）与原表达式双跑对照，并加两条源码锁（D7d/D7e）防复活。
  **③ 徽章构造收敛（方面 1「合并重复分支」）**：状态徽标原先 **12 处**各写三行「建 div → 塞 dot → 塞文本」，其中 3 枚异步回填靠 `querySelectorAll('span')[1]` **按 DOM 位置取文本节点**（改结构即断）。统一到新增的 `UI.dsBadge(text, kind)`（返回 `{box, setText, setKind, setTitle}` 句柄，直接持有节点引用）；深睡视图的局部 `dsBadge(state, count, label)` 参数序不同，改为只做参数适配、构造仍走同一实现。测试新增 E 节 6 条（含"调用点 ≥5"防工厂留而不用）。
  **验收**：`node --check client.js` 通过；`npm run build:client` 同步 `lib/client.js`（208,522 字符，**与源逐字节一致**）；**`npm test` PASS（23 pass · 1 xfail · 0 skip）**，xfail 仍为既有 `test-treeops-rm.mjs`；`gen-ui-preview` 重生成无报错。三件新测试均登记进 `check-runner.mjs` 的 `CHECKS`。
  **✅ 已于 2026-09-12 12:40 部署**（详见下方「部署」段）：commit `9f6c920` 已 push；插件包 `~/.dsh/profiles/web/node_modules/dsh-shoucang-memory` 的 `client.js` 与 `lib/client.js` 已同步（sha1 `511aa87d9bf5` 与仓一致）；**待用户热重载后生效**。
  **⚠ 一条证据订正（勿引为既有失败）**：本轮某次 `npm test` 中 `test-forgetops.mjs` 曾报 FAIL，但随后**单独连跑 3 次均为 `30 PASS / 0 FAIL`（exit 0）**，全量 `npm test` 复跑亦为 PASS（23 pass · 1 xfail）。该件只读 `src/treeops.ts` 并向 `_memory/audit/` 写带时间戳的审计 jsonl，与本次 UI 改动（仅 `client.js`）无交集 ⇒ 判定为**瞬时读数**，不作既有失败登记。
- **🟠 UI 重构（2026-09-12 第二轮）：展开/收起单一数据源 · 内联样式清零 · 派生状态映射收敛 —— `client.js` 重写三处病根，行为与视觉均无回归**
  **① 展开/收起：4 套实现 → 单一数据源 `Fold`**。改前面板并存 4 套折叠状态：DOM class（`!body.classList.contains('sc-hidden')`）、闭包变量、局部 `advOpen`、以及 `scheduleFold` 的 `setTimeout(0)` 收口。具体病状：**(a)** notes 小节树**从 DOM 反推开合** ⇒ 状态与渲染互为因果，任何重绘即失同步（保存小节后整棵树塌回）、父节点 open 依赖子容器 class 导致嵌套项互相影响；**(b)** `setTimeout(0)` 先铺开再收起 ⇒ 可见抖动闪烁，且抛异常时哨兵残留；**(c)** 自动展开用 `h.click()` 模拟点击，依赖 DOM 结构且非幂等；**(d)** 60s 轮询重绘强制收起用户已展开的区块；**(e)** 折叠键只用标题 ⇒ 同名兄弟小节互相串状态。现收敛为 `Fold` 单一数据源（`get/set/toggle/clear`，同值不广播以切断 paint↔set 回环），配套 `UI.fold()` 折叠原语（`variant: card|more`，支持 `disabled` / 空态 / `busy()` 异步骨架，`paint()` 先画后插、节点 disconnected 后自动退订），新增 `deferFold`/`flushFolds` 取代 `setTimeout` 收口；小节树改按 `note:<rel>:<path>§<title>` 带层级路径取键；`show()` 仅**换视图**时 `Fold.clear()`（同视图重绘保留开合态）。新增 `scripts/test-ui-derive.mjs` 之外的 `scripts/test-fold-state.mjs`（**18 条**：从 `client.js` 原地 eval 抽出真实 Fold 执行 + 反模式锁 + 反向证伪）。
  **② 样式：内联直写 9 处 → 0 处**。`.style.maxWidth` / `.style.display` / `.style.width` / `.style.color` / `.style.background` / `gap`/`marginTop`/`maxHeight`/`marginLeft` 全部改为类或 CSS 变量：输入框宽度走 `--sc-in-w`、进度条走 `--sc-pct`、日志面板高度走 `--sc-log-h`（CSS 兜底 150px）、缩进走 `--sc-indent`、标签色走 `.hued` + `--sc-tag-h`（**配色算法从 JS 搬进 CSS**，JS 只传色相）、新增 `.sc-toolbar` / `.sc-spacer` 两个布局类。另把「折叠」与「检索过滤」两个语义拆成 `.sc-hidden` / `.sc-filtered`（原共用 `.sc-hidden`，参数检索框会覆盖折叠态）。剩余 7 处均为 `setProperty` 变量赋值（数据驱动，非样式直写）。
  **③ 显式逻辑：散落三元链 → `Derive` 派生映射层**。「provider→徽章色 / provider→中文名 / provider→语义召回态 / 水位→等级 / 成员装配→徽章 / 向量区可见性」六组判定原先以三元链散在 5 处，且**同一 provider 口径不一致**（向量区把 `DmlExecutionProvider` 视作 running，记忆板块把 `fusion` 视作 running）。现建 5 张表（`VEC_DOWN`/`VEC_LABEL`/`VEC_RECALL`/`CAP_PCT`/`SUITE_STATUS`）+ 7 个判定函数，口径差异不抹平、改由调用方显式传入「本处视作 running 的 provider 列表」。魔法值 `85`/`60`/`8` 提为 `Derive.CAP_PCT` / `BACKREF_LIMIT`。**顺带修掉两处潜在缺陷**：映射表查找原先裸写 `obj[k]`，`obj['constructor']` 会沿原型链取到 `Function`（truthy）⇒ 未登记 provider 被误判成已登记，现统一走 `hasOwn` 自有属性守卫；`providerDown()` 不做 `'off'` 兜底（原判据在 provider 缺失时为 false，兜底会把「未上报」误判成「已关闭」）。新增 `scripts/test-ui-derive.mjs`（**24 条**：新映射 **vs 原三元链双跑对照**逐输入比对 + 原型链防护 + 常量外露 + 反模式锁 + 两处反向证伪）。
  **验收**：`node --check client.js` 通过；`npm run build:client` 已同步 `lib/client.js`（211,980 字符，与源逐字节一致）；**`npm test` PASS（22 pass · 1 xfail · 0 skip）**，xfail 仍为既有的 `test-treeops-rm.mjs`；`gen-ui-preview.mjs` 重生成 `deliverables/ui-preview.html` 无报错（CSS 39,871 字符，本轮未改样式层 → 视觉无回退面）。两件新测试均已登记进 `scripts/check-runner.mjs` 的 `CHECKS`。
  **✅ 已于 2026-09-12 12:40 部署**（随第三轮一同上线，详见下方「部署」段）。
- **🟠 UI 统一设计系统收敛（2026-09-12）：5 层补丁 → 单一分层系统 + 修掉移动端无法关闭面板**
  **① 收敛重复定义**：原 CSS 由 5 层历史补丁叠加（基础 → U2.5 → U2.5b → UI 重构 → 样式系统优化），同一语义被反复覆盖——`.sc-h1` 三处、`.sc-btn` 四处、`.sc-h2` 三处，实际表现取决于级联顺序而不是设计意图。现重写为**单向依赖的六层结构**：① 令牌 Token（颜色/间距/圆角/字阶/阴影/动效）② 基础 Base（重置/滚动条/焦点环/排版基类）③ 布局 Layout（mask·modal·nav·main·view·statusbar）④ 原件 Control（按钮/输入/下拉/开关/徽标/折叠/进度/日志）⑤ 业务 Block（记忆卡/指针/索引/深睡/向量/根目录/画像）⑥ 适配 Adapt（密度/响应式/触摸/减弱动效）。**断点外重复选择器块 0 处**（自检脚本实测），改标尺即改一处。
  **② 配色统一**：业务层**裸 hex 归零**——16 种散落十六进制（`#4a9eff`/`#f85149`/`#999`/`#3fa76a`/`#c98a1e`/`#e05561` 等）与 10 处直接 rgba 收敛为语义令牌；新增 `--sc-info` 补上"探测/可疑"状态长期借用 `#4a9eff` 的缺口；柔和底/描边由 `color-mix` 从主色派生（`--sc-*-bg` / `--sc-accent-bd`），不再各写一份 rgba 常量。仅剩的 hex 全部位于令牌定义处（`--dsw-alias-*` 的兜底值与"强调色上的白字"）。
  **③ 补三个真实视觉缺陷**：**`<select>` 此前零样式**——深色主题下是系统白底控件，与面板割裂，现统一控件外观并加自绘箭头；**`UI.toggle` 与其它三处开关形态不一致**——它返回 `label` 包裹 `input`，而胶囊样式写在 `label` 上、内侧原生勾选框未被隐藏 ⇒ 胶囊上叠一个系统方框，现统一为 `input.checkbox-container` 单一实现；**`.sc-kv` 键值栅格从未生效**——行包裹层挡住了 grid，`display:contents` 后 k/v 才真正两列对齐。
  **④ 交互流程与排版**：新增 `UI.pageHead()` 统一「标题+描述+分隔线」页头，替换 10 处裸拼 `sc-h1`/`sc-desc`（此前每处留白各写各的）；切视图自动回到顶部（此前长视图切页后停在上一页滚动位置）；导航宽度改**写 CSS 变量**而非内联 `width`——内联会压过媒体查询，把宽屏设的宽度带进移动端。
  **⑤ 响应式**：断点由 3 处扩到 6 处（≥1440 / ≤1180 / ≤900 / ≤720 / ≤480 / `hover:none`），模态由固定 `min(880px,94vw)` 放宽为 `min(1040px,100%)`+遮罩留白；**≤720px 修掉一个真实阻断**：模态 `100vw×100vh` 全屏后遮罩被完全盖住 ⇒ 点遮罩关闭失效、移动端无 Esc 键 ⇒ **面板打不开也关不掉**，现于导航条右侧加 sticky 关闭按钮（仅窄屏显示）。
  **⑥ 新增 `scripts/gen-ui-preview.mjs`**（生成器，**未**登记进 CHECKS）：CSS 从 `client.js` 原地求值抽取而非复制粘贴 ⇒ 预览与线上同源，产物 `deliverables/ui-preview.html` 含 7 档设备宽度 + 深浅色切换，可作设计系统回归台。
  **验收**：`node --check client.js` 通过；`npm run typecheck` 零错误；`npm run build:client` 已同步 `lib/client.js`（225,666 B，与源字节一致）；**`npm test` PASS（20 pass · 1 xfail · 0 skip）**，其中 `check-hardcode` / `check-ui-contract` / `check-srcmap` / `check-deploy-sync` / `check-changelog` 全绿；xfail 仍为既有的 `test-treeops-rm.mjs`。
  **⚠ 一条证据订正（勿引为既有失败）**：本轮首次跑 `npm run check:all` 时 `test-wiring-gate.mjs` 曾报 `31 PASS / 1 FAIL（漏网 1）`，**但随后连跑 3 次均为 `32 PASS / 0 FAIL`（exit 0）**，最终 `npm test` 亦为 PASS。该门禁只读取 `src/distill.ts`，与本次 UI 改动（仅 `client.js`）无交集；同时间 `scripts/test-wiring-gate.mjs`、`test-wiring-gate-ast.mjs` 正被并发编辑（`git status` 可见其为已修改态），首次读数属**并发改写中的瞬时读数**，不作既有失败登记。
- **🟠 UI 样式系统重构 + 剩余项落地（2026-09-12）：设计令牌 / 交互反馈 / 边界态 / 响应式**
  **① 设计令牌**：原有 45 个 `--sc-*` 令牌基础上补齐缺失项——阴影三档（`--sc-shadow-1/2/3`）、过渡时长与缓动（`--sc-t-fast/base/slow`、`--sc-ease`）、焦点环（`--sc-ring`）、禁用透明度（`--sc-disabled-op`）、层级（`--sc-z-modal/mask/toast`）、字重四档（`--sc-fw-*`）、字距（`--sc-ls-*`）、以及**状态色语义派生**（`--sc-ok-bg/warn-bg/err-bg`）。原 CSS 有 369 处 px 硬编码、16 种十六进制色、10 处直接 rgba —— 本轮为**纯新增**（不动任何既有选择器，零布局回退风险），新令牌供后续渐进替换。
  **② 视觉层次**：统一主次按钮（`.sc-btn` 最小高度 30px、`inline-flex` 居中、`primary/danger` 各有 hover 态）、状态徽标改为语义类（`.sc-badge-ok/warn/error/info`，颜色走 `--sc-*-bg` 令牌而非行内 `style.color`）、分区节奏（`.sc-section` 用 `--sc-gap-group` 统一，"留白即分组"）、标题层级（`.sc-h1/h2` 字号字重令牌化）。
  **③ 交互反馈与边界**：新增 `:focus-visible` 焦点环（键盘可见、鼠标不显环）、`:active` 按压位移（原 0 处）、`:disabled` 统一禁用态（原仅 2 处 → 11 处）、过渡统一并**尊重 `prefers-reduced-motion`**；新增加载态（骨架微光 `sc-shimmer` + 行内 `sc-spinner`）、空态（`.sc-empty` 图标+标题+说明）、溢出处理（`.sc-ellipsis` / `.sc-clamp-2/3` / `.sc-break` / `.sc-scroll-y`）。
  **④ 响应式**：原 **0 处 `@media`** ⇒ 补 6 处——≤900px 导航收窄、≤640px 导航转顶部横向条且模态全屏（setting-item 改纵向堆叠、kv 单列）、≥1440px 放宽阅读宽度至 1100px、`hover:none` 触摸设备加大点击热区。
  **⑤ 剩余功能项**：**C1 进度覆盖旧调用**——`api()` 增加慢请求（>1.5s）自动显示「执行中…」（用 `setStatusText` 不写日志、结束即清），覆盖全部旧调用点；**D6 无障碍**——模态框 `role=dialog`+`aria-modal`+`aria-label`、导航项 `role=button`+`tabindex=0`+`aria-label`+键盘 Enter/Space、视图区 `role=region`+动态 `aria-label`；**A6 视图路由**——记住最后视图（localStorage）+ 支持 `#sc=<视图名>` 深链**读取**（不写 URL，避免干扰宿主路由）；**A2 组件层**——新视图全面使用（26 处调用），旧视图已转换插件集合成员列表 1 处作为模板（手工 `setting-item` 20 → 19）。
  **⚠ A2 未做批量替换的理由**：剩余 19 处虽为同一机械范式，但控件的 `.setting-item-control` 包装方式需逐处确认，盲目 codemod 会改变 DOM 结构 —— 与本次「保持 DOM 结构不变」的要求冲突。列为下一轮，建议配合目视验收逐处推进。
  **验收**：`npm test` exit 0（20 pass · 1 xfail · 0 skip）；`client.js` 193,173 B。

- **🟠 UI 系统性优化（2026-09-12）：架构分层 / 功能链条闭环 / 可观察性 / 信息密度与设置 —— `client.js` 2331→2978 行**
  **① 架构（A1/A2）**：新增基础设施层——`Bus`（事件总线）、`Store`（单一数据源 + 订阅，替代散落的 `refs = {}` 可变全局袋）、`Cfg`（参数化配置，localStorage 持久化）、`UI`（组件工厂：item/toggle/input/select/button/badge/collapsible/progress/kv），消除 14 个 render 函数里 `setting-item` 三件套的重复实现；视图注册表 `VIEWS` 由元组下标访问（`v[0]…v[3]`）改为具名渲染分派，并新增 `observe`（运行观测）、`settings`（界面设置）两个视图（6→8）。
  **② 功能链条（B1）**：修复 **6 个"后端已实现、界面不可达"的死角端点**——`/embed/test`（嵌入连通性测试，先读 `/embed/config` 取 baseUrl 再测，后端要求 `{baseUrl,apiKey}` 不可发空 body）、`/get_root`、`/inject/stats`、`/root/bootstrap` 接入「运行观测 → 运维操作」；`/memory/edit`、`/memory/remove`（行级原语 `{file,line}`）接入「高级：行级编辑/删除」并附**显式风险提示**——既有设计 R3 明确"索引行只读，直接改会与 notes 详情错位"，常规编辑仍走 `/memory/section-edit`，此处仅为消除死角而暴露并默认折叠。**实测：端点覆盖 34/34 全部可达（原 28/34）。**
  **③ 可观察性（C1–C4）**：新增 `Prog` 进度管理 + `UI.progress` 进度条（长操作不再盲等）；新增 `Log` 分级日志（info/warn/error，保留 500 条，不互相覆盖）+ 常驻日志面板（`Ctrl/⌘+Shift+L` 切换，级别可过滤）；错误定位升级——`fail(e, ctx)` 记录**端点/方法/参数/堆栈/时间戳**，观测视图可展开查看，不再只有一行 message；`apiCtx()` 包装自动记录每次调用耗时；`collectMetrics()` 汇总 MCL 状态 / 向量档 / 注入统计 / 当前根等关键指标。
  **④ 信息密度与设置（D1–D5）**：状态栏由单行覆盖式改为**分级**（info/warn/error 分色）并写入日志历史；新增 `UI.collapsible` 支持**概览—详情分层**（列表先给概览、按需展开，长列表按阈值默认折叠）；新增密度切换（紧凑模式隐藏描述、压缩行高）；8 项隐式默认行为显式化为设置项（密度/导航宽度/自动刷新/轮询间隔/日志面板/日志级别/概览模式/折叠阈值），集中到新增的「界面设置」视图，支持恢复默认。
  **⑤ 自由度（C5–C7）**：新增快捷键 `Ctrl/⌘+Shift+S` 开关面板、`Esc` 关闭、`Ctrl/⌘+Shift+L` 切日志；导航宽度 140–320 可配；轮询间隔可配（0=关闭，且仅在面板打开时轮询，关闭时不空转）。
  **⑥ 新增门禁 `scripts/check-ui-contract.mjs`（已登记进 CHECKS）**：常驻校验 ① client.js 语法 ② 基础设施符号齐备 ③ VIEWS 与 show() 分派一致 ④ **panel.ts 每个端点都必须在 client.js 中被引用**（未暴露须入白名单并写明理由，否则 FAIL —— 长期防止"死角入口"复发）⑤ 前端产物 `lib/client.js` 与 `client.js` 同步 ⑥ 设置项 UI 可见。**已做反向证伪**：注入无入口端点 ⇒ 4 PASS/1 FAIL exit 1；删除 `Cfg` 符号 ⇒ 4/1 exit 1；制造产物漂移 ⇒ 5/1 exit 1；还原 ⇒ 6 PASS exit 0。
  **⚠ 顺带修掉一个真实缺口**：`package.json` 的 `pretest` 只跑 `build:host`（tsc），**不含 `build:client`** ⇒ 改了 `client.js` 后 `npm test` 不会同步进 `lib/`，而发布的是 `lib/`（files 含 lib），表现为"改了源码没生效"且无任何报错。已由新增的门禁第 ⑤ 项常驻拦截。
  **验收**：`npm test` exit 0（**20 pass · 1 xfail · 0 skip**）；`client.js` 经最小 DOM 桩实测加载——模块注册成功、factory 执行无异常、20 个新增符号均有定义。

- **MCL 熟悉度阈值重校准 0.65 → 0.58（缺陷2 · 2026-09-11，可热回滚）**：原阈值 0.65 在实测样本上**结构性不可达**——193 条 `mcl-step` 审计的 sim 分布 max=**0.634** / mean=0.5658 / p75=0.609 / p90=0.624，**≥0.65 命中 0 行** ⇒ 快通道恒为 0，快/慢分流退化为**单一慢通道**（设计意图「熟悉任务零材料零往返」从未生效）。新值 **0.58** 取实测分位（≥0.58 覆盖 53/193 = 27.5%）。**落点（两处）**：① 注册表 `criteria.json#surface.mcl.familiarThreshold`（唯一事实源，已重跑 `gen:criteria` 同步三处投影）；② **附带修复 SSOT 破口**——`scheduler.ts:643` 的缺省值原为**硬编码 `0.65`**，注册表改了也不生效，现改读投影 `SURFACE.mcl.familiarThreshold`。**回滚**：`/set mclFamiliarThreshold 0.65`（写全局 `~/.dsh/suite/scheduler.json`，热生效无需重启）。**⚠️ 效果上限须诚实说明**：快通道是「sim 达标 **且** hasHighConf」双门，本次只放宽前者；后者仍要求命中 `mclGate` 标签（路径/原则），实测 top-1 口径下界仅 2/193 ⇒ **实际快通道触发率远低于 27.5%**。是否放宽第二道门（或改为「P 层命中即算熟悉」）属语义变更，单列待拍板。
- **移除 boards 死开关与假依赖文案（A 方案 · 2026-09-11）**：`boards.memory` 是「只写不读」死开关——全仓确认 `parseView` 把 `shoucang.boards.*` 解析进 `out.boards` 后**零读取点**，注入总闸判定（`panel.ts` 的 `level === 'off' || !hotMemoryOn`）**从不引用 boards**；而旧 UI 文案却称其为「热记忆注入总闸的父开关」（`injection.hot_memory` 描述亦写「需 boards.memory 开启」）⇒ **两条均为假依赖**（用户关掉 `boards.memory`，注入照常进行）。属 2026-09-10「清死键/死 UI」的同类遗漏（当时 archive/lifecycle/merge 组已清、boards 组被留）。**处置**：① `client.js` 删 `boards.memory` 开关项 + `CTRL_META` 条目，并改准 `injection.hot_memory` 文案与参数页说明（去假依赖与「root 仅管 boards 显示项」）；② `src/panel.ts` 删 `ParsedView.boards` 字段、`out.boards` 初始化、`/^shoucang\.boards\./` 解析分支、`/toggle` 白名单中的 `'boards.memory'`（`flipBool` 兜底机制保留）；③ `shoucang.config(.example).yaml` 删整个 `boards:` 段（persona/memory/wiki 三键均无读取点）；④ `scripts/check-carriers.mjs` 的 `ROOT_ONLY` 清空（当前无 root-only 键）并与 `/toggle` 白名单对账同步。**用户可感知**：面板少了误导性的「记忆板块」开关与假的父开关依赖说明；`injection.*` 注入链路零改动、完好。
- **文档与配置模板对齐现行代码（文档漂移修复 · 2026-09-11）**：三处文档与配置模板落后于代码，据实测对齐。**① AGENTS.md 结构表**：`src/` 行补登 7 个漏登记模块（`criteria.ts` L0 判据内核 + 升格/降格裁决、`criteria.generated.ts` 由 `skill/engine/criteria.json` 生成的判据投影〔生成物禁手写〕、`mcl.ts` 认知环 `agent/pre-step` 双通道、`mcl-share.ts` 认知环状态惰性桥、`activity.ts` 条目活性聚合、`treeops.ts` treeOps 执行层、`vec.ts` 向量档 + RRF 融合 k=60），并把过时描述改回实测（panel.ts 去掉已随 2026-09-10 P0 清理删除的「+ 空闲巩固轮」；scheduler.ts 工具数由「suite/verify/probe」更正为实际注册的 5 个：`shoucang_suite`/`shoucang_verify`/`shoucang_targets_probe`/`shoucang_recall`/`assistant_capabilities`）。**② 包名漂移**：`@dsh-external/shoucang` → `dsh-shoucang-memory`（AGENTS.md 与本仓外的工作区总览 `D:\FF\PROJECT.md`；CHANGELOG 历史条目保留原文不动）。**③ 构建说明**：`npm run build` 注释由「src→lib + client + default-project」更正为 build:host（tsc src→lib）+ build:client（复制 client.js 进 lib/）——default-project 生成链 2026-09-11 已退役。**④ 配置模板清死键**：`shoucang.config.example.yaml` 与本机 `shoucang.config.yaml` 删除 4 个零消费顶层段（`archive:`/`lifecycle:`/`merge:`/`idle:`——消费端为已不随包分发的旧 `_meta/*.py` 链路，`/toggle`/`/set` 白名单早已移除），保留有真消费的 `boards:`（`boards.memory` 板块显示开关，/toggle 白名单在册）与 `injection:`（root YAML 兼容回退读取，panel.ts:260-270）。**（★后注 · 同日 A 方案覆盖）**：本条「保留 `boards:`」的判断当日即被推翻——实查该项为「只写不读」的潜伏死项（`parseView` 只写 `out.boards`、从不写 `out.flags`，而渲染守卫 `client.js` 读 `parsed.flags[...]` ⇒ 恒 `undefined` ⇒ 从不渲染；旧 `ROOT_ONLY` 对 ⑤ 号检查亦为死代码，因 `/set` 白名单从不含该键）。已连同 `boards:` 配置段全量移除，见本小节首条。
- **maturation 终局决策（用户授权"你自己决定" · 2026-09-11）**：**决定不翻 `maturationEnforce`**（保持只记录），并**把"何时可翻"做成机检条件**。**判前先修判据 — 发现 F13（决定性）**：`maturation-scan` 读 `activity.jsonl` 时找 `r.at || r.lastHitAt || r.t`，而**真实字段是 `{f,s,hits,lastHit,firstSeen,days30,…}`** ⇒ 全 `undefined` ⇒ `add()` 直接 return ⇒ **整个信号源被静默丢弃**；改为优先读其**自带的 `days30`（跨日命中天数，比按单时点聚合更准）**、回落 `firstSeen↔lastHit` 跨日、与 `access.log` 日集合**取最大**。**修后数字完全改变**：小节 **29→53**、达 gate **1→17**、拦阻率 **96.6%→67.9%**、信号源 `activity.days30` 34 键 + `access.log` 29 键 ⇒ 若不先修判据，会基于**错误数字**误判为"观测史不足/太早"。**决策依据（修后）**：观测窗口 **3 天 ≥ gate 所需 2 天** ⇒ **分母有效**（"只出现 1 天"是真实分布，不是观测不足）；拦阻率 **67.9% > 50%** ⇒ **不翻**（一翻冻结 36/53 的升格）；且 **gate 无中间可选区间**（A 分布 `1:1 · 0.9:3 · 0.7:11 · 0.5:2 · 0.3:36`：gate ≤0.3 等于无约束、>0.3 即拦 68%+）⇒ **调 gate 不是解法，等分布自然右移**。**已落地**：`maturation-scan` 增 `readiness`（`gateReady = 观测天数 ≥ needDays ∧ 拦阻率 ≤ 50%` + 理由输出），当前实测 **⛔ 不可翻**，满足后自动转 **✅ 可翻 enforce**，届时一条配置即可翻转；决策全文见 `docs/memory-m5-decision.md §6`。
- **笔记层级重排（F11 落实 · 2026-09-11）**：按用户拍板"整"，对**私人记忆库**的 `notes/` 做**层级提升 + 同名合并**（**不动内容、不改小节名** ⇒ 全部 `§指针` 继续有效），工具 `scripts/restructure-notes.mjs`（`--apply` 前先出 dry-run 方案 + 内容级断言）。**做法**：① **提升**——`env.md` 的 `## DSH 环境` 由 10 个子节收敛到 3（`插件注入`/`Windows npm 执行策略`/`Windows PowerShell 编码`/`记忆库与内核概览`/`插件装配·部署·卸载`/`检索链路与桥`/`内核边界与四层叠加` 共 7 项升为 `##`）；`lessons.md` 的 `## DSH 自托管约束` 由 8 → 3（`ESM 再导出陷阱`/`多根拷贝与文件判因`/`假绿与实证（干跑对账）`/`指针规范化与并发`/`诊断方法论` 共 5 项升为 `##`）；同质章节（`flows.md 全局工程纪律`、`lessons.md Windows 系统运维`）**有意保持不动**。② **同名合并**——`env.md` 的 `Windows npm 执行策略`（`###` 与独立 `##` 并存）合并；`假绿与实证`（提升出的 `##` 与 Windows 章下 `###` 同名）合并，**只搬正文、丢弃重复标题**。**实测**：字符 Δ=**−21**（完全可解释：提升 12 处标题各少 1 字符 + 丢弃 1 个重复标题）· **断言全过**（标题多重集 / **层级归属** / 守恒）· 体检 **⑥ 由 4 处收纳筐 + 1 处重复 → 0 ⚠ / 0 ❌**（余 2 条 ℹ 信息）· 指针解析 **33/34 → 34/34**。**过程中翻车一次并留痕**：首版按**原位置**发射提升项 ⇒ 父章节后续子节被新 `##` 吞掉（`## Windows 系统运维与数据安全` 标题消失、8 个子节挂错），而我当时用"标题数 23/23 相同"当验证＝**假绿**（数量相同、标题被替换）⇒ 从备份（`audit/backup-notes-*`）**还原**，改为**两阶段发射**并加**内容级断言**（层级归属判据正是能抓此 bug 的那条）。**同时**：修 **F12 悬空指针**（`MEMORY.md → notes/tools.md §记忆脚本` 小节从来不存在，早于写门"悬空 exit=2"硬化）——补 `## 记忆脚本` 小节（内容取自本会话实测：脚本位置/`MEMORY_ROOT` 定位/`--json --out` 机读/退出码契约/PowerShell 引号坑/库 git `safe.directory`）；并把**悬空指针**纳入 `memory-reconcile` ⑥ 体检（解析语义**照抄读取器**：`##`/`###` + 大小写不敏感双向包含 + 去日期后缀），此后该类问题自动报出。库 git 已快照 `32a9012`。
- **审查 M 档三条护栏落地（2026-09-11）**：把架构审查（`docs/architecture-review-20260911.md`）的 F1/F6/F8 从"报告条目"变成**自动红灯**。**① F1-B 字段角色机检**：`criteria.json` 新增 **`fieldRoles`**（键=导出常量.字段，值=`runtime｜doc`），新增 `scripts/check-field-usage.mjs` **双向校验**——声明 runtime 必须被 `src/` 消费、声明 doc 必须未被消费（**标记说谎即红灯**）；判据=**文件级**（常量被 import ∧ 文件内出现 `.字段` 属性访问形态），容别名（`s.alphaImp`）与 cast（`(CARRIERS as …).tags`），并**排除常用词误判**（`enforce`/`step` 作参数名不算消费——收紧前后各测一次才定准）。**实测修正了 F1 的范围**：初判"三处双源"偏窄，真实情况是 **`L0`/`SURFACE`/`GATE`/`HEALTH`/`TRIGGER` 五块整体为 doc**（`L0`/`GATE`/`HEALTH`/`TRIGGER` 四个导出常量**无人 import**；`SURFACE.recall/fusion/threshold/rerank/mcl` 运行时真源在 `vec.ts`/`scheduler.ts`），真正 runtime 的只有 `SCORE.alphaRel/alphaImp/alphaRec` · `MATURATION.A0/step/gate` · `CARRIERS.tags` ⇒ **B 档（注册表即真源）工作量据实扩大**。**② F8 部署面机检**：新增 `scripts/check-deploy-sync.mjs`（仓 `scripts/` ↔ 库 `scripts/` 同名件 sha1 比对；库根缺失 ⇒ **exit 3 诚实跳过**）——**落地当天即抓到一次真实漂移**：`test-layering.mjs` 库内是旧版（改过却漏同步）⇒ 已同步，现「一致 7 / 不一致 0」。**③ F6 退出码契约统一**：新增 `scripts/check-runner.mjs`（唯一实现 `0=pass · 3=skip(依赖缺失) · 其他=fail`），`npm test` 的检测段改为经它运行（`check:all` 便捷入口）；库侧 `sleep-selfcheck.mjs` 实现同一契约。**④ 文档**：`spec §1.0.1` 补「检测件退出码契约」「字段角色契约」，审查报告增 §5「M 档已落地 + F1 范围修正」。**验收**：`npm test` = **5 pass / 0 skip**（判据/载体/字段/分层/部署面）+ 40+30+18+18 + check-hardcode ✅；架构档 L1 全门 + 锚点 265/265 + 105/105 全 PASS。
- **M5 模拟测试 + 依据证据翻转 scoreWeights=v2（2026-09-11）** 公式（`rel`=归一 RRF 分、`imp`=`importanceOf(行)`（标签权重 0.5 + 内容长度 0.5，内容长度是 MSR 校准后权重最高的可得信号）、`rec`=活性因子代理、`v2=α_rel·rel+α_imp·imp+α_rec·rec`）并写 `audit/score-shadow.jsonl`（一次召回一行 top-5，**不改变排序**）——供 R-2 判据：`corr(importance,relevance)>0.9` 即删该分量。**② M4 成熟度只记**：新增 `scripts/maturation-scan.mjs` —— 按 `access.log`/`activity.jsonl` 的**跨日命中日数**算 `A = A0 + step·(days−1)`（缺省 0.3/0.2/0.5），落库内 `audit/maturation.jsonl`；实测 **29 小节 / 1 个达 gate**。`criteria.ts` 新增 `activationOf`/`maturationVerdict`/`layeredScore`/`importanceOf`（**单一实现**）。**③ M5 开关（已落地·默认未翻）**：`scoreWeights='v2'` 真正切换 E 层排序（缺省 legacy，可回滚）；`maturationEnforce=true` 时深睡升格须 `A≥gate`（缺省 false=只记录；查不到按 A0 计 → 未成熟条目降级 notes）；`carriers.profile=0` 回退 P 层画像行。**翻转需影子期证据**（这是 M5 的出口判据，不是省事）。**④ M6 治理收口**：`spec §1.0` 新增「载体契约与三层生效模型」（P/R/E 表 + 载体三要素 + 读取面义务 + 写入回执 + 成熟度 + 统一打分）；`spec §5.5` 补 `[性格]`/`[认知]` 两标签（v2.2 新增，带正反例）；`engine/distill-contract.md` → **v9**；总纲路线图加**实施进度表**（M0–M6 逐阶段状态与出口实测）。**⑤ 对账器扩展**：`memory-reconcile` 新增 ④ 成熟度分布与 ⑤ **影子相关性**（Pearson corr + R-2 判词）；成熟度台账按**库根**解析（数据属库，与运行时台账分域）。**验收**：`typecheck`/`build` 零错；`npm test` = 判据门 + **载体门** + 40+30+18+18 + check-hardcode ✅；影子日志实测产出（含 old/imp/rec/v2）；`/reconcile` 出 ①–⑤ 五段；架构档 L1 重生成（**14 源文件 / 30 边**，新增 3 条判据层依赖；出度最高变**并列 7**）+ **锚点 265/265 + 105/105** + 9/9 新鲜；**门禁工具增强**：`arch-check l1` 的 max-in/out 断言支持**逗号分隔多值**（并列是合法事实，此前会把并列判为不符）。
- **面板 UI 优化 U2.5b 落地（内联样式归零 · 2026-09-11）**shSlots` **转正进 scheduler zod**（此前 panel 一直在 `readSuiteConfig()` 读取，但 scheduler 从未声明 ⇒ UI 调不了、写回也保不住）；`/config` 补返 **10 个键**（上述 2 键 + `recallFusion`/`bankGit` + MCL 6 键）；面板补 **10 个控件**（注入选行 2 · 召回融合 radio 2 档 · 库版本化 1 · 认知环 6），全部落「①注入与画像」与「④后台与调度（折叠）」两桶并带作用域/生效态徽章。**② 实测抓出并修掉两个真缺陷**（静态断言当时是过的 —— 印证 `[原则] 结果验证重实证`）：**(a) `/toggle` 误走 root YAML**：除 `hot_memory` 外的新布尔键落到 `flipBool` 找 `shoucang.<key>` 行 → 500；改为 **`SUITE_BOOL` 映射统一走 suite 持久通道**（scheduler.json）。**(b) `/set` 无全局映射/枚举被数值化**：新键缺 `SCHED_KEY` → 400；补映射后又发现 `recallFusion='rrf'` 被 `Number()` 写成 **0** ⇒ 改为「**枚举键原样写字符串，仅数值键 Number 化**」，并补 `RANGE` 五条数值范围（与 zod min/max 一致）。**③ 可访问性（A10）**：persona/level/融合三处档位由 `div+onclick` 改为 **`<button role=radio aria-checked>`**（键盘可达 + 读屏可辨）；折叠按钮改 **`<button aria-expanded>`**（含 `scheduleFold` 与深睡高级阈值两处）；状态栏加 **`role=status aria-live=polite`**（状态变化被播报）；新增 button 化后的**样式重置**（视觉不变）。**④ 机检升级**：U3 验收脚本扩到 **三方对齐**（能力声明 ↔ 面板控件 ↔ **写通道** SCHED_KEY/RANGE/SUITE_BOOL），共 **46 条断言全过** —— 让"静态过、写通道断"这类缺陷下次直接被机检拦下。**验收**：`typecheck`/`build` 零错；U1/U2.5/U2/U3 四套静态验收**全 PASS**；**端到端实测**：`/config` 返回全部新键（`injectRelevance=true injectFreshSlots=2 recallFusion=rrf bankGit=true mclEnabled=true mclFamiliarThreshold=0.65 mclTopK=3 mclAudit=true`）· `set recallFusion` 往返 `rrf→weighted→rrf` 全部 `ok` 且**落盘为字符串 `"rrf"`** · `toggle injectRelevance` 两次 `false→true`（已还原）· **非法枚举/越界均被 400 拒绝**；`npm test` = 判据门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅。
- **面板 UI 优化 U3 落地（能力对齐 + 可访问性 · 2026-09-11）**9` 做**加性改造**（只插标题/哨兵与折叠容器，**不重排既有代码块顺序**；先备份 `client.js.pre-u2`）。**① 参数调节分 4 桶（B6）**：`① 注入与画像（即时）`（persona 档位 + 两个总闸开关 + 注入强度）· `② 记忆与容量`（三容量门 + 活性/遗忘阈值）· `③ 模型与向量`（当前链路 + 蒸馏/深睡模型）· `④ 后台与调度（高级 · 改后需重载）`（蒸馏节流，**默认折叠**）——桶标题用与记忆板块同款 `sc-mem-group-title`（视觉语言统一），原子节标题由 `sc-h1` 降级为新增 `sc-h3` ⇒ **参数页 sc-h1 由 5 处收敛为 1 处（仅页面标题）**，符合「每板块 ≤2 级标题」。**② 深睡尾部合并（A7）**：`会话明细`/`控制`/`阈值` 三块 h2 大标题 → h3 小节；**「阈值」4 项（含 enableDeepSleep 开关）并入折叠体**，并改用**显式容器接管异步追加节点**（否则 `/deepsleep/config` 的异步项会落在折叠体之外）⇒ 深睡视图 `sc-h2` 清零、首屏不再被高级阈值占据。**③ 配置视图「最近改动 5 条」（B9）**：新增只读端点 **`GET /api/shoucang-panel/config/recent`**（读库 `.git/logs/HEAD` reflog 最近 5 条 + `scheduler.json` mtime，**零 spawn**），配置页脚渲染时间 + 提交说明列表。**验收（机检 16 项全过）**：`node --check` 通过；**U2 静态验收 PASS 16/16**（4 桶标题齐 · 参数页 sc-h1=1 · sc-h3≥4 · 桶④折叠 · 阈值 4 项全落折叠体 · 深睡 sc-h2=0 · /config/recent 端点+消费+样式 · U1/U2.5 无回归）；端点实测 `最近改动 2 条`（`memory: snapshot 2026-09-11T05:57:38` / 初始快照）+ `configMtime` 有值；`npm test` = 判据门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅；U2.5 排版门**复跑仍 PASS**（新增类同样零裸 px）。
- **面板 UI 优化 U3 落地（能力对齐 + 可访问性 · 2026-09-11）**间距/字号/圆角」从**散落裸值**升级为**令牌化标尺 + 覆盖层**（判因：改前实测 **335 处裸 px**、**零间距/字号令牌**、46 处内联样式，导致组内组间同档、11px 中文正文）。**① 令牌**（新增于既有颜色令牌块旁，13→32 个）：间距 `--sc-sp-1..6`=4/8/12/16/24/32（4px 基准/8pt 节奏）· 语义 `--sc-gap-row/item/group`=8/12/24（**留白即分组**）· 字号 `--sc-fs-xs..xl`=12/13/14/16/19（模数 1.2）· 行高 `--sc-lh-tight/normal/loose`=1.35/1.55/1.7 · 圆角 `--sc-r-sm/md/lg/pill`=6/8/12/999 · 宽度 `--sc-w-control/read/sm/lg/xl`。**② 覆盖层**（一次成型、**删块即回滚**，不改任何既有规则）：把 `sc-h1/h2/desc/mem-group-title/mem-stat(s)/mem-grid/ds-badges/ds-badge/setting-item(-name/-desc)/persona-slider/cell/range-wrap/ctrl-meta/chip/more-btn/search-bar/input/btn/statusbar/yaml/card-body/ds-session(s)/num-wrap` 共 **30+ 类**统一到令牌；组标题改为「上 24（组间）+ 下 12（组内）」并加 1px 顶边 ⇒ 分组可读；新增行/栅格/宽度三原语（`sc-row`/`sc-col`/`sc-w-sm|lg|xl`）。**③ 可访问性**：统一 `:focus-visible` 焦点环（6 个交互类）+ 状态点尺寸令牌化（形状+颜色双编码，色弱可辨）。**④ 内联样式收敛**：参数页数字项（`numSetting`/冷降权系数/深睡阈值/模型选择）的 spacing/type 内联样式改类（`sc-num-wrap`/`sc-row`/`sc-w-lg|sm`），`.style.width` 由 8 → 3 处。**验收（机检 12 项全过）**：`node --check` 通过；U2.5 静态验收 **PASS 12/12** —— 覆盖层裸 px **0**（除 1px 边框/2px 焦点环）· 间距令牌 35 次 · 字号令牌 21 次且五档 ≥12px · **组间:组内 = 24:12 = 2.0:1** · focus-visible 6 处 · 圆角令牌 8 次 · spacing/type 内联越界 0。余下 cssText 20 处属状态切换/宿主对齐/图标尺寸（**U2.5b** 逐板块再收敛，已如实记账）。
- **面板 UI 优化 U3 落地（能力对齐 + 可访问性 · 2026-09-11）****改造（先备份 `client.js.pre-u1`，每项可回滚，不动既有 `sc-*` 语义与结构骨架）。**① 记忆板块首屏收敛 11→5 组**：新增折叠哨兵 + `scheduleFold()`（`setTimeout(0)` 自调度 ⇒ 后续分组代码零改动），把 notes 详情 / 本地知识区 / 向量召回 / delta / 本周成长 收入「展开更多」；**判据注册表卡移出记忆板块**（它在最前是上一轮我加剧堆叠的自我修正）→ 落「运行」视图。**② 状态徽章 3→7 枚**：+记忆容量水位（`chars/cap` 带分档色）· +认知环（快/慢计数，消费 `/mcl/status`——**该端点首次进 UI**）· +判据台账行数 · +库 git 版本（`/criteria` 新增 `bankGit`：只读 `.git/logs/HEAD` 解析提交数与最近时间，**不 spawn git**）。**③ 运行视图新增两组**：`renderRunExtras()` = 「判据与对账」（版本/融合+阈值/台账/rerank 门/库版本）+「认知环（MCL）」（状态/通道计数/注入与 Nudge）。**④ 调节选项加作用域+生效态徽章**：`CTRL_META` + `metaBadges(key)` 接入 4 处控件构造点（`makeToggle`/persona 档位/level 档位/`numSetting` 数字项），显式区分「全局注入 / 本 root / 写门容量 / 召回融合 / 调度」与「即时 / 需重载（warn 色）」。**⑤ 参数检索框**：参数调节页顶新增前端过滤（匹配名称/键名/说明，实时报「匹配 N / 总 M 项」，零新端点）。**验收（机检 `scripts/…` 静态断言 + 端点实测）**：`node --check client.js` 通过；U1 静态验收 **13/13 PASS**（含「记忆板块首屏组数 = 5」）；`/criteria` 实测 `bankGit=2 提交 · lastAt=2026-09-11 13:57:38 · ledger=6 行 · rerankGate=43/200`；`/mcl/status` 正常；`npm test` = 判据门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅；架构档 L1 重生成（client.js 2076 行 / panel.ts 1735 行）+ 锚点 265/265 + 105/105 + 9/9 新鲜。
- **ACT-024 打扰度采样去污染 + 阈值重校准（2026-09-11）**：路线④ 影子采样（`src/distill.ts:activationStep`）原按**内容正则**判宿主样板，而 DSH 把宿主注入块同样作为 `user/message` 事件下发 ⇒ 实测 **909 样本污染 49.3%**；换结构口径复测：14 天窗口 849 条 `user/message` 中 **548 条（64.5%）不是用户输入**（内容正则只能看出 54.3%，即**旧判别系统性低估**）。四处修正：① **结构性判别** —— 只采 `data.source.kind === 'user'`（真值域 `user` / `plugin` / `agent-instructions` / `skill-catalog` / `agent-message` / `subagent-settled` …），无 `source` 的旧格式事件再用内容闸兜底；影子行新增 `src` 字段供污染复盘。② **判据量换绝对口径** —— 原 `sim` 用的是融合召回的**池内 min-max 归一化分**（相对分、跨查询不可比）：干净样本 p50=0.700 / p90=0.850，现状阈值 0.62 会命中 **88.5%** 的真实用户消息（**结构上不可做阈值**）；改用「用户文本 ↔ 命中索引行的**绝对余弦**」（`vec.semanticSim`），实测可分辨（真命中 0.62–0.73 / 噪声 0.38–0.45），影子行同时留 `rel` 字段对照旧口径。③ **阈值重校准** —— `activationTOn 0.62→0.65`、`activationTOff 0.52→0.60`（绝对余弦口径；301 条干净样本 p95=0.627 / p99=0.657），0.65 处**触发率 1.99%**，且其上的 6 条样本**全部是真语义命中**（「怎么用指针搭树」↔`[lesson] 指针非限制`、「画像默认3000记忆5000」↔`[env] 记忆容量与向量` 等）。④ **共用实现** —— 样板判别上提为模块级导出 `CANDIDATE_NOISE` / `isNoiseIntent`（候选区与采样共用，并补上实测漏判的三条：小写 `background job …`、`Agent <uuid> sent a message`、热记忆横幅）。⑤ 新增校准器 **`scripts/activation-calib.mjs`**：结构取样（跳过子代理会话）+ 编译产物 `lib/vec.js` 打分（不另立实现）+ `--since/--sids` 固定窗口 + 相对/绝对双口径分位与触发率，可复现本次结论。⑥ 旧污染日志按「口径变更不可比」归档 `~/.dsh/suite/knowledge/audit/activation-shadow.pre-act024.jsonl`（911 行）。`activationPrefetch` 仍缺省关（保持影子观察态）。
- **ADR-122 v2 收尾：判据函数进载荷路径 + 报告器 + UI 卡 + 面板写后库快照 + 弱关联列（2026-09-11）**：把 v2 的"机制化尾巴"从"函数/文档存在"接成**载荷路径**。**① 判据函数进真实决策**：`ensureFlowCandidate` 每次同型合并时调 `criteria.ts#promoteVerdict` 做**转正资格确定性预判**（`path` 判据：同型 ≥2 且跨会话 ≥2 且只从成功），结果写进候选文件（新增 `- 转正判据：eligible/not-yet（basis）` 行，重建式重写保持幂等）**并落判据台账**（`step=candidate-promote`）——深睡材料据此直接看到"已达门槛"的证据。**② 判据健康报告器**：新增 `scripts/criteria-report.mjs` → 写 `~/.dsh/skills/managing-memory/audit/criteria-report-<date>.md`，含对账四指标（复用 `criteria-audit.mjs --json --out`，不写第二份实现）· 注入预算（实测 **67%**）· **rerank 触发门**（43/200 未达）· 判据分层与强制面 · **M3 调参清单**；`criteria-audit.mjs` 增 `--out`。**③ 面板 UI**：client.js 记忆板块新增「判据注册表（v2 · ADR-122）」卡（版本 / 融合+阈值 / 台账行数 / rerank 门），走**按需端点** `/criteria`，不新增常驻注入点（守「注入重复计费」红线）。**④ 面板写后库快照**：`/memory/section-edit|edit|remove` 成功后调 `bank-git.mjs`（best-effort，不动写门语义）。**⑤ 弱关联替代实体图**：库内 `notes/INDEX.md` 条目元数据表新增「**关联主题**」列 + 维护规则（深睡 pointerOps/人工填 1–2 个语义相邻主题；不引图库）。**⑥ `/criteria` 增 `rerankGate`**（索引行数 / 阈值 / 是否达门）。**验收**：typecheck/build 零错；`npm test` = 判据门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅；`/criteria` 实测 `version=v2.0.0 fusion=rrf/60 threshold=abs-cosine ledger=6行 rerankGate=43/200 ready=false`；报告器实跑写出报告（保守度 100.0% · 注入 67% · 门未达）；库 git 第 2 次快照 `c95b6a8`；L1 重生成 + 锚点 265/265 + 105/105 + 架构档 9/9 新鲜。
- **ADR-122 记忆核心 v2：判据注册表化 + 双域分离 + 台账对账（P1–P4 一次落地，2026-09-11）**：把判据从「散落的自然语言 + 多处常量」升级为「单一事实源 → 生成投影 → 机检门 → 决策留痕」四层管道，并把**摄取域**（会话→库）与**巩固域**（库→库）在架构上分离。**① 判据注册表**（`skill/engine/criteria.json`，唯一事实源）：L0 共用内核（reuse/generality/stability/conflict，枚举不打分）· L1 摄取域（归属含**降级为子判据组的四问**/落点/粒度/去重/格式）· L1 巩固域（支撑/升格/**前提识别 premise**/整形/降格/跨主题）· L2 代价权重 · 硬门与观测参数 · anti-scope；**删除「规则→SOUL.md」死支**（宿主本就无该写入通道）。**② 三处投影由生成器产出**（`scripts/gen-criteria.mjs`，禁手写）：`src/criteria.generated.ts`（两个 prompt 的判据段 + judgement 提示 + GATE/HEALTH/SURFACE 常量）· `skill/engine/criteria.md`（人读表）· `skill/engine/criteria-gate.json`（脚本面；`memory_write_gate.mjs` 与 `memory_health_check.mjs` 改为读它，env 优先级不变）。**③ 机检门**（`scripts/check-criteria.mjs`，纳入 `npm test`）：注册表自洽 + 投影最新 + **投影接线**（prompt/criteria.ts/两个脚本确实消费生成物）。**④ 双域 + 单一实现**：新增 `src/criteria.ts`（`evaluateL0` 四维代理评估 · `promoteVerdict` 升格裁决含 premise 硬门 · `demoteVerdict` 三守卫+画像节保护+单轮上限），两域共调；两个 prompt 的判据段改为生成投影（`INGEST_JUDGE` / `CONSOLIDATE_JUDGE` + `JUDGEMENT_HINT`）。**⑤ 判据台账 + 对账**：每次决策写 `~/.dsh/suite/knowledge/audit/judgement-ledger.jsonl`（域/判据/取值/决策/结果/依据；**跳过路径也留痕**），新增 `scripts/criteria-audit.mjs` 出「判据-结果一致率 · 两域冲突率 · 保守度 · 召回-判据样本量」（字段缺失返回 `n/a`，不编造）。**⑥ 表现层/运维归位**：融合改 **RRF 排名融合（k=60）**（`vec.ts`；阈值仍用绝对余弦——归一化融合分只能排序；`recallFusion=weighted` 可回滚）· 体检增**注入 token 账**（按档位 cap 估算，实测 2020 字符 ≈1347 token / 预算 3000 → 67%）与**放置审计**（主档行标签越界）· **记忆库本地 git 版本化**（新增 `skill/scripts/bank-git.mjs`：写后快照、可 diff/revert、自带「Windows 不可寻址文件名」预检自愈）· 面板新端点 **`GET /api/shoucang-panel/criteria`**。**⑦ 文档**：`spec §1.1` 重写为判据三层表、`§8 生命周期`改为显式升格链状态机；`engine/distill-contract.md` → **v7**（判据正文不再复述，只留字段语义/时序/不变量）。**验收**：`typecheck`/`build` 零错；`npm test` = 判据机检门 PASS + 40 + 30 + 18 + 18 PASS + `check-hardcode` ✅；`/criteria` 实测返回 v2.0.0 全套判据参数；手工触发蒸馏 → 台账落 **6 行**（`criteriaVersion=v2.0.0`），对账器保守度 **100.0%**（另一致率/冲突率因样本不足返回 n/a）；库 git 首次提交 `7aecee6`（580 文件）；体检 exit 0；L1 总览重生成（14 源文件 / 27 边，L1 机检 PASS）、三档锚点 265/265 + 105/105、架构档 9/9 新鲜。方案档：`docs/memory-architecture-v2-plan.md`（ADR-122）。
- **ACT-029 认知环（MCL）双通道机制化落地（2026-09-11）**：把 SC-S05 的七步循环从「提示词里」（模型自愿 read 才发生）变成**宿主必经环节** —— 新增 `src/mcl.ts`（`agent/pre-step` 钩子）+ `src/mcl-share.ts`（面板惰性桥）。**分流**：熟悉度 = 用户文本 ↔ 命中索引行的**绝对余弦**（复用 `vec.recallRanked`/`semanticSim`，不新写打分，D1）≥ `mclFamiliarThreshold`（缺省 0.65，ACT-024 校准值）**且**命中 `[路径]`/`[原则]` → **快通道**：零材料、零额外往返（不拖慢熟悉的活）；否则 **慢通道**：`step 1` 注入「薄契约（复述类型目标 / 需要就 `shoucang_recall` / 引用一条 `[路径]`｜`[原则]`）+ top-k 薄行」，体量受 `mclBudgetChars`（缺省 600）硬约束，**不进 systemPrompt 常驻面**（D7）。**有界再引导**（D2）：后续步若 assistant 未引用注入材料主题词 → 再引导 1 次（`mclMaxNudges`，之后放行，绝不死锁）。**配置**：新增 6 键 `mclEnabled`（缺省开；置 false 一键回滚）/`mclFamiliarThreshold`/`mclMaxNudges`/`mclBudgetChars`/`mclTopK`/`mclAudit`。**观测**：审计流 `knowledgeRoot()/audit/mcl-audit.jsonl`（`mcl-ready`/`mcl-step`(通道·熟悉度·注入·再引导·合规)/`mcl-skip`/`mcl-error`）+ 新端点 **`GET /api/shoucang-panel/mcl/status`**。**实现要点（接口实证，非猜测）**：`agent/pre-step` 签名与官方 `dsh-agent-instructions:1270-1288` 同款（`({agent,messages,step,signal}, next) → PreStepDecision{kind,messages}`，注入=把自造消息 splice 进 `decision.messages`）；消息用官方 `createUserMessage({content, source:{kind:'plugin',plugin:'shoucang-mcl',form:'recall'}})`（**动态 import + 手工构造兜底**，避免为仓内 typecheck 引入 `@deepseek-ai/dsh-llm` 依赖或写死本机路径）；任务文本主通道 = `session/event` 的 `user/message`（**结构判别 `source.kind==='user'`**，与 ACT-024 同口径——pre-step 的 `decision.messages` 只是本步出队消息，首步后取不到用户原话）。**验收**：新增回归套件 **`scripts/test-mcl.mjs` 18 PASS / 0 FAIL**（假 ctx + 合成事件驱动编译产物 `lib/mcl.js`：慢通道注入 321 字符/主题命中、再引导 1/1 与上限放行、快通道零注入、中途步 late-step skip、子代理不引导、`next()` 抛错不打断、reject 原样透传），已并入 `npm test`；`typecheck`/`build` 零错；热重载 active；`/mcl/status` 实测 `active:true` 且 `steps>0`（**钩子被宿主真实调用**）。方案与决策 → `.internal/arch/shoucang-SC-S05-MCL-实施方案.md`（ADR-009/010）。
- **认知可视化：画像 / 记忆 / 睡眠三视图信息深化（2026-09-11 v9）**：三个视图此前都是「只有总量、没有构成/因果」——容量看不出谁在吃、睡眠看不出睡完做了什么。**① 画像板块 · 容量构成**（新增 `kindOf()` + `buildComposition()`）：按行类别（习得原则 / 任务路径 / 能力边界 / 画像条目）聚合**条数·字符·占比·降序条**，回答"谁在吃容量"；口径已在文案注明（行合计 ≠ capacity 总数，后者含标题/空行）。**② 记忆板块 · 知识索引容量构成**（复用同一实现）**+ 指针健康**（新增 `buildPointerHealth()`，纯端侧）：扇入 TOP 8 + 悬空行告警，**直接接 §8.1 阈值语义**（≥12 标红=该升格、≥6 标橙=该裂）。**③ 睡眠板块 · 本轮产出回执 + 下轮材料预估 + 历次趋势**：新增单端点 **`GET /api/shoucang-panel/cognition/report`**（只读派生，服务睡眠/记忆两视图）——① 深睡历次回执（`audit kind=deep-sleep`：新增/替换原则、画像、指针、树操作、**forgetOps 归档/保留**、`stop` 原因与水位回滚提示）；② 下轮材料预估（遗忘候选 / 加深候选 / 互抑候选，读 `activity-candidates|hot|interference-<day>.md`）；③ 记忆冷热分布 + **覆盖率**（activity 跟踪数 ÷ 三主档索引行数）；④ 超 R 节清单（§8.1 口径，R=1000）；⑤ 归档区 `notes/archive/` 文件与体量。客户端新增共用渲染器 `renderCognitionReport(view, mode)`，sleep/memory 两视图各挂一处。**实测（HTTP 200 + 真实数据）**：深睡 20 条（最近 stop=completed / 新增原则 4）；材料预估 遗忘 13 · 加深 17 · 互抑 0；冷热 active 23 / warm 0 / cold 13，**覆盖率 46%**（跟踪 36 ÷ 索引 79）；超 R 节 12 个（TOP `env §DSH 环境` 6395）；归档 0（无遗忘对象）。**已知口径差**：端点算 12 个超 R 而 `memory_health_check` 算 11 —— 前者 `##` 子树含子节标题行、后者不含，**以 health 为准**（差异已在端点注释与本节登记，待统一口径时对齐）。验证：`typecheck`+`build` 零错、`check-hardcode` ✅、`lib` panel/client sha MATCH、热重载 active、客户端放置断言通过。
- **认知/睡眠对照 · 一次落地（#8/#5/#7/#10/#6/#2/#9，2026-09-11）**：对 13 项「人脑机制 ↔ 系统实现」逐项补缺口。**#8 主动遗忘（最大缺口）**——`activity.ts` 每轮产出「遗忘候选」却**无消费端**（只写 `audit/*.md` 无人读）：新增 `treeops.ts applyForgetOps`（只允许 `archive`/`keep`，**禁直删**；三守卫 = 叶子节 / activity 里为 cold / 非重复 stub）；`distill.ts` 材料加「遗忘候选」段 + 契约 `forgetOps` + 落盘调用 + 审计字段。archive = 该节**正文**移入 `notes/archive/<file>`、原位留 2 行 stub ⇒ **索引指针仍有效、可一键恢复、容量真降**（路 A：不做事损删除）。**#7 降权贯通三通道**——v7 的 `coldFactor` 此前只作用于**向量召回**（cold 内容仍被 grep 命中、索引行仍照常注入）：补 `panel.ts` 注入侧冷行降到补位末段 + `read_section.mjs` 冷/retired 标记。**#5 复习-强化**——`vec.ts` cold 但 `hits>0`（曾用过）系数抬到 ≥0.5（不与从未用过的同冷）+ 注入补位按 `hits30` 高者先占槽。**#10 显著性**——`activity.ts` 加 `days30`/`salience`（0–3：频次档 + 跨日档），`activity-hot-*.md` 按 `hits30×(1+salience)` 排序并出「显著性」列（只作排序权重不作门槛）。**#6 竞争性抑制**——新增 `activity-interference-*.md`（同文件 § 名 bigram ∈[0.50,0.66)，低于唯一门 0.66 故并存至今）+ `distill.ts` 材料段 + `vec.ts` 融合 topK 内**同 § 只留最高分一条**。**#2 跨日回放**——材料加「近 7 日再现」（源 `access-real.jsonl`）+ 契约加「跨日二次激活」判据。**#9 REM 相**——轻量实现：契约 `crossTopic` 通道 + 宿主**硬门（源指针须覆盖 ≥2 个不同 §）**后并入既有 `principles`（**零新增落盘代码**）；开关 `enableRemPass` / env `SHOUCANG_REM_PASS=1`，**缺省关**。**验收**：`scripts/test-forgetops.mjs` **18 PASS / 0 FAIL**、`test-treeops-split.mjs` 18 PASS 回归、`typecheck`+`build` 零错、`check-hardcode` 通过、`lib` 5 项与生效包 sha MATCH、热重载 active。**如实记的三处偏差**：#9 未做独立第二 pass（避免翻倍 LLM 成本）；#10 缺「用户拍板/纠正」档（bank audit 无结构化信号源）；#5 的「概况 30→40 字」未做（与 `write_gate` 硬规则冲突，留待行预算拍板）。方案与进度 → `docs/cognition-mapping-landing-plan.md`。
- **§8.1 分裂律落地（P0/P1/P2，2026-09-11）**：让「不停向下分裂」从文档变成可运行路径。**P0 打通分裂出口**——`src/distill.ts` 契约句原为 `section 必须既有 ## 小节名`，而底层 `memory-append.mjs` 早已支持 `父/子` 路径且深层自动建 `###`（**能力全在、只差契约**）：改为 `section = 既有 ## 名，或「父/子」路径`，并补 §8.1 分裂判据句（**子树正文 > R=1000 字 或 同级条目 > K=6 → 裂 `###`，否则并入**）；去重键由整体 `.slice(0,12)` 改**逐段**截断（`split('/').map(s=>s.slice(0,12))`，防同父下不同子撞键）。**P1 可观测**——`memory_health_check.mjs` 加「超 R(1000) 节 N 个」（`##` 按子树含子节、`###` 按自身；与 `NOTES_WARN` 同策略**只提示不 exit**，因 R 是内容律非硬门）；现网实测 env 4 个 / flows 1 个 / lessons 6 个（`§DSH 自托管约束` 6145、`§DSH 环境` 5981 等）。**P2 treeOps 加 `split`**——`src/treeops.ts` 新增把一个**叶子 `##`** 按边界锚拆成 **≤6 个 `###`** 的操作（K=6 防横向膨胀）：边界锚=子节首行原文、须在节内唯一，非叶子/锚缺失/锚歧义/顺序不符/同层重名一律跳过并归档；**幂等**（锚上一行已是目标 `###` 即 no-op）；**不改写指针**（父 `##` 保留，子节经「父/子」逐层展开——§8.1 逐层指针）；沿用 v1 的归档可回滚 + tmp+rename 原子落盘。`DEEP_SLEEP_PROMPT` 授 split 判据，并新增材料段「待拆候选节正文」（**有界**：top 3 个超 R 叶子 `##`、每个 ≤60 行——否则模型拿不到正文行，`parts[].start` 无从逐字取自材料）。**验收**：`scripts/test-treeops-split.mjs`（玩具副本，不碰真库）**18 PASS / 0 FAIL**；`typecheck`+`build` 零错、`check-hardcode` 通过、`lib` 与生效包 sha 一致、热重载 active。**未开**：`###`→`####`（等 §2.7「不建 `####`」拍板）。方案与进度 → `docs/split-law-landing-plan.md`。
- **§8.1 指针树分裂律（2026-09-11 v21）**：`skill/memory-whitelist-spec.md` §8 新增。**指针是搭树的边，不是限制树的闸**——多层指针的目的是**渐进式加载召回**（指针=延迟加载句柄）。结构律：`读一层 = O + K·E_child ≤ R`（R=1000，每层独立不累加 ⇒ **深度免费**）；分裂触发 `子节点数>K ∨ 自身正文>R ∨ 扇入>2K`（写入时判）；层数 `⌈log_K(N)⌉`；**扇出目标 K=6（§2.7 现值，避免每层横向膨胀 ×12），12 只是 Fano 硬上限**；每层须缩小候选集。展示律：注入行 100 = 固定 56 + 根指针 44，**44 只约束「一跳直达」（全路径指针），不约束树深**；逐层指针 `§本级名` 长度 O(1)。**不改任何容量数字**（5000=50×100、3000=30×100、8000=8R 均由本律反推自洽）。配套：memory-core-model §2.7 预算列字符化、write_gate 常量加「公式派生」注释（不改数）、spec v20→v21 + 变更账本。**修订留痕**：本条目曾三次改写——① 首版误把「全路径指针」成本当成树深上限（得出「深度 2 到物理顶」）；② 用户纠正「用指针搭树而非让指针限制」后解耦为结构律/展示律/两形态；③ 用户补明目的「渐进式加载召回」后补层数定式与判别增益；④ 用户指出「膨胀太狠」后 §8.1 由 111 行压到 28 行、本条目压成一行。**实测**：N≈56–65 节 → 需 2 层，现网形态即够用；超 R 节 `lessons §DSH 自托管约束` 6059、`env §DSH 环境` 5888（扇入 13）；文件 `env.md` 9099 / `lessons.md` 11211 > 8000。
- **索引台账自动登记端（2026-09-11 ACT-030 防复发，宿主）**：`src/distill.ts` 新增 `registerIndexMeta()` —— 索引行（`newIndex`）写成功后**同步登记 `notes/INDEX.md`「条目元数据表」**（幂等：同主题已存在即跳过；主题口径与体检脚本同源＝去标签 → 取 `·` 前 → 去 `→` 后 → 去 `=/：` 复合前段）。判因：元数据表是「一行一主题」的维护台账，但登记端此前**根本不存在** ⇒ 缺口随每次蒸馏单调增长（**实测存量 36 条**）。失败不阻断索引写入（体检仍以 ⚠️ 暴露缺口）。**生产实证（两条，非 mock）**：本次会话内蒸馏 `9b62a8fb` 新增的两条索引行已自动落账 —— `| 边界探针 | 2026-09-10 | agent | active | 蒸馏 9b62a8fb 新增 |`、`| DSH 沙箱边界探针 | … |`（该「蒸馏 &lt;sid&gt; 新增」格式串只存在于新代码）。另附**复刻 harness**：插入 → 二次调用幂等 → 以**真体检脚本**为裁判报「元数据表覆盖: 索引主题全部登记 ✅」。
- **归档 mark 清理器 `skill/scripts/archive-prune.mjs`（2026-09-11）**：dry-run 缺省 / `--apply` 才重写（先备份 `.bak-prune-<ts>`、tmp+rename 原子替换），复用 `archive-lib` 的 `pathConfig/readMarks/normalizeSid`（**不另立路径口径**、无本机硬编码）。判因（为何删安全）：`audit/archive-progress.jsonl` 由 `upsertMark` 按 sessionId **只增不删**维护，而消费端 `findMark(sid)` 只对**磁盘上仍存在的会话**查询 ⇒ 会话目录已消失的 mark 永不再被读到＝纯死重量；路径形式 sessionId 一律保留。
- **注入窗口相关性化（2026-09-10 ACT-027，P1）**：横幅的知识索引行原为**位置式 `slice(0, cap)`＝永远最旧 N 条** —— 实测 MEMORY.md **50 条**已登记行中 **40 条（80%）结构性不可见**（压缩/新增对横幅零影响，早先已实测）。改为**三者并集**：① **任务相关性 top-k**（复用 `recallIndex`，单一实现；`dsh-system-prompt:346` 会把 assembly context 传给 `text` 回调 ⇒ 从 `context.agent.session` 取最近一条 `user/message` 作 query）② **新鲜度保证槽**（末尾 N 条，默认 2 ⇒ 新知识必进横幅）③ **基线补齐**（防「继续」这类零命中短指令把知识行从 cap 缩到 2 的信息损失）。画像行（AGENT/USER）**保持不变**（实测取用 21/100 轮，是主力）；query 为空 / 召回无命中 / `injectRelevance=false` 时回退位置式。**缓存键加入 query**（原仅按 root 的 30s 缓存会让同一会话内永不更新）。新增配置 `injectRelevance`（默认 true）、`injectFreshSlots`（默认 2）；`/inject/preview?q=<任务文本>` 支持验证。**实测**：实时横幅由「最旧 10 条」变为 **`6 条新知识（相关性∪新鲜度）+ 4 条基线补齐 = 10 条`** —— 此前不可见的 40 条中已有 6 条进入 ✓；`typecheck`+`build` 零错、产物与生效库 sha 一致（`C9517254…`）、fiber 热重载生效。**验收基线**（`recall-eval`，改前的历史会话）：每 100 轮 画像 21.0 · 知识 12.7 · 召回工具 1.5 · 跟读 2.0；注入改动对真实会话的效果需后续会话累积后再 A/B。
- **真实读埋点补全（2026-09-10 ACT-023，P0 观测面）**：`audit/access.log` 原先**只由 `read_section.mjs` 写**，而 agent 的真实读路径（`read`/`grep`/`glob`/`pwsh` 命中记忆库）**零埋点** ⇒ 活性/遗忘/回想强度三模型失真，**实测假冷 26 条**（32 条中 26 条从未记录过命中）。补齐：① 新增 `skill/scripts/harvest-access.mjs` —— 从**会话转录**派生真实读，按「会话 → seq 水位」**增量**追加 `audit/access-real.jsonl`（幂等：复跑 0 新增；水位随文本格式代作废重扫；复用 `archive-lib.decodeTranscript` 与既有 `vendor/fzstd`，无本机硬编码）；语义=args 带 `§小节` 记该小节、仅提 `notes/x.md`（整文件读/grep）记该文件**全部已登记小节**，索引外小节不入账；② `src/activity.ts` 聚合改为**合并两份日志**（`access.log` + `access-real.jsonl`）—— 聚合本是「每轮按日志全量重算」，故形状一致即可、判定逻辑零改动；③ `src/distill.ts` 在活性聚合前经既有 `runNode`（**异步，守「禁 spawnSync」红线**）调用采集器，失败仅 log、不阻断深睡。**实测**：首轮 backfill 43 会话 → **249 条真实读**（flows 84 / env 70 / lessons 64 / tools 29 / agent 2）；驱动**编译产物** `lib/activity.js` 跑真实聚合，**假冷 26 → 9、active 6 → 23**，加深候选 **0 → 17**，30 天命中 Top = `DSH 环境(28)`/`DSH 自托管约束(27)`/`深睡蒸馏(23)`/`职责边界(22)`；`vec.ts` 的冷/退役降权随之吃到真数据（**召回排序同受益**）。`typecheck`+`build` 零错、产物与生效库 sha 一致、fiber 热重载生效。**套件覆盖**：新增 1 例（采集器 `记录 7 → 复跑 7` 幂等 + 夹具隔离），**38 → 39 例、双模式全绿**。**过程中修掉两处自身缺陷**：① 采集器与评测器同源的 **JSON 双反斜杠转义**比较问题；② 采集器 `walk()` 只收 `.zstd` → 补 `.jsonl`（否则明文夹具/归档不可测）。
- **召回评测器 `recall-eval.mjs`（2026-09-10 ACT-023，MCL 方案 P0 观测面）**：新增**只读**评测工具，把「记忆是否真的被用上」变成可复现的四项口径——① 横幅取用（索引行**主题词**在 assistant 内容中命中；探针词**运行时从索引行派生**，不硬编码、不易过期，并按画像行 / 知识索引行分列）② `shoucang_recall` 调用 ③ 指针跟读（`read/grep/glob/pwsh` 参数命中记忆库 `notes/*.md`）④ 主档直读。复用 `archive-lib`（`pathConfig/decodeTranscript/normalizeSid`）与 `vendor/fzstd.cjs`，**无本机硬编码**（会话根/记忆库根按 `~/.dsh` 与 `MEMORY_ROOT` 派生，支持 `--sessions/--bank/--exclude/--json`）。**防假零值**：探针为空（找不到索引文件）时**显式 exit 2 报错**，绝不静默返回 0 —— 否则「真的没被取用」与「根本读不到库」不可区分（已由套件用例固化）。**实测基线（20 会话 / 197 轮，剔除审计会话）**：每 100 轮 画像取用 **21.0** · 知识取用 **12.7** · `shoucang_recall` **1.5** · 指针跟读 **2.0** · 主档直读 **0.0**（其中召回 3 次 / 跟读 4 次 / 主档 0 次与我方手工审计**完全一致**）。**套件覆盖**：`skill/scripts/test.mjs` 新增 2 例（夹具会话口径可复现 + 无索引库 exit 2），套件 **36 → 38 例，双模式全绿**。**过程中定位并修复两处自身实现缺陷**：① 「是否访问本记忆库」原按字面名 `managing-memory` 匹配 → 改为按 **bank 路径**（更正确，且使夹具可测）；② tool/call 的 `arguments` 是 JSON 串、路径分隔符为**双反斜杠**，比较前须**归一转义** —— 该缺陷正是被新增夹具用例抓出（用例本身抓到了实现缺陷，属有效覆盖）。**另发现一个重要陷阱（已写入 test.mjs 注释）**：`makeContainer()` 先复制 `repoDir` 再并入 `dataDir`，**后者的 `scripts/` 会覆盖前者** ⇒ 从仓库跑套件实际测的是**生效库副本**；仓库与生效库未同步时会出现「同一套件两种模式结果不同」的假象（本轮实测：同步前仓库模式 37/38、同步后 38/38，且 37/38 的唯一差异正是被覆盖的旧评测器）。
- **体检元数据台账回填 36 行 + 存量待办处置（2026-09-11）**：按体检「未登记元数据表主题」缺口（36 条）逐条回填 `notes/INDEX.md`，**日期一律取证据（所属小节标题内日期），取不到记 `—` 并在备注披露来源**（不编造创建日）：33 条取到小节标题日期、3 条记 `—`。回填后体检报「元数据表覆盖: 索引主题全部登记 ✅」。同时处置三项存量：① `archive-progress.jsonl` 失效 mark **548/549 → 1**（复跑 0 失效）；② `MEMORY.md` 的 `[偏好] 设计极简抗堆叠` 行**跨文件错位**（spec §4 MEMORY 白名单只有 `env/tool/flow/lesson`，`[偏好]` 属 §5 USER 画像）⇒ 迁至 `USER.md`（指针与事实不变），两侧写门 exit=0；③ 9 条 `flow-candidates` 按四问全部归档至 `.processed/`（**全部 1 次/1 会话，均不满足转正判据「同类成功 ≥2 且跨会话 ≥2」**），逐条理由留痕于 `audit/2026-09-11-flow-candidates-disposition.md`。
- **清理与回到纯默认（2026-09-11，用户拍板「全部清理保持默认」）**：① **配置不留 override** —— `~/.dsh/suite/scheduler.json` 置为 `{}`（原 16 个键逐一比对，**全部等于新缺省**：persona/level/hot_memory、caps 3000/3000/5000、embed* 四项、深睡与蒸馏键），重载后实测 `persona=both level=smart hot_memory=true caps=3000/3000/5000`、`provider=gpu-ready localOk=true baseUrl=http://127.0.0.1:11434/v1`、召回 `dense0.7+lexical0.3 融合`——**证明 Ollama/11434 路线完全跑在代码缺省上，无需任何持久覆盖**。② **清残留 20 项 / 2.0MB**：本次会话的临时备份（`.bak-cap-*`、`.bak-embed-*`、`.bak-coldtest-*`、`audit/*.bak-fix-*`、`audit/*.bak-idx-*`，含 `src/distill.ts.bak-cap-20260911-012137`）与 Ollama 首次拉取被中断的 `partial-*` 孤儿 blob。③ **保留（非残留）**：`D:\AI\models\bge-m3` 的 ONNX 模型（543MB，D 盘）与桥脚本——旧 9915 路线随时可复活；生效库 `audit/backup-*`（记忆技能自身的备份惯例）。④ **遗留待办（提权受限）**：计划任务 `dsh-web-user`、`dsh-bge-embed-user` 删除被拒（`Access is denied`，当前会话非管理员）——需在提权终端 `schtasks /delete /tn dsh-web-user /f`（后者目标 `D:\lk\tools\bge-embed.cmd` **本身不存在**，任务无效）。宿主 3080 保持手动启动（`D:\lk\tools\dsh-web.cmd`）。
- **向量召回承载换成 Ollama（2026-09-11，nssm 卸载后的方案调整，用户拍板方案 A）**：原「nssm 服务 `dsh-bge-embed` + 自建 9915 桥」随 nssm 卸载停止服务（**更正**：检查期实测确认**桥的模型资产并未丢失**——实际模型在 `D:\AI\models\bge-m3`（`onnx/model_quantized.onnx` 543MB，DirectML），以现成脚本 9916 端口试跑 **2 秒起桥**、`/health` 返回 `{ok,model:bge-m3,dims:1024,pooling:cls}`；此前「资产已删」的结论系**查错目录**：只看了 `~/.dsh/memory/models`（旧默认路径）与 HF `Xenova` 缓存，未查 `D:\AI\models`），面板实测 `provider:"unreachable" localOk:false lastMode:"lexical"`（召回降级纯词法）。改为 **Ollama 承载 bge-m3**（官方库 1.2GB，模型盘 `D:\lk\Obsidian\ollama-models\models`，`ollama pull bge-m3`），`embedBaseUrl` → `http://127.0.0.1:11434/v1`：**零新进程、零服务管理器**（Ollama 自身随登录自启；用户选择宿主 3080 保持手动起，不做自启）。**代码侧四处修复/泛化**：① `panel.ts` 本机端点判定**去 9915 硬编码**——改判任意 `127.0.0.1/localhost` 基址，探测顺序 `/health`（自建桥）→ `<base>/models`（OpenAI 兼容）→ `/api/tags`（Ollama 原生），`vectorMini` 同步；② **修 `/embed/test` 拼接 bug**——原恒拼 `raw + '/v1/models'`，而 UI 预设与 `vec.ts` 用的 baseUrl 形如 `…/v1` ⇒ 实际请求 `/v1/v1/models` 恒 404、Ollama 枚举静默失效；改为已含 `/v1` 时只补 `/models`；③ `vec.ts` 嵌入超时按端点分档（**本机 30s / 云端 8s**）——本地冷启含模型加载，统一 8s 会把**首次召回**误判超时并静默降级（实测 `lastMs=8001` → lexical）；④ 缺省值对齐 `scheduler.ts` / `panel.ts` / `client.js`（预设、datalist、占位符、不可达提示）→ Ollama `11434` 为默认，自建桥 `9915` 降为可选预设。**实证**：`ollama pull` 成功（1.2GB）；`/api/embed` 与 `/v1/embeddings` 双端点 1024 维、批量 2 条通过；**A/B `/embed/test`**：修复前 `服务不可达（/v1/models 与 /health 均无响应）`→ 修复后 `mode=openai-compatible` 列 11 模型（含 `bge-m3:latest`）；**端到端召回**：`provider=gpu-ready localOk=true`、**冷启 + 空缓存下 `dense0.7+lexical0.3 融合` 5 条命中**（`lastMs=3523`，缓存重建 48→50 行，`baseUrl=http://127.0.0.1:11434/v1`）；超时实测冷启 2.2s / 热 59ms；`typecheck`+`build`+`check-hardcode` 零错误，产物与安装副本 sha 一致，fiber 热重载生效。**部署**：`lib/` + `client.js` 同步安装副本；`scheduler.json` 经面板 `/embed/config` 写入（改前备份 `scheduler.json.bak-embed-20260911-021153`），旧向量缓存移出为 `.vector-cache.jsonl.bak-embed-*`（旧向量空间作废）。
- **容量门默认值调整：画像 3,000 / 记忆 5,000（2026-09-11，用户拍板「画像默认 3000，记忆默认到 5000」）**：三主档容量门缺省由 `AGENT 3000 / USER 2000 / MEMORY 3000` 改为 **`AGENT 3000 / USER 3000 / MEMORY 5000`**（用户画像与 agent 画像等宽 3,000、知识索引放开到 5,000）。**同源面全部对齐（防漂移）**：① 生效库脚本 —— `memory_write_gate.mjs`（CAP_ENV 默认 + LIMITS）、`memory_health_check.mjs`（INDEX_FILES limit）、`engine/target-registry.json`（静态 capacity）；② **`memory-append.mjs` 补齐第四处容量源** —— 原硬编码 `3000/2000/2000` 且**不读 env**（「面板调了容量门、生效库仍按旧值拒写」的漏点）⇒ 补 `SHOUCANG_CAP_*` 覆盖（与 write_gate 同构造），宿主蒸馏/深睡调用时注入 = scheduler.json 实时值；③ 宿主 —— `scheduler.ts` 容量门 zod 缺省、`panel.ts` `CAP_GATES`/`memoryCaps`、`client.js` 输入框缺省、`distill.ts` `liveCaps()` 回落值；④ 规格与文档 —— `memory-whitelist-spec.md` **v20**（§2 总表/§4/§5 容量行 + §7 变更账本行）、`docs/ARCHITECTURE.md`、`docs/settings-guide.md`、`skill/docs/borrow-memsearch-gitmemory.md`。**实证**：`typecheck`/`build`/`check-hardcode` 零错误；**A/B 同一份生效库 MEMORY.md（3,109 字符）** —— 旧门（`SHOUCANG_CAP_MEMORY=3000`）`exit 1 超容量 3109/3000 (104%)` → 新默认 `exit 4`（仅剩既有「概况超 30 字(31)」格式问题，容量不再拦）；体检实测 `3,109 / 5000 (62%)`（改前 2,935/3,000 = 98%）；`memory-append` 夹具四例全过（MEMORY 3,450 字·无 env→exit 0 / ·env=3000→exit 1；AGENT 2,518 字·无 env→exit 0 / ·env=2000→exit 1）；面板 `/config` 实测 `cap_agent=3000 / cap_user=3000 / cap_memory=5000`（改前 3000/2000/3000）；回归套件 **39 PASS / 0 FAIL**。**过程中修掉一处用例缺陷**：`test.mjs`「门禁-超容量」原固定追加 `'内容'×1000 = 2,000` 字，在 5,000 门限下不再必然越线（实测基座 2,951 + 2,026 = 4,977 < 5,000）⇒ 落成格式错 `exit 4`，用例假红；改为**按实际基座推导追加量**并抽出 `CAP` 常量（夹具尺寸一律由它推导，不再散落字面量）。**部署**：`lib/` + `client.js` + `skill/` 同步安装副本、`skill/` 同步生效库（被覆盖文件留 `.bak-cap-20260911-*` 备份），fiber 热重载生效。
- **大节拆分第二·三批（2026-09-11，ACT-025 收尾）**：按同一「只插 `###`、零文本移动 + 守恒机检」流程完成余下各节 —— `lessons.md`（`§网络坑` 3 段、`§Windows 系统运维与数据安全` 4 段）、`env.md`（`§DSH 环境` 6 段、`§视觉方案` 3 段）、`flows.md`（`§全局工程纪律` 5 段）。**最终粒度**（notes 全量实测）：`lessons.md` 小节 4→**18**、最大节 **6082→1981**；`env.md` 7→**16**、**4845→1634**；`flows.md` 6→**11**、**1675→859**；其余 5 文件最大 ≤701；`INDEX.md §条目元数据表` 2585 **按计划保留**（非检索单元，`activity.ts` 已排除其在条目宇宙外）。⇒ **>1500 字的节：7 → 3**（其中 1 个为有意保留的 INDEX 表 ⇒ **实际超标 2 个，达 P2 门槛「≤2」**）；**全局最大节 6082 → 1981（−67%）**。**验证**：每批守恒机检**丢行均为 0**；三主档门禁 **exit=0**；`read_section` 子节抽检精确（4–5 行/节）；**套件 39 PASS / 0 FAIL**；每批各留一份备份于 `audit/backup-split-*`。
- **两级检索单元契约 + 大节拆分第一批（2026-09-11 ACT-025，P2）** + 大节拆分第一批（2026-09-11 ACT-025，P2）**：P2 实测出**结构性阻塞** —— `read_section.mjs:27` 只把 `^## ` 当标题 ⇒ ① 只把大节正文切成 `###` 子节时，读取器**仍返回整节**（跟读成本不变）⇒ 切分**无效**；② 门禁 `listSections` 若不认 `###`，`§子节` 指针会被判**悬空**。故先立 **ADR-015**（SC-S06：补丁计数 3/3 后的首个架构决策，计数已重置），确立「**`##` 大节 + `###` 子节两级检索单元，读取器与门禁必须同级支持**」，并落三处改动：① `read_section.mjs` —— 标题匹配扩为 `^## ` ∪ `^### `，**读取终点 = 下一个同级或更高级标题**（读 `###` 止于下一个 `##`/`###`；读 `##` 仍止于下一个 `##`，**既有行为完全不变**）；`access.log` 的 `s` 记实际命中标题（子节锚记子节名）。② `memory_write_gate.mjs` 的 `listSections` 纳入 `###`（§子节 可选、不再误判悬空）。③ `memory_health_check.mjs` 的小节计数与零召回枚举同步纳入 `###`。**内容侧第一批（仅 `lessons.md`）**：对最大节 `§DSH 自托管约束`（6082 字 / 97 行；35 组「目标/根因/不适用」三元组、主题交错）**只插入 7 个 `###` 波段标题、零文本移动** ⇒ 拆为 746/639/846/1097/914/731/1109 字（**最大降 5.5×**），并把**扇入最高的 4 行**重指到具体子节（`§DSH 自托管约束/§插件注册与服务判活`、`…/§诊断方法论`、`§Windows 系统运维与数据安全/§假绿与实证`、`…/§服务与重启约束`）—— **实时横幅已显示新指针** ✓。**验证**：守恒机检（仅存在于改前 **0 行**、改后仅多 7 个标题）✓；`read_section` 读子节只返回该子节（12–20 行）、读父节仍返回整节（**向后兼容**）✓；门禁**接受** `§子节` 且**正确抓出**悬空子节 ✓；三主档门禁 **exit=0** ✓；**套件 39 PASS / 0 FAIL** ✓；三份脚本仓库↔生效库 sha 一致 ✓。备份：`audit/backup-split-20260911-004821`（lessons.md）、`…-004844`（MEMORY.md / AGENT.md）。**未完成（后续批次）**：②`env §DSH 环境`(4845) ③`lessons §Windows…`(2577) ④`env §视觉方案`(2268) ⑤`flows §全局工程纪律`(1675) ⑥`lessons §网络坑`(1595)；另有 9 行仍指父节（**仍有效**，按需再重指）。**附带发现**：体检的「无指针索引行」由 1 条涨到 **3 条**（新增 `- 项目开发严格限于当前工作区…`、`- 认为 agent 收任务后应先理解任务…` 两条**画像行**，为深睡/画像通道在本会话期间写入）⇒ **ACT-030 那类问题在持续增长**，应优先修，否则体检长期非 0/2。
- **§ 名提取正则把空格当分界 ⇒ 冷热感知与竞争抑制全链路失效（2026-09-11，第三轮自查）**：三处 §token 提取写成 `§([^/→\s]+)`，而真实节名**普遍含空格**（`§DSH 环境`/`§Windows npm 执行策略`/`§DSH 官方包地基`）⇒ 提取结果在空格处被截断（`DSH`/`DSH`/`DSH`），**不同节折叠成同一 key**。后果有二：① **`panel.ts` 的注入侧冷热降权从未生效**——它用 `actMap.get('env::dsh')` 精确查找，而 activity 写入的 key 是 `env.md::dsh 环境`，**永不相等 ⇒ 恒判非冷**（`#7a`/R6 的实现一直是空转）；② `vec.ts`/`targets.ts` 的同 § 去重把不同节误判为同族，**去重后 keep 数被压到 1 → 触发保底回填 → 重复全量恢复**（去重自我抵消）。修：三处字符类统一改 `§([^/→]+)`（含空格，与 activity/审计口径一致）。**顺带落地**：把「同 § 只留最高分 + 不足 topK 按序回填」的竞争抑制从 `vec.ts` 的 fusion 分支**上移到单一实现点 `targets.recallIndex`**（panel 注入 / distill 材料 / 召回工具全体生效，守 AGENTS.md「架构单一实现」）；`recallIndex` 返回值补 `mode` 字段（消灭「用不存在的字段判路径」这类无效诊断）。**实证**：`q="Windows"` 词法命中 0 条 → 修前该查询下无任何降权/去重可言；`q="npm 装包"`/`q="DSH 环境"` 池内仍以单一 § 对为主 ⇒ **回填使其保留全部**（无竞争者时抑制无意义，行为正确），即「竞争性抑制在当前库上仍无可抑制对象」。`typecheck`+`build` 零错、`test-forgetops` 30 PASS、`test-treeops-split` 18 PASS、`check-hardcode` ✅、`lib` 5 项 sha MATCH、热重载 active。
- **体检把「画像行」误判为格式违规（2026-09-11 ACT-030，长期假红根因）**：`memory_health_check.mjs` 原先只认索引行格式（`[tag] … → notes/…`），而画像行（`- … ← 源: …`，写入口=蒸馏 `profileUpdates` 与深睡 `profileOps`）是**并列的第二类合法行** ⇒ 每条画像行都被判「无标签 + 无指针」并把退出码顶到 5（**实测 AGENT 1 条 + USER 3 条**）。修：按行首 `- ` 识别画像行类，使其**退出索引行的标签/指针判定**，但**新增独立门「画像行缺源」**（缺 `← 源:` 仍 exit 5，不放水）；元数据表覆盖校验同步跳过画像行（自由文本无 tag/主题结构）。**实证**：修前 `exit=5` → 修后 `exit=0`（三主档 无标签 0 / 无指针 0 / 画像行 4 条全带源）；**套件新增 1 例**（`体检-画像行类：带源不误判 / 缺源必报`，断言按 AGENT.md 段内容而非退出码——容器并入真实库的告警会按 max 语义压码），**39 → 40 例、双模式全绿**。顺带定位：`test.mjs` 既有的 `sanitizeIndexes()` 里「剔掉无 `→` 的 `-` 行」正是为绕过本缺陷而写，缺陷修复后该行仅剩净化用途。
- **flow-candidate 两处自身缺陷（2026-09-11，候选区处置时实测发现）**：① **「最近更新」无限累积** —— `ensureFlowCandidate` 同型合并分支只剔 `源会话/成功次数/跨会话` 三键、**从不剔 `最近更新`** ⇒ 每次合并再追加一行，**实测单文件累积 40 条重复行**（本批 9 条中 5 条中招：文件膨胀 + 「最近更新」语义失真）。修：改为**按固定字段序整体重建**（类型线索 → 每会话一行 `源会话` → 成功次数 → 跨会话 → 状态 → 最近更新），任何字段不再重复累积；源会话改每会话一行，**跨会话数可从文件自身复算**。② **宿主样板进候选区** —— 9 条候选中 **3 条根本不是用户任务**（`Current runtime context…` 运行态快照、`Background subagent|job …` 完成通知、`<system-reminder>` 注入块），且会把**不同会话的样板文本互相「同型合并」制造假跨会话信号**。修：新增按行首/标志串的**噪声闸**（只判样板前缀，避免误杀真实任务）。**实证**：复刻 harness 3 次合并 → `最近更新` 1 行 / `源会话` 3 行（可复算）/ 计数键各 1 行 / 字段序稳定 ⇒ PASS。**遗留未修（如实登记）**：候选只在 `route !== 'discard'` 时创建，而「路由成功」≠「任务成功」⇒ 失败/报错会话也会建候选（本批 1 条即此例），与「同类**成功** ≥2」判据语义不符，需 episode 带成败信号后再判。
- **体检 notes 文件级警戒线缺可判读度量（2026-09-11）**：`env.md`(9,099) / `lessons.md`(11,211) 超 `NOTES_WARN=8000` 长期只报「超警戒线」而不给度量。ADR-015 两级检索单元后**单次跟读成本＝小节体量而非文件体量** ⇒ 现并列输出**最大小节字数**（实测 env 2,265 / lessons 1,802，其余 5 文件最大 ≤674）。**处置结论：不拆文件**——拆需同步 6 处（体检 `NOTES` 数组 / INDEX 子文档注册 / 门禁 append 白名单 / 蒸馏契约 target 白名单 / `target-registry.json` / spec §4-§5），而读取本就按小节定位 ⇒ 收益为零、漂移面大；文件级行保留为「文件是否臃肿」的气味提示，并已注明「判读看最大小节」。
- **门禁用例夹具隔离补漏（2026-09-11，ACT-025 过程中实测发现）**：`skill/scripts/test.mjs` 的门禁用例（正常/超容量/悬空）原**直接以真实 `MEMORY.md` 为基座**，而活库已近容量门（实测 2935/3000 = **98%**）⇒ 在其上追加一行即**先撞 `exit 1`（容量）**，从而**掩蔽**用例真正要验的码（`门禁-悬空指针` 期望 2 却得 1）。修：新增 `gateBase()` —— 把基座**压到 80% 以下**再作夹具，三例共用。**实证**：修前 38 PASS / 1 FAIL，修后 **39 PASS / 0 FAIL（库内直跑与开发仓直跑双模式均全绿）**；`test.mjs` 仓库↔生效库 sha 一致。属 ACT-028「夹具未隔离缺陷类」的**门禁侧漏网**，**非本次内容改动所致**（判因：门禁退出码优先级 1>2，容量错压过悬空错）。
- **回归套件恢复（2026-09-10 ACT-028，P0 前置）**：`skill/scripts/test.mjs` 长期**在第 2 例即中止**（`'x'.repeat(padChars)` 负值 `RangeError: Invalid count value: -58`）⇒ 后 34 例**从未执行**、回归网形同失效（早先记录的「35 PASS」是开发仓下的旧态）。三处结构性问题一并修：① **夹具不再依赖真实库尺寸**——原算式 `0.9*3000 − 真实索引去空白字数`，库增长到 2758 字后即变负 → `Math.max(0, …)` 夹取；② **开发仓探测分支缺失**——数据在仓根 `_memory/`、脚本在 `<仓根>/skill/scripts/`，原逻辑只探 `repoDir/_memory` → 补 `../_memory` 探测，消除开发仓 ENOENT；③ **缺陷类未隔离**——体检退出码是 **max 语义**（5>4>3>2），真实库既有告警会压过用例期望码 → 新增 `sanitizeIndexes()` 夹具净化（沿用同文件 `cleanContainer` 既有先例，只净化副本不改真实库）。另三处用例修正：`体检-真实目录` 由「断言健康码 0/2」改为**冒烟（档内码）**并**新增 `体检-净容器 → exit 0`** 覆盖健康路径；`方案B-会话发现` 补 `cleanContainer`（该例漏调，prod 下真实 mark 必然击穿 `due2.count===0` 幂等断言——文件内注释已写明此机制）；三条体检用例改用新增 `execOut()`（**非零退出也取 stdout**，沿用 `runC` 既有先例）。**实证**：**36 PASS / 0 FAIL**（原 35 例 + 新增净容器 1 例），**库内直跑与开发仓直跑两种调用模式均全绿**；生效库与仓库副本 sha 一致 `1E6C3DC1…`。**附带发现**：网修好后立刻暴露一条**真实回归**——画像行（`writeProfileLine` 写的 `<文本> ← 源: …`）被体检按「无指针索引行」判 5（体检只认 `→`），即**画像行格式与体检规则不兼容**，每次画像写入都会让体检报错；该问题在体检脚本侧，已另立动作（非本套件问题）。
- **memory_write_gate「遮蔽缺口」（2026-09-10 ACT-026，架构体检发现）**：`skill/scripts/memory_write_gate.mjs` 原设计「§ 小节存在性**仅在行格式通过后**检查」，导致**同一行既有格式违规又有悬空指针时，悬空指针被静默跳过、长期隐形**——实测样本即 MEMORY.md 指向 `notes/tools.md §DSH 环境` 的那条指针（该小节不存在，却因该行概况 32 字超限而**从未被门禁报出**，须手写全库扫描才在 66 条指针里发现）。修复：① § 检查改为对**所有索引行**执行（删掉 `lineOk` 守卫，并清掉因此变成只写不读的 `lineOk`，不留死代码）；② `exit=1`/`exit=2` 的输出**并报**格式违规（`另有格式违规: …`），使两类问题不再互相遮蔽；**exit 优先级语义不变**（1 容量 > 2 指针/小节 > 4 格式）。**实证**：A/B 对照（`git show HEAD` 原版 vs 新版，同一批夹具）——pass / 超容量 / 悬空 / 短概况四类退出码**完全一致**；遮蔽类夹具由原版 `exit=4 且悬空不可见` → 新版 `exit=2 且两类并报`；真实库三主档（MEMORY.md / AGENT.md / USER.md）仍全部 `exit=0`；`node --check` 通过；生效版与仓库版 sha 一致（`88BF4C32…`）。**附注**：套件 `test.mjs` 当前有 1 条**既有红灯**（`体检-真实目录 exit=4，期望 0/2`）——该用例执行的是 `memory_health_check.mjs`（0 处引用门禁），红灯源于库内既有问题（`- [边界] …` 行无 `→` 指针、33 条未登记元数据主题等），与本修复无关；套件另在第 2 例因 ENOENT 中止，故本次以 A/B 对照替代套件背书。
- **深睡异常路径水位回滚失效（2026-09-10，架构体检发现 + 逐行复核确认）**：`src/distill.ts` 的 `deepSleepCheck` 自动路径原为**重复的 `.catch((e) => {})` 空块**——首个 catch 开块即闭合、静默吞掉异常，真正的水位回滚（`lastDeepSleepAt = prevDeepSleepAt`）挂在第二个 `.catch` 上**永不执行**。后果：`runDeepSleep` **抛异常**时（区别于返回 `'failed'`——后者由 `.then` 分支正确处理）水位已在触发时推进到 `now`，同一批痕迹**不会被重试**，违背该处注释声明的「只有 failed 回滚，同一批下轮重试」语义；手动路径 `runDeepSleepNow` 不受影响。修复=删掉那个空 catch 开块，使「返回值 failed」与「异常」两条回滚路径均可达。**实证**：`npm run typecheck` 零错误；`src/distill.ts` -1 行（2595→2594）、`lib/distill.js` 重建同步为单 catch（编译产物同样修复）。**发现路径**：project-nav 架构体检中的 shoucang L2 重提炼（子代理精读 2595 行 + 父代理逐行复核约 40 条锚点）。
- **画像/记忆板块容量与容量门同源联动（2026-09-10，用户实态发现"调了容量但 UI 没变化"）**：`panel.memoryCaps()` 原读 `engine/target-registry.json` 的**静态** capacity（恒 3000/2000/3000），而容量门生效值在 `~/.dsh/suite/scheduler.json` 的 `capAgent/capUser/capMemory`（= write_gate 的 env `SHOUCANG_CAP_*`）——两套源导致面板调容量门后画像/记忆板块容量显示不变。修复：`memoryCaps()` 优先级改为 **① scheduler.json 容量门 → ② target-registry 静态值（旧源兼容）→ ③ 内建默认**；`distill.ts` 同步新增 `liveCaps()/capEnv()`——写门 env 每次调用实时读 scheduler.json（此前用启动期 config 值，改动需重载），与面板同构同源。**实证**：`capMemory=5000`/`capAgent=2000` 生效——记忆板块显示 `MEMORY 2951/5000`、画像板块 `AGENT 531/2000`（原恒为静态 3000）；改 `capAgent=4000` 后 `/memory/overview` **立即**显示 4000（无需重载），还原后回 3000。35 PASS 无回归。
- **水位双证校验（2026-09-10 v19，抗会话格式代际迁移的 seq 重排）**：DSH 会话格式升级（V0/V1/V2 → V3）会**密集重排事件 seq** 并插入 `system/message` 行，同一数字不再指向同一事件——守藏自持的 `sessionId→lastSeq` 裸数字水位随之失效，且两种失效方向都无声：live 序号偏小 → 增量窗口被放大成整会话（LLM 成本暴增 + 重复入册）；live 序号偏大 → 挪位后的事件未被消费（静默跳过真实增量）。修复=`src/distill.ts` 水位记录随行**格式代（`session.header.version`）+ 锚点事件指纹（`type|time|data 长度`）双证**，读取经 `resolveWatermark` 校验：格式代不同（已迁移）或指纹不符（序号空间重排）即作废，从当前边界 `maxSeq` 续写（不写 0——无锚点的行会被判不可验证从而每轮重蒸，形成死循环；跳到边界既不成环也不回补不可定位的旧增量），并落审计 `watermark-invalidated`（含 `reason`/`prevSeq`/`prevVersion`/`restartFrom`）。附带两项读取侧收敛：`distillAgent` 与 `sweepBacklog` 共用同一校验实现且**共享单次 `snapshotEvents()` 快照**（此前同一会话被整表物化两遍，大会话为 O(全量)）；`buildEventChunks` 支持外部快照入参以复用该快照。验证：`npm run typecheck` / `npm run build` 零错误。
- **UI 数据全动态化审查 + 窗口聚焦刷新（2026-09-10，用户要求"审查 UI 各项数据是写死静态还是动态"）**：① 逐视图审查 6 个视图（记忆/画像/插件集合/深度睡眠/参数调节/配置原文）——除**设计常量**（知识索引档位行数 2/4/8/10 = 后端 `rowCaps`、delta 48h 有效期、融合权重 dense0.7+lexical0.3）外**全部动态获取**；键完整性核对：前端 11 个 `gVal` 键 ↔ `/config` global 12 键全覆盖，前端 20 个端点全部有后端 route。② 修 3 处写死文案：向量缓存「39 行」→ 当前实际行数；蒸馏节流说明的缺省值 → 回填当前生效值（蒸馏开关/空闲 N 分钟/最少 N 字符/预筛/蒸馏模型）；注入档位「·默认」→ 标当前档位。③ **补 `/memory/section-edit` 路由**（前端「✎编辑此小节」此前无对应路由 → 必 404 失效）：按标题层级（##/###/####）定位小节，只替换正文并保留标题与其他小节，走 write_gate 门禁 + 备份落盘，索引指针不动。④ **窗口重新聚焦刷新**：绑定 `window focus` + `visibilitychange`（返回前台）→ 面板打开时重渲染当前视图（守卫：面板未开不刷、页面隐藏中不刷、1.5s 防抖）——轻量替代全局轮询；刷新时机现为「打开面板 / 切换视图 / 重新聚焦」三处。验证：section-edit POST 200 且小节替换后其余小节完整（已还原原文）；CDP hook fetch 计数确认聚焦刷新（打开 4 次 / focus 后 2 次）与防抖（连击 first=2 second=2）；35 PASS 无回归。
- **project 卡去重门 + 存量卡合并去重（2026-09-10）**：`src/distill.ts` 新增 `cardTokens`/`cardSimilar`（英文词 ≥2 含 `vec` 等短词 + 中文 2-gram；相似度=交集/min ≥0.42，阈值经实测标定：同类对 0.444~1.0、异主题 ≤0.30）——挂到两处写入点：① `writeDispatch` 项目直写（route=project 前查 devref 既有卡标题）；② `flushDeferCards` defer 回流。近似既有卡 → 跳过写入并审计 `dupOf`（防多轮蒸馏同主题重复产卡——实测 19 张存量卡里 10 张为重复）。存量修复：19 张合并为 9 张（删 16 张重复、写 6 张合并卡、保留 3 张独立卡）。验证：测试卡（vec/caps 近似）均被判重跳过、真实蒸馏新卡（向量检索排序器/四项裁决/守藏核心模型/v17 审查）正常写入、13 张卡两两相似度无 >0.3 异主题对。
- **蒸馏分段续传 v18（2026-09-10）**：distill.ts 事件蒸馏改分段（buildEventChunks 按 10k 字符/事件边界切段，段间紧凑清单 manifest 续上下文防重复入册）；每段成功即推水位（chunk/chunkStart/chunkEnd/totalChunks 审计与 stub 标记），失败仅停本段下轮断点续传——修复 24k 截断丢尾与失败整窗重蒸；单轮上限 3 段（CHUNK_CHARS/MAX_CHUNKS_PER_RUN 常量可调，UI 后续）。一次性子代理沿用；可复用子代理+全上下文列后续档。
- **蒸馏/深睡模型独立配置 + 宿主模型选择（2026-09-10，用户拍板"LLM 直接用 Harness 模型体系"）**：① 后端拆独立键 `distillProvider/distillModel`（蒸馏）+ `sleepProvider/sleepModel`（深睡），各自可指定宿主模型或空=回落共用键→继承主会话；宿主 LLM 枚举桥 `schedulerShare.llmModels()`（listProviders→listModels 扁平）+ `GET /llm/models`（实测 53 宿主模型）；distill.ts `resolveLlm` 具体键优先回落。② UI 参数调节新增「蒸馏/深睡模型」卡——两个 Provider→Model 两级联动下拉（仿 AnythingLLM LLMProviderModelPicker），含「继承主会话」空选项，数据源 /llm/models，写 /distill/config（白名单补 4 键）。蒸馏节流区移除旧文本输入（双入口消除）。③ 向量与模型卡样式优化（Provider 胶囊按钮组 sc-prov-btns + 统一操作按钮 sc-vec-actions）。验证：选 ollama→列 ollama 模型、选 deepseek-v4-flash→scheduler.json 落盘、还原继承正常、vision 无重叠。commits cd36201/a9b3da9/7a45d43。
- **记忆/画像文档架构 v6 定稿 · 指针生命周期（2026-09-10，用户拍板五原则）**：树状分裂自动维护 ✅（既有 v5.4）；只注入压缩指针行 ✅（既有）；指针承载概况供快速路由 ✅（既有 v13）；执行中按需取正文 ✅（既有懒展开）；**新增缺口**——① **指针自动维护矩阵**：新建=蒸馏 newIndex（`src/distill.ts` 加唯一性硬门：同 `[标签]`+同主题精确拒重 / 同标签+主题 bigram 重叠 ≥0.66 近似拒重，审计 `dup-index-topic`）；扩容/重构=深度睡眠 `pointerOps.update`（DEEP_SLEEP_PROMPT v17.2 判据 + 宿主 `applyPointerOps`：原地整行替换、逐字 match、整文件过 write_gate 后原子 rename，深睡审计行加 pointers/ptrSkipped；材料新增「现行知识索引（MEMORY.md）」段）；删除=仅审计裁决。② **同类同事实唯一** 落为硬门 + 去重规则（详见 memory-core-model §2.6、whitelist-spec §8「指针生命周期与唯一性」v19）。只读口径修正：**指针对人工编辑只读、对蒸馏/深睡自动通道可写（且必须自动写）**。验证：typecheck/build 零错误（hardcode/热重载/冒烟见后）。
- **v6 向量政策第一批（2026-09-10，用户拍板"各环节凡向量可提质处皆用之，质量优先，效率遇到再解"）**：① **激活打分改融合召回**——路线④ activationStep 从词法 recallIndex 升级 recallRanked（dense 0.7 ⊕ lex 0.3），sim 口径随 mode 归一（fusion=score/100、lexical=命中/tokens），影子行加 `rmode` 供阈值再校准；② **蒸馏喂相关既有记忆**——裁决 agent 材料新增「相关既有记忆」段（recallRanked 对增量文本召回 top5 索引行），Q0 已有归属 / Q3 能合并 判定从此有库内证据（命中即视已覆盖，降重复入册）；向量未启用/失败自动词法/省略，闭环不中断。③ `DistillConfig` 增 embed* 可选键（scheduler 组装传入），`embedCfgOf` 单一构造。验证与全链路深睡 pointerOps 见后续条目。
- **v6 向量政策第二批（2026-09-10）**：① `vec.ts` 导出通用 `semanticSim`（两段文本嵌入余弦，未启用/失败=null 词法兜底）；② **newIndex 指针去重第三键=向量近似**——词法精确/近似之外，embed 可用时对同标签既有行做语义比对（去指针段、阈值 0.80 保守拒并，reason `dup-index-topic:sem`），补措辞迥异同事实漏网；③ **flow-candidate 同型语义合并**——`ensureFlowCandidate` 词法无同型后再对既有候选「类型线索」做语义比对（>0.80 并旧累计数），同型任务跨会话聚合召回提升（[路径] 转正数据更全）；embed 未启用/失败自动回退词法/新建，闭环不中断。实测 semanticSim（bge-m3 本地）：同主题异措辞 0.649 / 无关 0.274。
- **consolidation v1 · 树感知去重整合（2026-09-10，并入深睡巡检）**：`src/distill.ts` 新增 `consolidateTree(memRoot)`（runDeepSleep 内 resolved 通过后、痕迹判断前执行；纯本地零 LLM，失败仅 log 不中断）。四步：A 索引行精确重复折叠（MEMORY/USER/AGENT）；B 索引语义近重折叠（同文件+同标签+同指针，semanticSim≥0.90 保概况长者，union-find）；C 小节内重复正文行去重（保留首现）；D **叶子小节语义合并**（≥0.95 / 正文全同直并；canonical=较长者、唯一行并入、指针整段改写为 canonical 去日期核心名、链式解析终值；**带子树树干不合并=phase-1 守卫，树枝零悬空**——落实用户「树干调整须交代树枝去向」）。tmp+rename 原子落盘；删除/并入前全文归档 `audit/consolidate/`；审计 `kind=consolidate`。自测：逻辑复刻 harness（抓修指针 `notes/env.md.md` 双后缀真 bug）+ 真实库只读干跑（0 重复行/0 全同对，84 结构候选对仅 ≥0.95 触发）。实证：深睡巡检真实跑 1 轮 → 0 动作（当前库健康）、审计落账。
- **v7 A 步 · 条目活性聚合落地（2026-09-10）**：新增 `src/activity.ts` + `activityAggregate`（并入深睡巡检：consolidate 后、归纳前执行；纯本地零 LLM、零删除、失败仅 log）。索引指针 §锚 建立条目宇宙（同小节多条索引行共享一条活性，正对"同事实多份"噪音维度）→ access.log 命中聚合（{t,f,s}）→ 状态迁移（有命中 <14d=active / <44d=warm / 否则 cold，ACT-R 幂律借形）→ **遗忘候选清单**（cold 且 0 命中 或 >90 天未用 → 写 `audit/activity-candidates-<date>.md`，供 audit-protocol §3 人工裁决，**绝不自动删**）。派生数据存 `audit/activity.jsonl`（机读、原子替换；INDEX.md 人工注册表不动，守"运行时与维护分离"）。审计 `kind=activity`（tracked/active/warm/cold/archiveCands）。实证：真实跑 1 轮 → 跟踪 29（active 6 / cold 23，首轮缺命中历史属冷启动，随 access 累积自校准），候选清单已产出。
- **v7 B/C 步 · 加深候选 + 负反馈 v1（2026-09-10）**：`src/activity.ts` 扩展——① **B 加深候选**：近 30 天窗命中（hits30）≥5 且非 retired 的高频小节 → `audit/activity-hot-<date>.md` 清单，深睡归纳材料新增「活性高频小节」段（是否经 pointerOps.update 扩容概况 / principles 提炼原则由深睡按既有判据决定、宿主 gate 把关）——「反复使用反复加深」闭环接通；② **C 负反馈 v1（确定性负真值）**：读 INDEX.md 条目元数据表人工状态，`superseded/merged/archived/removed` → 行 retired（不进遗忘候选、不参与加深，防机器误判历史留痕条目）；ActivityRow 增 `hits30/retired` 字段。审计行含 retired/hot 计数。实证：直跑 activityAggregate → 跟踪 29 / retired 0（遗留 retired 主题已无活动指针，天然出局）/ hot 0（冷启动）→ RUN=0 字段落账。
- **v7 收尾 · 召回活性降权（2026-09-10）**：`src/vec.ts` `recallRanked` 融合路径接活性状态——候选池放大 topK×3（≥9），按 `audit/activity.jsonl` 对 **cold/retired 小节降权 0.35** 后重排切 topK（warm 中性、active 不罚）；锚匹配按 索引行指针 § token 与 activity 小节双向包含；60s 缓存；activity 文件缺失/向量不可用自动降级（词法直返），闭环不中断——执行时"久不用/已退役"条目自然靠后，重复噪音进一步抑制。实测端点瞬时不可用时优雅词法降级 RUN=0。
- **v7 阈值登记 UI 设置（2026-09-10）**：新增 5 个可调键 activityWarmDays(14)/activityColdDays(44)/activityArchiveDays(90)/activityHotHits(5)/recallColdFactorPercent(35)——scheduler Config schema（zod 缺省）+ /set 白名单/范围 + scheduler.json 持久 + client「活性/遗忘·校准阈值」卡（参数调节）+ distill activityAggregate opts + vec EmbedCfg.coldFactor 运行时生效；活动性/遗忘/加深/召回降权全部可在面板调，阈值单一实现=scheduler 默认。
- **深睡 treeOps 通道 v1（2026-09-10，模型自动维护树第一档）**：新增 src/treeops.ts applyTreeOps（rename/merge 两操作，宿主执行：tmp+rename 原子写、标题同层查重回滚、指针集内改写（MEMORY/USER/AGENT 先过 memory_write_gate）、操作前归档 audit/treeops/ 可回滚、幂等、审计 kind=treeops）；深睡契约 v17.2→v17.3 解除"不新建/不合并小节"禁令（模型可提 treeOps，宿主守不变量），材料加「现行树节清单」，归纳输出可选 treeOps。验证：玩具副本自测（rename 指针改写/merge 去重并入/非叶子跳过/重名回滚）+ typecheck 零错误。
- **v7 条目活性模型方案（2026-09-10，不从零造轮子）**：新增 `docs/memory-activity-model.md`——Mem0（add/search 评分+Memory Decay）/ ACT-R（base-level activation 幂律衰减借形）/ FSRS（命中=review 强化语义）/ Zep-Graphiti（矛盾即失效 invalidate）/ Letta（分层+睡眠期整合，仅借架构）五源映射 + 本项目适配（INDEX.md 元数据表零新增、遗忘四级 active→warm→cold→archive 候选、加深提升链、负反馈、recall 加 recency 维 w3=0.1）。实施序 A 活性聚合+遗忘候选 → B 加深自动提升 → C 负反馈（在 consolidation 后同轮跑）。
- **蒸馏稳健性 + 积压扫尾（2026-09-10，实态排查：多工作区会话数小时未蒸馏）**：`src/distill.ts`——① **inactive context 根因修复**：热重载/重载风暴后旧 fiber 遗留 idle 定时器在 ctx 失效后仍触发 → spawn 必报 `cannot get required service "subagents" in inactive context`，窗口全部失败且无重试（实锤 21:37–22:11Z 连续 6 次）；新增 ctx.effect 清理（dispose 时清空 idleTimers/distilling）+ spawn 失败按错误分类静默跳过（水位保留），不再污染 providerFailCount；② **积压扫尾 sweepBacklog**：启动 30s + 每 10min 巡检所有仍存根的根会话，凡水位<内存末事件 seq、已出 10min 宽限期（FSM running/probing/suspect 与宽限内跳过）即自动补蒸馏——首扫即恢复 lk-FF/project-nav 4 个积压会话（3e2b5004 入册 2 / 9a7d7ef9 入册 4 / 5f024550 入册 5 / 471aca03 入册 2），当前活跃会话正确跳过；③ **预筛大段放宽**（用户拍板）：`prescanMinChars` 缺省 4000，增量 ≥ 阈值跳过信号词预筛直接蒸馏——信息密集无关键词会话不再整段丢弃推水位；④ **日志 sid 可辨识**：`sid.slice(0,8)` 恒为 'session-' 前缀导致全部日志无会话辨识度，改 `sidShort` 取 uuid 中段。附带修正：llm 指纹标签对齐独立模型键（distillProvider/distillModel）。验证：typecheck/build/hardcode 零错误；重载后首扫 6 会话补蒸馏、4 个 completed 水位推进、fclass（gate-reject/ok/dispatch-failed）+ llm=inherited 落审计。
- **appends 小节名归一化（2026-09-10，实态补充）**：积压消化实证发现 2 条 `dispatch-failed` 的真因不是锚缺失（`lessons.md §DSH 自托管约束`/`env.md §DSH 环境` 锚均存在）而是**蒸馏模型偶发在 section 带前导 `§`**（落点日志 `notes/lessons.md§§DSH…` 双 § 为证）→ memory-append 按字面找不到既有锚；`writeDispatch` 增加小节名归一化（去前导 §、路径间游离 § 规整为 `/`，保留 父/子 语义），空节名计 failed 不入册。实证复测（741dc51b 落点失败）再补：模型还可能输出带 markdown 标记的 `## 小节名` → 归一化同步去前导 `#` 与段内标记。
- **扫尾跨实例 claim 锁（2026-09-10，观测实证）**：重叠 fiber（多轮重载各自 30s 首扫）会同时抢同一积压窗口 → 471aca03 被双蒸馏双写（首扫 22:18:59 + 次扫 22:21:08 各完成一次）；`sweepBacklog` 加 `audit/claims/<sid>.json` 在途锁（25min 内跳过 / 过期覆盖 / 无增量顺清），重叠 fiber 不再双跑同一窗口。
- **WikiSkill 借鉴全量落地 · 蒸馏审计失败归类 + LLM 指纹 + raw 裁决存根（2026-09-10，用户拍板一次做彻底）**：`src/distill.ts`——① distill-run 审计行加 `fclass` 失败归类（json-parse / provider-fail / agent-stop / dispatch-failed / gate-reject / discard / ok）与 `llm` 指纹（指定 provider/model 或 inherited），episode 同补——失败环节首次可按类聚合（audit-protocol §8 第 4 问回流）；② 新增 `audit/raw-stub/stub.jsonl` 不可变裁决元数据存根（watermark/chars/route/stop/fclass/llm/outShape 计数，**不含正文**，隐私安全）——route 分流抽验（§8 第 5 问）与契约升级离线重放的数据底座（对标 WikiSkill raw/ 只存证据）；③ 两处 distill-skip 审计补 fclass；④ 路线④ activationStep 在 `activationPrefetch` 置位时照走决策通路（影子行记 `mode=prefetch-armed|shadow`），实际注入仍待影子校准后拍板（借鉴 6 只接通路不默认开）。
- **蒸馏契约 v4→v5 · 教训带根因与适用边界（2026-09-10，用户拍板）**：`DEFAULT_DISTILL_PROMPT` + `skill/engine/distill-contract.md` + scheduler 注释同步——`appends` 条目可选 `rootCause`/`avoidWhen`（各 ≤30 字）：教训/踩坑类浓缩带 WHY 与「不适用」场景（对标 WikiSkill pattern 双记 + SKILL.md When NOT to Apply），`writeDispatch` 写入小节正文时自动追加「- 根因：…」「- 不适用：…」两行；v4 旧输出（无此二字段）照常受理，向后兼容。
- **白名单变更账本 + 审计回归窗（2026-09-10，WikiSkill 借鉴：被否提案=知识 + 轻量验证门控）**：`skill/memory-whitelist-spec.md` §7 新增第 6 步「写变更账本」（含被否尝试，回退路径必填，对标 WikiSkill skill-impact.md）+ 详情小节模板两条可选行（根因/不适用，spec v18）；`skill/audit-protocol.md` §8 三问扩六问——新增 fclass 失败归类聚合、raw-stub 存根抽验、规则变更回归窗（health exit0 + 无新绕过 + route/fclass 分布未劣化；回归 → 按账本回退路径处置；放行标准=无回归而非有提升）。
- **模型配置小白友好化 M0-M2（2026-09-10，用户要求"地址+名字对小白不友好"）**：参考/照抄 AnythingLLM `customModels.js` + Open WebUI 枚举/下拉代码（11+ 产品调研 + 代码考古，非自研）。M0——vec 缓存指纹加 **baseUrl**（换服务但同名 model 不再误用旧向量）。M1——`/embed/test` 后端枚举（OpenAI 兼容 `/v1/models`；bge 类无 /models 降级 /health→固定模型；协议纯 node:http 零依赖）。M2——UI **Provider 预设卡 + URL(datalist) + 浏览器直连枚举模型下拉三态**（选 Ollama 自动列已装模型/选 bge 降级 health/自定义云端；embedding 名弱分类标「嵌入」；URL 改后自动重探）。实测：Ollama → 下拉列出 10 模型 ✓；bge → health-fixed。发现并绕过：DSH 宿主对 panel 进程外联 11434 的网络限制（浏览器直连方案）。commits 前批 + cb72942。
- **树状记忆 v5.4（2026-09-10，用户拍板演进式多层树）**：记忆/画像/索引=**运行期自动生长的树**（索引指针冠层→notes 子树层层分裂，全部由蒸馏/深睡搭建，无手工摆设位）。落地——memory-core-model 升版 v5.4（树状知识结构语义：分裂归蒸馏/整编归深睡/指针只读）；`/memory/sections` **多层标题树解析**（## 顶层 → children ###/#### 递归）；详情页**递归树状渲染**（子树缩进逐层展开 + 每节点「编辑此小节」）；`memory-append.mjs` **section 路径分裂**（`父/子/孙` 逐级定位，深层小节不存在自动新建 ###；顶层 ## 仍须锚）——四场景实测（归父/分裂###/再入命中/分裂####）；深睡 prompt 加树状纪律（分裂归事件蒸馏，深睡不改 JSON 契约）。索引指针**只读**（编辑在树节点细节正文，指针手工改会与详情错位）。验证：sections API 三层解析实证、flows 详情 DOM 树节点渲染实证、35 PASS/0 FAIL。commits 8a078a7/f1ec828。
- **UI U1-U6 落地（2026-09-10，ui-impl-plan 施工图）**：后端——`/vector/status2`（真实 GPU provider 探测+缓存+vecStats，替代退役 vector_search.py）、`/embed/config`（GET+POST 合并写 scheduler.json）、`/memory/edit|remove|approve`（走 write_gate 门禁：临时文件整改→gate→rename 失败回滚；approve 双区 flow-candidates/pending→.processed）、overview 增 delta/vector/weekDiff、sections 增 backrefs 反链。前端——记忆板块 §0 状态徽章（蒸馏/向量/pending）+ §7 向量状态 + §8 delta + §9 周 diff、pending 行批准/忽略按钮、notes 详情被引用反链、画像行编辑（editable 行尾按钮）、参数调节「向量与模型·当前链路」节（30s 轮询防泄漏）。约束达成：画像/记忆板块分区结构零改动（只尾部/行尾 append）、sc-* 样式语言保留、写全走门禁、注入 M8 零改动。验证：端点 curl 实证（status2=DmlExecutionProvider/编辑改还原/remove 404/approve 双区）、35 PASS/0 FAIL。commits 50cf715+66209cd。
- **向量默认启用（本地 bge-m3 · GPU/DirectML，2026-09-09 用户拍板「按电脑性能配、质量为先 + 控 token/效率」）**：① `vec.ts` 词法打底空时不再直接返回——向量开则全量索引薄行池做 dense 检索（语义相似但措辞不同的真正价值场景）；本地端点免 key（localhost 无鉴权，云端仍须 API key）；② `scheduler.ts` embed 缺省开（embedEnabled true + embedBaseUrl `http://127.0.0.1:9915/v1` + model bge-m3；云端可配键不变）；③ 基础设施：下载 Xenova/bge-m3 q8（543MB，多语言 1024d，检索损失 <5%，=原 cjs 服务 dtype 配置）→ 建 D 盘 venv `D:\AI\venv-bge`（onnxruntime-directml 1.24.4）→ 新 GPU 服务 `bge-m3-openai-server-gpu.py`（DmlExecutionProvider 驱动 2070S，XLMRobertaTokenizer + q8 ONNX + cls pooling + L2 归一，OpenAI/Ollama 双兼容）→ nssm dsh-bge-embed 固化（AUTO_START）。实测：GPU 显存 ~1.6-2GB、融合召回缓存后 **200-300ms/查询**、语义查询精准命中（踩坑→网络坑教训/排障→排障原则/偏好→用户画像）。commit dfafb11。
- **S5 召回零命中兜底（2026-09-09，assistant-focus-plan S5）**：`src/targets.ts` + `src/scheduler.ts` —— 新增 `recallApprox`（零命中降级分析）：① 建议检索词 = 查询 token 中在索引行出现过的高判别词（该领域库内有、换措辞可命中）；② **库内主题地图** = notes/ 各文件小节清单（换问法的线索，至多 12 条）——设计验证修正：词法零命中时逐行部分匹配必为空（与 recallIndex 同构），真价值是主题地图而非伪近似。`shoucang_recall` 零命中分支由静默新手态改输出「建议词 + 主题地图 + pending 提醒」。验证：typecheck/build/check-hardcode 零错误；行为验证（真零命中查询 → 主题地图 12 条 / 库内词场景 → 建议词正确）；lib 同步 + 热重载。
- **S4 episode/转正数据源硬化（2026-09-09，assistant-focus-plan S4）**：`src/distill.ts` —— ① **episode 触发放宽**：蒸馏「裁决完成」（stop=completed && out，无论入册多少）即留轻 episode（含 route/outcome），不再只在入册>0 时记——episode=「任务发生+结果」的同类判定/转正数据源（memory-core-model §3.1），discard 也是有效裁决；② **flow-candidate 同型聚合**：`ensureFlowCandidate` 新增 `intentTokens` 语义指纹（CJK 双字滑动 + 英文≥4 词），与既有候选类型线索共享 ≥2 token 判同型 → 追加本次源会话并累计 `成功次数/跨会话` 计数（同会话去重），否则新建；③ **深睡材料第 5 段转正置顶**：候选按「成功≥2 且跨会话≥2」转正门槛排序置顶，深睡可据此直接归纳 [路径]（memory-core-model §4）；④ `DEEP_SLEEP_PROMPT` 路径判据补转正门槛句。存量 2 候选迁移新格式（计数=1）。验证：typecheck/build/check-hardcode 零错误；lib 同步部署 + 热重载 active。
- **S3 能力自省工具 `assistant_capabilities`（2026-09-09，assistant-focus-plan S3）**：只读工具，任务认领前自查「现在能做什么/边界在哪」——返回三段聚合：① 当前 Agent 可见工具面按族归类（`ctx.tools.schemas(exec.agent)`，DSH 官方同款用法；族=记忆/执行/文件/检索/视觉/治理/开发/编排/技能）；② 记忆库边界纪律（AGENT.md `[边界]`/`[原则]` 行，常注入）；③ suite 装配状态。只读无副作用。验证：typecheck/build/check-hardcode 零错误；lib 同步部署位 + 热重载 active。
- **write_gate § 小节存在性校验补缺（2026-09-09，S1 实证发现）**：此前指针只校验 `notes/<f>.md` 文件存在、**不校验 §小节真实存在**——深睡产物曾指向 `notes/flows.md §深睡蒸馏` 空壳小节仍 gate=pass。现 `memory_write_gate.mjs` 增加小节存在性核对（匹配口径=read_section.mjs 权威：title===kw || 双向包含，支持 `§A/§B` 并列与括号日期小节名）；只对格式通过的行检查（格式违规 exit 4 不被小节错 exit 2 抢占）。同步修正测试夹具的虚构 `§调试流程` 为真实小节 + 新增 3 用例（真实过/空壳拒/缩写过）→ **35 PASS / 0 FAIL**。
- **助理目标 S1 深睡实证闭环（2026-09-09，主线 exit 达成）**：手动 POST /deepsleep/trigger 消费 flow-candidate → 归纳子代理 stop=completed（audit：added 1 / profiles 0 / gate pass）→ **AGENT.md 产出首条带源指针 `[路径]` 行**（`[路径] 深睡记忆蒸馏 · ①区间起点先取值显式传参 ②按判据三通道提炼 ③done 才推进水位 → notes/flows.md §深睡蒸馏`）+ 晨起摘要 delta.md 生成（1 行，注入下会话热记忆「🧠 最近成长」实证）。配套：notes/flows.md 补建 §深睡蒸馏 锚点小节。方案文档 `docs/assistant-focus-plan.md` 落盘（S1-S6 阶段施工参照）。
- **架构补足第一批（2026-09-09，实态审计驱动：R3 项目事实丢失 + 深睡/蒸馏 JSON 失败水位误推进）**：`src/distill.ts` —— ① `resolveWorkspace` 增加瞬态容错（转录定位失败重试 3 次 × 1.5s 退避；路径已定位但无 workspace 归属=永久，不重试）；② `writeDispatch` route=project 且 workspace 反解失败时，projectCards **不再整批拒收丢弃**（审计实锤：route=project 入册 0/拒收 6，6 条全同因「workspace 反解失败」）——改为幂等降级落 `pending/`（`<date>-project-defer-<slug>.md`，符合蒸馏候选命名规范 → 下轮随 pending 重新裁决：workspace 恢复则直写 devref、确认泛化则入 notes；同题文件已存在不去重堆积），跨工作区红线不变（降级=暂存待认领，不落全局 notes/索引）；③ 深睡与蒸馏「stop=completed 但 out=null（JSON 解析失败，日志实锤 `Unexpected end of JSON input`×2）」一律按 failed 回滚水位——此前 completed 即 done 会推进水位，把整批痕迹/增量永久划出窗口（归纳/蒸馏结果整轮丢失）。验证：typecheck/build/check-hardcode 零错误 + 测试 32 PASS / 0 FAIL。
- **记忆核心模型 v5.2 设计定稿（2026-09-09，连续四轮会话收敛 + auto-memory/外部研究考古）**：新增 `docs/memory-core-model.md`——定位（私人助理记忆=可复用认知+人格双面）、三叠分层（底色/经验/状态）、双环闭环（成长环：蒸馏→episode→深睡→晨起摘要→月度成长页；使用环：类型认领→薄行召回→懒展开→收尾沉淀）、转正硬化（成功≥2 且跨会话≥2 + correction≤30% + successCriteria + 高风险仅 hint）、打扰度（滞回双阈值 + shadow-first + packet 纪律）、防线（纠偏防误采五闸/红线分级/容量精选）、度量、不做清单与落地顺序。本文档为方向唯一参考，实施启动时同步修订 spec/契约/架构文档。本轮纯文档，未动 src。
- **深睡契约 v17 落地（2026-09-09，路线①写侧）**：`src/distill.ts` —— ① `gatherDeepSleepTraces()` 补第 4 段「窗口内任务运行统计」（成败对比材料，ExpeL 式；只取带 stop 的 distill-run 汇总行——writeDispatch 与 distillAgent 双写审计，直接按 kind 过滤会翻倍；预算 800 字符；不携带 target 文件名/reason，守跨工作区红线）；② `DEEP_SLEEP_PROMPT` v17：任务句改「反思三通道」（认识自己[原则] + 认识用户 + 沉淀通用任务路径[路径]，对标 AWM）、新增路径判据（同类型窗口 ≥2 次且只从成功任务归纳）与路径行格式（概要 ≤40 字、变量化、禁步内 →）、成败对比句、JSON 示例补 `[路径]` 行；③ `[原则]`→`[原则|路径]` 正则放宽两处（applyPrinciples 预检 / currentList 现行清单）。门禁/体检 tag 感知：`memory_write_gate.mjs` [路径] 概要 ≤40 字 + 步内 → 判违规（防与 → notes/ 指针歧义）；`memory_health_check.mjs` AGENT tags 增 `路径`。spec v16→v17（头部/§0 AGENT 行/三级层级/§5.5 新增 [路径] 行/§5.8 标题与条目·判据·使用）；`engine/target-registry.json` 注释同步；panel/client 文案 v17。文档：`docs/agent-reflection-research.md` P1/P2 标 ✅ 已落地、README 深睡句与 AGENT 行同步、audit-protocol §5 三处。测试补 #26 [路径] 行门禁（正常 0/步内箭头 4/超 40 字 4/体检 tag 含路径）→ **32 PASS / 0 FAIL**；typecheck/build/check-hardcode 零错误。部署（lib 覆盖 profile + skill 同步 + sc restart）与手动 trigger 实证未执行，见下。
- **路线② 使用环最小件（2026-09-09）**：① 读侧词法召回工具 `shoucang_recall`（`targets.ts` `recallIndex` 单一实现：AGENT[原则/路径]+MEMORY+USER 索引行 top-k，token=ASCII 词+中文串，权重 路径>原则；返回薄行+notes 指针，详情按指针懒展开；无命中=明示新手态）；② 成长环数据源：蒸馏成功（added>0）留轻 episode（`suite/knowledge/audit/episodes.jsonl`，{intent=首条 user 消息/route/added…}，保留 256）+ 低置信任务候选（`pending/flow-candidates/`，蒸馏采集只读顶层不递归，无死循环）；③ 深睡材料第 5 段「跨窗口任务候选」（不限水位 ≤8 条，仅背景非源指针）——深睡可跨天见同类型重复（[路径] 判据数据基础）；④ 晨起摘要 delta：深睡消化后行级 diff（[原则]/[路径]/画像行 ≤3）写 `suite/knowledge/delta.md`（48h 有效、非事实源），panel 热记忆注入顶部**预留字节**插入「🧠 最近成长」（预算内不被吞，persona=off 不注入）。typecheck/build 零错误；部署（lib 覆盖 + 重启激活新工具）待执行。
- **路线③ 月度成长页（2026-09-09，纯读零定时器）**：panel `/memory/overview` 响应新增 `growth`（`growthOf()` 按月聚合 distill-audit：深睡 pass/习得/替换/画像、蒸馏 run/成败/预筛跳过、AGENT 画像现状快照 原则/路径行数与容量、本月有效产出明细 ≤5）；client 记忆板块新增「本月成长」卡组（深睡归纳 / 蒸馏 / AGENT 画像 + 有效产出列表）——"人格在长"的可见物与一致性度量载体。typecheck/build 零错误；部署待执行。
- **路线④ 打扰度影子观察 MVP（2026-09-09，shadow-first）**：新增 6 配置键（`activationShadow` 缺省开 / `activationPrefetch` 缺省关 / `activationTOn` 0.62 / `activationTOff` 0.52 / `activationCooldownSteps` 3 / `activationTopK` 3）；distill 在任意根会话 user 消息上做词法打分（复用 `recallIndex`，sim=top1 score/token 数），per-session 滞回状态机（idle↔prefetch，冷却步数防连续打扰），**只落 `suite/knowledge/audit/activation-shadow.jsonl`（含 state/prev/sim/tOn/tOff/emit/hit 前 120 字/pointers/excerpt），不注入上下文**——默认关注入、影子日志攒真实样本供校准阈值（auto-memory M7 shadow-first 纪律）。typecheck/build 零错误；部署待执行。
- **路线⑤ 向量档（2026-09-09，可选默认关）**：新增 `src/vec.ts`——① 派生缓存非事实源（`.vector-cache.jsonl` @ suite/knowledge，行 hash 惰性增量补齐，可删重建）；② OpenAI 兼容 `/embeddings` provider（key 走进程 env `EMBED_API_KEY` 或 config `embedApiKeyEnv`，不落盘）；③ 融合召回 `recallRanked`：词法 top≥8 打底 → 行向量补齐 → dense topK → **dense 0.7 ⊕ lexical 0.3**（min-max 归一）重排；④ **未配置/无 key/超时/失败一律自动降级纯词法**，闭环不中断。scheduler 新增 4 键（`embedEnabled`/`embedBaseUrl`/`embedModel`/`embedApiKeyEnv`，缺省关）；`shoucang_recall` 改走融合（返回标注 mode）。typecheck/build 零错误；部署待执行。
- **白名单重构审查（2026-09-09，v15/v16 多次调整后的全量对账）**：① **target-registry.json 删除 `project` 卡库死节**（旧 pmg cards/how-to|reference|decision 三卡册结构，v15 单库化后零消费——panel 只读 memory.capacity、targets.ts 用内建白名单、knowledge-append 运行时零调用；R3 现行为蒸馏器直写 `<workspace>/docs/devref/shoucang/` 不经注册表）；② memory 节与 targets.ts BUILTIN、write_gate LIMITS 三方对账一致（三索引 MEMORY/USER/AGENT + notes 七类 + 容量 3000/2000/3000）；③ PRINCIPLES / boards / pmg 全仓扫描确认残留均为「退役说明/变更记录」性质注释，无活性引用；④ `docs/human-loop-impl-plan.md` / `human-loop-roadmap.md` 顶部补历史文档标注（四索引/PRINCIPLES 口径已被 v16 取代，防误导检索）；⑤ distill.ts 头注释「devref-card」旧说法更正为 workspace 直写。
- **蒸馏跳过观测盲区（2026-09-09）**：门槛跳过（增量 < minTurnChars）与预筛跳过（无信号词且无 pending 候选）此前只进日志不落审计——审计里只见真实 run，「蒸馏为什么没跑」无法从数据区分是没触发还是被挡。现两类跳过均写 `distill-skip` 审计条目（带 reason 与字符数），后续可从 distill-audit 直接统计触发率/跳过率。
- **蒸馏节流组持久化 UI 通道（2026-09-09，settings-audit P1 缺口补齐）**：`enableDistill` / `idleWakeMs` / `minTurnChars` / `distillPrescan` / `llmProvider` / `llmModel` 六键此前只有插件 Config（schemastery UI 改了不持久），只能手写 `~/.dsh/suite/scheduler.json`——现经新增 `GET+POST /distill/config`（单 handler 按 method 分发，与 /deepsleep/config 同模式，避开宿主按路径去重的插件树崩溃坑）读写同一文件：POST 走 `validateDistillConfig` 校验（布尔/≥60000/≥0/字符串）+ 备份先行原子写，GET 返回 `running`（scheduler 运行时真值，经 `scheduler-share.ts` 惰性桥接新增 `distillConfig()` 暴露，**缺省值仍单一实现于 scheduler.Config**）+ `persisted`；client.js「参数调节」页底部新增「蒸馏节流（运行时通道）」分组（两开关 + 空闲分钟 + 最少字符 + 模型 provider/model，逐项即时保存），**改动需重载生效**已在 UI 与文档明示。settings-guide §0/§2 同步（新增 2.2 面板可调 6 键，原手写清单收敛为 2.3）。typecheck/build/check-hardcode 零错误。
- **注入容量预算三板块可调（2026-09-09 用户拍板）**：面板「参数调节」页新增四个数字输入——注入总预算 `injection.max_tokens`（100–8000 tokens，v16 接通生效，缺省 3000 与原硬编码一致）+ 三板块字符上限 `injection.agent_max_chars` / `injection.user_max_chars` / `injection.memory_max_chars`（0=不裁保持现行行为；逐行累加裁切不切半行，裁切时注入尾注提示）；panel.ts parseView//set 白名单+范围校验（[0,20000]）同步，buildHotMemoryText 消费全链接通。config example 与 vault 模板同步（模板零消费的 injection.smart.* 残留节顺势替换为新增键，三方缺省统一 3000）。
- **spec v16：原则层并入 agent 画像（2026-09-09 用户拍板「记忆插件最终是一个能一直学习反思迭代的 agent 助理角色」）**：**PRINCIPLES.md 退役**——跨任务泛化原则改以 `[原则]` 索引行并入 AGENT.md（agent 画像=成长档案：定位/做法/边界/教训/习得原则），蒸馏=学习、深度睡眠归纳=睡前反思、replace=迭代。① spec v14→v16（头部版本号修正：v15 单库化未同步）：§0 定位表/记忆定义/四级→三级层级句/§5.5 AGENT 白名单加 `[原则]` 标签行与容量 2,000→**3,000**/§5.8 整节改写（含**反思双通道**拍板：睡眠不仅要认识自己还要认识用户，仅其一=反思不完整）/§6.1 判定流/§7 写门目标/变更记录；② audit-protocol §5 落点改写 + 双画像巩固升格为与原则提炼并列的核心输出；③ SKILL 四索引→三索引、检索路由表同步；④ write_gate LIMITS 删 PRINCIPLES、AGENT 3,000；health_check PRINCIPLES 段移除、AGENT tags 加 '原则'；engine/target-registry.json capacity 同步；test.mjs 原则门用例改写（28 PASS/0 FAIL）；⑤ distill.ts：DEEP_SLEEP_PROMPT v16 契约（身份句=反思双通道、原则行格式 `[原则] <主题 · 一句泛化> → notes/…`、JSON 示例同步）、applyPrinciples 落盘目标 PRINCIPLES.md→AGENT.md（write_gate 'AGENT.md' 校验）、现行原则清单读 AGENT.md `[原则]` 行、PROFILE_CAP 2,000→3,000、AGENT 建档头文本=成长档案口径；⑥ panel.ts：注入面重构——原则层板块替换为 agent 画像板块（AGENT.md 全索引行，含 [原则]），**persona 档位（off|me|you|both）真正接通**（me=AGENT/you=USER，漂移键消除）、容量卡三索引制、memoryCaps 默认 AGENT 3,000；targets.ts indexTargets 删 PRINCIPLES.md；⑦ 生产库迁移：PRINCIPLES.md（空壳零原则行）→ `audit/retired/PRINCIPLES.md.retired-20260909` 归档（备份先行 ~/.dsh/backups/managing-memory-v16-*），skill/ → ~/.dsh/skills/managing-memory/ 权威部署同步，生产 health_check exit 0。
- **设置项总说明（2026-09-09，全键盘点 + 消费点核验）**：新增 `docs/settings-guide.md`——三大调节入口（面板参数调节页 YAML / 深度睡眠页 scheduler.json / 手写 JSON）+ 隐性键（模板 YAML 有、面板白名单没有、_meta 脚本消费：distill.llm 端点、lifecycle.tiers/expire、archive.staging、merge.apply 等）+ 固定常量备查 + 常见调节场景速查。**消费链核验新发现 3 处漂移键**：injection.persona（UI 可改但运行时零消费，画像现为常驻全量注入）、injection.max_tokens（UI 可改但注入预算硬编码 3000 字符不读此键）、injection.smart.* 整节（模板有、代码零读取，旧 R1 残留）；另记录模板与 example 缺省值 5 处不一致（max_tokens/complement_floor/min_confidence/age_days/boards.wiki）。injection 档位映射经核验为 low 2 / medium 4 / high 8 / smart 10 行（USER 画像与原则层不受档位限制）。
- **设置调节属性审查报告（2026-09-09，待办盘点 + 参数三通道全景 + 四记忆项目对比）**：新增 `docs/settings-audit.md`——① 待办盘点（ui-todo T1/T2 与 human-loop 批次 0-5 均已落地、HANDOVER 下一步失效、pending 零积压；新发现 distill.ts 两处「接线待办」注释漂移）；② 参数三通道盘点（面板 YAML 白名单 / scheduler.json 自持通道 / 硬编码常量）；③ 对照 dsh-auto-memory（一切皆开关）/ mem0（组件化 llm 配置）/ Letta（block limit 可配）/ LangMem（hot-path|background 双模式）提炼暴露规律；④ 结论：蒸馏节流组 enableDistill/idleWakeMs/minTurnChars 与 llmProvider/llmModel 有 Config 无持久 UI 通道（P1/P2 缺口）、MAX_WRITES_PER_RUN 建议提为 Config、PROFILE_CAP 三处同值建议收敛单一实现；写门 LIMITS/警戒线/降级判据维持 spec 协议常量不设置化。本轮仅产出审查文档，未动 src。
- **治理事实源同步 v16 + 注释漂移清理（2026-09-09）**：① project-nav 四维索引 `D:\FF\.internal\nav-index.json`——SC-S06 描述改 v16（三索引 MEMORY/USER/AGENT、PRINCIPLES 退役并入 AGENT `[原则]` 行、容量 2,000→3,000）、SC-S07 归纳落点由 PRINCIPLES 改 AGENT.md，新登记 `docs/settings-guide.md` / `docs/settings-audit.md` → SC-S02（双向映射自检通过，metadata 重算 files 47→49）；② `nav-docs.json` DOC-004 spec v15→v16 + 新增 DOC-006（设置项总说明）；③ `vector.json` 主线转 v16 真实会话验证期（退出条件=AGENT.md 出现带源指针 `[原则]` 行 + 双画像闭环）；④ `nav-actions.json` 追加 ACT-007（done）留痕；⑤ `D:\FF\PROJECT.md` 手写区与 `D:\FF\modules\shoucang.md` 同步——shoucang 功能清单由「已归档」改 v16 现行七项、架构图改单插件三模块、主线向量/决策记录补 v16、模块档案标注已上线。⑥ `src/distill.ts:89/:981` 两处「接线待办见 docs/ui-todo.md」注释改指向实际接线点（T1/T2 已落地：deepsleep-share 桥接 → panel /deepsleep 三路由 → client 深度睡眠视图）。本轮无功能改动，typecheck/build/check-hardcode 零错误。
- **架构健康度审查批次（2026-09-08，全仓审查：薄弱点/模块边界/治理漂移/死代码硬编码）**：① **suite 装配矩阵收敛单一实现**——提取至 `targets.ts` 的 `suiteAssemblyMatrix()`，`shoucang_suite` 工具与 panel `/suite` RPC（新增 `scheduler-share.ts` 惰性桥接，同 deepsleep-share 模式）共用；panel 本地 SUITE_MEMBERS 硬编码副本删除（pmg 移除后仍显示已死 governance 成员的漂移实锤）；scheduler 本地 dshHome/readInjectedRegistry/scanProfiles 副本删除，统一 import targets。② **死代码清理**：panel `walkMarkdown`（无调用）、`pointerTitle/pointerDesc`+PointerFile（R1 指针注入遗留）、`projectRoots` 配置（pmg 时代无消费）、scheduler `governancePkg`（pmg 残留）、targets `selftestMatrix(real)` 死参数（连带 probe 工具删 real 构造）、consolidateRound `workFile` 死变量；distill `distillAgent` 手写 JSON 解析段改为复用既有 `parseAgentJson`（消除同逻辑双实现）。③ **失效代码修复**：consolidateRound 清理临时文件用 `require('node:fs')`——ESM 下必然 throw 被静默吞掉（tmp 文件从未清理过），改顶部 import 的 `unlinkSync`；py 配额日志 `(>{MAX_PY_PER_ROUND} 次)` 模板插值失效改回 `${…}`。④ **跨平台/路径口径**：consolidateRound 会话目录缺省探测 `USERPROFILE`（仅 Windows）→ `dshHome()`（DSH_HOME||~/.dsh，与全插件同源）；signals.mjs 动态 import 手拼 `file://` → `pathToFileURL()`。⑤ **描述与行为对齐**：scheduler Config `distillPrompt` 描述 v2→v4、`deepSleepProbe` 描述"采样两次"→多轮采样口径。⑥ **机检增强**：check-hardcode 盘符模式泛化为任意字母（此前只查 D:/C: 两盘，其余盘可逃逸）。⑦ **配置模板重写**：shoucang.config.example.yaml 原内容（suite/gates/verify.g30/state_dir）与 panel 解析器键**零重叠**，重写为 parseView+/toggle+/set 白名单全覆盖版（boards/injection/archive/lifecycle/merge/idle/embedding，含范围注释）。⑧ **治理修正**：AGENTS.md 结构表/规则/命令段 `plugins/shoucang/` 旧路径全部更正为仓根形态并补「架构单一实现约定」；CLAUDE.md 要点同步；HANDOVER.md 顶部加历史文档标注。
- **UI 样式专项审查（2026-09-09，动态获取链路 + pmg 移除残留双向审计）**：① **状态栏样式失效修复**——`bar.id='sc-statusbar'` 只挂 id 未挂类，而 CSS 写的是类选择器 `.sc-statusbar`，状态栏样式自上线起从未命中；现 `el('div','sc-statusbar')` 双挂。② **pmg/wiki 时代死样式清理 27 条**（全部经「CSS 定义 ↔ DOM 使用」双向差集脚本确证零使用，含模板拼接/innerHTML 盲区排查）：旧板块列表 `sc-board-list`、旧卡片头 `sc-card/sc-card-head/sc-card-name/sc-card-meta`（`sc-card-body` 保留在用）、旧 vault 文件树 `sc-explorer/sc-tree 系列 6 条`、旧笔记详情 `sc-note(容器)/sc-note-placeholder/title/meta/props/sc-prop-row/name/value/sc-note-body`、白名单链接 `sc-wl-link`、旧入口图标 `sc-trigger-glyph`、旧索引分组头 `sc-idx-group/group-head/file/cap`。③ **补缺**：`sc-idx-list` 此前 DOM 使用但无 CSS 定义（靠内联样式兜底）——正式定义并删除内联重复。④ **宿主变量降级健壮性**：`.sc-trigger` 的 `--dsw-alias-label-primary/--dsw-alias-interactive-bg-hover` 补 `var(--sc-*)` fallback（宿主变量缺失时不再失效）。审查通过项：样式注入机制正常（面板打开时 `<style>` 幂等注入 + 卸载移除）；`--sc-*` 深浅色经 `prefers-color-scheme` 自适应正常（设计=跟随系统，注释明示）；sparkline/idxPill/徽章等 JS 内联动态样式正常。build:client 已同步 lib/。
- **架构健康度复查批次（2026-09-09，链条闭环/死代码/遗留配置/硬编码四维全仓审查）**：上轮审查批次 4 处「声称修复但未落地」的遗漏本轮补齐——① **panel /suite 切 schedulerShare 桥接**：删除 panel 本地 `SUITE_MEMBERS` 硬编码副本（含已死 governance 成员的假数据）与双基准扫描重复实现（40 行），/suite RPC 改经 `schedulerShare.api.suiteScan()` 读取 targets.ts `suiteAssemblyMatrix()` 单一实现（调度器未就绪=如实空态）；连带 `memoryHomeOf`/`suiteHomeOf` 三处内联 `DSH_HOME||~/.dsh` 探测收敛到统一 `dshHome()`，删除失效的 `SuiteMemberRow` type 导入；② **signals.mjs 动态 import 落实 `pathToFileURL()`**（上轮只加了 import 未改调用点，含空格/中文路径下静默降级内嵌副本）；③ **py 配额日志插值修复**（`(>{MAX_PY_PER_ROUND})` 缺 `$`）；④ **distillPrompt 版本描述统一 v4**（interface 注释 v2 / schema description v3 与实际契约 v4 漂移）。另：client.js 删除治理知识库时代死样式 6 条（`.sc-gm-*` ×5 + 无使用点的 `.sc-tag.dim`）；panel 头注释 RPC 清单与启动日志对齐实际 20+ 路由（删除已不存在的 boards/tree/note 路由文案）；verify 工具 Q3 落点文案 pmg「devref-card 迁移」→ v15「workspace devref 直写」；writeProfileLine 门禁注释澄清（单行 ≤160 / 库容量 ≤2,000）。审查通过项：三条链闭环（事件→蒸馏→写入审计 / FSM→探测→归纳→write_gate→水位回滚）、suiteAssemblyMatrix/dshHome 单一实现约定（scheduler 侧）、桥接 type-only 无循环依赖、example yaml 与 parseView//toggle//set 白名单全对齐、遗留配置键（migrate_enabled/default_project/generic_project/wiki_root 等 6 键）零残留、typecheck+build+check-hardcode 零错误。
- **单库化 + 双画像通道（2026-09-08 用户拍板 v15，记忆架构再进化）**：**① 单库化**——「守藏只是一个记忆插件，真库只有一个」（`~/.dsh/skills/managing-memory`）：取消 route=project 的 pmg-cards/local-pending 二分（pmg 卡库随治理插件移除后本就是死胡同），蒸馏契约 v3→**v4**——R2 跨项目细粒度条文改入 notes（原 generic 板块承接），R3 项目专属事实**直写项目工作区 `<workspace>/docs/devref/shoucang/`**（workspace 由会话转录反解；反解不到=无项目归属，如实丢弃并审计，跨工作区红线）；`targets.ts` 删 projectChain/PMG_BOARDS/gateProjectCard，`BUILTIN_WHITELISTS` 收敛为单库；面板「治理知识库」视图与 `shoucang_migrate` 工具（pmg 专属死功能）整体移除；配置键 `migrate_enabled`/`default_project`/`generic_project` 删除。存量 2 条 pmg 缺席积压卡已按新落点迁入 `D:\lk\FF\docs\devref\shoucang\`，原件移 `pending/.processed/`。**② 双画像通道**（助理的自我认知）——USER.md=用户画像（库中唯一直接关于「人」的文件），AGENT.md=agent 自我画像（角色定位/稳定做法/能力边界/常犯错误教训），**库中其余 notes/原则/索引皆为 agent 为履行助理职责积累的自身资产**；此前契约 Q2「归谁 MEMORY/USER/AGENT」有问无通道（画像从未被写入），现补齐：蒸馏 `profiles` 字段（route=memory 时 0-2 条，USER/AGENT）+ 深度睡眠 `profileOps`（add/replace，须 notes 源指针，与原则同判据同红线）；宿主直写（tmp+rename 原子），门禁=target 白名单+小节防注入+单条 ≤160 字符+库容量 ≤2,000+去重+replace 须 match 逐字存在。测试 28 PASS/0 FAIL。
- **会话活跃状态机（2026-09-08 用户拍板：长线任务/卡住/异常退出必须能区分，不能打补丁）**：深度睡眠判定由「单点时间戳」重构为显式状态机——任意事件→RUNNING、turn/end(completed)→ENDED；RUNNING 无事件 ≥`deepSleepProbeAfterMs`（缺省 3h）→ PROBING：采样会话转录文件两次比对 mtime/size → 输出增长=**正常长任务**（刷新水位不睡）/ 无增长且会话仍在=**STALLED 疑似卡住**（不阻塞睡眠 + 审计告警 `deep-sleep-probe:stall` 提示人工确认）/ 无增长且会话已消失=**EXIT 异常退出**（计入停滞）/ 探针不可用或探测异常=无法确认，**按停滞处理→正常睡**。**用户拍板口径：除「长线任务正在推进」外，其余情况一律正常睡眠**；停滞计时一律沿用最后事件时刻、不刷新成当前时间（否则每 3h 重试失败会永远睡不着），仅采样窗口内「未决」时跳过本轮（最多延后一个巡检周期）。新增配置 `deepSleepProbe`/`deepSleepProbeAfterMs`/`deepSleepProbeWindowMs`。附修：痕迹窗口改按 mtime/时间戳判定（修 pending 文件名 UTC 与本地日切错配）、窗口起点=max(本日 0 点, 上次睡眠) 防重复回想、痕迹清单先给全 + 单文件正文上限（多工作区预算公平）、归纳契约加「跨工作区红线」（项目专名/路径/一次性事实不上提，原则常驻注入所有工作区）。`registerDistill` 返回 `getDeepSleepStatus()` 快照供 UI 消费。
- **探测可靠性加固（2026-09-08 用户要求：防单次采样错判误睡长任务）**：探测由「两次采样」升级为**多轮采样 + 多信号交叉 + 二次确认 + 失败重试 + 时长兜底**：① 每轮 `deepSleepProbeSamples`（默认 3）次采样，任一次检出转录增长即判长任务；② 多信号交叉（转录 size/mtime + 事件心跳 + agent 存活 + agent 状态），**状态活跃但无输出增长=证据冲突 `conflict`** → 转 `suspect` 复核而非直接判卡住；③ 判卡住需连续 `deepSleepProbeConfirm`（默认 2）轮，首轮落 **`suspect` 新状态（阻塞睡眠）**待下轮巡检复核；④ 探针不可用/异常重试 `deepSleepProbeRetries`（默认 2）次；⑤ 单轮 `deepSleepProbeMaxMs` 兜底防悬挂；⑥ 探测期间来新事件立即中止并回 RUNNING（卡住可复活，清 stallRound）。状态快照新增 `suspect` 计数与 `probeEvidence`（rounds/samples/deltaBytes/alive/active）便于排查。
- **防漂移审查（2026-09-08，project-nav 主线）**：核查三条链——执行任务链（session/event→idle→distill）、蒸馏固化链（route→白名单→写入→审计）、睡眠链（FSM→探测→归纳→write_gate→PRINCIPLES）。结论无漂移：生产库无 whitelist.json（走内建，已含 PRINCIPLES）、engine/target-registry 一致（PRINCIPLES + 容量 1000）、7 个 notes 全部在 notes/INDEX.md 注册（write_gate 指针校验不会误拒）、PRINCIPLES 仓内与生产副本同步。治理索引登记 **SC-S07 深度睡眠状态机与探测链**（fileToFeature：`src/distill.ts`→[SC-S03,SC-S07]、`src/scheduler.ts`→[SC-S03,SC-S07]、`docs/ui-todo.md`→[SC-S07]）。
- **UI 待办清单（2026-09-08 登记）**：新增 `docs/ui-todo.md`——T1 会话状态机可视化（数据契约/配色/接线点）、T2 睡眠唤醒时间判断的可视化与可调（阈值配置项 + 手动触发 + stall 告警）。本轮只做内核与数据接口，不动样式。
- **深度睡眠面板视图落地（T1+T2，2026-09-08 续做「UI 待办」）**：两项全部实现。新增 `src/deepsleep-share.ts` 跨插件共享引用——panel 与 scheduler 共用同一 ctx，但 `index.ts` 先 `applyPanel` 后 `applyScheduler`，故用惰性桥接：scheduler 启动期把 `registerDistill` 返回的 `{getDeepSleepStatus, runDeepSleepNow, getConfig}` 挂上共享引用，panel RPC 请求时读取（读不到=未激活态，不报错）。panel 新增 `GET /deepsleep`（状态快照）、`POST /deepsleep/trigger`（手动归纳，复用 `deepSleepRunning` 并发守卫）、`GET/POST /deepsleep/config`（运行中配置展示 / 写 `~/.dsh/suite/scheduler.json` 五个深度睡眠键，原子写+备份先行，改动需重载生效）。client.js 新增「深度睡眠」导航视图：T1 五态徽章（running 绿 / ended 灰 / probing 蓝闪 / suspect 蓝 / stalled 红）+ 会话明细（色点+停滞时长+探测结论文案）；T2 计时（已停滞 / 下次入睡倒计时 / 上次入睡）+ 控制（立即归纳一次 / 暂停到明天）+ 阈值可调（enableDeepSleep·idleMs·probeAfterMs·probeWindowMs 滑块，重载生效）+ 卡住红告警。`registerDistill` 返回值由 `{getDeepSleepStatus}` 扩展为三函数。红线：deepsleep-share 仅 type-only 引用 `DeepSleepStatus`（无运行时循环依赖）；check-hardcode ✅。
- **深度睡眠自动触发（2026-09-08 用户拍板：全部会话停滞 ≥3 小时自动执行）**：守藏蒸馏器新增独立巡检定时器（10min）——无任何根会话 turn/end 活动持续 ≥`deepSleepIdleMs`（缺省 3h，可配 `enableDeepSleep`/`deepSleepIdleMs`，自持 scheduler.json 同通道）且无活跃会话 → 自动执行一次深度睡眠归纳 pass（作用域=当天痕迹：本日 pending + 本日写入 notes + 本日 access 命中）→ 归纳子代理提炼原则 JSON → write_gate 校验 → `PRINCIPLES.md` 原子落盘（add 去重 / 冲突原地 replace；每轮停滞窗口至多一次，新活动重置水位；重启从蒸馏审计回放水位）。规范同步：audit-protocol §5 / spec §5.8 写入口径改「宿主停滞 ≥3h 自动触发 + 审计手工兜底」；内建白名单 indexTargets 补 PRINCIPLES.md（四索引对齐）。审计轮仍可手工兜底同一 pass。
- **记忆架构批次 1-3 落地（2026-09-08）**：批次1 文档失真修复（SKILL/README 解除过时退役标注转现行状态、spec §5.5 AGENT 容量对齐 v10 口径、human-execution-loop 补「召回即修正」再巩固纪律）；批次2 降级提纯（audit-protocol §3 提纯降级 SOP + §5 双向生命周期降级判据「连续 2 次审计零命中且非 env/release」、health_check 候选统计段增零召回清单）；批次3 四级层级 spec v14（§5.8 原则层 PRINCIPLES.md：L0 图式 ≤1,000 硬限、唯一写入口=审计深度睡眠归纳 pass（作用域=当天痕迹）、原则行格式 `- 原则 ← 源: notes/…`；SKILL 三索引→四索引、L3 原则层路由；write_gate/health_check 支持 PRINCIPLES；_memory 建档）。测试 28 PASS/0 FAIL；check-hardcode ✅。
- **人化执行体系实施方案（2026-09-08）**：新增 `docs/human-loop-impl-plan.md`——批次 1-5 逐项执行规格（精确文件/锚点/验证命令/回退方式）：批次1 文档失真修复 → 批次2 降级提纯（协议+health 零召回清单）→ 批次3 四级层级 spec v14（PRINCIPLES 原则层/写门/深度睡眠归纳 pass）→ 批次4 project-nav 索引同步（原子写约束）→ 批次5 部署生效。
- **人化执行体系优化路线图（2026-09-08）**：新增 `docs/human-loop-roadmap.md`——全量优化方案总览：已落地 4 项（七步循环总纲/循环完整版四要素/循环×记忆钩子/任务流程增强）+ 待拍板 4 项（A 主动遗忘=**降级提纯机制**：用户拍板方向修正——遗忘不直接删，细节下放更低记忆板块并提取通用经验，三级降级设计触发→提纯→降级→兜底，与蒸馏教程式浓缩同构；B 嵌入模型升级触发判据与路径；C 部署生效；D 记忆层级扩展=**新增 L0 原则层 PRINCIPLES.md**——四级层级 L0 图式/L1 索引/L2 详情/L3 暂存归档，提纯全链 pending→notes→原则，睡眠巩固双机制=即时小睡（事件蒸馏，已有）+深度睡眠（**回想巩固当天记忆**的归纳 pass，作用域限当天痕迹））+ 平台层 SOUL.md 可选补强项 + 设计原则四条。
- **循环 × 记忆钩子表（2026-09-08）**：human-execution-loop.md 新增「循环 × 记忆钩子」节——七步循环各步的检索钩子（查什么）与写入钩子（何时沉淀）显式成表，原则=检索贯穿全程（线索触发）、写入只在⑥回溯与⑦收尾两个闸口（对应人脑「随时回忆、离线巩固」节律）。
- **人化执行循环完整版（2026-09-08）**：新增 `skill/human-execution-loop.md`——七步循环逐步展开为「决策点 / 所需地基 / 判定标准 / 失效信号」四要素（横切地基：三索引/任务类型/goal/红线清单；人类依据：信息觅食、Kuhlthau ISP、程序理解研究、内外双循环、ReAct/Plan-Act-Reflect/Reflexion 印证）。task-protocols §1 总纲、SKILL L3 速查、README 拓扑三处指针同步接入。
- **人化执行循环集成（2026-09-08）**：`skill/task-protocols.md` §1 新增「人化执行循环」总纲（① 澄清意图 → ② 侦察环境 → ③ 计划+未知项 → ④ 小步执行 → ⑤ 每步验证 → ⑥ 偏差即回溯 → ⑦ 沉淀记忆；依据信息觅食/采莓模型与老手开发流研究，需求随执行演化、线索变弱即换向、证据冗余即停）；build 流程方案模板补「未知项」、执行补「连续 2 次无实质进展即停走 §0」监控；consult 流程补检索停止条件（证据冗余即停）；SKILL L1 §2/§3 同步（方案模板补未知项 + 总纲路由）。
- **打包形态修正（2026-09-08，github 安装不可激活问题）**：插件包自 `plugins/shoucang/` 提升至**仓库根**（dsh 单插件仓标准形态，对齐 dsh-prompt-enhancer）——根 package.json 携带 dsh.bundle 契约、cordis.patch.yml id/name 改为包名 `dsh-shoucang-memory`、**lib/ 构建产物入库**（github: 安装无现场编译，产物随仓走）。修复 `dsh plugin add github:` 报「declares no dsh.bundle，装成 plain dependency 不激活」。
- **无旧版适配清理（2026-09-08 用户拍板：项目未正式发布，不考虑老版本适配）**：合并插件 config 由 panel:/scheduler: 嵌套两节改为**扁平单层**（z.intersect 组合两组 schema，运行时解析合并验证通过）；shoucang.config.example.yaml 删除纯旧版兼容残留 wiki_root 节（零代码引用）；README/配置头注同步去掉「对号入座/兼容旧配置」表述。
- **⛔→🔄 仓重构：双插件合并 + pmg 移除（2026-09-08 用户拍板）**：dsh-managing-memory 项目迁入本仓（公开树 → `plugins/shoucang/skill/`，私人数据 → 仓根 `_memory/`，gitignore；源仓保留冻结）。shoucang-panel + shoucang-scheduler + managing-memory 三位合并为**单一插件** `plugins/shoucang/`（@dsh-external/shoucang v0.3.0）：config 分 panel:/scheduler: 两节（字段与合并前一致），suite 外部成员表清空（记忆技能内嵌、pmg 移除），typecheck+build 零错误。**项目治理插件（project-map-governance）整体移除出架构**：docs/map 拆除、pre-commit 地图检查删除、ADR/地图/卡库机制不再维护；本仓与记忆仓历史 ADR+facts 分别存 `docs/history/` 与 `plugins/shoucang/skill/docs/history/`（只读）。AGENTS/CLAUDE 重写为精简工作约定（4 条规则）；README 重写为单插件架构。插件仍未上线（dsh-web 无软链），重启时软链指向 plugins/shoucang。
- **⛔ 守藏退役归档（2026-09-07 用户拍板，本仓 ADR-0003 / pmg 权威仓 ADR-0003）**：插件从 dsh-web 下线（`~/.dsh/plugins/shoucang-panel` 软链删除，仓库本体保留），记忆职责移交 dsh-auto-memory。ADR-0001（集合中枢定位）/ADR-0002（蒸馏唯一权归守藏）双双 superseded，F-001/F-008 superseded；README 定位声明改退役实态，suite 数据 `~/.dsh/suite/knowledge/` 零损失保留（只读）。本仓转冻结归档仓（治理文档 AGENTS/CLAUDE/docs/map 为 gitignore 本地文档，已同步改写不入库）。
- **本地可复现构建路径 build-local.sh（2026-09-06，遗留项落地）**：DSH 源码 checkout 本机不存在，scripts/build.sh 不可用 → 新增 scripts/build-local.sh + tsconfig.local.json（npm run build:local），无 checkout 环境可编译。三个踩实前提：① 编译依赖落 devDependencies（npm 对 peerDependencies 按名安装会静默跳过；@deepseek-ai/dsh-tools 传递依赖自带 @deepseek-ai/cordis）② --legacy-peer-deps 防 npm 10 arborist 在 dsh-llm 预发布 peer 区间崩溃 ③ moduleResolution=bundler + cordis paths 映射 @deepseek-ai/cordis（npm 版 cordis type:module+无扩展名 d.ts 在 NodeNext 下星号导出失效 TS2834；ESNext 产物与 NodeNext 等价）。clean-room 复现（rm node_modules lib → 全新构建）通过，产物含契约 v3.1 prompt，self-reload 热重载生效；发布构建仍以 checkout build.sh 为权威
- **阶段 2 复审修正（2026-09-06，切换前全面审查）**：① **补回并发守卫**——迁移时遗漏记忆插件原版 `distilling` Set（同会话蒸馏在途标记），蒸馏在途（最长 10min）内再次 turn/end 会重武装定时器导致双写/竞态，已补回（add/finally.delete 配对）；② **pmg 写门双部署口径统一**——skills 副本与 plugins/engine 两处 devref-card.mjs 并存（pmg 治理双部署同步约定），targets.ts `pmgScriptsRoot()` 改双路径探测回退（skills 优先/engine 兜底），index.ts migrate 工具同源引用，消单点漂移；③ 审计双条（writeDispatch 明细 + distillAgent 汇总）保留为有意设计；pending 候选正则放宽为 `\d{4}-\d{2}-\d{2}-*.md`（有意，覆盖 R2 回退文件）。修复后 E2E 6/6 复验通过
- **阶段 3 单飞切换落地（2026-09-06）**：蒸馏唯一权正式移交——scheduler `enableDistill` 缺省 `false→true`（lib 重编确认，registry/staging 无覆盖），记忆插件同批关闭蒸馏（其 lib 缺省 false）；数据迁移：水位 16 行 + pending 26 文件 → `suite/knowledge/`（audit/ + pending/，路径与 distill.ts 读取根吻合；原文件重命名 `.migrated-20260906` 保留可回滚）；self-reload 同批热重载（reload-debug 确认 match，记忆插件日志确认「蒸馏 off」）——**无双写窗口、无去重逻辑**；水位最新行为切换时活跃会话，衔接无缝。记忆仓治理同步：ADR-0007（accepted）+ facts F-001/F-002 superseded + CHANGELOG 归一（技能仓 a91574e、pmg 44590a3、本仓 e703ff2）
- **蒸馏契约 v3：粒度判定锚 + 通用板块路由（2026-09-06 用户拍板）**：两库区别不是主题类别是粒度分工——记忆库=泛化元记忆（人脑类比，只收「下次做类似任务给大概方向」的粗粒度指引，宁粗勿细）；pmg 卡库两板块收细粒度（board=generic 官方规范/平台规则/DSH 开发规范条文→通用知识库=pmg 权威仓 docs/devref；board=project 项目事实/开发中用户决策→当前项目卡库）；超出范围一律不存、无承接插件丢弃不回退。scheduler：DEFAULT_DISTILL_PROMPT v3（粒度锚+board 字段）+ writeDispatch board 分发（generic→config `generic_project` 宿主，未配置降级 pending `[board:generic]`）+ config 新增 `generic_project`。事实源：记忆仓 distill-contract v3 + spec R0 锚 + facts F-003；pmg 板块白名单 docs/devref/whitelist.json（库自治）。E2E 6/6 回归过
- **panel 阶段 4 UI 同步：双根知识区 + 蒸馏统计卡（2026-09-06）**：host（src/index.ts）——① 新增 `suiteHomeOf()`（`$DSH_HOME/suite/knowledge` 探测）与 `distillStatsOf()`（`suite/knowledge/audit/distill-audit.jsonl` 全量聚合：runs/added/rejected/failed/gateRejects/writeFails/byRoute/last/尾部5条明细）；② `/memory/overview` 记忆库读取逻辑提取为 `memOverviewOf(base)` 双根复用，响应新增 `suite` 块（守藏知识区 indexes/pending/notes，与记忆库同构）与 `distillStats` 块，原字段全保留（向后兼容）；③ `/memory/sections` 加 `root` 参数（`root=suite`→守藏知识区，缺省 memory），响应回显 root。client（client.js→build 复制 lib/client.js）——记忆板块 stat 网格新增「守藏蒸馏」卡（次数/入册/最近时刻）与「蒸馏路由」卡（memory/project/discard 分布 + 拒收/失败/门拒计数）；新增「守藏本地知识区」板块（三索引容量卡 + suite pending + notes chips 点击 `root=suite` 直达小节）；notes 浏览返回按钮按 root 显示「返回守藏知识区/记忆库」。验证：热重载后 overview 实测 `suite.present=true`、三索引/pending 26/notes 七类、distillStats 聚合正常（runs=0 待命态）、双根 sections 全通；client 语法过、host tsc 零错误
- **调度器自持配置通道 `~/.dsh/suite/scheduler.json`（2026-09-06，契约 v3 落地配套）**：注入插件不进 loader 配置持久化（super-injector dev_inject 硬编码 config:{}，重启不恢复），schemastery UI 配置对本插件不持久——scheduler 启动时读该 JSON 就地覆盖 config 缺省（键名同 Config，缺文件/坏文件=纯缺省不 fail-loud）。已落生产值 `generic_project=D://FF//dsh-project-map-governance-plugin`：蒸馏 board=generic 卡自此直写 pmg 权威仓 docs/devref 通用知识库，不再降级 pending。
- **ADR-0002 阶段 2 蒸馏器落地（2026-09-06）**：`shoucang-scheduler` 新增 `src/distill.ts`——自记忆插件迁入事件驱动蒸馏机器（session/event turn/end → idle 定时器 → snapshotEvents 水位增量 → 信号词预筛 → spawn 蒸馏子代理 maxDepth=1+persona 委派禁令+toolFilter → JSON 裁决 route=memory|project|discard），**写入分发重接 targets.ts**：动态路由 + 各库白名单门禁（不符合不存、拒收写审计）+ 零拷贝写入（memory-append 经 MEMORY_ROOT 切区 / devref-card 派发 / pmg 缺席落 pending 积压兜底）；水位迁 `suite/knowledge/audit/distill-watermark.jsonl`，新增蒸馏审计 `distill-audit.jsonl`（UI 统计卡数据源）；补强 LLM 路由连败≥2 弃用指定 provider 回落继承（坑位卡原缺陷）。config 增 distill 节（enableDistill 缺省 false——单飞切换时开启）；inject 扩 ['tools','llm','subagents','agents']。验证：**E2E 隔离自测 6/6**（临时 DSH_HOME + mock 子代理驱动全链：事件→增量→预筛→spawn 契约→路由→白名单放行/拒收→真实 memory-append 写入→水位推进→审计留痕）；**连带发现并归一修复记忆插件 runAsync2 退出码恒 0 缺陷**（安全阀拒写被计成功，主仓 commit 1d4d178）
- **ADR-0002 阶段 1 目标层落地（2026-09-06）**：`shoucang-scheduler` 新增 `src/targets.ts`——R0 动态目标路由（memory→记忆插件库→守藏本地三索引；project→pmg 卡库→本地 pending，装配探测复用 registry+profiles 双基准）+ 白名单门禁（各库数据根 `whitelist.json` 自治、蒸馏器只读消费、不符合不存、缺文件回退内建缺省并标注来源）+ `shoucang_targets_probe` 只读自测工具（组合矩阵 4 行 + 现网实测 + 门禁抽样）。守藏本地知识区建成 `$DSH_HOME/suite/knowledge/`（三索引+notes 七类+INDEX 注册表+pending+audit+whitelist.json，与记忆库同构）；维护工具零拷贝复用记忆仓 scripts 验证通过（`MEMORY_ROOT` 指向本地知识区：体检 exit 0 健康、写门 exit 0 允许）。验收：组合矩阵 4/4、门禁抽样 3/3、typecheck 零错误；reload 信号已写（生效待宿主重启/手动注入）
- **ADR-0002 蒸馏固化唯一权迁入守藏 + 阶段 0.5 技术查证（2026-09-06）**：产品原则拍板「守藏必须安装、守藏+任意一个成员插件=自循环」——蒸馏执行权（事件 watcher+spawn LLM 子代理+路由）自记忆插件迁入 scheduler；双库定位（记忆库=泛用元记忆、pmg 卡库=项目知识库分项目/通用两板块）；白名单门禁双端（各库 config 自治、不符合不存、拒收写审计日志）；R0 动态目标路由+降级链（守藏本地三索引兜底，位于 `$DSH_HOME/suite/knowledge/`，维护工具零拷贝复用记忆仓 scripts+MEMORY_ROOT）；UI 读时拉取+蒸馏统计卡；单飞切换。阶段 0.5 查证结论：无需 daemon 形态升级（scheduler 扩 `inject=['tools','llm','subagents','agents']` + `ctx.on` 即可，官方 cordis 契约）；spawn 契约/迁移单元（≈260 行蒸馏机器）/坑位防御清单/白名单跨读候选（倾向库目录 whitelist.json）已落 ADR-0002；F-002 superseded→F-008
- **守藏迁入为独立集合中枢仓（2026-09-06）**：自 dsh-managing-memory/suite 迁入——UI（plugins/shoucang-panel，暂冻结）+ 调度执行器（plugins/shoucang-scheduler，4-Gate 降级复用为 suite 路由、G30 证据计数保留）+ scripts 合规扫描；配置模板 v2（`suite:` 成员注册表，archive:/boards:/lifecycle: 节删除）；README v4 重定义定位、HANDOVER 交接方案。已裁决事项见 `docs/map/facts.md`（蒸馏唯一权=记忆插件 watcher、旧三板块废弃、向量 UI 悬置、scnote 保留、零硬编码红线）
- **panel 记忆展示补齐审查缺口（2026-09-06）**：记忆板块补渲染 MEMORY.md 46 行知识索引（标签 tag pill 着色 env/tool/flow/lesson/release… + 主题 + notes 指针，点击直达详情小节）；蒸馏 stat 卡从「N 条记录」改为最近蒸馏时刻 + lastSeq + 会话 id，新增「待归档会话」卡（queue.undone，archive-progress 未 done 计数）；notes 小节展开加 ▸/▾ 箭头与高亮状态；画像板块补 USER/AGENT 容量卡并对齐 tag-pill 行结构。统计口径经核验与 memory-append.mjs 同源（去空白计字符，容量 89% 无误）
- **panel 记忆展示接通记忆库事实源（2026-09-06）**：`plugins/shoucang-panel` 画像板块/记忆板块重定义（F-003 落地）——不再读 root 指向的 Obsidian 仓库，改读记忆插件蒸馏 watcher 唯一事实源 `~/.dsh/skills/managing-memory/`（host 运行时探测 DSH_HOME，零硬编码）。host 新增只读端点 `/api/shoucang-panel/memory/overview`（三索引 MEMORY/USER/AGENT 解析 + 容量水位 + pending 计数/最近 + 蒸馏水位 + notes 小节索引）与 `/memory/sections`（notes 白名单按 ## 切片正文，path traversal 防护）；client「画像板块」= USER.md/AGENT.md 指针行（点击直达 notes 小节）、「记忆板块」= 记忆库仪表盘（容量进度条 / stat 卡 / pending 队列 / notes 小节浏览，只读），wiki 导航标注「旧 vault」保留兼容（deprecated）。构建墙修复：原 `.tsbuild` tsc 路径失效 → 以现成 typescript（dsh-temp-janitor node_modules）重编 host + build:client 复制，已热重载生效
- **治理重建（2026-09-06）**：部署 project-map-governance v3 治理（AGENTS/CLAUDE 入口 + docs/map 三层地图 + facts 用户事实 + ADR-0001 + pre-commit 地图门禁）；治理文档本地化（.gitignore 排除 AGENTS.md/CLAUDE.md/docs/map/）
- **scheduler 重定义 suite-manager 只读模块（2026-09-05，HANDOVER #2）**：`plugins/shoucang-scheduler` 从记忆归档调度（boards 三板块/R1-R5/W1-W3，已拍板废弃）重写为 `shoucang_suite` 装配检测工具——config 内嵌 suite 成员表（默认 memory/governance，对齐 example v2），比对注入器 registry（`$DSH_HOME/super-injector/registry.json`）+ profiles 装配清单（dependencies+bundles）双基准，输出每成员 injected/profile/both/missing 状态与 repo/role；零硬编码路径（运行时 env/home 探测）；v0.0.1→0.1.0；已注入运行（01d0ce4f）
- **shoucang_suite 工具（2026-09-05）**：只读装配检测，入参 member（过滤）/scope（all|injected|profile）
- **shoucang_verify 回归（2026-09-05，HANDOVER #5）**：G30 证据计数（claims≤evidence 只信工具实证），输出对齐记忆审计 §8 第三问（route 分流质量抽验：route/project_cards/落点），config.verify_enabled 控制
- **shoucang_migrate 工具（2026-09-05，HANDOVER #4）**：migrationHint 消费——尾读记忆插件日志（$DSH_HOME/super-injector/dsh-managing-memory.log）解析「迁移调度提示」行（近 24h 计数 + 明细），读目标项目 devref/pending 积压（≥3 张过阈值），输出 pmg devcard 派发命令（目标=参数 project 或 config default_project，运行时探测 pmg 引擎路径，零硬编码）；只读不代执行写卡（守藏只调度，写卡归 pmg）
- **panel「插件集合」视图（2026-09-05，HANDOVER #3）**：host 增 GET /api/shoucang-panel/suite（registry+profiles 双基准扫描，与 scheduler 同算法）；client VIEWS 增「插件集合」页（成员卡片：id/包名/状态/repo/role），旧「板块与管线」页标 deprecated（F-003 对齐）
- **panel client 迁移到 slot 契约（2026-09-05，解冻前置）**：client.js 注入声明加 `'slots'`，入口从直插侧栏 footArea DOM 改为注册 `sidebar.footer.action` 插槽按钮（无 slots 环境保留直插兜底）；host+client 已注入运行（ef85e372），构建产物 lib/ 重建

### Fixed
- **🔴 G-4a：跳过分支越过未消化段直接推水位到 maxSeq ⇒ 失败段此后永不重扫（2026-09-12，真根因）**——**此前对 G-4 的定性是错的**：不是"dispatch 失败后没有重试机制"，而是 `below-min`（`if (!chunks.length || totalChars < minTurnChars)`）与 `prescan-no-signal`（`if (!hasSig && candFiles.length === 0)`）两个跳过分支**无条件 `writeWatermark(sid, maxSeq, agent)`**。失败段本身确实没推水位（注释"水位保留"属实），**但会被紧随其后的跳过分支抢先把水位推平** ⇒ 该段此后再无机会（实测：50 个失败段中 **35 个被后续 run 越过**、4 个真重扫、11 个无后续；`below-min` 紧随失败段出现 **9 次**）。顺带澄清 `dispatch-failed-forced = 0` 的真因：不是"达到 3 次后走了别的分支"，而是**重试计数从未累积**——50 段每段只失败 1 次（n=1，50/50），无一达到 2 次；且 `if (!segOk) break` 段失败即停，**不存在"轮内重试"** ⇒ `MAX_DISPATCH_RETRY(3)` 从未被触发，它防的是一种实际上不会发生的场景。修复：新增模块级纯函数 `planSkipWatermark(hasUndigested, holdRounds, maxSeq)`（与 G-20 的 `planDiscardWrite` 同规格、可脱离宿主驱动），两处跳过分支改为——**有未消化段 ⇒ 扣住不推**（审计 `skipPlan=skip-held-for-undigested`）；**连续 `SKIP_HOLD_MAX=3` 轮仍无进展 ⇒ 允许推 maxSeq 并显式记账**（`skip-abandoned-after-hold`），避免长期 below-min 会话每轮重扫的死循环（否决"推到安全边界"方案：below-min 时 chunks 为空/不足门槛，本就无可寻址边界，推边界等于不推，只是把死循环换个名字）。顺带修掉次级缺陷：**段成功/强制推进时未清失败记账** ⇒ 会永久误判"存在未消化段"。**影响面（量化）**：净失败 **45 段 / 19 个会话 / 未蒸馏 seq 跨度 1,213,582**；**82%（37/45）净失败段所属会话出现过 below-min/prescan skip** ⇒ 不是统计噪声，是确定的机制缺陷。⚠ 口径提醒：seq 跨度 ≠ 消息条数（实测约 520:1），不得读作"121 万条消息"。
- **🟠 G-23：门禁把「已知未修」渲染成 ✅ pass（2026-09-12）**——`check-runner.mjs` 判读只有 `0=pass / 3=skip / 其他=fail` 三档且 `stdio:'ignore'` ⇒ 含 XFAIL 的检测件仍显示 `✅ … exit=0 pass` ⇒ 未修缺陷在 `npm test` 总入口**不可见**。修复：ADR-132 增码位 **`4 = xfail`**，运行器渲染为独立字形 `⚠` 并单独计数；**4 不计入失败**（xfail 是"已知未修"而非失败，计入等于把假绿换假红），但**必须可见**。改为**声明制**：`['scripts/test-treeops-rm.mjs', { xfail: true }]`，未声明的件退 4 ⇒ 判 fail（防止"真实失败被静默降级成 xfail"——`exit 4` 在三个运行时脚本中已被占用）。验收：声明件退 4 ⇒ ⚠ xfail、不计 failed、runner exit 0；未声明件退 4 ⇒ ❌ fail、计入 failed、runner exit 1；未声明件退 5 ⇒ 仍归 fail（确认新分支没吞掉 else）。
- **🔴 G-19：深睡 landed 判据只消费 principles 一个通道，同轮另外四通道全失败时误判「已消化」（2026-09-12）**——`deepSleepLanded` 的判据是 `app.added > 0 || app.attempted === 0`，其中 `app` 只来自 `applyPrinciples`（原则/路径通道）。深睡同轮另有 **profileOps / pointerOps / treeOps / forgetOps** 四个写入通道，其结果**从不进入判据** ⇒ 当某轮只有这四通道提案且**全数失败**时，`app.attempted === 0` ⇒ 误判 `landed:true` ⇒ 水位推进 ⇒ 那批材料永久关在窗外（**静默丢料**）。Rex 实测约占 **9.5%~14.3%** 轮次。**架构修法：判据必须消费完整轮次结果，而非其子集**（与 G-16 同源——判据只认真实完整产出）。实现：`deepSleepLanded(stop, out, app, other?)` 增第 4 参 `other: { tried, done }`（缺省 `{0,0}` ⇒ 与旧行为一致，零回归）；规则推广为**全通道**——任一通道有落地 ⇒ done；五通道皆无提案（真·空轮）⇒ done（回滚会导致同一批痕迹无限重处理，必须排除）；只要有提案而**一件都没落地** ⇒ failed（水位回滚、下轮重试，幂等）。审计行同步增 `otherTried` / `otherDone` 两字段，使判据输入可观测。**取向**：宁可重试（failed，幂等、可观测），**不可静默丢料**（landed，无声无息）。**测试**：`scripts/test-deepsleep-verdict.mjs` 由 36 条扩到 **42 条**，新增 6 条含三个对照组——纯其他通道轮全未落地 ⇒ failed（核心）、五通道皆无提案 ⇒ done（防无限重处理）、其他通道有落地 ⇒ done（防误伤），另含向后兼容（不传 `other` 与旧行为一致）与失败 gate 优先（其他通道 done=5 也判 failed）。**验收**：`npm test` exit 0（19 pass · 1 xfail · 0 skip）。
- **🟠 G-20 补正：回退 100% 由读方决定，只改写方对「整窗重蒸」无效（2026-09-12）**——上一版 G-20 只改**写方**（`maxSeq<=0` 不写水位），**对核心危害无效**。根因：`resolveWatermark` 四个作废分支**全部 `return null`**，而调用方是 `const lastSeq = baseline ? baseline.lastSeq : 0` ⇒ null 把 `lastSeq` 打成 **0** ⇒ 整窗重蒸，**与写方写了什么完全无关**。实证：`restartFrom = 114654 / 811483 / 339724` 三条健康边界值已写进水位，下一轮仍从 7~8 开始。修复（**读方为主修**）：① 新增导出纯决策表 `planDegradedBaseline(maxSeq, prevSeq)`——`maxSeq >= prevSeq`（同一/已增长的 seq 空间）⇒ 返回**降级基线** `{ lastSeq: maxSeq, degraded: true }`，即注释早就声明的**语义 A**（跳到当前 live 边界，"宁可少蒸一次，不可错位重蒸"）；`maxSeq < prevSeq`（序号空间已重排/缩小，如 prevSeq=101539 / maxSeq=511）⇒ 保持 `null` 走**语义 B** 全量（新空间通常只有几百条，便宜）。**A 是代码自己选过的语义，B 是违背声明的实现，按 A 修不需要用户拍板。** ② 闭包 `resolveWatermark` 改为薄包装转调导出的 `resolveWatermarkBaseline(...)`（闭包内 const 无 export，照 `commitPrinciples` 先例下沉，否则改回去没有任何断言变红）；两条调用点（蒸馏主路径 / 积压扫尾）同时吃到新语义。③ `discardWatermark` 改为回传 `{ maxSeq, wrote }` 供读方取 live 边界。④ 写方追加禁令：**禁止写任何比 `prevSeq` 小的值**（`planDiscardWrite` 增 `seq-space-regressed-noop` 分支）；禁写 0 与熔断 `DISCARD_SNAPSHOT_CB_N=3` 保留。**测试**：`scripts/test-watermark-guard.mjs` 由 18 条扩到 **39 条**——新增读方决策表 ⑩（A/B 分级，含"相等仍降级""无可用边界仍全量"）与读方端到端 ⑪（`unverifiable-legacy` / `format-migrated` / `fingerprint-unavailable` / `seq-space-shifted` 四分支均断言**返回降级基线而非 null**，直接对应"13 次整窗重蒸"；反向 `maxSeq=5 << prevSeq=114654` ⇒ **必须**为 null 以保语义 B；对照组双证齐全 ⇒ `degraded=false` 防误伤）。**已做反向证伪**：把 `toBaseline` 改成无条件 `return null`（还原旧行为）⇒ **30 PASS / 9 FAIL / exit 1**，9 条全在读方 ⑪ 组（⑪-e/f/g 三个对照组保持 PASS，符合预期）；还原 ⇒ **39 PASS / exit 0**。**验收**：`typecheck` / `build:host` 零错；`npm test` **exit 0**（`check-runner` **16 件全 pass / 0 skip**）。**⚠ 代价声明（不可省略）**：语义 A 下，双证失效时"不可定位的那一段增量不再回补"——这是代码注释自己承认的取舍，**不是新引入的丢料**；换来的是消除 13 次整窗重蒸 / ≈1,371,812 事件重扫与重复入册。**严重度升 🔴**（定级依据是它自身代价，不依赖"重复入册"的因果链）。
- **🟠 已安装副本（profile node_modules）漂移此前对机检完全不可见（N2，2026-09-12）：三道门全绿、修复却没在跑**——`check-deploy-sync` 比的是仓 `scripts/` 与 `skill/{scripts,engine,docs}/` ↔ **记忆库**同名路径，**不覆盖 profile 的 node_modules 安装副本**；`check-srcmap` 比的是仓内 src ↔ 仓内 lib。两者都绿时，宿主实际加载的第三份副本仍可陈旧。实测：已部署 `lib/distill.js` 停在 2026-09-11 22:41（246680 B），仓内为 09-12 01:22（251030 B，G-16 后又增至 260379 B），`commitPrinciples` / `COMMIT_FAILED_GATE` / `deepSleepReplayable` 在已部署副本中计数**均为 0** ⇒ **已修复（提交 `ce8cdae`，本地 36 条断言通过）／未部署／运行时仍在中招**，三态不许合并表述。新增 `scripts/check-installed-sync.mjs`（`--installed <path>`，缺省用 `homedir()` 探测 `~/.dsh/profiles/<profile>/node_modules/dsh-shoucang-memory`，零硬编码）：未探测到 ⇒ exit 3 诚实跳过；探测到 ⇒ `lib/` 全量 sha1 比对并输出漂移清单，**exit 0 报告态**。定位为报告工具而非 CI 红灯：部署含 push / 用户热重载等环境侧步骤，做成红灯等于把环境问题误报成代码问题（**假红灯**，与假绿灯是镜像错误）；待部署链路可自动化后一句改动即可升级为门禁。实测当场抓出 **4 件漂移**（`distill.js` / `distill.js.map` / `types/distill.d.ts` / `client.js`）。**同时把测试清单纪律执行化（N1）**：`test-deepsleep-verdict.mjs`（G-16 的 36 条断言）、`test-watermark-guard.mjs`（G-20，18 条）、`test-atomic-write.mjs`（D3 原子性，29 条，且从未 `git add`）三件此前**既不在 `check-runner.CHECKS` 也不在 `npm test`**，等于写了从未运行——纪律文本本身不产生执行力。现全部登记进 CHECKS（**16 件**），`npm test` 退化为只跑 `check-runner.mjs`（单一入口 ⇒ 不存在「登记在另一份清单里」的漏网件）；登记了但文件缺失 ⇒ 判 FAIL 而非静默跳过（已实测：16/16 FAIL、exit 1）。**验收**：`npm run check:all` **exit 0**（16 pass / 0 skip）、`npm test` **exit 0**（含 pretest build）。
- **🟠 水位作废时写下「0 行」——代码实现了自身注释明令禁止的那件事（G-20，2026-09-12）**：`src/distill.ts` 的 `discardWatermark` 上方注释白纸黑字写着「为何不是 0：写 0 的行没有可用锚点（seq 0 无事件）→ 下次读仍判「不可验证」→ **每轮全量重蒸，形成死循环**」，而 `snapshotEvents()` 抛异常时 catch 把 `maxSeq` 退化为 0，随后**照样** `writeWatermark(sid, 0, agent)`——即写下了注释禁止的「0 行」。**机理订正（撤回「写了不生效」的说法）**：不是"写了读不到"，是**写了 0**；读侧 `resolveWatermark` 为 `if (lastSeq <= 0) return null`，故**写 0 与不写在读侧完全等价**，写 0 唯一作用是污染水位文件并让审计把「无水位」误读成「从 0 续」。**实测底数**：水位文件 418 行中 `lastSeq<=0` 共 **10 条 / 10 个不同 sid / 全部 2026-09-10 / 集中在 00:54:56–00:55:55 这 60 秒内**；至 09-11 15:49（**38 小时**）零复发；单 sid（`session-5f024550`）实测失效 **2 轮**（00:54:56、00:57:42）后于 01:02:12 收敛到 `lastSeq=114654` 且双证齐全 ⇒ **撤回「每轮整窗重蒸」的措辞，实测只有 2 轮**。严重度裁 🟠（自愈 + 38h 零复发），但必须写死一句：**今天没进入死循环是运气（下一轮快照就恢复了），不是设计保证**——只要 `snapshotEvents` 连续不可用，注释预言的死循环就会真实发生。修复两层：① `maxSeq<=0` ⇒ **不写水位**，只落审计 `reason='snapshot-unavailable-noop'` 且 `restartFrom=null`（不谎报「从 0 续」）；② 同一 sid **连续 N=3 轮**快照不可用 ⇒ 本轮跳过（不再整窗重蒸烧 LLM）+ 审计 `kind='snapshot-unavailable-circuit-break'`；熔断计数在任一成功写入时复位（复位点收在 `writeWatermark` 内，覆盖全部写入点）。为可单测，`discardWatermark` 的下沉实现 `runDiscardWatermark(...)` 与纯决策表 `planDiscardOnUnavailableSnapshot(...)` / 常量 `DISCARD_SNAPSHOT_CB_N` 一并按 `commitPrinciples` 先例**导出**（闭包内 const 无 export = 改回去没有任何断言变红）。**新增 `scripts/test-watermark-guard.mjs`（18 条）并接入 `npm test`**，核心断言为「用抛异常的假 agent 驱动真实实现 ⇒ 水位落盘文件不得出现任何 `lastSeq<=0` 的行」。**已做反向证伪**：把守卫 `if (maxSeq > 0)` 改成 `if (maxSeq >= 0)` ⇒ **6 PASS / 12 FAIL / exit 1**，且落盘行实锤为 `{"sessionId":"session-aaaa","lastSeq":0,…}`（正是守卫要防的污染）；还原 ⇒ **18 PASS / exit 0**。**验收**：`typecheck` / `build:host` 零错；`npm test` **exit 0**（41 / 30 / 18 / 18 / 36 / **18** PASS + `check-hardcode` ✅ + `check-deploy-sync` 83 件 0 不一致）。
- **🟠 深睡原则落盘失败被判「已消化」（G-16，2026-09-12）：崩溃型静默丢料，比 D2 的拒收型更隐蔽**——`src/distill.ts` 深睡 `applyPrinciples` 内 `try { renameSync(tmp, target) } catch {}` 空吞异常后，仍按内存数组算出 `added>0` 返回；而 `deepSleepLanded` 判据只看 `added/attempted`（**不读 gate**）⇒ 判 `landed:true` ⇒ 审计记已消化、`lastDeepSleepAt` 推进、下轮不再重蒸 ⇒ **这批痕迹静默永久丢失**。与 D2 的差别：拒收型至少在 `rejectedLines` 留痕，崩溃型**零痕迹**——这是 D2 的覆盖缺口（只堵了拒收型）。修复三层：① 抽出并**导出** `commitPrinciples(tmp, target): {ok, err}`，失败**提前 return**（正确性押在 return 字面量上——漏改 `added` 或 `gate` 其中之一在新版里无法表达）；② 失败路径 `added/replaced` 一并归 0、`gate` 置为失败 gate、留 `log`；③ `deepSleepLanded` 增失败 gate 否认表（纵深防御——即使上游把 `added` 谎报成 >0 也判 failed）。`gate` 字面量收敛为导出常量 `COMMIT_FAILED_GATE`（产出侧与消费侧同一定义，杜绝字符串漂移导致判据静默失效）。**测试盲区同步堵上**：`applyPrinciples` 原为闭包内 `const` 无 export、单测到不了，断言只锁判据不锁生产者（改回去没有任何断言变红）⇒ 新增 **10 条**断言（producer 侧：tmp 不存在 ⇒ ok=false / 失败留 err / 失败不创建目标 / 成功 rename 后 tmp 消失；判据侧：谎报拦截 + 对照组）。**已做反向证伪**：把 `commitPrinciples` 失败分支改成 `ok:true` ⇒ **35 PASS / 1 FAIL / exit 1**；还原 ⇒ **36 PASS / exit 0**。附带：`npm test` 链末增 `check-deploy-sync`（能自动化就别靠纪律）。验收：`npm test` exit 0、`check-hardcode` ✅、`check-deploy-sync` 0 不一致。
- **可靠性审查 P0 二项落地：深睡重启丢料（D2）+ 主写入通道非原子（D3）+ 红线闸门假阳性（N2）（2026-09-11）**：
  **D2 深睡水位回放判据与进程内判据不一致（重启即丢料）**——`src/distill.ts` 重启时从 `distill-audit.jsonl` 回放 `lastDeepSleepAt`，旧判据只排除 `error` / `stop=error` / `result ∈ {no-parent, no-traces}`（即"无事可做"），**漏排"做了但被拒"**（`attempted>0 && added=0`，如 `gate=all-rejected`）。这类轮次被当作有效水位回放 ⇒ 那批痕迹**永久关在窗外**，重启一次即丢（实测 09-11 08:32 / 08:48 两轮共 4 条候选行）。修复：深睡审计行新增 `landed: deepSleepLanded(stop, out, app)`（`:2583`，与进程内判据**同一函数**，非第二份实现）；回放过滤改为「有 `landed` 以它为准，无则回落旧判据」（`:1421-1423`，保守兼容——历史 785 行绝大多数无该字段，**不回捞**，故已丢的 4 条不追回：回捞会把水位往回推，在 D1 幂等落地前只会把丢料换成重复写）。**G-1 已核伪**："热重载不重置 `lastDeepSleepAt` 会重复吸收"不成立——`lastDeepSleepAt` 是 `ctx.effect()` 内的 `let` 闭包变量（`distill.ts:351`），随 fiber dispose 一同销毁，重建后为 0；真放行深睡的是后续 `stalled ≥3h` 判定，非旧水位。
  **D3 主写入通道非原子（中断留半文件）**——`skill/scripts/memory-append.mjs:148` 原为 `await writeFile(filePath, content, 'utf8')` 直接覆盖；宿主重启 / 热重载 / 强制刷新落在「截断后、新内容未落完」之间即留半截主文档，且备份虽在但**无任何自动回滚**。修复：改同目录 tmp 写 + `rename` 原子替换（同文件系统内 rename 原子，观察者只见旧全文或新全文）；失败 `unlink(tmp)` + **exit 5**（新退出码，调用方 `distill.ts:870` 只判 `status === 0`，非零一律计 failed，兼容）；**原文件始终未被触碰**。备份目录顺带治理：原为分钟级永不清理（实测 98 个目录 = 98 份主文档全量副本），改保留最近 `SHOUCANG_BACKUP_KEEP`（缺省 30，置 0 = 不裁剪、保持旧行为）。**实证**：临时库写入 exit 0 / 无 tmp 残留；造 5 个历史备份目录 + `KEEP=2` ⇒ 剩 2 个且为时间戳最大者（本次新写的必留）；`KEEP=0` ⇒ 一个不删。`lib/` 已同步至库内副本，`check-deploy-sync` 81 件一致。
  **N2 红线闸门假阳性（根因级）**——`scripts/check-hardcode.mjs` 的 `SKIP_DIRS` 未排除 `.workbuddy-ai/`（`.gitignore:35` 已忽略、永不入库的运行时暂存区），面板探针把 `root` 路径写入该区即被判红线违规。此前的处置是删掉探针文件，**属掩盖而非修复**——假阳性会训练人忽视红灯，比漏报更危险。修复：`SKIP_DIRS` 增补 `.workbuddy-ai` / `.workbuddy`（收窄的是"扫哪里"，未削弱"判什么"）。**已做反向证伪**：注入真实违规 ⇒ exit 1 并点名文件；清理后 ⇒ exit 0。
  **附带订正（不改行为）**：`memory-append.mjs` 的插入点注释与实现不符——文件头称「在该小节末插入条目」，`secEnd` 扫描判据 `lv <= lastHead.level` 对非标题行（`headingAt` 返回 0）恒真，故扁平小节（正文直挂 `##`）实际插在**正文首行前**，呈「最新在上」倒序（真库 `notes/flows.md §深睡蒸馏` 已验证：今日条目在最前）。**仅订正注释**，不改逻辑——翻转会改变全库既有顺序，风险与收益不对等。
- **🔴 修复本次修复自身引入的回归：相关性通道被空集合短路，gated 载体有无查询都取不到（2026-09-11 上机前代码审查拦截）**：`src/panel.ts:340` 的按需通道守卫为 `if (q && relOn && allMem.length)`，其中 `allMem.length` 是「MEMORY.md 不存在/全空则不必走召回」的早退守卫，**写于 `allMem` 尚未分层过滤的年代**。缺陷1 修复后 `allMem` 只剩 P/always 行，而真实库 MEMORY.md 的 48 条索引行**全是 E 层 gated**（env/flow/tool）⇒ `allMem` 恒为空 ⇒ 守卫恒假 ⇒ **相关性通道（契约指定的 gated 唯一渲染器）永不执行**，gated 载体从「无差别铺开」直接翻到「永远取不到」——正是 A6 断言要拦的过度过滤。**A6 为何没拦住（假绿根因）**：A6 夹具的 MEMORY.md 混有 P 层行 ⇒ `allMem` 非空 ⇒ 守卫通过 ⇒ 断言通过，而真库形状（全 gated）从未被覆盖。**修复**：去掉 `&& allMem.length`（`recallIndex` 对空库自然返回空 rows，下方 `if (picked.length)` 兜底，语义不变）；并更正 `panel.ts:1587` 同失效注释（原写「取不到即空串 ⇒ 回退位置式，不影响可用性」——位置式池本身就是过滤后的 `allMem`，真库下**回退=回退到空**，已非安全网）。**新增护栏 A7（真库形状夹具：MEMORY.md 全 gated）+ 三断言**（A7-1 无查询恒定面 0 条 gated / A7-2 有查询 gated 仍能经相关性通道现身 / A7-3 回补行受档位 cap 约束）。**已做反向证伪**：把守卫改回 `&& allMem.length` ⇒ **A7-2/A7-3 变红，而 A6 仍绿**（复现 A6 假绿）；还原 ⇒ 20 PASS / 0 FAIL。**未上机即拦下**——此缺陷若上机，表现为「知识索引段整体消失且 gated 永不召回」，易被误判为「修复生效」。
- **SSOT 残留修正（同源）**：`src/scheduler.ts:208` 的 `mclFamiliarThreshold` schema 缺省原指向 `SURFACE.threshold.tOn`（**ACT-024 校准的另一套语义，仍为 0.65**），与 MCL 熟悉度阈值同名不同义 ⇒ 该文件兜底分支恒被跳过（死代码）；一旦 `~/.dsh/suite/scheduler.json` 的持久键缺失（换机/新装/清配置），阈值会**静默回到 0.65**（高于实测上限 0.634 ⇒ 快通道永不触发）。缺省改为读注册表同一字段 `SURFACE.mcl.familiarThreshold`。
- **`check-deploy-sync` 覆盖缺口二次修复：判据面漂移对机检完全不可见（2026-09-11 上机前实测发现）**：`skill/engine/` 是**判据唯一事实源**（`criteria.json` + 生成投影 `criteria-gate.json` / `criteria.md`），它同样有一份部署镜像在库根 `~/.dsh/skills/managing-memory/engine/`，但机检此前只比对 `scripts/` 与 `skill/scripts/*.mjs`（2026-09-11 早些时候刚补上后者），**完全不覆盖 `engine/` 与 `docs/`**。后果在本次上机时实测发生：库侧 `engine/criteria.json` 仍停在 `familiarThreshold: 0.65` 且 `mclGate` **0 处**，仓侧已是 `0.58` + `mclGate` 2 处（`原则`/`路径`），而 `check-deploy-sync` **全绿**——判据面漂移会让库内自检/定时跑着**旧判据却"跑成功了"**，与本次专项打击的「假绿」同源。修复：机检扩展为四个比对面（`scripts/` · `skill/scripts/` · `skill/engine/` · `skill/docs/`，递归且跳过 `.bak-*`），检查面 24 → **81 件**；`engine/` 与 `docs/` 纳入后当场抓出 4 件漂移（`criteria.json` / `criteria-gate.json` / `criteria.md` / `docs/archive-detection-design.md`，均为本次会话改动），备份后同步仓→库，复核 **67/67 全一致**。**已做反向证伪**：把库侧阈值改回 `0.65` ⇒ 门变红 exit=1 并点名文件；还原 ⇒ exit=0。剩余 16 件「库内缺失」为仓内开发脚本（机检/生成/单测，本就不部署），属诚实标注而非错误。**验收**：`node scripts/check-deploy-sync.mjs` exit=0（81 件 / 0 不一致）。
- **注入/召回链三缺陷修复（2026-09-11 工程保障团队专项 · 缺陷1/2/3 全量推进）**：
  **🔴 缺陷1 · 恒定注入面不执行层过滤（gated 载体 76.1% 泄漏）**——契约 `criteria.json#carriers.note` 明言「P 层 always（恒常、不参与相关性竞争）；R/E 层 gated（按任务型/相关性调用）」，但恒定注入面 `src/panel.ts:288` 的索引分支只用 `/^\[.+\]/` 通配选取，**从不读 layer**；唯一的过滤分支（`alwaysProfileTags`）只覆盖 `profile` 形式行，**完全不覆盖 index 形式**。真库实测：恒定面 67 条索引行中 always 16 / gated **51（76.1%）**——`MEMORY.md` 48 条索引行里 always **0** 条（env19/flow8/tool7/lesson14 全为 E 层），R/E 每轮无差别铺进恒定预算，「gated」对 index 载体形同虚设。**修复（三入口收敛为单一实现）**：① `targets.ts` 新增 `indexCarrierSet()` / `profileCarrierSet()` / `indexRowInLayer()` / `indexRowTag()` / `scanIndexRows()`，**标签→层映射只认注册表**（CARRIERS），代码内不再出现任何标签白名单正则；② `panel.ts` **位置式基线 + 新鲜度槽**（恒定铺开的那一段）改 `indexRowInLayer(l,'always')`；**相关性通道保持不限层**——它本身就是契约指定的 gated 渲染器（`panel.ts:276-278`「`gated:index` 由 recallIndex/recallRanked 按任务型/相关性选择」），R/E 行可**按需**出现且受档位 cap 约束（第一版曾把相关性通道也锁成 always-only，属**过度过滤**：会让 gated 载体永远无法在注入面现身，已由新增断言 A6 护栏拦住）；③ `vec.ts` 内与 `recallIndex` **重复的逐行扫描副本删除**（改用 `scanIndexRows`）——两副本并存是过滤口径漂移的温床；④ `mcl.ts` 的 `hasHighConf` 原为硬编码正则 `/^\[(路径|原则)\]/`（与注册表 `路径` note「复用 ACT-029 MCL 快通道熟悉度分流」是同一事实的两份副本），改由注册表新字段 `mclGate: true` 驱动（`highConfCarrierSet()`，语义不变）。**A5/A6 双向护栏**（防「过滤不足」与「过度过滤」两个极端）：A5 证 gated 行**召回得到**（`recallIndex` 缺省不限层，真库实测 45/48=93.8% gated 行可复现召回）；A6 证 gated 行**在注入面现身得到**（有查询时按相关性进入知识索引，且受 cap 约束）——只留 A2 会漏掉「过度过滤」这个反向退化。**真库实测**：67 条索引行 = always 16 / gated **51（76.1%）**；`MEMORY.md` 48 条索引行 always **0** 条 ⇒ 修复后**无查询**时「知识索引（MEMORY.md）」段不再恒定铺开（banner low −8.3% / medium −13.5% / high −23.8% / **smart −27.9%**），**有查询**时按相关性回补 2~4 行（banner 1888~2068，仍小于修复前 2408，且由「最旧 N 条」变为「最相关 N 条」）。**验收**：`scripts/test-carrier-layers.mjs` 由「缺陷固化 4 PASS/5 FAIL」翻转为**回归护栏 17 PASS / 0 FAIL**（gated 泄漏 0/4）。
  **🟠 缺陷3 · 合规判定只认逐字复现（159/159 恒 false，5 次再引导零生效）**——`judge()` 判据为 `text.includes(t.slice(0,6))`，要求模型**逐字复现主题词前 6 字**，一旦转述/省字即判未引用。真库审计 159 条带 `compliant` 样本**全部 false**、5 次 nudge 全部零效果。**修复**：改**三信号「或」**——① 主题词全串命中 ② 主题词前缀（旧口径保留）③ **信号词元覆盖率**（`rowSignals()` 从主题词 ∪ §小节名 ∪ 指针文件名抽取 ASCII 整词 + 中文二字滑窗，任一行命中 ≥2 个词元且覆盖率 ≥60% 即判引用）。保留密度下限的意义：不把「提了一句相关词」也算合规，仍要求足够密度而非任意单字命中。
  **🟠 机检假绿（根因级）**——`check-carriers.mjs` 原 ①~⑤ **全是声明侧校验**（只验注册表自身自洽：P⇒always、R/E⇒gated），**从不校验运行时是否真的按 layer 过滤** ⇒ 缺陷1 存续期间该门**全绿**。另 ④ 的「panel 消费 CARRIERS」断言可被**注释里的四个字母**满足。修复：④ 改为断言 `targets.ts` 真的 `import { CARRIERS }`（层判据的单一实现）；**新增 ⑥层执行**四道断言（恒定面调 `indexRowInLayer(l,'always')` · 判据单一实现在 targets · vec 无第二份扫描副本 · src 代码无标签硬编码正则），且**先剥注释再匹配**（第一版曾把「注释里引用旧写法」误报，与 ④ 假绿同源）。**已做可证伪验证**：把 panel 改回缺陷态 ⇒ ⑥-1 变红；把 mcl 改回硬编码 ⇒ ⑥-4 变红。
  **🟠 测试链构建缺口**——`npm test` 无 `pretest`，而 `test-layering` 等 6 支脚本**全部 import `lib/` 编译产物** ⇒ 改了 `src/` 不 rebuild 时测的**是陈旧产物**（症状：源码已修、测试仍红/仍绿都不可信）。修复：`package.json` 加 `"pretest": "npm run build:host"`。**同时收敛两份零重叠的测试清单**：`check-runner.CHECKS`（6 件）与 `npm test` 的 && 链此前**互不重叠**，新增测试件无处登记；现纪律为「行为级测试件一律进 CHECKS」，`test-carrier-layers.mjs` 已入 CHECKS（7 件全 pass），`check-carriers` 不再在 npm test 里重复跑。**验收**：`typecheck` / `build` 零错；`npm test` exit=0；`check-carriers` ⑥ 全过。
- **深睡「静默丢料」根因修复：水位与落地解耦（2026-09-11 睡眠链路专项检索发现）**：`runDeepSleep` 的最终判据（`src/distill.ts:2607`）此前**只按 `stop === 'completed' && out`** 判 `done`，从不检查候选是否真正落地。当代理跑完（stop=completed）但 `applyPrinciples` 的门禁把候选行**全数拒收**（`gate` 为 `all-rejected` / `maturation-rejected` / 尾部总门失败，`attempted>0 && added===0`）时仍返回 `'done'` → 调用方（`:2768-2773`，仅 `failed` 回滚）**推进 `lastDeepSleepAt` 水位** → 被拒痕迹**永久划出窗口、静默丢失**。**审计实证 2 轮**：`2026-09-11T08:32:23.997Z`（attempted=3 / added=0 / all-rejected）与 `08:48:10.129Z`（attempted=1 / added=0 / all-rejected），两轮均 `stop=completed` ⇒ 均判 `done` 并滑窗，**丢弃 4 条候选行**（全为 `[gate:行格式违规]`，逐条核验 31/38/36 字确有超 30 上限——**门未误判，坏的是产出与水位语义**）。**修复（单点判据 + 显式排除）**：① 新增落地判据 `landed = app.added > 0 || app.attempted === 0` —— `added>0` 判 done；`attempted===0`（代理本就无新原则/路径提案，如纯 `profileOps`/`pointerOps`/`treeOps`/`forgetOps` 轮或真·空轮）**必须仍判 done**，否则回滚会致同批痕迹**无限重处理**；`attempted>0 && added===0`（100% 拒收=材料损失）判 `failed` 使水位回滚、同批下轮重试。该谓词**不枚举 gate 文案**，天然覆盖 `:1612` / `:1621` / `:1633` / `:1641` 全部零落地出口。② 追加排他 `gateMissing = app.gate === 'write_gate 未就位'`（`applyPrinciples` 早返回 `:1538`，其 `attempted` 恰为 0 会被 `landed` 误判 done）——**门禁脚本缺席属基础设施失败，不得计为已消化**，强制 `failed` 重试（历史审计 0 行该路径，属潜在边角，但同族静默丢料面）。**未改**：`applyPrinciples` 本体、水位逻辑（`:2768-2777`）、`no-traces` 早返回（`:2301` 仍为 done 语义）。**验收**：`typecheck` / `build` 零错；四套单测 **90 PASS / 0 FAIL**（24+30+18+18，无回归）；`check-criteria` / `check-carriers` / `check-hardcode` / `check-changelog` / `check-deploy-sync` **5 闸全过**；`lib/distill.js` **构建可复现**（重跑 build sha1 不变，提交产物与源码一致）。commits `64fa33a` + `c9d67f5`。**残留（已记，待拍板）**：① 全拒收时水位不再推进 ⇒ 若某痕迹被门禁**持续 100% 拒收**（如指针悬空 `gateExit=2`）会每轮重处理同批痕迹（**有意取舍：宁可重试不可静默丢**，拒因已进审计，建议观测 `all-rejected` 频次）；② ~~四套单测未直接覆盖 `runDeepSleep` 判据分支~~ **已补（同日）**——判据抽为模块级导出纯函数 `deepSleepLanded(stop, out, app)`（单一实现，调用点与单测共用防漂移）+ 新增 `scripts/test-deepsleep-verdict.mjs`（驱动编译产物，**15 PASS / 0 FAIL**，覆盖正常消化 / 全拒收 ⇒ failed / `attempted===0` 纯 ops 轮 ⇒ done / `stop≠completed` 与 `out` 假值 ⇒ failed / `write_gate 未就位` ⇒ failed / 部分接受 ⇒ done），接入 `npm test`；③ `memory_write_gate.mjs:101-108` 投影缺失时**静默回退内建 30/40**（双源漂移风险，建议加告警）。**测试总账**：`npm test` = 四套既有 **90 PASS / 0 FAIL** + 新判据 **15 PASS / 0 FAIL**，入口 exit=0。
- **蒸馏链复检：修 1 处索引悬空指针 + 2 处台账文档口径（2026-09-11 复检发现）**：① **`MEMORY.md:47` 悬空指针（🔴 结构完整性）**——`[tool] 专家市场安装 … → notes/tools.md §专家市场`，但 `notes/tools.md` **全文 8 个 `##` 章节从无 `专家市场`**（该内容实在 `notes/env.md §WorkBuddy 与多 Agent`）。溯源：蒸馏 `6ba51f20` **一次产出两行**（L149 `专家市场安装` + L150 `WorkBuddy 专家安装`，同一事实），内容只写进 `env.md` 一份，却**登记了两个指针** ⇒ 一条永久悬空、该主题**检索期不可达**。修：按 INDEX 既有的「索引合并」惯例，把 L47 指针**改指真实落点** `notes/env.md §WorkBuddy 与多 Agent`。**实测**：全库 47 条指针行，修复前 **1 条不可解析**，修复后 **47/47 全解析**（脚本逐行核对 `notes/<file>.md §小节` 对章节头）。② **台账文档口径 2 行（🟡）**——`skill/engine/distill-contract.md:115` 与 `skill/memory-whitelist-spec.md:349` 仍把 `judgement-ledger.jsonl` 写成**正名**，而 L10/L21 与写入端早已统一为 `audit/ledger.jsonl`。修：两处改为正名 + 标注旧名仅作只读兼容；**`criteria.json:578` 的 `legacyLedger` 登记别名有意保留**（`judgement.ledger` 正名 + `legacyLedger` 兼容并存，是有意设计非遗漏），`recall-eval.mjs:106` 的 `judgement-ledger` 是自指词表关键词，同样保留。**仓 ↔ 生产库双份同步**（两份曾为镜像，修后 sha1 仍一致：`distill-contract.md` `71bdcb6c70` / `memory-whitelist-spec.md` `3e3b74293e`）。**验收**：`check-criteria` / `check-carriers` / `check-hardcode` 三闸 exit=0；`typecheck` 零错；**未改任何代码、未动 registry**。
- **转录命名版本漂移致 workspace 反解全量断链（F-1 · 2026-09-11 修复）**：DSH 自 **2026-09-10 13:49** 起会话转录由 `session.jsonl.zstd` 改名为 **`session.v3.jsonl.zstd`**（带版本段），而定位白名单写死 `['session.jsonl.zstd','session.jsonl']`——`session.v3.jsonl.zstd` **不含子串 `session.jsonl`** ⇒ `archive-lib.locateTranscript` 恒 null ⇒ `resolveWorkspace` 三种退避重试全失败 ⇒ **项目路由卡 100% 降级 pending-defer 且永久无法回流**（连带归档链 `archive-timer` 同源失效），并每轮扫尾空转（4 卡 × 3 次探针 × 每 10 min，日志 352 行）。**证据**：磁盘 346 转录 = 175 旧名 + **171 新名**（今日 136/136 全为新名）；`locate-transcript-probe` 对卡源会话 **exit=1「转录未找到」**而文件实在（7.25 MB）；日志 `ws 反解: 转录定位失败 attempt=1..3` × 4 卡/轮。**修复（根部解决 · 单一实现）**：① `skill/scripts/archive-lib.mjs` 新增 **`TRANSCRIPT_NAME_RE = /^session(?:\.v\d+)?\.jsonl(?:\.zstd)?$/` + `pickTranscriptIn(dir)`**（列目录 + 版本无关正则，`.zstd` 优先、版本高者优先），`locateTranscript` 与 `enumerateSessions` 两处枚举旧名的循环改调它（未来 v4/v5 命名无需再改）；② **双闸之第二闸**：`src/distill.ts` 的 `find(l => l.includes('session.jsonl'))` 同族判据改同正则（探针已成功仍被二次判 null 的第二处失效）；③ 第三处硬编码：`skill/scripts/candidate_grep.mjs` 的 `join(wsDir,sid,'session.jsonl.zstd')` 改调 `lib.pickTranscriptIn`；④ **测试盲区机械化封堵**：`skill/scripts/test.mjs` 新增用例「转录命名版本兼容」（旧名 + 新版名各一例，断言 **定位与枚举两条路径**均可命中）——此前 8 处夹具全造旧名，测试**结构性看不见**此漂移。**实测（非接口成功）**：`locate-transcript-probe` 真库 **exit=1 → exit=0** 并输出 `…\session.v3.jsonl.zstd`；热重载后手动触发 pending 回流，**A/B 对照同一批卡 22 分钟内两种结果**——修复前 18:23 那轮 `写入 0 / 保留 4`，修复后 18:25 `写入 4 / 保留 0`，4 卡实际落盘 `docs/devref/shoucang/`（`# [项目事实]` 格式、工作区 `D:\FF\shoucang`）+ 移入 `.processed` + 审计 `defer-flush` 7→11 行；**空转归零**（18:25:40 后 33 行日志中反解失败/保留 = 0）。**验收**：`typecheck`/`build` 零错；`npm test` **exit=0**（含新用例 41 PASS / 0 FAIL）；`check-deploy-sync` 一致 24 / 不一致 **0**；`lib/distill.js` 仓↔安装副本 SHA256 MATCH；库 git 快照 `512f2e6`。**残留（待拍板）**：F-2 永久不可解卡的退避/上限/审计（本次已随 F-1 消除具体来源，机制层建议仍加）、F-5 候选区 `runtime-context` 样板未入 `CANDIDATE_NOISE`、F-4 声明重钉与推送。
- **产出物质量核验 + 新增笔记结构体检（2026-09-11）**：过门 ≠ 有用，故对深睡新产出做**质量核验**：`AGENT.md` 新行的指针目标 `notes/env.md §插件注入` **确实存在**（7205 字符 / 61 行）且含完整六步与注意项 ⇒ **精简概况未造成信息损失**（细节落 notes，符合设计）。**新增审查 F11（内容组织债，不自动改）**：笔记小节层级失真 + 主题重复——`notes/env.md` 的 `## DSH 环境` 下挂 **10 个 `###`**（`记忆库与内核概览`/`检索链路与桥` 显然不属于"环境"），且 `### Windows npm 执行策略` **同时**以独立 `##` 章节存在；`notes/lessons.md` 两章各挂 8 个 `###`；`notes/flows.md` 一章挂 7 个。**处置**：笔记是**私人记忆数据**（守「数据先问」）⇒ **不擅自重排**，改为在 `memory-reconcile` 新增 **⑥ 笔记结构体检**（章节下 `###` 计数 + 同名主题既 `###` 又 `##` 检出，**只报告不修改**），实测报 **8 文件 / 37 章节 / 39 子节 · 4 处收纳筐 + 1 处主题重复**。**同时**：体检扫描失败**显式可见**（`notesHealth.scanError`）——实测踩到 `readdirSync` 未导入被裸 `catch` 吞成"0 文件 = 健康"，与写门 `proj` 未遂事故**同族**（**静默兜底会伪造健康**），已改为不静默。**新增护栏** `scripts/check-changelog.mjs`（接入 `check-runner` → `npm test`）：硬门检「孤立行（标题被吃）/ 条目标题未闭合 / 小节重复 / 非标准小节」，双向自测通过（注入孤立行 → exit=1 并给出行号与修法提示；还原 → ✅）——**本会话我两次犯同一失误（前置新条目时吃掉上一条标题），故机械化**。
- **修复效果实测通过：真实深睡三轮对比 `added 0 → 1`（2026-09-11）**：手动触发真实深睡三轮（每轮 `HTTP 200 result=done`，约 10s）并**逐轮定位**：① 08:32 修复前 `attempted=3 added=0 gate=all-rejected`（概况 31/38/36 字超 30 字硬门）→ ② 08:48 仅注入**字数**约束后仍 `added=0 gateExit=4`，拒因变为 **`[路径]` 步骤内嵌 `→` 与指针箭头歧义**（我漏派生了 `forbidArrowInPath`）→ ③ **08:50 改为「逐参数派生」**（`forbidArrowInPath`/`requireMiddleDot`/`requirePointer`/`banDate`/字数 全覆盖）后 **`attempted=1 added=1 gate=pass gateExit=0`** ✅。**落盘核验（非接口成功）**：`AGENT.md` 实际含新行 `[路径] 插件运行时注入 · 前提装注入器 ①…⑤ → notes/env.md §插件注入`（18 行/1053 字符）；台账 `write.consolidate` 最新 `verdict=written written=1 reason=pass`；**库 git 自动快照** `839b281 memory: deep-sleep @ 08:50:59`；对账「**上次有效深睡**」由 2026-09-09 更新为 **08:50:59**、**连续空转 0 轮**、R 层 +1；**下一轮注入面已可见该行** ⇒ 闭环（prompt 约束 → 合规产出 → 过门 → 落盘 → 注入可见）完整。**同时**：④ 对账「闭合」改**自举基线**（首次落 `audit/row-baseline.json`，历史行显式豁免，只判"基线之后"的未解释差异）——原口径下台账窗口覆盖不到 M2 前历史 ⇒ 差异恒在、**报警疲劳**；现 **✅ 未解释差异 0**。⑤ 两处**测试侧假阳性**已更正并留痕：`mcl.topK` 端点未暴露（实查 `scheduler.ts:646` 早已消费 ⇒ 补端点字段）、库 git "dubious ownership"（实查 `bank-git.mjs:22/24` **本就带 `-c safe.directory`** ⇒ 一直正常，是我核验时用裸 `git -C`）。⑥ **审查结论据实测分级**：F3-②（自检拖深睡尾）由 🟡中 **降为 🟢低**——实测 6 项检测仅 **0.9 秒**。⑦ 部署护栏当日第二次生效：抓到 `memory-reconcile.mjs` 改后未同步并修复。
- **实测轮抓到并修复「深睡长期零产出」的真因（2026-09-11）**：现场证据=最近一轮深睡 `attempted=3 · added=0 · gate=all-rejected`，三条被拒原文全是高质量原则，原因均为 `[gate:行格式违规]`；复现报错 `概况超30字(31)/(38)/(36)` → **exit=4 硬拦截**，边界实测 **30 字过门 / 31 字拒收**。**根因=格式判据"四环三断"**：注册表有 `ingest.format.index-line.params`（summaryMax 30/pathSummaryMax 40/topicMax 12）、投影 `criteria-gate.json.format` 也携带，**但写门硬编码 `isPath?40:30` 从不读投影，且 prompt 判据段里"30"出现 0 次（模型根本不知道有上限）**。**修复**：① 写门改为**读投影**（`FMT_LIMITS`，由 `import.meta.url` 自足定位 + 内建缺省回落）；② 生成器把格式硬约束**从注册表派生**并注入**两个判据段**（摄取域 + 巩固域），含"若压不进上限就把细节写 notes、索引行只留短概况"的明确指示；③ 注册表该判据补实测根因 note。**端到端证明**：仅把**投影**改为 `summaryMax=28`（注册表仍 30）→ **29 字被拒、28 字过门** ⇒ 门确实读投影；还原后 30 过 / 31 拒 ✓。**同时修复**：④ 深睡审计行漏 `gateExit`（补上）；⑤ **未遂事故**——写门引用 `proj` 而它定义在更窄的块内 ⇒ 模块加载 `ReferenceError` 被调度器读成 **exit=1（容量超限）**，若不测则**下一次真实深睡写入会全部假失败且报错方向完全误导**，改为自足解析；⑥ `check-deploy-sync` 覆盖缺口——此前只比对 `scripts/` ↔ 库，**漏 `skill/scripts/`**（`memory_write_gate.mjs` 漏同步正因此暴露），扩展后立刻抓到 2 件漂移，现 0 不一致；⑦ `/mcl/status` 补 `topK` 字段（此前未暴露导致自测**假阳性**误判"`surface.mcl.topK` 未生效"，实查 `scheduler.ts` 早已消费）。**实测健康面**：统一台账 16 行五类事件齐备；**睡眠自检三触发全部实战发生过**（`check.sleep` 的 trigger = `timer 3 · manual 2 · deep-sleep 1`）；`/selfcheck`=ok 六项全 pass；部署镜像 8/8 sha 一致；**注册表↔运行时 7/7 一致**。**验收**：`typecheck`/`build` 零错；`npm test` = 5 pass/0 skip + 40+30+18+18 + check-hardcode ✅。
- **全模块链条审查 · 一批修复（2026-09-11，A/B/C 三级 15 项）**：按「逐模块功能链条核查」结果修复。**A 级（会静默丢知识，真缺陷）**：① **水位前移吞条目** —— 蒸馏段成功判据加 `disp.failed === 0`（`src/distill.ts` 成功分支），条目级落盘失败时**水位保留、下轮续传**；为防永久失败卡死水位，同段连续失败满 `MAX_DISPATCH_RETRY=3` 次后**强制推进 + 审计 `fclass=dispatch-failed-forced`**（丢失显式记账，不再无声）。② **project-defer 卡被主路径重裁决** —— `distillAgent` 入口先 `flushDeferCards()`（按卡内「源会话」反解 workspace 回流），候选池排除 `-project-defer-`（原先会被喂 LLM 重裁决 → 落错工作区 / 随后被 `.processed` 吞掉）。③ **claim 锁单侧** —— `tryClaim/claimHeld/releaseClaim` 统一到蒸馏入口（在途 25min 让位、结束/早退释放），扫尾改**只读**让位判定（原先只有扫尾写 claim，idle 路径不查 ⇒「跨实例防双蒸」不成立）。**B 级（空转 / 断链）**：④ **新库引导链断** —— `panel.bootstrapDefaults` 不再解压 pmg 时代 wiki vault，改为幂等生成**单库骨架**（三索引 + 七类 notes + INDEX + `whitelist.json` + 随包 `scripts/engine/规则档`，与 `memoryRootOf()`/`targets.memoryLibRoot()` 读链对齐）；同步退役 `default-project.json`、`default-vault-template.tar.gz`、`scripts/gen-default-project.mjs` 及 package.json 的 `build:default`/exports/files 条目。⑤ **白名单链空转** —— 库根写入 `whitelist.json`（新增 `skill/whitelist.json` 模板并同步生产库），`shoucang_targets_probe` 现报 `白名单来源=file`；`suite/knowledge/whitelist.json`（非库目录、零读取的孤儿）改名留痕。⑥ **`shoucang_suite` 恒空** —— members 缺省回落**自检本插件**（`SELF_MEMBER` + `memberSpecsOf`），工具 / `/suite` / `assistant_capabilities` 三处不再恒「无成员」。⑦ **`prescanMinChars` 无配置通道** —— 补 `scheduler.ts` interface + zod 键 + `registerDistill` 透传（此前声明了却恒回落 4000）。⑧ **契约漂移** —— `skill/engine/distill-contract.md` 按现码重写为 **v6**（R1/R2=memory、R3=project、R4=discard；删 `board`/`migrationHint`/`devref-card` 死声明；补分段水位 + 深睡通道表），`engine/README.md` 同步；**退役 `skill/engine/knowledge-append.mjs`**（运行时零调用，生产库副本移入备份区）。⑨ **无回归聚合入口** —— package.json 新增 `npm test`（`test.mjs` + `test-forgetops.mjs` + `test-treeops-split.mjs` + `check-hardcode.mjs`）。⑩ **评测器窗口不可复现** —— `recall-eval.mjs` 增 `--since`（绝对日期 / 12h / 3d / 2w）与 `--sids` 固定采样窗口，JSON 与文本均回显窗口并警示「未固定窗口不可跨次对比」。⑪ **§ 抑制双实现** —— 键与算法收敛为 `targets.sectionKeyOf` / `dedupeBySection` **单一实现**（`vec.ts` 删本地副本；归一化统一「去行尾日期括号」），消除词法/融合两路去重分叉的潜伏缺陷。**C 级（死代码 / 文档漂移 / 阻塞）**：⑫ 删 `extractDelta`（实证零调用，原注释「勿删」与实况不符）、`DistillChunks.truncatedTail`（恒 false 无消费方）、未用 import `recallIndex`/`memorySkillPresent`；`panel.ts` 头注释与启动日志按实际 **28 条路由**重写（原挂着 `/idle/status|consolidate`、`/model/*`、`/vector/status|build` 等已不存在的幽灵端点）。⑬ 面板写门 `gateWrite` 由 `execFileSync` 改**异步 `execFile`**（原先慢门禁会阻塞宿主事件循环最长 30s）。⑭ 扫尾覆盖注释按现码更正（只覆盖 live roots，不再声称「重启前已结束的一律补」）。⑮ `globalChildSeen` 全局冻结加 60s 节流日志（可观测）。**库侧卫生**：生产库根三份旧副本（`memory_write_gate.mjs`/`distill-contract.md`/`target-registry.json`）与 2 个测试 tmpdir 残留移入 `audit/backup-20260911-hygiene/`。**验收**：`typecheck` 零错、`build` 零错、`npm test` **88 项全绿**（40 + 30 + 18）+ `check-hardcode` ✅、`lib` 与生效包 sha MATCH、热重载 active。
- **认知对照落地后的 6 项审查缺陷修复（2026-09-11，自查）**：**R1【高】画像节误伤面**——`forgetOps` 的守卫②（须 cold）**挡不住机制性冷节**：画像行是**全量注入**（每轮都在上下文，agent 无需 read）⇒ 永不产生 access 命中 ⇒ 恒为 cold，且按「距最后命中」降序时 `never` 排最前。**真库实测：cold 9 条中 6 条是 `user.md` 画像节（`§身份/§硬件/§偏好-复刻类/§偏好-开源免费/§习惯-中文短指令/§习惯-记忆质量审查`）且排最前** ⇒ 首次深睡即可能归档掉用户画像。修：`treeops.ts` 新增**守卫④ `PROFILE_FILES`（user.md/agent.md 一律禁 archive）** + `distill.ts` 材料侧同步剔除。**R2【中】悬空候选占名额**——`activity.jsonl` 的 `(f,s)` 源自索引行解析，历史悬空指针会留痕（真库 9 条里 3 条指向不存在的节），白占材料 top-10；修：导出 **`sectionExists()`**（口径与 `matchSection` 同源，不另立一套）供材料侧过滤。**R3【中】`enableRemPass` 只能靠 env**——补 `scheduler.ts` 的 `interface Config` 字段 + zod 条目（`default(false)`）+ `registerDistill` 映射。**R4【低】无单轮归档上限**——加 `MAX_ARCHIVE_PER_RUN = 3`（keep 不受限）。**R5【低】** `hotCtx` 材料切片 `.slice(1,20)` 会把 `|---|` 分隔行带进材料 → 改 `.slice(2,20)`（与新加 `interCtx` 口径一致）。**R6【低】降权未覆盖回退路径**——`panel.ts` 的冷热感知原在 `if (q && relOn)` 分支内，`injectRelevance=false` 或空 query 走位置式回退时**完全不感知冷热**（"贯穿三通道"实际只剩两通道）；修：`actMap`/`rowWeight` **上提到分支外**，回退基线改为「冷行稳定后置、组内原序不变」（仍属位置式）。**验收**：`scripts/test-forgetops.mjs` 扩到 **30 PASS / 0 FAIL**（新增 ⑨画像节拒归档 ×3 / ⑩单轮上限 ×4 / ⑪`sectionExists` ×4）；**真库实证：修复后 cold 9 条 → R1 滤 6 + R2 滤 3 → 真候选 0 条**（当前无可遗忘对象，误伤面 100% 被挡）。`typecheck`+`build` 零错、`check-hardcode` 通过、`lib` 6 项 sha MATCH、热重载 active。
- **蒸馏 profiles 双画像通道「契约↔写门」用词不一致（2026-09-10 ACT-020，架构体检发现 → 当日修复 → 重建 lib）**：宿主契约 `DEFAULT_DISTILL_PROMPT` 教模型输出 `"target":"USER|AGENT"`（裸名，判定句亦写 `target=USER`/`target=AGENT`），而写门 `writeProfileLine` 第一条判据是 `if (target !== 'USER.md' && target !== 'AGENT.md') return 'rejected'`（只认文件名）→ **该通道自 v15（09-08）上线以来每一次写入都必然被拒**。审计实锤：`kind=gate-reject` 按 target 计 `USER` **16** 条 / `AGENT` **13** 条（最近 `12:01:53Z` USER、`12:31:25Z` AGENT×2）；画像文件事实：`AGENT.md` 停在 09-09 23:57、`USER.md` 停在 **09-02 12:03**；深睡侧契约用 `USER.md`/`AGENT.md` 故 `profileOps` 能成功（09-09T14:33Z `profiles=1 gate=pass`），反证问题只在蒸馏契约用词。**这是主线 Next「蒸馏 profiles 双画像写入」长期不达标的唯一堵点。** 修复：① 写门新增 `normalizeProfileTarget()`——接受 `USER`/`AGENT`、带或不带 `.md`、大小写差异，统一收敛为规范文件名（与同函数既有的 section 归一化同法：模型输出用词漂移一律在宿主侧收敛，不回退成拒收）；② `rejected` 由裸值改为**带拒因对象**，四个分支各自写真原因（非画像目标 / 格式违规含具体项 / 容量超限含算式与阈值 / replace 未逐字命中），审计不再糊成一句「格式/容量门」导致无法诊断；③ `PROFILE_CAP` 硬编码 3,000 → 按 target 读 `liveCaps()`（补齐 2026-09-10「画像/记忆容量与容量门同源」漏掉的**第三处容量源**：USER 取 `capUser`、AGENT 取 `capAgent`）；④ 契约文本（判定句 + JSON 示例）与 `skill/engine/distill-contract.md`（v5.1）同步为 `USER.md|AGENT.md`；⑤ 深睡侧 `profileOps` 预过滤改用同一归一化（原 `['USER.md','AGENT.md'].includes()` 会把漂移值**静默丢弃**）。**实证**：`npm run typecheck` / `npm run build` 零错误、`check-hardcode` 通过；**针对真实编译产物**的赋值桩测试 **26 PASS / 0 FAIL**——从 `lib/distill.js` 抽取真实 `normalizeProfileTarget`/`profileCapOf`/`writeProfileLine` 函数体驱动（非复刻），核心断言「裸 `AGENT`/`USER` 现可成功写入且落到正确文件」通过。**部署（发布级）**：本地提交 `a70f134` → 推送 `origin/master` → profile 依赖 `dsh-shoucang-memory` 由 `#8bec0d42…` 改指 `#a70f134…` + `pnpm install` 重算 lock 三段包键与 integrity（Packages: +1，无其他依赖变动）→ 安装副本与仓库 `lib/`、`skill/` 逐文件 SHA256 一致（`lib/distill.js` 198957 字节）。**生效方式=fiber 热重载（未重启宿主）**：`dsh-super-injector` 重载 `dsh-shoucang-memory`（清缓存 10 模块 / 重建 1 fiber，before/after 均 active）→ 重载后 `sweepBacklog` 于 11s 起执行（`apply()` 启动路径）且 `shoucang_recall`/`shoucang_suite` 正常响应 ⇒ 新代码已装载生效。**红线边界澄清**：`禁自重启`约束的是宿主进程重启/杀端口/自 stop（`notes/lessons.md` §DSH 自托管约束 L118/L122/L97），fiber 级热重载不在其列（同 §L139「禁用插件只停 fiber」）。`CHANGELOG.md` 不在 `package.json` 的 `files` 内、不随包发布，故文档类后续提交不影响安装副本字节。
- **记忆循环断链修复（2026-09-10，用户实态察觉"门拒这么多是不是记忆完全死掉了"——确认死掉）**：① **workspace 反解死循环（根因）**：蒸馏尝试从会话目录名 decode 工作区（`D:\FF\shoucang` → `--D-FF-shoucang--`，盘符冒号被压成 `-`、目录内连字符不可区分）→ 无法还原冒号 → 校验失败 → route=project 卡**每轮全部降级 pending**（45 条门拒中 35 条=此因；22 张 project-defer 堆积无人认领，project 通道最近 4 轮零入册）；修复=**改读转录首行 `session.cwd`（权威无歧义）**，新增 `skill/scripts/transcript-cwd-probe.mjs`（解 zstd 读首行），目录名 decode 仅兜底。② **runNode 子进程 NODE_OPTIONS 干扰（连带根因）**：`runNode` 继承宿主 process.env 的 `NODE_OPTIONS`（inspector 端口 9445 已被宿主占用）→ 子进程报 `Starting inspector ... address already in use` 且**无 stdout**（status=null）→ locate-transcript/cwd 探针/memory-append/write_gate 等**所有 runNode 子脚本静默失效**；修复=spawn 时显式 `NODE_OPTIONS: ''`。③ **defer 卡自动回流**（`flushDeferCards`）：project-defer 是「已裁决为项目卡」的降级暂存——workspace 恢复后**直写 `<workspace>/docs/devref/shoucang/`** 并移入 `.processed`，不再依赖 LLM 重裁决（重裁决按本轮 route 一刀切，实测 22 张卡曾被"消费未入册"而丢失）；挂载于手动触发 + 周期 sweepBacklog。④ **手动触发入口**：`POST /distill/run`（`runDistillNow`）+ 参数调节页「立即处理 pending 候选」按钮。**实证**：存量 22 张 project-defer 恢复 19 张入 `D:\FF\shoucang\docs\devref\shoucang\`；诊断卡 B 自动回流成功（note 报"defer 回流 1 张卡"、pending 清零、devref 19→20）；35 PASS 无回归。
- **子代理感知守卫（2026-09-10，实态修复：等子代理返回期间误触发蒸馏/深睡停滞误判）**：`src/distill.ts` 新增子代理感知——DSH 子代理会话 `header.origin='subagent'` + `header.parentSession` 建父子链，`hasActiveSubagents(sid)` 沿链上溯 ≤4 层判 `status==='running'`。四处修正：① **蒸馏守卫**：主会话派子代理后 turn/end 已完成、status=idle 时不再触发蒸馏（审计 `distill-skip/active-subagent`+`fclass=busy-subagent`，水位保留，重新武装 idle 定时器；子代理完成时父会话 followup 事件会再次触发）；② **事件活性传播**：子代理 turn/end 与任意事件原先被直接 return，现刷新父会话活动（`noteEvent(parentSid,false)`）；③ **深睡停滞判定**：深睡巡检遇活跃子代理会话直接视为 running 并刷新活动（跳过"输出增长探测"——子代理写自己的转录、父转录不增长会被误判卡住）；④ 积压扫尾跳过活跃子代理会话（勿抢蒸）。**二修（同日 E2E 实证）**：首版只查 `ctx.agents.list()` 的 `status`，13 分钟长睡 E2E 中守卫未命中（list() 记录未必带 live status，上游 dsh-subagent 亦另取 `agents.get(id)?.status`）→ 改**双通道判定**：① 事件通道（任意子代理事件即记「父会话有子代在跑」，3 分钟新鲜度 + agent/session disposed 清理，归属解析失败时全局兜底「宁少蒸勿切碎」）；② 枚举通道（list() 扫 subagent 记录 + `ctx.agents.get(id)` 取 live status==='running'）。**三修（同日 E2E 第二轮）**：`parentSidOf` 改多字段探测（`session.header.parentSession/parent`、`session.record.header.parentSession`、`options.parentId/parentSession`、直挂 `parentId`/`parent.id`）——第二轮守卫命中 3 次但三会话同判 busy（父归属解析失败→全局兜底），精度不足；探测全失败才回落全局。
- **配置体系审查全量修复 P0-P2（2026-09-10，config-audit 报告落地）**：P0——参数调节清死键/死UI（archive/lifecycle/merge 组 + 旧「向量检索」区 + 孤儿函数 193 行全删，消费端=_meta/*.py 已不随包分发；/set /toggle 白名单收窄到真有效键；client 111KB→90KB）+ vec 缓存加 **model 指纹**（cacheKey=file+hash+model，换模型旧向量自动失效重嵌，杜绝新旧混用）+ `/vector/cache/clear` 端点与「清缓存重建」按钮。P1——60s 空闲巩固轮心跳移除 + /idle//vector/status|build//model/* 死端点 + consolidateRound 孤儿链删除（panel.ts 1571→1264 行；真蒸馏由 distill.ts armIdleTimer 独立驱动已实证）+ **注入配置迁全局 scheduler.json**（inject* 键；切 root 不再影响注入，root YAML 回落兼容）。P2——新装首开零配置可用（无 root 也能调注入）+ settings-guide 三通道重写。验证：typecheck/build/hardcode 零错误、35 PASS/0 FAIL、核心端点 200/死端点 404、注入双画像实测、向量缓存 model 指纹实证。commits 4fdd207/46ad727/494e053/eb6cf86/8f5284d。
- **深度睡眠空转（2026-09-09 用户指出，上一轮修复的副作用当场实测复现）**：no-traces 回滚水位后 `hottest > lastDeepSleepAt` 恒成立 → 每 10min 巡检重触发一次、每次留一条 no-traces 审计（实测 14:34-18:28 间 6 连发，按此节奏每天 144 条）。重构为**纯水位语义**：① `traceSince()` 去掉「本日 0 点」下限——0 点切会把午夜前产生、午夜后才睡的痕迹永久划出窗口（日切丢痕），纯水位下窗口只会移到更晚、未来痕迹 mtime 必然更晚永不丢失；② 窗口内**确认无痕迹 → 本轮不睡**（不调 LLM、不留审计，窗口直接滑到当前），后续巡检因 `hottest ≤ 水位` 直接 return，空转消失——「没有材料就不需要睡眠」；③ 只有 failed（有材料但没消化成）才回滚重试；④ 全新启动（审计从无消化记录）水位从进程启动时刻起算，首轮不把既有全历史 notes 一股脑当材料；⑤ 作用域口径同步：spec/audit-protocol/README 由「当天痕迹」改为「自上次归纳以来的新痕迹」。验证：typecheck/build/hardcode 零错误 + 测试 28 PASS。
- **深度睡眠归纳三个缺陷修复（2026-09-08 首轮实跑暴露）**：① **无 parent 崩溃**——深睡必然在「全部会话停滞/结束」时触发，此时 `ctx.agents.roots()` 为空，而宿主 spawn 必须有 parent（`resolveChildDepth` 读 `parent.options`）→ 抛 `Cannot read properties of undefined (reading 'options')`，审计只留一条 error，等于「越该睡越崩」。改为 `pickParent()` 三级兜底（当前 roots → 在册 agents → **事件回调中缓存的最近活动 agent**），确无可用 parent 时跳过本轮并审计 `result=no-parent`。② **失败也推进水位**——`lastDeepSleepAt` 在 run 之前赋值，崩溃后整批痕迹被划出窗口，当天重试直接判「本日无痕迹」（实测 09:34 崩溃 → 09:43 重试 no-traces）。改为 `runDeepSleep()` 返回 done/failed，瞬时故障（no-parent/子代理异常）**回滚水位**下轮可重试；重启回放水位跳过 `error`/`no-parent` 条目。③ **无会话即无 parent**——服务重启后从未有过会话活动时 roots/list/缓存全空，深睡永远跑不起来（夜间正是此场景）：新增**守护 parent**（插件 ctx 建常驻 agent，仅承载归纳子代理、不下发任务）作最后兜底，但**默认关闭**（新增配置 `deepSleepDaemonParent`，缺省 false）——实测宿主「新建空 agent 当 parent」路径下子代理 100ms 内 `stop=error` 且零输出，未验证通过，故不上默认路径；开启后路由取插件 `llmProvider/llmModel`，缺省回退宿主默认模型 `ctx.agentDefaultModel`。不开时行为=跳过本轮并**保留痕迹**（水位回滚），等有会话活动后再归纳。另加窗口起点/痕迹长度与非正常结束详情日志便于排障。
- **修复面板路由重复注册导致插件树整体加载失败（2026-09-08，P0 线上故障）**：`GET/POST /deepsleep/config` 被拆成两次 `route()` 注册，而宿主 webserver 按**路径**去重（不区分 method），第二次注册直接抛 `duplicate exact route`，进而 `plugin tree failed to load`——整个守藏插件（面板 + 蒸馏 + 深度睡眠）无法启动。修复：合并为**单 handler 按 `req.method` 分发**；同时在 `route()` 内加已注册路径集合兜底——同路径重复注册只告警忽略，不再因一条路由拖垮整个插件。typecheck/build/check-hardcode ✅。
- **审查修复三连（2026-09-08 逻辑关键点审查 → 用户拍板 A 方案）**：① 蒸馏 memory 路由探测改造——`presence().memory` 由「探测已消失的 @dsh-external/dsh-managing-memory 包（恒 false → 静默降级旁路权威记忆库）」改为 `memorySkillPresent()`（探测 ~/.dsh/skills/managing-memory/MEMORY.md），自测工具同口径；部署口径=skill/ → ~/.dsh/skills/managing-memory/。② panel 配置隔离——apply 给 panel 传浅拷贝，杜绝 scheduler 自持配置（suite/scheduler.json）就地覆写反向污染 panel 键。③ MEMORY_ROOT 双口径写入 skill/README 与仓 README（生产缺省即正确；仓内手工跑脚本须显式指向 _memory/）。
- **蒸馏白名单消费路径修复（2026-09-06，契约 v3 联动）**：project 分支白名单原从 `pmgScriptsRoot()`（scripts 目录）读 → pmg `docs/devref/whitelist.json` 从未被消费（恒走内建缺省）；改为跟随实际写入目标加载（board=generic → `generic_project`/docs/devref，board=project → workspace/docs/devref）。targets.ts：Whitelist 增 `boards` 字段（BoardDef），BUILTIN 补 pmg 两板块，`gateProjectCard` 增 board∈boards 校验（越界宁弃不存）；index.ts/HANDOVER v2→v3 口径残留清理
- **panel 入口双显示修复（2026-09-06）**：0.1.2 契约下 React slot 按钮（`slots.register` 第二参数组件）与 DOM 直插入口（`mountSidebarEntry`）同时显示为两个侧栏入口——暂禁用 slot 按钮（`ENABLE_SLOT_BUTTON = false`），只保留 DOM 直插真实入口；React 组件改按 0.1.2 契约传 register 第二参数（`options.component` 已不被读取，对照 dsh 0.1.2-alpha.3 brand-official 用法）；如需恢复改回 `true`
- **panel 入口双显示修复（2026-09-06）**：0.1.2 契约下 React slot 按钮（`slots.register` 第二参数组件）与 DOM 直插入口（`mountSidebarEntry`）同时显示为两个侧栏入口——暂禁用 slot 按钮（`ENABLE_SLOT_BUTTON = false`），只保留 DOM 直插真实入口；React 组件改按 0.1.2 契约传 register 第二参数（`options.component` 已不被读取，对照 dsh 0.1.2-alpha.3 brand-official 用法）；如需恢复改回 `true`

### Added
- **UI 对齐重构：新增「架构」视图（5 端点 + MCL 旋钮可调）（2026-09-13/14）**
  **动机**：G0–G4 重构后，记录层/内容环/统一台账/装配根/断言图在界面上**不可见**（实测客户端引用 **0** 处），
  MCL 8 个旋钮**无写入口**。
  **落地**：主机侧新模块 `src/panel-arch.ts`（`/arch/records` · `/arch/graph` · `/arch/observability` ·
  `/arch/assembly` · `GET|POST /mcl/config`）；客户端新增一级视图「架构」（5 页签 + 通用事实渲染器 + JSON 兜底）+ `ICONS.arch`。
  **活体实测（真实数据）**：记录 **967** · 载体 **11/11 一致** · **写时自证 写33/可还原33/分歧0** ·
  断言图 **139 边/悬空 0** · 台账 **494 行/缺 at 0** · **桥 0/路由 41/模块 18-18** · 旋钮 8 个（阈值 0.58 · P2b true · REM false）。
  **门禁**：`npm test` **62 pass** · `ui-geo-regress` **99 PASS/0 FAIL**（含新页出图）· 视图契约 **PASS** ·
  `check-ui-contract` **9/0** · 路由锁 41 · 安装副本 **185/185**。
  **看图/看数据才发现的四处**：① 页签占位符未清空（会与真实数据并存）② 描述里 `**…**` 被当字面量
  ③ **新视图图标 key 缺失 ⇒ nav `undefined.split` ⇒ 整页白屏**（二分定位；加视图必须同时补图标并纳入出图集）
  ④ **根目录错**：`/arch/records` 曾用 suite 区而非记忆库 ⇒ 返回"记录 0"这种**看起来正常的空态**（活体抽查抓到）。
  证据图：`deliverables/ui-arch-view-2026-09-14.png`；方案档 §76。
- **声明位同步已执行 + 重启核实（2026-09-13/14）**
  **重启未退回**（实测）：安装副本 **182/182 与仓内一致** · 特性 31 项 · 新模块全在 · 路由 200
  ⇒ 本次重启**未触发重新物化**（安装被复用）。但声明位仍是旧 ref ⇒ 趁重启窗口追上：
  - 备份 `package.json.bak-ref-20260914-011048`（+ lock）→ ref `#f81eb2e5…` → **`#5d9e4ae5…`**
  - **踩到一处文档偏差**：`pnpm install --legacy-peer-deps` ⇒ **`Unknown option`**（那是 **npm** 旗标）；
    本环境是 **pnpm v11** ⇒ 正确写法 **`pnpm install`**。**已修 `AGENTS.md` 常用命令**。
  - `pnpm install` ⇒ **Done in 14.1s · +1 包**（**未触发批量删除保护**）
  - **版本钉点三处一致 @ `5d9e4ae5`**（旧 `f81eb2e5`）· 安装副本 **182/182** · 特性 **31 项** ·
    `lib/mcl.js` 含 `decideTurn`/`materialStep`/`sysBlockNonEmpty`（确为新码）· 热重载后 **6/6 路由 200**
  ⇒ **隐患消除**：今后重新物化会拉到本次提交，不再退回旧代。
- **仓库同步（f38d73e）+ 部署核查（2026-09-13）**
  **同步**：提交 **`f38d73e`**（624 件）并推送；**远端 sha 逐位核实一致** · 工作树 **0 未提交** ·
  隐私红线通过（无 `_memory`/`devref`）。
  **提交前拦下一处污染**：仓库根出现 5 个**误建的单库骨架散件**（`notes/`、`whitelist.json`、
  `memory-whitelist-spec.md`、`task-protocols.md`、`human-execution-loop.md`；09-13 18:19 同时刻的 133–146B 桩）
  ——来源是面板 **`POST /root/bootstrap`（建单库骨架）被指向仓库根**。处置：**移出到 `%TEMP%`（不删）+ `.gitignore` 设防**。
  **部署核查（四项 + 活体）**：安装副本 **182/182 逐件 sha256 一致** · `check-deploy-sync` **PASS** ·
  特性 **31 项** · 版本钉点 **PASS @ f81eb2e5** · 六条面板路由 **全 200** · MCL `sysBlockNonEmpty=19`（P2b 持续生效）。
  **唯一剩余缺口（决定：暂不动）**：profile **声明位**仍是旧 ref `#f81eb2e5…`，而仓 HEAD 为 `f38d73e`。
  只改声明而不跑 `pnpm install` 会留下"声明 ≠ 实装"窗口，而 install 属**重启类**（触发批量删除保护）
  ⇒ **保持当前已验证一致的状态**，命令与时机留给用户（方案档 §74.3）。
- **P2b 活体达成 + 全部决策收口（去重已执行）（2026-09-13）**
  **① 活体判据达成**（我自己立的判据）：真机 trace `set|430` → `cap|12` → **`renSame|430`**，
  `/mcl/status` **`sysBlockNonEmpty=1` · `sysBlockLastChars=430`** ⇒ 材料出现在**注入面**（非用户消息）✓
  **② 跨文件重复：按授权执行去重**（不再是"只报告"）——内容**已失效**（指向已移除的 pmg 卡库），
  删除 **4 份标题 + 4 份正文 + 1 条重复归档 = 9 行**；影子库 **977 → 967**；
  `check-record-parity` **PASS**；`--dups` 只剩 **2 组正常结构**（索引/详情同名标题）；
  库有 git 版本化 + 备份 `.records/backup-dedup-*` ⇒ **可回退**。
  （过程复盘：首轮字面量取自 records 的**截断串** ⇒ 只匹配上标题、正文漏删 ⇒ 出现"有身无头"，
  随即用**前缀匹配 + "下一非空行必须是标题"**的安全阀补删；`release.md` 因正文在**文件末尾**被安全阀跳过，单独收尾。）
  **③ 其余决策全部由我落定**（详表见方案档 §73）：MCL 口径不改（86% 无召回命中才是瓶颈）· REM 保持关 ·
  M4/M5 **no-go**（`record` 未实现 + 零生产写入）· `test-forgetops` 飘红**不盲改** · 子代理不引导**保留** ·
  **不提交不推送**。**⇒ 无任何事项再挂在"等你决策"上。**
- **层二真根因（活体 trace 抓到）：轮级重置把刚写的材料删了（2026-09-13）**
  **真机序列**：`pre`(判定) → **`set`(材料 441 字符)** → **`cap`(user/message) 到达** → 下一步 `ren` **读回 0**。
  ⇒ 根因是 `captureTaskText` 的 **`state.delete(sid)`（轮级重置）与材料写入赛跑**：
  **本机宿主的 `user/message` 落在当轮 pre-step 之后** ⇒ 重置把**刚写入的材料删掉** ⇒ 块永远读不到
  （审计照旧记 `viaSystem=1`——又一次"**意图 ≠ 送达**"）。
  **为什么夹具一直绿**：夹具里 `cap` 总在 `set` **之前**，**从未覆盖真机顺序** ⇒
  **夹具不只在数据分布上会失真，事件顺序同样会失真**。
  **修法（极小）**：轮级重置**只清判定态**（channel/topics/signals/nudges/sim/lateLogged），
  **保留 `materialText`/`materialStep`**——材料要活到"那一步的渲染"为止。
  **回归闸**：新场景 Q（**按真机顺序**：pre-step 先判定 → cap 后到 → 下次渲染必须仍取到材料），
  `test-mcl` **45 → 47 PASS**；Q1 在前一版代码上会红，修正后实测 321 字符 ✓。
  **门禁**：`typecheck`/`build` 零错 · `npm test` **62 pass** · 安装副本 182/182。
  **活体判据仍待真实用户消息**（`sysBlockNonEmpty > 0`）：本轮消息在本代开始前到达，测不出。
- **层二已修：MCL 判定提前到"消息到达时"（P2b 材料终于能在首次渲染前就位）（2026-09-13）**
  **① 机理链（用户问的"为什么取不到"）**：块由宿主在**请求装配**时渲染，而 `pre-step` 在**其后**才跑；
  旧实现把判定与材料写入都放在 `pre-step` ⇒ 块渲染那一刻 `st.materialText` **还是空的**；
  后续渲染能否补上 ⇒ **实测没有**（`injected=436 viaSystem=1` 而 `sysBlockNonEmpty=0`／21 次渲染）
  ⇒ **审计里的 `viaSystem=1` 是"意图"，不是"送达"**。
  （"为何之后再没渲染"**未查明**——候选"宿主每轮只装配一次/缓存"或"state 下次渲染前被清"；
  我没证明是哪一个，而是用"**提前写**"绕过它。）
  **② 修法：单一实现、两处触发**——新增模块级 `decideTurn(d, sid, step)`（召回/熟悉度/快慢/去重/材料/审计/计数全集中一处）；
  **触发点①** `session/event` 的 `user/message`（**消息到达时**，在**任何渲染之前**备好材料，仅 system 段模式）；
  **触发点②** `pre-step`（兜底 + 消息面注入），靠 `st.channel` **幂等**。
  **③ 顺带修一处真回归**：材料落在本步时**本步不判合规**（`st.materialStep`）——否则第 1 步就误发再引导（F3 实测红）。
  **④ 证据（决定性在单元级）**：新场景 P（`test-mcl` **43 → 45 PASS**）——
  **P1** 消息到达即判定 · **P2 块无需 pre-step 即可返回材料（实测 321 字符）**。
  门禁：`typecheck`/`build` 零错 · `npm test` **62 pass** · 安装副本 182/182。
  **⑤ 活体判据（待真实用户消息）**：`/mcl/status` 的 **`sysBlockNonEmpty > 0`**；P2b 已开通，若仍为 0 则当轮读轨迹定位并回滚。
- **MCL 判定门竞态**已修**（有回归测试）· P2b 第二层假设逐个证伪（2026-09-13）**
  **① 第一层（更基础的缺陷）已修**：旧判据 `!st.channel && step !== 1 → late-skip` 只认 **`step === 1`**，
  而消息（`cap`）若落在当轮 step 1 的 pre-step **之后** ⇒ **整轮不判定**（与 P2b 无关：**消息面也不会注入**）。
  新判据原理化：**判定时机 = 消息到达后的第一个 pre-step**（`capAt > 上次 pre-step 时刻`，限前 3 步内，
  超出仍不打断进行中的任务）。**证据**：`test-mcl` 新增场景 O（**39 → 43 PASS**）——O2「消息晚到也判定」
  修正前恒 0、现 `channel=slow`。（O3 首版**是我的夹具判据写错**：nudge/合规步本就会写 `mcl-step` 行，
  应断言"不重复**注入**"，已改。）
  **② 子代理不是 MCL 的有效测试车**（我先前判断错）：`mcl.ts:427` 明写**子代理不引导**
  ⇒ 轨迹实证子代理有 `ren`/`cap` 而**一次 `pre0` 都没有**。⇒ 有效测试车只有**顶层用户会话**，
  且其 `cap` 必须在**当前进程代内**到达（重载清内存态）。
  **③ 第二层假设逐个证伪（测，不猜）**：① 宿主传参形状 ⇒ **证伪**（`sid` 能解出）② 两键不同源
  （`agent.id` vs `agent.session.id`）⇒ **证伪**（轨迹 `renSame`）③ 单元级读取 ⇒ **证伪**（场景 F6 通过）
  ④ **渲染早于设置** ⇒ **存留（最可能）**：真机 `injected=436 viaSystem=1` 而 `sysBlockNonEmpty=0`（21 次渲染），
  单元级能读 ⇒ 差别只在**时序**。
  **④ 决策**：**P2b 保持关**（丢材料比不做更糟）；材料走消息面。**修复判据不可动摇：`sysBlockNonEmpty > 0`。**
  **下一步已定形状**：把判定**提前到消息到达时**（`session/event` 本可 async；判定抽为**单一实现**供两处共用、
  靠 `st.channel` 幂等），使**当轮首次渲染**即可取到材料；`pre-step` 留兜底。
  ⚠ **不在状态不明时硬改活体**：该重构须先有"渲染早于设置"的直接证据。
  **⑤ 顺带**：探针触发 I1 装配棘轮（`registerMcl` 122 > 120）⇒ `captureTaskText` **提到模块级**
  （合仓内约定）⇒ 门禁全绿；`CLAUDE.md` 的 `scheduler-share.ts` 桥接说法**已失效**⇒ 更正为 composition root。
- **P2b 实测不合格 ⇒ 回滚（材料被静默丢弃）· 教训：我把"没查数据"说成了"环境做不到"（2026-09-13）**
  **① 用户一句反问点破我**：「P2b 慢通道材料流实景为什么做不了，你用一个新会话测试不就可以了吗」——
  我此前把它归为"环境受限/需真人发言"，**但从未去读已经躺在库里的活体数据**。
  **② 一读就看到答案（推翻我自己的假设）**：`/mcl/status` 前值是
  `slow=2 · injected=1`（**不是"恒 0"**），台账已有 **4 条 `mcl` 行**（改道在运行态也生效）。
  其中一行是：
  ```
  type=mcl-step step=1 channel=slow sim=0.572 injected=436 viaSystem=1
  ```
  **而 `sysBlockNonEmpty = 0`（21 次渲染，块从未返回过材料）**
  ⇒ **审计记的是"意图"（viaSystem=1），不是"送达"**：材料被标成进了 system 段，
  而 `materialInSystem` 下**又不再走消息面插入** ⇒ **慢通道材料被静默丢弃**。**这是我第 17 轮开启 P2b 时引入的回归。**
  **③ 先测不猜**：给块加**宿主传参探针**（`sysBlockCtxKeys` / `sysBlockLastSid`）——实测宿主传 `agent, scope, signal`，
  **我的解析成功解出 sid**（`session-697a44`）⇒ **不是形状问题**；故问题在**时序**：
  块在同步请求装配时渲染，而材料在 `pre-step` 才设置、下一轮开始即清 ⇒ **永远赶不上渲染**（此因果为**假设**，未经宿主源码确认）。
  **④ 决策：回滚 P2b**（`mclMaterialInSystem: false`，备份 `.bak-p2b-off-*`）——因为它在"声称 viaSystem=1"的假象下
  **静默丢弃**材料，**比关着更糟**；回到消息面（送达有据：`test-mcl` F3/F6 + 审计 `injected` 计数）。
  实测回滚后 `materialInSystem=False`、块未挂载（`sysBlockCalls=0`）。
  **⑤ 探针保留**（`sysBlockCtxKeys`/`sysBlockLastSid`）——重开 P2b 时的**首要判据**就是它；
  **重开前提**：先解决"材料在渲染之前就位"（例如把 material 缓存到**下一轮/下一步**而不是轮内清除），并证明 `sysBlockNonEmpty>0`。
  **⑥ 教训（比修 bug 更重要）**：**我把"没查已有的数据"说成了"环境做不到"**——
  这类"未验证的限制"会被写进汇报，看起来像客观约束，实际是自己没看。**凡声称"受限"，先列出已有哪些数据可查。**
- **收尾决策记录（用户授权「除重启外自行决策闭环」）+ `--dups` 可复现提案（2026-09-13）**
  **① 六项决策全部落档**（方案档 §67：决策 + 依据 + **开门条件**，不留模糊）：
  · **跨文件重复 → 不删**：`git log -S` 追溯根因是提交 `7aecee6`「memory: snapshot 2026-09-11」
    —— **整库快照导入带进来的既有状态**，非本仓脚本缺陷；且用户记忆原则「**可写不等于有处置权**」
    ⇒ 闭环 = **可复现提案** + 由你指定保留哪一处（记忆库有 git 版本化，可回退）。
  · **MCL 口径 → 不改**：真数据显示 **86% 的步无召回命中**（与阈值/标签门无关），改阈值收益 ~1pp 且属行为变更
    ⇒ 先查召回；标定工具常驻为仪表。
  · **联想 REM → 保持关闭**：候选生成已由向量路径覆盖（实机落环 1 条），REM 增量会**直接并入 AGENTS.md 画像**，
    噪声代价高；开门条件与做法已写明。
  · **M4/M5 切源 → 明确 no-go**：`record` 尚未实现（要做须改**库侧脚本**写入语义）+ `dual` 开启后**零生产写入**
    ⇒ 无流量证据不切；**开门条件**（出现真实写入样本）与执行路径（§47 M0–M5）已写明。
  · **`test-forgetops` 飘红 → 不改代码**（无断言名不盲改）；捕获已就绪，再现即定位。
  · **git → 不提交不推送**（工作树是你的；本地提交不改变 profile 物化行为），风险与检测/修复见 AGENTS.md。
  **② 新 `--dups`**（`scripts/assertion-graph.mjs`）：列出**跨文件逐字节同文**组（排除空行/分隔线），
  实测 **5 组**——其中 **2 组是正常结构**（章节标题在索引与详情各一处：`## 偏好-开源免费`、`## 身份`），
  **3 组是真重复**（`## DSH 开发知识迁移指引` 标题+正文 ×4 · `归档于 …（forgetOps；可回滚）` ×2）。
  **本器只报告不删**。
- **新棘轮：legacy 流引用白名单——把"改了落点忘了消费方"变成可拦（2026-09-13）**
  **① 动机来自实证**：DS4 第六刀改落点后，`test-event-envelope` 仍读 legacy `distill-audit.jsonl`
  ⇒ **ENOENT 崩了才暴露**。"改了落点、忘了消费方"这一整类问题当时**只能靠崩来发现**。
  **② 做法**：`check-observability` 新增一段——为每个 legacy 流登记**引用白名单**（含理由：
  双源读实现 / 写入侧路径常量 / 测试夹具 / 注册表自身），
  **引用集合 ⊆ 白名单** 才通过；**新增引用即 FAIL** 并点名文件；白名单**过期项也会提示**（防白名单腐化）。
  **③ 已反向证伪**：造 `src/_legacy-probe.ts` 引用 legacy ⇒ ❌ 精确点名该文件；删除 ⇒ PASS。
  **④ 它当场抓出一处真漂移**：`scheduler.ts` 里 **6 处用户可见描述**仍写着旧落点
  （`mclAudit` / `shadowScore` / `activationShadow` 的注释与 `description`）——那些流**早已并入统一台账**
  ⇒ 用户按描述去找 `score-shadow.jsonl` 会**找不到**。已全部改为指向 `audit/ledger.jsonl` 与对应 `type`。
  **⑤ 验证**：`typecheck`/`build` 零错 · `npm test` **62 pass** · 观测流门 **PASS**（含新段 + `--selftest`）·
  安装副本 **182/182** · 已部署并热重载。
- **MCL 通道**离线标定工具** + 用真数据推翻「快通道恒 0」的旧结论（2026-09-13）**
  **① 为什么是"离线标定"而不是"每步交模型"**：快/慢通道判定在**热路径**（每步 `agent/pre-step` 都要判）
  ⇒ **不可能每步调模型**。按项目原则：**这一步的判定必须廉价**（向量/规则），而**口径的选择**应由**数据**决定
  —— 新 `scripts/mcl-calibrate.mjs` 就是那个"用数据定口径"的地方（双源读：legacy ∪ 台账 `mcl*`）。
  **② 真数据（936 个 mcl-step）**：
  ```
  hit 为空 805（**86.0%**）           ← 多数步根本没有任何召回命中
  sim 分位 p50=0.513 p90=0.575 p99=0.640 max=0.662
  阈值 × 标签门：T=0.58 ⇒ sim 过线 87(9.3%) · 快通道 17 · **被标签门挡掉 70**（其中 flow:14 · (无/空):42）
                T=0.55 ⇒ 238(25.4%) · 26 · 212       T=0.65 ⇒ 3(0.3%) · 2 · 1
  ```
  **③ 结论（推翻旧说法，且指出真正的瓶颈）**：
  · 「快通道**恒 0**」**已过时**——实测 `fast` 有 **26** 条（约 2.8%）；旧观测属其时的未校准态。
  · **首要瓶颈不是阈值、也不是标签门，而是 86% 的步根本没有召回命中**（与两者都无关）；
    ⇒ **调阈值无法改善快通道率**，该查的是**召回（词表/索引）**。
  · 次要因素：在**有命中**的步里，标签门（现行 `[路径]`/`[推荐]`… 实为 `[路径]`/`[原则]`）挡掉约 **62%**，
    被挡的多是 **`[flow]`**（E 层知识标签）⇒ 若要把快通道率提上去，第二顺位是**改 gate 口径**
    （须同步改注册表 `surface.mcl.gate`），而不是降阈值。
  **④ 本器只给数据、不替你定口径**（工具输出里明写三档读数提示）；口径变更属行为变更，**待拍板**。
  **⑤ M4/M5 证据基础仍为空（诚实标注）**：写时自证仍是 **11 次（全 CLI 导入）**——
  `dual` 开启后**尚无真实记忆写入** ⇒ **切源仍无生产证据**，不切片。
- **DS4 收口：`suite` 域**单一事件源达成**（事件流 1 = `ledger`）——四族两域口径成立（2026-09-13）**
  **① 最后一刀是"判定不并"**：`distill-watermark` 的**读侧语义**是 `map.set(sessionId, o)` —— **按 key 取最后一条**
  （键控状态），与我所并的那 6 条（读侧把行当**事件**：计数/聚合/取最近）**不同族**；且它在**热路径**
  （每 10min × roots **全量读**，D7 已记为性能隐患）⇒ 并入只会放大那次读。
  ⇒ 归 **`keyed`（键控日志）** 族，**不并入事件台账**。**这是读语义的分别，不是为了凑目标数**——
  判据写在注册表里：**事件流 = 读侧逐条语义**。
  **② 收口口径（四族 × 两域）**：
  | 族 | 域 | 条数 | 处置 |
  |---|---|---|---|
  | **事件流** | **suite** | **1**（`ledger`） | ✅ **DS4 目标：单一事件源** |
  | 键控日志 | suite | 1（`distill-watermark`） | 读侧键控语义 + 热路径 ⇒ 不并入 |
  | 事件流 | bank | 2（`access-real` · `ring-events`） | **分域**（数据属库）⇒ 不该并 |
  | 状态表/投影 | bank | 3（`activity` · `archive-progress` · `maturation`） | 整表重写/upsert ⇒ 本就是投影 |
  **③ 本轮之前的六刀（suite 域 13 → 1）**：`score-shadow` → `activation-shadow` → `stub` → `episodes`（连带落地
  **按 type 裁剪**机制）→ `mcl-audit` → `distill-audit`（连带**双源读**强制验证）——每刀都有消费者侦察 + 对拍/断言 + 棘轮收紧。
  **④ 验证**：`check-observability` **PASS**（`suite 域事件流 1 = 1（DS4 目标达成）`· 键控 1 · 库域 2 · 状态表 3）·
  `--selftest` PASS · 每个注册项都带**族/域/理由**，陈旧登记会告警。
- **DS4 第六刀：`distill-audit` 并入 `ledger`（suite 域事件流 3 → 2）——带正确性对拍（2026-09-13）**
  **① 先量风险，再动刀**：这条流有 **6 个读侧**，其中**两个是正确性路径**（重启**回放深睡水位** `lastDeepSleepAt`
  与**痕迹窗口**）。动刀前先对拍三种源：
  ```
  legacy 回放 → 2026-09-13T10:17:48.975Z（命中 16 轮深睡）
  仅台账      → (无)（命中 0 轮）        ← **单读台账会丢光水位历史**
  双源合并    → 2026-09-13T10:17:48.975Z ✅
  ```
  单读台账的后果是**具体的**：水位回放拿不到值 ⇒ 置 `Date.now()` ⇒ **窗口滑到当前、丢一轮可回想的痕迹**
  （与仓内 D2「丢料」同类）。⇒ **双源是强制的，不是谨慎。**
  **② 落地**：新 `src/audit-source.ts`（**双源读单一实现**：legacy 在前、台账 `audit.*` 在后；
  同时提供**行数组**与**合并文本**两种形态——后者让"原本就是 `readFileSync(路径)`"的调用点只换一处表达式，
  **既有过滤/括号结构一律不动**，把改面压到最小）；写入改投 `ledger.jsonl`（`type=audit.<kind>`）。
  6 个读侧全部迁移（2 正确性 + 3 面板 + 1 脚本）。
  **③ 对拍（用真实现，不是近似）**：`lib/audit-source.js` 双源读 **931 行**、回放水位与 legacy 单源**逐位相同** ✅。
  **④ 棘轮**：suite 域事件流 **3 → 2**；`distill-audit.jsonl` 转 legacy 只读豁免（豁免理由写明"单读台账会丢水位历史"）。
  **⑤ 门禁抓到一处我漏迁的消费方（正是它该做的）**：`test-event-envelope` 读 `paths.auditFile` ⇒
  改落点后 **ENOENT** 崩掉。**这印证了「改落点必须同步全部消费方，含测试件」**——已迁到台账（`auditRows()`）。
  另：`memory-reconcile.mjs` 有**库内孪生副本**，`check-deploy-sync` 如实报不一致 ⇒ 备份后部署 + 库内实跑。
  **⑥ 真机**：`/memory/overview` 200 且 `distillStats`/`growth` 均在（双源读在起作用）· `/mcl/status` `/rings` 200。
  台账 `audit.*` 暂为 0（重载后尚无蒸馏写入）——**双源设计的好处正在此：不依赖"首次新写入"即可验证口径不变**。
- **DS4 口径补正：注册表加「域」维度（suite/库）——并说明剩下三条**为何暂停**（2026-09-13）**
  **① 侦察结果（决定了不能照搬前五刀）**：
  · **`distill-audit`** —— **5 个代码消费者**，且其中一个是**正确性路径**：重启时**从它回放
    `lastDeepSleepAt`** 重建深睡水位。**先并表不搬回放读侧 = 可能破水位**（读错文件或双计）。
  · **`access-real` / `ring-events`** —— **根本不在同一个域**：它们在**记忆库**（`<bank>/audit/`、
    `<bank>/.records/`），而 `ledger` 在 **suite 知识区**。**「数据属库、运行时台账分域」是仓内既有约定**
    ⇒ **跨域并入是语义错误**，不是"还没做"。
  · **`distill-watermark`** —— 同域，但读侧在**热路径**（每 10min × roots **全量读**）⇒ 并表会让那次读变大，
    需要按 type 高效过滤（或每类索引）——**是含性能权衡的改造，不是搬代码**。
  **② 落地**：`check-observability` 注册表加**第二维「域」**（`suite` / `bank`），
  棘轮**只数 suite 域事件流**；三族分别打印。实测：**suite 域事件流 3（= 基线 · 目标 1）·
  库域事件流 2（分域自持，不并入）· 状态表/投影 3**。
  **③ 这纠正了我此前的说法**：之前报"**事件流 5 → 目标 1**"是**没有分域**的——把库域的流算进了 suite 台账的目标里。
  分域后目标数更小（3）**但更真**：库域两条不是"待并"，而是**不该并**。
- **改道已确定性验证 + 抓出并修掉一处测试污染真库（2026-09-13）**
  **① 真机验证为何停滞（推理清楚）**：重载后 MCL 走了 8 步而 `fast=0/slow=0` ⇒ **8 步都没做通道判定**。
  原因不是改道失败，而是**我的自动轮消息不是真实用户输入**——MCL 用结构判别 `isRealUserEvent`
  （`data.source.kind === 'user'`）把人机消息分开，自动 goal_round 被**正确忽略** ⇒ 无任务文本 ⇒ 不判定、不落账。
  ⇒ **不靠"等真人打字"验证**，改用确定性单测。
  **② 新 `test-mcl` 场景 N（已登记）**：不给 `audit` 钩子（走默认钩子）⇒ 隔离 DSH_HOME 下真写盘，断言
  **台账出现 `mcl*` 行**、含 `mcl-step`、每行有非空 `at`、且 **legacy `mcl-audit.jsonl` 未被创建**
  （后者才是"改道"的实质）。`test-mcl` 35 → **39 条**。
  **③ 抓出并修掉一处测试污染（本轮最有价值的发现）**：写场景 N 时发现 **`test-mcl.mjs` 本来没有环境隔离**
  （直接跑在真实 `DSH_HOME` 上），而"默认审计钩子会真写盘"⇒ 我的两次调试运行**往真库台账写了 4 行测试数据**
  （`sid=sess-aud…`）。**已按精确条件（type + sid 前缀，不按时间）删除那 4 行并留备份**
  （`ledger.jsonl.bak-testpoll-*`）；场景 N 改为 **mkdtemp 隔离 + finally 恢复 + 清理**。
  **纪律**：**凡触发真写盘的用例，必须隔离 `DSH_HOME`**——这不是洁癖，是"测试不该动用户数据"。
  **④ 顺带修一处数据形状**：判别字段原为 `mcl.mcl-ready`（kind 已带 `mcl-` 前缀，再加前缀成双）⇒
  改为直接用 `kind`（`mcl-ready`）；两个读取者的过滤放宽为 `startsWith('mcl')`（兼容历史写法）。
  **⑤ 验证**：`typecheck`/`build` 零错 · `npm test` **62 pass** · 真库台账 `mcl` 行 = **0**（测试确已隔离）·
  已部署并热重载。
  **⑥ 一次瞬时红的追查（诚实收尾：未复现，但锁定嫌疑件）**：`npm test` 又出瞬时红（本次 `28 PASS / 2 FAIL`；
  §28 曾 `27 PASS / 3 FAIL`），**单跑与连跑均不可复现**（`test-forgetops` 单跑 4 次、`npm test` 连跑 3 次全绿）。
  **定位手法：用汇总条数反查**——两次失败合计都是 **30 条**，与 `test-forgetops.mjs`（30 条断言、
  唯一含 `sectionExists` 的测试）**精确对应** ⇒ 锁定嫌疑件。
  **我一度按"对账闸并发写竞态"假设加了复跑容错，随后定位显示该假设不成立**（该测试**夹具隔离**、不读真库）
  ⇒ **已撤回**。**纪律：未证实的容错等于掩盖真漂移**（它会把首次真实不一致静默抹掉）。
  处置：**不猜修**（没有失败断言名就改代码＝盲改）；`check-runner` 的失败输出捕获（今日早先为同一抖动所加：
  原 `stdio:'ignore'` 把失败件输出吞掉，致前两次抖动无从定位）会在**下次再现时直接给出失败断言名**——
  那才是动刀的时机。经验已入 `pending/flaky-gate-30-assertions-2026-09-13.md`。
- **DS4 合并第五刀：`mcl-audit` 并入 `ledger`（事件流 6 → 5）（2026-09-13）**
  **① 消费者侦察（代码侧 2 个）**：面板 `/mcl/status` 的 `recent`（`panel-observe.ts`）·
  `scripts/mcl-compliance.mjs`；其余均为**配置描述与文档**（写的是路径文本，非读取）。
  **② 改法**：`mcl.ts` 的审计钩子改投 `ledger.jsonl`（`type=mcl.<kind>`——该判别字段**上一轮补信封时已就位**）；
  两个读取者改为「**legacy 文件（历史）∪ 台账里 `mcl.*` 行**」**双源读**（历史不丢、口径不变）。
  `panel-observe` 为此抽出 `mclAuditRecent(root, n)`（`/mcl/status` 的 recent 与它单一同源）。
  **③ 棘轮**：事件流 **6 → 5**（`mcl-audit.jsonl` 转 legacy 只读豁免）。
  **④ 已验证**：`typecheck`/`build` 零错 · `npm test` 全绿 · 棘轮读数 `事件流 5` ·
  `mcl-compliance` 双源读数正常（803 行，来自 legacy）· `/mcl/status` 200 且 `recent` 10 行（legacy）·
  legacy 末次写入停在 **22:52（重载前）**。
  **⑤ 诚实标注（本轮的验证缺口）**：重载后 MCL 走了 3 步但 `fast=0/slow=0` ⇒ **这 3 步没做通道判定**
  （重载后尚未收到**新的用户消息**）⇒ **自然没写审计行**，故"写入已改道"只能由**下一回合**的真实回合验证
  （判据：legacy 文件**不再增长**，而台账出现 `mcl.*` 行）。**不把"没数据"说成"已验证"。**
  **⑥ 我的一次漏改（记）**：改 `mcl-compliance` 时把变量 `f` 改名，**第 63 行的引用漏改** ⇒ 直接
  `ReferenceError: f is not defined` 崩掉。按纪律**先直跑取原始报错**（不猜），一眼定位。
  ——与上一轮"改 `V` 签名漏改调用点"**同一类错**（今日第二次）⇒ 改名必须全仓搜旧名。
- **重做候选层：`pointer` 分组 → 向量近邻（`nearPairs` + `adjudicatePairs`）；真库立刻查出跨文件重复（2026-09-13）**
  **① 推翻上一版（有据）**：旧 `competingOf` 按 `pointer` 相等分组 ⇒ 拿真库+真向量一跑产出 **224 条"相斥"**，
  其中混着 `[身份] ≠ [硬件]` 这种废话；**更致命的是它对跨文件重复结构性失明**（同 pointer 才同组，
  而重复恰恰常发生在**不同文件**之间）。**精确键回答不了"是不是同一件事"。**
  **② 重做后的分工**：
  · `nearPairs(records, vectors, {topK, minSim, maxN})` —— **候选生成交向量**（top-k 近邻 + 去重 + 截断）；
    与「联想」的分工**恰好相反**：联想要**词面不重叠**（异域同构），竞争/重复要**语义近**（同一件事）
    ⇒ 本层**不做任何词面过滤**；`samePointer` 降级为**证据**而非分组键；超 `maxN` 者**如实计数不参与**（宁少勿假）。
  · `adjudicatePairs(pairs, judge)` —— **判交模型**（`judge` 注入，返回 `duplicate / consistent / contradictory /
    unrelated / null`；`null` = **未判**）。**为什么必须模型**：向量只能说"很像"，**说不了"能不能同时成立"**
    （"必须备份" / "禁止备份" 语义几乎相同却互相矛盾）——这是判断，不是度量。
  **③ 真库一跑就出真东西（本轮最有价值的发现）**：`assertion-graph.mjs --near` 立刻查出**跨文件重复**——
  同一段文字在 **4 个文件**各存一份（相似度 **1.000**）：
  `notes/flows.md#58 = notes/lessons.md#160 = notes/release.md#7 = notes/tools.md#37`；
  以及 `notes/lessons.md#159 = notes/release.md#6 = notes/tools.md#36`（同标题）。**旧版结构上找不到这个。**
  （**只报告不擅改**：那是用户记忆库的内容，去重属写入动作，须用户/蒸馏决定。）
  **④ 测试**：`test-assertion-graph` 38 → **41 条**（G 组重写为近邻语义：异 pointer 也能成候选 · 同 pointer 但向量远不成候选 ·
  maxN 如实计数 · 向量缺失零候选 · 对称对去重；L 组重写为判层语义：四种裁决透传 · 无模型全未判 · 判层抛异常记未判）。
  **⑤ 夹具第四次出错（都记）**：合成向量**眼估**（`[0,1]` 与 `[0.1,0.9]` 我以为是"都远离"，实际几乎平行）
  ⇒ 改用**正交基**（两两余弦精确为 0）；另改 `V` 签名后**漏改调用点** ⇒ `[0.99,0.01,undefined]` ⇒ NaN
  ⇒ 给参数**默认值**根除该类错。**夹具 bug 与代码 bug 始终分开归因。**
  **⑥ 顺带**：`vec#cosine` 签名改 `readonly`（它只读入参，调用方无需为传参复制数组）。
- **联想接入 REM `crossTopic`（带向量候选去判）+ 两条经验沉淀进 pending（2026-09-13）**
  **① 纪律先行：运行中经验走 `pending/`（不写契约）**，本轮沉两条：
  · `association-vs-retrieval-divide-2026-09-13.md` —— **共词多寡就是联想与检索的分界**：
    共词多 ⇒ 只是"用词像"，检索就能找到；**共词少而语义近 ⇒ 异域同构**，才是联想。
    附分工（向量/大模型/代码各管什么）与"字段相等答模糊问题必露馅"的反例。
  · `fixture-green-vs-real-data-2026-09-13.md` —— **夹具绿 ≠ 真数据绿**：夹具的数据分布由我决定，
    结构性错误在夹具里**不可见**；派生视图/判据类特性**必须拿真数据跑一遍**，且"一眼认得出来吗"是有效验收。
  **② 联想接入深睡 REM**（此前 REM 让 LLM **从零"注意到"**联系；现改为**带着候选去判**）：
  `runDeepSleep` 在 REM 开启时先跑向量候选（`supplyAssociations` → 语义近 + 跨载体 + 词面不重叠），
  作为**新的一段材料**喂给子代理，并明确要求：「成立的写进 `crossTopic` 并说明联系，**不成立就丢弃**——
  **勿为凑数硬报**」。候选为空/向量不可用 ⇒ 照常走（只少这一路输入），**绝不退回结构规则假装生成**。
  **③ 三入口收口为单一实现**（防"同事实多份副本"）：新增 `src/association-supply.ts` 作**IO 组合层**
  （读影子库 → 切节 → 批量嵌入 → 过滤 + 供模型读的文本版式），
  **工具 / 深睡 REM / CLI 三处共用**；`association-propose.ts` 保持**纯函数零 IO**（单测不受影响）。
  **④ 测试**：`test-scheduler-wiring` 32 → **35 条**（⑪ 组合层：切出 2 小节 + 向量不可用 ⇒ 零候选 + 可读 reason）。
  **⑤ 诚实标注**：REM 相**缺省关**（`enableRemPass=false`）⇒ 本轮的接线目前**在环但未激活**；
  开启后即生效。开启与否属运行策略，需证据或用户拍板，**本轮不擅自开**。
- **联想通路首次端到端走通（向量候选 → 模型裁决 → 落环可核）（2026-09-13）**
  **① 真调工具**：会话内调 `shoucang_associate` ⇒ 90 小节全嵌入，返回 **2 条候选**（与 CLI 输出一致 ⇒
  两个入口同一实现、无漂移）。
  **② 模型裁决（这是通路的后半段，也是本能力真正的价值所在）**：
  · **候选 1 判成立** —— `notes/flows.md §职责边界`（**规则的定义**：什么该进长期记忆、什么归宿主）
    ↔ `notes/user.md §习惯-记忆质量审查`（**用户会审这件事**）。**不是同义重复，而是同一约束的两端：
    规则 ↔ 它的外部审查者**；它回答了一个"为什么"——**职责门为什么是硬要求**（因为用户会审）。
  · **候选 2 判不落环** —— 两条都是"provider/模型不在内置目录 ⇒ 被静默拒绝或元数据不可信"，
    是**同一故障族的两个症状面**；且**共词 2（provider/settings.yaml）说明词面本就相关**
    ⇒ 按判据（共词多 ⇒ 更像**检索**而非联想），**价值低**。
  **③ 落环（只落判成立的那一条）**：`association:1c6flkt`，带**语境**（做联想能力时跨载体复核）、
  **洞见**（规则与外部审查者是同一约束的两端）、**证据**（0.731 · 共词仅 `agent` ⇒ 异域同构而非用词相近）。
  **④ 三级验证**：`--collisions` 列它（已认可）· `/rings` 联想环 `collisions 2 · accepted 2 · pending 1` ·
  **事件流** `#12 collision.record` + `#13 collision.accept`（seq 递增、可重放）。
  **⑤ 意义**：「**向量做候选 · 模型做裁决 · 环做记账**」这条分工第一次**跑通并留下可核产物**——
  对照此前纯结构规则在同一批数据上产出的 224 条"相斥"噪声。
- **联想接进运行态：`shoucang_associate` 工具（向量候选 → 模型裁决）（2026-09-13）**
  **① 关键判断（决定接法）**：LLM 精判阶段的宿主**不必另建**——宿主里本就跑着一个云端大模型
  （**就是对话中的模型**）。故正确接法是：**插件暴露"向量候选"工具，由模型在环内判断**。
  这既符合「哪个更合适用哪个」，又**不必造子代理派发**（`ctx.llm` 是宿主服务，而工具**已经运行在宿主里**）。
  **② 落地**：新工具 `shoucang_associate`（参数 `minSim` / `maxShared` / `topN`）：
  读影子库 → `sectionsOf` 切节 → `embedMany` 全量嵌入 → `proposeAssociations` 过滤 →
  返回**候选 + 证据**（相似度 / 共词 / 两侧地址），结尾明确请调用方"判断哪几条真成立并说明联系"。
  **③ 诚实降级（针对你指出的失败形态的防线）**：拿不到向量时**如实报"向量不可用"**，
  **绝不退回结构规则假装生成联想**。已钉成断言（`test-scheduler-wiring` ⑩）：关掉 embed 执行该工具
  ⇒ 返回含「向量不可用」且**候选数为零**。
  **④ 工具面变化**：5 → **6** 个工具（`WANT` 同步更新）；`test-scheduler-wiring` 29 → **32 PASS**。
  **⑤ 本轮踩的两个夹具坑（都记）**：① 夹具写到 `MEMORY_ROOT`，而工具读 `memoryLibRoot()`
  ⇒ 报"影子库不可用"；② 夹具**漏了标题行**，而 `sectionsOf` 按标题切节、标题前内容按设计丢弃
  ⇒ 报"未切出小节"。**两次都是夹具不全，不是代码错。**
- **联想生成（向量空间里的"异域同构"）+ 「按适配选模型」落成表（2026-09-13 用户两次点拨）**
  **① 用户点拨**：(a)「**联想**这种能力，用纯代码我觉得基本实现不了」；(b)「以质量为前提，
  **向量模型还是大模型，在每一个地方哪个更合适就用哪个**」。
  **② 先承认现状（不粉饰）**：既有 `association-ring` 只能**记账**——`recordCollision` 的"碰撞"内容是
  **人或模型先想到的**，代码负责去重/跨度门/落地状态/KPI，**它不生成任何联想**。联想 = **生成** = 模糊判断。
  **③ 落地形态：在向量空间找"异域同构"**（新 `src/association-propose.ts` + `scripts/association-propose.mjs`）：
  有价值的联想**不是**"两段话用词像"（那是**检索**，代码强项），而是
  **语义高度相近 · 却来自不同载体 · 且词面几乎不重叠** ⇒ 同一道理出现在两个领域。
  判据三条合取：**跨载体**（同文件内相近是"重复"，不是异域）· **相似 ≥0.72** · **共词 ≤2**（与检索的分界线）。
  职责切分：**向量**算相似（新增 `vec#embedMany` 批量导出，避免 O(n²) 次 IO）· **代码**做过滤/排序/截断（纯函数）·
  **人或模型**复核后才落环（本器**只提议、不擅自落环**）。
  **④ 真库实测（与纯结构规则的对照）**：90 小节全部嵌入，产出 **2 条提议**，且**人一眼认得出来**：
  · `notes/flows.md §职责边界` ↔ `notes/user.md §习惯-记忆质量审查`（相似 0.731 · 共词仅 `agent`）
    = **同一道理的两个面**（agent 记的边界原则 ↔ 用户画像里的审查习惯）；
  · `notes/lessons.md §白名单与链接装配` ↔ `notes/tools.md §模型链路与排障`（0.726 · 共词 2）
    = 同一问题的**排障面与配置面**。
  **对照**：上一版纯结构规则在同一批数据上产出的是 **224 条"相斥"**，里面混着 `[身份] ≠ [硬件]` 这种废话。
  **⑤ 测试**：新 `test-association-propose.mjs` **17 条**（已登记 ⇒ `npm test` 61 → **62**）——
  三条判据的**出现与不出现条件**逐条钉死（同文件不提议 · 共词过多不提议 · 低相似不提议 · 向量缺失如实"未判"不猜）。
  **⑥ 「按适配选模型」落成表**（本轮把选择理由写清，避免以后乱用）：

  | 环节 | 用谁 | 为什么 |
  |---|---|---|
  | 全对粗筛 / 近邻 / 去重 / 候选生成 | **向量** | O(n²) 全扫，便宜、确定、可缓存 |
  | 相似度打分、聚类、跨域"异域同构" | **向量** | 这是度量的活，代码做不了、LLM 做起来贵 |
  | 裁决（"是不是同一断言"）· 生成（"这俩有什么联系"）· 说清理由 | **大模型** | 需常识与推理，且**理由本身才是价值** |
  | 精确匹配 / 结构判定 / 记账 / 门禁 | **代码** | 确定、可单测、零成本 |

  **⑦ 落点约束（诚实标注）**：`distill-llm` 走 **`ctx.llm`（宿主服务）** ⇒ **脚本侧拿不到 LLM，插件运行态拿得到**。
  故**联想的 LLM 精判阶段**（确认+说清"为什么"）应落在**插件内**——既有 REM `crossTopic`（缺省关）正是它的宿主，
  而**本轮的向量候选正是它的输入**（此前是让 LLM 从零"注意到"联系，现在改成"**带着候选去判**"）。
  **该接线列为下一步**（本轮不假装已经接好）。
- **项目级设计原则：「精确检索留代码 · 模糊判断交模型」+ 语义裁决层落地（2026-09-13 用户点拨）**
  **① 点拨（用户）**：本项目与一般项目的区别在于**自带向量模型与云端大模型**——
  凡属**检索判断 / 语义模糊判断**，可用向量与云端模型辅助，**不必完全依赖代码实现**；
  代码的精确检索确实强，但**模糊判断上模型优势很大**。
  **② 我立刻能指认的"用精确规则假装模糊判断"处**：
  · **断言图的"竞争断言"判定**（我前几轮刚写的：用 `pointer` 相等判"同一断言"）；
  · **MCL 熟悉度**（`sim >= 0.58` 硬阈值假装"这任务我熟不熟"）。
  **③ 本轮改造（断言图分层）**：新增 `adjudicateCompeting(groups, sim, opts)` ——
  **代码做粗筛**（精确、廉价、零 IO）· **模型/向量做裁决**（`sim` 由调用方注入，本层仍零 IO）· 分四档：
  `sameClaim`（≥0.90 ⇒ 同一断言的表述差异，可归一）· `differentClaim`（≤0.55 ⇒ 真相斥，需裁决）·
  **`ambiguous`（中间带 ⇒ 本层不判，交模型深判或人工）** · **`unjudged`（向量不可用 ⇒ 与"含糊"分开记**：
  缺仪表 ≠ 判不了）。测试 `test-assertion-graph` 29 → **38 条**。附 CLI `scripts/assertion-graph.mjs --competing`。
  **④ 真数据一跑就露（这轮最有价值的发现）**：拿真库 + 真向量（本地 `bge-m3`）跑，裁决层老实报出
  **相斥 224 · 含糊 816** —— 而里面赫然有 `[身份] ≠ [硬件]`、`[身份] ≠ [偏好]` 这类
  **本来就是不同事实**的对子。**人一眼就知道那不是竞争断言。**
  根因：`competingOf` 按 `pointer` 分组，而**notes 记录的 pointer 是整个文件** ⇒ 分组退化成
  「同文件所有行两两比」。**⇒ 精确键（字段相等）回答不了"是不是同一断言"这个模糊问题。**
  **夹具测试永远发现不了这个**（夹具里 pointer 是我自己造的干净值）——**只有真数据+真模型才暴露**。
  **⑤ 处置（诚实标注，不装作能用）**：`competingOf` 上加**醒目警示**：对 notes 记录**不成立、勿直接消费**；
  仅对"带 § 小节的索引行"有用。**正解 = 候选生成也交给检索**（用现成向量召回取 top-k 近邻，
  代码擅长的精确检索做粗筛，再由模型裁决）——列为**待改造**。
  **⑥ 我自己也踩了两次夹具坑（记下，不遮）**：L2/L4 首版失败是**我的夹具判据写反**；修完又因
  **条件顺序**（含"改写"的对与"不相干"配对先命中高相似）再次分档错。**夹具的 bug 与代码的 bug 要分开归因**。
- **镜像覆盖缺口第二处（distill 的 notes 追加未镜像）· 已修 + 我上一轮的残余说法纠错（2026-09-13）**
  **① 纠错在先**：上一轮我写「面板 / 脚本侧的载体写入仍不经此处 ⇒ 由对账闸兜底」——**这句话是错的**。
  实测：**面板域根本不写载体**（逐个模块扫"写原语 × 载体路径"同现，**零命中**）⇒ 该残余**不存在**。
  教训：**别把"没想到的地方"写成"存在缺口"**——那会让人以为有已知风险，实际是自己没查。
  **② 但顺着这条线查出真缺口（第二处，同一类）**：`distill-write` 的 `appends` 循环写 `notes/*.md`，
  以及索引登记顺带更新 `notes/INDEX.md`——**这两处写完全无人镜像**；原实现只在
  「MEMORY.md 落盘后」与「画像落盘后」两处镜像 ⇒ `storeMode=dual` 下**最常见的 notes 追加**会让影子库失步，
  下一次对账必红（红得对，但那是**覆盖不全**，不是记录坏了）。
  **③ 修法（与深睡同一形状）**：route=memory 一趟**写入结束处**统一 `mirrorAll(root, at, carrierFiles(root))`；
  **保留**原有两处窄镜像（**中途中止时的部分覆盖**），并在注释写明为何保留。
  **④ 同时清掉一条化石**：`distill.ts` 有一条**死导入**（`applyTreeOps, applyForgetOps, sectionExists, type TreeOp`
  四个符号全未使用）——它是"本模块曾调用 treeops、后来路径迁走"的遗迹，留着会让人误以为 distill 也做结构操作。
  **⑤ 两处同类缺口的共同根因**：镜像**是写入点自愿调用**的（opt-in）⇒ 新增写入者必然有人忘。
  **根治就是 M4 的单一写入收口**；在那之前，"dual = 写入即镜像"靠**逐处补钩 + 对账闸兜底**。
  **⑥ 验证**：`typecheck`/`build`/`npm test` 全绿（61 pass）· 已部署并热重载 · 对账闸 `PASS`。
  生产自证样本仍为 **11（全 CLI 导入）**——`dual` 开启后**尚无真实写入**发生（这本身是下一轮要看的信号）。
- **开 dual 后发现的镜像**覆盖缺口**：深睡写入不进影子库（已修）+ 一次自我纠错（2026-09-13）**
  **① 触发**：核生产自证时发现 md 在 18:17（本地）被改过，而计数仍停在 11 ⇒ 顺着查"谁写的、有没有镜像"。
  **② 我先犯了一次误判，必须记**：那次的 `lastAt` 是 **UTC**（`14:29Z` = 本地 22:29），
  而 md 的 18:17 是**本地**时间 ⇒ 那笔写入发生在**我开 `dual` 之前**，**没镜像是正常的**。
  我一度据此推断"深睡写不镜像"，**该推断当时不成立**——教训：**跨时区的时间戳不能直接比大小**。
  **③ 但结构性问题成立（由代码判定，不靠时间）**：镜像钩子原只有 `distill-write.ts` **两处**调用；而
  **深睡的载体写入在 `deepsleep-apply.ts` 里直接 `writeFileSync` + `renameSync`**（AGENT/USER/MEMORY），
  `treeops` 同 ⇒ `storeMode=dual` 下这些写入**不进影子库**，且"**写入即镜像**"的承诺**只对 distill 成立**。
  后果具体：下一次对账闸会红（`check-record-parity` 对账 FAIL）——**红得对**，但那是"覆盖不全"，不是"记录坏了"。
  **④ 修法（单点覆盖整轮，不在 N 处散点补钩）**：`runDeepSleep` 在**整轮写入结束后**判断
  `config.storeMode === 'dual'` ⇒ `mirrorAll(root, at, carrierFiles(root))` **整体镜像一次**。
  为什么放这里：深睡的写入点分散（apply / treeops / forget），逐个补钩子必然有人忘；
  而**深睡频率是分钟级，整轮全量镜像代价可接受**。
  **⑤ 显式记下残余（不假装覆盖全了）**：**面板 / 脚本侧的载体写入**仍不经此处 ⇒ 由**对账闸兜底发现**。
  真正的根治是 M4 的**单一写入收口**；在此之前，"dual = 写入即镜像"只对 distill 与深睡成立。
  **⑥ 验证**：`typecheck`/`build`/`npm test` 全绿（61 pass）· 已部署并热重载 · 对账闸 `PASS`。
  生产样本仍为 11（全 CLI）——**下一轮真实写入起**才是生产证据。
- **M3+ 开 `storeMode=dual`（生产自证开始累积）+ 修掉「第二通道绕过校验」（2026-09-13）**
  **① 本轮真发现：M1 的守卫可被绕过。** 配置有**两条通道**——schema 与自持文件 `~/.dsh/suite/scheduler.json`。
  后者原为**无校验裸合并**（`(config as any)[k] = v`）⇒ 写 `{"storeMode":"record"}` 就能**绕过**上一轮刚加的枚举守卫
  （`record` 未实现 ⇒ `mirrorShadow` 不动作 ⇒ **死开关复活**）；且**任意键、任意类型**都能塞进 config
  （`{"deepSleepIdleMs":"abc"}` 照收）——**schema 是声明，合并却不过它**。
  **② 修法（防御式，不依赖库的具体表现）**：**键白名单从 schema 自身派生**（`Object.keys(Config({}))`，
  不手抄第二份名单）+ **逐键过 schema 校验**；非法键/值 ⇒ **忽略并记 warn**（不注入）。
  这样无论 schemastery 对非法输入是抛、是穿透还是丢弃，**都不会有未校验值进入 config**。
  （我本想先探明其行为，但探针受 ESM 依赖解析所限跑不起来——**故改成不依赖该行为的设计**，这反而更稳。）
  **③ 回归测试**：`test-scheduler-wiring` ⑧ → 新增 ⑨（**27 PASS**）——写一份**含毒** scheduler.json
  （`storeMode:'record'` + 未知键 + 错类型 + 一个合法键）后断言：非法值**被忽略**、未知键**未注入**、
  类型错**未注入**、**合法键仍然生效**（守卫不是一刀切禁用文件通道）、非法值**有日志留痕**。
  **④ 开 `dual`（本轮目标）**：`scheduler.json` 增量置 `storeMode:'dual'`（先备份 `.bak-dual-*`）→ 热重载。
  语义：**md 仍是事实源**，每次 md 写入后镜像进影子库并**逐字节对账**，结果累加进 `shadow-stats.json`
  ⇒ M4/M5 的**生产证据**从此开始积累。**一行回滚**：`storeMode:'md'`。
  **⑤ 真机确认**：门禁同源读到 `storeMode=dual` · 往返/对账仍全绿 · `/suite` `/distill/config` 200 ·
  当前自证 `镜像 11 · 可还原 11 · 分歧 0`（这 11 次仍是 CLI 导入；**下一次真实记忆写入起**才是生产样本）。
- **M3 落地：影子写时自证（落盘计数 + 分歧即切源门）（2026-09-13）**
  **① 补的是什么**：①②（往返闸 / 对账闸）证明的是「**此刻**能否还原」；M3 回答的是
  「**生产里到底分歧过没有**」——而内存计数随进程消失，故必须**落盘**。
  **② 实现**（`record-shadow.ts`）：新 `SHADOW_STATS_FILE = shadow-stats.json` ·
  `shadowStatsPath` / `readShadowStats` / `bumpShadowStats`；`mirrorFile` 每次镜像后累加
  `writes / verified / diverged`，并留痕 `lastAt/lastFile` 与 **`lastDivergedAt/lastDivergedFile`**。
  仪表纪律：读损坏 ⇒ 全零 · 累加失败 ⇒ 静默（**它只是仪表，坏了不该拖垮主链路**）。
  **③ 接上放行门**：`check-record-parity` 新增 ③ 段读计数并打印；
  **`diverged > 0` ⇒ FAIL**，判词写明「**分歧未清零前不得切源**」——这就是 M4/M5 的**运行态依据**。
  **④ 测试**：`test-record-store` 86 → **96 条**（K 组 10 条）：真实镜像 ⇒ `writes/verified` 各 +1 ·
  人为造分歧 ⇒ `diverged` 可数且**留痕**（未分歧时留痕为空，不误留痕）· 计数文件损坏 ⇒ 全零不崩 ·
  **notes 载体走同一条自证路径**。
  **⑤ 真机证据**：真库镜像 **11 次 · 可还原 11 · 分歧 0**（末次 `notes/user.md`），落盘
  `.records/shadow-stats.json`；门禁读数与文件内容一致。
- **M2 落地：行寻址 `(file, order)`（重复行可准确定位）+ 补上 notes 记录的主体缺口（2026-09-13）**
  **① 为什么必须有 M2**：`MemRecord.id = subject:kind:fingerprint(text)` 是**内容指纹**，不是行号 ⇒
  **内容相同的行共享 id**。真库实测：**976 条 → 8 个 id 碰撞组 · 涉及 153 行**（最大一组 106 行空行）。
  ⇒ 任何"按 id 找到那行再改"的逻辑在重复行上会**改错行/只改第一条/删错行**，而投影要求行数一份不少。
  **② 新件 `src/record-address.ts`**（寻址面独立成模块——`record-store` 导出已 34/35，加在此处会顶到棘轮）：
  `lineKeyOf`（行地址 = `file\0order`）· `linesOf`（按 order 升序、**不去重**）· `atLine`（按地址精确命中）·
  `setLineText`（纯函数改一行：**内容派生字段随文本重算 · 状态字段一律承接**）· `idCollisions`（把重复行变成**可数**数字）。
  **③ 测试**：`test-record-store` 67 → **86 条**（新增 J 组 19 条）。核心是 **J8：相邻两行完全相同，改第 3 行时第 2 行原样**
  —— 这正是 `id` 定位做不到的事；另验 J11 投影只差一行 · J14/J15 状态承接（hits/maturity/lifecycle/meta 不被清零）·
  J12 id 随内容重算而**行地址不变**。
  **④ 真库实测**：按行地址定位 `notes/INDEX.md:3` **精确命中第 2 条空行**（id 相同也能分开）。
  **⑤ 顺带补上我上轮引入的质量缺口**：notes 记录化后 789 条的 `subject` 全是 **`unknown`**——而 `unknown`
  **不是合法主体**（`isValidSubject` 判否）。现按**所属画像**给出**规则**（非逐文件枚举，未来新 notes 自动覆盖）：
  `notes/user.md → user` · `notes/agent.md → agent` · 其余 notes → `knowledge`。
  修后：**agent 76 · user 119 · knowledge 781 · 非法主体 0**，对账仍**逐字节 PASS**。
- **`storeMode=record` 迁移 + 回滚路径（兑现承诺）+ 修掉一处真存在的死开关（2026-09-13）**
  **① 纠正我上一轮的表述**：`record` 档**尚未实现** —— 切源不是"翻开关"，是**一次功能开发**。
  **② 修掉一处真缺陷（注释声称的约束没落实）**：`storeMode` 的注释**声称**"只接受 md|dual——避免死开关"，
  实现却是 **`z.string()`（什么都收）**：设 `record` 不报错、只**静默无动作**
  （`mirrorShadow` 仅在 `=== 'dual'` 时动作）⇒ **注释声称要防的死开关，其实已经存在**。
  现改为枚举（`z.union([z.const('md'), z.const('dual')])`），非法值**当场抛**
  （实测 `expected "md" | "dual" but got "record"`），并钉成断言（`test-scheduler-wiring` ⑧ ⇒ 22 PASS）。
  **教训：注释里的约束不算约束，代码里的才算。**
  **③ 迁移路径落档**（每步可验证、可停）：M0 前置（✅ 投影无损双向 · 11 载体逐字节）→ M1 死开关守卫（✅ 本轮）
  → M2 **定位键** `id` → **`(file, order)`**（因 976 行仅 831 唯一 id，重复行无法按 id 定位）
  → M3 影子自证仪表（写入后断言可还原 + 计数）→ M4 **写入路径 record-first**（改造点两处：
  `src/distill-write.ts` + `skill/scripts/memory-append.mjs`；md 转为只读派生输出）→ M5 切换。
  **④ 回滚路径（为什么安全）**：**一行回滚** `storeMode:'md'` —— M4 只换"谁先写"，**md 一直是每次写入的产物**
  ⇒ **不需要数据迁移回滚**；影子库是派生品，随时可由 md 重建（`record-sync --import`，已有备份惯例）。
  检测器：`check-record-parity`（往返/对账/就绪度）· `check-installed-features`（31 标记）· 记忆写入门。
  **明确不做**：不删 md · 不把 md 设只读 · 不动 `_memory/`。
- **切源唯一前置达成：`notes/*.md` 记录化（影子库 187 → 976 条 · 详情载体 0/8 → 8/8）（2026-09-13）**
  **① 先实证后落地**：动手前先跑一个实验——既有 `parseRecords` + `renderFile` 对 8 个 notes 文件是否本就往返无损？
  **结果：全部逐字节一致**（789 行）。⇒ 这件事**几乎免费**，只需把**载体面显式列全**，不需要新解析/渲染逻辑。
  **② 载体面显式列全**：新增 `record-shadow#carrierFiles(root)`（索引三件 + `notes/*.md`），
  由**镜像 / 对账 / 就绪度**三处共用（单一实现，不各写一份文件清单）。
  **③ 导入结果**：`record-sync --import`（先备份影子库 → `records.jsonl.bak-noteimport-*`）⇒
  影子库 **187 → 976 条**（notes 789 条）；kind `structure:138 blank:135 fact:240 persona:25 prose:425
  procedure:5 decision:1 outcome:1 valence:1 relation:1 commitment:3 association:1`。
  **④ 验证（对账闸扩到全载体）**：`check-record-parity` 的**往返闸 + 对账闸**现覆盖 **11 个载体**
  （索引 3 + notes 8），**全部逐字节一致** ⇒ `PASS（事实源切换前置条件成立）`。
  就绪度：**索引载体 3/3 · 17171/17171B** ｜ **详情载体 8/8 · 94679/94679B**（此前 0/8）。
  **⑤ 断言图在新库上的实测**：**831 记录 + 31 锚 · 136 边** · 竞争组 6 · **引用完整性 0 悬空**。
  **⑥ 模型事实（对切源有约束力，必须记）**：976 行 → **831 个唯一 id（145 重复）**，
  重复几乎全部来自**空行/完全相同的行**——`id = 内容指纹` 对重复行**天然不唯一**。
  ⇒ **切源后定位必须用 `(file, order)`，不得用 `id` 当主键**（否则重复行会互相干扰，增删改会错行）。
  md 投影本身不受影响（`renderFile` 不去重 ⇒ 对账仍逐字节一致）。
  **⑦ 就绪度分类被我自己改坏又修回**：扩载体后 `--coverage` 把全清单当"索引"（报出 **19/19** 的荒谬数字）
  ⇒ 分类改回按 `INDEX_FILES` 判定。**又一次证明：口径错了数字会自己变得很好看。**
  **⑧ `storeMode=record` 仍未翻**：前置条件**已不再是覆盖率**，而只剩**迁移 + 回滚路径**——
  这正是我此前记下的承诺（切前先出迁移与回滚）。**下一步先写这份路径，再谈翻开关**。
- **G0 断言图内核（拍板「合并」路线）+ `storeMode=record` 切源决策（2026-09-13）**
  **① 用户拍板**：SQLite 断言内核 → **合并**（不并存）；`storeMode=record` → **合并**；并授权
  「以项目质量为准自行决定切源时机」。
  **② 断言图内核落地（不新开第二个库）**：新 `src/assertion-graph.ts` —— 断言图**建在既有 Record 事实源之上**，
  零 IO、零存储，**关系本来就是记录里写着的字段**：
  `answers`（`outcome.meta.decisionId` 后果回收）· `collision`（`association.meta.a/b` + `landed`）·
  `commitment` / `relation`（`meta.who/direction/status/level`）· `points-to`（`pointer` 证据锚）·
  `provenance`（`source`）· `supersede`（`validTo` + 同 kind+subject 的时态谱系）。
  另附 `neighborsOf`（两个方向的邻域）· `competingOf`（**竞争断言组**：同 `pointer` 上 ≥2 条活跃且文本不同
  ⇒ 需裁决）+ `graphCensus`（KPI）。
  **③ 为何"合并"是对的（架构级）**：本仓已有单一事实源（`records.jsonl` + 可重放的 `ring-events.jsonl`）。
  再加一个 SQLite 库 = **同一事实两份权威**，必然漂移 —— 仓内已在别处反复吃过（惰性桥 6 处副本 ·
  信封写法 6 处副本 · 三处版本记录各说各话）。**断言图的价值在关系，而关系本来就在记录字段里**。
  **④ 测试**：新 `scripts/test-assertion-graph.mjs` **29 条**（已登记）——每条边的**出现与不出现条件**都钉死
  （如"跨 kind 不连替代边""同文不算竞争"），并对**真库**做**引用完整性**检查。
  **⑤ 真库实测**：**161 记录 + 31 锚 · 136 边**（answers 1 · collision 2 · commitment 3 · relation 1 ·
  pointsTo 91 · provenance 38）· 竞争断言组 **6** · 引用完整性 **0 悬空**。
  **⑥ `storeMode=record` 决策：本轮不翻**（我以项目质量为准的判断）。依据是量出来的就绪度：
  · **索引载体 3/3 有记录表示**（17171/17171B）且 `records → md` **逐字节一致**（`check-record-parity --coverage`）；
  · **详情载体 0/8**（0/94679B）—— `notes/*.md` 在 Record 里**根本没有表示**。
  ⇒ 现在切源 = 「索引由 Record 权威 + 详情由 md 权威」的**双权威**，正是"合并"要消除的东西。
  **前置条件具体化**：先把 `notes/*.md` 按 `### §` **小节记录化**，再用往返闸逐字节证明，才可切。
  **⑦ 自我纠正（两处，都必须记）**：
  · 我新建的 `check-record-projection.mjs` 与既有 `check-record-parity` ① **往返闸重复** —— 按「单一实现」
    纪律**删掉新件**，只把**新的**「切源就绪度」并入既有门禁；
  · 该就绪度**首版口径错**：把**技能自身文档**（spec 49KB · CHANGELOG 30KB · README…）当成"记忆载体"，
    算出误导性的 7.2%。现按 **索引 / 详情 / 技能资产（排除）** 三类分开，技能资产**明确不计入**。
  **⑧ 运行态发现（重要运维事实）**：部署时出现异常数字（新增 46）——查明为**安装副本曾被宿主重新物化回退**
  到**已提交版本**（profile 依赖指向 git 提交，而本会话改动**未提交**），故旧代 lib 连同**三条退役桥的产物**
  一起回来了。已按**精确文件名**（不用通配符——§33 的教训）清掉那 9 件 stale 产物；
  现安装副本 **170/170 逐件一致 · 仅已安装 0**，特性探针 **31 项齐全**、**桥退役不变量 ✅**。
  ⇒ **风险提示**：只要改动未提交，宿主任何一次重新物化都会把"装上去的那份"退回旧代；
    检测器就是 `check-installed-features`（31 项标记 + 桥不变量），**修复动作 = 重跑部署 + 复验**。
  **⑨ 记录模型边界（真库线索）**：真库 187 行只有 **161 个唯一 id** —— 28 行重复来自 `kind=blank`
  的空行记录（`user:blank:45h ×18` / `agent:blank:45h ×10`）。**空内容指纹必然碰撞**（无害，但说明
  "id = 内容指纹"对空内容不唯一）；断言图按 id 去重，故不受影响。
- **DS4 合并第四刀：`episodes` 并入 `ledger`（事件流 7 → 6）+ 落地「按 type 裁剪」机制（2026-09-13）**
  **① 前置机制先落地（上轮拦下的障碍）**：`episodes` 的保留期裁剪原本是「读**自己那个文件**全部行 → 重写保留末 N 行」，
  并进共享台账后会**截断整个 ledger**。故本轮先做 `src/ledger-compact.ts`：
  · `planCompaction(lines, type, keepLast, slack)` —— **纯决策函数**（可单测，不必真写文件）；
  · **只删同 type 的最旧行**，其他 type **原样保留、顺序不变**（这是本机制存在的全部理由）；
  · **余量 slack**：超 `keepLast + slack` 才动手（裁剪要重写整文件，不能每追加一行就重写一次）；
  · **原子替换**：备份 `.bak-compact-<ts>` → 同目录 tmp → `renameSync`（与仓内 `test-atomic-write` 同纪律）；
  · **坏行不可裁**（解析失败的行一律保留 —— 不因裁剪丢证据）。
  **② 再用它并 `episodes`**：`distill-paths` 的 `episodeFile` 落点改指 `ledger.jsonl`；
  `recordEpisode` 写入后调 `compactFile(…, 'episode', EPISODE_CAP, 8)`；棘轮事件流 **7 → 6**。
  **③ 测试**：新 `scripts/test-ledger-compact.mjs` **21 条**（已登记入 `CHECKS`）—— A 组纯决策
  （其他 type 一条不少 + 顺序不变 + 留最新）· B 组阈值（未超绝不动手）· C 组边界（空文件 / 零条 /
  **坏行保留** / `keepLast=0` / 非法值防御）· D 组真文件（**其他 type 行数不变** · 总行数 5→3 · 有备份 ·
  无 tmp 残留 · 余量内 noop · 缺文件 missing）。⇒ 把「**删错了不会有人报错**」变成 21 条会响的断言。
  **④ 残余风险（诚实记录）**：重写窗口内其他写入者的 append 可能丢失。缓解：只在超阈值时触发（低频）·
  台账本就是 best-effort（各写入点 catch 静默）。与原 `episodes` 裁剪**同一量级**，**不构成回归**。
- **DS4 合并第三刀：`stub.jsonl` 并入 `ledger.jsonl`（事件流 8 → 7）（2026-09-13）**
  **① 为何选它（而不是更"零消费方"的 `episodes`）**：侦察发现 `episodes.jsonl` 虽也**零代码消费者**，但它带
  **`EPISODE_CAP` 裁剪**（读全文件 → 重写保留末 N 行）。并进共享台账后，那段裁剪会**截断整个 ledger**
  —— 这是**真障碍**，须先有「按 `type` 裁剪」机制，**故不在本轮并**（留作显式待办）。
  `stub` 无裁剪、无保留期，且**代码侧零读取者**（只有 `audit-protocol.md` 的抽验规程引用路径）⇒ 干净。
  **② 改法**：`recordStub` 改投 `ledger.jsonl`（`type=stub`，走统一信封）；**两份审计规程**同步改口径
  （`audit-protocol.md` + `skill/audit-protocol.md`：第 3 问改指「`ledger.jsonl` 中 `type=stub` 的行」，
  第 5 问由「raw-stub 存根抽验」改为「**裁决存根抽验**」）。
  **③ 棘轮**：事件流 **8 → 7**；`stub.jsonl` 转 legacy 只读豁免。
  **④ 验证**：`test-event-envelope` 21 → **22 条** —— 新增两条断言：`**存根已并入台账** type=stub`
  与 `**不再单开 raw-stub/stub.jsonl**`（后者才是"合并的实质"：证明旧落点真的空了，不只是多写一处）。
  **⑤ 过程留痕（我的一次低级错）**：改注册表时**多留了一个 `]`**（数组提前闭合，后续条目变成游离表达式）
  ⇒ `check-observability` 直接 `SyntaxError: Invalid destructuring assignment target` **崩溃**。
  按纪律**先直跑取原始报错**（不猜），读到行号后一眼定位。⇒ 教训：**删/改数组末条时，必须复核括号配对**。
- **DS4 口径修正：注册表分「事件流 / 状态表」两家族（事件流 → **8**，目标 1）（2026-09-13）**
  **① 触发**：准备并第三条流（`archive-progress`）时发现——它由 `archive-lib.upsertMark` **按 sessionId upsert**
  （每会话仅最后一条有效），**不是 append-only 事件流**；把它追加进共享台账会**破坏其语义**。
  **② 按源码核清三条的写入语义**（不靠印象）：
  · `activity.jsonl` —— `activity.ts` **原子替换整表** ⇒ 状态表
  · `archive-progress.jsonl` —— `upsertMark` **按 key upsert** ⇒ 状态表
  · `maturation.jsonl` —— `maturation-scan` **每次扫描覆盖写** ⇒ 状态表
  **③ 口径落成注册表字段**：每项标 `event` / `state`；**棘轮只对事件流计数**（目标 1）；状态表单列并注明
  「**投影**：可重建、不参与『合并为单一事件源』」——这恰是 DS4 原话「其余降为**投影**」的兑现。
  **④ 修正后的诚实数字**：**事件流 8**（`mcl-audit` · `distill-audit` · **`ledger`（主干）** · `episodes` ·
  `access-real` · `distill-watermark` · `ring-events` · `stub`）· **状态表/投影 3**。
  ⚠ **8 与方案档原话「现有 8 个 jsonl」精确吻合** —— 此前把状态表一并算成 13，是**两个家族混算**。
  **⑤ 意义**：棘轮的数字第一次**只对"能合并的东西"计数**；否则拆到那三条状态表时会陷入
  「并进去就坏语义」的死路——而 DS4 对它们的要求本来就是"降为投影"，**已然成立**。
  **⑥ 验证**：门禁打印 `✅ 事件流 8（= 基线；DS4 目标 1）· 状态表/投影 3`；形态审计按家族分组；
  `--selftest` 仍绿；未登记流的 src/scripts 分档判据不变。
- **DS4 合并第二刀：`activation-shadow.jsonl` 并入 `ledger.jsonl`（12 → 11）（2026-09-13）**
  **① 消费者侦察结论更好**：全仓搜 `activation-shadow` ⇒ **代码侧零读取者**（只有写入者 `distill-activation.ts`
  + 文档；`activation-calib.mjs` 是**从转录重采样**、并不读本文件）⇒ **本刀无需改任何消费方**。
  **② 改法**：`distill.ts` 的 `actShadowFile` 落点改指 `ledger.jsonl`；`distill-activation.ts` 的写入改走
  统一信封（`type: 'activation.shadow'`）。
  **③ 棘轮**：12 → **11**（`activation-shadow.jsonl` 转 legacy 只读豁免，理由写明）。
  **④ 验证**：`test-event-envelope` 18 → **21 条** —— 新 F 组用**真写入器** `createActApi().activationStep(...)`
  验证落点带 `type=activation.shadow` + 非空 `at` + 既有字段（`kind`/`src`）保真；**legacy 已冻结**
  （84.2KB · 末次写入 20:18，改动之后无新写入）。
  **⑤ 运行态佐证（`ledger.jsonl` 现有类型分布）**：`decision.ingest 142` · `write.ingest 106` · `check.sleep 74` ·
  `decision.consolidate 11` · **`score.shadow 8`（第一刀的活体行）** · `write.consolidate 8`；
  `activation.shadow` 待下一个用户回合产生（该流由 `user/message` 触发）。
  ⇒ **统一台账正在成形**：单一文件 + `type` 判别 + 各消费方按 `type` 过滤。
- **DS4 合并第一刀（真合并）：`score-shadow.jsonl` 并入 `ledger.jsonl`（13 → 12）（2026-09-13）**
  **① 消费者侦察先行**（改消费方前的必要动作）：全仓搜 `score-shadow` ⇒ **代码侧只有 1 个读取者**
  （`memory-reconcile.mjs` 的 ⑤ 段），其余全是文档引用。并核了**另一个台账消费方** `criteria-audit.mjs`：
  它按 `type.startsWith('decision')` 过滤 ⇒ 塞入 `score.shadow` 行**不影响它**（无需改动）。
  **② 改法**：`vec.ts` 的影子写入改投 `ledger.jsonl`（`type: 'score.shadow'`，走统一信封）；
  `memory-reconcile` ⑤ 段改读「**legacy 文件（历史批次）∪ ledger 的 score.shadow**」两处合并
  ⇒ **历史不丢、新数据同源**。
  **③ 棘轮收紧**：观测流 **13 → 12**（`score-shadow.jsonl` 转为 **legacy 只读**豁免项，理由写明）。
  **④ 验证三件**：
  · **前后对拍**（改消费方的纪律）：`memory-reconcile` ⑤ 段**逐字等于基线** —— `409 行 / 1783 样本 · corr=0.021`；
  · **写入侧实证**：跑 `activation-calib --n 1`（**带 embed** ⇒ 走稠密/融合分支）⇒ ledger **340 → 348 行**，
    末行 `type=score.shadow mode=legacy top=5` ✓；
  · **legacy 不再增长**：`score-shadow.jsonl` 保持 148.8KB、末次写入 20:18（改动之后无新写入）。
  **⑤ 附带发现**：`--no-embed` 时 `recallRanked` 走**词法早退**，根本到不了影子分支 ⇒ 首次"用 CLI 造样本"
  失败（ledger 行数未变）是**预期行为**，不是写入坏了。这条同时解释了：该路径的影子数据**只在嵌入可用时产生**。
  **⑥ 另一处「仓内绿 ≠ 运行态绿」被门禁抓住**：`check-deploy-sync` 报 `scripts/memory-reconcile.mjs`
  **仓内与库内不一致** —— 该脚本**在记忆库里有部署副本**（面板 `/reconcile` 跑的是库内那份），
  我只改了仓内 ⇒ 库内仍是旧逻辑。备份后部署，**库内副本实跑**验证：`⑤ 影子打分: **417 行 / 1815 样本**`
  （= legacy 409 + ledger 新增 8）⇒ **合并读取在运行态真的生效**；复查部署面 **不一致 0**。
- **DS4 形态统一第三刀：水位流补判别字段 + 一处口径误判的修正（2026-09-13）**
  **① 核实**：上轮信封改造后 `episodes`（走 `recordEpisode`）**已自动获得** `type: 'episode'` ⇒
  `--shape` 报的「需改造 3」里 `episodes` 属**历史数据尚未更新**，不是没修。真正剩下的是 **`distill-watermark`**。
  **② 补 `type: 'watermark'`**（写入器一处追加），并**显式留痕一处刻意不做的偏离**：`sessionId` → `sid` **不改**
  —— 读侧 `readWatermarks` 与 **G-20 双证守卫**都按 `sessionId` 取键；为一次形态对齐去动**水位守卫**的读链，
  风险与收益不成比例（合并时做字段映射即可）。
  **③ 验证**（`test-event-envelope` 13 → **18 条**）：新 E 组用**真写入器**（不是 fake）验证 ——
  `type=watermark` · 非空 `at` · `sessionId/lastSeq` 原样 · **`readWatermarks` 仍按 sessionId 取得到**（读侧未受影响）。
  **④ 我的门禁抓到了我的测试（口径误判，当场改准）**：`check-observability` 把测试夹具名 `wm.jsonl`
  判成"未登记观测流"——**门禁没错，是口径过宽**。观测流的定义是「**运行时（src）写出**的 append-only 流」，
  而 `scripts/` 里多为消费者/夹具 ⇒ 现**分档**：**src 未登记 ⇒ FAIL** · **scripts 未登记 ⇒ 只报 ⚠**（附指引）。
  已双向证伪（在 `src` 造未登记流 ⇒ FAIL；`scripts` 里的夹具 ⇒ 仅提示）。
  **⑤ 形态审计补口径注**：该表读**历史数据**，代码侧修复只对**之后**的写入生效 ⇒
  「需改造」计数会随新数据自然下降，不是没修。
- **DS4 形态统一第二刀：统一事件信封收敛为单一实现（6 处副本 → 1）（2026-09-13）**
  **① 副本真相**：原始写法 `JSON.stringify({ at: new Date().toISOString(), ...o })` 在 src 里出现
  **6 处 / 5 个模块**（`distill-infra` ×4 · `mcl` · `deepsleep-tree` · `treeops` ×2 · `vec`）——
  上轮只修了 `distill-infra` 的四条路径，本轮把**其余副本全部收敛**到新件 `src/event-envelope.ts`
  （各处以 `envelopeEvent as envelope` 别名导入 ⇒ **零调用点改动**）。
  **② 一次拿三样**：
  · **修根因** —— `at` 不再可能被调用方用 `undefined` 覆盖后静默丢弃；
  · **补判别字段** —— `mcl-audit` 得 `mcl.<kind>` · 归档流得 `archive.<op|action|kind>` ·
    `score-shadow` 得 `score.shadow` ⇒ **DS4 形态统一再推进 3 条**；
  · **消副本** —— 同一事实从 6 份变 1 份（本项目一贯在剿的形态）。
  **③ 新不变量（已反向证伪）**：`check-observability` 断言**源码中不再出现原始写法**——
  在 `scripts/` 造回一行 ⇒ FAIL；删除 ⇒ 复绿。
  **④ 过程留痕（我的一次错）**：收敛 `deepsleep-tree.ts` 时把锚点选成 `import { join } from 'node:path'`
  并整行替换，**顺手删掉了 `join` 的导入** ⇒ typecheck 立刻报 8 处 `Cannot find name 'join'`，当场修回。
  ⇒ **教训：替换 import 行时，锚点必须是"要加的那一行"，不能拿"相邻行"当锚点**；
  这次是类型系统兜住的——若被删的是无类型引用的东西，就不会这么响。
- **DS4 形态统一第一刀：统一事件信封（修掉致 `at` 缺失的静默缺陷）+ 形态审计（2026-09-13）**
  **① 根因级修复**：审计写入器写的是 `{ at: new Date().toISOString(), ...o }` —— **展开顺序允许调用方用
  `at: undefined` 把注入的时间戳覆盖掉**，而 `JSON.stringify` **静默丢弃 undefined 键** ⇒ 产出的行没有 `at`。
  实测证据：`check-observability --shape` 读出 `distill-audit` **930 行里有 1 行缺 `at`** ——
  **不是漏写，是被覆盖后丢弃**（不报错、不抛异常）。
  修法：新增 `envelope(o, defaultType)` —— 把 `at` 与 `type` 放在**展开之后**并做有效性兜底
  （调用方给的**合法**值仍被尊重）；四条写出路径（`audit` / `recordEpisode` / `recordStub` / `ledger`）
  全部改用它 ⇒ 结构字段**调用方弄不没**。
  **② 顺带统一判别字段**：四条流此前**只有 `ledger` 有 `type`** ⇒ 现在全都有
  （`audit.<kind>` / `episode` / `stub` / `ledger.type`）——**DS4 合并的形态前提一次推进 4 条**。
  **③ 新件 `check-observability --shape`（形态审计，报告态）**：读**真实数据**给逐流表
  （时间字段 / 判别字段 / 会话键 + 解析失败行数），把「13 条并成 1 条」从大工程拆成**可数改造项**。
  实测：**可并入 4 · 需改造 3 · 无数据 6**——需改造的是 `distill-audit`（1 行缺 `at` + 仅 850/930 有 `sid`）·
  `episodes`（无判别字段）· `distill-watermark`（无判别字段且用 `sessionId`）。
  **④ 测试**：新 `scripts/test-event-envelope.mjs` **13 条** —— 核心是**覆盖攻击**
  （传 `at: undefined / null / ''` 后每行仍必须有非空 `at`）+ 四条路径都有 `type` + 全量不变量。
  **⑤ 已知未做（显式）**：`mcl.ts` 的审计钩子**是同一形态的第二个副本**（`{ at, ...o }`），下轮一并收敛。
- **G0 DS4 前置：观测流注册表 + 棘轮（13 条 → 目标 1）（2026-09-13）**
  DS4 要求「**一个** `events.jsonl`，现有 8 个 jsonl 降为**投影**」，但**"现有几个"从来没数过**——
  而没有数字的目标等于没有目标（本项目已三次实证：快通道恒 0 无人知晓 · 惰性桥 6 条边没数过就拆不动 ·
  合规率没有分母就无从放行）。本件把它数出来并**只许减不许增**。
  **① 注册表 13 条（实测）**：`mcl-audit` · `distill-audit` · **`ledger`（DS4 候选主干）** · `score-shadow` ·
  `activation-shadow` · `episodes` · `activity` · `access-real` · `maturation` · `distill-watermark` ·
  `archive-progress` · **`ring-events`（第二个候选主干）** · `stub`（裁决存根）。
  **② 豁免 4 条并写明理由**：`session.jsonl`（宿主转录）· `records.jsonl`（Record **事实源**，非观测）·
  `.vector-cache.jsonl`（**可重建缓存**）· `judgement-ledger.jsonl`（**legacy 只读别名**）。
  **③ 门禁语义**：出现**未登记**的 `.jsonl` 字面量 ⇒ FAIL；登记项在源码里查不到 ⇒ 提示清理（陈旧登记也是漂移）；
  流数 < 基线 ⇒ PASS + 提示收紧基线。配 `--selftest`（6 例）。
  **④ 两个实测坑（都当场修）**：
  · 初版**没剥注释** ⇒ 文档里提到的目标名 `events.jsonl` 被判成"未登记流"——**门禁对文档开火**。
    修法沿用仓内先例（`check-carriers` 的「先剥注释再匹配」）。
  · 首版登记**漏了 `stub.jsonl`**（`distill-infra.ts` 确实在写）——**是扫描把它抓出来的**：
    「登记不全」与「漏网」的区别正在这里 —— **扫描是发现手段，注册表是承担**。
  **⑤ 反向证伪**：在 `scripts/` 造 `brand-new-stream.jsonl` ⇒ FAIL（未登记流）；删除 ⇒ 复绿。
- **部署一致性：已安装副本特性探针补**宿主侧**（15 项新标记 + 桥退役不变量）（2026-09-13）**
  **① 缺口**：`check-installed-features` 原先只认**客户端/契约**产物（S1–S4 · 14 项）⇒ 本会话新增的
  **宿主侧能力**（五环 · 事件流 · composition root · 双时间戳 · 读侧候选集 · P2b 材料块 · `storeMode`）
  **全都查不到** —— 而「文件 sha 一致 ≠ 装上去的那份带着本轮能力」正是本件的立件理由。
  **② 补**：新增 **15 项宿主侧标记**（`rings#RING_OF_KIND` · `decision-ring#scorecardOf` ·
  `relation-ring#trustOf` · `association-ring#associationCensus` · `fact-ring#factCensus` ·
  `ring-events#reconcileRing` · `record-store#validTo` · `record-shadow#saveStoreRecords` ·
  `supply-assembly#buildCandidates` · `composition#createComposition` · `mcl#sysBlockCalls/materialInSystem` ·
  `scheduler#storeMode` · `panel-observe#ringsRoute` · `panel-observe#scheduler.current`）
  + **桥退役不变量**（已安装 lib 中不得有 `-share.js` 引用；与仓内 `check-bridges` **各查一侧**）。
  **③ 实测**：**31 项标记齐全**；**已反向证伪** —— 在安装副本造 `_falsify-probe.js`（引用 `-share.js`）⇒
  该条变 ❌ 且计 1 项缺失；删除 ⇒ 复绿。
- **G4 接线 P2b 开启 + 判据换成「当场可测」（2026-09-13）**
  **① 换判据（本轮核心）**：上轮补了合规率的分母，但它**在真实分布下样本结构性稀疏**——合规判定只落在
  **慢通道后续步**，而多数步是快通道 ⇒ 实测窗口 **0/803**，判据**执行不了**（不是没装仪表盘，是仪表盘没数据）。
  故改为**当场可测**的指标：给 `systemPrompt` 块装**渲染计数**（`sysBlockCalls` / `sysBlockNonEmpty` /
  `sysBlockLastChars`），直接回答 P2b 的实质问题——**"材料有没有真的进注入面"**。
  **② 测试**：`test-mcl.mjs` 32 → **35 条**（F9-F11：块渲染计数在涨 · 带材料次数 · 末次长度 + `materialInSystem=true`）。
  **③ 启用与真机实证**：`scheduler.json` 增量置 `mclMaterialInSystem: true`（备份 `.bak-p2b-on-*`）→ 热重载
  （清缓存 51 模块 · 重建 1 fiber · `client ✓`）⇒ `/mcl/status`：**`materialInSystem=True`（未回落 ⇒ 块已挂）·
  `sysBlockCalls=1`（宿主确实在渲染该块）**；`slow=0 / injected=0`（本轮尚无慢通道材料可放）。
  **④ 一次被打断的重载（留档 + 可复用判据）**：`dev_reload_package` 调用被中断、结果未记录。按规程
  **不盲目重试**，先核外部状态——用本轮新增字段作判别器：`/mcl/status` **含 `sysBlockCalls`** ⇒ 运行态已是新代码
  ⇒ **那次重载实际成功**（中断只在结果记录环节）。**判据**：判断"装上去的是哪一代"，找**只有新代码才有的
  可观测字段**，比读日志可靠。
  **⑤ 纪律留痕**：本轮两条教训按仓内纪律写入 `pending/`（**不直接改契约**）——
  `shared-dir-wildcard-delete-2026-09-13.md`（通配符误删 `panel-shared`）·
  `name-derivation-second-source-2026-09-13.md`（名字推导当第二份事实源 ⇒ 扫描器漏计）。
- **G0 composition root 收尾：`scheduler-share` 退役（桥边 2 → 0）+ 一次真实误删的复盘（2026-09-13）**
  **① 最后一刀**：`SchedulerApi` 接口搬入 `src/composition.ts`；`schedulerShareApiOf` 的返回值以该类型标注
  ⇒ 形状与 root 句柄盒**编译期对齐**（漂移即报错）；scheduler 装 `comp.scheduler.current`；
  `panel-observe` 三个端点（`/suite` · `/llm/models` · `/distill/config`）改读 `d.scheduler.current`；
  删除 `src/scheduler-share.ts`。**三条惰性桥至此全部退役，棘轮基线 1+1 → 0+0**。
  **② 两处安全网按新契约更新**（它们**确实被打破**，正是安全网该做的事）：
  `test-scheduler-wiring.mjs` 由「直连 `scheduler-share` 读 `.api`」改为「建 root 句柄盒 → 传入 →
  断言 `comp.scheduler.current`」（20 PASS）；`test-targets.mjs` 由「断言 panel 源码含 scheduler-share」
  改为「断言 panel 从 `scheduler.current` 取矩阵」+ **「lib 中无任何 `-share.js` 引用」**（60 pass）。
  **③ 真机验证**：热重载后 **7 条路由全 200 且有真实数据** —— `/suite members=1` ·
  `/distill/config active=True 键=10` · `/llm/models models=83`（后两条**只能经装配面到达**；
  桥已不存在而仍通 ⇒ root 链路成立）。
  **④ 复盘：我用通配符删错文件，把重载打坏了（必须记）**
  清理退役桥产物时用了 `Get-ChildItem -Filter "*-share*" | Remove-Item` ⇒ **误匹配 `panel-shared.*`**
  （"panel-**share**d"）——它是 panel / panel-observe 的核心依赖；缺失后热重载报
  `The "type" argument must be of type string. Received an instance of ModuleJob`，**连续两次失败**。
  按 sha 逐件补回后恢复（161/161 一致），重载转为「坏缓存兜底重载完成」。
  **教训**：共享目录内清理**只按本次确定的精确文件名**逐条删、**永不按通配符扫删**——
  这条本就在用户记忆里，我仍然踩了；根因是"名字里含 share 的都该删"这个**想当然的模式**。
- **G0 composition root 第二刀：`deepsleep-share` 退役（桥边 4 → 2）+ `check-srcmap` 反向孤儿检查（2026-09-13）**
  **① `deepSleep` 句柄搬入 root**：`DeepSleepApi`（原 `deepsleep-share.ts` 的接口）迁入 `src/composition.ts`；
  scheduler 装 `comp.deepSleep.current`；`panel-observe` 的 **4 个深睡/蒸馏端点**（`/deepsleep` ·
  `/deepsleep/trigger` · `/distill/run` · `/deepsleep/config`）改读 `d.deepSleep.current`
  （各handler 先取局部 `sleep`，避免属性链窄化歧义）；删除 `src/deepsleep-share.ts`。
  棘轮基线 **2+2 → 1+1**，`RETIRED` 增列（复现即 FAIL）。
  **② 补上轮发现的漏检**（`check-srcmap` **反向**）：`tsc` **不删已删源文件的产物** ⇒ 退役桥的
  `lib/*.js` + `.js.map` + `types/*.d.ts` 成孤儿，而原门**只做 src→lib 单向**、对此**全绿**
  （孤儿随即被部署 ⇒ **死代码随包发布，没有任何门看得见**）。现新增**孤儿模块检查**
  （lib 顶层每个 `.js` 须有对应 `src/*.ts`；白名单仅 `client` ← `src-client/` 经 `npm run build:client`），
  **判 FAIL**；并已**反向证伪**（造 `lib/_orphan-probe.js` ⇒ FAIL exit 1；删除 ⇒ PASS）。
  **③ 真机验证**：部署（覆盖 10）+ 热重载后 `/mcl/status active=True` · `/deepsleep active=True` ·
  `/deepsleep/config active=True running=有` · `/rings` `/suite` 200 ⇒ **两刀之后的 root 链路都通**。
  安装副本里退役桥的残留产物亦已清。
- **G0 composition root 第一刀：`mcl-share` 退役（桥边 6 → 4）（2026-09-13）**
  **① 新 `src/composition.ts`（root 的持有面）**：root **显式创建句柄盒**（`{ mcl: { current } }`）并在装配时
  交给两侧 —— `applyPanel(ctx, config, comp)` / `applyScheduler(ctx, config, comp)`。**不换装配次序**
  （panel 仍先装，避免启动期行为风险），但依赖从「模块级全局 holder」变成「**显式参数**」：
  生产者 scheduler 装入、消费者 panel 路由取出，**依赖关系静态可追**。
  **② 退役**：删除 `src/mcl-share.ts`；`/mcl/status` 改读 `d.mcl.current`（comp 缺省时给空盒 ⇒ 如实报
  `mcl-not-ready`，与"调度器未装配"**同一语义，不造假态**）。
  **③ 棘轮收紧 + 退役守卫**：`check-bridges` 基线 **3+3 → 2+2**；新增 `RETIRED = ['mcl-share']`
  —— **退役的桥文件复现即 FAIL**（退役不许被悄悄加回来）。实测 **4/4 边**、GATE 绿。
  **④ 真机验证（本次重构的关键一步）**：部署 + 热重载后 `GET /mcl/status → active=true` 且字段齐全
  （`topK` / `materialInSystem` / `slow`）⇒ 证明「root 建盒 → scheduler 装入 → panel 取出」链路真的通了；
  `/rings` `/suite` `/criteria` 均 200。
  **⑤ 顺带清掉一处产物漂移**：`tsc` **不删已删源文件的产物** ⇒ `lib/mcl-share.{js,map}` 与
  `lib/types/mcl-share.d.ts` 成孤儿（仓内 3 件 + 安装副本 3 件），已清。
  **发现的缺口（记下，下轮补）**：`check-srcmap` 只做 src→lib **单向**核对，**孤儿产物漏检**——
  需加反向检查（lib 顶层每个 `.js` 须有对应 `src/*.ts`）。
- **G0 composition root 前置：惰性桥消费点棘轮 + 反向证伪（2026-09-13）**
  目标里「唯一 composition root」要求**消掉 3 个 `-share` 惰性桥**；但"消桥"若没有数字，就只是一句愿望。
  本件把三条桥的**发布点 / 消费点**数成数字并**只许减不许增**：
  · 基线（实测）**发布 3 + 消费 3 = 6 条边**——发布全在 `src/scheduler.ts`，消费全在 `src/panel-observe.ts`；
  · 边数 **> 基线 ⇒ FAIL**（新增惰性桥消费点须改走 composition root，或显式上调基线并说明理由）；
  · 边数 **< 基线 ⇒ PASS 并提示收紧基线**（棘轮只许收紧：拆桥后必须把基线降下来）；
  · **目标 0**：由 composition root 直接构造并**显式传句柄**，两侧都不再需要全局 holder。
  **反向证伪抓出真缺陷**：初版扫描器按文件名推导标识符（`deepsleep-share → deepsleepShare`），而真实导入名是
  **`deepSleepShare`（大写 S）** ⇒ **整整漏掉一条桥**（基线被算成 4，真实是 6）。若没有 `--selftest`，
  棘轮会以错的基线长期少算一条——正是本项目一直在剿的"假绿"。现改为**从 import 语句解析标识符**，
  配 `--selftest`（6 例：发布 / 消费 / 无 import / 仅注释提及）。已登记 `check-runner`（+2 件）。
- **G4 接线 P2b 的放行判据补齐：合规步落账 + 分流读数工具（2026-09-13）**
  上一轮把 P2b 实现并真机验证后**回滚**，原因是方案档 §12 风险 1 的放行判据「合规率不降才放行」**执行不了**：
  `mcl.ts` 只在**不合规**分支写审计行 ⇒ 合规率**没有分母**（实测 803 条全 `false`、合规 0 行）。
  **① 合规步也落账**（`src/mcl.ts`）：补 `compliant: true` 审计行（字段与 false 行同构：`nudge/nudges/topics`），
  使前后对比**有分母**。
  **② 分流读数工具**（新 `scripts/mcl-compliance.mjs`）：按 `viaSystem` **分段**算合规率
  （材料走消息面 vs 走 systemPrompt 段），判据 `段(systemPrompt) ≥ 段(消息面) − 5pp`；
  **样本不足一律判 INSUFFICIENT 并退 3**（不拿小样本下结论）；配 `--since` 时间窗——
  合规落账是 2026-09-13 才补的，**更早的行没有分母**，混算会把合规率算成 0%（正是那个 artifact）。
  **③ 测试**：`test-mcl.mjs` 由 29 → **32 条**（H 组：引用材料后不再引导 · **合规行确实落账** · 字段齐备）。
  **④ 现状（如实）**：仪表盘已装并部署，**开关仍为 `false`（现行运行不变）**；
  基线窗口起点 `2026-09-13T12:36:50Z`；当前读数 **INSUFFICIENT**（两段 0/0）——
  **待窗口内各段 ≥20 条判定样本后，才能用数据放行 P2b**（一行开启 + 重载）。
  （本件为读数工具、非机检件，沿用 `criteria-audit` / `maturation-scan` 先例不登记 `CHECKS`。）
- **G4 接线 P2b：慢通道材料改挂 `systemPrompt` 段（实现 + 部署；开关已回滚为缺省关）（2026-09-13）**
  **① 机制**（`src/mcl.ts`）：新增 `mountMaterialBlock` —— 在 `systemPrompt` 注册块 **`shoucang-mcl-material`**
  （**order 89**：user-settings 85 / 守藏热记忆 88 / 本块 89 / memory 90），块**按会话 id** 返回该会话本轮材料
  （别的会话取空 ⇒ 不串话）。开启时材料**消息面零插入**（转录不再被材料污染，对应 §11 度量
  「转录内 MCL user/message 条数 → 0」）；**消息面仅保留 `nudge`**（方案档 §3.3 明确允许的唯一一项）。
  资源挂 `ctx.effect`；`systemPrompt` 能力不可用时**回落 false 并记日志**（宁走旧路，不可静默失效）。
  **② 开关**：`mclMaterialInSystem`（缺省 **false ＝ 现状零行为变化**）；`/mcl/status` 暴露**解析后的实际去向**
  （回落时会变 false ⇒ 活体可核，不是"读了配置就算数"）。
  **③ 门禁**：`registerMcl` 一度涨到 **148 行 > I1 上限 120**，被架构棘轮当场抓住 ⇒ 按领域外提
  （`mountMaterialBlock` / `materialOf` 两个模块级函数）压回限额，棘轮复绿。
  **④ 测试**：`test-mcl.mjs` 由 20 条扩到 **29 条**——F 组（块注册 · 序 89 · **消息面零插入** · 审计 `viaSystem=1` ·
  按会话取材料 · 别会话不串话 · 无会话 id 不抛）；G 组（**能力不可用时回落消息面**，认知环不因开关失效）。
  **⑤ 真机实证**：部署 + 热重载后 `/mcl/status` **出现 `materialInSystem` 字段**（此前无此字段 ⇒ 证明新代码在跑）；
  写入开关再重载 ⇒ **`materialInSystem=true`（未回落 ⇒ 块确实挂上了）**。
  **⑥ 开关已回滚为 `false`**：取基线时发现**合规率不可测**——`mcl.ts` 只在**不合规**分支写审计行
  （实测 909 慢通道步中 803 条全为 `compliant:false`，**合规步 0 行落账**）⇒ 方案档 §12 风险 1 的放行判据
  「合规率不降才放行」**当前无法执行**。按仓内「先有仪表盘、再动 active」纪律回滚；
  补上「合规步也落账」后即可一行开启（`scheduler.json` 置 `mclMaterialInSystem: true` + 重载）。
- **面板新增只读端点 `/rings`（五环 KPI + 事件对账）+ 本会话产出首次部署到运行态（2026-09-13）**
  **① 新端点**：`GET /api/shoucang-panel/rings`（只读、零 LLM）——环内容（决策/后果/价态/关系/承诺/碰撞）
  此前**只有 CLI 面**，面板完全看不到，而"机制没有仪表盘"正是本项目反复踩的坑（快通道恒 0、崩两次才被
  人肉发现）。现一次暴露五环 KPI 与**事件流重放对账**。路由 35 → **36**：契约表（`panel-contract.ts`）·
  `test-panel-wiring` 契约清单 · `gen-panel-contract` 产物**三处同步**更新。
  **② 首次把本会话产出部署到运行态**：`check-installed-sync` 此前报 **37 件漂移**——本会话新增的 9 个模块
  在安装副本里**根本不存在** ⇒ 「重启」本身验证不到任何新能力（这也是此前判 blocked 的直接原因）。
  按仓内「只覆盖差异文件」路线部署：先备份，再按 sha256 **逐件比对**后覆盖 ⇒ 新增 **27** / 覆盖 **10**
  （第二轮 +6）/ 一致 **130**；`client.js` 本轮随契约产物更新（630,505 → 630,671 B）。复测
  **167/167 一致 · 内容不同 0 · 仅仓内 0**（唯一"仅已安装"= 既有 `client.js.bak-*`，非本次产生，不动）。
  热重载 OK（清缓存 **45 → 47** 模块——正对应新模块被面板引入）。
  **③ 运行态实证（真机，非接口自述）**：`GET /rings → 200`：环普查
  `fact 72 / decision 2 / relation 4 / association 1 / value 26 / none 82` · 决策环
  `opened 1 / collected 1 / pending 0 / hitRate 1` · 关系环 `关系 1 / 承诺 3 / 待兑现 2 / 人 1` ·
  联想环 `碰撞 1 / 认可 1 / 落地 1` · 事实环 `187 全有效` · **事件流 11 条 · 重放对账 ok=true（store 8 ⟷ replay 8）**。
  该路由此前**不存在** ⇒ 返回 200 且数据自洽，即证明**新代码在被执行**，不只是文件拷上去了。
- **G4 读侧候选集 + 画像行分层订正（时态失效进读侧闭环）（2026-09-13）**
  **① 候选集构建**（`src/supply-assembly.ts` 新增 `buildCandidates`）：记录集 → 按层分好、且**已剔时态失效者**
  的候选；被剔者进 `expired` 清单（带失效因由）**不静默消失**；非可注入者（结构/空白/环记录/空行）计数可见。
  判定时刻 `at` **必填**（不吃隐式 now ⇒ 结果可复现）。
  **意义**：`validFrom/validTo` 此前**只写不读**——标了失效的断言照样进候选、照样被注入，「旧事实与新事实
  并存」的污染一点没减（**机制空转**）。本节点把「**失效者不得入候选**」变成读侧硬规则。
  **② 订正一处分层误判（真库实测暴露）**：`indexRowInLayer` 只认 `[tag] …` 形态（真库索引行确为此形），
  而**画像行是 `- … ← 源:` 形态** ⇒ 被判成"非 always"而掉进变动面，与 `carriers` 契约不符。
  新增 `targets#isProfileRow`（口径归 targets **单一实现**，不在读侧另写行形态判据）。
  **实测差异**：真库恒定面候选 **18 → 48**（约 30 条画像行此前被算进变动面）——**恒定面的真实压力比以前
  测到的更大**。
  **③ 消重**：`supply-preview.mjs` 原自带一份分层逻辑，改为调用 `buildCandidates`（读侧单一实现）。
  **实测（真库）**：core 1 · 恒定面 48 · 变动面 72 · 联想 3 ⇒ 实装 **core 1 + 恒定 15 + 变动 9 + 联想 2** ·
  字符 **1877 / 2100** · **被预算挡下 97 行**（订正前测得 66–67）。单测 **40 条**（含端到端「失效行不出现」）。
- **G0 事实环时态失效（双时间戳）+ 镜像状态承接（2026-09-13）**
  目标里 G0「双时间戳」以 **Record 扩展**落地（**不另建事实源**）：`validFrom/validTo` 进记录模型与走形判定。
  **① 时态失效**（新 `src/fact-ring.ts`，纯函数）：`isLive`（**坏时间戳 fail-closed**——不拿坏标记当好标记）·
  `supersede`（**幂等**：重复标记被拒，否则"何时失效"会被后来者覆盖；记下因由与"被谁取代"）·
  `revive`（撤销误标）· `liveRecords`/`expiredRecords`/`staleReport` · **`factCensus`**（本环 KPI）。
  **② 正交性写成断言**：`validTo`（**还成不成立**）与 `lifecycle`（**值不值得注入**）**不许混用**——
  混用会犯两类错：把"过时"当"不重要"（继续注入错的事实），或把"不重要"当"不成立"（丢掉真的事实）。
  **③ 修掉一处会静默吃掉状态的隐患**：镜像按文件整片替换记录 ⇒ 该文件上累积的**状态全被清零**
  （命中统计 `hits/lastHit`、活性 `lifecycle`、成熟度、双时间戳、以及 `meta` 里的前提/失效因由）。
  实测后果：事实环标了"已失效"的断言，**下次镜像就复活**；命中统计同样丢失。
  现改为 **内容以 md 为准、状态以既有记录为准**（承接 hits/lastHit/maturity/lifecycle/validFrom/validTo/meta/createdAt）。
  **④ CLI**：`--supersede / --revive / --facts`；`--score` 增事实环行。
  **实测（真库，只读）**：**187 条记录 · 有效 187 · 已失效 0 · 坏时间戳 0 · 带前提 0**——
  最后一项是信号：仓内判据要求「依赖隐含前提者必须写出前提」，实测**一条都没有**。
  单测 **40 条**（`scripts/test-fact-ring.mjs`，含镜像承接与 fail-closed 反向证伪）。
  ⚠ 已知边界（显式）：事实环失效是**状态位变更**，**不进**环事件流的 9 种 op（索引行由 mirror 管）；
  该边界已写成断言钉住——将来要改必须同时改取集范围与重放载荷，改错了那条断言先红。
- **G0 剩余两项：KPI 机检门 + 部署版本三处一致巡检（2026-09-13）**
  **① KPI 机检门**（扩 `scripts/check-ring-coverage.mjs` + 新 `src/rings.ts#RING_KPI`）：**每个内容环必须登记
  其 KPI 产出者，且该函数真在 `lib/` 里被导出**（登记了却取不到＝死登记）。依据是本项目已有的实证教训：
  **快通道曾恒为 0 而无人知晓**（`fast=0` 崩过两次才被人肉发现）——机制没有仪表盘就等于没有。
  实测：五个环各自绑定 `scorecardOf`（命中率/待回收）· `trustOf`（双向兑现率）· `associationCensus`（落地率）·
  `inventoryOf`（清单/生命周期分布），全部命中。
  **② 部署版本三处一致巡检**（新 `scripts/check-version-pin.mjs`，已登记）：profile 里同一依赖有**三份版本记录**——
  `package.json`（声明）· `pnpm-lock.yaml`（锁定）· `node_modules/.modules.yaml`（实装）；三份各说各话时，
  **「仓内绿」与「装上去的是哪一代」完全脱钩**（曾有修复已提交、安装副本仍旧代而三道门全绿的前例）。
  **实测本机确为三处不一致**：`f81eb2e5` / `9f6c920e` / `1c5b09fe`。
  设计：**报告态**（不一致仍 exit 0，并给出根治指引）——部署含 push / 热重载等环境侧步骤，做成红灯＝**假红灯**
  （与假绿灯是镜像错误），与 `check-installed-sync` 同规格；要当 CI 硬门时加 `--strict`。
  **静默失效防御**：文件里有依赖名却抽不出 SHA ⇒ 判**代码问题 FAIL**（不是"诚实跳过"），否则解析器一坏就永远
  走 skip 分支；配 `--selftest`（4 例反向证伪，证明抽取器真的会抽）。
- **G0 环事件流 + 重放对账（统一事件流账本的环侧落地）（2026-09-13）**
  目标里 G0「统一事件流账本」在**环侧**的兑现：**事件流是不可变历史，store 是当前状态**——store 会被
  镜像按文件整片重写；不另存事件，环的历史（何时开裁决/回收/结清/落地）就只存在于最终状态里。
  **① 事件模型 + 重放**（新 `src/ring-events.ts`，纯函数）：**9 种 op**（五环的写与状态迁移全覆盖）·
  `eventsFromDiff`（写时差分推导；**载荷逐字取自记录 `meta`，不做正文反解**——按正文反解会在文本格式
  变动时静默走偏）· `replayEvents`（**复用写入侧同一批纯函数**重建；不另写一套，否则"重放一致"只证明
  两套实现写了同样的 bug）· `reconcileRing`（**事件流重放必须能重建当前状态**）。
  **② 身份以事件为准**：环操作新增显式 `id` / `text` 覆盖 —— 重放**不重算 id、不重拼正文**
  （实测教训：库里老记录的 payload 只活在正文里，重算 id 与重拼正文都会走形 ⇒ 对账必红）。
  **③ 迁移**：`--backfill-events [--force]`（从当前状态回填，`at` 取各记录 `createdAt` 保序）；
  此后每次环变更**自动追加**事件。**④ CLI**：`--events` / `--reconcile` / `--backfill-events`。
  **实测（真实库）**：回填 **10 条**事件 ⇒ `--reconcile` **PASS**（store 环记录 7 ⟷ 重放 7，
  kind/text/meta 逐条一致，含只有正文有载荷的老记录）；活路径新开 1 条承诺 ⇒ 事件追加为 **#11** ⇒ 再对账仍 **PASS**。
  单测 **28 条**（`scripts/test-ring-events.mjs`），含**四类偏差必须都抓得住**（缺失/多出/内容不一致/坏事件）
  与「状态→事件→状态」往返无损。
  ⚠ 与 `audit/ledger.jsonl` 的关系：那条是**判据/写入**的统一台账（消费方已有 `criteria-audit` / `memory-reconcile`），
  环事件落在库内自有路径 `.records/ring-events.jsonl`，**暂不并入**——先求不扰动既有审计消费方，合并留作专项。
- **G4 读侧装配 + 越界联想独立预算槽（读侧落地）（2026-09-13）**
  讨论结论的落地：**价值只在下游兑现** ⇒ 架构重心从写侧（蒸馏/归纳/水位）右移到读侧；
  「检索 top-k」升为**「预算内最小充分集」**。
  **① 装配器**（新 `src/supply-assembly.ts`，纯函数 · 确定性）：`assembleSupply` 按恒定/变动/一次性
  **三层预算**取行 + **核心必进**（身份/使命/边界，超额度也进但计入溢出账）+ **整条进或整条丢**
  （绝不截半行——半截行既走样又可能断指针）+ **溢出全量记账**（`meta.dropped` 带 slot/原行/原因）。
  `renderSupplyText` 渲染（空段不产标题）。
  **② 越界联想独立预算槽**（相对方案档三层预算的**新增**）：`serendipity` 拿**自己的额度**，与相关性面
  **互不挤占**——依据是注入打分 `α_rel·relevance + …` 里 α_rel 越强越不会发生越界碰撞（**精度与惊喜
  在数学上对立，改权重无解，只能分槽**）；**缺省额度 0（关闭）**，启用时 `meta.budgetTotal` **显式上升**
  （2100 而非偷偷超花上下文）。
  **③ 真库预览**（新 `scripts/supply-preview.mjs`；分层判据**复用 `targets#indexRowInLayer` 单一实现**，
  不另写标签名单）：候选 core 1 / 恒定面 18 / 变动面 72 / 联想 3 ⇒ 实装 **core 1 + 恒定 15 + 变动 9 + 联想 2**，
  字符 **1896 / 2100**，**67 行因预算被挡**（关联想槽时 1627 / 1800 · 66 行被挡）。
  ⚠ 实测说明**恒定面候选自身已超额度**（18 行 P 层要挤进 1,000 字符）——溢出账把它从"看不见"变成"读得到"。
  **④ 未接线（显式）**：装配**尚未接进 `systemPrompt`**。该步（方案档 P2b）依赖宿主
  「`agent/pre-step` → 请求装配」的先后关系，**仓内无法在不重启的情况下验证**，贸然上可能静默关掉认知环。
  本节点交付**引擎 + 离线可复现基线**，接线待重启验证后一个开关。
  单测 **28 条**（`scripts/test-supply-assembly.mjs`）。
- **G3 联想环 + 碰撞记录 + 越界召回（内容环第五环落地）（2026-09-13）**
  讨论结论的落地：**洞察是「关系」不是「条目」**——在写入时提炼洞见是错位范式（碰撞的分母是"未来某个问题"，
  写入时不可知），且若模型能在写入时生成它，读取时也能生成，存下来只会污染库并挤占注入预算。
  故本环**只记碰撞**（撞过哪两条 + 什么语境 + 被认可吗 + 后来成了吗），**洞察本体不落库**。
  **① kinds +1**：`association` 归联想环；`RING_PENDING` **清空**（五个环全部落 kind）。
  **② 碰撞记录 + 跨度门**（新 `src/association-ring.ts`，纯函数）：`recordCollision`——**硬门：两锚点须带
  `§` 地址且小节不同**（同一主题内的归纳归 principles 通道，不许冒充碰撞）· `collideRecords`（按记录 id 记，
  锚点由 `anchorOfRecord` 推导）· `markAccepted`（价态）· **`landCollision`（落地回收，幂等）** ·
  `openCollisions`（待回收队列）· `associationCensus`（**落地率分母 = 已认可者**，不是全部碰撞）。
  **③ 越界召回**（读侧独立通道）：`serendipityPairs` **不按任何相关性打分排序**，按「§ 跨度 + 冷度」挑候选对；
  同 seed 逐字可复现（可作回归基线）；**已撞过的对不再推荐**。
  **④ 修掉一处真实缺陷（真库跑出来才暴露，非推理）**：初版去重尺子错位——碰撞存的是**锚点**、
  召回排除集查的是**记录 id** ⇒ 已撞过的对会被**反复推荐**；且无 `§` 地址的行（画像行）混进候选池，
  `sectionOf` 退化为整串正文 ⇒ **任意两行都判"跨 §"，跨度门形同虚设**（实测 span 恒为满分）。
  现统一口径（`anchorOfRecord`）+ 收紧前置门（`hasSection`）+ 候选池只收带 `§` 地址的行。
  **⑤ CLI**：`record-ring.mjs` 增 `--collide / --land / --collisions / --serendipity`；`--score` 合并三环 KPI。
  **实测（真实库）**：越界召回产出真实**跨文件跨 §** 对；记 1 次真实碰撞（往返闸 ⨯「产物未校验不得推进水位」）
  → 认可 → **登记落地** → 待回收清空 → 联想环 `碰撞 1 / 认可 1 / 落地 1 / 落地率 100%`；三环记分卡齐备。
  单测 **52 条**（`scripts/test-association-ring.mjs`），含两条**反向证伪**（同 § 必拒 · 无 § 地址必拒）。
- **G2 关系环 + 承诺状态机 + 双向兑现率（2026-09-13）**
  讨论结论的落地：人记的大半不是知识，是**社会位置**（谁有期待、我欠谁、谁可信）。模型没有社会位置，
  这部分只能外置，且它是**双向**的（对面也记得你）。
  **① kinds +2**：`relation`（关系事实）/ `commitment`（承诺）归关系环；`RING_PENDING` 撤销 relation 申报。
  **② 承诺状态机**（新 `src/relation-ring.ts`，纯函数）：`openCommitment`（`status=pending`，带
  `direction = owed-by-me | owed-to-me` 与 `due`）→ **`settleCommitment`**（pending → kept | broken；
  **重复结清被拒**；结清即出队）→ `openCommitments`（待兑现队列，可按人过滤）· `relationsOf`（按人取双向面）
  · `relationCensus`（关系网规模）· `trustOf`（**双向兑现率分开统计**——合成一个数就丢掉了方向这个最有用的信息）。
  **③ 棘轮加固**：`check-ring-coverage` 新增**陈旧申报**检查——环已落 kind 却仍留在 `RING_PENDING` 即 **FAIL**
  （防"显式豁免名单永不清空"）。
  **④ CLI 扩**：`record-ring.mjs` 增 `--relation / --commit / --settle / --commitments / --relations`，
  `--score` 合并两环 KPI。
  **实测（真实库）**：记 1 条关系 + 2 条承诺（1 兑现 / 1 待兑现）→ 待兑现队列剩 **1 条**
  （`切 storeMode=record 前先出迁移与回滚路径` —— **真实未结事项，队列确实在追这条**）·
  我欠兑现率 100%（1/1）· 无记录主体报 0（不 NaN、不编造）。单测 **35 条**（`scripts/test-relation-ring.mjs`）。
- **G1 决策环 + 后果回收 + 价态采集口 · 内容环落地（2026-09-13）**
  来自三轮讨论的两条核心结论落成代码与门禁：**没有后果回收，「经历」永远变不成「认知」**；
  **频率门（≥3 痕迹 / ≥2 次）结构性杀死一次性洞见**。
  **① 内容环注册表**（新 `src/rings.ts`）：`kind → 环`（fact/decision/relation/association/value/none）**唯一声明处**；
  `FREQUENCY_FREE_RINGS = ['decision','association']` 把「一次性即成立」钉成契约；`RING_PENDING` 显式申报
  G2/G3 尚未落 kind 的环（棘轮：落地后必须删除，否则门禁翻红）。
  **② 决策环**（新 `src/decision-ring.ts`，纯函数）：`openDecision`（裁决 + **当时预测** + 理由 + 被否方案）
  → **`collectOutcome`（后果回收）**——幂等拒绝重复回收、未给 hit 时由价态符号推导 ——
  → `recordValence`（价态 + **触发条件**，重现累加 hits 不新增）→ `openDecisions`（待回收队列）
  → `scorecardOf`（**KPI 只从记录集推导**，不另立计数器）。
  **③ Record 扩展点**：`KINDS` 增 `decision/outcome/valence`；`MemRecord.meta` 通用槽 + 显式 `id` 覆盖
  （同文本后果挂不同决策不撞 id）⇒ **新增一类内容不动 schema**（兑现 P4 验收「新增类型/主体零架构改动」）。
  环记录 `file=''` ⇒ **天然无 md 投影**，镜像的按文件替换不会吞掉（有单测钉死）。
  **④ 门禁**（新 `scripts/check-ring-coverage.mjs`，已登记 `check-runner`）：每个 kind 必须登记环归属 ·
  空环须显式申报 · **免频率门环缺 `association`/`decision` 即 FAIL**。
  **⑤ CLI** `scripts/record-ring.mjs`（`--decide/--outcome/--valence/--open/--score`）。
  **实测（真实库）**：开裁决 → 回收后果（命中）→ 采价态 → 待回收队列清空 → 记分卡
  `已开 1 / 已回收 1 / 待回收 0 / 命中率 100% / 价态 1`，且**环记录落地后三索引对账仍逐字节零差异**
  （4645 / 2106 / 2393 B）。单测 **48 条**（`scripts/test-decision-ring.mjs`）。
- **P4 存储解耦 · 双写期落地（Record 事实源 + md 投影）（2026-09-13）**
  依据 `docs/context-supply-plan.md` §8 P4 / §10 单写向；恢复前置三项**全部达成**（见下实测）。
  **① Record 事实源模型**（新 `src/record-store.ts`，纯函数零 I/O）：`id` 内容指纹派生（天然去重）·
  主体是**字段**（`user|agent|knowledge|companion:<id>`，新增主体零架构改动）· 生命周期 `active|cold|retired`
  （遗忘=迁移不删除）· 命中记账 `hits/lastHit`（"被用过"的证据，非猜测）；**标签→类别从
  `criteria.generated.ts#CARRIERS` 派生**，不再维护第二份标签名单。
  **② 宿主影子写**（新 `src/record-shadow.ts`）：md 成功写入后镜像进 `<库根>/.records/records.jsonl`
  （原子 tmp+rename；**只镜像、绝不回写 md**；零抛出，不影响主写入链路）。
  **③ 开关 `storeMode`**（scheduler；缺省 `md` = **现状零行为变化**）：`dual` 才启用双写镜像；
  配套 `scripts/record-sync.mjs`（`--import` / `--check` / `--diff` / `--export`）。
  **④ 常驻门禁**（新 `scripts/check-record-parity.mjs`，已登记 `check-runner`）：往返闸恒跑
  （md → Record → md 逐字节重现）+ 影子库对账；`storeMode=dual` 而影子库缺席 ⇒ **FAIL**（防"开关已启用却无影子库"的死开关）。
  **⑤ 消重**：`scripts/record-export.mjs` 原带**私有解析器 + 私有 P_TAGS/R_TAGS 名单**，改调同一实现。
  **实测（真实库）**：三索引 **179 记录**（MEMORY 68 / USER 62 / AGENT 49）· 往返**逐字节一致** ·
  影子库对账**零差异** · 干跑**零差异**；单测 **67 条**（`scripts/test-record-store.mjs`：CRLF/LF 混用、
  无尾换行、连续空行、损坏影子库、重复镜像幂等、**反向证伪**「改了 md 不镜像 ⇒ 对账翻红」）。
  ⚠ `storeMode=record`（md 降为纯投影）**尚未实现**，本键只接受 `md|dual`——不留"选了却没接线"的值。
- **审查 B 档落地：注册表成为真源（2026-09-11）**：把 `criteria.json` 里此前**只作文档**的运行参数逐一接入代码（审查报告 §6），实现"改注册表即生效"。**接线**：`trigger.idleMs/probeAfterMs/probeWindowMs` → `scheduler` zod 缺省（新增注册表字段 probeAfterMs/probeWindowMs）；`trigger.newTracesMin` → `distill` 深睡痕迹门槛（`traces.length < min ⇒ no-traces`，与旧语义等价）；`trigger.manual` → `panel` `POST /deepsleep/trigger` 守卫（false ⇒ 403）；`score.mode` → `scheduler.scoreWeights` 缺省；`maturation.enforce` → `scheduler.maturationEnforce` 缺省；`surface.injection.carriers.profile` → `injectProfileRows` 缺省；`surface.injection.levelCaps` → `panel` 档位行数上限（原硬编码 `{low:2,medium:4,high:8,smart:10}`）；`surface.fusion.k` → `vec` 的 RRF `k`（原硬编码 60）；`surface.fusion.kind`/`recall.coldFactorPercent`/`threshold.tOn`/`mcl.*` → `scheduler` 各缺省；**`l0.*.values` → `criteria.ts` 的 L0 字面量**（新增 `l0Pick()`：按名从注册表取值，**注册表若删值即抛错**，杜绝"声明一套实现一套"）；`GATE.caps/notesWarn` 与 `HEALTH.R/K/notesWarn` → 写门/体检脚本读投影 `criteria-gate.json`。**实测核对（接线未改行为、真源已生效）**：`/deepsleep` → `idleMs=10800000·probeAfterMs=10800000`；`/deepsleep/config` → `ProbeWindowMs=60000`；`/mcl/status` → `阈值=0.65·topK=3·budget=600·nudges=1`；`/config` → `scoreWeights=v2·maturationEnforce=false·injectProfileRows=3`；`POST /deepsleep/trigger` → **409 already-running**（守卫未误伤）；`/criteria` → `levelCaps` 来自注册表。**仍为 doc（有意）**：`SURFACE.rerank`（声明闸门）· `CARRIERS.renderers`（仅元操作消费）· `GATE.exit`（脚本内建）。**机检自纠两次**：字面 token 检索被别名/cast 骗过 → 改文件级判据；消费者集合误含 `gen-*`/`check-*` → 29 项全判 runtime（**判据自我满足**）→ 排除元操作并区分「runtime⇒硬红灯 / doc⇒仅告警」。现 **PASS（32 项）**；库内移除两份**仓侧专用**检测件拷贝（读仓内 `src/`，库内不可运行）。**验收**：`typecheck`/`build` 零错；`npm test` = 5 pass/0 skip + 40+30+18+18 + check-hardcode ✅；部署面一致（8 一致 / 11 未部署 / 0 不一致）。
- **睡眠期自检落地：深睡完成后 + 定时自动跑齐六项检测，并按白名单做事实调整（2026-09-11）**。**动机**：这些检测（判据门/载体门/分层单测/成熟度/影子打分/账本对账）依赖"会话执行过程中的数据"，人工容易想不起来 → 交给系统自动做。**① 机制核实（先判因）**：深睡由 **DSH 子代理**执行（`ctx.subagents.start('spawn', { label: 'deep-sleep-induction' })`，独立 session、`parentSession`=父会话、**父状态恒 idle**）⇒ 自检必须挂在**子代理完成之后由宿主执行**，不能靠父状态轮询（守 `[env] DSH 子代理会话` 语义）。**② 新增自检器** `scripts/sleep-selfcheck.mjs`：跑齐六项（仓侧三项需 `--repo`；库侧三项恒可跑），结构化取数（`--out` 读文件、不解析屏幕文本），出**裁决** `ok|warn|adjust` + 白名单调整清单，并**自己写统一台账** `type=check.sleep`（三条触发路径同一处留痕）。**③ 两条执行路径共用同一实现**（`runSelfCheck(trigger)`）：**深睡完成后**（每次归纳都自检）+ **定时器**（缺省 6h，启动 3 分钟后先跑一次；`selfCheckIntervalHours=0` 关闭）——后者专治"深睡触发严苛（需全部会话停滞 ≥3h）导致想不起来"。**④ 白名单事实调整（边界显式）**：仅一项窄动作 `rollback-scoreWeights`（依据 R-3：`shadow-sim.flipReady=false`），且需显式开启 `selfCheckAutoRollback`（缺省 **false=只告警**）；改 α/改 gate/改判据/删改库内容**一律只建议**；自动删记忆/自动接受被拒写入/自动重启宿主**永不做**。回滚前先备份 `scheduler.json.bak-selfcheck`。**⑤ 可见面**：面板新增 `GET /selfcheck`（最近裁决）与 `POST /selfcheck/run`（**手动立即跑一次**）、深睡视图新增「睡眠期自检」卡（裁决/六项/白名单调整 + 一键跑）、`/config` 暴露四个新键并纳入 `/set`|`/toggle` 白名单。**⑥ 实测（端到端）**：库内跑（无 repo）→ 裁决 **ok** + 三项诚实跳过（含 `shadow-sim` 依赖缺失 → 新增 **exit 3 = 诚实跳过**语义，避免"环境限制"被误判为"检测失败"）；配置 `selfCheckRepo` 后 `POST /selfcheck/run` → **六项全 pass、verdict=ok**；台账 `check.sleep` 实测 **3 行**（`trigger=manual|timer`）。**⑦ 机检再强化**：`check-carriers` 增 **⑤b 键类型分类**（每个 `/set` 键必须可归类为 枚举/数值(RANGE)/字符串(STRING_KEYS)）——本轮第三次同类缺陷（`selfCheckRepo` 被 `Number()` 吞成 `0`，前两次是 `recallFusion='rrf'→0`、白名单缺映射）已由该门彻底关闭。**验收**：`typecheck`/`build` 零错；`npm test` = 判据门 + 载体门（含 ⑤/⑤b/⑤）/ 分层单测 24 + 40 + 30 + 18 + 18 + check-hardcode ✅；架构档 L1 全门 PASS + 锚点 265/265 + 105/105 + 9/9 新鲜。
- **真实 A/B 基线建立 + recall-eval 三项增强（2026-09-11）**：为 `scoreWeights=v2` 建立**可复现真实基线**并存档（`docs/memory-ab-baseline.md`）。**① 工具增强**：`recall-eval` 增 **`--out`**（基线成一级产物，可跨次逐字比对）· **`⑤ 召回零命中` 列**（召回调用后结果文本显示未命中即计一次）· **`--exclude-self`**（按自查词**出现次数**判断自查会话，**保守阈值 300**、剔除清单打印供人工过目——宁少剔勿多剔，守「数据先问」）。**② 三条基线实测**：B1 全窗口（60 会话/601 轮）画像 **24.5** / 知识 **80.0** / 跟读 6.5（每 100 轮）· B2 翻转后（同窗口，因自查占多数 B1≈B2）· **B3 剔除自查 13 会话后：画像 29.6 / 知识 63.1 / 召回 0.5 / 跟读 0.0**。**③ B3 揭示的关键事实（据此修订判据）**：剔除自查后**跟读 notes = 0.0** ⇒ 真实开发任务用的是**索引行**而非 notes 详情——*正面*印证「P 层 always-on + E 层索引行薄注入 + 多级指针按需展开」的设计；*负面*则说明**「跟读率」在本仓无法作为 v2 质量判据**（分母无效），故回滚判据改为预注册四条：**R-1 注入取用率 ≥ B1 的 70%**（画像 <17.2 或 知识 <56.0 即回滚）· **R-2 零命中率 +10pp** · **R-3 `shadow-sim.flipReady` 转 false** · **R-4 定性抽查**。**④ 翻转时间戳入档**：`scoreWeights` 首次生效 **2026-09-11T07:39:07.121Z**（影子日志）。基线产物存库内 `audit/recall-eval-{baseline,postflip,clean}-20260911.json`。
- **真实 A/B 基线建立 + recall-eval 三项增强（2026-09-11）**\|corr(importance,relevance)\|≤0.9 ∧ **top-3 Jaccard≥0.6**；*成熟度门* ⇔ 拦阻率 ≤50%。**① 新增模拟器** `scripts/shadow-sim.mjs`（**真实库行 79 行 × 合成检索样本 60 query**，importance 走产品实现 `lib/criteria.js`，relevance 为词法代理并**明示该边界**）：实测 `corr=−0.293`（**分量不冗余**，R-2 通过）· 扰动性质=`v2 换进更重要条目（预期行为）`。**② α 调参扫描**（0.35/0.25/0.15/0.10/0.05）：Jaccard 依次 0.56/**0.68**/0.72/0.76/0.91 ⇒ 取「满足判据的最大值 **α_imp=0.25**」写回注册表（附证据说明），初始 0.35 因扰动 >40% 被否。**③ 翻转并验证生效**：注册表 `score.mode=legacy→v2` + 运行时 `scoreWeights=v2`（走配置通道 `/set`，落盘 `scheduler.json`，`/config` 回读）→ 影子日志最新行 `mode:"v2"`（前一行仍 legacy），且 v2 把 `rel 0.36/imp 0.79` 的 env 行提入 top-3 = **换进更重要条目**（与模拟预测一致）；真实影子 22 样本 `corr=0.051`（与模拟同向）。**④ 成熟度门明确不翻**：`maturation-scan` 实测 **29 小节仅 1 个达 gate ⇒ 拦阻率 96.6%**，翻会冻结成长 ⇒ 保持 `maturationEnforce=false`，并把复评条件写进决策记录。**⑤ 新增分层单测** `scripts/test-layering.mjs`（**24 PASS**：成熟度曲线/升格门/α 权重/importance 代理/既有裁决回归），纳入 `npm test`；夹具**运行时构造**路径串（守零硬编码红线）。**⑥ 机检再强化**：`check-carriers` 增 **⑤写通道三方对齐**（`/set` 白名单 22 键 ⊆ SCHED_KEY∪SUITE_BOOL∪root-only；`/toggle` 布尔键 ⊆ SUITE_BOOL）——该门当场抓出**两个真实缺口**（`scoreWeights` 我漏映射 → 翻转时实测 400；`embedding.dimension` **历史遗留**白名单无映射），已补齐。决策记录：`docs/memory-m5-decision.md`。
- **记忆核心 v2.2 M4+M5+M6 落地：影子打分 + 成熟度 + 分层打分开关 + 治理收口（2026-09-11）**ngest` / `decision.consolidate` / **`write.ingest` / `write.consolidate`**（含 `carrier`/`channel`/`verdict`/`attempted`/`written`/`reason`/`gateExit`/`rejectedLines`）；`criteria.json` 的 `judgement.ledger` 指向统一 `audit/ledger.jsonl`（保留 `legacyLedger`），读侧（`criteria-audit`/`criteria-report`/面板 `/criteria`）**优先统一台账、回落旧文件**（兼容一版）。**② M2 逐条裁决**（`perItemGate`，缺省 true，false=回滚到整轮全拒）：`applyPrinciples` 改为「逐条过门 → 记录 `[gate:<reason>]` 原文 → 并集再做总门 → 超限则尾部贪心回退」，实现**单条不合格不再拖垮整轮**；新增 `gateExit` 字段（写入回执可读退出码）。**③ M3 账本对账器**：新增 `scripts/memory-reconcile.mjs`（**单一实现**，双布局可用：仓内 `skill/engine/` 与库内 `engine/`）出三类数——**行数闭合**（实际行数 vs 台账 written 累计，无写事件时诚实报「样本不足」而非「有差异」）· **产出健康度**（上次有效深睡 / 连续空转轮数 / 被拒率 / 材料量；「有效」= completed ∧ 有落地 ∧ **gate=pass**，修正了 09-10 那轮 `added=4/gate=行格式违规` 被误当有效的口径）· **三层占比**（P/R/E 条目数与注入估算）。面板新增只读端点 **`GET /api/shoucang-panel/reconcile`**（spawn 库内脚本 + 读 JSON，零逻辑复制），客户端运行视图新增「**账本对账与产出健康（v2.1 M3）**」卡片。**实测**：`/reconcile` 返回 `上次有效深睡=2026-09-09T15:57 · 连续空转 5 轮 · 三层 P 12+2 / R 1 / E 44+7`（**与深睡诊断完全一致**）；触发一轮蒸馏后统一台账 `audit/ledger.jsonl` 落 **6 行 `decision.ingest`（criteriaVersion v2.2.0）**；仓内与库内两份脚本输出**逐字一致**（注册表双布局解析已修）。**验收**：`typecheck`/`build` 零错；`npm test` = 判据门 + 载体门 + 40+30+18+18 + check-hardcode ✅；双端部署 + 热重载 + 端点实测。
- **记忆核心 v2.2 M2+M3 落地：统一台账 + 逐条裁决 + 账本对账（2026-09-11）**契约化·零行为）实施。**① M0-a 载体渲染（行为变更·可一键回滚）**：`src/panel.ts` 的 `readIdx` 升级为 **`readCarrier`** —— `always:index`（P 层索引行）全量 + **`always:profile`（P 层画像行 `- … ← 源:`）每档 ≤`injectProfileRows`（缺省 3，`0`=回滚）**；标签→层的判定**读注册表 `CARRIERS`**（不在代码里硬编码），无标签历史行回落 `← 源:` 启发式；注入段落文案同步说明"含成长画像行"。**实测**：本会话注入面已出现 agent 画像 3 条 + 用户画像 3 条 `← 源:` 行（此前被 `^\[` 过滤，永久不可见）。**② M0-b 审计字段拆分**：`applyPrinciples` 增 `attempted` 与 `rejectedLines`（候选行原文，含 `[format]/[dup]/[no-match]/[gate:…]` 标记），**门禁拒收时 `added/replaced` 归零**（不再让账本显示"加了 4 条"却实际 0 落地）、`skipped` 记为 attempted；深睡审计行同步写 `attempted/rejected/rejectedLines`。**③ M1 契约化（零行为）**：`criteria.json` 升 **v2.2.0**，新增 **`carriers`**（17+1 标签 → `{layer: P|R|E, form, inject}` + 5 条渲染器声明）、**`surface.score`**（`mode/α_rel/α_imp/α_rec`）、**`maturation`**（`A0/step/gate/enforce/ledger`）、**`trigger`**（`idleMs/newTracesMin/manual`）、`judgement.ledger` 改指统一台账 `audit/ledger.jsonl`（保留 `legacyLedger`）；生成器投影出 `CARRIERS/SCORE/MATURATION/TRIGGER` 常量与判据表新增「载体契约」「生效权重与成熟度」两节；新增机检门 **`scripts/check-carriers.mjs`**（契约自洽 · injectable 组合渲染器全覆盖且指向真实文件 · **体检标签 100% 登记** · 投影接线）并纳入 `npm test`；`scheduler`/`panel` 补 4 个开关（`injectProfileRows`/`scoreWeights`/`shadowScore`/`maturationEnforce`，均带缺省与回滚位）。**验收**：`check-criteria` + **`check-carriers` 双绿**（17+1 标签、体检 16 标签零漏登记、渲染器文件全部存在、投影一致）；`typecheck`/`build` 零错；`npm test` = 判据门 + 载体门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅；双端部署 + 热重载 + 注入面实测（见上）。
- **记忆核心 v2.2 M0+M1 落地：载体契约 + P 层画像行恢复可见 + 审计字段拆分（2026-09-11）**SS，JS 只管状态**"。**做法**：① 新增 **17 个工具类/令牌**（`.sc-hidden`/`.sc-on`/`.sc-inline-note`/`.sc-col-end`/`.sc-row-gap`/`.sc-toolbar`/`.sc-box`/`.sc-w-md`/`.sc-max-xl`/`.sc-btn-xs`/`.sc-btn-ok`/`.sc-btn-muted`/`.sc-card-head`/`.sc-edit-sec`/`.sc-ta`/`.sc-ic-lg`/`.sc-ic-sm`/`.sc-fab` + 令牌 `--sc-w-md`、`--sc-shadow-2`）；② **状态切换** `x.style.display='none'|''` → `.sc-hidden` 类（`classList.toggle`），共 8 处；③ **尺寸/间距/字号**内联 → 类，共 8 处；④ **动态缩进**（notes 小节按层级）→ **CSS 变量 `--sc-indent`**（`style.setProperty`，不再拼 px 字符串）；⑤ FAB/图标 → `.sc-fab`/`.sc-ic-lg`/`.sc-ic-sm`；⑥ 删除两处空操作内联。**余下 5 处允许内联**：数据驱动颜色 3（标签色相 `hsl` 2 + 状态徽章色 1）与 CSS 变量赋值 2（`--sc-indent`）。**验收**：`.style.cssText`/`.style.display`/`.style.width`/`.style.cursor`/`.style.maxHeight` **全部 = 0**（机检断言入 U2.5 门，共 **18 条全过**）；`node --check` + `typecheck` + `build` 零错；U1/U2.5/U2/U3 四门全 PASS；`npm test` = 判据门 + 40 + 30 + 18 + 18 PASS + check-hardcode ✅。**过程留痕（错误不删）**：本轮曾用 PowerShell `Set-Content -Encoding utf8` 重写 `client.js` → **BOM + 中文乱码写坏文件**（正是记忆库 `[lesson] PowerShell 编码` 记过的坑）；已 `git checkout` 恢复、改由 **node/编辑工具**改文本并重跑 codemod（幂等），最终一致性与门禁均复验通过。
- **深度睡眠「本日无痕迹」恒真 bug（2026-09-09 实跑确诊，上线以来归纳从未真正执行过）**：触发流程先 `lastDeepSleepAt = now` 推进水位、后调 `runDeepSleep()`，而窗口起点 `traceSince() = max(今日 0 点, lastDeepSleepAt)` 在其内部求值时已读到被改成 now 的水位 → 扫描窗口退化成 `[now, now]`，任何文件 mtime 都不可能 ≥ now → 每次审计 `no-traces`（日志实锤：窗口起点恒等于触发时刻）。修复：① 窗口起点在推进水位**之前**取值，经参数显式传入 `runDeepSleep(since)` / `gatherDeepSleepTraces(root, since)`；② 返回值细分 `done / failed / no-traces` 三态——水位只在 `done`（真正消化了材料）时保持推进，`failed` 与 `no-traces` 一律回滚（当日稍晚产生的痕迹不被划出窗口，且不会重复回想）；③ 手动触发（POST /deepsleep/trigger）同样按上次水位取窗口，消化成功才推进水位，防自动巡检重复回想同一批材料。**端到端验证**：造真实痕迹（2 个 pending 候选 + 1 条 notes 今日条目）后手动触发——窗口识别 3,453 字符（起点=今日 0 点，不再是触发时刻）→ 归纳子代理跑通（首轮 stop=aborted 触发 10min 超时兜底、水位正确回滚；次轮 stop=completed）→ 审计留痕；产出 no-op（`原则 +0`）为内容判断层合规保守（pending 仅背景材料、不作合法源指针），非工程故障。