# 验证账本（verification log）

> 本文件是**证据**，不是说明书。说明书看 [`../README.md`](../README.md)；设计看 [`collab-enhancements-design-2026-09-19.md`](collab-enhancements-design-2026-09-19.md)；变更史看 [`../CHANGELOG.md`](../CHANGELOG.md)。
>
> **为什么要拆出来**：本仓库的验收文化要求每一轮都留下「修复前必红 / 修复后全绿」的读数（变异验证），但 2026-09-20 之前这些逐轮证据被塞进了 README，于是 README 从说明书长成了实验记录本。现在证据按**时间顺序**集中在这里，README 只保留读者要用的东西。
>
> **纪律**：本文件**只追加**、不重写历史条目；每轮新证据加在末尾的「## 」小标题下。**当前读数**与运行方式见 README §十。

---

## §7 服务获取与留痕（0.3.7 的关键修复）——完整历程


这一节值得单独读：**0.3.7 修的是一次「静默降级了整整一天没人发现」的故障**。

### 病灶：`ctx.get` 是时点快照

`settings` 与 `webServer` 都是**运行期取**的服务（不在 `inject` 数组里，服务缺失时插件完整降级）。但 cordis 的 `ctx.get(name, strict = true)` 只返回**提供方 fiber 已 active** 的服务：

```
_getImpl(name, strict = true) {
  const impl = key && this.store[key];
  if (!impl) return;
  if (strict && impl.fiber.state !== 2) return;   // ← 只认已激活的提供方
  return impl;
}
```

而 settings provider 要**先完成 `[Service.init]`**（读 `settings.yaml` → publish）才 active。插件 `apply` 的那一刻它可能还没就绪——于是旧版本在这里**一次性取服务**，取不到就**静默**退回进程内存引擎：此后无重试、无日志，**teams / watchdogs / pairs / rotation 全部不落盘**，每次重启清零。

> **当时的实测取证**：`team_link_watch register` 返回成功、`list` 可见条目，但 `profile/settings.yaml` 的 mtime 与全文在写入前后**毫无变化**；日志里也从未出现本插件的任何 warn（另一条注册失败路径必留 warn，故也被排除）。盘上从来没有 `team-link:` 段——**自 0.2.x 起信任数据从未落盘**，所以「改名迁移已完成」这个结论当时是错的。

### 修法：可选有序注入 + 惰性重试 + 留痕

```mermaid
sequenceDiagram
    autonumber
    participant C as 插件 apply
    participant S as settings provider fiber
    participant L as 日志
    C->>S: ① 快路：ctx.get("settings")
    Note over S: provider 需先完成 [Service.init]<br/>（读 settings.yaml → publish）才 active
    alt 已 active（或同步 stub）
        S-->>C: service
        C->>L: info · policy store attached to settings namespace "team-link"
    else 尚未 active
        C->>L: ⚠️ warn · settings not active at activation (not yet active | no register())
        C->>C: ② ctx.inject(["settings"], cb) —— 可选有序注入，非硬依赖
        S-->>C: 服务转 active → 回调 attach
        C->>L: info · policy store attached …
        C->>C: 内存窗口并入 → 改名迁移
        C->>L: info · post-attach policy chain finished — …
    end
    Note over C: ③ get()/update() 每次发现未挂载就惰性重试 ctx.get("settings")<br/>每个未挂载窗口有且仅有一行 warn
```

1. **立刻试一次**（提供方已 active，或有同步 stub：走快路，不引入任何异步延迟）；
2. 没拿到 → **留一行 warn**，并登记 `ctx.inject(["settings"], cb)`：provider 转为 active 时回调 attach。这是**可选有序注入**，不是硬依赖——服务永远不出现时插件照常加载并降级；`ctx.inject` 本身不可用时再留第二行 warn；
3. **运行期惰性重试**：`get()` / `update()` 每次发现未挂载就再试一次；成功即挂载并记一行 info。失败**不重复告警**——「未挂载告警」有**两条到达路径**（激活时未 active / active 但 `register()` 抛错），二者共用同一个一次性门，故**一个未挂载窗口有且仅有一行 warn**。

一次性改名迁移（`session-link-pro` → `team-link`）随之从 `apply` 当场移到 **attach 之后执行**（在 ③ 未修时它必然是空操作）。

**明确不采用**的做法：把 `settings` / `webServer` 加进 `inject` 数组。`inject` 是**硬依赖**——依赖缺失时 cordis 令整个插件 fiber 不激活，与「服务缺失时插件完整降级」这条红线相抵；而 `ctx.inject` 与 `inject` 在**确定性**上等价（同样等 provider 完成 `[Service.init]`），故取零功能回归者。

### 三个配套细节

**启动窗口的数据一致性**（防御性冗余）：attach 之前写进去的东西只会落在进程内存里，而这个窗口理论上不可达（那时还没有活动代理能调工具）。万一真发生，attach 时会把这些内存写入按与改名迁移同形的规则并入设置命名空间（**仅当**设置侧仍是默认值；settings 始终是事实源），并留一行 warn——不静默丢写。并入**先于**改名迁移执行，迁移的「当前命名空间已在用」判据因此看到的是最终状态。

**provider 生命周期归属**：晚挂拿到的 scope 与其**注入 fiber 同生共死**——挂载时用 `owner.effect(() => () => detach(), …)` 把释放挂到「取到服务的那个上下文」的 fiber 上（与 `webServer` 站点 `target.effect(() => webServer.register(…))` 同一条归属规则）。provider 的 fiber 被 dispose（配置变更 / 插件重载 / teardown）时，scope 归零并记一行 info，store 回到**未挂载态**，provider 回归时由惰性重试重新挂载。此前这里只有捕获、没有归属：scope 非 null 却已死，于是 `update()` 每次都抛错、而 `get()` **静默改答陈旧内存**——读写长期不一致。**快路（宿主自身 ctx）无需额外处理**：那里的 owner 就是本插件自己的 fiber，store、工具、巡逻定时器与这条 effect 同生共死。

**事后链留痕**：attach 之后的两步（内存窗口并入 → 改名迁移）各自返回结论，attach 结束时统一记一行 info：

```
post-attach policy chain finished — memory window: <none (no writes while unattached)
  | not folded (settings namespace already in use) | folded into settings | fold failed>;
  legacy migration: <no legacy namespace | legacy namespace refused (register failed)
  | legacy read failed | no legacy data | migrated | kept (current namespace in use) | failed>
```

「被拒」不再与「根本没有旧命名空间」同形；内存窗口旗标在结论记录后清零（所以后续窗口不会把同一份已解决的内存态**再并入一次**），只有 `fold failed` 保持置位——那些写入确实仍在内存里，下一次挂载必须重试。

### 红线与回归锁

**红线**：任何「未能立刻挂载」都必须留痕，**不得存在第二次静默回退**。

回归锁都在 `host-half.test.mjs`：**U9**（先 apply、之后 provider 才 active 的时序用例）、**U11**（settings 彻底缺失时全功能可用且**有且仅有一行** warn）、**F1**（provider 已 active 但 `register()` 恒抛错时，多次 `get`/`update` 后该窗口仍**恰一行** warn）；另有三组生命周期锁：provider 晚挂 → **dispose 其真实 cordis fiber** → 再回归（释放行、未挂载写走内存、重挂后读写都跟着新命名空间）；门**随窗口**复位（窗口 2 的拒绝自己留一行，窗口**内**的惰性重试仍只算一行）；事后链三态与 `refused` / `no legacy data` 的取值区分。

---


---

## §10 测试——逐轮红相/绿相账本


```
npm test                    # host 889 项 + client 170 项（合计 1059 项）
node host-half.test.mjs     # 宿主半边，stub 风格（真 cordis Context）
node client-half.test.mjs   # 浏览器半边
```

断言总数由两个套件**各自在结尾打印**（`assertion total: 889 (failed: 0)` / `assertion total: 170 (failed: 0)`），文档里的计数即取自这两行——改测试后请同步本行、下面的徽章与 `CHANGELOG.md`。**不要从「上一版计数 ± 本轮新增条数」反推**：② 收口轮的 WIP 就被这样算成了 640，而那次提交自带的实测是 **639**（`506 + 133`）。

**覆盖地图**（按能力划分）：

| 领域 | 覆盖要点 |
| --- | --- |
| 上游深链 | 9 例解析用例 + 深链快照注入 |
| 工具面 | 注册 / 列表 / 导出 / 发送 / 配对全流程，含拒绝、取消、自发送、死目标守卫 |
| 活性信号 | verdict 五态判定表 + 两个阈值边界、goals 缺失降级、读数时效戳 |
| surface 读取窗口 | 只读前 12 行且调用次数**恰为 12**、12 次读取并行在飞、第 13 行起降级、窗口内一行不可读只降级该行 |
| 看门狗 | 注册校验全表、四态巡逻策略、tick source 三成员与正文常量化、去抖、TTL 自清、观察者 dead 分支、dispose 清理定时器 |
| roster / 黑板 | 写权限三态与现任比对、upsert-team 幂等与 workspace 捕获、set-role 版本史与「不迁移 pairs」、retire 的置空/版本史/两条清理对话框分支、镜像一致性与失败降级、团队名与 file 白名单、decisions seq 与行格式与 500 字符上限、discipline baseHash 乐观锁两路、末 20 条窗口 |
| **U16–U19 `/team_session` 自动建队（§10.2）** | 命令面：可选 `commands` 注入下注册 `/team_session`（descriptor + hint + `recordInput`），**服务缺席/迟到/无 `register()` 三种降级**都只丢这条命令且每个未挂载窗口恰一行 warn，模块级 `inject` 仍 4 项；参数文法（`n` / `count` / `team` / `roles` / `role` / `task` / `preset` / `model=<provider>/<model>` + 位置角色名）与逐类拒绝——**文法面的位置角色名真的进计划**（`bare` 折进 `roles`，不是只收集）、**`task=` 取到行尾/下一个 `key=` 边界**（`task=fix the bug` 不再截成 `fix` 并把 `the`/`bug` 丢进被忽略的桶）、**`key="value"` 剥引号**（`team="t"` / `task="fix the bug"`，半引号一律拒绝）、缺 `team=` 时明确报缺（两处都有**端到端**断言：真跑一条命令，读计划/创建/确认框/启动任务正文）；**两个代码常量**：N ≤ 8、每队成员 ≤ 24（含「恰 24 合法」「把团队顶过 24 拒绝并报两个计数」「同名角色在一批里重复拒绝」），并断言它们不在 settings schema 里；确认框正文含**数量 / 模型 / 预设 / cwd / 保守成本 / 配对授权**，选项恰为「创建 / 取消」，**取消 ⇒ 零创建零 pairs**、无确认服务 ⇒ fail-closed、N > 8 不进对话框；创建：`meta` **恰 `{cwd, agentPreset}`**（无 origin / parentSession / delegationDepth / isSeeded）、无 `parentAgent` / `seed`、id 形如 `team-link-<team>-<role>-<uuid8>`（含代理项与路径分隔符被剥离）、cwd 为调用者绝对路径；**生命周期**：handle 由**插件根 ctx** 的控制器持有（`controller.rootCtx === ctx`，别的 ctx 没有控制器），运行期由既有 registry 面寻址，`list_sessions` 对「盘上有会话但无活代理」读 `✕ 未运行 + verdict=dead`；**驱动**：kickoff 用 `followup`（非 `inject`）、`source` **恰三成员**、正文含团队/角色/任务/cwd/回报方式，且动作日志证明**全部 create 先于任何 followup**；**幂等**：整批重跑零创建零 pairs 且 roster/pairs 逐字节不变、混合批只建缺的角色；**失败即停**：第 k 个 create 失败停住、已建者保留并照常驱动、报告逐行列出每个角色的结局、pairs 只给真正建成的、首个即失败时零创建零 pairs 零 roster；**既有团队走既有 `writerGate`**（非现任在对话框之前就被拒）；**孤儿防护**：`pending-creates` 意图写于 create 之前、成功回填、失败留行，TTL 过期由**插件自身启动清扫**报告「可收编清单」（不判会话是否存在、不删会话、报告即记录）、healthy boot 零行；prepare 文案不再声称「本插件不能编程创建会话」 |
| **U19 红线回归（§10.3）+ 并发纪律（§10.2.6）** | **①/② 红线**：源码级锁定「**本模块自己不长出日志写入面**」——无 `ctx.session` 写入缝（`ctx.*` 的会话接触只有**读**面：`sessionQuery` 的**四个**读方法 `listSessions` / `readSession` / `readSurface` / `readTitleSnapshots`，外加 `sessionReferenceResolver` 与 `agents`），无 `session.append` / `appendEvent` / `writeEvent` / `logEvent` / `ctx.emit`；注意措辞的边界（差异审计修复轮 🔵-1）：插件对会话的写入面**是存在的**——`ctx.agents.create` 与 `agent.followup`——红线不破的理由是那两条路径产生的事件类型由**上游定义**，而这条源码断言**证明不了**事件类型（它证明的是本模块没有 append/emit 面；审计的变异 M6「往模块里放一个日志写入 API → 1 红」证明的正是这个锁会咬）。**导入面是六模块白名单**（新增依赖无法偷渡写入 API；`@deepseek-ai/dsh-session-reference` 是上游深链解析器，不是日志写入器）；客户端半边**零 import** ⇒ ① 同样到不了写入面；真跑一批（2 worker）后回放插件自己的 `agent/pre-step` 监听器 ⇒ 事件只剩**上游深链**一条，运行时状态**只落 settings 命名空间 + `agents.create` + `agent.followup`** 三个既有出口 ⇒ **不产生任何新的日志事件类型**（**旁证**而非判据：那条用例读的是**桩**，结构上观察不到新事件类型）；`source` 仍**恰三成员**（复用 U17 的 kickoff + 新跑一批各一条）；模块级 `inject` 仍 4 项且导出面恰 `apply`/`inject`/`__testing`/`name`；**既有 schema 与投递双门零改动**——policy 命名空间仍恰 8 键（② 自己那一个 `pendingCreates` + 先前七个）、`team_link_send` 参数面仍恰 `message`/`meta`/`targetSessionId`/`targets`（`required:["message"]`）、配对免双门、无配对时双门两次都在、接收方选项表逐字、**整批恰弹一次对话框**（§10.2.4 那个，pairs 而非新旁路）。**G2 并发**：在飞 `agents.create` 峰值由**提供方侧**计数（每次 create 故意加 20ms），断言 **≤2** 且**实测恰 1**（单条 `await` 串行循环；源码面同证：全模块 `agents.create(` 恰一处、无并行组合器） |
| **U30–U34 §10.2.8 三条真机缺陷修订（2026-09-22）** | ① 输入文法（方案 A「参数可省」）：R1 参数区只在行首且谓词闭合（静默结束 ⇒ 归正文；key 未知或取值不合法 ⇒ 整条拒绝）、R2 正文不解析（`N=3` / `pid=384448` / `word=` 逐字保留）、R3 失败点名并给出路；**位置角色名废除**（裸 token 是正文的起点，`roles` 只由 `roles=` 声明）与三个默认值（`team` = 调用会话工作区目录名、`n` = 1、一个 `worker-1`）；**正文逐字送达**（kickoff 与确认框交出去的是同一段）；② 结果可见性 = **通道 1**（复用 D 模式：按 `data.name` 过滤 `command/run`、按见过的 `commandId` 认领 `command/done`、有界 64、成功与失败同一条通道），**不新增任何日志事件类型**；③ 确认框边界：**换槽位**（`question` 一行话 ≤120 码点且无换行，披露正文整段进 `detail` ≤600 码点 / ≤12 换行）、任务预览截断标注、不逐角色展开（前 3 个 + 「…等 N 个」且总数写全）、长 cwd / 长团队名的裁剪标注、必备披露与角色指引在压缩后一字不少；④ `/team_rotate` 回归守卫（位置角色名语法与结果不变）|
| 广播 fan-out | 寻址解析与通配仅协调者、逐目标独立过门与 fail-closed、≤8 上限与整次拒绝（**表达式**数；卡内**行数**另受 §10.1.2 的 24 行上限约束）、去重、no-holder、单目标/广播互斥 |
| 信封 banner | 枚举校验全表、ref 按码点截断并注明、首行格式与部分键、source 仍三成员、fan-out 共享 meta |
| busy 预判 | 运行中分钟数 / 时间戳不可读回退 / 空闲原文案 / fan-out 逐目标 |
| **U13 发送方回执（§10.1.2）** | `presentationMeta` 已声明且仍走 `textOutput` 文案（模型可见文本零改动）；单目标与 fan-out 两条路径的 kind/v/at/senderSessionId/targets/summary/fanout；正文 **2000/2001 边界**、头 1500 + 3 码点标记 + 尾 400、`chars` 记原始码点数、astral 切点无半截代理项、继承来的孤立代理项被修复；信封「给了才有」（含 `meta:{}` 不算）；no-holder 的 `sessionId:null` 与 `expr`；去重计数；**行数上限 24**（一个 `team:<n>/*` 合法展开出 30 行 → 卡内恰 24 行 + `targetsTruncated:{shown:24,total:30}` + 保留行是报告的前 24 行 + **summary 仍 30** + 文本报告仍 30 行 + 30 个目标都真收到；对照：恰 24 行**不**截断且卡与改动前逐键一致）；busy 三态（有分钟 / 读不到 / 空闲）；投递阶段之前的拒绝只投影 `{}`（降级）；**审计 F2**：`sessionId` / `expr` / `meta.ref` 三条路径分别污染 `\uD800` 后 `JSON.stringify(card)` 无孤立代理项（修复前 2 红、修复后全绿），对照组是同一次调用的**模型可见文本本已干净**；**审计 B1（2026-09-20 换锁）**：`meta.ref` 被截断时提示只进文本报告、不进卡内行；**`targets[].detail` 仍留在回执里**（模型可见事实源 + 纯文本降级兜底），只是**不再是 A 面的渲染输入**——取代旧「卡内行 == 报告首行」等式的是**跨半边行为锁**（见下一行） |
| **U14 发送方工具行（§10.1.1 A）** | 槽位 key **逐字** `team_link_send`（近形键不占该行）；有回执 → **A 面**（极简标签「工具名 + 目标数」+ 逐目标行「目标（`expr` 或短 id）+ **outcome 短语** + busy 徽标」——**不渲染 `detail`**，2026-09-20 修订），**且不含**标题/时间/正文/汇总/信封；空目标表仍出标签（0 个目标）；无回执（在飞 / 无 meta / 形状不认识 / 别的工具的 meta / 抛异常的 getter）→ 纯文本行并显示模型可见文案；12 种坏形状都不成卡且不抛错；**`targets` 超过 `SEND_CARD_ROW_LIMIT`（24）的回执照常成卡，但 A 面行数封顶 24 并在卡上标注「已截断——仅显示前 24 行」，标签的总数仍是真的**（round-1 🔵 #2；对照：恰 24 行全画且无标注、普通 3 目标卡不受影响）；**该渲染期判据的触发条件是回执自身超过 24 行，而宿主侧自 §10.1.2 修正轮起就在制卡时裁到 24，所以它现在只在异构实现或手改日志的 `meta` 上生效**；宿主自产的 24 行卡带 `targetsTruncated` 字段，A 面**读它**（2026-09-19 收尾轮补的跨轮读路径）——24 行 + `{shown:24,total:30}` 的宿主形回执照常出标注且标签显示**真值 30**，而标签永远显示的是**真值**、不是画出的行数；zh/en 字典键集一致，且**本轮改写没留下死键**（旧行用过的 `sendBusyMinutes` / `sendBusyUnknown` / `outcomeDelivered` / `outcomeRefused` / `outcomeNoAgent` / `outcomeNoHolder` 六键已从两本字典里消失、新行要用的六键都在两本里） |
| **DEFECT-5 §10.1.5 文本重建（无回执时的 A 面兜底，2026-09-20）** | 三种情形的判定与优先级（有回执 ⇒ 结构；无回执但文本认得 ⇒ 最小卡；都不成 ⇒ 纯文本行）；**① 有 meta 时永远走结构化路径**——一块「有完整回执 + 旁边放一份能解析成**另一张**卡的诱饵文本」的块必须按回执渲染（反过来把重建器改成恒返 `null`，全部既有用例照常出卡）；**② 往返判据（跨半边，落在 `host-half.test.mjs`）**——真跑投递取**真实的报告文本**与**同一次调用的真实回执**，加载真实浏览器 bundle，把两面都过真实 A 面组件渲染，逐目标**身份与结果短语判等**；覆盖单目标（含 `「标题」(id)` 与含 `：` 的标题）、混合广播（delivered/refused/no-holder）、`no-agent` 的**跨行**段落、去重；**敏感性锚点**是一条常驻断言——把同一份真实报告的行分隔符改一个字符，重建即失效（证明这把锁不是空的）；**③ 不伪造**——单目标**被拒**句、寻址/`meta` 拒绝、改写过的行分隔符、汇总与逐行自相矛盾、首行数字不符、缺汇总行、表头计数不符、四种之外的 `outcome`、多出来的行、标签不闭合，**11 种全部回纯文本行且逐字显示**；重建**不读** `busy`（机制句里的「已运行 7 分钟」不长徽标）、不留 `detail`、不产 `at`/发送方/正文，也**永远长不出 D 的顶层卡**；坏输入（非字符串 / 空 / `❌` / `汇总：。`）不抛错 |
| **U15 顶层节点（§10.1.3 D）** | 视图与接收方 `key:"context"` **同槽不同键**并存；definition 只认既有 `tool/call`（名字逐字）与带本插件回执的 `tool/result`，其余事件类型一律不认；顶层节点产出（key/kind/id/target/anchorSeq/location/visibility/data）；**D 面**（标题 + 发送方/时间 + 信封 + 正文 + 截断标注 + 汇总计数）**且无逐目标行、无目标身份**；**窗口截断回退**（tool/call 不在窗口仍出节点、别的工具的 meta 不出）；无回执 / 在飞 / 形状坏 → 不渲染；**审计 F1**：两面可见文本取并集后任一语句**恰好出现一次**（任一面把另一面的块搬回来即红）；**审计 F3**：模块级 `inject` 只有 `slots`/`sessions`/`locale` 三项，`uiConversation` 走 `ctx.inject` 动态注入——缺服务 / callback 从不触发 / ctx 无 `inject` 三种坏境下 `apply()` 都不抛、其余四条注册照常落地，**只丢顶层卡**；**审计 B3**：**四条**槽位注册（header 按钮条 + 三条 §10.1）各自加护栏，任一条 `slots.register`（或 `slots.inject`）抛错都只丢那一行、其余照常，且不牵连 definition——含 header 按钮条（round-1 🔵 #3：它跑在四条最前，未过护栏时一条拒绝会带走其后全部注册） |
| 换届 M4 | 令牌绑定与 TTL、rotationBackup 快照、速率限制、冻结清单、多选对话框逐项勾选、域限定迁移、对称撤销、落定与版本史、令牌掩码、四种拒绝、到期清扫与取消/回退、provisional 可见面、幂等重放、内部广播被屏蔽拦截、`goals.resume` **零调用**红线 |
| **§12.5 跨半边行为锁（outcome 枚举 ↔ 客户端短语，2026-09-20）** | 取代 B1 旧「卡内行 == 报告首行」等式的那把锁：`host-half.test.mjs` 同时读 `lib/index.js` 与 `lib/client.js`——宿主侧按两种**铸值形状**取字面量（`outcome: "…"` 直接构造 + `outcome === "…"` 的 `buildSendCard` 摘要四路分支，实测 **4** 个 token），客户端侧取 `OUTCOME_PHRASES` 字面量（实测 **4** 对），两条断言**判等集合**：① 宿主能铸的每个 token 都有客户端短语（缺一即红，红相报 `unphrased: no-queue`）；② 客户端不得给宿主铸不出的 token 配短语。**客户端半边**另有三条同向锁：映射是源码里的真字面量、键集逐字是那四个且两本字典都声明、每个键在渲染器里真被取用；运行时还钉住「映射外的 token 原样显示（新宿主不吞、不编）」。**这条锁的边界如实声明**：静态读看不到「token 经变量到达 `targets[].outcome` 而该变量不出现在任何字面量站点」的路径——今天不存在这样的路径，且一旦出现，它必然落在上面两种形状之一 |
| **§11 ③a 自动换届（U20–U24 / U28）** | **契约层（§11.9.6）**：五硬节 + 三软节的名单、脚手架、提示语与测试样例是**同一套名字**（名单改一个名字即红）；**同改锁（差异审计修复轮 🟡-3）**：那份完整名单在 `lib/index.js` 里**一处都不许手抄**（真源数组是唯一字面处），三处宣传面（工具 description / `handoff` 参数 / 投递正文）在**运行时**渲染出的就是真源那一份，且 `unknownz`/`missionz`/`inflight`/`taskandgoal`/`firstactions` 这类漏改变体一个都不许出现；**🟡-4**：`/team_rotate` 的**被宣传键集 == 被接受键集**（广告由 `TEAM_ROTATE_KEYS` 渲染），且任何不在广告里的键都被**解析器**拒绝并在文案里点名；**🟡-6**：拒绝文案的路径标签按当次调用的 successor 形态渲染（同一条「缺硬节」分支在 auto 下写 `successor:"auto"`、显式下写「显式 successor」）；标题层级/大小写/下划线/尾冒号都折成同一节名；**缺项阶梯逐条断言**——auto + 正文缺失/空 → 拒绝并给出脚手架；**五个硬节各缺一次、每次只点名缺的那个**；硬节在场但为空也拒绝；软节缺 → 放行 + 点名警告；五节全 `TODO` 也放行（**内容质量不被检查**，诚实原则写进断言）；显式 `successor` + 无正文 → 放行 + 警告。**文档三层**：头部九项字段齐全、只给掩码（明文令牌不进任何落盘文件）、`claimedAt` 位置写明「写于 prepare 之前 / claim 不复验 / 不追写」；事实段与 claim **同源**（freeze 正文用投出去的那条常量、迁移/未迁移/对称撤销行用同一个构造器、provisional 回退窗口用同一个函数，且**四类行模板在 `lib/index.js` 里各只出现一次**这一条由源码级断言锁住）；正文原样保留；时间戳文件名 → 第二份把上一份路径写进事实段；头部的完整性判定与校验器读数同源。**auto 编排**：确认框内容（id / cwd / 模型情形 / 保守成本 / 信任面 / 取消=零副作用 / 不迁移任何 pairs）；建出**根会话**（`meta` 恰 `{cwd, agentPreset}`——`agentPreset` 是 DEFECT-1 修复后**缺省也解析**出来的那一个、id 语法、handle 由插件持有）；令牌绑定到自建 id；文档落盘且头部指向前后任；冻结未被跳过；**followup（非 inject）**、正文含令牌明文 + claim 调用 + 文档路径 + 交接正文，`source` **恰三成员**；pending-create 意图回填；**auto + 空正文 → 零建会话/零令牌/零 freeze/零文档/连确认框都不弹**（读提供方侧的 `agents.create` 计数与 `pending`/成员投递数）；无确认服务 → fail-closed；取消 → 零副作用；**30 分钟未认领 → rotation-cancelled + 额外点名自建继任者**（并有一条对照：手工路径不点名；**🟡-2：点名判据跨激活成立**——持久证据优先（交接文档头部的 `successor:` 行，只认最新那一份 / 落盘的 `pending-create` 意图），内存 handle 只作附加佐证，且点名行自报判据来源；跨激活相用**全新 Context + 空注册表**跑同一次清扫，修复前必红）；create 失败 → 意图留在盘上并被启动清扫报进可收编清单；文档写失败 → **abort-before-prepare**（不铸令牌、不 freeze、会话如实报为孤儿）；**一次完整 auto → claim**：域限定迁移 + 对称吊销 + roster 落定 + `rotation-done`，且宿主动作日志只有 `create`/`followup` 两种（无新日志事件类型）。**`/team_rotate`**：可选 seam 注册（descriptor/hint/`recordInput`）、文法的四类拒绝、现任校验与点名、未知团队、同名角色多团队消歧、速率限制窗口不空转、**命令零副作用**（零创建 / 零 pending / 零 pairs）、投出的指令教的语法就是工具接受的那条（五硬节标题 + `successor="auto"` + `handoff=`）、H3 诚实面、无服务/迟到服务两种降级的行数与其余工具面 |
| **§11 ③b 恢复与诊断面（U25–U27 / U29）** | **诊断面（U25）**：三道门的**签名与返回形状一字未动**（`writerGate` 2 参 / `retireGate` 2 参 / `rotateGate` 3 参，且门本体拿不到 `ctx`）——富化全在有 `ctx` 的工具层；两个派生词 `vacant`（`current=null`，**刻意空缺上不加死亡诊断**）与 `seated-dead`（有席位无活代理）在读取时派生；`set-role` / `upsert-team` / `retire` / `prepare` 四条拒绝路径在死现任下都带「活性诊断 + 恢复梯子」，而**对照组**（现任活着、只是调用者不是他）一个诊断字都不多；`roster get` 的现任行（概要 + 详情各一次，同源）带注记而活着的角色行保持干净；**`roster.md` 镜像里一个活性词都没有**（同时保留 `vacant`——它是用户显式表达的持久状态，不是读数）；启动清扫**新增一行**列出各团队 `current` 无活代理的角色（跨团队、带 id 与梯子），**刻意空缺不误报**，全员活着时零行。**L1 `revive`（U26）**：工具恰两个封闭动词且参数面**只有** `action`/`team`/`role`（没有任何能承载继任者 id 的参数），第三个动词在**参数边界**就被拒（`ToolArgsError`）；插件自建会话（id 文法 `team-link-<team>-<role>-<uuid8>`，**重载后已无 handle**）→ `resume` 同一个 id，身份不变 / roster 不动 / 信任零改动 / `resumeCalls` 参数恰 `{resumeSessionId}`；复活出来的代理**真的进了同一个 `agents.get` 注册表**（`writerGate` 按 id 比对直接放行）；handle 归插件；人类自建会话 → **只给深链指引**（零 resume、零写入，并说清 `ownerCtx` 那条理由）；`resume` 缺失 → **fail-closed** 且零改动；无确认服务 → fail-closed 并点明「刻意没有 provisional」；现任已活着 → 幂等拒绝（连限速戳都不落）；**刻意空缺 ≠ 死亡空缺**（`current=null` 时 revive 说清「没有 id 可复活」）；非 coordinator 角色拒绝；不带 `role` 只输出诊断且零副作用；**三处留痕**逐条断言（role 行 `recoveries` 的 verb/from/to/at/by/note + 同一笔更新占用 `rotationAt`；`roster.md` 的恢复行且**无活性词**；`decisions.md` 的 seq/author/正文），`roster get` 同样呈现恢复记录；10 分钟窗口内的第二次恢复被拒；`policy.writer` 原样（**绝不降级为 any**）；在飞未过期令牌 → 不插队拒绝。**L2 `reappoint`（U27/U29）**：对话框选项就是**本队活成员**（排除死现任那个角色自己）、**单选**（③b 差异审计 B3：`multiSelect` 曾为 true 而调用方只取 `picked[0]`，人类勾的第二位会被静默丢弃——盒子不许承诺代码不会做的选择）、调用方无继任者 id 参数；确认框写清爆炸半径与八条边界；**逐字复用 prepare**（三元组绑定 + 30 分钟 TTL + `rotationBackup` 快照 + freeze 到其余成员）、明文令牌只出现一次且此后掩码；三处留痕（继任者具名）；对话框返回集外 label → 按「没有勾选任何候选人」拒绝；无确认服务 / 取消 → 零令牌零 freeze 零写入（承诺限定在**本次调用自身**——B2，入口清扫可能已真写）；**TOCTOU 两条**（对话框仍开着时现任复活 → 中止；候选死亡 → 中止并说「原地再造一个死结」），其中**身份**复检与**活性**复检**各说各的话**且各有一条只能由它回答的判据（③b Y3：身份复检被删 → 那条调用会一路铸出令牌，立即红）；全队皆死 → 候选集为空 + 三条出路 + 连确认框都不弹；`writer=any` 队照走同一套；`recovery` 行内字段**不改 policy 顶层键**（八项一个不多）。**③b 差异审计新增（Y1/Y2/Y4）**：`revive` 仅 coordinator、`reappoint` **任意角色**（描述与 README 双向锁 + 非 coordinator 角色真铸出令牌的行为锁）；**发起域**（现任成员 ∪ 该角色最近一任前任，域外拒绝并指向设置 UI，三半各有断言）；**入口 `rotation.sweep(...)` 的行为锁**（过期令牌必须在恢复自己的前置检查之前被清掉，短路入口即红——红线⑧） |
| **DEFECT-1 preset 解析与挂载（§10.2.2 模板）** | 真机缺陷 #1 的回归锁：`meta.agentPreset` 与 `agentPresets.mount` 的绑定**按会话 id 配对**（不按位置、不看「有没有建出来」）——**缺省也解析**（`resolve(undefined)` = 宿主 `defaultId`，断言读的是**提供方侧**的调用记录）、`meta` 里那一个与真被挂上的那一个**同源**、每个新建会话**恰挂一次**，且那条 mount 绑的 agentCtx 就是**该会话自己的** setup 上下文（fixture 用 `agentId` 顶替真服务的 `scopeOf(agentCtx)`）；显式 `preset=` 走**同一条**代码（不是第二个分支）；**唯一允许跳过 preset 面的分支**是 `agentPresets` 服务缺席 —— 该分支零 mount、`meta` 只剩 `cwd`、**每个新建会话恰一行 warn 且那行说清后果**（没有 persona-prefix 组装源）、会话照建照驱动；`preset=` 指了一个解析不出来的 id ⇒ **创建失败并如实报原因**（零创建），不静默降级成一个没有组成源的会话。③a 侧同批断言：`successor:"auto"` 建出的继任者**同样**满足上面每一条（含 auto → claim 全流程里「认领并落定的那个会话就是被挂载过 preset 的那个」），且服务缺席时换届不因此失败、仍恰留一行 warn |
| **DEFECT-2 工作区归属（§10.2.2 模板的时序）** | 真机缺陷 #2 的回归锁：判据不是「盘上有会话、cwd 也对」，而是**那份工作区的成员名单里有它**（侧边栏按工作区分组读的就是这个）——`workspaceRegistry.create` 每个新建会话**恰一次**（路径 = 调用会话的 cwd，绝对）、`attachSession` **恰一次**且 id 就是**该会话自己的** id、`meta.cwd` 取自 registry 归一化后的 `path`（模板 `:103`：让 registry 归一化出一个不同的路径，这个读数才可观测）；**唯一允许跳过 workspace 面的分支**是服务缺席 —— 该分支零 create / 零 attach、`meta.cwd` 回落调用方 cwd、会话照建照驱动，且**每个新建会话恰一行 warn** 点名「未挂进工作区，可能不会出现在侧边栏」；**回滚（模板 `:135-147`）**：attach 抛错 ⇒ `detachSession` 恰一次 + handle 被 dispose（代理不在注册表、无 controller handle）+ 批次如实报「创建失败」+ 零 followup + **原错误照抛**，且另有一条**半成品**对照（`attachSession` 已把会话写进成员名单之后才抛 ⇒ detach 仍被调用、名单里不留它——`attached` 标志在这里是 false，靠它就漏掉）；源码锁：全模块 `.attachSession(` / `.detachSession(` / `agents.create(` **各恰一处**。③a 侧同批：`successor:"auto"` 的继任者同样挂进工作区（同一条创建路径、同一份判据），服务缺席时换届不因此失败、仍恰留一行 warn |
| §9 收尾修复 | **U9** settings 时序回归锁（先 apply 后 active）、**U10** 创建即认领与不可劫持、**U11** 降级红线与「有且仅有一行」warn、**F1** 两条到达路径共用一次性门；**U9 扩展（差异审计修复轮 🟡-1）**：内存窗口并入的**写面完整性**——两个 provider 都迟到时，一批 `/team_session`（第 2 个 create 故意失败）在内存窗口内写完 roster + pair + `pending-create` 意图，attach 后并入必须**逐字段带上那条未回填的意图**（修复前必红：并入后 `pendingCreates` 消失），且并入恰是 policy 的**八个** key |
| 字符串安全 | emoji 走遍 0..120 **每一个**切割偏移（其中恰好一个偏移在旧代码上留下半截 emoji）、生产边界、预污染源、导出切点、两处批准提问、投递 banner、深链快照注入、poisoned targetId 回显、**回执卡的全部字符串成员**（正文 + `sessionId` / `expr` / `detail` + `senderSessionId` + 信封 `ref`，按 `JSON.stringify(card)` 判定） |

**两组容易复发的回归锁**，值得单独点名：

- `host-half.test.mjs` 里的 `AUDITED_SOURCE_KINDS` 断言是**迁移契约的回归锁**：它按 `dsh-session-format-v2-to-v3` 的白名单与「恰好三成员」规则检查投递出去的 `source`，改坏了会立刻红；
- `client-half.test.mjs` 锁定「上游相邻代理消息不得被误判成本插件卡片」这条边界。

**三条验证纪律（2026-09-27 立；只记在本账本 —— README 是项目介绍，不写我们自己的内部纪律）**：

① **声称必须可核** —— 每条「有断言」的声称附可 grep 到的断言名，每条读数附命令与原文。事故：A 批声称「三态都有断言」，而 `grep 无法计算 host-half.test.mjs` 命中 **0**，本账本却把该文案当实测原文贴出。
② **声称带范围，复核区分「活声称」与「更正注记」** —— 事故：一边写「本档零命中」实为「**能力矩阵那一行**零命中」，另一边复核更宽范围时差点把更正注记当成未改。
③ **「0 命中」必须用真能区分的检查得出** —— 事故：`Select-String -SimpleMatch` 配 `|` 模式 = 搜字面量，报出假「0 残留」；程序化逐行扫描后抓出两处真残留。

**本账本此后每轮条目按此三条记账。**

**变异验证的证据文化**：本仓库的修复都要求给出「修复前必红、修复后全绿」的两次实测输出——例如 0.3.7 收尾修复轮：把 lib 的修复逐条回退后 `506 (failed: 4)`；把 `createPolicyStore` 换回真正的修复前形状则 `506 (failed: 16)`。没有这个证据的修复不算完成（本条自身也是照此执行：② 收口轮的 U19 断言先跑出 `656 (failed: 5)` 的红相再改绿，见下文；该本轮 U19 小节共 **17 条**断言，此前误记为 16，差异审计修复轮 🔵-4 已改）。

§10.1 A/D 轮（当次实测，逐条单点变异、改完全量回退后复跑基线 `543 (failed: 0)` / `104 (failed: 0)`）：**宿主**——去掉 `sendCardMessage` 的截断 → `543 (failed: 5)`；去掉结构化 busy → `543 (failed: 3)`；把 `presentationMeta` 改成恒返 `{}` → 套件当场崩（exit 1：客户端级断言读不到卡）；**客户端**——把 A 的槽位 key 改成近形 `team-link-send` → `104 (failed: 3)`；不读回执（回退恒赢）→ `104 (failed: 12)`；去掉窗口截断回退 → `104 (failed: 2)`；让 `match` 认领每个 `tool/result` → `104 (failed: 1)`；把 D 的内层降级护栏改成 rethrow → `104 (failed: 1)`。

**差异审计分歧修复轮**（当次实测，基线 `552 (failed: 0)` / `121 (failed: 0)`，单点变异跑完即逐条回退再复跑基线）：**宿主**——只把 `targets[].sessionId` 的修复回退 → `552 (failed: 1)`（F2 的 literal id 那条）；只把 `targets[].expr` 的修复回退 → `552 (failed: 1)`（F2 的 no-holder 那条，也就是审计插桩复现的两条路径）；把信封 `sendCardEnvelope` 回退成直传 `request.meta` → `552 (failed: 1)`（`meta.ref` 那条）；两条同时回退（该轮加 B1 断言之前的基线）→ `549 (failed: 2)`；**客户端**——把 A 面退回修复前的形状（head/body/summary/foot 也渲染）→ `121 (failed: 4)`，其中并集断言当场打印出被重复的 head / 正文 / 汇总三句。

**评审 round-1 🔵 收尾轮**（当次实测，逐条先插断言跑红、修完复跑基线）：基线 `552 (failed: 0)` / `121 (failed: 0)`；🔵 #3（header 按钮条并入 `guardedSlot`）——只插断言未修 → `123 (failed: 2)`（「其余三条照常落地」与「definition 不受牵连」两条同时红），修完 → `123 (failed: 0)`；🔵 #2（A 面行数渲染期封顶）——把 `SEND_CARD_ROW_LIMIT` 退回修复前的无界形状（`Infinity`，即原来的 `card.targets.map`）→ `130 (failed: 2)`（「行数有界」与「已截断标注」两条红，对照条仍绿），还原 → `130 (failed: 0)`；🔵 #1 是纯注释修正（`lib/index.js` 文件头的空闲投递语义由 `inject` 改为 `followup`），无断言可变异，其事实由同一文件的 `if (running) target.steer(message); else target.followup(message);` 与 README 的 followup 语义互为对照。

**宿主侧 `targets` 行数界轮（§10.1.2 2026-09-19 修正的收口）**（当次实测：先把 12 条新断言插进**无界**的宿主形状跑一次留证，再补上限复跑）：插入后未修 → `564 (failed: 3)`——「卡内恰 24 行」「卡自身带 `targetsTruncated` 标注」「标注紧跟 `targets`」三条同时红，而对照三条（「恰 24 行不截断」「≤24 行卡不多一个键」「≤24 行的计数与报告行数仍是 24」）与「summary 仍为全量」「文本报告仍 30 行」「30 个目标都真收到」当场全绿；补上 `SEND_CARD_ROW_LIMIT = 24` 的裁剪与标注后 → `564 (failed: 0)`，客户端 `130 (failed: 0)` 零改动零回归。红相里「保留行是报告的前 24 行」「卡仍是无损 JSON」两条本来就是绿的：前者在**无界**形状下对全部 30 行逐一比对了报告里的同一身份（有界后同一条断言只覆盖前 24 行，仍是同一条比较），后者与行数无关。

**跨轮交互缺口收尾轮（客户端读宿主的 `targetsTruncated`，§10.1.2 / U14）**（当次实测：先插 8 条断言、`lib/client.js` 一字未改跑红留证，再补客户端读路径复跑）：红相 → `138 (failed: 3)`——「A 面出截断标注（占位符 24）」「标签显示真值总数 30」「两类超限都能在界面上看出来」三条同时红（宿主自产的 24 行卡只画出 24 行，既不出标注、标签又把已画行数 24 当成了总数），而对照五条当场全绿（「宿主形回执照常成卡」「画出的恰是宿主保留的 24 行」「形状不认的标注被丢弃且不凭空出标注」「标注里的假 `shown` 不得进句子（句子报实际画出的 24）」「无标记且 ≤24 行的卡无标注且标签是自身行数」）；补上 `readTargetsTruncated`、`sendCardTargetTotal` 与 A 面按标注出标注后 → `138 (failed: 0)`，宿主 `564 (failed: 0)` 零改动零回归（本轮未触碰 `lib/index.js`，宿主侧行为零改动）。

**② 收口轮：U19 红线回归 + 并发纪律（§10.3 / §10.2.6，当次实测 `656 (failed: 0)` / `138 (failed: 0)`）**：本轮**只加断言，`lib/index.js` 一字未改**（G2 的约束已经写在树上）。**红相**：断言插入后首跑 → `656 (failed: 5)`，五条全是**断言自身写错**而非实现缺陷——`!/ctx\.session\b/` 被 `ctx.sessionQuery`（只有 `\b` 拦不住字母后缀）误伤；`import.meta.resolve("./lib/index.js")` 按**进程 cwd** 解析，写成相对路径会读到空内容（已改为 `fileURLToPath(new URL("./lib/index.js", import.meta.url))`，并按「换成别的 cwd 跑一次」验证它不再依赖启动目录）；导入面用**黑名单正则**判「无日志包」时误伤 `@deepseek-ai/dsh-session-reference`（上游深链解析器）——改为**六模块白名单**，顺带把「新增依赖偷渡写入 API」也堵上；统计 `参数名` 时按 `parameters.targets...` 取，而真实形状是 `parameters.properties.*`（键名是 `message` 不是 `text`、`required:["message"]`）；把「模块导出键」写成 `apply`/`inject`/`__testing` 三项，实测还有插件 `name`。五条据此逐条改正后 → `656 (failed: 0)`；`lib/index.js` 与 `client-half.test.mjs` 全程零改动，客户端 `138 (failed: 0)` 同期复跑确认零回归（本轮未触碰客户端两个文件，红相与绿相里它都照常全绿）。红相里另外 11 条**当场全绿**（三成员 `source`、`inject` 4 项、schema 8 键、双门三态、并发峰值恰 1），它们的作用是**把红线的判据本身钉住**，而不是重述 U16–U18 的实现断言：读的是**提供方侧**的读数（`agents` 服务桩的在飞计数、注册进去的命名空间 `base`、注册出来的工具 `parameters`），插件自报的形状改坏了也会红。

**并发纪律（§10.2.6「create 与 followup 串行（或 ≤2）」）**：本轮经实测确认该约束**已经在实现里**——`lib/index.js` 的 `createTeamSessions` 是**单条 `await` 串行循环**（全模块 `agents.create(` 恰一个调用点，先全部 create 完再逐个 `followup`），因此**没有新增任何有界队列/信号量**（那会是已绿实现的重复改造）。断言改为**从提供方侧测在飞峰值**：桩的每次 `create` 故意加 20ms，**实测峰值 1 ≤ 2**（若实现改成并行 fan-out，同一条断言会读到 2 而变红）；测试输出把这句读数原样打印出来（`measured peak 1 ≤ 2, N=2`），红相能直接说出它看到的数字，而不只是「越界了」。

**差异审计修复轮（🟡-1 的写面 + 全文计数与措辞，当次实测 `663 (failed: 0)` / `138 (failed: 0)`）**：这是**本仓库第一次在 `lib/index.js` 上做「同一事实两处写、只改了一处」的收口**。断言先落地、修复后补——**红相**（`adoptMemoryWindow` 的补丁仍是七键）→ `663 (failed: 3)`：三条同时红（「窗口内写下的 §10.2.6 意图并入后仍在」「并入的行逐字段完整」「并入恰是那八个 key」），而同组三条**前置**当场全绿——两个 provider 都迟到 ⇒ 整批在内存窗口内跑完；commands 迟到挂载不额外留行；worker-b 的 create 失败 ⇒ 它的意图未被回填。**前置全绿是这轮红相最有价值的部分**：它把「红色＝断言写错了」和「红色＝根本没走到那条路径」区分开。**绿相**：把 `pendingCreates` 补进那笔补丁 → `663 (failed: 0)`（宿主侧唯一改动），客户端 `138 (failed: 0)` 同轮无损。**基线是实测出来的、不是推出来的**：把新增的那一组断言整段从测试文件里摘掉再跑一次 → `656 (failed: 0)`，与 ② 收口轮自报的 656 一致；本轮新增**恰 11 条**（`674 − 663`），与「② 收口轮的 WIP = 640」这种算法无关。本节的分母（656）与分子（663）都取自套件自己在结尾打印的那一行。

**差值的来历（差异审计修复轮第 2 轮，🟡-1 的写面 + 全文计数与措辞）**：那轮新增断言恰 7 条（656 → 663）。**计数勘误（差异审计修复轮 🔵-4）**：本仓库此前的计数习惯是「上一版计数 ± 本轮新增条数」，这个习惯在 ② 收口轮算错过一次——**639 与 640 的差别**（`506 + 133 = 639`，而 `656 − 16 = 640`）就来自这里；那一轮 WIP 提交**自带的 README 记的是 639**（提交时内部自洽），640 只是事后从 656 反推出来的数。本轮起一律以 `assertion total:` 那一行为准；`check(` 调用点个数会略有出入（存在被注释掉或落在未执行分支里的调用点），**不作为计数来源**。

**文法面收尾轮（代码评审的 3 🟡 + 2 🔵，当次实测 `675 (failed: 0)` / `138 (failed: 0)`）**：两条 🟡 是**同一个文法面的两个缺口**，同批修——① `bare` 只收集不消费（`readTeamSessionCommand` 把位置参数收进 `value.bare`，`teamSessionPlan` 只读 `roles`/`n`/`team`，于是 hint / description / 报错文案宣传的「位置参数写角色名」端到端不可用：照着报错提示再输一次，会得到同一个报错）；② `task=` 的注释写「取到行尾」而实现按空白切分，未加引号的多词任务把 `the`/`bug` **静默丢进被忽略的 `bare`**（与 ① 叠加成静默丢数据），带引号的任务又把引号字符留在值里。**修复取「让位置参数真正生效」**（而不是删宣传）：`bare` 折进 `roles`，`team=` 仍是必需 key（首个裸 token **不**兼作团队名——否则「首 token 当团队名」与「用户忘了 team=」无法区分，宁可报错也不猜）；`task=` 的取值读到行尾，遇到下一个**已知 key=** 才收界（所以 `task=… model=… preset=…` 这个从旧版就在的次序照旧成立），整段加一对引号时以闭引号收界且**闭引号之后不得再有内容**（否则报错，不静默丢）；`key="value"` 统一剥引号（半引号一律拒绝）。扫描器的正则另有一处**必须是自己的组**的坑：`(?:a|b|c)+` 的 `+` 只作用于最后一支，`team="t"` 会被切成两个 token。**红绿证据**：把 HEAD 的 `lib/index.js` 导出到 `.test-tmp/old-grammar/`（`git show` 取原始字节，落在仓库内**已 gitignore** 的临时目录里，不碰工作树、不提交）用**同一组断言**对比——红相 `roles=undefined` / 计划报「需要角色列表」、`task="fix"` 且 `bare=["the","bug"]`、`task` 值是 `"fix the bug"`（含两个引号字符）、`team="t"` 原样带引号；绿相全部反转。新增断言 **恰 11 条**（`674 − 663`；那 674 是修好实现后套件的**首跑全绿**读数，此后只再补了 1 条 `plannedId` 的按 role 取 id 断言，终态 `675`）。两道禁令内的取舍：`CHANGELOG.md` 本轮**未同步**（任务明令不得改），计数同步只落 README 三处。

**§11 ③a 自动换届主路径轮（`successor:"auto"` + 交接文档契约 + `/team_rotate`，当次实测 `735 (failed: 0)` / `138 (failed: 0)`，基线 `675`）**：本轮新增 **60 条**断言（`735 − 675`），分三批落盘、每批跑完全绿再往下（交接文档契约 → auto 编排 → 命令与文档面）。**红相不藏**：契约批首跑 `696 (failed: 3)`，三条一次都没猜中——① 头部 `team:` 是 `undefined`、② freeze 正文里的团队名是空的——**两条根因其实是同一个**（`writeHandoffDocument` 没有把 `team.name` 注进渲染器），③ 「事实源锁」读到「对称撤销」前缀在 `rotationFactRows` 的两个分支里各出现一次（把共同前缀抽成 `revokedHead` 后计数=1）；auto 批首跑 `719 (failed: 2)`，两条也都是**测试自己写错**：预期 pairs 字符串把 `a`/`b` 顺序写反、以及另加的对端对压根没进 fixture。**本轮与既有断言的三处「同改」**（都是清单/计数随新面增长，逐条改并留证）：① 第二个命令走进**同一个 `commands` seam** 后，「迟到服务挂上一条命令」变为两条（`definitions.length === 1 → 2`）；② 同因导致 U19 的 info 行数从 3 变 4——那条断言顺势改成**按种类点名**（`attach,chain,cmd-rotate,cmd-session`），比原来的裸计数更紧：多出**任何一类**新 info 行仍会红；③ `rotateEnv` 转发 `omitCommands`/`lateCommands`/`failCreateAt` 三个 fixture 开关。**红线回归照旧全绿**：模块级 `inject` 仍 4 项、`source` 恰三成员、policy 命名空间仍恰 8 键、全模块 `agents.create(` 仍**恰一处**（auto 路径复用同一个 `createRootAgent`）、一次完整 auto → claim 的宿主动作日志只有 `create`/`followup`。**边界**：`CHANGELOG.md` 本轮未同步（任务明令不得改），**该缺口已在后续提交 `7236ce8` 补齐**——0.3.7 的三段未发布条目（① 发送方可见性 / ② `/team_session` / ③ 换届与恢复）现在都在仓库的 `CHANGELOG.md` 里，计数同步只落 README（徽章 + 测试节两处）。

**§11 ③b 恢复工具与诊断面轮（§11.9.3–§11.9.5 / U25–U27 / U29，当次实测 `783 (failed: 0)` / `138 (failed: 0)`，基线 `735`）**：新增 **48 条**断言（`783 − 735`，分三段：诊断面 10 条 / L1 revive 19 条 / L2 reappoint 17 条 + 文档面 2 条），三段落盘（诊断面 → L1 revive → L2 reappoint），每段跑完全绿再往下。**本轮的三处「同改」**（都是清单随新面增长，逐条改并留证，且都有断言锁住）：① `roleRecord` / `normalizeRoles` 新增角色行内字段 `recoveries`，**同一批**必须改到四个读面（`roleRecord`、`normalizeRoles`、`renderRosterMirror`、`roster get` 详情行）——锁是「恢复记录同时出现在镜像与工具读面上」两条断言；② 测试骨架的 `agents` 桩**新增 `resume` 面**（`resumeRecords` / `resumeCalls` / `resumedAgents`，且**复活要同时发布进注册表并解除 `hidden`**，否则「复活后 writerGate 直接放行」这条断言测不到真东西）；③ `rotateEnv` 转发 `omitResume` 与 `extraAgents` 两个 fixture 开关（`REAP_DEAD` 必须先**注册**再隐藏——隐藏一个未注册的 id 是 no-op，`hidden` 只会对真存在的注册项生效）。**红相不藏（本轮实测到的四个）**：① 三处 gate 富化在**第一版只改了调用点、没改 rotate 的入口**——`rotateGate` 的富化没生效，`diagPrepare` 一条诊断字都没有（红后补 `withLiveGateDiagnostic` 到 prepare 的拒绝路径）；② `revive` 的 roster 镜像**读的是 pre-write 的 roster**，于是刚写下的 `recoveries` 在落盘文件里凭空消失（红后改为从**写入后的** roster 渲染）；③ `version-note` 原本把英文的 `seated-dead` 烙进 `roster.md`，与 U25 的「镜像里一个活性词都没有」直接对撞——改成设计自己的理由词 `vacant-due-to-death`（§11.9.5⑦ 原文），活性读数只留在 `decisions.md` 与工具答复这两个**事件面**；④ `reappoint` 走既有 `prepare` 时被 `rotateGate` 挡在门外（死现任的会话不是调用者），红后按 §3.6.2 原文的 `|| userInitiated` 给 `prepareAdmission` 加了 `userInitiated` 开关——**只跳过那一项授权检查，其余（self-succession、速率限制、团队/角色存在）照跑**。**红线回归照旧全绿**：模块级 `inject` 仍 4 项、`source` 恰三成员、policy 顶层键仍八项、`writerGate` 原样、`claim` 一字未改（`reappoint` 复用它，不新增令牌类型）、全模块 `agents.create(` 仍恰一处、恢复路径的宿主动作日志只有既有的 `create`/`followup`/`resume` 三种。**边界**：`CHANGELOG.md` 本轮未同步；真机验证（H1/H4 + ③a 的 H3 + 演练 10）仍未做，与设计 §11.9.9 的「本节不可验项」一致。

---

**DEFECT-1：真机缺陷 #1「会话建得出、跑不起来」修复轮**（真机现象 `本轮运行失败 / prompt variable "{{model}}" has no value for this assembly (section "deployment:persona-prefix")`；当次实测 `793 (failed: 0)` / `138 (failed: 0)`，基线 `783`）：
**根因**：`buildTeamSessionCreateOptions` 只在 `plan.preset !== undefined` 时才写 `meta.agentPreset` 并 `agentPresets.mount(...)` ⇒ 不传 `preset=`（`/team_session` 的默认）时**整条 preset 路径被跳过**，新建 agent **没有任何 persona-prefix 组装源**，首回合起不来。官方模板 `dsh-webhook` 的 `createWebhookSession` 不是这么做的：它 `await ctx.agentPresets.resolve(resolved.agentPreset)` → `standingKeyFor(preset.id)` → `meta:{ cwd, agentPreset: preset.id }` → `setup` 里 `mount(agentCtx, preset.id)`，**总是解析出一个 preset（缺省也解析）并挂载**；本插件把它做成了「有才挂」。
**修法**：按模板改为**缺省也解析**（`resolve(plan.preset)`，`undefined` 即宿主的 `defaultId`）→ `standingKeyFor` → `meta.agentPreset` → `setup` 里 `mount(agentCtx, preset.id)`；`buildTeamSessionCreateOptions` 因此变成 `async`（`meta` 必须在 `agents.create` **之前**拿到真实 preset id），两个调用点同批加 `await`。**唯一允许跳过 preset 面的分支是服务缺席**（仍降级为**每个新建会话一行 warn**，且那行点名「没有 persona-prefix 组装源」）；服务在、`resolve` 抛错（未知 id / 组成装不上）一律**传播**：批次如实报「创建失败」且零创建 —— 宁可不建，也不建一个没有组成源的会话。
**影响面（同批修）**：③a `successor:"auto"` 复用同一个函数 ⇒ 不修则换届会失败在「继任者跑不起来 ⇒ 无法 claim」，而令牌已经投给它、旧任已经冻结（信任迁移路径上的失败）。本轮对 ② 与 ③a 两条路径都补了「不是『建出来了』，而是**同一个会话既在 `meta` 里记着某个 preset、又真被挂到那个 preset 的组成上、且恰一次**」的判据。
**红绿证据（断言先落地、修复后补）**：新增 **11 条**断言、摘掉 **1 条**旧断言（旧的「U18 降级: 无 agentPresets ⇒ 会话照常可用」的前提正是被真机推翻的那句话，由新的降级组取代），净 **+10**（`783 → 793`）。**红相**：断言插入后、`lib/index.js` 一字未改 → `789 (failed: 7)`，七条一次全中（`U20 自建继任者` 的 `meta` 断言 + 缺省解析 / 总是挂载 / 判据是「能用」/ 显式 `preset=` 同一条代码 / 降级分支 / 未知 preset 不静默降级）；**其中「降级那行 warn 说清后果」一条在红相里空转通过**（零条 warn 时 `every()` 恒真）——当场给它补上「恰 2 条」的计数前置条件，红相里它是 0 ≠ 2，同一处判据不再可能空过。**绿相**：修完 `lib/index.js` → `789 (failed: 0)`（② 段），再补 ③a 的四条 → `793 (failed: 0)`（客户端 `138` 全程未触碰）。
**本轮的三处「同改」**（都由同一条事实驱动，逐条改并写进断言）：① `U20 自建继任者` 的 `meta` 断言由 `["cwd"]` 改为 `["agentPreset","cwd"]` —— 设计 §11.4.2 本来就写的是 `meta` 只放 `{cwd, agentPreset}`，是断言跟着当时的实现写窄了；② 测试骨架的 `setup()` **新增 `agentPresets` 服务桩**（默认提供，与 `commands` 同款：`resolve` 把 `undefined` 当宿主 `defaultId`、`mount` 拒绝无身份的上下文并记录 `(agentId, id)` **绑定对**）与 `omitAgentPresets` 降级开关，`teamSessionEnv` / `rotateEnv` 各自转发该开关；`makeAgents` 交给 `setup` 的上下文带上 `agentId`（真服务用 `scopeOf(agentCtx)` 认 agent，桩用同一处身份回答「哪个 agent 被哪个 preset 组成」）；③ 两处确认框文案同改——`teamSessionDialogText` 与 `rotationAutoDialogText` 的「模型/预设」一行在缺省时不再什么都不说，而是写明「宿主缺省 agentPreset（缺省也解析并挂载）」。
**边界**：`CHANGELOG.md` 本轮未同步（任务明令不得改）；`docs/` 由父代理同步；真机复验（按缺陷记录第七节的四步复现）仍需一次用户批准的窗口。

---

**DEFECT-2：真机缺陷 #2「编程创建的会话未挂进工作区」修复轮**（真机现象：H1 探针建的 `team-link-h1-probe-worker-1-<8hex>` **在盘上存在、`cwd` 也对**，但用户在侧边栏看不到，得手动切工作区才找得到；当次实测 `806 (failed: 0)` / `138 (failed: 0)`，基线 `793`）：
**根因**：§10.2.2 的模板引用只给了**形状**（`meta` 只放 `{cwd, agentPreset}`），没给**时序**。`dsh-webhook` 的 `createWebhookSession` 是一串**创建后动作**：`workspaceRegistry.create(path)`（`:96`）→ `meta.cwd = workspace.path`（`:103`）→ `agents.create` → `workspace.attachSession(sessionId)`（`:115`）→（失败）`detachSession` + `dispose`（`:135-147`）。本插件只做了 `meta`，全库 **0 处** `attachSession` ⇒ 会话没有工作区归属，侧边栏按工作区分组时列不出它。与 DEFECT-1 是**同一个成因模式**（模板有一组创建后必须做的事，我们只做了一部分）。
**修法**：把模板时序落成**一个函数**（`createRootAgent(ctx, rootCtx, plan, entry, cwd)` —— 全模块唯一的创建落点，② 与 ③a 共用）：`openTeamSessionWorkspace`（`ctx.get("workspaceRegistry")`，与 `agentPresets` 同款的创建时取用）→ `meta.cwd = workspace.path` → `agents.create` → `attachTeamSession`（attach + 模板回滚）。服务缺席是**唯一**允许跳过 workspace 面的分支，且**每个新建会话恰留一行 warn** 点名「未挂进工作区，可能不会出现在侧边栏」；服务在而 `create` 抛错则**传播**（批次按「失败即停」如实报，零创建）。
**与模板的一处有意差异（已写进代码注释）**：模板用 `attached` 标志门着 detach，这里**无条件**调 `detachSession`（幂等）。理由：真实 `attachSession` 先 `host.rememberSessionPath()` 再写记录，写记录抛错时 `attached` 仍是 false，而会话已在 registry 的路径索引里——那个标志会跳过真正需要的回滚。判据里因此专设一条**半成品**对照（已写进成员名单之后才抛 ⇒ detach 仍被调用、名单里不留它）。
**本轮的「故意不做」清单（模板有、我们不做的每一步与理由，交设计裁定）**：`permissionPresets.resolve/set`（`/team_session` 没有权限档参数，设计契约里也没有——不替用户选档）、`sessionTitle.rename`（设计逐字契约里没有标题，三个 worker 该叫什么属于用户可见的交互决定，不自造）、`agentDefaultModel.currentSelection()`（缺省模型由宿主自己决定，命令确认框写的就是「（本会话默认）」；我们只在调用方给了 `model=` 时才装 `agent/request` 钩子）、`signal.throwIfAborted()`（webhook 注册生命期语义，本路径在一条命令内完成；补它要改两处调用点签名与断言面，属另一轮）、`snapshotDelivery` 与 `WebhookRuntime` 的 6 项 `inject`（webhook 投递侧与本插件的红线——模块级 `inject` 仍 4 项）。
> **⚠️ 前向指针（2026-09-20 补，本清单保持原样——它是那一轮如实上交的记录）**：上面 `agentDefaultModel.currentSelection()` 那一条**后来被真机推翻**：宿主缺省只在宿主**自己的装配流程**里生效，而由 `agents.create` 造出来、不带 `agentOptions` 的 agent 走不到那里 ⇒ `deployment:persona-prefix` 的 `{{model}}` 无值、首回合直接失败（`本轮运行失败 / prompt variable "{{model}}" has no value`）。见真机缺陷记录 **DEFECT-3**（`DEFECT-3-model-selection-missing.md`，落在会话工作区目录 `dsh-session-link-pro/.goal/` 下）与本节的「DEFECT-3 收尾轮」条目（CHANGELOG 的 0.3.9 收尾条目由父代理同批同步）。**教训**：列入「故意不做」的每一条都是**一条未经证实的判断**，「我认为宿主会兜底」不是判据。
> **⚠️ 前向指针 2（2026-09-20 补，DEFECT-4）**：同一份清单里的 `sessionTitle.rename` 那一条**也被真机推翻**——**不设标题不等于不替用户决定**：宿主给新会话的默认标题就是工作区名，于是**同一批 worker 在侧边栏里全部同名、互相无法区分**。现在 ② 与 ③a 共用的那**一个**创建落点会按已有的结构化信息给每个新会话设一个可区分的标题 **`<team> · <role>`**（缺一则回落 `<team>` 或会话 id 短前缀，**绝不回落成工作区名**；`ctx.get("sessionTitle")` 取服务、不进模块级 `inject`，服务缺席或改名失败只留一行 warn、**不阻断创建**——那是呈现面，不像 preset/模型选择那样决定会话能不能跑），并在确认框与回执里**说明设了什么标题**、**想改随时在壳里重命名**。
>
> **标题长度边界（同日补）**：上游 `dsh-session-title` 按 **`maxTitleBytes: 80`（字节）剪尾巴、不追加标记、不拒绝**，而团队名只受 `[a-z0-9-]+` 约束、**没有长度上限** ⇒ 若把 `<team> · <role>` 原样交出去，**超长团队名会把 role 段剪没**，使同队两个 role **撞成同名**（实测 `distinct: 1 of 2`）。因此派生时**团队段先截、role 段完整**（UTF-8 安全截断 + 省略号；团队段连前缀都放不住才退成「只有 role」，**不是**工作区名、也不留空的 `<team> · `）。**未给团队名新增任何长度约束**（那是接口变更）。边界如实：role 自身 >76 字节时任何方案都装不下，此时给非空省略号前缀。
**红绿证据（断言先落地、修复后补；红相在 `%TEMP%` 的独立 harness 里跑「新断言 × 修复前的 `lib/index.js`」快照，绿相在仓库树上跑）**：新增 **13 条**断言（`793 → 806`），**红相** `806 (failed: 11)` —— 11 条一次全中（② 的 create/attach/成员名单/`meta.cwd` 来源/降级 warn + ③a 的继任者与降级 + 回滚两条 + 半成品 + 源码锁），**另外 2 条在红相里就是绿的**（② 的「服务缺席降级不阻断创建」与 ③a 的「同一份判据」——它们描述的是**降级与同源**这两个不变量，修复前的树本来就满足，作用是把判据钉住而不是复述实现），且**修复前的树上 795 条既有断言全绿**（新 fixture 零回归）；**绿相** `806 (failed: 0)`；客户端 `138 (failed: 0)` 全程未触碰。第一版绿相曾 `806 (failed: 2)`：两条**源码级**锁（`.attachSession(` 计数、U19 的 `agents.create(` 计数）被我自己新写的注释文本误伤（注释里写了 `agents.create(...)` 与 `workspace.attachSession(sessionId)`）——改注释措辞而不是放宽锁，锁的严格度不动。
**本轮的三处「同改」**（都由同一条事实驱动）：① 测试骨架新增 `workspaceRegistry` 服务桩（默认提供：`create` 记录路径并返回带 `sessionIds` 成员名单的 workspace、`attachSession`/`detachSession` 记录并改名单；`omitWorkspaceRegistry` 降级开关 + `workspaceRegistryOptions` 透传 `refuseAttach` / `registerThenRefuse` / `normalize` 三种 fixture），`teamSessionEnv` / `rotateEnv` 各自转发；② 新的读数 `workspaceBindingOf` / `workspaceBoundOnce` 按**会话 id** 配对（不按位置），② 与 ③a 共用同一份判据；③ 源码锁从「一处 `agents.create(`」扩到「`.attachSession(` / `.detachSession(` / `agents.create(` 各恰一处」。
**边界**：`CHANGELOG.md` 与 `docs/` 本轮未同步（任务明令不得改；§10.2.2 的「模板完整时序」由父代理写进设计）；真机复验（重启后建一个 worker，看它是否**直接**出现在调用会话所在工作区的侧边栏里，无需手动切）需要一次用户批准的窗口。

**③a 差异审计分歧修复轮（宿主侧 🟡-2/🟡-3/🟡-4/🟡-6 + 🔵-1/🔵-3，当次实测 `820 (failed: 0)` / `138 (failed: 0)`，基线 `806`）**：本轮新增 **14 条**断言（`820 − 806`），逐条对应审计的处置清单（`.goal/round-26-3a-audit-dispositions.md`）。
**🟡-2（唯一实质项）「§11.5 点名插件自建继任者」原来只在一个激活窗口内成立**：判据是内存态 `hasHandle`，而**插件重载会清空 handle 注册表**——盘上的 pending 仍在、清扫照跑、点名行却静默消失（审计实测同窗口 4 行 → 换激活后 3 行），而那**正是设计要防的「没人知道的孤儿」窗口**。修法：判据改为**持久证据优先**——① 交接文档头部 `successor:` 行（读目录，重载不动；**只认最新那一份**，因为一个 token 若还 pending，它必然是最后一次 prepare 的，旧文档里的同名 id 属于已被取代的换届）→ ② 落盘的 `pending-create` 意图（创建前写、prepare 成功后才删；它还在说明收尾那步失败了）→ ③ `hasHandle`（本激活的读数，降为**附加佐证**）。点名行还会**自报判据来源**（「判据取自落盘的交接文档头部 successor 行 / 落盘的 pending-create 意图 / 本激活窗口的 AgentHandle 注册表」），读者一眼能分清耐久证据与内存读数。
**红相（跨激活，修复前必红，实测留证）**：把「持久证据优先」那一支临时短路（其余一字不动）→ 跨激活断言红，报 `{snapshotHadPending:true, documentOnDisk:true, cancelled:1, naming:0, pendingCleared:true, currentKept:true}`——**pending 被正常取消、`rotation-cancelled` 照发、旧任仍为现任，唯独点名行消失**，与审计描述的失败形状（同窗口 4 行 → 换激活后 3 行）逐字一致；恢复后绿。同一红相里「三层来源各司其职」那条也红（`document.evidence` 从 `handoff-document` 掉到 `none`，`handle` 顶上来当了唯一来源——那正是修复前的行为）。
**🟡-3 五个硬节名「一处名字、四处写」，其中两处宣传面无断言**：把真源 `HANDOFF_HARD_SECTIONS` **上提到 §11.2 段首**（`handoffDeliveryMessage` 与 `team_link_rotate` 的 description 都在那一段里读它），并让**投递正文**与**工具 description / handoff 参数**全部经 `handoffSectionsInline()` 渲染。锁是双向的：源码里那份完整名单**一处都不许手抄**（实测 0 处）+ 三处宣传面**运行时**渲染出的就是真源那一份 + `unknownz`/`missionz`/`inflight`/`taskandgoal`/`firstactions` 这类漏改变体一个都不许出现。**红相**：把 `handoff` 参数 description 里的 `unknowns` 改成 `unknownz` → 「三处宣传面」与「没有第二个拼法」两条同时红（修复前这种变异**全绿**）。
**🟡-4 键表只锁单向**：`TEAM_ROTATE_KEY_HINT` 现在**从 `TEAM_ROTATE_KEYS` 渲染**（`TEAM_ROTATE_KEY_HELP` 是每键的说明表），并在测试里加**操作性**的反向锁——任何不在广告里的键都必须被**解析器**拒绝、且拒绝文案印的就是广告那一份。**红相**：给 `TEAM_ROTATE_KEYS` 加一个 `shard`（审计的 M5b 变异）→ `unknownRefused:false` 当场红。**这一轮的红相还暴露了我自己第一版锁的弱点**：只比「广告集合 == 接受集合」是**同义反复**（广告是渲染出来的），所以反向锁必须落在**解析器行为**上，这条修正是本轮值得记下的教训。
**🟡-6 拒绝文案把显式 successor 误标成 `successor:"auto"`**：文案里的路径标签改为**按当次调用的 `successor` 形态渲染**（`options.auto` → `successor:"auto"` / `显式 successor`）。两处阶梯的**缺硬节**那条同时服务两种形态，所以它是这条修正的真判据：auto 下写 `successor:"auto"`、显式下写「显式 successor」，都不被标成对方；而**正文缺失**那条今天只有 auto 会产出拒绝（显式 successor + 无正文 = 放行 + 警告，§11.9.6），这一点也单独断出来，免得把「显式形态在这条上没有拒绝」误读成修正没生效。
**🔵-1 一次改名就让套件崩溃**：`readHandoffArgument(handoffBody(["team-map"]))` 在名单改名后返回 `{error}`（没有 `warnings`），而断言直接读 `.warnings.join()` → `TypeError` 中止进程、**连 `assertion total` 都不打印**（掩盖后续断言）。修法：该处改为对 `undefined` 安全（`(parsed.warnings ?? []).join()`），并**另加一条对照断言**把同一个状态单独说清（「改名后那份正文是缺硬节而不是缺软节」），免得护栏把崩溃变成空过。同一轮里还有三处「红相不是干净红」被一并钉住：`tokenOf` 在无令牌时返回 `""`（原来返回 `undefined`，而工具调用桥不接受 `undefined` 参数——`INVALID_ARGS` 把 FAIL 变成崩溃）、`U21 红线` 与 `U20 意图闭环` 加了判据前置、诊断渲染统一走 `show()`（`JSON.stringify(undefined)` 返回 `undefined`，同样会让 harness 抛 `INVALID_ARGS`）。**红相**：把 `unknowns` 整处改名 → `820 (failed: 41)`，套件**跑到底并打印 `assertion total`**（修复前是 7 条红后 `TypeError` 中止）。
**🔵-3「全模块唯一构造器」措辞偏大**：实测 `{kind:"agent-message", form:"relay"}` 有 **3 处**字面构造（`relayUserMessage` / 看门狗 `tickMessage` / §3.4 `team_link_send` 投递），**三处都恰三成员**。代码注释 `relayUserMessage` 的原文「every relay this plugin **drives**」是准确的，但容易被读成全模块唯一——已改成**带范围**的表述并列出另外两处及其各自不能共用该构造器的理由；README 的「消息形状」一节同批补了同一句话（三处一起改，冒出第四处才是缺陷）。
**本轮的「同改」清单（该类缺陷今晚已出现五次，逐条留证）**：① 真源数组**上提**到 §11.2 段首（读者与真源同段，否则 §11.5 段首的 `handoffDeliveryMessage` 读不到它）；② 两处宣传面由手抄改为**渲染自真源**，连带删掉 `readHandoffArgument` 警告行里那份手抄的 `HANDOFF_HARD_SECTIONS.join(" / ")`；③ `TEAM_ROTATE_KEY_HINT` 由字面量改为**渲染自钥表**；④ 测试骨架新增「重载窗口」最小上下文 fixture（**不能复用 `rotateEnv`**：它的 settings 存根把 `register(namespace)` 与「种入 state」绑在一起，而新策略存储自己会再 register 一次 ⇒ state 被重置成空，那样测的是「另一个空命名空间」而不是「重载后还认不认得」）；⑤ README 计数（徽章 + `npm test` 行 + 判定行）按当次实测同步为 `820`。

**③b 差异审计分歧修复轮（Y1/Y2/Y3/Y4/Y7 + B1/B2/B3/B5/B6/B7，当次实测 `831 (failed: 0)` / `138 (failed: 0)`，基线 `820`）**：本轮新增 **11 条**断言（`831 − 820`），逐条对应 `.goal/round-3b-audit-dispositions.md`。

- **Y1 宣传面 vs 实现面**：工具描述与 README 曾写「本工具**只受理 coordinator**」，而 `reappoint` 接受**任意角色**（窄域检查只在 `reviveIncumbent`）。裁定是**改描述、不改行为**（授权从不源自 coordinator 身份，唯一来源是对话框里人类那一下点击）。两处改成诚实口径（「`revive` 仅 coordinator；`reappoint` 受理任意角色」），并加**一条双向锁**：非 coordinator 角色在 `reappoint` 下真铸出三元组令牌 + 真落 `rotationBackup` + 真广播 freeze（有人给它加回 coordinator 守卫即红），同一角色走 `revive` 仍被窄域拒。
- **Y2 发起域（§11.9.5 正文 469 行）原来是空的**：`caller` 只用于留痕，**与团队无关的活会话、甚至没有会话身份的调用者**都能发起并铸令牌。现在落成硬集合：发起者 ∈ {该角色**最近一任前任**} ∪ {团队**现任成员**}，域外拒绝并**点名现任成员集合 / 该角色前任 / 调用会话**，且指出**设置 UI（R2 级，用户在那里是超级写者）仍是永远可用的出口**。三半各有一条断言（非成员活会话被拒、无身份被拒、前任可发起），`role` 缺省诊断读态不受此限（零写入）。**代价如实声明**：不属于本队的活会话不能发起恢复——有意的收窄。
- **Y3 空锁（该类缺陷第七次出现）**：把 `reapIncumbent` 的**身份**复检删掉曾是 820 全绿——同一句「现任已复活，无需恢复」由幸存的**活性**复检产出。现在两条路径**各说各的话**（身份：「该角色的现任已不是 X（现在是 Y）——本次的身份主张已过期」；活性：「已经有活动代理了——现任已复活，无需恢复」），并加一条**只能由身份复检回答**的判据：现任 id 变了但**新现任是死的**（活性复检对它为假），把身份复检删掉那次调用会一路铸出令牌。
- **Y4 红线⑧ 没有断言咬住**：入口 `rotation.sweep(...)` 换成 `{lines: []}` 曾是 820 全绿。现在有一条**行为**锁：过期的 pending 必须在恢复**自己**的前置检查之前被清扫——断言读「恢复没有被那句『已有在飞的换届令牌』误拒」+「答案里带着清扫自己的取消行」+「盘上那枚过期令牌真的被这一趟清掉了」。
- **Y7 脏红**：`revivePost.recoveries.length` 缺 `?? []` ⇒ 一处 break 就在该行崩、**无 `assertion total`**。补护栏，并**扫了一遍同类未护栏的访问**（`.length` / 下标取值 / `.join`），新增 `at()` 助手把 9 处深链访问收进断言：任何 break 之后套件都跑到底并打印总数。
- **B1**：`recoveryRateLimited` 的后半段与 `rotationRateLimited` 的 `rotationAt` 支**条件完全重合、永不触发**（`RECOVERY_RATE_LIMIT_MS === ROTATION_RATE_LIMIT_MS`）⇒ 删除重复实现，改为委托同一个函数（一条规则一处实现）。**B2**：恢复的拒绝文案写「零写入」，但入口 sweep 可能已真取消过期令牌并写 settings/广播 ⇒ 与 §11.9.6 同款收窄为「**本次恢复调用自身**零写入」。**B3**：候选对话框 `multiSelect: true` 而调用方只取 `picked[0]` ⇒ 改**单选**（盒子不许承诺代码不会做的选择）。**B5**：多处注释称「未声明的字段会被 settings provider 剥掉」——**实测不成立**（`schemastery` 不做 strip，这正是 `recoveries` 能存活的原因），注释按实改准。**B6**：导出块的 `.test-tmp/` 并入收尾清理（此前每跑一次留 2 个文件）。**B7**：README 的「`CHANGELOG.md` 本轮未同步」在 HEAD 已不成立（`7236ce8` 已补）。
- **红/绿证据（实测）**：`reappoint` 加 coordinator 守卫 + 发起域改成恒真 ⇒ `831 (failed: 3)`（Y1 一条 + Y2 两条，对照组全绿）；删身份复检 + 入口 sweep 短路 ⇒ `831 (failed: 2)`（Y3/Y4，套件跑到底并打印总数）；恢复审计行整段摘掉 ⇒ `831 (failed: 7)`。Y7 的护栏另用独立 harness 对照**同一失败状态**两种写法：无护栏 → `TypeError` 中止、**连输出都没有**；有护栏 → 跑到底并打印 `assertion total: 3 (failed: 1)`。恢复首跑全绿（`831 (failed: 0)`）。

**A 面逐目标行措辞轮（2026-09-20 用户决定：改从结构化字段渲染一句人话，设计 §10.1.5 修订 + §12.5；当次实测 `833 (failed: 0)` / `146 (failed: 0)`，打印合计 **979**，基线 `831` / `138`）**：本轮**只改客户端**——`lib/client.js` 的 A 面行从「目标 + outcome + **`target.detail`**」改为「目标 + **outcome 的一句人话短语** + busy 徽标」，`detail` 仍留在回执里；`lib/index.js` **一字未改**（只在红相里被临时注入过一个字面量，见下）。**红相（跨半边锁的「新增枚举值 → 必红」）**：往 `lib/index.js` 的 `buildSendCard` 摘要分支里注入一行 `if (target.outcome === "no-queue") …`（一个**宿主能铸、客户端无短语**的新枚举值，正是「A 面没有它的短语就必须红」的字面场景），实跑 → `833 (failed: 3)`：三条 §12.5 断言同时红，且**报出判据本身而不只是「不等」**——`both halves were really read (host mints 5 literal outcome tokens, the client phrases 4)`、`every outcome token the host can mint has a client phrase — a new enum value without one is RED (unphrased: no-queue; host: delivered,no-agent,no-holder,no-queue,refused; client: delivered,no-agent,no-holder,refused)`、`… the two sets are EQUAL, so neither half can drift alone`；**注入行已逐字回退**（`Select-String` 实测 `no-queue` 0 处）。**绿相**：回退后复跑 → `833 (failed: 0)` / `146 (failed: 0)`。**本轮换掉的锁（不是新增一条空锁）**：B1 那轮钉的「卡内行 == 报告首行」**等式作废**（它锁的是一个已被设计替换的渲染，而且在「同源化」之后**由构造保证永不红**，§12.3 ⑤），换成上面那把**跨半边行为锁**——「新增/改一个 outcome 枚举值而不给客户端短语 → 必红」，红相里它是真的红了。**新增断言（客户端 +8、宿主 +2）**覆盖：行文本逐字改为「已送达 / 未送达——接收方拒绝 / 未送达——该角色当前空缺」且**不含 `detail` 句**；四个 outcome 短语键各不相同、两本字典都声明、键名不漏成文本；**降级路径零回归**（无 meta / 旧形状 / 12 种坏形状 / 抛异常的 getter 仍回退纯文本行）；字典键集一致且**旧行用过的六键已从两本字典消失**（不留死键）；busy 徽标两态（「忙碌 · 已运行 7 分钟」/「忙碌中」）且**不再出现 steer 机制文案**；F1 两面信息分工的并集断言照常全绿（`rowStatements.length === 4` 未变——行仍是一行、明细没回来）。**对照的逐目标行文本（本机实测）**：

```
改前  session-worker-a（via team:night-shift/*） 已投递 已投递到 session-worker-a（已配对通道，免确认自动投递）：目标空闲，已唤醒目标会话并作为新回合处理。
改后  session-worker-a（via team:night-shift/*） 已送达

改前  session-worker-b（via team:night-shift/*） 被拒绝 未投递：目标会话用户未确认接收。
改后  session-worker-b（via team:night-shift/*） 未送达——接收方拒绝

改前  team:night-shift/reviewer 空缺目标 该角色当前空缺
改后  team:night-shift/reviewer 未送达——该角色当前空缺
```

**边界（如实声明）**：该轮的 `CHANGELOG.md` 当时**未同步**（不在其允许清单里）；**父侧已于 `e7a54ea` 补齐**——0.3.8 的「A」条现在写的就是「逐目标行 = 目标身份 + `outcome` 短句 + （忙碌时）徽标；`detail` 仍留在 meta 里、只出现在模型可见的报告」。

**合并代码评审收尾轮（2026-09-20；当次实测 `836 (failed: 0)` / `146 (failed: 0)`，打印合计 **982**，基线 `833` / `146`）**：评审 **PASS**（1 🟡 + 3 🔵），四条全部处置。

- **#1（唯一 🟡）`revive` 侧身份复检的半空锁 → 行为锁**：`reappoint` 侧已有行为锁（Y3），而 `revive` 侧**没有任何断言单独咬住它**。新增**逐字对称**的两条：`Y3-sym`（对话框挂起期间把该角色改任给**另一个（死的）**会话 ⇒ 活性复检读的是 preflight 捕获的 incumbent、响不了 ⇒ **只能由身份复检拒绝**；断言拒绝文案点名「该角色的现任已不是 … / 现在是 …」且**不含**「已经有活动代理了」，并断言 `resumeCalls.length === 0`、零 `recoveries`、零 `rotationAt`）与 `Y7-sym`（现任 id **没变**、只是复活 ⇒ 由**活性**复检回答）。**红相实测**：把身份复检**整段注释掉** → `835 (failed: 1)`，**唯一红的就是 `Y3-sym`，`Y7-sym` 与全部既有 revive 断言仍是 PASS**——这正是「半空锁」的实证。
- **#3 四处机械拼接的排版残留 → 已清理**（`lib/index.js`），附**三层「纯空白」证明**：① 正则 `[;,}]\t+[^\s*]` **4 命中 → 0 命中**；② 逐处「前形态已消失、后形态各恰一次、**空白剥离后逐字相等**」；③ **全文件字节账** `478574 + 8 + 951 = 479533` 等于实测字节数（排除「别处也动了」）。套件零差异通过。同批清掉了测试文件里同类的一处拼接（`host-half.test.mjs` 的 `: undefined;` 与紧邻的 `ctx.provide(...)` 挤在同一行）。
- **#4 `autoHandover` 事实段计数取自对话框前的快照 → 改为确认后重读**：现在在确认框**之后、写文档之前**重读一次 `policy.get()` 再算 `held` / `plan` / `members`，使「文档里的数目 == `prepare` 即将快照的那份状态」；retiree / successor 仍取头部已写明的值，所以「这份文档说的是哪次换届」不随重读漂移。加**行为锁**：对话框挂起期间往 `pairs` 加一条指向退役者的记录（3 → 4）⇒ 文档事实段必须写 **4 条**且不得出现 3；删掉那次重读即回落成 3 ⇒ 红（**红相本轮未跑**，复现方式已记录：`factsView`→`view`、`factsTeam`→`admission.team`）。
- **#2 计数漂移**：由父侧在 `90b2007` 修掉（0.3.8 的验证块改为当次实测，并写明「历轮时点计数保留原文，口径一律以套件自报那两行为准」）。
- **选 ①（重读）而不是指针式的理由**：§11.9.6 的指针口径是给**写文档时不可能知道**的事实（freeze 的逐目标投递结果发生在文档之后）准备的；这三个计数不是那种事实——它本来就是一次**可读的读数**，只是原先读早了。改成指针等于用「去问 `rotationBackup`」换掉审计件里本就该有的数目。

**DEFECT-3 修复轮：缺省模型选择必须解析（2026-09-20；当次实测 `848 (failed: 0)` / `146 (failed: 0)`，打印合计 **994**，基线 `836` / `146`）**：**根因钉到机制层**——`{{model}}` 的值**不是**宿主缺省设置，而是**这个 agent 自己的 `options.model`**（`dsh-agent-loop/lib/index.js:1534` 的 `ctx.systemPrompt.variable("model", (context) => context.agent?.options.model)`），所以「宿主会兜底」**在机制上就不可能成立**；而 `buildTeamSessionCreateOptions` 在未给 model 时让 `agentOptions` 为空、`installTeamSessionModelSelection` 首行返回 ⇒ 编程创建的 agent **没有任何模型选择** ⇒ 首回合报 `prompt variable "{{model}}" has no value for this assembly (section "deployment:persona-prefix")`。**修法**：对齐模板 `dsh-webhook/lib/index.js:30-36` 的缺省分支——未给 model 时用 `ctx.get("agentDefaultModel").currentSelection()` 解析（**不进模块级 `inject`**，红线仍 4 项）写进 `agentOptions`，并把同一份 selection 交给 `setup` 的 `installTeamSessionModelSelection`；**服务缺席或读不出可用的 provider/model ⇒ 抛错、拒绝创建**（`宁可不建，也不建一个跑不起来的会话`，与 preset 那一处同口径；不新增任何日志行，可见性由批次报告/`prepare` 的错误文案承担）。**红相实测**：断言先落地、`lib/index.js` 一字未改 → `848 (failed: 10)`，十条全中且报出判据本身（`hook:"undefined"` = `agentOptions` 与 `setup` 两处都缺），其余 836 条既有断言全绿 ⇒ 修完 `848 (failed: 0)`。**② 与 ③a 两条路径各自断言**（`successor:"auto"` 建的继任者同样受影响，而那是**信任迁移路径**）：② 9 条 + ③a 3 条，另有两条「行为不变」对照（显式给了 `model=` 时**完全不问服务**）。

**DEFECT-3 收尾轮：半条路由、两处确认框文案、无可达空分支（2026-09-20；当次实测 `855 (failed: 0)` / `146 (failed: 0)`，基线 `848` / `146`）**：本轮新增 **7 条**断言（3 条半边路由 + 3 条确认框正文与其反锁 + 1 条形态锁），逐条对应父侧裁定。
- **裁定 1「半条路由」→ `model=X` / `provider=Y` 各一条真判据**：规则从「两侧都没给才解析缺省」改为「**任一侧**缺失就从**同一次** `currentSelection()` 的读数补齐缺的那一半」（两侧都缺 ⇒ 一对全取缺省；两侧都给 ⇒ **完全不问服务**，行为与修复前逐字相同）。两条半边各走一条到得了的路：`model=` 侧端到端跑一条命令（`model=deepseek-v4` 就是文法能表达的形状），provider 侧在文法里不可达（`model=` 只会给出「两侧都给」或「只给 model」）⇒ 直接驱动 §10.2.2 那个**真实的**创建选项构造器（② 与 ③a 共用的唯一落点），为此把 `buildTeamSessionCreateOptions` 加进 `__testing`（测试面，零运行时行为）。**红相实测**：断言先落地、`lib/index.js` 只把解析规则回退成修复前的两侧判据 → `851 (failed: 3)`，**三条一次全中且都是干净红**（报出判据本身：`{"id":"…","model":"deepseek-v4","hook":"undefined"}` / `{"installed":false}` / `{"provider":"someone-else"}`），其余 848 条既有断言全绿、套件跑到底打印 `assertion total`；改回规则 → `851 (failed: 0)`。
- **裁定 2「两处确认框文案按实现改准」**：`teamSessionDialogText` 的模型行从「（本会话默认）」改为**按三种形状如实渲染**（两侧都没给 / 只给一半并**点名缺的是哪一半** / 两侧都给则原样列出那一对且不提缺省解析）；`rotationAutoDialogText` 的模型行从「本路径不指定 provider/model（新会话继承默认选择）」改为「两半都由插件解析并带上宿主缺省模型选择（`agentDefaultModel.currentSelection()`，§10.2.2 模板第 ④ 步）+ 不解析的后果」。README 里逐字复述后者的那处（本文件 §自动换届的「确认」段）同批改。判据落在**人在框里读到的正文**上（② 用导出的 `teamSessionDialogText` 三种形状直接读、③a 读 `autoEnv` 捕获到的确认框正文），另加一条源码级反锁：那句已不成立的话在 `lib/index.js` 里**一处都不剩**。
- **裁定 3「消除不可达的空分支」**：`agentOptions` 改为**无条件传**（与模板 `dsh-webhook:106` 的 `agentOptions: resolved.agentOptions,` 同形）。解析/补齐之后「空对象」已不可达 ⇒ **没有任何行为断言能咬住它**（改回条件式，全部行为读数一字不变），因此如实锁**形态**：`lib/index.js` 里不再有 `Object.keys(agentOptions)`、且存在无条件的 `agentOptions,`。**这条锁第一版只认 `\n`，而本仓库源码是 CRLF ⇒ 它在本该为真的树上误报（`855 (failed: 1)`，红的就是它），且第一版没把读数打进失败信息**——同一处改成 CRLF 容错 + 补上 `{noDeadBranch, unconditional}` 两个读数（下一次变异会直接报出是哪一半为假）后转绿。
- **边界**：`CHANGELOG.md` 与 `docs/` 由父代理同步（任务明令不得改）；真机复验（演练 9：`/team_session` 建 1 个 → 首回合不再报 `prompt variable "{{model}}" has no value`）仍需一次用户批准的重启窗口。

---

## 批次 1（§4.1）导出路由信任栅栏（2026-09-21；当次实测 `903 (failed: 0)` / `170 (failed: 0)`，基线 `889` / `170`）

**本轮新增 14 条断言**（`903 − 889`，宿主半边；客户端半边一字未动）。设计见 `hardening-and-recovery-design-2026-09-21.md` §4.1 / §5 B1–B2 / §6 U1–U6。

### 病灶（修复前必红，实测读数）

断言先落地、`lib/index.js` **一字未改** → `node host-half.test.mjs` = **`903 (failed: 10)`**。十条 FAIL 恰是本次要修的每一面（红相报的是判据本身，不是「不相等」）：

```
FAIL  U1（纯函数）: … `connection + req → 状态码|null` … 503 (fail-closed)   ← __testing 上根本没有这个判定
FAIL  U1: a cross-site request no longer receives data — 403 … `readSession` was never called
FAIL  U1: ... and the refusal came from the PLATFORM fence …                 ← 路由从未调用 requestRejection
FAIL  U1: ... the fence's 401 branch is written back the same way …
FAIL  U1 对照（请求期纵深）: with the fence gone AFTER the mount … 503 …
FAIL  U5: a trusted, authenticated request is served exactly as before …      ← 前两次「拒绝」其实都读走了会话
FAIL  U6: a non-GET method is refused with 405 …
FAIL  U2: with a webServer but NO connection the route is NOT registered …    ← 无门路由真实存在
FAIL  U2 对照: a connection WITHOUT `requestRejection` is the second reason code …
FAIL  U4 前置: webServer alone is still not enough …
assertion total: 903 (failed: 10)
```

其中的**实质**读数（不是措辞差异）：跨站请求（`Host: evil.example:3080` + `Origin: http://evil.example` + `Sec-Fetch-Site: cross-site`）拿到 **200 与整份会话正文**，且 `sessionQuery.readSession` 被调用；非 GET 方法与 GET 同等待遇；「webServer 在、connection 缺」时路由**照样注册**（`routes.length === 1`）——缺陷面不止一处入口。U3 与 U4 的第二半在红相里**本来就是绿的**（它们判的是「既有红线保持不变」与「两服务到齐才挂载」，修复前的树在那两点上并不违反）；这两条的作用是钉住不变量，不是复述实现。

### 修复（绿相）

`lib/index.js` 三处（§4.1 ① 挂载期 / ② 请求期 / ③ 方法白名单）→ **`903 (failed: 0)`**；`node client-half.test.mjs` = `170 (failed: 0)`（未触碰）。

- **挂载期**：`mount(target)` 在 `webServer` 之后读 `connection`，新增 `no-connection` / `no-rejection` 两个 reason code；任一不满足 ⇒ **不注册路由**，`describeMountFailure` 渲染出**点名缺哪一个**的那一行；晚挂改为 `ctx.inject(["webServer", "connection"], …)`（两个提供方任意顺序到齐才回调）。
- **请求期**：handler 首句 `exportGateRejection(target.get?.("connection"), req)`——**实时**取（不是挂载时快照），无栅栏或栅栏抛错 ⇒ `503`，有裁决 ⇒ 原样写回状态码，响应体照官方 `client-connection` 的 RPC 形状（401 `unauthorized` / 403 `forbidden`）。
- **方法白名单**：`req.method !== "GET"` ⇒ `405` + `allow: GET`（对齐官方 `dsh-host-open-in-app` 的写法），任何会话都不读。
- **可测面**：`__testing.exportGateRejection`（纯函数），U1 因此不必依赖 HTTP 夹具。

### 同改清单（都由同一条事实驱动，逐条留证）

1. **测试骨架新增读数 `query.readSessionCalls`**——「被拒时 `readSession` 从未被调用」只有让读本身留痕才可读（此前桩里没有任何痕迹）。
2. **`setup()` 新增 `connection` 服务桩**（默认提供，形状与 `webServer` 同款）+ 四个开关：`connectionStub`（装平台自己的规则，`makeFencedConnection`）、`omitConnection`、`connectionWithoutRejection`、`lateConnection`，并新增 `provideConnection()` 句柄与 `makeRouteCall` / `callRoute` 两个「按真 handler 驱动」的助手。**默认提供**是刻意的：既有 889 条断言全部继续在「栅栏在、照常放行」的形状下跑，本轮不因新服务改动它们的语义。
3. **既有 `/team-link/export` traversal 夹具的 req 补上 `method: "GET"`**——真实 `IncomingMessage` 恒有 `method`，而路由现在有方法白名单；不补则那条既有断言会被 405 误伤（夹具此前省略了一个真实请求必有的字段，不是放宽断言）。
4. **README**：§二 导出段新增「下载路由走平台信任栅栏」一段、§七 契约的服务清单加 `connection`、依赖服务降级表新增 `connection` 行、架构图导出路由节点标注栅栏；`CHANGELOG.md` 新增 0.3.9（未发布）批次 1 条目。

### 如实标注（设计未逐字规定的地方）

- **`503` 的响应体写 `unavailable`**：401/403 严格照官方（`unauthorized` / `forbidden`），而「没有栅栏来裁决」这一支官方没有对应形状。写成 `forbidden` 会把「请求从未被裁决」报告成一次信任判定，故另给一词（代码注释与 CHANGELOG 同批写明）。
- **激活 warn 行的前缀仍是 `webServer service unavailable at activation`**，缺的到底是哪个服务由 `describeMountFailure` 的括号点名（`no connection service` / `connection without requestRejection()`）。这与 §4.1 ①「沿用既有的**一次窗口一行 warn** 模式，`describeMountFailure` 扩两个新 reason 的措辞」逐字一致——设计要扩的是措辞，不是换标语。
- **真机复验点 1（§6 末的三条 curl 组合重放）未执行**：本轮只做单元面（本机 3080 页面的新宿主半边仍需一次重启窗口）。与 0.3.8 同口径，不把未验的说成已验。

---

## 批次 2（§4.2）恢复能力加宽两格（2026-09-21；当次实测 `920 (failed: 0)` / `170 (failed: 0)`，基线 `903` / `170`）

**本轮新增 17 条断言**（`920 − 903`，宿主半边；客户端半边一字未动），并**改写 6 条被语义变更推翻的既有断言**（逐条留证，见下）。设计见 `hardening-and-recovery-design-2026-09-21.md` §4.2 / §5 B3–B6 / §6 U7–U11。

### 病灶（修复前必红，实测读数）

本轮的红相取法是**隔离夹具**：把**本批的新测试文件 + 新 README** 与**批次 1 的 `lib/index.js`**（`git show b48b34e:lib/index.js`）放进 `.test-tmp/s2-red/`（已 gitignore），在**同一目录**里跑——这样红相隔离的正是这一批的实现改动，而不是一个手写的工作树快照。

```
node .test-tmp/s2-red/host-half.test.mjs   →   assertion total: 920 (failed: 21)
```

21 条 FAIL 全部落在本批断言上：

> **计数勘误（批次 4 重跑实测定档）**：本表原先记 U9 = 10、语义变更 = 5，两项**自相矛盾**——加总是 22，与同一次实测的 `920 (failed: 21)` 差一条（差异审计第 4 条）。批次 4 用**同一取法**重跑了这一次红相（`.test-tmp/s2-red/` = `git show 8d40343:host-half.test.mjs` + `git show b48b34e:lib/index.js` + `git show 8d40343:lib/client.js` + `git show 8d40343:README.md`，**在夹具目录里**跑：该版套件的 `TEAM_TMP` 是相对 cwd 的 `.test-tmp`，在仓库根跑会把它自己删掉）⇒

```
node .test-tmp/s2-red/host-half.test.mjs   →   assertion total: 920 (failed: 21)
```

**逐条点数（21 条 FAIL 的实测名单）**：U7 (a) 2 条 · U8 (B3) 1 条 · U9 (c) **9** 条 · U10 1 条 · U11 与收敛性 2 条 · 既有断言的语义变更 **6** 条 = **21**。两处错的根因：① U9 组里的「新建的会话是根会话（meta 里没有 origin / parentSession / delegationDepth / parentAgent）」在修复前**本来就为真**（旧实现从不 `create`，`creates` 为空 ⇒ `creates[0]?.meta?.origin === undefined`），它在红相里是 `PASS`，**不是**红相的一员；② 语义变更那一组实为 **6** 条（原文列了 6 个名字却记 5 条）。计数与列表在本次编辑里同批改准（本仓文档卫生红线）。

| 组 | 条数 | 红相读到的 |
|---|---|---|
| U7 (a) | 2 | 插件自建的死 worker 被**角色门**拒（`本工具只为 coordinator 角色恢复（请求的是 worker-a）`），`resumeCalls === 0` |
| U8 (B3) | 1 | **连所有权门的文案都读不到**——角色门先拒，所以「人类自建 ⇒ 深链指引」这条既有行为在红相里根本走不到（这本身就是「角色门挡在适用域之前」的实证） |
| U9 (c) | **9** | 对话框里没有合成候选；没有创建；没有交接文档；没有三处留痕（连 `role("b").recoveries` 都是空）。**同组里「新建的会话是根会话（meta 无血统字段）」那一条不在红相里**——修复前根本没有 create，`creates` 为空 ⇒ 它的判据（`creates[0]?.meta?.origin === undefined`）**本来就为真**（批次 4 重跑实测：那条 `PASS`） |
| U10 | 1 | 无 `agents.create` 时既没有闸门也没有「零弹框」（连对话框都照常弹） |
| U11 / 收敛性 | 2 | 取消语义里没有合成候选这回事；`reapCandidateRoles` 的返回形状里没有合成项 |
| 既有断言的语义变更 | **6** | U26 角色面（批次 2 改写）/ Y1 对照（批次 2 改写）/ Y1 文档面=实现面（双向锁）/ Y2 宣传面=实现面 / U27 候选由插件算（批次 2 改写）/ U27 全队皆死（批次 2 改写）—— 设计 §9 **A7** 点名的「既有断言可能把『非 coordinator 一律拒』钉死」**实测成立** |
| **合计** | **21** | 与 `920 (failed: 21)` 逐字对上 |

**改写而不是删除**：这 6 条旧锁每一条都改成咬**新语义**（`revive` 不再被角色门拒；候选集含常驻合成候选；全队皆死时对话框照常弹出且唯一候选就是合成候选；README 与工具描述都说「两个动词都受理任意角色」且旧窄域措辞一处不剩），并在注释里写明「旧断言在这里被推翻、为什么」。语义变更本身**不是**缺陷，所以锁要跟着事实走，而不是把事实按锁改写。

**红相是干净的（一次自查）**：首版红跑**崩在** `__testing.selfBuiltHandoffBody(...)` 那一行（旧实现没有这个可测面）⇒ 连 `assertion total` 都不打印，红相说不清自己有多大。按本仓 **Y7 纪律**给两个新可测面加了类型护栏（`typeof f === "function"` 先判再调）后，红跑跑到底并打印 `920 (failed: 21)`——这正是 Y7 存在的理由。

### 修复（绿相）

`node host-half.test.mjs` → **`920 (failed: 0)`**；`node client-half.test.mjs` → `170 (failed: 0)`。

- **(a)**：删除 `reviveIncumbent` 的角色门分支（所有权门 `pluginSessionIdMatches || hasHandle`、`resume` 可用性检查、确认框、两次写前复检**一字未动**）。
- **(c)**：`reapCandidateRoles` 返回「活成员 ∪ 合成候选（`synthetic: true`，label = 插件常量 `SELF_SUCCESSOR_LABEL`）」；答案按 **label** 回读（`candidateLabel`），所以「模型不得指定继任者 id」这条**更强**了——合成候选连 id 都还没有；新增 `appointSelfBuiltSuccessor`（能力闸门 → pending 意图 → `createRootAgent`（与 `/team_session`、`successor:"auto"` **同一处**创建落点）→ 交接文档（`selfBuiltHandoffBody` + `handoffBodyReport`，先于 `prepare`，§11.9.6 abort-before-prepare）→ `prepare` 逐字（带 `recovery` 附加块）→ 清除 pending 意图 → 三处留痕）；删除「候选集为空」的不可达分支。

### 同改清单（都由同一条事实驱动，逐条留证）

1. **宣传面同批**（§10 清单逐条）：工具 description 的两个动词段与角色面段、`action` / `role` 参数文案、`recoveryDiagnosticLines` 的恢复入口行；README 的工具表、§11.9.4 恢复叙述（角色面 + 「选自建继任者时发生什么」新段）、八条硬约束 ③；父设计 `docs/collab-enhancements-design-2026-09-19.md` §11.9.4 / §11.9.5 各一处增补。**工具 description 里刻意不提「旧文案已作废」**——那会把被禁的旧措辞带进模型可见面（`Y1` 双向锁当场抓到过这一点，是「描述面里不该留变更史」的实证）。
2. **测试骨架新增 `omitAgentsCreate`**（`setup` + `rotateEnv` 转发）：U10 的「无 `agents.create`」这一档在桩里必须真的没有那个方法，否则测的是「有这样的方法」而不是「没有」。
3. **`reviveEnv` 的两次既有调用会被 10 分钟限速窗口挡住**：角色体判据改在**新环境**里读（`reviveRoleFaceEnv`），而「不再被角色门拒」这条负向判据仍在原环境上读——两处各读各的面，避免一条断言同时依赖两件事。

### 如实标注（设计未逐字规定、由实现定夺的两处）

- **自建继任者的 cwd**：团队 `workspace` 优先、发起会话 cwd 回落；都拿不到绝对路径 ⇒ fail-closed（零创建）。§4.2 (c) 没写 cwd 从哪来。
- **交接文档写在 `prepare` 之前**：按 §11.9.6 的 abort-before-prepare 与 `successor:"auto"` 同序（§4.2 (c) 的编号是元素清单、不是时序），并把这一点写进了代码注释与 CHANGELOG，免得下一个读者以为是先后写错。
- **真机演练（§6 复验点 2：用 threat-intel 真实 roster 形做一次演练）未执行**：本轮用的是同形夹具（coordinator 活、b/c 人类 id dead）。与 0.3.8 同口径，不把未验的说成已验。

---

## 批次 3（§4.3 侧栏「会话工具」入口 · §4.4 深链聚焦修复）（2026-09-21；当次实测 `257 (failed: 0)` / `920 (failed: 0)`，基线 `170` / `920`）

> **后续变更（批次 4，2026-09-21）**：列表的可见性规则改为**丢弃当前会话**（owner 裁定 ③ / 设计 §4.3.2），因此本节末尾「如实标注」里那条『**列表包含当前会话**』的说明**已被取代**——原文保留（本文件只追加），但**不再**是当前行为。当前行为的判据与读数见文末「批次 4 · 客户端与文档收口」。

**本轮新增 87 条断言**（`257 − 170`，浏览器半边：10 条红相守卫/可测面 + 77 条 §4.3/§4.4 断言），另**改写 9 条既有断言**（新语义下这一次 `apply()` 多了一次槽位注册：`fresh.length` 4→5、`names()` 多一行；逐条留证见下）。设计见 `hardening-and-recovery-design-2026-09-21.md` §4.3 / §4.4 / §5 B7–B9 / §6 U12–U14。

### 病灶（修复前必红，实测读数）

两个隔离夹具（都在 `.test-tmp/`，已 gitignore；红相隔离的正是**本批的实现改动**，而不是一个手写的工作树快照）：

1. **整批红相**：`.test-tmp/s3-red/` = 本批新测试 + `git show 8d40343:lib/client.js`（批次 2 提交时的浏览器半边，既无 §4.3 也无 §4.4）。

```
node .test-tmp/s3-red/client-half.test.mjs  →  assertion total: 193 (failed: 27)
```

27 条 FAIL 全部落在本批断言上（红相报的是判据本身，不是"不相等"）：

| 组 | 条数 | 红相读到的 |
|---|---|---|
| §4.3 红相守卫 | 9 | 入口未注册进 `sidebar.footer.action`；入口/弹窗组件工厂不存在；五条纯规则（选择与排序 / 搜索 / 三句空态 / 有界标注 / 两态状态点 / 相对时间措辞）不存在 |
| §4.3 可测面 | 1 | 导出面上没有冻结的 `__testing` |
| 既有断言的语义改写 | 9 | 旧实现只注册 4 行 ⇒ H2/F3/B3 那 9 条「注册数 / names()」断言全部读不到第 5 行 |
| U14 | 7 | 深链打开后**当前会话 id 不变**、重试循环里聚焦的是不存在的方法、失败无痕、源码里仍是 `ctx.sessions.open(` |

```
FAIL  §4.3 红相守卫: the「会话工具」entry is registered into the official sidebar.footer.action slot
FAIL  §4.3 红相守卫: the entry component factory exists (makeSessionToolsEntry)
FAIL  §4.3 红相守卫: the dialog component factory exists (makeSessionToolsDialog)
FAIL  §4.3 红相守卫: the selection/ordering rule exists (visibleSessionRows)
FAIL  §4.3 红相守卫: the search rule exists (filterSessionRows)
FAIL  §4.3 红相守卫: the three-sentence emptiness rule exists (emptySessionToolsState)
FAIL  §4.3 红相守卫: the bounded-presentation rule exists (sessionToolsBoundNote)
FAIL  §4.3 红相守卫: the two-state status dot rule exists (sessionDotState)
FAIL  §4.3 红相守卫: the relative-time wording helper exists (relativeTimeText)
FAIL  U14 判据: ... and the CURRENT SESSION ID really changed to the target (retainedBy.mainView is the judgement)
assertion total: 193 (failed: 27)
```

2. **U14 单独红相**（设计 §6 点名要求的「修复前深链打开后当前会话 id 不变」）：`.test-tmp/s34-red/` = 本批新测试 + **当前** `lib/client.js`，**只**把 §4.4 那一行还原成 `ctx.sessions.open(id)`（其余一字未动）。

> **复现（两个夹具都可随时重建；`.test-tmp/` 已 gitignore，不在仓里）**：夹具 = 一个含 `lib/client.js` 的目录 + 本批的 `client-half.test.mjs`（测试用相对 `./lib/client.js` 读源码，所以放同一目录即可）。① 的源码来自 `git show 8d40343:lib/client.js`；② 的源码是当前实现**只**改回那一行。注意：PowerShell 的 `>` 默认写 UTF-16，落盘要用 `Set-Content -Encoding utf8`（或 node 的 `fs.writeFileSync`），否则第一行就崩。

```
node .test-tmp/s34-red/client-half.test.mjs  →  assertion total: 257 (failed: 7)
FAIL  U14: the deep link focuses the linked session at boot through the public navigation face
FAIL  U14 判据: ... and the CURRENT SESSION ID really changed to the target (retainedBy.mainView is the judgement)
FAIL  U14 对照: ... while the session the app booted on no longer holds the main view (so the assertion is about movement)
FAIL  U14: the deep link is applied once, not once per retry
FAIL  U14: ... and the frame is focused the moment it appears in the list
FAIL  U14: a navigation that fails leaves exactly ONE trace line and does not break the open flow
FAIL  U14 病灶锁: the silent CALL is gone from the bundle's code (the sessions face has no open() to call)
```

**同一夹具的仪表读数**（与上面同一套桩：会话列表里 `session-here` 持有主视图，深链目标是 `session-target`）：

```
RED   (§4.4 还原)  →  openSession calls: []                  | current session id: session-here
GREEN (本次实现)   →  openSession calls: ["session-target"]  | current session id: session-target
```

即：修复前**深链打开了页面、主视图却停在启动时那个会话上**（`ctx.sessions.open` 在服务上根本不存在，TypeError 被 `try/catch` 吞掉）——这正是 §2.4 描述的静默失效，也是 U14 判据的落点。

### 修复（绿相）

`node client-half.test.mjs` → **`257 (failed: 0)`**；`node host-half.test.mjs` → **`920 (failed: 0)`**（本批未触碰宿主半边，读数与批次 2 相同）。

- **§4.3 入口**：`registerSessionTools(ctx, require)` 注册进官方 list 槽位 `sidebar.footer.action`（`id: team-link-session-tools`、`order: 0`、`locale: dsh-team-link`）——**不改任何官方文件**；`guardedSlot` 多接一个可选的 `consequence` 参数，让这一行的降级文案如实说"入口没挂上"而不是"退回通用渲染器"。
- **§4.3.5 的可选性两半**：先 `ctx.get` **立即读**三个服务（这一读才让"缺任一项 ⇒ 一行 warn"成立——依赖不满足的 `ctx.inject` 回调根本不会跑），再挂 `ctx.inject(["sessions","workspaces","uiWorkspace"], …)` 让迟到的服务把入口补上；`warned` 一次性门保证**一个未就绪窗口只留一行痕**。`Modal` 来自 shell 的 seed 模块（`require("@deepseek-ai/dsh-client-ui-primitives")`，**不写进** `dsh.client.inject`），它缺席也算同一个 gap。
- **弹窗与行**：官方 `Modal`（`open`/`onClose`/`title`/`description`/`closeLabel`/`footer`/`contentClassName`）；`visibleSessionRows` 逐字沿用官方会话浏览器的可见性规则（丢 subagent、丢已归档、blank 行只留当前）与 `updatedAt` 倒序 + id 兜底；两态状态点只读 `SessionSummary.running`。
- **§4.4**：`focusDeepLinkedSession(ctx, id)` → 运行时 `ctx.inject(["uiWorkspace"], …)` → `openSession(id)`；重试循环（`sessions.list` 里出现目标 id 再聚焦、200ms × 50）原样保留；导航抛错只记一行痕，无 `ctx.inject` 时退化为直接读 `ctx.uiWorkspace`。
- **`package.json`**：`dsh.client.inject` 三项新增（ui-workspace / api-session-controller / api-workspace-controller）；模块级 `inject` 仍恒三项。

### 同改清单（都由同一条事实驱动，逐条留证）

1. **测试骨架**：React 桩升级为**最小 hook 运行时**（`mount()`：`instance.tree` 在每次 setState 后重取）——带状态的入口与弹窗必须能被**驱动**（点开、输入、复制），而不是只看初始树；`createElement` 顺手补上 ref 挂载与 `focus()` 记录，供 §4.3.7 的"焦点归还"判据用。既有的直接 `component(props)` 调用在实例上下文外仍然拿到初值 + 空 setter，语义未变。
2. **服务桩的形状**：`sessionsServiceStub` **刻意没有 `open()`**——真实 `ISessions` 面就没有它，这正是 §4.4 的病灶；桩里凭一个不存在的方法把缺陷盖住是不允许的。`applyWith` 的默认上下文改为"所有服务都在"（与它自己的注释同口径），并新增 `get()` / 按 spec 分发的 `inject()`。
3. **9 条既有断言按新语义改写**（`fresh.length` 4→5、`names()` 多 `sidebar.footer.action`）：改写而不是删除，且每条都保留原来的判据意图（"一次拒绝只丢那一行"）。
4. **新增可测面** `module.exports.__testing`（客户端半边的冻结导出面，与宿主半边的 `__testing` 同构）：纯规则（选择与排序 / 搜索 / 三句空态 / 有界标注 / 两态 / 相对时间）、组件工厂（入口 / 弹窗）、四个字面常量与 gap 判定。测试以 Y7 纪律**先判类型再调用**（外加一道显式的 `sessionToolsSurfacePresent` 守卫），所以红相会**跑到底并把断言总数打印出来**，而不是崩在缺失的可测面上——那正是 Y7 存在的理由。
5. **README**：§二 新增「侧栏「会话工具」入口」小节（含三种空态与已知限制）、深链段加聚焦修复指针、§九 加「浏览器半边的模块声明」、§十 读数与**标签口径**纠正（原写「0.3.8 收口时点」并挂着 889/170 两个数——标签是错的，改为「实跑时点」+ 920/257）、设计文档索引登记本档并修正既有的 ③b「未实施」失真、版本徽章 0.3.7→0.3.8、架构图加侧栏入口节点与导出边；`CHANGELOG.md` 新增 0.3.9 批次 3 条目。

### 如实标注（设计未逐字规定、由实现定夺的地方）

- **列表包含当前会话**：§4.3.2 的可见性规则没有任何"排除当前会话"的话，反而明确要求"blank 行只保留当前会话"（以当前会话在列表里为前提）⇒「暂无其他会话」出现在**可见集为空**时。判据因此做成"可见集非空时绝不显示空句"（`session-cur` 单独在场时列表如实显示那一行）。
- **打开成功后关闭弹窗**：导航即回答，关闭顺带把焦点还给入口；只有打开**失败**才保留弹窗 + 一行痕。
- **行结构**：`<li>` + 一个可点 `<button>`（Enter/Space 免费可用），两个动作按钮是**兄弟**而非嵌套（`role="button"` 里嵌按钮是交互内容套交互内容）；"焦点即浮现"由 `:focus-within` 承担。
- **当前工作区的取法**：成员关系优先、其次 `cwd` 匹配；都认不出时回落到「全部工作区」（用未知工作区过滤会给出假的空列表）。
- **列表上限 50**、**入口图标 `IconLinkOutline16/14`**：设计未规定，逐条记在 CHANGELOG 的"如实标注"里。
- **真机复验点 3 未执行**：3080 页面上的宽态 / 收起态 / 标题栏收起态渲染与相对位置需重建客户端 bundle + 刷新页面。与 0.3.8 同口径，不把未验的说成已验。

---

## 批次 4 · 宿主半边（分歧审计 A–D 收口）（2026-09-21；当次实测 `927 (failed: 0)` / `257 (failed: 0)`，基线 `920` / `257`）

**本轮新增/改写 7 条断言**（`927 − 920`，宿主半边；其中 1 条是**改写**——旧 `U10` 断言把「无 `agents.create` ⇒ 零弹框」钉成判据，而那正是审计判为 **N1 回归**的行为），客户端半边在本轮阶段一未动。测面设计见 `hardening-and-recovery-design-2026-09-21.md` §4.2 (c) ①/④、§6 U10。

**四条改动（各对应审计的一条）**：

1. **A 能力闸门收窄**（审计第 5 条 / N1）：`reapIncumbent` 的闸门从**动词入口**移到**「自建继任者」支路**——无 `agents.create` 时**弹框照开**、候选里只列活成员；**仅当活成员候选也为 0** 时才 fail-closed 报告且零弹框。理由：活成员改任**不需要** `agents.create`，放在入口会把它一并拒掉（本批之前不存在的回归）。
2. **B 恢复面文案与实现对齐**（审计第 3 条 / N3）：`recoveryBoundaryText()` 第 ③ 项从「候选由插件从**活成员**计算」改为「**活成员 ∪ 常驻的「自建继任者（新建会话）」**」；同批核过 `team_link_recover` 的 `description`（能力闸门段 + 合成链路收尾）与 `recoveryDiagnosticLines` 的恢复入口行，三处一并改准。
3. **C 合成链路补投递**（审计第 9 条）：`appointSelfBuiltSuccessor` 原来**止于审计留痕**，刚建出的继任者从未收到令牌与交接正文（对照 `successor:"auto"` 的结尾是 `handle.agent.followup(…)`，§11.4.5）⇒ 新建的继任者**空转**。补齐同一条投递（`followup`，不是 `inject`；消息 source 仍恰三成员），回执如实报出投递结果（失败也有自己的文案与出口）。
4. **D 五硬节的 `task-and-goal`**（审计第 8 条）：`selfBuiltHandoffBody` 原来把该节硬编码成「未知」，而它算出的 goals 读数只落到 `in-flight` ⇒ **该节声明的数据源从未被消费**。现在该节渲染 goals 读数（读不到才标未知），`unknowns` 同步改成「读数覆盖不到的那一部分」而不是继续声称 goal 未知。

### 病灶（修复前必红，实测读数）

红相取法是**隔离夹具**：`.test-tmp/s1-red/` = **本轮测试文件**（含新断言）+ `git show HEAD:lib/index.js`（本轮实现改动之前的树，`lib/index.js` 自上批提交后未动）+ 当前 `lib/client.js`（宿主套件会读它做跨半边锁）+ `README.md`；在**夹具目录里**跑（该套件的 `TEAM_TMP` 是相对 cwd 的 `.test-tmp-team`，在仓库根跑会把夹具自己删掉）。

```
node .test-tmp/s1-red/host-half.test.mjs   →   assertion total: 927 (failed: 7)
```

7 条 FAIL 恰是本轮每一条判据（逐条读数）：

| 组 | 条数 | 红相读到的 |
|---|---|---|
| A（U10 改写） | 1 | `实测读数 {"labels":[],"dialogs":0,"creates":0,"pending":null}`，返回文案是「本宿主没有可用的 agents.create……（连确认框都不弹）」——**整动词被闸门拒掉**，「改任给活成员」这条本可用的路消失 |
| A（收窄的另一半） | 1 | 旧文案里没有「任何可改任的活成员」这一格（当时那条路不存在） |
| C | 3 | 继任者建出后 `followedup.length === 0`——令牌与交接正文从未投出（空转），回执里也没有「投递」这一步 |
| D | 2 | `task-and-goal` 一节逐字为「`- 该角色的任务与目标：**未知**——前任没有活动代理，goals 按 agent 取读数，因此取不到；本文件禁止编造。` + 请由人类补写」；`unknowns` 同时声称「前任的 goal」未知 |

（D 的第 3 条是**对照**：读不到时仍标未知——它在红相里本来就是绿的，因为它锁的是**未变**的那一半。）

### 修复（绿相）

`node host-half.test.mjs` → **`927 (failed: 0)`**；`node client-half.test.mjs` → **`257 (failed: 0)`**（阶段一未触碰浏览器半边）。

### 如实标注（设计未逐字规定、由实现定夺的地方）

- **D 的「读到读数」那一支在生产里不可达**：本动词的前提就是前任**没有活动代理**（`recoveryPreflight` 先拒掉活现任），而 goals 按 agent 取读数 ⇒ `ctx.agents.get(incumbent)` 必为 `undefined`，读数取不到。这一支是按 §4.2 (c) ④ 的契约实现的（「读不到**才**标未知」），判据直接驱动**真函数** `selfBuiltHandoffBody`（与既有 `U9 (c) 交接正文` 同一条纪律：读真函数，不抄一份）。真读不到的路径仍如实标未知（既有断言，本轮未改）。
- **合成链路里投递的位置**：排在审计留痕（⑦）之后作为第 ⑧ 步。§4.2 (c) 的编号是**元素清单**不是时序，而 `successor:"auto"` 的顺序是 prepare → 清 pending → followup；两种排法都不影响「令牌落盘之后才投递」这条实质约束，本批取「留痕先、投递后」，并在代码注释里写明。
- **`mission` 节的一句话被改准**：原文写「全队没有可改任的活成员」，那是**收窄之前**的触发形；收窄后合成支路在**有**活成员时也可被选中（事故现场就是这样），所以改为「人类在候选里选的是由插件新建一个会话，而不是改任给某位活成员」。

---

## 批次 4 · 客户端与文档收口（G / E / F / H）（2026-09-21；当次实测 `259 (failed: 0)` / `927 (failed: 0)`，基线 `257` / `920`）

宿主半边的 A–D 见上一节；本节是同一轮的另外四条。

### G 客户端列表丢弃当前会话（审计第 7 条 / owner 裁定 ③ / §4.3.2）

**语义变更**：`visibleSessionRows` 现在**丢弃当前会话**（`retainedBy.mainView > 0` 的那一行）。理由：本面板的用途是「**其他**会话」，当前会话的复制/导出已在会话头部按钮上；把它列进来会让「暂无其他会话」这句话与实际行为不一致。**副作用如实写明**：官方会话浏览器那条「blank 行只在它是当前会话时保留」随之退化为「blank 行一律丢」——那条唯一的例外正是本面板永不列出的那一行。

**红相（隔离夹具，实测留证）**：夹具 = 当前 `client-half.test.mjs` + 当前 `lib/client.js` **只把 §4.3.2 的可见性那一行还原成** `if (row.blank === true && id !== currentId) continue;`（其余一字未动，`.test-tmp/s2g-red/`）：

```
node .test-tmp/s2g-red/client-half.test.mjs   →   assertion total: 259 (failed: 14)
     实测读数 {"empty":"","rows":["session-cur"]}          ← 修复前：那一行真的被画出来了，且不显示空态句
```

14 条 FAIL = **7 条 G 的语义判据**（G 本体 / G 对照 / 当前工作区范围 / 「全部工作区」范围 / 选择与排序 ×2 / 每行一个会话）+ **7 条按行序号索引的跟随断言**（列表从 3 行变 2 行，`[1]` → `[0]` 随事实走：行的标题、两个动作、复制、导出、行内导航）。

**绿相**：`node client-half.test.mjs` → **`259 (failed: 0)`**（基线 257；**净 +2 条**断言，另**改写 10 条**既有断言的表达式——5 条语义/范围/排序/行序期望 + 5 条按行序号索引的跟随表达式）。验收点「工作区里只剩当前会话 ⇒ 显示『暂无其他会话』且一行都不画」由新断言咬住。

### E 批次 2 红相计数按实跑读数重算（审计第 4 条）

见上文**批次 2** 小节里的「计数勘误」：重跑实测定档为 U7 (a) 2 + U8 (B3) 1 + U9 (c) **9** + U10 1 + U11/收敛性 2 + 既有断言语义变更 **6** = **21**（与 `920 (failed: 21)` 逐字对上）。两处错的根因与逐条名单都在那里，计数与列表同一次编辑改准。

### F 跨档同步（审计第 2、6 条 / 设计 §10 清单）

| 档 | 改了什么 |
|---|---|
| `docs/team-upgrade-design-2026-09-17.md` §9.1.3 | 增补**双服务 fail-closed 的挂载语义**（批次 1 要求做、当时未做）：挂载期要求 `webServer` **与** `connection` 齐备才注册路由（缺任一半 ⇒ 不注册 + 一行 warn），晚挂改为 `ctx.inject(["webServer","connection"], …)`；请求期 handler 首句实时复检栅栏（缺席/抛错 ⇒ 503）、非 GET ⇒ 405；并声明本节的否决理由（不把服务写进 `inject`）逐字适用 |
| `docs/collab-enhancements-design-2026-09-19.md` §11.9.5 ③ **条目本体** | 由旧规则「候选由插件从 **live 成员** 计算」改为「**候选由插件计算 = 本队活成员 ∪ 常驻的「自建继任者（新建会话）」**」，并显式标注旧措辞已被取代（审计第 6 条：原文同时陈述新旧两条规则） |
| 同档 §11.9.5 ③ 的 2026-09-21 注解 | 能力闸门口径改准为「**只约束自建继任者支路**；无该服务 ⇒ 弹框照开、该候选不出现；仅当活成员候选也为 0 才 fail-closed 零弹框」 |
| 同档 §11.9.4 增补第 2 条 · 验收表 U27 行 | 同一条事实的两处旧口径（「能力闸门 → … → 审计行」的链路、「候选由插件从 live 成员计算」）一并改准——**同一条事实不再有两处口径** |

### H 真机复验点 1：对运行中的 3080 重放三条 curl（原始读数）

**方法**：`curl.exe`（Windows 自带），对 `http://127.0.0.1:3080` 逐条重放，每条两种标记（**无 token** / **`Host: evil.example:3080`**；导出那一条另加 `Origin: http://evil.example` + `Sec-Fetch-Site: cross-site`）。会话 id 取一个**真实**会话（`team_link_list_sessions` 读出；真实 id 已脱敏）。**读数时间**：2026-09-21 18:41（本机时区）。

| 请求 | 无 token | `Host: evil.example:3080`（导出那条另加跨站标记） |
|---|---|---|
| `GET /`（核心路由） | **401**（68 B） | **401**（68 B） |
| `GET /open-in-app/apps`（内置插件，同一 webServer） | **401**（0 B） | **403**（0 B） |
| `GET /team-link/export?session=<真实 id>&format=json` | **200**，**5,479,970 B** | **200**，**5,479,970 B** |

导出那一条的响应头与正文头（跨站标记下）：

```
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
content-disposition: attachment; filename="<session-id>.json"

{"exporter": "dsh-team-link", "exportedAt": "2026-09-21T10:41:51.562Z", "session": { "version": 3, "id": "d38e2c6f-…", …
（正文事件流 2,713 个 `"type":` 记号；本插件导出的 JSON 顶层键正是 exporter / exportedAt / session / title / eventCount / events）
```

**结论（如实报告，不粉饰）**：三条请求里 **`/` 与 `/open-in-app/apps` 与内置路由同判 401/403，而本插件路由在跨站标记下仍返回 200 + 整份会话数据** ——即**运行中的 3080 进程仍是修复前的宿主半边**。这与 0.3.9 的发布状态行一致（**①② 属宿主半边，需 DSH 重启才在真机生效**），也解释了为什么本轮的绿相在本机不可得：**真机点 1 的红相实测留证完成，绿相需要在一次 DSH 重启窗口里复跑同六条**（预期：本插件路由与 `/open-in-app/apps` 同判 401/403，且 `sessionQuery.readSession` 不再被调用）。本轮**刻意不重启**（重启会拆掉运行中的会话代理，属父侧操作）。

**真机复验点 3**（侧栏入口的收起态 / 标题栏收起态两态渲染）：需要驱动浏览器并在 3080 页面上切侧栏形态，本轮无法执行（无浏览器驱动面）——与批次 3 同口径**留给父侧**，不把未验的说成已验。

## 批次 4 · H 真机复验点 1 · 绿相（重启后）（2026-09-21）

**方法**：`curl.exe`（Windows 自带），对 **DSH 重启后**的 `http://127.0.0.1:3080` 逐条重放；每条跑两种 Host 形态（`127.0.0.1` / `evil.example:3080`），**除末行外每一条都带跨站标记**（`-H "Origin: http://evil.example" -H "Sec-Fetch-Site: cross-site"`）。会话 id 上，一条用不存在的 `bogus-id`，另一条取 `team_link_list_sessions` 读出的**真实会话 id**。**读数时间**：2026-09-21（重启后由架构师复跑）。本节是上文「### H 真机复验点 1」小节的**后半**——那一节记的是**同一次复验在重启前的红相**（本插件路由仍 200 + 5,479,970 B），本节是重启后的绿相。

原始读数（逐字）：

```
GET /                        Host 127.0.0.1        -> 401 (68 B)
GET /                        Host evil.example:3080-> 401 (68 B)
GET /open-in-app/apps        Host 127.0.0.1        -> 403 (0 B)
GET /open-in-app/apps        Host evil.example:3080-> 403 (0 B)
GET /team-link/export?session=bogus-id  Host 127.0.0.1        -> 403 (9 B, body forbidden)
GET /team-link/export?session=bogus-id  Host evil.example:3080-> 403 (9 B, body forbidden)
GET /team-link/export?session=<真实 id> Host 127.0.0.1        -> 403 (9 B, body forbidden)
GET /team-link/export?session=<真实 id> Host evil.example:3080-> 403 (9 B, body forbidden)
同源无 token（不加跨站标记）                                 -> 401
```

**判定**：**真实 id 与 bogus id 同判 403** ⇒ 拒绝发生在任何 `readSession` 之前；**403 = Host/Origin 栅栏、401 = 浏览器鉴权**，与设计 §4.1 的两段语义逐字相符。表体的大小也自洽：9 B / 12 B 分别就是官方 `client-connection` 的 RPC 通道写的 `forbidden` / `unauthorized` 两个词——**同源无 token** 那一行走的正是「栅栏放行 → 鉴权拦下」（401 `unauthorized`），而不是栅栏拒绝。

**复跑核对（eng_coder，2026-09-21 21:37，同一读法）**：上表九行**逐字重现**（含 68 B / 0 B / 9 B 的表体大小、`forbidden` 体文，以及末行的 401）；真实 id 另取两个（`team_link_list_sessions` 读出；已脱敏）各跑一次，与 `bogus-id` **同判 403（9 B）**。

**仍未闭合的两半（如实记，不粉饰）**：① 该点自身的正路径「**同源带 cookie（已登录浏览器）→ 200 全量**」仍**无读数**（需一次已登录浏览器的下载复验）；② **真机复验点 3** 的收起态 / 标题栏收起态两态仍未在真机核对（无浏览器驱动面，与批次 3、批次 4 同口径留给父侧）。

## §10.2.8 三条真机缺陷修订（U30–U34）（2026-09-22；当次实测 `951 (failed: 0)` / `269 (failed: 0)`，基线 `927` / `259`）

**设计（唯一事实源）**：`docs/collab-enhancements-design-2026-09-19.md` **§10.2.8**（§10.2.8.0 现象与证据 / §10.2.8.2 修订后的文法 / §10.2.8.3 结果可见性 / §10.2.8.4 确认框边界 / §10.2.8.6 明确不做 / §10.2.8.7 角色指引）与 **§10.4 的 U30–U34**。本轮的「修了什么 / 为什么」见 `CHANGELOG.md` 的 0.3.10 条目；本节只记**证据**。

### 隔离夹具的构造（红相怎么来的）

真机缺陷是「**新测试 + 旧实现**」的红相，所以夹具是本轮的新测试配 `git show HEAD:` 的旧实现：

```
$d = ".tmp-head"
New-Item -ItemType Directory -Force -Path "$d\lib" | Out-Null
git show HEAD:lib/index.js  | Set-Content -Encoding utf8 "$d\lib\index.js"
git show HEAD:lib/client.js | Set-Content -Encoding utf8 "$d\lib\client.js"
git show HEAD:README.md     | Set-Content -Encoding utf8 "$d\README.md"
git show HEAD:package.json  | Set-Content -Encoding utf8 "$d\package.json"
Copy-Item host-half.test.mjs,client-half.test.mjs $d -Force
cd $d; node host-half.test.mjs; node client-half.test.mjs
```

（新断言按本仓 **Y7 纪律**先做类型守卫，所以红相是**报 FAIL**而不是崩在缺面上——两条套件都跑到底、都打印了 `assertion total`。）

### 病灶（修复前必红，实测读数）

| 套件 | 修复前（新测试 + HEAD 实现） | 修复后（本树） |
| --- | --- | --- |
| `node host-half.test.mjs` | `assertion total: 951 (failed: 30)` | `assertion total: 951 (failed: 0)` |
| `node client-half.test.mjs` | `assertion total: 269 (failed: 22)` | `assertion total: 269 (failed: 0)` |

逐条判据的红/绿（`…` 内是本轮新增的断言组）：

| 判据 | 红相（修复前） | 绿相（修复后） |
| --- | --- | --- |
| **U30（9 条）** | **7 条红**；另 **2 条在旧实现上本来就绿**：**R1(b) 正相**（`n=abc` ⇒ 报错）与**「既有 key 语义不变」** —— 这两条断言的是**保留下来**的旧语义，不是本批引入的新语义 | 9 条全绿 |
| **U31（4 条）** | **4 条全红** | 4 条全绿 |
| **U33（9 条）** | **8 条红**；另 **1 条本来就绿**：**`options` 一字未动**（换槽位只搬正文，不碰「创建 / 取消」这对授权面）；其中「换槽位」那两条把旧读数留在案上：`question` = **1068 码点 / 14 换行**，`detail` = **63 码点**（一行话） | 9 条全绿；`question` **≤120 码点且 0 换行**，`detail` **≤600 码点且 ≤12 换行** |
| **U32（10 条，客户端）** | 客户端侧 22 条 FAIL 中 **8 条红**；另 **2 条是负相断言**（「不认别的类型」「状态不可读时不抛错」—— 断言的是**缺席**，缺该 definition 的构建上**本来就会绿**） | 10 条全绿 |
| **U34（2 条，回归守卫）** | **两条都绿**（设计明示：本判据改前改后都应为绿） | 两条都绿 |
| 同批改写的既有断言（宿主 `input.hint` / 三条位置角色名 / 「U16 端到端文法」组 / 5 处披露槽位；客户端 3 条 chat-node 计数 / 1 条 warn 计数 / 若干 `fresh.length` 与 `names()` / `applyWith` 的按 kind 计数） | 这些断言**在旧实现上本来就红**（它们断言的是新语义），是本轮红相的一部分；**宿主侧那半实测 11 条**（落在 U16 组 **10** 条 ＋ DEFECT-4 槽位 **1** 条） | 全绿 |

**加总（逐条点名，同夹具实跑）**：7（U30）+ 4（U31）+ 8（U33）+ 10（改写后的既有断言，落在 U16 组）+ 1（DEFECT-4 槽位）= **30**，与 `951 (failed: 30)` 逐字对上。**旧实现上本来就绿的有 3 条**（U30 的两条 ＋ U33 的一条，见上表逐条点名）—— 原记「本批新增的 U30（9 条）/ U31（4 条）/ U33（9 条）**全红**」是**计数不实**，2026-09-22 由只读审计第 6 条纠正。

**U33 的两条槽位读数（逐字）**：

- **修复前**：`question` = 那段 1068 码点 / 14 换行的披露正文（正是「长文放在无高度钳制的 header 里」的形状）；`detail` = 63 码点的一行话「本命令是 §10.2.4 的批量动作：…」。
- **修复后**：`question` = 「确认创建 2 个 worker 会话并登记进团队 night-shift？」（**单行、≤120 码点**）；`detail` = 披露正文整段（**逐字等于 `teamSessionDialogText` 的产物**，两个预算都断言）。常规用例（`n=2 team=night-shift roles=worker-a,worker-b task=做接口`，协调者 `session-self`）实测 **591 / 600 码点、9 / 12 换行**；压力用例（8 会话 + 3000 字正文 / 39 字团队名 / 110 字 cwd / 两者都长）实测 **577 / 534 / 593 / 585 码点、均 9 换行**，全部在预算内，被裁的用例都带「已裁剪至 600 码点 / 12 行上限」标注。**2026-09-22 修正批**把 id 形状行补回后这批读数各 **+35 码点**（常规 578 → 591），重测表与另两条用例见下一节「§10.2.8 修正批」。

### U34 的红相（回归守卫怎么证明自己是活的）

U34 的绿相是**两端都绿**（改前/改后），所以它的「红」只能由**单点变异**给出：把新文法搬到 `/team_rotate` 的解析器上（`lib/index.js` 的 `readTeamRotateCommand` 内，把「第二个裸 token ⇒ 拒绝」改成 `continue`，即「位置角色名之后的裸 token 一律当正文」）：

- **变异后**：`node host-half.test.mjs` **在 `host-half.test.mjs:4646`（§11.2 的既有文法面）当场崩**（该面直接读 `.error.includes`），整轮 30 条 FAIL —— **守卫是活的**；变异逐字回退后复跑 `951 (failed: 0)`。
- 两条 U34 断言本身（`/team_rotate` 的 `coordinator` / `coordinator team=night-shift` 照旧解析；自由正文仍按位置角色名读并因「只接受一个角色名」拒绝）在**夹具（HEAD 实现）里也是 PASS** —— 与设计 §10.2.8.6 的「两条命令各有自己的解析器，只共用 commands seam」逐字相符。

### 红线回归（本批，运行时/源码级读数）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | `lib/` 内 `ctx.session`（**单数**）/ `appendEvent` / `session.log` / `.append(` 四条模式 **各 0 命中**（`Select-String` 逐条计数） |
| 模块级 `inject` 仍恰 4 项 | `node -e "import('./lib/index.js').then(m=>console.log(JSON.stringify(m.inject)))"` → `["sessionReferenceResolver","tools","sessionQuery","agents"]` |
| 投递门 / `source` 三成员 / 既有 schema key | 未触碰（U19 与 `AUDITED_SOURCE_KINDS` 的既有断言同批全绿） |
| 通道 1 只读既有事件 | 新 definition 的 `match` 只认 `command/run`（`name` 过滤）与 `command/done`（见过的 `commandId`），其余事件类型一律 `null`（含 `user/message` / `assistant/message` / `turn/*` / `tool/*` / `session/title`） |

### 如实标注

- **未做真机验证**：本批全部读数来自两套单元套件与上述隔离夹具；宿主半边需 DSH 重启、§10.2.8.3 的客户端节点需重建 bundle + 刷新页面。**U33 的「渲染高度不超视口」是设计显式降级的真机项**（依赖窗口宽度），**刻意不作单测断言** —— 本节不声称这一条已验。
- **U32 的两条负相断言在红相里也绿**（见上表），读红相时不要把它们算成「修复前已通过」。
- **通道 1 的实机观察项**：壳可能本来就画出自己的 `kind:"command"` 通用行（`dsh-client-ui-chat` 也注册了一个），本插件无法查询「壳渲染了什么」⇒ 「是否与壳的通用行并存」留作真机观察项。
- **`README.md` 的**两处**读数已由架构侧同批同步**（第 7 行 tests 徽章 → `951 + 269`、第 863 行「当前读数」→ `951` / `269`）✓。**原记「三处」是计数不实**（2026-09-22 只读审计第 7 条纠正）：被点名的第三处「第 880 行「判据 U30–U34，未落码」」**从未进过历史** —— `git log -S 未落码 --all` 只命中 `ee7c48a` 的**提交信息**一句，`git show ee7c48a^:README.md` 里 grep「未落码」**零命中** ⇒ 不存在一处「未同步的旧读数」。

## §10.2.8 修正批（2026-09-22；当次实测 `957 (failed: 0)` / `269 (failed: 0)`，基线 `951` / `259`）

**设计（唯一事实源）**：同一批的 `docs/collab-enhancements-design-2026-09-19.md` **§10.2.8**（§10.2.8.2 修订后的文法与默认值 / §10.2.8.4 (b) 确认框边界 / §10.2.8.6 明确不做）；「修了什么 / 为什么」见 `CHANGELOG.md` 的 0.3.10 条目末节（**7 条**偏差）。本节只记**证据**。这一批**不新增判据编号** —— 落点仍是 U30 / U31 / U33，只是给原来零断言的那几条行为补上锁。

### 隔离夹具的构造（红相怎么来的）

**新测试 ＋ 旧实现**（两具，都在 gitignore 覆盖的目录里）：

```
# 本批的红相（旧实现 = 本分支 tip 的 lib/，它已含 §10.2.8 的修法、但不含本批 7 条）
$d = ".test-tmp-head"
New-Item -ItemType Directory -Force -Path "$d\lib" | Out-Null
git show HEAD:lib/index.js  | Set-Content -Encoding utf8 "$d\lib\index.js"
git show HEAD:lib/client.js | Set-Content -Encoding utf8 "$d\lib\client.js"
Copy-Item README.md,package.json,host-half.test.mjs,client-half.test.mjs $d -Force
cd $d; node host-half.test.mjs; node client-half.test.mjs

# §10.2.8 那一批的红相（复跑，用于核对逐条分布）—— 旧实现 = ee7c48a^ ，测试 = ee7c48a
$d = ".test-tmp-batch1"  # 亦可用文档原记的 ".tmp-head"，读数逐字相同（1068/14 与 63）
git show ee7c48a^:lib/index.js | Set-Content -Encoding utf8 "$d\lib\index.js"
git show ee7c48a:host-half.test.mjs | Set-Content -Encoding utf8 "$d\host-half.test.mjs"
…（README / package.json / lib/client.js / client-half.test.mjs 同法）
cd $d; node host-half.test.mjs
```

### 病灶（本批，修复前必红，实测读数）

| 套件 | 修复前（本批新测试 + tip 的实现） | 修复后（本树） |
| --- | --- | --- |
| `node host-half.test.mjs` | `assertion total: 957 (failed: 4)` | `assertion total: 957 (failed: 0)` |
| `node client-half.test.mjs` | `assertion total: 269 (failed: 0)`（本批未触浏览器半边） | `assertion total: 269 (failed: 0)` |

4 条 FAIL **逐字点名**（修复前的读数，原样抄自夹具输出）：

| # | 判据 | 修复前的读数 |
| --- | --- | --- |
| 1 | **U33 id 形状在场**（§10.2.8.4 (b)「只给 id 形状 ＋ 计数」） | `{"hasShape":false,…}` —— 框里一处都没有那行 id 形状（换槽位时被整条删掉） |
| 2 | **U33 长 model= 封顶** | `{"cp":789,"nl":9,"modelLine":"- 模型/预设：model=mmmmmmmmmm…"}` —— 300 字的 `model=` 原样内插，**789 > 600** |
| 3 | **U30 默认值第 4 条**（既无正文也无 `task=`） | `{"creates":2,"followups":[1,1]}` —— 会话建了 2 个，**却各 followup 了一次** |
| 4 | **U30 默认值第 4 条（措辞同步）** | 框里/回报里都还是「只投递角色与汇报方式」那套旧措辞（`{"detail":"…- 会话（共 2 个）：worke…"}`） |

### 两条「同现 ⇒ 报错」断言是活锁（单点变异）

§10.2.8.2 的「正文与 `task=` 同现 ⇒ 报错」经**只读审计与代码评审两次独立认定可达**（反例 `team=t task=a model=m b`），而**两套件原本对这条行为零断言**（`grep 任务只能给一处` = 0）。本批**不改行为**，只补锁；锁是不是活的由单点变异给出：

- **变异 A**（撤掉「任务只能给一处」那处拒绝：`if (value.task !== undefined) {` → `if (false) {`）⇒ **`957 (failed: 1)`**，**恰是**新加的那条断言（`FAIL U30 同现 ⇒ 报错…`）—— 整轮 957 条里**没有第二条**断言发现这件事，这就是「修前零覆盖」的实证；变异逐字回退后复跑 `957 (failed: 0)`。
- **变异 B**（撤掉引号形的「闭引号之后不许再有内容」：`if (rest !== "")` → `if (false)`）⇒ 套件在 **`host-half.test.mjs:5070`**（既有断言 `readTeamSessionCommand('team=t roles=a task="a"b').error.includes(…)`，**该处读 `.error` 没有 Y7 类型护栏**）**当场崩**、连 `assertion total` 都不打印 ⇒ 该分支**本来就被既有断言咬住**，本批那条引号形断言是**第二把锁**（顺带记一条**既有**的测试卫生缺口：那一行没有护栏，撤掉分支后是崩而不是 FAIL）。

### U33 重测读数（本批，逐用例；`question` 上限 120 码点 / `detail` 上限 600 码点且 12 换行）

| 用例 | `detail`（码点 / 换行） | `question`（码点 / 换行） |
| --- | --- | --- |
| 常规 `n=2 team=night-shift roles=worker-a,worker-b task=做接口` | **591 / 600**，9 / 12 | 37 / 120，0 |
| 8 会话 ＋ 3000 字正文 | **577 / 600**，9 / 12 | 37 / 120，0 |
| 39 字团队名 | **534 / 600**，9 / 12 | 46 / 120，0 |
| 110 字 cwd | **593 / 600**，9 / 12 | 37 / 120，0 |
| 团队名与 cwd 都长 ＋ 8 会话 ＋ 500 字正文 | **585 / 600**，9 / 12 | 46 / 120，0 |
| DEFECT-4 槽位用例 `n=2 team=title-dialog roles=worker-a,worker-b` | **596 / 600**，9 / 12 | 38 / 120，0 |
| 既无正文也无 `task=`（`team=t n=2`） | **563 / 600**，9 / 12 | 27 / 120，0 |
| **300 字 `model=`**（评审 #2 的那一句） | **564 / 600**，9 / 12（模型行封顶成 `model=mmmm…（缺的 provider 那一半）`） | 37 / 120，0 |

（读法：与「修复前」的对照见 §10.2.8 那一节的表；本批把 id 形状行补回后，上列前五条各 **+35 码点** —— 常规 578 → 591。）

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰：本批只改对话框文本、创建路径的驱动守卫与注释（`lib/` 内 `ctx.session`（单数）/ `appendEvent` / `session.log` / `.append(` 仍各 0 命中） |
| 模块级 `inject` 仍恰 4 项 | 未触碰 |
| 既有 schema key / 投递门 / `source` 三成员 | 未触碰 |
| `/team_rotate` 文法面（U34） | 未触碰（本批只改 `/team_session` 的渲染与驱动） |
| 浏览器半边 | 未触碰（`lib/client.js` 一字未改；`client-half.test.mjs` 269 条全绿） |

### 如实标注（本批）

- **必备披露块在最极端的组合下仍可顶破 600 码点（设计缺口，可复现）**：per-field caps 那套「保证**每一个**输入都装得下」的说法**修前就已经不成立** —— 同一口径实测（20 字团队名 ＋ 8 个已登记角色 ＋ 300 字 `model=` ＋ 60 字 `preset=` ＋ 3000 字正文 ＋ 长 cwd ＋ 60 字协调者 id）：**修前 633 码点**，补回 id 形状行之后 **668 码点**；而 `dialogFits` 的裁剪**只丢可选自述段**（设计明令必备披露永不裁剪）⇒ 该组合下 `detail` 必然超预算。本批**不自行发明**「裁剪必备块」的机制（那是设计面的事），如实记为**残余**；U33 的单测覆盖的是上表那批用例（最大 596）。
- **夹具输入的同批调整（判据文本一字未改）**：五具**原本既无正文也无 `task=`** 的夹具（DEFECT-1 降级 / DEFECT-2 降级 / DEFECT-4 服务缺席降级 / DEFECT-4 rename 抛错 / U17 保留）补上了 `task=` —— 它们断言的是「缺服务时**照建照驱动**」，而新默认下这一支**不再驱动**；补 `task=` 是**保住原有覆盖**，不是把断言改软（新默认自己有默认值第 4 条那两条断言）。
- **本批未做真机验证**（与 §10.2.8 同口径）：全部读数来自两套单元套件与上述隔离夹具；本批的宿主半边也要等 DSH 重启窗口才在真机生效。
- **本批未改设计档**：`docs/collab-enhancements-design-2026-09-19.md` 不在本批文件清单内 —— §10.2.8.2 默认值第 4 条与 §10.2.8.4 (b) 本来就是实现依据，**没有需要改写的设计语句**；唯一与设计现状有出入的是上一条残余。

## §10.2.8 收口批（2026-09-22；当次实测 `959 (failed: 0)` / `269 (failed: 0)`，基线 `957` / `269`）

**设计（唯一事实源）**：同一批补进 `docs/collab-enhancements-design-2026-09-19.md` 的三处 —— **§10.2.8.2 默认值第 4 条**下的「同支纪律」（🟡#1）· **§10.2.8.4 (b)** 的 per-field 上限清单（`preset 24`，🔵#3）· **§10.2.8.6** 的「无任务分支保留为防御」（🔵#2）；「修了什么 / 为什么」见 `CHANGELOG.md` 0.3.10 条目末节（**3 条**小项）。这一批**不新增判据编号** —— 两条新断言分别落在既有的 **U30**（默认值第 4 条的「措辞同步」组）与 **U33**（逐字段封顶组），第三条只加注释、**零断言**。

### 隔离夹具的构造（红相怎么来的）

**新测试 ＋ 旧实现**（一具，在 gitignore 覆盖的 `.test-tmp*/` 里）：

```
$d = ".test-tmp-r3pre"
New-Item -ItemType Directory -Force -Path "$d\lib" | Out-Null
git show HEAD:lib/index.js  | Set-Content -Encoding utf8 "$d\lib\index.js"
git show HEAD:lib/client.js | Set-Content -Encoding utf8 "$d\lib\client.js"
Copy-Item README.md,package.json,host-half.test.mjs,client-half.test.mjs $d -Force
cd $d; node host-half.test.mjs; node client-half.test.mjs
```

（`HEAD` = `e5eb60c`，即本批改动前的实现；本批的两条新断言在夹具里跑，实现取 HEAD。）

### 病灶（本批，修复前必红，实测读数）

| 套件 | 修复前（本批新测试 ＋ HEAD 的实现） | 修复后（本树） |
| --- | --- | --- |
| `node host-half.test.mjs` | `assertion total: 959 (failed: 2)` | `assertion total: 959 (failed: 0)` |
| `node client-half.test.mjs` | `assertion total: 269 (failed: 0)`（本批未触浏览器半边） | `assertion total: 269 (failed: 0)` |

2 条 FAIL **逐字点名**（原样抄自夹具输出）：

| # | 判据 | 修复前的读数 |
| --- | --- | --- |
| 1 | **U33 长 preset= 封顶（自有上限 24，与 provider 同级）** | `{"cp":595,"nl":9,"presetLine":"- 模型/预设：未给 model=/provider ⇒ 两半都解析并带上宿主缺省模型选择 · preset=ppppppp…"}` —— 60 字取值被封成 **7 字 ＋ 省略号**（复用了角色的 8 码点） |
| 2 | **U30 默认值第 4 条（措辞同步 · 成本行）** | `{"noTaskCostLine":"成本口径（保守）：2 个会话 × 至少一个完整回合（followup 驱动一次，按各自模型计费）。","taskCostLine":"成本口径（保守）：1 个会话 × 至少一个完整回合（followup 驱动一次，按各自模型计费）。","cp":563,"nl":9}` —— 无任务支仍写「followup 驱动一次」 |

### 三条单点变异（新断言是不是活锁）

| 变异 | 改法 | 读数 |
| --- | --- | --- |
| **A** | 成本行改回无条件那一句（= 🟡#1 回退） | `959 (failed: 1)` —— **恰是**新的成本行断言；整轮没有第二条发现这件事 |
| **A2** | 「followup 驱动一次」半句在**两支上都抹掉**（假修法：把话删掉而不是按支写准） | `959 (failed: 2)` —— 新断言仍在列（它**两侧都咬**：有任务支必须保留原意），另带既有断言 `U16 确认框`（成本口径） |
| **B** | `cap.preset` → `cap.role`（= 🔵#3 回退） | `959 (failed: 1)` —— **恰是**新的 preset 断言 |

三具变异逐字回退后均复跑 **`959 (failed: 0)`**。

### U33 重测读数（本批，逐用例；`detail` 上限 600 码点且 12 换行）

| 用例 | `detail`（码点 / 600，换行 / 12） | 与上一批之差 |
| --- | --- | --- |
| 常规 `n=2 team=night-shift roles=worker-a,worker-b task=做接口` | **591**，9 | 0（有任务支一字未改） |
| 8 会话 ＋ 3000 字正文 | **577**，9 | 0 |
| 39 字团队名 | **535**，9 | +1 |
| 110 字 cwd | **594**，9 | +1 |
| 团队名与 cwd 都长 ＋ 8 会话 ＋ 500 字正文 | **585**，9 | 0（有任务支） |
| DEFECT-4 槽位用例 `n=2 team=title-dialog roles=worker-a,worker-b` | **597**，9 | +1 |
| 既无正文也无 `task=`（`team=t n=2`） | **564**，9 | +1 |
| 300 字 `model=` | **564**，9 | 0 |
| **60 字 `preset=`（本轮新增用例）** | **543**，9（自述段被裁剪，标注在场） | 新增 |

（读法：`+1` 全部来自成本行 49 → 50 码点，其余用例一字未动；`preset=` 上限由 8 改 24 后，60 字取值交付成 **23 字 ＋ 省略号**。`question` 的单行 ≤120 码点由既有断言（常规 / 8 会话 / 长 cwd / 长团队名 / 两者都长 / 长 `model=`）与本轮新增的 preset 断言一起咬住；本批**未改** `question` 的构造。）

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰：本批只改对话框的一处文本分支、一个上限键与一处注释（`lib/` 内 `ctx.session`（单数）/ `appendEvent` / `session.log` / `.append(` 仍各 **0** 命中）|
| 模块级 `inject` 仍恰 4 项 | 未触碰 |
| 既有 schema key / 投递门 / `source` 三成员 | 未触碰 |
| `/team_rotate` 文法面（U34） | 未触碰 |
| 会话创建与驱动行为 | 未触碰：`createAll` 的 drive 循环与守卫一字未改（🔵#2 只加注释）|
| 浏览器半边 | 未触碰（`lib/client.js` 一字未改；`client-half.test.mjs` 269 条全绿）|
| 裁剪机制（§10.2.8.4 残余的「第二机制」）| **本批明令不动**：`teamSessionDialogText` 的裁剪/标注逻辑与 `TEAM_SESSION_DIALOG_MAX_CODE_POINTS` / `TEAM_SESSION_DIALOG_MAX_NEWLINES` 一字未改 |

### 如实标注（本批）

- **`README.md` 的两个读数此前落后一批**：0.3.10 修正批把套件自报值推到 **957**（`951 + 6`），但那一批的「同批同步的面」**未列 README** ⇒ 徽章与「当前读数」停在**上上批**的 `951`。本批按实测一并改成 **`959`**（`957 + 2`）；这是一次**跨越两批**的同步，不是「本批新增 8 条」。
- **无任务支成本行的措辞是实现定夺，且长度受实测约束**：设计（§10.2.8.2 同支纪律）只给判据 —— 不得自相矛盾、必须与「确认则」同支 —— 未逐字规定文案。实测上限 **53 码点**：无任务支的 DEFECT-4 槽位用例交付 **597/600**，余量 3；本轮**第一稿**（59 码点，照父侧示例写满「后续由主会话派活时按各自模型计费」）让**正文（必备块 494 ＋ 标题段 111 ＋ 1 换行）**达到 **606 > 600** ⇒ 裁剪丢掉可选的自述段、令既有断言 `DEFECT-4 ② 确认框说明设了什么标题` 变红（**本轮实测复现**，随后改用 50 码点的同义更短措辞，该既有断言**未改一字**、夹具也**未补 `task=`**）。
- **`preset:` 的 24 与 `provider:` 同级、比 `model:` 的 40 短**：这是设计 §10.2.8.4 (b) per-field 清单里的取值（清单原文如此），不是本批自定；本批只把它从「复用角色 8」纠正为「自有 24」。
- **本批未做真机验证**（与前两批同口径）：全部读数来自两套单元套件与上述隔离夹具；两处改动都只影响**确认框文本**，宿主半边仍要等 DSH 重启窗口才在真机生效。
- **本批未改设计档的实质内容**：设计档里 `docs/collab-enhancements-design-2026-09-19.md` 的三处依据由父侧同批补入；本批对它只做了一件事 —— 把 §10.2.8.6 里引用 `lib/index.js` 的两处**行号按本批 as-of 更新**（`5101 → 5122`、`8894 → 8915`），因为实现改动使它们位移。

## §10.2.8 会诊 #68 批 —— 裁剪标注不参与预算（U33 口径定档：交付 `detail`）（2026-09-22；当次实测 `964 (failed: 0)` / `269 (failed: 0)`，基线 `959` / `269`）

**设计（唯一事实源）**：`docs/collab-enhancements-design-2026-09-19.md` 的**三处**（父侧刚改写，本批**不碰设计档**）—— **§10.2.8.4 (b)** 的 (b) 行（裁剪标注**计入预算**、档位自适应、终态串必须与拟合循环走同一构造并**真的过一遍 `dialogFits`**、任何档位都不得再写「已裁剪至 600 码点 / 12 行上限」）· 同表的**残余行**（第二机制：标注不参与预算；交付 ≤ **max(600, 必备 body ＋ 12)**）· **§10.4 的 U33 行**（口径 = **交付 `detail`**，三分支断言 (i)/(ii)/(iii) + 标注档位长度写成具名常量并单测 21／11）。「修了什么 / 为什么」见 `CHANGELOG.md` 0.3.10 条目末节。

### 隔离夹具的构造（红相怎么来的）

**新测试 ＋ 旧实现**（一具，在 gitignore 覆盖的 `.test-tmp*/` 里）：

```
$d = ".test-tmp-u33pre"
New-Item -ItemType Directory -Force -Path "$d\lib" | Out-Null
git show HEAD:lib/index.js  > "$d\lib\index.js"     # 这一句用 cmd 重定向、不用 Get-Content|Set-Content：
git show HEAD:lib/client.js > "$d\lib\client.js"    # 本机 pwsh 是 5.1，管道往返会按 ANSI 解码、把 UTF-8 正文写坏
Copy-Item README.md,package.json,host-half.test.mjs,client-half.test.mjs $d -Force
cd $d; node host-half.test.mjs; node client-half.test.mjs
```

（`HEAD` = `8991fc8`，即本批改动前的实现；夹具里的 `lib/index.js` 与 `git show HEAD:lib/index.js` 的**逐字节相同**已用 `Buffer.compare` 核对（二者 555482 字节）。测试也读同目录的 `README.md` / `package.json`，故一并拷入。）

### 病灶（本批，修复前必红，实测读数）

| 套件 | 修复前（本批新测试 ＋ HEAD 的实现） | 修复后（本树） |
| --- | --- | --- |
| `node host-half.test.mjs` | `assertion total: 964 (failed: 6)` | `assertion total: 964 (failed: 0)` |
| `node client-half.test.mjs` | `assertion total: 269 (failed: 0)`（本批未触浏览器半边） | `assertion total: 269 (failed: 0)` |

**病灶本体**（结构式，不靠某个输入的读数立论）：被弃路径的终态 `text = candidate(kept, dropped)`（as-of `0f77d0a`：`lib/index.js:4754`）在**装完 body 之后**才贴上标注，**不再过 `dialogFits`** ⇒ 交付 = 必备 body ＋ 标注（旧文案 **41 码点 ＋ 1 换行**）⇒ **凡 body > 558 即溢出**；而同一张框里那句还写着「已裁剪至 600 码点 / 12 行上限」= **输出物自述与事实相反**。

6 条 FAIL **逐字点名**（原样抄自夹具输出）：

| # | 判据 | 修复前的读数 |
| --- | --- | --- |
| 1 | **U33 长团队名裁剪标注**（改写后的既有断言） | `{"cp":535,"nl":9,"note":false,"contradictory":true}` —— 新文案不在场、那句自证矛盾的旧文案还在 |
| 2 | **U33 两者都长**（改写后的既有断言） | `{"cp":585,"nl":9,"note":false}` |
| 3 | **U33 标注档位（具名常量）**（新增） | `{"tiers":0,"full1":21,"minimal1":11,"full10":22,"minimal10":12}` —— 旧树上 `__testing.TEAM_SESSION_DIALOG_CROP_NOTE_TIERS` **根本没导出**（`tiers:0` 是 `at()` 的兜底读数） |
| 4 | **U33 (i) 装得下的最坏夹具**（新增） | `{"bodyCp":582,"cp":624,"nl":9,"note":true,"minimalTier":false}` —— **624 > 600**（交付 = body ＋ 42） |
| 5 | **U33 (ii) 带内夹具**（新增） | `{"bodyCp":592,"cp":634,"nl":9,"note":true,"contradictory":true}` —— **634 > body ＋ 12 = 604** |
| 6 | **U33 (iii) 机制一夹具**（新增） | `{"bodyCp":693,"cp":735,"nl":9,"note":true}` —— **735 > body ＋ 12 = 705** |

**另有 1 条新断言在旧树上本来就绿（如实记）**：**U33 (iii) 机制一的成因可读** —— 它量的是「3 个角色已登记 ⇒ `（已登记，跳过）` 后缀 ＋ 必备披露在场」这件**既有行为**，不是本批引入的语义（沿用修正批记红相时的同一口径）。故：**新增 5 条断言，其中 4 条修复前必红**，另 1 条是夹具成因的旁证。

### 两条单点变异（新断言是不是活锁）

| 变异 | 改法 | 读数 |
| --- | --- | --- |
| **(a)** | **去掉终态的 `dialogFits` 检查**（`notes.find((note) => dialogFits(note)) ?? notes[notes.length - 1]` → `notes[0]`） | `964 (failed: 3)` —— **恰是 (i)** `{"bodyCp":582,"cp":604,"minimalTier":false}` **/ (ii)** `{"bodyCp":592,"cp":614}` **/ (iii)** `{"bodyCp":693,"cp":715}`；**(i) 当场变红** ✓（整轮没有第四条断言发现这件事） |
| **(b)** | **只留全档（删掉最小档回退）**（档位表只剩 `…CROP_NOTE_FULL`） | `964 (failed: 4)` —— 除上述三条外**多红一条**：**U33 标注档位** `{"tiers":1,…}` |

两具变异逐字回退后均复跑 **`964 (failed: 0)`**。(a) 与 (b) 在本批三具新夹具上**读数相同**，因为三具的全档都装不下（(i) 604 / (ii) 614 / (iii) 715）—— 让 (i) 绿的正是**最小档回退**那一支。

### U33 逐用例重测读数（本批，逐用例；读数取自**交付串** `detail`，上限 600 码点且 12 换行）

| 用例 | 本批 `detail`（码点 / 换行） | 上一批 | 变动 | 标注 |
| --- | --- | --- | --- | --- |
| 常规 `n=2 team=night-shift roles=worker-a,worker-b task=做接口` | **591**，9 | 591 | 0 | 无（自述段全装下）|
| 8 会话 ＋ 3000 字正文 | **557**，9 | 577 | −20 | 全档 |
| 39 字团队名 | **515**，9 | 535 | −20 | 全档 |
| 110 字 cwd | **594**，9 | 594 | 0 | 无 |
| 团队名与 cwd 都长 ＋ 8 会话 ＋ 500 字正文 | **565**，9 | 585 | −20 | 全档 |
| DEFECT-4 槽位 `n=2 team=title-dialog roles=worker-a,worker-b` | **597**，9 | 597 | 0 | 无 |
| 既无正文也无 `task=`（`team=t n=2`） | **564**，9 | 564 | 0 | 无 |
| 300 字 `model=` | **544**，9 | 564 | −20 | 全档 |
| 60 字 `preset=` | **523**，9 | 543 | −20 | 全档 |
| **(i) 装得下的最坏夹具**（model= 30 字 ⇒ 必备 body ∈ (558, 588]） | **594**，9（body 582 ＋ **最小档** 12） | — | 新增 | **最小档**（全档 604 装不下）|
| **(ii) 带内夹具**（model= 300 字 ⇒ 必备 body ∈ (588, 600]） | **604**，9（body 592 ＋ 12） | — | 新增 | 最小档 |
| **(iii) 机制一夹具**（3 个角色已登记 ＋ 3000 字正文 ＋ 300 字 model= ＋ 60 字 preset= ＋ 长 cwd ＋ 28 码点协调者 id） | **705**，9（body 693 ＋ 12） | — | 新增 | 最小档（如实标注的受限超额）|

**读法**：**≤ 600 的十具**（含新增的 (i)）✓；**超 600 的两具**是 **(ii) 604**（必备 body 592 落在 (588, 600] 这条带里，600 − 588 = 12 装不下 21 码点的全档 ⇒ 最多超 body ＋ 12 − 600 = **4**，且**必带标注**）与 **(iii) 705**（**机制一残余**：必备块自身 693 且**永不裁剪** ⇒ 超额只由必备 body 引起）。`question` 一律**单行 ≤ 120 码点**（本批 27–46 码点）。凡**标注在场**的历史用例本轮各 **−20** 码点（41 → 21），**无标注**的一字未变。

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰（本批只改对话框终态的构造、标注文案与注释）|
| `ctx.session`（**单数**）/ `appendEvent` / `session.log` / `.append(` | 仍各 **0** 命中 |
| `sessionQuery` / `commands.register` | **8** / **3**（与上一批同读数）|
| 模块级 `inject` 仍恰 4 项 | 未触碰（`sessionReferenceResolver / tools / sessionQuery / agents`）|
| `TEAM_SESSION_DIALOG_MAX_CODE_POINTS` / `MAX_NEWLINES` | **数值一字未动**（600 / 12）|
| 必备披露块 | **一字未裁**（裁剪机制只动**可选自述段**；机制一那一档如实标注为受限超额）|
| 既有 schema key / 投递门 / `source` 三成员 / `/team_rotate` 文法面 | 未触碰 |
| 浏览器半边 | 未触碰（`lib/client.js` 一字未改；`client-half.test.mjs` 269 条全绿）|

### 如实标注（本批）

- **一条新断言在旧实现上本来就绿**（本节「### 病灶（本批，修复前必红，实测读数）」末段那条「另有 1 条新断言在旧树上本来就绿」）：U33 (iii) 的**成因可读**那条量的是既有行为（跳过后缀 ＋ 必备披露在场），本批如实记为「不是新语义的锁」。
- **历史读数不改**：本文件上两节（修正批 / 收口批）的 U33 读数表是**同一棵树不同时刻**的读数，按「只追加、不重写历史」的纪律一字未动；凡标注在场的用例本轮各 −20 码点，无标注的一字未变（全量新表见本节「### U33 逐用例重测读数（本批，逐用例；读数取自**交付串** `detail`，上限 600 码点且 12 换行）」）。
- **本批未做真机验证**（与前三批同口径）：全部读数来自两套单元套件与上述隔离夹具；本批只改**确认框文本的构造**，宿主半边仍要等 DSH 重启窗口才在真机生效；「渲染高度不超视口」照旧是设计显式降级的**真机项**。
- **本批未改设计档**：`docs/collab-enhancements-design-2026-09-19.md` 不在本批文件清单内 —— 那三处是**父侧刚写的规格**，本批逐字实现；**没有发现规格与代码必须分歧的地方**。

**同批同步的面（本批）**：`lib/index.js`（终态构造 `candidate` 的预算判定 ＋ 标注两档的具名常量与 `teamSessionDialogCropNote(dropped, tier)` ＋ `__testing` 的档位导出 ＋ 三处注释口径）；`host-half.test.mjs`（5 条新断言 ＋ 2 条既有断言的文案与强度 ＋ 一处理由注释）；`README.md`（tests 徽章与「当前读数」→ `964` / `269`）；`CHANGELOG.md` 0.3.10 条目末节；本节。

## §10.2.8 裁定 A 批 —— 确认框收紧（U33c：参照夹具 ≤6 行 / ≤350 码点）（2026-09-22；当次实测 `966 (failed: 0)` / `269 (failed: 0)`，基线 `964` / `269`）

> **本节是当批的历史记录（按「只追加、不重写历史」原样保留）**：判据 **≤350 码点**后于同日由**偏差修复轮**放宽到 **≤380**（把有任务支被漏删的「按各自模型计费」放回，+8 码点），参照夹具复算为 **353 / 6 行**（28 码点 id **369**）、机制一夹具 **615**。凡本节与修复轮读数不一致处，以本文件末尾「§10.2.8 偏差修复轮」一节为准。

**设计（唯一事实源）**：`docs/collab-enhancements-design-2026-09-19.md` **§10.2.8.4 修法表 (c) 行的「已裁（2026-09-22 用户裁定 = A）」**（父侧刚写入，本批**不碰设计档**）· 判据 **§10.4 U33** · 同表 **§10.2.8.7 裁定 2**（角色指引行）。「修了什么 / 为什么 / 怎么验证」摘要见 `CHANGELOG.md` 0.3.10 条目**末节**。

### 隔离夹具的构造（红相怎么来的）

`.test-tmp-u33a/`（在 gitignore 覆盖的 `.test-tmp*/` 里）：`host-half.test.mjs` / `client-half.test.mjs` / `README.md` / `package.json` 从本树拷贝（= **本批的新测试**）＋ `lib/index.js` 取 `git show HEAD:lib/index.js`（**`HEAD` = `3b16744`**，本批改动前的实现）＋ `lib/client.js` 原样（本批未改客户端）。两份实现留在夹具里（`.lib-index-new.js` / `.lib-index-old.js`），**变异轮直接改夹具那一份、逐字回退后复跑**；**工作树全程只跑绿相**。

### 参照夹具（U33c 的硬指标，逐项可复核）

| 项 | 值 |
| --- | --- |
| 输入 | `/team_session 你是新的主管会话`（正文 **8 码点**）|
| `team`（缺省 = 调用会话工作区目录名）| `dsh-session-link-pro`（**19 码点**）|
| 协调者 id | `session-self`（**12 码点**；断言 `codePointsOf(u33cEnv.senderAgent.id) === 12` 钉住这一条）|
| cwd | 仓内绝对路径 ＋ 同名末段 —— 真机那条 cwd 与它**同长**（cwd 字段封顶 24 码点 ⇒ 可见前缀不同、**长度逐字相同**）；测试里刻意不写仓外绝对路径 |
| 交付 `detail` **改前** | **569 码点 / 10 行** ✗（用户截图那次协调者 id 取满 28 码点 ⇒ **585 码点 / 10 行**）|
| 交付 `detail` **改后** | **345 码点 / 6 行** ✓（当批判据：≤ 350 且 ≤ 6 行。**偏差修复轮复算 = 353 / 6 行**，判据同时放宽到 ≤380 —— 见「§10.2.8 偏差修复轮」一节）|
### 病灶（本批，修复前必红，实测读数）

| 套件 | 判据 | 修复前（本批新测试 ＋ `HEAD` 实现）|
| --- | --- | --- |
| 宿主 | **U33c 参照夹具 ≤6 行 / ≤350 码点**（**新增**）| `{"cp":569,"lines":10}` —— 超 **219** 码点 / 超 **4** 行（现行判据 ≤380 下同样超线 ⇒ 红相不变）|
| 宿主 | **U33c 删除面逐条点名**（**新增**）| 10 条**全部还在**：标题自述段 · 标题段的解释（两句）· § 号 · 「两道门」的括号 · 「（保守）」· 模型解析的教学式说明（两句）· `工作目录（cwd）` 的同义 gloss · 未截断时重复一遍的投递承诺 |
| 宿主 | **U33 必备披露逐件点名**（**改写**，九件逐条带标签）| 缺 `cwd` / `成本` / `信任授予` / `确认则（两支）`（旧文案的字面与新判据不同；事实本身全在）|
| 宿主 | **U33 (i) / (ii) / (iii)**（改写）| `{"bodyCp":582,"cp":594}` · `{"bodyCp":592,"cp":604}` · `{"bodyCp":693,"cp":705}`（都是 body ＋ 段落级标注）|
| 宿主 | 既有断言 **9** 条（措辞被删 / 被改）| U16 确认框 2 条 · U33 换槽位 1 条 · 长 cwd 1 条 · 长团队名 1 条 · 两者都长 1 条 · U30 成本行 1 条 · DEFECT-4 ② 1 条 · 裁定 2 ② 1 条（**计数勘误**：2026-09-22 偏差修复轮 —— 左栏原写「8 条」而右栏列的本就是 **9** 项：2 ＋ 1 ＋ 1 ＋ 1 ＋ 1 ＋ 1 ＋ 1 ＋ 1 = **9**；`CHANGELOG.md` 同错已同批改准）|

**合计 `966 (failed: 15)`**（构成 = U33c **2** ＋ 逐件点名 **1** ＋ (i)/(ii)(iii) **3** ＋ 既有 **9** = 15，与 `.test-red-a.log` 的 15 行 FAIL 逐条相符）；客户端 `269 (failed: 0)`（`lib/client.js` 本批一字未改 ⇒ 红相不该动它，实测也确实没动）。

### 两条单点变异（新断言是不是活锁）

| 变异 | 改法（只夹具那一份）| 读数 |
| --- | --- | --- |
| **(a) 把删掉的解释性文字加回一处** | 信任行补回「（绕过发送方审批与接收方 ask 两道门，§10.2.3 预置配对）」| `966 (failed: 3)` —— **U33c 参照夹具当场变红：`379` 码点 / 6 行 > 350** ✓；另红两条：**删除面点名**（`§ 号` / `两道门` 还在）、**U16 信任授予**那条（它咬整句）|
| **(b) 删掉一件必备披露** | 把成本行与信任行的合并块改成只留成本行（整句「信任授予：…」消失）| `966 (failed: 3)` —— **U33 必备披露逐件点名当场变红，并逐字点名缺的是 `信任授予`** ✓；另红两条：**U16 信任授予**那条、**(iii) 机制一夹具**的守卫（body `607 → 551`，不再 > 600 ⇒ 夹具自证失效，断言如实变红）|

两具逐字回退后均复跑 **`966 (failed: 0)`** ✓。（(a) 的红落在**码点侧**、(b) 的红落在**在场侧**，与 `CHANGELOG.md` 末节记的两条判据一一对应。）
### 全夹具逐用例读数（**2026-09-22 偏差修复轮复算**；两列都是**真夹具**（cwd 字段 24 码点）上实跑）

> **这张表被复算过一次（2026-09-22 偏差修复轮，审计 DIVERGENCE #1 / #4）**：原表的 14 行里有 **7 行**把 cwd 取成探针里的 `C:/dev/demo/ws`（**14 码点**），而真夹具的 cwd（`host-half.test.mjs` 的 `TEAM_WS`）经 **24 码点**的字段封顶 ⇒ 那 7 行的**两列都少 10 码点**（同一个 cwd 字段只出现一次）。本轮按真夹具复跑，并把修复轮放回的「按各自模型计费」（有任务支 **+8** 码点）一并记进「改后」列 ⇒ 该行「改后」= 审计给出的复算值 ＋ 8（无任务支的四具不变）。

| 用例 | 改前（cp / 行）| 改后（cp / 行）|
| --- | --- | --- |
| **参照夹具**（12 码点协调者 id）| 569 / 10 | **353 / 6** |
| 参照夹具（28 码点协调者 id，= 真机 585 那一次）| 585 / 10 | **369 / 6** |
| 常规 `n=2 roles=worker-a,worker-b task=做接口`（`team=night-shift`）| 591 / 10 | 348 / 6 |
| 8 会话 ＋ 3000 字正文 | 557 / 10 | 426 / 6 |
| 39 字团队名 | 515 / 10 | 385 / 6 |
| 110 字 cwd | 594 / 10 | 376 / 6 |
| 长团队名 ＋ 长 cwd ＋ 8 会话 ＋ 500 字正文 | 565 / 10 | 434 / 6 |
| DEFECT-4 槽位 `n=2 team=title-dialog roles=worker-a,worker-b` | 597 / 10 | 377 / 6 |
| 既无正文也无 `task=`（`team=t n=2`）| 564 / 10 | 366 / 6 |
| 300 字 `model=` | 544 / 10 | 420 / 6 |
| 60 字 `preset=` | 523 / 10 | 382 / 6 |
| **(i) 中间档夹具** | 594 / 10（body 582 ＋ 全档标注 12）| **504 / 6**（＝必备 body 逐字，框内**无**标注行）|
| **(ii) 第二具中间档夹具** | 604 / 10（body 592 ＋ 标注 12）| **514 / 6**（＝必备 body 逐字，框内**无**标注行）|
| **(iii) 机制一夹具** | 705 / 10（body 693 ＋ 标注 12）| **615 / 6**（＝必备 body 逐字，**仍 > 600**）|

**读法与两处更正**：**十四具全部收到 6 行**；除机制一那一档（必备 body **615** > 600、**永不裁剪** ⇒ 设计档 §10.2.8.4 残余行「第一机制」原样保留）外**全部 ≤ 520 码点**，离硬顶 600/12 更远。机制一是**唯一**仍可能超 600 的一档，而它超的原因是**必备披露本身**，不是措辞。
（**① cwd 更正**）上表 7 行（常规 / 8 会话 ＋ 3000 字 / 39 字团队名 / DEFECT-4 槽位 / 既无正文 / 300 字 `model=` / 60 字 `preset=`）的两列各 **+10**：原表用了 14 码点 cwd，真夹具的 cwd 字段是 24 码点 —— 审计 DIVERGENCE #1 给出的 7 个复算值（591 · 557 · 515 · 597 · 564 · 544 · 523）与本轮实跑逐字相符 ✓；**参照夹具两行与五具 LONG_CWD 夹具（110 字 cwd / 长团队名＋长 cwd / (i) / (ii) / (iii)）原本就用 24 码点封顶的 cwd ⇒ 不受这条影响** ✓（7 ＋ 2 ＋ 5 = **14** 行）。
（**② 事实回归**）「改后」列凡夹具**带任务**者再 **+8** 码点（把有任务支被漏删的「按各自模型计费」放回），**无任务支的四具一字不变**。逐行读数：353（345 ＋ 8）· 369（361 ＋ 8）· 348（340 ＋ 8）· 426（418 ＋ 8）· **385（39 字团队名：无任务，不变）** · **376（110 字 cwd：无任务，不变）** · 434（426 ＋ 8）· **377（DEFECT-4 槽位：无任务，不变）** · **366（既无正文：无任务，不变）** · 420（412 ＋ 8）· 382（374 ＋ 8）· 504（496 ＋ 8）· 514（506 ＋ 8）· 615（607 ＋ 8）。

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰（本批只改确认框正文的构造与注释）|
| `ctx.session`（**单数**）/ `appendEvent` / `session.log` / `.append(` / `ctx.commands` | 仍各 **0** 命中 |
| `sessionQuery` / `commands.register` | **8** / **3**（与上一批同读数）|
| 模块级 `inject` 仍恰 4 项 | 未触碰（`sessionReferenceResolver / tools / sessionQuery / agents`）|
| `TEAM_SESSION_DIALOG_MAX_CODE_POINTS` / `MAX_NEWLINES` | **数值一字未动**（600 / 12）|
| `question` 单行做法 | 未触碰（本批九条 `question` 断言全绿）|
| 必备块裁剪逻辑 | 未触碰（必备块**永不裁剪**；本批动的是必备块**内部的行归属与措辞**）|
| 两档标注与终态预算机制 | **代码一字未改**（触发面变空，见「如实标注」第 1 条）|
| `lib/client.js` / 既有 schema key / 投递门 / `source` 三成员 / `/team_rotate` 文法面 | 未触碰（客户端 `269 (failed: 0)`）|

### 如实标注（本批）

1. **可裁段现在是空的（本批唯一一处「能力面变了」的事实，已在交付报告里点名请父侧决定）**：裁定 A 移出去的那个「会话标题」块**正是**此前唯一的 `required: false` 段 ⇒ `optional` 恒为空、`dropped` 恒为 0，`dialogFits` 与 `TEAM_SESSION_DIALOG_CROP_NOTE_TIERS` 这条**标注路径不再被触发**。用户裁定的「不许动：…两档标注与终态预算机制」按**代码原样保留**执行（一字未改），两档文案的长度与「不含自证矛盾句」仍由**纯函数**断言咬住；U33 (i)/(ii)/(iii) 三具夹具改写成**现在真正成立的形状**（交付逐字 = 必备 body；机制一仍超线）。**这不是本批可以自行决定的取舍**，已列为交付报告的第一条待决项。
2. **「行」的定义与判据同口径**：U33c 的两条上界都按**交付串 `detail`** 计（行数 = 换行数 ＋ 1），与 U33 的 600／12 一致。
3. **U33c 的 cwd 用的是仓内绝对路径**（不是真机那条仓外路径）：两者在框里都是「同长被 cap 的字段」（24 码点），所以**码点与行数两个判据的读数逐字相同**；这样写是为了不在测试里硬编码仓外绝对路径（设计评审 R1 曾按机械项点过这一类）。
4. **历史读数不改**：本文件前几节的 U33 逐用例表是**同一棵树不同时刻**的读数，按「只追加、不重写历史」的纪律一字未动；它们的夹具 cwd 与本节的探针夹具略有不同，故同一用例的绝对值会差几码点（cap 前后的可见前缀差异），**方向与幅度不受影响**。
5. **未做真机验证**：全部读数来自两套单元套件与上述隔离夹具；本批是**宿主半边**（需 DSH 重启才在真机生效）。

---

## §10.2.8 偏差修复轮 —— 独立发散审计 `DIVERGENCE(5)` 收口（2026-09-22；当次实测 `966 (failed: 0)` / `269 (failed: 0)`，与修复前**同计数**）

**设计（唯一事实源）**：`docs/collab-enhancements-design-2026-09-19.md` **§10.2.8.4 修法表 (c) 行的「落码读数 …… 判据定档」与「380 的来由（审计 DIVERGENCE #4 后定档）」** ＋ **§10.4 U33 行末的「裁定 A 落码后的口径更正」**（父侧同批写入，本批**不碰设计档**）。本批的**任务书就是偏差清单**（独立发散审计判 `DIVERGENCE(5)`：实现面的九个必备事实与裁剪机制**无偏差**，5 条全在读数/计数/规格口径/未申报删字/恒真断言上）—— 只修这 5 条，不扩范围。

### 五条偏差的处置（逐条）

| # | 偏差 | 处置 | 落点（本树）|
| --- | --- | --- | --- |
| **4**（先修，它决定下面所有数字）| **未申报删字**：有任务支成本行把「**按各自模型计费**」一并删掉（不在裁定清单里，且属**成本口径**：每队各按自己模型计费；无任务支一直保留着它 ⇒ 两支不一致）| **放回**（`+8` 码点；行数仍 6）| `lib/index.js:4758`（＋理由注释 `:4752-4755`）|
| **3** | **规格口径不一致**：设计档定档 **≤ 6 行 且 ≤ 380 码点**，而实现注释与 U33c 断言仍写 ≤350 | 两处同批写到 **380**，并**如实留下 350 → 380 的放宽与理由**（换回一条必备事实；**不写「本来就 380」**）| `lib/index.js:4699-4707`、`:4783`、`host-half.test.mjs:5273`/`:5278-5283`/`:5293`|
| **5** | **恒真断言**：`u33RequiredBodyOf` 是恒等函数、`u33HasCropNote` 恒 false ⇒ `detail === u33RequiredBodyOf(detail)` 不可能为假，而注释却称它防「假绿」| **选 (a)**：删掉那对包装，改成对**交付串本身**的**正面**判定「框内**没有**段落级标注」（标注形状的行数 = 0），并把误导注释改成如实口径（记明旧写法**结构上恒真**）| `host-half.test.mjs:5148-5160`（新助手）＋ `:5343-5345`/`:5355-5357`/`:5382-5385`（(i)/(ii)/(iii)）＋ `:5218-5220`/`:5245-5247`（两条同类反锁一并核过）|
| **1** | **文档读数错 10 码点**：`docs/verification-log.md` 的「全夹具逐用例读数」表有 **7 行**用了 **14 码点 cwd**（探针 `C:/dev/demo/ws`），而真夹具是 **24 码点**（`host-half.test.mjs` 的 `TEAM_WS`，字段封顶 24）| 用**真夹具**复算改准（该 7 行**两列各 +10**），并同批记入修复轮放回的事实的 +8 | 本节上一节的表（已就地复算，含两处更正说明）|
| **2** | **计数与列表不一致**：「既有断言 **8** 条」而右栏列了 **9** 项 | 同一次编辑改计数为 **9**（红相 15 的构成 = U33c 2 ＋ 逐件点名 1 ＋ (i)(ii)(iii) 3 ＋ 既有 **9**，与 `.test-red-a.log` 的 15 行 FAIL 逐条相符）| `docs/verification-log.md`（本节上一节病灶表 ＋ 合计行）、`CHANGELOG.md` 0.3.10 裁定 A 批 ③ |

**附带（同批）**：`lib/index.js:4154-4156` 的注释说 `dialogFits`「常规路径上不再被调用」，**实为任何路径都不被调用**（`optional` 恒为空 ⇒ 拟合循环与终态构造都走不到它）⇒ 改成如实口径。

### 红相 / 绿相（隔离夹具 `.test-tmp-fix/`：本批新测试 ＋ `git show HEAD:lib/index.js`，`HEAD` = `62c272b`）

| 相 | 读数 |
| --- | --- |
| **红相**（新测试 × 修复前实现）| **`966 (failed: 3)`** —— 三条全是「放回一条事实」的判据：**U33c 参照夹具**（`成本口径那半句仍在`；当处读数为 **345 / 6 行** ⇒ 码点侧在 380 下为绿、红在**事实缺席**）· **U33 必备披露逐件点名**（`（缺：["成本"]）`）· **U30 成本行同支纪律**（有任务支 `taskCostLine` 逐字缺「按各自模型计费」）|
| **绿相**（工作树）| `node host-half.test.mjs` → **`966 (failed: 0)`**；`node client-half.test.mjs` → **`269 (failed: 0)`**（`lib/client.js` 一字未改）⇒ **断言总数与修复前相同**（`966` / `269`），本轮无新增/删除断言、只有判据与文案的改写 |

### 变异验证（新断言是不是活锁）

| 变异 | 改法（只改夹具那一份 `lib/index.js`）| 读数 |
| --- | --- | --- |
| **A（偏差 5 的正面断言）** | 把段落级标注**人为塞回**终态（`const text = candidate(kept, dropped) + "\n" + teamSessionDialogCropNote(1, TEAM_SESSION_DIALOG_CROP_NOTE_FULL);`）| **`966 (failed: 6)`** —— 6 条**全部**点出那行标注：U33 (i) `526` · (ii) `536` · (iii) `637` · 长团队名 `407` · 两者都长 `456` · U33c（`375` 码点 / **7 行**）。**正面断言可假 ⇒ 不是恒真** ✓（旧写法里那半条 `detail === u33RequiredBodyOf(detail)` 才是恒真的那半条）|
| **B（U33c 码点侧）** | 把删掉的一处解释性文字**加回**（信任行补回「（绕过发送方审批与接收方 ask 两道门，§10.2.3 预置配对）」，`+34` 码点）| **`966 (failed: 3)`** —— **U33c 参照夹具 `387` 码点 / 6 行 > 380** ✓（放宽后的判据照样咬得住；裁定 A 批记的同一条变异是 `379 > 350`）＋ **删除面逐条点名**（`§ 号` / `两道门` 还在）＋ **U16 信任授予**（它咬整句）|

两具逐字回退后均复跑 **`966 (failed: 0)`** ✓。

### 复算读数（真夹具，24 码点 cwd）

- **参照夹具**：**353 码点 / 6 行**（12 码点协调者 id；修复前 345 ⇒ 放回事实 `+8`）；**369 码点 / 6 行**（**28 码点 id，即真机那一次**；修复前 361 ⇒ `+8`）。原真机读数 **585 / 10 行**。
- **判据**：**≤ 6 行（硬）且 ≤ 380 码点**（两个参照都在内：353 / 369）。
- **机制一残余**：最极端组合的必备 body 由 **607 → 615**（仍 `> 600`，该档**永不裁剪** ⇒ 设计档 §10.2.8.4 残余行「第一机制」原样保留，不是本批要修的东西）。
- 十四具逐用例读数见本节上一节的复算表（**7 行 +10、带任务者 +8、无任务支四具不变**）。

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰（本批只改一行成本文案、注释与断言）|
| `TEAM_SESSION_DIALOG_MAX_CODE_POINTS` / `MAX_NEWLINES` | **数值一字未动**（600 / 12）|
| 裁剪机制 / 必备块 | 未触碰（必备块**永不裁剪**；本批没动一行裁剪逻辑）|
| 模块级 `inject` 仍恰 4 项 | 未触碰（`sessionReferenceResolver / tools / sessionQuery / agents`）|
| `sessionQuery` / `commands.register` | **8** / **3**（与上一批同读数）|
| `ctx.session`（**单数**）/ `appendEvent` / `session.log` / `.append(` | 仍各 **0** 命中 |
| 既有 schema key / 投递门 / `source` 三成员 / `/team_rotate` 文法面 | 未触碰 |
| `lib/client.js` / `main` | 一字未改（客户端 `269 (failed: 0)`）|

### 如实标注（本批）

1. **偏差 5 选的是 (a)**：U33 (i)/(ii)/(iii) 的断言措辞由「交付 `detail` **逐字等于必备 body**」改为「交付 `detail` 里**没有**段落级标注」—— 后者**可假**（变异 A 实测 6 条红），前者在裁定 A 之后是**从 detail 自算的恒真式**。设计档 §10.4 U33 行末那句「(i)/(ii) 断言交付逐字等于必备 body …… 且『**没有**段落级标注』由本组另一条正面锁住」因此**按 (a) 的写法落地**：逐字交付这件事在**没有标注行 + 九件逐件点名 + 两个预算**三条判据的合取里成立，不再由一条恒真断言自称。
2. **判据放宽是「有代价的放宽」，不是迁就读数**：`≤350` 只对 12 码点参照成立（历史来源是那次本地复现）；放回一条必备事实（`+8`）后上界由 **350 改 380**（`+30` = `+8` 的记账 ＋ 覆盖 28 码点真机参照 369 的余量），且变异 B（加回 34 码点）在 380 下**仍红**—— 口径变松一寸，判据强度未降。
3. **断言总数未变**（`966` / `269`）：本轮**不改** `README.md` 的 tests 徽章与「当前读数」（它记的就是这两套件的自报计数），**未触碰 `README.md`** —— 本仓「计数与列表同改」在这里表现为「没有变化 ⇒ 没有编辑」，而不是「顺手重写一遍」。
4. **未做真机验证**：全部读数来自两套件与上述隔离夹具；本批是**宿主半边**（需 DSH 重启才在真机生效），「渲染高度不超视口」照旧是设计显式降级的**真机项**。
5. **本批未改设计档**：`docs/collab-enhancements-design-2026-09-19.md` 不在本批文件清单内（父侧同批写入的规格，本批逐字实现）；**没有发现规格与代码必须分歧的地方**。

---

## §10.2.8.9 / §10.2.8.10 批（2026-09-22；当次实测 `995 (failed: 0)` / `269 (failed: 0)`，基线 `971 (failed: 0)` / `269 (failed: 0)`）

**设计（唯一事实源）**：`docs/collab-enhancements-design-2026-09-19.md` **§10.2.8.9**（① 默认名带日期 · ② 现任失联 ⇒ 释放并认领）与 **§10.2.8.10**（① 调用方回执 = 通道 4 · ② 无任务也投最小唤醒），以及 §10.2.8.4 的 U33c 判据。**+24 条断言**（971 → 995）。

### 本批的判据面（新增/改写，逐条点名）

| 面 | 条数 | 判据 |
| --- | --- | --- |
| **U35** 默认名带日期 | 5 | 格式（`<basename>-YYYYMMDD` / 回退 `default-YYYYMMDD`）· 同日幂等（纯函数）· 同日幂等（命令级，第二条零创建零对话框）· 跨日另起一队（store 两个团队、第一天那行原样还在）· **孤立后果**（无日期的旧团队仍有效 → 默认名不再解析到它、无迁移、旧行逐字未动）。**全部注入「当天」**（`__testing.teamSessionInjectNow`），不靠墙钟 |
| **U36 (a)–(h)** 释放并认领 | 8 | (a) 归档 ⇒ 认领 ＋ 版本史 `released: coordinator archived` ＋ `policy.writer` 仍 `coordinator` ＋ 报告点名 ＋ pairs 只给本次 worker · (b) gone ⇒ 同上（`… gone`，措辞不混）· (c) 现任存活 ⇒ 既有文案**一字不变**、零弹框零写入 · (d) 读不到 ⇒ 拒绝 · (e) 甲＋只归档 ⇒ 拒绝 · (f) 甲＋gone ⇒ 释放成立 · (g) **既有角色逐字未动**（`pending`/`rotationAt`/自己的版本史）· (h) **触发释放的框体** ≤6 行且 ≤390 码点、披露折在「确认则」一行 |
| **U37** fail-safe 与边界 | 4 | (甲)/(乙) 两形状**互不污染**（甲 ⇒ 跳过归档信号、只按 gone；乙 ⇒ unknown ⇒ 拒绝且文案点出读不出）· 变异基线 2（**只看现任**：旧任归档、现任活着 ⇒ 不释放）· 变异基线 3（**TOCTOU**：确认框期间复活 ⇒ 中止、零 roster 写入、**pairs 也不写**） |
| **U32 通道 4** 调用方回执 | 6 | 成功（**恰一次** followup、三成员信封、`senderSessionId` = 调用方、≤120 码点）· 无任务形态（`其中最小唤醒 M 个`，M 读的是**真投出去的那几具**）· 取消（也花一个回合，文本写明零创建零 pairs）· **解析前失败**（`n=abc` ⇒ 回执里**不含**团队名）· 解析后失败（含团队名 ＋ 出路尾句）· 无新日志事件类型 |
| **U30 默认值第 4 条（反转）** | 3 | 会话照建（恰 2 个）**且每个被 followup 恰一次**（inject/steer 零次）· 唤醒文本**三件逐件点名**（每个会话说自己那个角色）且**不编任务**（无 `- 任务：` 行、不要求它做事）· 措辞同步（框里「投最小唤醒 / 唤醒不含任务」、回报「已投最小唤醒（本次未给任务）」） |
| **成本行（改写）** | 1 | 两支**逐字同形状**（`N＋1 个回合（N 个新会话 ＋ 1 条调用方回执；按各自模型计费）`）；`followup 驱动一次` / `0 次驱动` / `不投启动任务` 在两支里**都不再出现** |
| **U33c（重测）** | 2 | 参照 A（12 码点 id）**355** / 参照 B（28 码点 id）**371** / 释放变体 E（28 码点 id ＋ 带日期团队名）**382** ≤ **390**；E 必须逐字等于 B 在 pairs 之后插入那 11 码点披露（**折叠**，不是新起一段） |

### 变异验证（三条，逐条实跑；每条只红它该红的那条）

| # | 把哪一行改坏 | 读数 | 红的恰是哪条 |
| --- | --- | --- | --- |
| A | (乙) 的 `unknown` ⇒ 「读不到就释放」（两处 return） | `995 (failed: 1)` | **U37 (乙)**（getter 抛错 / 不是数组那一具） |
| B | 「只看现任」⇒ 看任一历史任（handler 取 `history[0].session`） | `995 (failed: 2)` | **U37 变异基线 2** ＋ 一条**既有计时器夹具的偶发红**（见下） |
| C | 写时复检去掉活性那一半（`revived = false`） | `995 (failed: 1)` | **U37 变异基线 3（TOCTOU）** |

三条变异各自跑完即**逐字还原**，还原后复跑 `995 (failed: 0)`。

### 隔离夹具的红相（新测试 ＋ 旧实现）—— **当次实测 `995 (failed: 34)`**

**旧实现** = 本批改动前的 `348385a:lib/index.js`（含 §10.2.8 与裁定 A 的全部修法、不含本批）；**新测试** = 本树 `host-half.test.mjs`；夹具在 `.test-tmp-r7pre/`（`node_modules` 用 **junction** 指回仓内 —— `Copy-Item -Recurse` 不跟 junction，照抄会得到一棵坏树 `ERR_MODULE_NOT_FOUND: @deepseek-ai/cosmokit`）。

**34 条红，逐条点名**（按套件顺序；★ = 该条在旧实现上**绿**，属**负相**，如实记不算「修复前已红」）：

| 组 | 红 | 备注 |
| --- | --- | --- |
| U16 确认框 · 成本口径 | 1 | 成本行改写 |
| U33 · 长团队名字段封顶 | 1 | 封顶 20 ⇒ 截断位置不同 |
| U33 · 必备披露逐件点名 | 1 | 成本 token 变 |
| U33c · 参照 A ＋ 参照 B/E | 2 | 判据 390 与披露句 |
| U30 默认值（日期） | 2 | `<basename>-YYYYMMDD` |
| U35 | 5 | 格式 / 同日幂等 ×2 / 跨日 / 孤立后果 |
| U30 默认值第 4 条（反转） | 4 | 驱动 / 唤醒三件 / 措辞 / 成本行 |
| U32 通道 4 | 5 | 成功 / 无任务 / 取消 / 解析前 / 解析后；**★「无新日志事件」那一相在旧实现上也绿**（旧实现同样不引入新事件类型 —— 它是**红线锁**，不是「修复前必红」） |
| U36 | 8 | (a) / (a) 出席 / (b) / (g) / (h) / 工具路径 / 工具路径边界 / **空批角**（评审 round-1 🟡#1 新增的那条判据）；**★ (a) 的「`policy.writer` 仍为 `coordinator`」那一相在旧实现上也绿**（旧实现从不释放 ⇒ 边界本来就没被放宽 —— 也是**锁**，不是红相） |
| U37 | 4 | (乙) / (甲)+只归档 / (甲)+gone / 变异基线 3；**★ 变异基线 2（只看现任）在旧实现上也绿**（旧实现从不释放 ⇒ 它本来就拒绝）—— 这一条是**新语义的守卫**，其红相由 §「变异验证 B」提供（把现任判定换成看历史任 ⇒ 当场红） |

**客户端半边一字未改**（`269 (failed: 0)`）。

### 红相实跑抓出的**两个自己的崩相**（Y7 纪律，本批教训）

第一次跑红相时读数**不是 32 条红而是一次崩溃**（`assertion total` 都不打印 ⇒ 红相谎报了自己的规模）。根因两条，都在**我新写的测试**里：

1. **未守卫的可测面读取**：`__testing.TEAM_SESSION_RELEASE_NOTES.archived` / `__testing.roleRecord(...)` / `receiptTexts(env)[0].includes(...)` 在旧实现上分别是「读 `undefined` 的属性」「调 `undefined`」⇒ `TypeError` 崩在夹具构造/断言里。修：本批所有**新增**可测面在 §«受守卫读取» 那一块**统一先取值再判类型**（`RELEASE_NOTES ?? {}` / `ROLE_RECORD` 退化成恒等 / `receiptTextOr(env)` 返回 `undefined`），断言自己变红。
2. **只在假分支上求值的 `probe` 被声明在后面**：`probe` 只在条件为**假**时被求值 ⇒ 新实现上永远走不到，旧实现上在**很靠前**的通道 4 那几条里第一次被走到 ⇒ `ReferenceError: Cannot access 'probe' before initialization`。修：把 `probe` 与受守卫读取放在同一块（文件靠前处）。

**这条教训值得独立记一笔**：**「绿了就完事」会漏掉红相的形状问题** —— 本批若非真去跑「新测试 ＋ 旧实现」，这两个崩相会一直躺在树里，直到将来某次真正的修复前必红场景才炸。本仓的 Y7 纪律因此不是史前遗迹而是一条**活的规定**。

### 红线回归（本批）

| 红线 | 读数 |
| --- | --- |
| 不新增任何日志事件类型 | 未触碰（回执走的是**已有**的 `followup` 面；新增断言只读它） |
| `TEAM_SESSION_DIALOG_MAX_CODE_POINTS` / `MAX_NEWLINES` | **数值一字未动**（600 / 12） |
| 模块级 `inject` 仍恰 4 项 | 未触碰（`sessionReferenceResolver / tools / sessionQuery / agents`） |
| `source` 恰三成员 | 未触碰（回执复用 `relayUserMessage`，断言逐字钉三成员） |
| `policy.writer` 取值 | 仍 `coordinator`，**未放宽成 `any`**（U36 (a) 边界⑤断言） |
| 既有 schema key | 未新增、未改形（版本史的 `note` 是既有字段；释放只写它） |
| `lib/client.js` | 一字未改 |

### 如实标注（本批）

1. **§10.2.8.10 的实现期兜底没被触发**：设计给的是「先试 handler 内 `followup`，任一条冒烟判据不过就改结算后定时器」。本批**先试的那条路**就成立 —— ① 恰一个回合（断言）② `command/done` 仍落盘（未触碰结算路径）④ 重试不双投（`followup` 只有一处调用点）。**③「不阻塞」与真机面：已在「真机复验（2026-09-22 重启后）」一节里验到**（见下）—— 真机读数 `command/done → 回执落盘 0.288 s`，而回执花掉的那个模型回合在 `command/done` **之后**；真机日志里调用方会话与两个 worker 都出现了 `turn/start`，用户也在侧边栏同时看到三个会话。**本条的旧表述（「仍是真机项、不得声称已验证」）已被该节取代。**
2. **设计档两处勘误同批改**（描述面与实现一致）：**(i)** §10.2.8.9 ② 的披露句设计写「**12 码点**」，字面量 `（将释放并接管原团队）` 逐字数 = **11** —— 判据按**字面量**钉 11，以 12 为口径上界，档内已加勘误行；**(ii)** 同节的实测代价 `364 / 380` 是**改写成本行之前**的读数，本批重测为 **348 / 382**（§10.2.8.10 把成本行改写成 N＋1 回合口径、读数整体 −7）。
3. **U33c 的判据数字对齐**：测试里此前写的是 **380**，设计档 §10.4 的 U33c 行定的是 **390**（比设计档更严）。本批把测试改成 **390** 并**逐具写下读数**（355 / 371 / 348 / 382）—— 这是「与它声称跟随的设计档对齐」，不是放宽：390 之下的 382 余量只有 8，所以成本行只能**缩短**（见 CHANGELOG 的那条经申报的改写）。
4. **成本行的机制短语让位**：`followup 驱动一次` 从框内成本行移除（同一份事实由「确认则：创建 → 投递启动任务」承载），「**按各自模型计费**」逐字保留。这是**经申报的删减**，不是「顺手删事实」——理由与代价（换回执那 12 码点的预算）写在代码注释与 CHANGELOG 里。
5. **一次既有计时器夹具的偶发红**：「缺口1 超时读数自报真实后果（计时器到点）」在本批的多次跑里出现过 **1 次**（变异 B 那一次），**连续两次复跑均绿**；它与本批三条新语义无关（`/team_rotate` 的 claim 超时读数），**如实记录、不计入本批证据**，也不掩盖（本批的每次读数都取自完整输出）。
### 评审 round-1（`advisor type=code`，自动节点）与逐条处置

**评审产出**：`advisor-dsh-18`，**VERDICT: PASS**，**无 🔴**；1 🟡 ＋ 6 🔵。它读的是本批 **`f09d153` 之前**的 `host-half.test.mjs`（暂存副本先于那次 Y7 修复；lib 与文档与最终版一致）。

| # | 级别 | 它指出的 | 处置 |
| --- | --- | --- | --- |
| 1 | 🟡 | **零创建路径静默丢弃「释放并认领」**：既有团队 ＋ gate 拒绝 ＋ 证据门已确证，但本次没有要建/登记的角色时直接返回「无需创建」—— 释放既不发生也不被提及 ⇒ 用户会以为接管完成了 | **Fixed**：该支现在把两件事都说出来（证据已确证 `released: coordinator archived\|gone`、本次**未释放未认领**、下一步「重发一条带新角色的命令」），调用方回执也带 note；并新增判据 **U36 空批角**（零写入 ＋ 两处都说明白）。**「在空批上直接释放」**属设计未定（释放是**身份写入**、§10.2.4 要求必经确认框，而这条框的内容是「将创建 N 个…」）⇒ **留待用户裁定，不自行发明**（代码注释与本表同步记） |
| 2 | 🔵 | 断言标签写「恰 12 码点」，实际钉 11 | **Fixed**：标签与注释对齐 11（口径上界仍 12） |
| 3 | 🔵 | 设计档另三处（§10.2.4 / §10.2.8.4 / §10.3）仍写「12 码点」 | **Fixed**：三处一并改 11 并指向 §10.2.8.9 ② 的勘误行 |
| 4 | 🔵 | 唤醒 / 启动任务文本承诺「已建立 pairs」，在**释放中止**（本批明确不写 pairs）或 pairs 写入失败时为假 | **Fixed**：两支都改成「应已建立；若投递仍弹确认框，说明这次没建上，见完成回报」 |
| 5 | 🔵 | 写时复检中止的回执 reason 是通用句 | **Fixed**：改成点名「释放并认领中止（现任复活 / 证据变化），本次零写入」；TOCTOU 那条判据同时咬回执 |
| 6 | 🔵 | 设计档两处行号（`lib/index.js:5122` / `:8915`）已失准 | **Fixed**：去掉具体行号（守卫本批已撤除），改为文字描述 |
| 7 | 🔵 | 注入缝 `TEAM_SESSION_NOW_INJECTED` 有泄漏面（一条断言在注入窗口内抛错 ⇒ 墙钟被钉死、红相骗人） | **Fixed**：测试侧新增 `withInjectedNow(now, fn)`（**try/finally 还原**）并全部改用，删掉手动 inject/uninject 的助手 |

**处置后的全部读数（重测，不是复用旧数）**：绿相 `995 (failed: 0)` / `269 (failed: 0)` · 红相 `995 (failed: 34)` · 变异 **A** `995 (failed: 1)`（只红 U37 (乙)）· **B** `995 (failed: 2)`（U37 变异基线 2 ＋ 那条**既有计时器偶发红**）· **C** `995 (failed: 1)`（只红 TOCTOU 那条）。**评审 round-2** 针对处置后的修订重跑，见下节。

### 评审 round-2（`advisor-dsh-22`，路由 deepseek-official:deepseek-flash）与处置

**VERDICT: PASS** —— 上表 **7 条逐条核实为 Fixed**（它逐条引出落点），另提 **2 条新的非阻断 🔵 ＋ 1 条同类残余**：

| # | 级别 | 指出 | 处置 |
| --- | --- | --- | --- |
| 3-残余 | 🔵 | 同一字面量在 **`lib/index.js` 的三处注释**里仍写「12 码点」 | **Fixed**：三处一并改 11（其中两处带勘误指针；另几处「12 码点」指的是**协调者 id 长度**，那是对的，未动） |
| 8 | 🔵 | 修 #1 时**新加的那条断言**绕过了本块自己的 Y7 守卫（直接读 `__testing.TEAM_SESSION_RELEASE_NOTES.archived`） | **Fixed**：改读受守卫别名 `RELEASE_NOTES.archived`，并就地记一句「为什么这里必须走别名」 |
| 9 | 🔵 | 本节红相引导句仍写「**32 条红**」，而同节标题是 `995 (failed: 34)`、分组和也是 33 | **Fixed**：改 33 |

**关于 round-2 尾部的 `[host-verified] 0/16 citations match current file state` —— 这是校验器的假警报，不是评审编造行号。** 我抽 5 条逐字核对：`lib/index.js:4908`（当时那行 `12-code-point` 注释）· `:6089` `emptyBatchNote` · `:6152` `receipt.reason` · `host-half.test.mjs:5392`（U33c 参照 B/E 标签）· `:5331`/`:5334`（`withInjectedNow` 的 seam 与 `try/finally`）—— **全部逐字对上**。成因应是校验器把评审给出的**裸相对路径**（`lib/index.js`）按**会话工作区**解析（那里没有 `lib/`），找不到文件 ⇒ 0/16。**记此以免后人把这条警报读成「评审引文不可信」。**

**round-3**（只验上表 3 行，不猎新问题）见本文件末尾的续记（如有）。处置后读数：绿相 `995 (failed: 0)`。

### 评审 round-3（`advisor-dsh-23`）—— 收敛

**VERDICT: PASS**：**9 行逐条核实为 Fixed**（round-1 的 🟡#1 ＋ 🔵#2–#7、round-2 的 🔵#8/#9），**无 🔴、无 must-fix 🟡、无新增发现**（round-3 按纪律只验上表，不猎新问题）⇒ **收敛循环结束**（round-1 PASS → round-2 PASS + 2 新 🔵 → round-3 PASS）。

尾部的 `[host-verified] 0/13 citations match current file state` **仍是同一假警报**：我又抽 3 条逐字核对（`lib/index.js:6090` 的 `emptyBatchNote` · `:5972` 的回执 `note` 支 · `host-half.test.mjs:5759` —— 即 **#8 修好后的 `RELEASE_NOTES.archived`**），**全部对上**。两轮合计 `0/29`，成因已记于上一节（裸相对路径按会话工作区解析）。

**收敛后的最终读数**：绿相 `995 (failed: 0)` / `269 (failed: 0)` · 红相（新测试 ＋ `348385a:lib/index.js`）`995 (failed: 34)` · 变异 A `995 (failed: 1)` · B `995 (failed: 2)`（含那条**既有计时器偶发红**）· C `995 (failed: 1)`。

### 真机复验（2026-09-22 重启后；用户放行重启窗口）

**面 0 · 工具面（我自己跑，不需要人类）**：用一次性团队 `rm-probe-20260922` 造出「现任 = 不存在的会话」（`upsert-team` 创建 ⇒ `set-role` 到 `session-rm-gone-20260922`），再从**非现任**会话调 `upsert-team`：

- 报告：`团队 rm-probe-20260922 已存在，且原现任协调者 session-rm-gone-20260922 确证失联（已不存在）⇒ 按 §10.2.8.9 ② **释放并接管**：版本史写入「released: coordinator gone」、current 置为调用会话 …；**既有角色与它们的现任逐字未动**，policy.writer 仍为 coordinator（未放宽成 any）。`
- `action=get` 的版本史逐条对上：`session-rm-gone-20260922　20:49:26 → 20:49:32　备注：released: coordinator gone`，随后现任 = 我的会话 ⇒ **工具面（无确认框 ⇒ 只靠证据门）真机成立**。

**面 1 · `/team_session` 命令面（用户敲，我读日志）**：在**新建的空会话**里发 `/team_session team=rm-release-20260922 n=2 roles=a1,a2`（**故意不给正文/task=**）：

| 判据 | 真机读数 |
| --- | --- |
| 释放并认领（命令路径） | 版本史 `session-rm-ghost-20260922　20:52:48 → 20:57:20　备注：released: coordinator gone`；现任 = 用户那个会话 `session-526faa3c-…`（自 20:57:20） |
| 完成清单（截图逐字） | 两行 `a1/a2 → team-link-…：已创建 + 已投最小唤醒（本次未给任务）` ＋ `- roster：已登记 2 个角色：a1、a2（按 §10.2.8.9 ② 释放并接管原团队：released: coordinator gone）` ＋ `- pairs：与主会话 session-526faa3c-… 建立/确认 2 条…` |
| **回执（通道 4）** | 调用方日志 seq 12 `user/message`，`source={kind:"agent-message",form:"relay",senderSessionId:"session-526faa3c-…"}` —— **恰三成员、sender 就是调用方自己**；文本 `/team_session 完成：团队 rm-release-20260922，新建 2 个（其中最小唤醒 2 个）`；GUI 渲染为独立卡片「跨会话消息 来自 session-526faa3c…」 |
| **最小唤醒** | worker a1 日志 seq 9 那条 `relay` 消息逐字含三件（`【待命通知 · 本次命令未给任务】`／`你已被创建为团队 rm-release-20260922 的角色 a1`／`请等待主会话派活`），且**没有**「- 任务：」行 ⇒ 不编任务 |
| **侧边栏可见（用户确认）** | 「目前三个会话都有了」——a1／a2／调用方会话同时可见（**改前这两类会话都没有回合 ⇒ 隐身**）；a1 日志 seq 5 = `turn/start`，以「至少一个回合」为判据的壳侧列表必然列它 |
| **时序（「不阻塞」读数）** | `command/run 12:56:44.932` → worker 创建开始 `12:57:19.494`（≈**34.6 s 是人在框里停留的时间**）→ `command/done 12:57:47.188`（**结算本身 ≈27.7 s**：2×`agents.create` ＋ 挂载 ＋ 命名 ＋ roster ＋ pairs）；`command/done → 回执落盘 0.288 s`，而回执花掉的模型回合在**其后**（seq 10 `step/start` .469、seq 12 消息 .476）⇒ **回执在结算窗口内的边际代价 = 入队一条消息** |
| 如实记一处事件序 | `turn/start`（seq 7，12:57:47.111）**早于** `command/done`（seq 9，.188）77 ms —— 因为 `followup` 在 handler 内发出（设计指定先试的那条路），宿主的 splice 立即发生；**回执消息本身（seq 12）在 `command/done` 之后**，turn 的第一次 `step/start` 也在其后 281 ms ⇒ 与「回执在 `command/done` 之后」不矛盾，未观察到互锁 |

**面 2 · 确认框（用户截图，按「取消」⇒ 零副作用）**：同一测试会话里发 `/team_session n=1 roles=b1`（**省略 `team=` 也省略正文**）：

- 第一行团队名 `dsh-session-link-pro-20260922` ⇒ **带日期默认名真机成立**（§10.2.8.9 ①）；
- 「确认则」行含 `（将释放并接管原团队）` ⇒ **框内披露成立**（§10.2.8.9 ②）；
- 成本行 `成本：2 个回合（1 个新会话 ＋ 1 条调用方回执；按各自模型计费）` ⇒ §10.2.8.10 的 N＋1 口径成立；
- 信任授予那一格里协调者 id 显示 `session-79af…`（已脱敏） ⇒ **真机会话 id 是 44 码点、被 `id: 28` 封顶并留省略号** —— 本档早先记的「真机 28 码点」是**错的**（正确性不受影响：封顶 ⇒ 44 与 28 两具交付串等长），已在 §10.2.8.4 的「判据定档」里更正；
- **框体紧凑、底部「创建 / 取消 / 提交」全在视野内** ⇒ 缺陷 ③ 的「动作可达性」真机验收成立。

**真机复验抓出的一个真问题（已修，属我漏补判据）**：设计档 §10.2.8.10 🟡#7 明确要求「补一具**无任务形态**的框体读数」，**我漏补了**；真机那一次命令恰好落在「无任务 ＋ 释放披露 ＋ 带日期团队名 ＋ 44 码点 id」上 ⇒ **交付串实测 399 码点 > 390**（硬预算 600 未破、6 行未破）。修法**不是放宽判据**：压掉同一张框里的**重复**文案（「- 启动任务：」与「确认则」两行的括号都写「未给正文/task=」，且「改投最小唤醒 / 唤醒不含任务」两行各说一遍 ⇒ **−18**）⇒ **381 ≤ 390**；并**补上缺失的夹具**（U33c 参照 **F/G/H/I**：354 / 370 / 370（44 码点 id 封顶后与 28 码点等长）/ 381）。修后重跑：绿相 `995 (failed: 0)` / `269 (failed: 0)` · 红相 `995 (failed: 34)` · 变异 A／B／C `995 (failed: 1)`／`995 (failed: 1)`／`995 (failed: 1)`。

**本节的代价与残留（如实记）**：① 真机复验在用户 roster 里留下 **3 个一次性探针团队**（`rm-probe-20260922` · `rm-release-20260922` · `dsh-session-link-pro-20260922`）与其会话 —— **这三个团队同日已按 `retire` 退役**（见下），但**团队行仍在 roster 里**：工具面**没有删除动词**，删行只有**用户设置 UI** 一条路（父侧未碰、也不该碰）；② 面 2 的那次命令**按了取消**，所以「带日期默认名 ＋ 释放披露」这一格只有**框体读数**、没有落笔（落笔那一格由面 1 的显式 `team=` 命令覆盖）；③ 「渲染高度不超视口」这一条真机项本轮**已被动验到**（截图里动作行全在视野内），但它依赖窗口宽度，仍不作单测断言。

**同日收尾（退役与清理，真机读数）**：

| 团队 | 谁发起退役 | 读数 |
| --- | --- | --- |
| `rm-probe-20260922` | 父侧会话（我是现任） | `已退役：… 现任 session-b480e5d6… 置空（vacant），版本史记录 until=2026-09-22 21:17:52`；`信任清理：没有指向该会话的 pairs / trustedSenders / rememberTargets，无需清理` |
| `dsh-session-link-pro-20260922` | 父侧会话（**先经 §10.2.8.9 ② 把那具幽灵现任释放并认领到我身上，再退役**） | 释放读数 `原现任协调者 session-rm-ghost3-20260922 确证失联（已不存在）⇒ … released: coordinator gone`；随后 `已退役：… until=2026-09-22 21:18:15` |
| `rm-release-20260922` | **用户**在其测试会话 `session-526faa3c…` 里发起（现任才能发起 —— 父侧调用被 `retireGate` 拒：`只有现任协调者会话 session-526faa3c… 可写`） | `已退役：… until=2026-09-22 21:20:26`；**`信任清理：2 个 pairs 已清（0 trustedSenders / 0 rememberTargets）`** ⇒ 退役那一步的信任清理提示**也在真机走过** |

三行现均 `vacant`（`current=null`）⇒ 谁都写不进去、只有用户经设置 UI 能再任命 —— 这正是退役「把席位交回给人」的效果（**空缺席位连 §10.2.8.9 ② 的释放路径都够不着**：没有现任可判，`retireGate` 自己第一句也拒）。盘上那三个黑板目录（`team/rm-probe-20260922/`、`team/rm-release-20260922/`、`team/dsh-session-link-pro-20260922/`）由父侧删除（工作区里 `team/` 是**未跟踪**文件，`git ls-files team` 为空 ⇒ 删除无 git 影响）。

6. **`README.md` 的两处计数已同批更新**（徽章 `966 → 995`、「当前读数」`966 → 995`）—— 本仓「计数与列表同改」：本批**新增了 24 条断言**，因此这两处**必须**动（与上一批「没有变化 ⇒ 没有编辑」相对）。另在「十、测试」下加了一段**用法变化**（空会话里发命令会有回执把会话显出来 ＋ 代价）。

---

## 团队任务台账 `tasks.md` 第一批（设计 §9）＋ 分歧修复轮（2026-09-26；当次实测 `1057 (failed: 0)` / `269 (failed: 0)`，基线 `995 (failed: 0)` / `269 (failed: 0)`）

**设计（唯一事实源）**：`team-ledger-and-mode-design-2026-09-26.md` **§9**（§9.3 方案 / §9.4 边界与红线 / §9.5 判据 **U1–U18** / §9.6 明确不做 / §9.9 跨文档同步六条）；会诊底稿 `consult-minutes/2026-09-26-consult-9-minutes.md`（§2 逐条处置 19 条 · §3 三处分歧裁定）。

**+62 条断言**（995 → 1057）：**51 条**随第一批实施（台账本体），**11 条**随同日分歧修复轮（只读分歧审计 D1–D9 的收口）。

### 本批做了什么

1. **台账本体（§9.3）**：新增第三个黑板文件 `tasks.md`（`<workspace>/team/<name>/tasks.md`）—— 只追加、每行署名，行格式 `seq | ISO时间 | author-session-id | kind | task | 正文`。`kind` 是**闭集**（`plan` / `claim` / `done` / `block` / `dispute` / `retract`）；`kind=plan` 由插件**扫全文件**分配 `t-<已登记最大号+1>`，其余 kind 必填 `task` 且该号必须已在本文件登记过；`seq` **每文件独立计数**；`kind` / `task` 传给 `decisions` / `discipline` 一律拒绝且零写入。
2. **读面（§9.3.3）**：`team_link_team_read` 在 discipline 块之后追加 tasks 块（原始窗口末 20 条逐字 ＋ 派生视图扫最近 500 行 ＋ `baseHash` 仅供参考/审计 ＋ 三类边界如实标注：文件不存在 / 更早的 N 行未参与派生 / N 行无法解析）。
3. **派生规则（§9.3.4）**：最后主张 ＝ 该任务最后一条 `claim` / `done` / `block`；`retract` **不抹历史**；`dispute` 之后无新主张 / 撤回才标 `⚠ 未消解存疑 N 条`；**绝不自动裁决**；措辞一律「最后主张 / 未消解存疑」。
4. **分歧修复轮（本档新增的那 11 条判据）**：**D1** 两条尾巴紧跟 `）`（分隔符 `· `，其前无空格）· **D5** 删掉未申报的附加段「此主张后共 N 条撤回行」并锁「多条撤回取**最后一条**填 `#N`」· **D8** 读面尾巴与工具 description 由两文件口径改成**三件套** · **D9** 分配路径只接受**安全整数**（`Number.isSafeInteger`），不满足即**拒绝并报出原因**（不静默钳制）· **D4/D6** 补判据（U4 的 `=500 码点收` · U12 的 `block 可作最后主张` · U18 的四组合全覆盖 · §9.3.4 rule 2 的两条子情形）。

### 红相（两次实跑，读数原文）

**两次换实现都走同一条安全纪律**：备份工作树的 `lib/index.js` → 换实现 → 跑套件记读数 → 从备份还原 → **sha256 前后逐字比对**（两次还原后均为 `75fe75c26dd8b6022e30a6b997008b97734c915856fd9e338bc24a9c2c010296`，与当时的最终工作树一致）。**评审后补（2026-09-26）**：按代码评审 🔵#2 把 `team_link_team_read` 的描述面同步出 tasks 块，该文件 sha256 随之变为 `7bf2b9c48f13b47ae46eea295d79502f4872f36916ef2b3d9361d954b847ec5c`（同批评审 🔵#1 的另一处为 `README.md` 架构图节点，不涉代码）。。

**红相 ①（新判据 ＋ 旧实现 `3eba6c1:lib/index.js`）**

方法：`git show HEAD:lib/index.js > lib/index.js`，并以 `git diff --quiet -- lib/index.js`（退出码 0）复核工作副本与该提交**逐字相同**；测试文件是本树（最终态）的那一份。

读数原文（捕获文件共 **285 行**，其**最后 11 行**逐字如下；其中那条长路径在原控制台里按宽度折过一次，此处并为一行。PowerShell 把 stderr 并进 stdout 时另有一层 `NativeCommandError` 包装，那是**壳的噪声、不是套件的读数**）：

```text
ToolArgsError: invalid arguments: "file" must be one of ["decisions","discipline"]
    at Object.execute (file:///<CHECKOUT>/profile/profiles/web/node_modules/.pnpm/@deepseek-ai+dsh-tools@0.1._307da6b6f1082125485177be0afab642/node_modules/@deepseek-ai/dsh-tools/lib/index.js:868:37)
    at file:///<CHECKOUT>/plugins/dsh-team-link/host-half.test.mjs:2145:36 {
  code: 'INVALID_ARGS',
  violations: [ '"file" must be one of ["decisions","discipline"]' ]
}

Node.js v24.14.1
```

`nodeExit=1`；**`assertion total` 一行都没打印** —— 整轮在 `host-half.test.mjs:2145`（本块第一行 `file: "tasks"` 调用）当场中止，红相**说不清自己的规模**。这与 §10.2.8.9 / §10.2.8.10 那一节记下的 **Y7 教训同形**：新判据打在旧实现上会**抛**，而不是返回 FAIL。客户端半边未跑（宿主半边已中止）。

**红相 ②（本批 62 条判据 ＋ 本轮修复前的 `lib/index.js`）**

方法：同一套还原纪律；「修复前」＝ 工作树版把本轮 **D1 / D5 / D8 / D9** 四处改动**逐字回退**（8 处字符串级回退，每个锚点缺席或非唯一即**中止不写盘** —— 避免写出「既不是这版也不是那版」的中间态）。

读数：`assertion total: 1057 (failed: 8)`（`nodeExit=1`），8 条逐条点名：

| 组 | 红 | 判据 |
| --- | --- | --- |
| **D9** | 1 | 「超出安全整数范围的任务号 ⇒ `kind=plan` 拒绝、点名该号、零写入、不静默钳制」 —— 旧实现写的是 `t-1e+22` |
| **U13 / D1** | 3 | t-2（`⚠` 那条）· t-4 · t-1 三条**全行比对** —— 旧实现渲染成 `） · ⚠ …` / `） · 存疑已由 #N 消解` |
| **D1/D8** | 1 | 读面尾巴的「单行上限」引导句列出**三件套**（`file=decisions` / `file=discipline` / `file=tasks`） |
| **D6** | 2 | ① 同任务同时有未消解与已消解存疑 ⇒ 印 `⚠`（if 分支优先）；② 多条存疑都已消解 ⇒ `#N` 取**最后一条被消解存疑的首个应答行** `#24`（不是它后面的 `#25`，也不是前一条存疑的 `#22`） |
| **D5** | 1 | 多条撤回 ⇒ `#N` 取**最后一条**（`#29`），且派生块里**不再出现**「此主张后共」/「条撤回行」 |

**如实标注的负相（不是「修复前必红」）**：U4 的 `=500 码点收` · U12 的 `block 可作最后主张` · U18 的另两组组合 —— 这 5 条在本轮修复前**本来就绿**，它们补的是**判据覆盖缺口**（旧实现没有这个 bug，只是没有这条锁），所以不进红相计数。这与本档既有记法（`★` 标负相）同源。

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1057 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

客户端半边本批**一字未改**（仍 269）。

### 边界证据（修复轮的逐条取值，全部走真工具）

| # | 取值 |
| --- | --- |
| **D1** | 两条尾巴紧跟 `）`：`- t-2 · 3 行 · 最后主张 claim（… · session-target）· ⚠ 未消解存疑 1 条` · `- t-1 · 5 行 · …（… · 已由 #5 撤回 · 撤回者 session-self）· 存疑已由 #5 消解`（两条**全行相等**，不是 `endsWith`） |
| **D5** | `- t-7 · 4 行 · 最后主张 claim（… · session-target · 已由 #29 撤回 · 撤回者 session-self）`（两条撤回行取**最后一条**；派生块里 `此主张后共` 零命中） |
| **D6①** | `- t-5 · 5 行 · 最后主张 done（… · session-target）· ⚠ 未消解存疑 1 条`，同一行**不含**「存疑已由」 |
| **D6②** | `- t-6 · 7 行 · 最后主张 done（… · session-target）· 存疑已由 #24 消解`（`#24` 是该存疑的**首个**应答行；`#22`／`#25` 都在场） |
| **D9** | 手写 22 位号 `t-12345678901234567890` ⇒ `写入失败：tasks.md 的 kind=plan 分配被拒绝——文件里已有超出安全整数范围的任务号 t-12345678901234567890（…）`，该次调用**文件逐字节不变**；删掉那一行后**同一次调用**成功分配 `t-3`（证明拒绝是被那行引起的，不是夹具坏了） |
| **U4** | `"码".repeat(500)` 被接受（成功体含 `本次 500 字符`）；`501` 仍拒 |
| **U18** | `{kind,task} × {decisions,discipline}` 四个组合全部被拒、两个文件**零写入** |

### 计数与同批同步

- `README.md`：tests 徽章 `1046 → 1057`、「当前读数」`1046 → 1057`、Agent Teams 对照表里的稳定性一格（附本批**实测红相**）；
- `CHANGELOG.md`：同一条目的「怎么验证」补齐 62 条断言的拆分、两套件实测读数与红相两次读数；
- `team-ledger-and-mode-design-2026-09-26.md`：§7 第 1 步与 §9 状态行附实测读数；§1 / §4 的 `conflicted` 口径改成与已实施一致的措辞；§9.3.4 rule 2 补两条子情形定义。**提交哈希 `12f0874`（2026-09-27 由父会话回填）**（本轮的 coder 不碰 git 历史）。

---

## 可观测批（A 批）：读窗扩展 · 团队状态卡 · 台账收件视图 ＋ 派生回执

> 设计（唯一事实源）：[observability-batch-design-2026-09-26.md](observability-batch-design-2026-09-26.md)（§4.1 读窗 / §4.2 状态卡 / §4.3 收件视图 / §4.4 派生回执 / §5 红线五条 / §6 判据 U1–U14 / §7 明确不做 / §8 假设 A1–A5）。变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的「可观测批（A 批）」。

### 本批做了什么（三件交付）

1. **读窗扩展**：`team_link_list_sessions` 新增**可选且互斥**的 `readIds`（点名读，去重后 ≤12，超出 / 未知 id 一律**拒绝且零读**，点名优先占额、其余按原顺序补足）与 `offset`（分页，整数、越界拒绝并给有效区间）；末尾追加「未读 Y 行 ＋ 怎么读」提示段（**默认调用也带**，本次唯一的格式新增）；
2. **`team_link_status`（新工具，`timeoutMs` 30000）**：六段只读状态卡 + 反面预警注记（判据写死：`N == 0 且 M > 0` 才打）；
3. **`team_link_team_read` 新块**：收件视图（按 `ref=t-<n>` 分组）+ 派生回执（三态 ✅ / ⚠ / 未读）。

**成本不变量按工具分账**：`list_sessions` 三条路径 ≤ 12 · `team_read` ≤ `min(12, 1+|readIds|)`（自读占 1 个额）· `status` ≤ 12。

### 红相（本批 60 条判据 ＋ **实施前**的 `lib/index.js`）

方法（安全还原纪律）：把工作树版 `lib/index.js` **读进内存** → 用 `git show HEAD:lib/index.js`（`89074fe`）覆写 → 跑 `node host-half.test.mjs` → **还原内存里的那份** → **sha256 逐字节复核**。**不留备份文件、不留探针**，工作树零残留。

- sha256（实施版）：`fde1b78573f88d392cdf3666c38bf1f70132439209666d590bfc46bf546ff7c1`，**还原后逐字节一致**（`MATCH`）；
- 读数：**`assertion total: 1117 (failed: 55)`**（`nodeExit=1`，`assertion total` 照常打印 —— Y7 纪律：新判据在旧实现上**报 FAIL 而不是把整轮打崩**，办法是三个 Y7-safe 调用器 `listCall` / `statusCall` / `readCall`，把「参数不存在 / 工具未注册」的抛错收成一段文本）；
- **本批新断言 60 条，其中 54 条在实施前实测红**；另 **6 条在两种实现上都通过**，逐条如实列出（它们是**刻意**的回归锁，或红相上 trivially 成立）：

| # | 在红相上也通过的 6 条 | 为什么 |
| --- | --- | --- |
| 1 | U1 默认调用：读窗就是前 12 行（surfaceReads 恰 12 个且逐个按序） | **回归锁**：默认路径不许变 |
| 2 | U1 默认调用：每行结构逐字保持（id — 代理状态 · 创建于 … （读数 …，>2min 作废）） | **回归锁**：既有行格式逐字不变 |
| 3 | U1 默认调用：窗口内 12 行给真实 verdict，窗口外 2 行标未读 | **回归锁**：既有未读口径不变 |
| 4 | U12 零回归：派生读数（最后主张 / 未消解存疑）与原始行窗口一字未动 | **回归锁**：既有四块不许动 |
| 5 | U3 边界：点名的 id 本就在默认窗内 → 只占一个额、不重复读 | 旧实现**忽略未知参数**（`defineTool` 容许未声明的额外参数），于是它读的仍是默认窗 —— 这条断言的正是「窗口内容不变」，故两版都绿 |
| 6 | U9 零写入：调用前后 settings 命名空间逐字节不变 | 红相上 trivially 成立（旧实现没有这个工具，自然不写设置）；绿相上它是真锁（另一半「磁盘 tasks.md 逐字节不变」在红相上**是红的**） |

- **另有 1 条既有断言在红相上变红**：`§11.9 文档面=实现面（工具计数同改锁）`——临时状态下 README 已写 10 个工具而旧实现只注册 9 个。**这正是这条锁该红的原因**（加工具而不同改文档即红），不是回归。

| 阶段 | 新断言 | 红相红 | 绿相绿 |
| --- | --- | --- | --- |
| 1 读窗（U1–U7 的 list 半边） | 23 | 19 | 23 |
| 2 状态卡（U8 / U9 / U13 / U7 的 status 半边） | 20 | 19 | 20 |
| 3 收件视图 ＋ 派生回执（U10 / U11 / U14 / U12 / U7 的 team_read 半边） | 17 | 16 | 17 |
| **合计** | **60** | **54** | **60** |

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1117 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

基线 `1057` / `269` ⇒ 新增 **60** 条宿主断言（`1117 = 1057 + 60`）；**浏览器半边本批一字未改**（仍 269 —— 设计 §7 ① 明确不做客户端面板渲染）。

### §8 假设 A1–A5 的实测结论（实施期验证，如实标注）

| # | 假设 | 实测结论 |
| --- | --- | --- |
| A1 | `ctx.sessionQuery.readSurface(selfId)` 对**调用方自己**可读 | **harness 内成立**：`team_read` 的自读走的正是列表工具一直在用的同一个 `readSurface` 调用面（无结构差异），U10/U14 的三态全部由它派生；**真机（DSH 进程内）未复验** —— 如实标注为「待宿主复验」，不当作已证 |
| A2 | 点名读 12 个仍在预算内（`list_sessions` 60s / `status` 30s） | **读数已锁死**：三工具的 surface 读数上限逐条断言（12 / 12 / 12，含 15 个点名时的 1+11=12）；**墙钟未实测**（需真机跑真实 26 会话工作区），`timeoutMs` 常量一字未动（60s / 30s / 30s） |
| A3 | 消息的 `ref` 在 surface 事件里可稳定抽取（banner 首行格式固定） | **成立**（对 §3.4 banner 形状的样本）：`ref=t-<n>` 从既有事件文本里稳定抽出并按任务号分组；`ref` 是别的值（如旧样式的 `slp-…`）**不归组、只计数**（已断言）—— 这是有意的归组面收窄 |
| A4 | 状态卡输出长度有界 | **成立**：六段 + 活性 12 行（超出如实标注）+ 台账尾 `tasksTail`（默认 5、上限 20，超出**拒绝**）+ 会话面 ≤ `LIST_LIMIT`(50)；**未做真机像素级「一屏」测量**（界是常量与拒绝路径，不是渲染尺寸） |
| A5 | 读窗内的 surface 事件带可用的时间戳 | **成立**：注记的锚 `T0` 取自真实事件的 `time`；三态（`N==0 且 M>0` 打 / 其余不打 / 无时间戳时**如实标「无法计算」**）都有断言 —— **订正**：第三态（无时间戳）的那条断言当时**并不存在**（套件里 grep `无法计算` = **0 命中**，本行原先的「都有断言」不实），已由 **2026-09-27 的分歧审计修复轮 D1** 补齐；逐条读数见本档「分歧审计修复轮（DIVERGENCE(12)）」一节 |

### 边界证据（逐条取值，全部走真工具）

| # | 实测原文 |
| --- | --- |
| **U4** | `列出会话失败：readIds 最多 12 个（去重后 13 个）——超出即拒绝，本次零读；请分两批点名，或用 offset 分页走完列表。`（该次 surface 读数 **0**） |
| **U5** | `列出会话失败：readIds 里的 session-not-in-this-list 不属于本次列表（本工作区的会话列表里没有它）——先用 team_link_list_sessions 复制正确的 id。`（读数 **0**） |
| **U6** | `readIds（点名读）与 offset（分页）互斥…` / `offset 必须是整数（收到 1.5）。` / `offset 越界：本次列表共 14 行，有效区间 0..13（offset=k 表示从第 k+1 行起读 12 行）。`（三类拒绝**读数全为 0**） |
| **U1 尾巴** | `读窗：默认前 12 行` ＋ `未读 2 行（读窗 12/共 14 行）：读第 13–24 行 → offset=12；或点名 → readIds=["session-rw-12", "session-rw-13"]`（提示段在**最后一行之后**） |
| **U3** | `读窗：点名读 1 个（session-rw-13）+ 默认窗补足`；读数 = 被点名的那个 ＋ 前 11 行，不重复读 |
| **U13** | 触发：`⚠ 窗口内 0 条消息 / 台账同期新增 7 行 —— 会话可能已停止说话只写行（读数，不是裁决）。`；`N>0` 与 `M==0` 两种情形**连那一段标题都不出现**；无时间戳时 `（反面预警注记无法计算：本读窗内没有带时间戳的 surface 消息——不猜。）` |
| **U14** | `- t-7 → session-worker-b（MM-DD HH:mm）：✅ 有反应（MM-DD HH:mm 起有 assistant 事件）` · `：⚠ 无后续反应（该时刻之后无 assistant 事件）` · `：未读（未点名读该会话；要读 → readIds=["session-worker-d"]）` · `：未读（点名的会话面读取失败——不用空数据算读数）` · 非 delivered 的那笔如实写 `：未投递（outcome=refused）` |
| **U8 状态卡** | 六段标题逐字在场；`token tok-1a2b…7890（掩码…）` 且**完整令牌零命中**；`session-st-12：未读（本卡只读了前 12 行）…`；`tasksTail 越界（收到 21）：有效区间 1..20，默认 5。` |
| **U9** | 调用前后 `JSON.stringify(env.ns.data)` 与 `tasks.md` 的 sha256 **都不变**（连换届过期清扫都不跑） |
| **U11** | 未点名时 `query.surfaceReads` 恰 `["session-self"]`（**目标面零读**）；点名 3 个 ⇒ 恰 4 次（`min(12, 1+3)`）；点名 15 个 ⇒ 恰 12 次，超额的 4 个逐个标「本次未读」 |

### 计数与同批同步

- `README.md`：§二 新增「读窗参数 ＋ 成本不变量」表 · 新增「团队状态卡（只读）」一段（含目录条目）· §四 新增「收件视图与派生回执」小节 · 工具一览表三行（list / team_read / **新工具 status**）· 设计文档索引新增本档一行 · **三处读数**（tests 徽章 · Agent Teams 对照表稳定性格 · §十「当前读数」）`1057 → 1117`；
- `CHANGELOG.md`：新条目（修了什么 → 为什么 → 怎么验证 → 同批同步的面），含 60 条断言的拆分、两套件实测读数与红相 55 条的逐条交代；
- `host-half.test.mjs`：A 批 60 条断言 ＋ 三个 Y7-safe 调用器 ＋ `mkdir` 进导入 ＋ 既有的「工具计数同改锁」`9 → 10`；
- `docs/observability-batch-design-2026-09-26.md`：状态行与 §8 假设表回填实测结论；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：§7 的**步 2 / 步 4 标 ✅ 已实施**、**步 6 标「收件视图 ＋ 派生回执 均 ✅」**，三条各加指向本批设计档的链接。**提交哈希 `12f0874`（2026-09-27 由父会话回填）**（本轮 coder 不碰 git 历史）。

## 分歧审计修复轮 `DIVERGENCE(12)`（2026-09-27；当次实测 `1127 (failed: 0)` / `269 (failed: 0)`，基线 `1117 (failed: 0)` / `269 (failed: 0)`）

> 变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的同名条目。**本轮是修复轮**：只闭环只读分歧审计的 12 条结论（D1–D12），**不夹带新功能、不扩范围**；A 批设计 §7「明确不做」继续有效，B 档（`docs/team-mode-batch-design-2026-09-26.md`）**一字未动**。

### 12 条分歧的处置（逐条）

| # | 级别 | 分歧 | 处置 | 落点 |
| --- | --- | --- | --- | --- |
| **D1** | 🔴 | 设计 §8.1 A5 与账本都说「三态（触发 / 不触发 / 无时间戳「无法计算」）**都有断言**」，实际 `grep 无法计算 host-half.test.mjs` = **0 命中**（实现侧有那句话，判据没有） | **补那条断言**（无时间戳 ⇒ 输出「无法计算」且**不打**计数注记），并把两处声明订正为「第三态由本轮 D1 补齐」 | `host-half.test.mjs`（新断言）· 设计 §8.1 A5 · 本档 A 批一节的 A5 行 |
| **D2** | 🟡 | 无锚时的口径未进设计（`computed:false` 的「无法计算」句在「读窗非空但无带时间戳消息」时会照打），聚合态 `M` 未定义 | **保留实现行为、把口径写进设计 §4.2**（三态逐条 + ⑤ 聚合态 `M` = 所示各团队之和）；**补两条断言**覆盖 ①（读窗为空 ⇒ 整段不打印）②（无时间戳 ⇒ 打「无法计算」句） | 设计 §4.2 · `host-half.test.mjs`（2 条断言） |
| **D3** | 🟡 | `team_read` 的 `readIds` 边界（去重后 ≤11；超出**截断并标注未读**而非拒绝）没进设计的边界表 | **实现不动**；设计 §4.1 补「点名读上限与超限行为」表（两个工具两种形态同一条不变量），§4.3 指明该行为 | 设计 §4.1 / §4.3 |
| **D4** | 🟡 | 派生回执的投递事实来源与窗口未进设计（`tool/call` + `tool/ptc-dispatch`、`callId` 配对、窗口单位是「最近 20 次 send」） | 写进设计 §4.4；**补四条断言**（ptc-dispatch 载体 / 实参兜底解析 `team:<name>/<role>` / 回执截断行 / 行上限） | 设计 §4.4 · `host-half.test.mjs`（4 条断言） |
| **D5** | 🟡 | `team_read` 的 `readIds` 非数组拒绝、以及 D4 列的四个分支**全无断言** | **补断言**（逐分支一条；非数组 ⇒ 拒绝且**零读**） | `host-half.test.mjs`（含在 D4 的 4 条内 + 非数组 1 条） |
| **D6** | 🟡 | README 设计文档索引仍写「形态开关等第 2–5 步待实施」，父档 §7 已把步 2 / 4 / 6 标 ✅ | 改 README 那行为「第 2 / 4 / 6 步已随 A 批实施；第 3 步（形态开关）与第 5 步（teammate 交卷提示）待实施」 | `README.md` 设计文档索引 |
| **D7** | 🟡 | 注释承诺行上会标注「按当前名册解析」，`renderReceiptRow` 却只特判 `回执截断` ⇒ 换届后可能把 ✅/⚠ 判给当时并非收件人的会话且**不告知** | **实现那个标记**（按当前名册解析出来的行如实标注），并补一条断言 | `lib/index.js`（新常量 `ROSTER_RESOLVED_NOTE` + `receiptRowsOf` / `renderReceiptRow` + 工具描述）· `host-half.test.mjs` |
| **D8** | 🟡 | 第 4 态「：未投递（outcome=…）」实现里有、账本里有实测原文，设计 §4.4 与 README 都只写三态 | 设计 §4.4（判据 + 示例 + U14 行）与 README 的四态表各补第 4 态（措辞只陈述 `outcome`，不下结论） | 设计 §4.4 · `README.md` |
| **D9** | 🟡 | 断言半边**恒真**（`surfaceReads.slice(length).length === 0`），U13 的「注记零额外读」那半边是空的 | 换成**真实计数**：打注记那一次与不打注记那一次，各自的 surface 读数逐次相等（各恰 12 = 同一个有界读窗） | `host-half.test.mjs` |
| **D10** | 🟡 | 聚合态台账尾实为**每团队一次文件读**，设计 §4.2 成本列写「一次文件读」（README 本来就对）；聚合 M 与聚合上限无断言 | 设计 §4.2 成本列回填为「单团队 1 次 / 聚合 N 次（N = 所示团队数）」；**补一条聚合上限断言**（`M` = 3 + 2 = 5 之和，两个团队的台账尾都在卡上） | 设计 §4.2 · `host-half.test.mjs`（1 条断言） |
| **D11** | 🔵 | 设计 §4.2 写「`ctx.agents` + `ctx.sessions.list` 快照」，模块级 `inject` 里没有 `sessions` | 改设计那一行为 `ctx.sessionQuery.listSessions`（**与 `list_sessions` 同源同序**）+ `ctx.agents.get(id)` | 设计 §4.2 |
| **D12** | 🔵 | 归组面宽于假设 A3：`ref=(t-\d+)` 对**整段文本** exec（不要求 banner、不排除本会话自己），未进设计 | 写进设计 §4.3；**补一条断言**（**非 banner** 文本也归组，且发送方回落标「（本会话）」） | 设计 §4.3 · `host-half.test.mjs`（1 条断言） |

### 本轮新增 10 条断言与红相

- **命令**：`node host-half.test.mjs && node client-half.test.mjs`（本仓纪律：不用 `node --test`，沙箱下 `spawn EPERM`）；
- **绿相（工作树，实跑两行原文）**：

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1127 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

  基线 `1117` / `269` ⇒ **新增 10 条宿主断言**（`1127 = 1117 + 10`）；**浏览器半边本轮一字未改**（仍 `269`）。
- **红相 A（「本轮修复前」的实现 = 工作树，但 D7 那个标记还没落码）**：`assertion total: 1127 (failed: 1)` —— 唯一的一条红是 **D7**（`FAIL  D7 读数不失准: …按当前名册解析…`），其余 9 条**在两种实现上都绿**（见下「负相如实标注」）；
- **红相 B（A 批实施前的 `89074fe`）**：`assertion total: 1127 (failed: 65)` = A 批的 **55** 条（54 新 ＋ 1 既有工具计数锁，与本档「可观测批（A 批）」一节逐条相符）＋ **本轮 10 条全红**（旧实现里既没有 `team_link_status`，`team_read` 也没有 `readIds` 参数）；
- **红相 B 的安全方法（与 A 批同一纪律）**：把工作树版 `lib/index.js` **读进内存** → 用 `git show HEAD:lib/index.js` 覆写 → 跑 `node host-half.test.mjs` → **还原内存里的那份** → **sha256 逐字节复核**（`restoreMatch: true`；本轮工作树版 sha256 `d6ae2f78c1d6c13db8fb2d8ad0cc56cfd623702f7a675675d69c074211b9ab1a`）。**不留备份文件、不留探针**，工作树零残留。

| # | 新断言 | 本轮修复前（工作树） | `89074fe`（A 批实施前） |
| --- | --- | --- | --- |
| 1 | D1/A5 注记第三态：无时间戳 ⇒ 打「无法计算」句、**不打**计数注记 | 绿（**负相**） | 红 |
| 2 | D2① 读窗为空 ⇒ 注记**整段不打印**（连标题都不出现） | 绿（**负相**） | 红 |
| 3 | D10 聚合口径：`M` = 所示各团队之和（3 + 2 = 5） | 绿（**负相**） | 红 |
| 4 | D12 归组面：非 banner 文本同样归组 + 发送方回落「（本会话）」 | 绿（**负相**） | 红 |
| 5 | D4 载体：`tool/ptc-dispatch` 那一类投递照样成行 | 绿（**负相**） | 红 |
| 6 | D4 实参兜底：按实参解析 `team:<name>/<role>`，表达式与现任一并显示 | 绿（**负相**） | 红 |
| 7 | D4 回执截断行：只报告回执自己报的总数，不编目标身份 | 绿（**负相**） | 红 |
| 8 | D4 行上限：恰 20 行 + 一行「本次还有 N 行未显示」（N = 真实差额） | 绿（**负相**） | 红 |
| 9 | D5 `readIds` 非数组 ⇒ 拒绝且**零读** | 绿（**负相**） | 红 |
| 10 | **D7** 按当前名册解析出来的行如实标注（字面 id 的行不带） | **红**（`failed: 1`） | 红 |

**负相如实标注（不冒充「修复前必红」）**：上面 9 条在「本轮修复前」**本来就绿** —— 它们补的是**判据覆盖缺口**（旧实现没有这个 bug，只是没有这条锁），D1 那条尤其是本轮审计的**原点**（账本原先把该文案当实测原文贴出，而套件里零命中）。这与本档既有记法（`★` 标负相）同源；本轮**唯一的真红相**是 D7。

### D1–D12 逐条「怎么验证它没了」

| # | 一行验证 |
| --- | --- |
| D1 | `grep -c 无法计算 host-half.test.mjs`：修复前 **0**、现在 **1**；该断言在 `89074fe` 上红、在工作树上绿 —— 两处声明（设计 §8.1 A5 ＋ 本档 A 批 A5 行）均已订正为「第三态由本轮补齐」 |
| D2 | 三态两条断言（`读窗为空 ⇒ 整段不打印` / `无时间戳 ⇒ 打「无法计算」句`）＋ 聚合口径一条（下 D10）在 1127 全绿里；设计 §4.2 与 README 的同段文字与之一一对应 |
| D3 | 状态卡/列表/team_read 的全部成本断言仍绿（`U7` ×3、`U11`、`U14` 超额标注）；设计 §4.1 的新表两个工具两种形态的读数与 `lib/index.js:639-641`（拒绝）与 `:1890`/`:2866`（截断标注）逐条对得上 |
| D4 | 四条断言全绿；`grep ptc-dispatch host-half.test.mjs` 从 **0** 命中 → 夹具里出现（此前只在实现与 README 里） |
| D5 | `readCall({team, readIds: "session-worker-b"})` ⇒ `【调用失败：…"readIds" must be an array】` 且该次 `surfaceReads` 计数**不变**（= 0 增量） |
| D6 | README 设计文档索引那行与父档 §7 第 161 行的状态措辞一致（步 2 / 4 / 6 已实施；步 3 / 5 未开工）——两处 grep 比对 |
| D7 | 修复前 `1127 (failed: 1)`（唯一红就是它）→ 落码后 `1127 (failed: 0)`；断言的另一半反向钉住「字面 id 的行**不**带该标注」 |
| D8 | 设计 §4.4（判据 ＋ 示例行 ＋ U14 行）与 README 四态表各出现第 4 态，且措辞只陈述 `outcome`；`U14 非 delivered…` 既有断言仍绿 |
| D9 | 该断言的恒真半边已换成真读数（两次调用各恰 12）；换真读数后仍绿 ⇒ 注记确实零额外读 |
| D10 | 聚合上限断言在 1127 全绿里（`M` = 5 且两个团队台账尾都在卡上）；设计 §4.2 成本列已回填为「单团队 1 次 / 聚合 N 次」 |
| D11 | 设计 §4.2 那一行已改为 `ctx.sessionQuery.listSessions`；模块级 `inject` 恒 4 项（既有断言）且其中**没有** `sessions` —— 与实现同源 |
| D12 | 非 banner 的本会话消息归到 `t-7` 且标「（本会话）」的断言全绿；设计 §4.3 写死了同一个归组面 |

### 计数与同批同步

- `README.md`：tests 徽章 `1117 → 1127`、「当前读数」`1117 → 1127`、Agent Teams 对照表的稳定性格 `1117 → 1127`；状态卡段补 D2 的三态与聚合口径；收件视图/派生回执段补 D12 归组面、D4 的两类载体 ＋ `callId` 配对 ＋ 窗口单位、D7 的「按当前名册解析」标注；回执表补 D8 的第 4 态；设计文档索引那行的状态与父档对齐（D6）；
- `CHANGELOG.md`：新增「分歧审计修复轮 DIVERGENCE(12)」条目（修了什么 → 为什么 → 怎么验证 → 同批同步的面），含本轮 10 条断言的逐条红相/负相交代；
- `host-half.test.mjs`：新增 10 条断言 ＋ 4 条夹具事件（非 banner 消息、`tool/ptc-dispatch`、回执截断、18 目标的一次投递）＋ 3 个新夹具（无时间戳 / 读窗为空 / 两团队聚合）＋ `trTruncatedResult` 助手；`U13 零额外读` 那条改成真计数（D9）；
- `lib/index.js`：`ROSTER_RESOLVED_NOTE` 常量 ＋ `receiptRowsOf` / `renderReceiptRow` 的按当前名册解析标注 ＋ `team_link_team_read` 描述面同步；**其余一字未动**；
- `docs/observability-batch-design-2026-09-26.md`：§4.1 / §4.2 / §4.3 / §4.4 的口径回填 ＋ §8.1 A5 行订正 ＋ 状态行加「后续回填」一句；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：**一字未动**（本轮无该档范围的改动）；B 档 `docs/team-mode-batch-design-2026-09-26.md` 同样一字未动。

---

## 形态批（B 批）：团队形态 · `set-mode` · 读面形态段 · teammate 交卷提示（2026-09-27；当次实测 `1168 (failed: 0)` / `269 (failed: 0)`，基线 `1127 (failed: 0)` / `269 (failed: 0)`）

> 设计（唯一事实源）：[team-mode-batch-design-2026-09-26.md](team-mode-batch-design-2026-09-26.md)（§4.1 形态字段 / §4.2 `set-mode` / §4.3 读面形态段 / §4.4 交卷提示 / §5 红线六条 / §6 判据 U1–U14 ＋ U11b / §7 明确不做 / §8 假设 A1–A4）。变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的「形态批（B 批）」。

### 本批做了什么（四件交付）

1. **形态字段**（只落在 settings）：`mode`（闭集 `sessions` / `agent-team`，默认 `sessions`）＋ `leadSessionId`（Lead **指针**）；`normalizeTeams` 读到闭集外的 `mode` ⇒ 落默认档**并留痕**（读面点名原值 / 闭集 / 「原值未被改写」）；
2. **`team_link_roster action=set-mode`（第五个封闭动词）**：宿主探测（只对「切到 agent-team」这一向）＋ **双重门**（writer gate 原样 ＋ 人类确认框；无服务 / 超时 / 取消 ⇒ fail-closed 零写入）＋ Lead 校验（形状 ＋ 在场）与默认 ＋ `decisions.md` **恰好一行**形态史 ＋ **幂等**（同档同 Lead ⇒「已是该档」，不弹框、零写入）＋ 写时复检（TOCTOU）；
3. **读面形态段**（`roster get` 与状态卡 ⑦ 段同一渲染器）：形态 ＋ Lead ＋ 成员名册**投影**（读时现算、一行不落 settings；两种来源文案写死）＋ **完整能力矩阵**（逐行照抄父档 §2.3）＋ 结论 ＋ **形态诊断行**（只提示、绝不自动切）；
4. **teammate 交卷提示**（提示式、不阻断）：切换确认框正文列出「不会迁移的三件事」＋ 当前 teammate（可读则列 / 不可读如实说）＋「请确认它们的结论已落到黑板或文件」。

**红线（设计 §5，六条）**：只读宿主 · 不悄悄降级（写路径刺眼报错 / 读路径如实降级，两条路不混用）· 信任不迁移（一行不写）· 双重门 fail-closed · 指针不拷贝 · 切档永远由人触发。

### 新增 41 条宿主断言：分阶段红相（测试先行，逐阶段实跑）

方法：**先写断言、后写实现**，每一阶段都在该阶段实现**之前**跑一次套件并记下读数 —— 这比事后换实现更强：整轮跑到底、只有新断言红（Y7 纪律的两处调用器 `rosterCall` / `statusCall` 把「参数不存在 / 工具未注册」的抛错收成文本，不会把 `assertion total` 打崩）。

| 阶段 | 本阶段新断言 | 阶段红相读数 | 备注 |
| --- | --- | --- | --- |
| 1 形态字段 ＋ `normalizeTeams` 降级 ＋ `roster get` 形态段（U1 / U11） | 10 | `1137 (failed: 9)` | 1 条**负相**（见下） |
| 2 `set-mode` 第五动词（U2–U7 / U10 / U11b） | 20 | `1157 (failed: 19)` | 1 条**负相** |
| 3 状态卡 ⑦ 段 ＋ 诊断行 ＋ 交卷提示 ＋ 零回归（U8 / U9 / U12 / U13 / U14） | 11 | `1168 (failed: 2)` | 其中 3 条已被阶段 2 的实现满足、6 条**负相** |
| **合计** | **41** | 见下「红相 B」 | |

### 红相 B（本批 41 条判据 ＋ **实施前**的 `lib/index.js`）

方法（安全还原纪律）：把工作树版 `lib/index.js` **读进内存** → 用 `git show HEAD:lib/index.js` 覆写 → 跑 `node host-half.test.mjs` → **还原内存里的那一份** → **sha256 逐字节复核**。换进去的那一份**用 git 自己的量具对过**：覆写后 `git hash-object lib/index.js` == `git rev-parse HEAD:lib/index.js`（`swapBlobMatch=True`）——「实施前」不是自述，是 blob 相等。**不留备份文件、不留探针**，工作树零残留。

- 读数：**`assertion total: 1168 (failed: 34)`** = **33 条 B 判据红** ＋ **1 条既有锁红**；
- 工作树版 sha256：`4110893DC5F07C56909EE194B1E6BF0F20F5C674B8233007065CAE81A378FA3B`，**还原后逐字节一致**（`restoreMatch: true`）；
- **那 1 条既有锁红是该红**：`U10: the tool surface has no coordinator parameter`（roster 参数键集锁）—— 临时状态下测试文件已按设计要求期望 `mode`/`leadSessionId`，而旧实现没有这两个参数。**这正是这条锁该红的理由**（加参数而不同改锁即红），与 A 批的「工具计数同改锁」同源，**不是回归**；
- **本批新增 41 条，其中 33 条在实施前实测红**；另 **8 条在两种实现上都通过**，逐条如实列出（负相 —— 它们补的是**判据覆盖缺口**，不冒充「实施前必红」）：

| # | 在红相 B 上也通过的 8 条 | 为什么 |
| --- | --- | --- |
| 1 | B/U11 零回归锁：读面既有内容一字未少（注册表头行 / 角色现任行 / 详情块 / 黑板根 / 读数戳） | **回归锁**：本批只**追加**形态段 |
| 2 | B/U10 信任不动：切档前后 pairs / trustedSenders / rememberTargets 逐字节不变 | 旧实现里那次调用根本不发生 ⇒ 红相上 trivially 成立；绿相上它是真锁（红线 3） |
| 3 | B/U9 只读宿主（拒绝路径）：被 writer gate 拒绝的那次零写调用、零投影读 | 旧实现同样不碰宿主 ⇒ trivially 成立；绿相上钉住「门在探测与弹框之前就拦下」 |
| 4 | B/U13 状态卡只读：调用前后 settings 逐字节不变、形态未被自动改写、宿主零写调用 | 旧实现没有形态段却也不写 ⇒ trivially 成立 |
| 5 | B/U14 诊断行（不出现）：列表里有别的会话 ⇒ 一行都不打 | 旧实现没有诊断行 ⇒ trivially 成立；绿相上它是**反向锁**（有会话时不许打） |
| 6 | B/U14 只提示、绝不自动切：出诊断行的那两次读零写入（settings 不变 / 形态未改 / decisions 零新增） | 同上 |
| 7 | B/U12 零回归（既有四动词）：`upsert-team` / `set-role` / `retire` 的语义与文案一字未改 | **回归锁**：本批不动这四个动词 |
| 8 | B/U12 零回归（rotate / recover）：两个工具的动词闭集与三道门函数一字未动 | **回归锁**：本批只读它们、不碰它们 |

- **负相如实标注（不冒充「实施前必红」）**：上表 8 条在实施前**本来就绿**（旧实现没有这个 bug，只是没有这条锁）。这与本档既有记法（`★` 标负相）同源。
- **红相 B 里多出来的 3 条**（相对阶段 3 的红读数）：`B/U8 不悄悄降级`、`B/U9 只读宿主（成功路径）`、`B/U12 只动两个键` —— 它们是阶段 3 写的断言，但**由阶段 2 的实现满足**，所以在本阶段的红读数是绿的、在实施前的实现上是红的。

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1168 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

基线 `1127` / `269` ⇒ **新增 41 条宿主断言**（`1168 = 1127 + 41`）；**浏览器半边本批一字未改**（仍 `269` —— 设计 §7 明确不做客户端面板）。**唯一改动的既有断言**是 roster 参数键集锁（必须与参数面同改，本仓「改一处即两处」的既有规矩）。

### §8 假设 A1–A4 的实测结论（实施期验证，如实标注）

| # | 假设 | 实测结论 |
| --- | --- | --- |
| A1 | 宿主 `agentTeams` 服务可 `ctx.get` 到且读面形状可知 —— **2026-09-27 已核**（`DIVERGENCE(8)` D1 实证更正：本节原先记的「本部署仍读不到它」**把真机读反了**） | **① 读面形状已核实**（直读宿主包）：宿主 `TeamService extends Service` → `super(ctx, 'agentTeams')`（`…/dsh-experimental-agent-team/lib/types/index.js:28,46`），读面 = `tryMembership(agent)` / `listMembers(agent)` —— **以活动代理本人为凭据**，没有「按 id 读某一队」的公开面。**② 本部署已装载该组合包 ⇒ 服务已挂载**：活动 profile 是 **desktop**（`DSH_PROFILE=desktop`，`<DSH_HOME>\profiles\desktop`），其 `dsh.profile.bundles` **含** `@deepseek-ai/dsh-experimental-agent-team-profile`（写入 12:30 早于宿主启动 17:16），四个包也在 `desktop-runtime.json` 的 `sharedPackages` 里；**决定性证据**：本会话日志的系统提示词同时含该工具包的 POLICY 常量与**只由它注册**的 `spawn_teammate` 工具声明，而该工具包 `inject = ["agents","agentTeams","tools","systemPrompt"]` ⇒ `agentTeams` 服务已在运行实例中挂载。⇒ 探针 `available:true`、**U11b 那一支在本部署不会触发、US1 可达**。③ 原证据 `profile/profiles/web/...` 是**便携残留**，不是本部署。**读面仍按分支文案**（服务在场而调用方不是成员 ⇒ 中性首行 + 原因行），**写路径的拒绝分支仍由替身夹具断言**（真机不触发 ≠ 不需要） |
| A2 | `userQuestions.ask` 在 `set-mode` 场景可用（既有三处调用形一致） | **成立**：确认框走与既有三处同一个调用形（`questions[].options` + `agent` + `signal`，计时器 ＋ `AbortController` 复用 `ROTATION_CONFIRM_TIMEOUT_MS`）；四条路径各有断言：答「切换」⇒ 落笔 / 答「取消」⇒ 零写入 / 3 分钟超时 ⇒ 零写入 / 无确认服务 ⇒ fail-closed 零写入 |
| A3 | `normalizeTeams` 的降级留痕方式与既有范式一致 | **成立，但确如设计所料需补一处留痕通道**：`normalizeTeams` 是**纯函数**（导出给测试、被 `normalizePolicy` 每次读取调用），拿不到 `ctx` 也就打不出日志 ⇒ 留痕落在**读面**上，由一张**进程内**表（`TEAM_MODE_DEGRADATIONS`，每次归一化重建）承载 —— 与看门狗去抖同一条纪律（进程内、不持久化），**零新持久状态** |
| A4 | 当前会话 id 可从调用方上下文取（用于默认 Lead） | **成立**：`agentSessionId(exec)`（`exec.agent.id`）就是默认 Lead 的来源，断言覆盖「落笔的 Lead == 调用方会话 id」。**已知未断言的一条分支**（如实记）：`writer=any` 且执行上下文**没有会话身份**时，省略 `leadSessionId` 会走「请显式给 leadSessionId」的拒绝；该分支有实现、暂无断言（writer=coordinator 时空缺 / 无身份那两条已由既有门断言覆盖） |

### 边界证据（逐条取值）

| # | 实测原文（由断言钉住「出现在工具输出里」；字符串常量取自 `lib/index.js`） |
| --- | --- |
| **U1** | `- legacy-team：形态=sessions`（老 settings 行，读前读后 settings 逐字节不变、两个新键**没被写进盘**）；`- bad-mode-team：形态=sessions · 形态降级留痕：settings 里的原值「agentTeam」不在闭集内（闭集 sessions / agent-team）⇒ 已按默认档 sessions 读出（原值未被改写，请由用户在设置 UI 修正）。` |
| **U2** | 落笔：`已切换形态：团队 sm-team —— sessions → agent-team（Lead=session-self）（自 …）。`；形态史恰一行：`1 | 2026-…Z | session-self | 形态 → agent-team（Lead=session-self）`；确认框正文含`省略 leadSessionId ⇒ 默认取本次调用会话自己` |
| **U3 / U4** | `切换未执行（目标档 agent-team）：确认服务（userQuestions）不可用——切档必须有人在对话框里点一下；无确认即不执行（fail-closed，§4.2）。` / `确认框选了「取消」。` / `确认框 3 分钟内未获应答（超时；无人在场）。` ＋ `本次零写入：settings 与 decisions.md 逐字节未动，团队 … 的形态仍为 sessions。` |
| **U5** | 沿用既有门文案：`写操作被拒绝：团队 sm-team 的 policy.writer=coordinator，只有现任协调者会话 session-self 可写（当前调用会话 session-target）。` |
| **U6** | `已是该档：团队 … 的形态已经是 agent-team（Lead=…）—— 本次**不弹确认框、零写入**（连 decisions.md 都不追加：形态史记的是「切换」，不是「重复声明」）。` |
| **U7** | `切换失败：mode 必须在闭集内（sessions / agent-team）—— 当前是「agentTeam»；…` · `leadSessionId 是**显式空串**…` · `leadSessionId 形状非法（「-bad id!」）…` · `leadSessionId session-typo-1 在本次会话列表快照里找不到（本次列表共 … 个会话）—— 多半是 id 转录错位…` · `leadSessionId 只对 agent-team 档生效…` |
| **U11b / U8** | `切换被拒绝：本宿主现在到不了 agent-team 档 —— 宿主没有提供 agentTeams 服务（本次运行的 profile 没有装载 Agent Teams 组合包 @deepseek-ai/dsh-experimental-agent-team-profile）。` ＋ `怎么开：先看你**当前活动的 profile** 的 dsh.profile.bundles 里有没有…`（`DIVERGENCE(8)` D1：通用表述，不再断言「本部署没装载」）＋ `兜底路（永远可用）：形态就落在 settings 的 team-link.teams[].mode / leadSessionId 两个键上…` ＋ `本次**零写入**…连确认框都没弹`；切**回** sessions ⇒ `已切换形态：团队 … —— agent-team → sessions`（不探测宿主）。**注意：本部署已装载该组合包（A1）⇒ 真机不会走到这一支**，本条由替身夹具（`agentTeams: null`）断言 |
| **U11** | 名册可读：`来源：宿主 agentTeams 投影（本部署可读）` ＋ `- lead（Lead，running）`；不可读**按分支取首行**（`DIVERGENCE(8)` D2）：服务缺席 ⇒ `成员名册不可读（本部署未提供该投影）—— 仍可读 Lead 与形态`，其余四条（缺方法 / 无会话身份 / 调用方非成员 / 读取抛错）⇒ 中性首行 `成员名册不可读 —— 仍可读 Lead 与形态（哪一条读不到，见下一行的原因）`；两种情形都在下一行给`（不可读原因：…）`；矩阵区**逐行锁八行原文**（4 个 `❌` ＋ 3 个 `⚠️` ＋ 1 件与形态无关，含第 7 行的已核口径） |
| **U13** | 状态卡新增段标题：`--- 形态（⑦；本段由 B 批 §4.3 追加：形态 + Lead + 成员名册投影 + 能力矩阵 + 诊断行）---`（A 批六段一字未少，调用前后 settings 逐字节不变） |
| **U14** | `⚠ 多会话通道看起来不可用（列表里没有其他会话）—— 你可以让协调者切到 agent-team 档（team_link_roster action=set-mode）（只提示：本插件绝不自动切档，切档永远由人在确认框里点一下）。`；有别的会话时**一行都不打** |

### 计数与同批同步

- `lib/index.js`：形态常量与渲染（能力矩阵一行一源）· `TeamConfig` 两字段 · `normalizeTeams` 降级留痕 · `probeAgentTeams` / `readLeadSessionId` / `askModeDialog` / `teamModeSectionLines` / `modeCapabilityLines` / `sessionIdSnapshot` / `otherReachableSessions` · `set-mode` 分支 · `roster get` 与 `team_link_status` 的形态段 · 两个工具描述面；
- `host-half.test.mjs`：41 条断言 ＋ 宿主 `agentTeams` 替身（只给两个读方法，写方法调用即抛错并记账）＋ `rosterCall` 的 Y7-safe 调用器 ＋ 参数键集锁同改；
- `README.md`：tests 徽章 / 稳定性格 / §十「当前读数」**三处读数** `1127 → 1168`；roster 动词表补 `set-mode`、工具一览两行（roster / status）；**新增「团队形态（多会话档 ↔ agent-team 档）」一节**（两档白话 ＋ 三句要紧的话 ＋ 能力矩阵 ＋ 怎么切怎么看 ＋ 红线）；状态卡表补 ⑦ 行；设置键表与两处 yaml 样例补两个字段；设计文档索引加本档一行 ＋ 修正 A 批那行的「六段」表述；
- `CHANGELOG.md`：新增「形态批（B 批）」条目（修了什么 → 为什么 → 明确不做 → 怎么验证 → 同批同步的面）；
- `docs/team-mode-batch-design-2026-09-26.md`：状态行改「✅ 已实施」＋ 实测读数；§8 假设 A1–A4 回填实测结论；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：§7 步 3 / 5 标 ✅ 已实施 ＋ 指向本档的链接；状态行同步。**提交哈希 `12f0874`（2026-09-27 由父会话回填）**（本轮 coder 不碰 git 历史）；
- `docs/observability-batch-design-2026-09-26.md`：§7 第 6 条改标「状态卡形态段由 B 批实施」。

---

## 分歧审计修复轮 `DIVERGENCE(8)`（2026-09-27；当次实测 `1184 (failed: 0)` / `269 (failed: 0)`，基线 `1168 (failed: 0)` / `269 (failed: 0)`）

> 来源：只读分歧审计的 **8 条**结论（D1–D8）逐条闭环。**不夹带新功能、不扩范围**：A 批 §7 与 B 档 §7「明确不做」继续有效；`docs/observability-batch-design-2026-09-26.md` **本轮一字未动**。变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的「分歧审计修复轮 `DIVERGENCE(8)`」条目；设计口径落在 B 档 [team-mode-batch-design-2026-09-26.md](team-mode-batch-design-2026-09-26.md)（§3 未复核面行 · §4.2 幂等 · §4.3(3) 首行按分支 · §6 U6 / U11 / U11b · §8 A1 · §8.1 A1）与父档 [team-ledger-and-mode-design-2026-09-26.md](team-ledger-and-mode-design-2026-09-26.md)（§2.3 第 7 行 · §7 步 3 · §8 已核那条）。
> **上一节（形态批 B 批）的读数是那一批「当次实测」的历史读数**（`1168`）；本节是本轮修复后的当前读数（`1184`），两节不冲突：B 批自身的红相/绿相不变，本轮只在其上**补 16 条断言 ＋ 改写 3 条**。

### 本批做了什么（八条，逐条对审计结论）

| # | 审计结论 | 本轮处置 |
| --- | --- | --- |
| D1 🔴 | 文档把真机读反了（断言「本部署未装载组合包 ⇒ 切档被拒」，被实证推翻） | `lib/index.js` 的 `AGENT_TEAMS_HOWTO` 改**通用表述**（按**当前活动 profile** 的 `dsh.profile.bundles` 自查；已经在 ⇒ 拦住本次切换的是别的原因）＋ 拒绝文案补一行 `MODE_SETTINGS_FALLBACK`（设置 UI 永远是超级写者）；B 档 §3 / §8.1 A1、父档 §8 已核那条、本档 A1 与 U11b / U11 证据行、README 与 CHANGELOG 一律同改**实测事实**（desktop profile · `dsh.profile.bundles` 含该包 · 工具包 `inject` 含 `agentTeams` 已被满足 ⇒ 服务已挂载 ⇒ 探针 `available:true` ⇒ 拒绝路径不触发 ⇒ US1 可达） |
| D2 🟡 | 首行与原因行自相矛盾（5 条不可读分支，无条件的常量首行 + 真机走「调用方非成员」） | `probeAgentTeams` 回一个 `cause` 判别符；渲染器只在 `service-absent` 时打「本部署未提供该投影」，其余四条走中性首行 `TEAM_MODE_ROSTER_UNREADABLE_NEUTRAL` + 原因行；**补两条断言**（调用方非成员档 / 读取抛错档，此前**零断言**） |
| D3 🟡 | 镜像不含 mode / Lead，而镜像自述「与设置变更同一事务内镜像」 | `renderRosterMirror` 补两行（形态 / Lead 会话）；`set-mode` 落笔后与既有调用点**同形**调用同一个 `writeRosterMirror`（best-effort 语义不变：失败只告警）；**补 3 条断言**（补两行 / 切回后跟着事实走 / 镜像坏掉不阻断切换） |
| D4 🟡 | 同档自相矛盾 + 过期限定词抄进三处 | 父档 §2.3 第 7 行、`lib/index.js` 能力矩阵常量、README 同一行三处统一为已核口径「⚠️ 成员部分读宿主投影（2026-09-27 已核：本部署已挂载该服务 ⇒ 探针 available=true）」；矩阵断言同时改成**逐行锁八行原文** |
| D5 🟡 | §4.4 的两档只断言了可读档 | **补「成员名册不可读」档断言**（确认框正文），并补一条两档对照（可读档照旧逐个列成员） |
| D6 🟡 | 「除这两个键以外一个字不改」是过强表述（实现是整份数组回写） | README / CHANGELOG 改成准确表述（只改**本团队行**的两个键；其余行**缺值补默认、已有值不被覆盖**，与既有 `upsert-team` 同形）；**补一条多团队夹具断言**钉住这两半 |
| D7 🔵 | 测试盲区 / 死参数 / 元数断言的语义 | ① 能力矩阵断言改**逐行锁八行原文**（原锁只咬 `❌===4 && ⚠️===3` ＋ 2 行原文，其余 6 行文本漂移不会红）；② 删 `modeSetEnv({ tag: "rg" })` 死参数；③ 三道门的 `length` 断言在注释里**如实标注**为「函数元数变更探测器」，不是行为锁 |
| D8 🟡 | 指路与幂等互斥（唯一的行为缺口） | 幂等判据放宽为「同档同 Lead **且账上已有这一档的形态史行** ⇒ 已是该档（零写）；**账上缺 ⇒ 补记恰好一行**再返回」；正文由**共享常量函数** `modeHistoryBody` 生成（写读同源），只比正文、不看时间戳与作者；**账读不出来 / 没有 workspace ⇒ 不补记**并在返回体如实说明（fail-closed）；**补 3 条断言**（先写失败再按指路重发 ⇒ 账上确实出现该行 / 账读不出来 ⇒ 不补记 / 没有 workspace ⇒ 不补记） |

### 新增 16 条宿主断言的逐条红/负相拆分（测试先行：断言先写，打在**本轮修复前**的实现上）

方法：把 16 条断言（＋ 3 条改写）**先**写进 `host-half.test.mjs`，在**本轮修复前的实现**（工作树，即 B 批的 `lib/index.js`）上整轮跑一次并记下读数 —— 这比事后换实现更强：整轮跑到底、只有新断言红（Y7 纪律的两处调用器把「参数不存在 / 工具未注册」的抛错收成文本，不会把 `assertion total` 打崩）。

- 读数：**`assertion total: 1184 (failed: 14)`**（`nodeExit=1`）。**逐条点名后做了归因**：其中 **13 条是真红**（下面逐条列出），第 14 条（`D6 多团队夹具（准确口径）`）是**夹具假红** —— 那一版夹具忘了 `ctx.provide("agentTeams", …)`，于是整次切换先被宿主探测拒掉、断言读到的是拒绝文案。**补上替身**后，该断言在**两种实现上都绿**（本轮**没有改过**整份数组回写那一行 `reopened.teams.map(...)` ⇒ 行为在修复前后逐字相同）⇒ 它**改归 ★ 负相**（见下面的负相表，第 6 条）。**有效红相 = 13 条**。真红逐条：
  1. `B/U11 完整能力矩阵（D7① 逐行锁八行原文）`；
  2. `B/U6 幂等（sessions，账上缺该行 ⇒ 补记）`；
  3. `B/U6 幂等（补记之后）`；
  4. `D1 拒绝文案通用化`；
  5. `D1 设置 UI 兜底路`；
  6. `D2 分支①「调用方非成员」`；
  7. `D2 分支②「读取抛错」`；
  8. `D3 镜像补两行`；
  9. `D3 镜像跟着事实走`；
  10. `D3 镜像仍 best-effort`；
  11. `D8 指路可执行（本轮修复的核心）`；
  12. `D8 fail-closed①（账读不出来）`；
  13. `D8 fail-closed②（没有 workspace）`。
- 另 **6 条在修复前本来就绿**（含上面那条归因过来的 D6）—— 如实标 **★ 负相**（补的是判据覆盖缺口，不冒充「修复前必红」）：

| # | 在本轮修复前也通过的 6 条 | 为什么（★ 负相） |
| --- | --- | --- |
| 1 | `B/U6 幂等（agent-team，账上已有该行）`（**改写既有断言**：加上「账上已有该行」这一半 ＋ decisions 逐字节不变） | 夹具的账上本就有 U2 那次真切换写的同一行 ⇒ 旧实现的「同档同 Lead ⇒ 零写」在这一支上**本来就对**；改写的价值是把它与「缺行则补记」那一支**分开钉住** |
| 2 | `D2 首行按分支准确化（反向锁）` | 反向锁：要求**服务缺席**那一支仍说「本部署未提供该投影」—— 旧实现无条件都这么说，所以它在旧实现上 trivially 绿；绿相上它是「不许把中性首行滥用到服务缺席」的锁 |
| 3 | `D5 确认框正文（名册不可读档）` | 该档**早就实现了**（`（成员名册不可读）`），缺的是断言 —— 覆盖缺口类 |
| 4 | `D5 两档对照` | 同上（可读档由 B/U2 断言，本轮把它与不可读档并排对照） |
| 5 | `D8 前置（写失败）` | 前置条件断言：「没有 workspace ⇒ settings 落笔成功而形态史未写 ＋ 给出指路」在旧实现上**本来就成立**（那一条分支没变）；它钉住的是**重发路径的起点** |
| 6 | `D6 多团队夹具（准确口径）` | **D6 是文档表述问题、不是行为缺陷**：审计要求的是把「除这两个键以外一个字不改」改准 ＋ **补一条覆盖断言**。本轮**没有动过** `reopened.teams.map(...)` 那一行（修复前后逐字相同）⇒ 断言在两种实现上都绿。**假红说明**：首次红跑时这条 FAIL 是**夹具缺宿主替身**造成的（切换先被探测拒绝），不是 D6 的行为差异 —— 补上替身后即归 ★ 负相，如实标注 |

- **本轮改写的既有断言 3 条**（同批同步，不留旧口径）：`U11 完整能力矩阵`（→ 逐行锁八行原文）· `U6 幂等（agent-team）`（→ 加上「账上已有该行」这一半）· `U6 幂等（sessions）`（→ 拆成「缺行 ⇒ 补记恰好一行」＋「补记之后 ⇒ 零写幂等」两条）。

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1184 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

基线 `1168` / `269` ⇒ **新增 16 条宿主断言**（`1184 = 1168 + 16`）；**浏览器半边本轮一字未改**（仍 `269` —— 本轮只动宿主半边的文案、镜像与幂等分支）。两套件的宿主进程**退出码均为 0**。

### D1–D8 逐条「怎么验证它没了」

| # | 怎么验证它没了（皆由本轮断言钉住） |
| --- | --- |
| D1 | 拒绝文案断言要求：含「当前活动的 profile」「dsh.profile.bundles」「@deepseek-ai/dsh-experimental-agent-team-profile」，且**不含**「本部署」/「本部署未装载」；另一条要求含「兜底路（永远可用）」「用户经设置 UI 永远是超级写者」「team-link.teams[].mode」。四处文档同步后，`grep 未装载` 在本档 / README / `lib/index.js` 中**零命中**（B 档与父档只剩「曾把真机读反、已更正」的叙述） |
| D2 | 两条新断言：`isMember:false` 档与 `listThrows` 档的读面首行是中性行、**不含**「本部署未提供该投影」、且原因行点名各自的 cause；反向锁要求服务缺席档仍用旧文案 —— **首行与原因行不再可能互相打脸** |
| D3 | 三条断言：`set-mode` 落笔后 `roster.md` 里出现 `- 形态（mode）：agent-team` 与 `- Lead 会话（leadSessionId）：session-self`（返回体带「镜像已更新」）；切回 sessions 后同一文件里是 `sessions` ＋ Lead 行如实写「（空；…）」；镜像写不动（workspace 指向一个文件）时切换照旧成功、只多一句「镜像写入失败」 |
| D4 | 矩阵断言**逐行**比对八行原文（表头 ＋ 八行恰 9 行），其中第 7 行是已核口径 ⇒ 三处任一处漂回「未复核」即红；`grep 未复核` 在父档 / B 档 / README / `lib/index.js` 的能力矩阵一行**零命中** |
| D5 | 断言读确认框正文：名册不可读时那一行逐字是 `当前 teammate（若可读）：（成员名册不可读）`，同一次调用的正文仍含三件不迁移与「不阻断」两句；另一条把它与可读档（`lead（Lead，running）`）并排对照 |
| D6 | 多团队夹具断言：本团队行 `mode=agent-team` / `leadSessionId=session-self`；另一行**已有值**（`agent-team` / `session-other-lead`）**一字未被覆盖**；第三行夹具里**没有**这两个键，调用后变成 `sessions` / 空串 —— 正对着 README / CHANGELOG 改后的准确表述 |
| D7 | ① 矩阵锁逐行（见 D4）；② `modeSetEnv` 无 `tag` 形参，`grep 'tag: "rg"'` 零命中；③ arity 断言上方的注释如实写明它是**函数元数变更探测器**，不是行为锁 |
| D8 | 三条断言：**先**在 `workspace` 为空的团队上切换（settings 落笔、形态史未写、给出「重发本次切换以补记」的指路），**再**补上 workspace 重发 ⇒ 账上**确实出现** `形态 → agent-team（Lead=session-self）` 恰一行、返回体说「已是该档」＋「形态史补记」；另两条钉住 fail-closed（`decisions.md` 读不出来 / 没有 workspace ⇒ 「不补记」且不出现成功措辞）；外加两条幂等断言分清「账上有该行 ⇒ 零写」与「账上缺该行 ⇒ 补记」 |

### 边界与残留声明

- **本轮未运行任何破坏性命令**（无 `git rebase` / `reset --hard` / `clean -f` / `push --force`）；**未碰部署面**（`profile/profiles/web/...` 与用户目录里的插件副本）；**未碰 `docs/observability-batch-design-2026-09-26.md`**。
- **工作树零新增残留**：本轮的套件运行由脚本自己在 teardown 里清掉 `<repo>/.test-tmp-team`（含本轮新增的 `mode/*`、`mirror-ws`、`multi-ws`、`noboard-ws`、`readfail-ws` 夹具目录）；本轮**没有产生任何临时文件 / 探针 / 备份**（红相是「先写断言、在同一棵树里跑」得到的，不需要换实现、不需要隔离夹具目录）。
- `git status --short` 的八个 `M` 与本轮开始时**逐条相同**（`lib/index.js` · `host-half.test.mjs` · `README.md` · `CHANGELOG.md` · `docs/verification-log.md` · `docs/team-mode-batch-design-2026-09-26.md` · `docs/team-ledger-and-mode-design-2026-09-26.md` · `docs/observability-batch-design-2026-09-26.md` 的修改早于本轮、属上一轮 `DIVERGENCE(12)`）；根目录下那些 `.log` 与被忽略的 `.test-tmp-r7pre/` 都是**更早轮次**留下的（`.gitignore` 已覆盖），本轮既不产生也不清理它们。
- **提交哈希 `12f0874`（2026-09-27 由父会话回填）**（本仓纪律：coder 不碰 git 历史）。

### 同批同步的面

- `lib/index.js`：`AGENT_TEAMS_HOWTO`（通用化）· `MODE_SETTINGS_FALLBACK`（新）· 能力矩阵第 7 行 · `probeAgentTeams` 的 `cause` · `TEAM_MODE_ROSTER_UNREADABLE_NEUTRAL`（新）· `teamModeSectionLines` 按分支取首行 · `renderRosterMirror` 两行 · `set-mode` 的镜像调用 ＋ 幂等放宽 ＋ 形态史共享写入（`modeHistoryBody` / `decisionRowBody` / `decisionsHasModeHistory` / `appendModeHistoryRow` / `backfillModeHistoryRow`）· roster 工具描述面的幂等口径；
- `host-half.test.mjs`：16 条新断言 ＋ 3 条改写 ＋ `makeAgentTeams` 的 `listThrows` 与 `modeSetEnv` 的 `workspace` 两个夹具参数 ＋ 删死参数 ＋ 元数断言注释；
- `README.md`：三处读数 `1168 → 1184` · 能力矩阵第 7 行 · 落笔 / 幂等 / 看形态 / `set-mode` 四行 · `agentTeams` 服务表两处；
- `CHANGELOG.md`：本轮条目 ＋ B 批条目里「落笔」「幂等」两条口径同改；
- `docs/team-mode-batch-design-2026-09-26.md`：状态行补本轮说明 · §3 未复核面行 · §4.2 落笔后 / 幂等 · §4.3(3) 首行按分支（第三种文案）· §6 U6 / U11 / U11b · §8 A1 · §8.1 A1；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：§2.3 第 7 行 · §7 步 3 行（补本轮交付说明）· §8 已核那条。

## B 批收尾修复轮（代码评审 R1–R6）（2026-09-27；当次实测 `1193 (failed: 0)` / `269 (failed: 0)`，基线 `1184 (failed: 0)` / `269 (failed: 0)`）

> 来源：形态批（B 批）与分歧审计修复轮 `DIVERGENCE(8)` 之后的**只读代码评审 7 条**，本轮闭环其中 **6 条**（R1–R6）；**R7 不接受修复**（父侧裁定：接受顺序耦合）—— 见下「已知可接受项」。**不夹带新功能、不扩范围**：A 批设计 §7 与 B 档 §7「明确不做」继续有效；`docs/observability-batch-design-2026-09-26.md` **本轮一字未动**；**不碰部署面**。变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的「B 批收尾修复轮（代码评审 R1–R6）」条目；设计口径落在 B 档 [team-mode-batch-design-2026-09-26.md](team-mode-batch-design-2026-09-26.md)（状态行 · §4.2 幂等）与父档 [team-ledger-and-mode-design-2026-09-26.md](team-ledger-and-mode-design-2026-09-26.md)（状态段 · §7 步 3 行）。
> **取代声明（不删历史）**：上一节 `DIVERGENCE(8)` 的「U11b / U8 边界证据」行引用的 reason 原文（`宿主没有提供 agentTeams 服务（本次运行的 profile 没有装载…）`）**已被本轮 R1 改写** —— 那一行是**那一轮的实测读数**，不再代表当前实现；当前原文见本节 U11b 行。

### 本批做了什么（六条，逐条对评审结论）

| # | 评审结论 | 本轮处置 |
| --- | --- | --- |
| R1 🟡 | 诊断话术仍是**断言式归因**（D1 同类，漏改了一处）：`probeAgentTeams` 的 service-absent 分支把「服务看不见」写成因果断言「**本次运行的 profile** 没有装载…」 | reason 软化为「服务 `agentTeams` 当前不可见（可能未装载 Agent Teams 组合包 …, 也可能尚未激活完成 —— 可稍后重试，或核对当前活动 profile 的 `dsh.profile.bundles`）」；写路径拒绝照旧刺眼（拒绝 + 指路 + 零写入），**不替宿主下结论**；**引用该文案的既有断言同批改写**（`D2 首行按分支准确化（反向锁）`） |
| R2 🔵 | 同一判据被探测两次：可用性门与确认框正文的投影各调一次 `probeAgentTeams` | 「切到 agent-team」那一向的探测结果**直接复用**为确认框正文的投影（`probe ?? probeAgentTeams(...)`）；只有「切回 sessions」那一向没有前置探测、才现读一次。两条路的处置仍各自决定 |
| R3 🔵 | TOCTOU 复检后的**不对称**：镜像用复检后的行，形态史那行还用**对话框前**的 `team` ⇒ 确认框期间设置变了就账/镜像分家 | 两者**同源**：镜像与形态史都取 `teamWritten = nextTeams.find(...)`（复检后的那一行） |
| R4 🔵 | 幂等放宽的语义噪音：从未切换过的团队第一次收到默认档声明会**补记一行史**（设计裁定的取舍，**行为不动**） | B 档 §4.2 与 README 的对应处补明示「**首次声明也算一行**（形态史记的是「**声明过这一档**」，不是「档位发生变化」）」；`lib/index.js` 里两处同义措辞（`已是该档` 那一支与 `backfillModeHistoryRow` 的「已有」档）**同批改准** —— 否则文档与工具输出自相矛盾（旧措辞「形态史记的是「切换」，不是「重复声明」」全库零残留） |
| R5 🔵 | 无会话身份时诊断行会「猜」：`otherReachableSessions` 退化为按 `process.cwd()` 过滤 ⇒ 可能打**基于猜测**的「⚠ 多会话通道看起来不可用」 | `selfId === undefined` ⇒ **返回 `null`（不判）**，与 `sessionIdSnapshot` 的失败语义对齐（读不到 ⇒ `null` ⇒ 不判、不猜）；状态卡 ⑦ 段（原先直接传 `pool`）随之收敛到同一判据 |
| R6 🔵 | 状态行措辞过宽：B 档写「**D8 是本轮唯一的行为改动**」，而 D2 / D3 都改了**可观测输出** | 收窄为「唯一的**门 / 写路径语义**改动（D2 / D3 只改读面文案与镜像渲染）」；**同类声明全库同改**（B 档状态行 · B 档 §4.2 · `CHANGELOG.md` 的 `DIVERGENCE(8)` 条目 · 父档 §7 步 3 行） |

### 新增 9 条宿主断言 ＋ 改写 1 条的逐条红/负相拆分（测试先行：断言先写，打在**本轮修复前**的实现上）

方法：把 9 条新断言与 1 条改写断言**先**写进 `host-half.test.mjs`，在**本轮修复前的实现**（工作树，即 B 批 ＋ `DIVERGENCE(8)` 的 `lib/index.js`）上整轮跑一次并记下读数。

- 读数：**`assertion total: 1193 (failed: 8)`**（`nodeExit=1`）；**8 条真红**逐条：`R1 写路径拒绝文案软化` · `R1 写读同源（读路径的原因行）` · `R2 同一判据只取一次` · `R3 TOCTOU 后镜像与形态史同源` · `R4 形态史语义明示（返回体）` · `R5 无会话身份（roster get）` · `R5 无会话身份（状态卡 ⑦ 段）`（以上 7 条新断言）＋ `D2 首行按分支准确化（反向锁）`（**改写**：期望值随 R1 的文案一起改，故在本轮修复前的实现上必红）；
- 另 **2 条新断言在两种实现上都绿** —— 如实标 **★ 负相**（覆盖缺口类 / 反向锁，**不冒充红相**）：

| # | 在本轮修复前也通过的 2 条 | 为什么（★ 负相） |
| --- | --- | --- |
| 1 | `R2 ★ 负相（切回方向的对话框正文）` | 切**回** sessions 那一向修复前后**逐字同形**（旧实现也是现读一次投影）⇒ trivially 绿；它的价值是钉住「复用只发生在切到 agent-team 那一向」，防 R2 的复用被顺手扩到另一向 |
| 2 | `R5 反面对照（有身份时判据照样生效）` | 反向锁：要求**带**会话身份时诊断行照旧出现 —— 旧实现本来就出这一行 ⇒ trivially 绿；绿相上它钉住「R5 不是把判据整体关掉」 |

- **本轮改写的既有断言 1 条**：`D2 首行按分支准确化（反向锁）`（`mdNoHostGet` 的原因行期望值改为新措辞，并新增「也可能尚未激活完成」这半条）。

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1193 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

基线 `1184` / `269` ⇒ **新增 9 条宿主断言**（`1193 = 1184 + 9`）＋ **改写 1 条**；**浏览器半边本轮一字未改**（仍 `269` —— 本轮只动宿主半边的文案与判据）。两套件的宿主进程**退出码均为 0**。

- **如实记一条偶发读数**：绿相**首跑**出现过 1 条与本轮 diff 无关的 FAIL —— `缺口1 超时读数自报真实后果（计时器到点）`（该夹具把生产计时器压成 `0ms`，本身带时序敏感性）。本轮共实跑 6 次：红相 2 次它都绿、绿相首跑它红、其后 **2 次绿相重跑与 1 次改注释后的复核全绿**。它不在本轮触碰的任何代码路径上（rotate / claim 的确认框路径本轮一字未动），按偶发记录在此，供宿主复核时对照。

### R1–R6 逐条「怎么验证它没了」

| # | 怎么验证它没了（皆由本轮断言钉住） |
| --- | --- |
| R1 | 两条断言同时咬**写路径**（`smNoHostOut`：含 `服务 agentTeams 当前不可见` 与 `也可能尚未激活完成`、**不含** `没有装载`）与**读路径**（`mdNoHostGet` 的 `（不可读原因：…）` 行逐字同源）⇒ 文案既不再断言成因，也仍然只有一份字面量；`grep 没有装载` 在 `lib/index.js` 的 reason 上**零命中**（HOWTO 里「有没有 …」那类正常表述不受影响） |
| R2 | `tryMembership` / `listMembers` 各**恰 1 次**，且同一次调用的确认框**确实弹了**（`uq.requests.length === 1`）—— 不是「没探测」而是「只探测一次」。**修复前的次数由代码直接读出**：`probeAgentTeams` 在可用性门与确认框正文各调一次 ⇒ 2 / 2（该断言在本轮修复前实测红，红的就是计数这一项） |
| R3 | 确认框期间把 workspace 改成新路径 ⇒ 断言要求 **新路径下 `roster.md` 与 `decisions.md` 都在**（内容各含本次落笔的值），**旧路径下一个文件都没生成**（`readOrMissing` 返回读取失败）。修复前该断言红：镜像在新路径、账落在旧路径 |
| R4 | `已是该档` 的返回体含 `声明过这一档` 与 `档位发生变化`、**不含** `重复声明`；`grep 重复声明` 在 `lib/index.js` / `README.md` / B 档三处**零命中**（仅历史读数节保留旧措辞的引用） |
| R5 | 两条断言各咬一条路：无身份时 `roster get` 与状态卡 ⑦ 段都**不打**诊断行（旧实现按 `process.cwd()` 过滤 ⇒ 凭空打出这一行），同时形态段、能力矩阵、「（当前会话未知）」照旧；第三条反向锁要求**有身份**时该行照旧出现 |
| R6 | 四处同类声明（B 档状态行 · B 档 §4.2 · `CHANGELOG.md` 的 `DIVERGENCE(8)` 条目 · 父档 §7 步 3 行）一律收窄为「唯一的**门 / 写路径语义**改动（D2 / D3 只改读面文案与镜像渲染）」；`grep '唯一的行为改动'` 剩下的命中只在**本轮条目的叙述里**（引用旧措辞说明改了什么）与**另一批**（A 批流水里 D7 那条，本轮不在范围内、未动） |

### 已知可接受项（R7，**本轮不修、仅留档**）

- **R7 🔵 测试夹具顺序耦合 —— 接受，不改**。`host-half.test.mjs` 的 `modeSetEnv` 共享 `SM_WS` / `smDecisions`，多个用例依赖前序写入（例如 `U6 幂等（agent-team）` 依赖 `U2` 那次真切换写下的形态史行）。评审与父侧一致裁定为**可接受的顺序耦合**：夹具里有注释说明、`rmSync(TEAM_TMP)` 的 teardown 已清理本轮新增的一切。
- **如未来重排用例**：必须**同时**给各用例独立 workspace（否则重排即静默改语义）。**已有的正确做法**就在同一文件里：`D8` 的 `nbWs` / `fbWs` 各自一份 workspace。**本轮不新增顺序耦合**：新夹具的 4 个目录各自独立（`r2-ws` / `r2-back-ws` / `r3-old-ws` → `r3-new-ws`，覆盖其中 3 条断言），**其余 6 条新断言读的是既有夹具的只读字符串**（`smNoHostOut` / `mdNoHostGet` / `smIdemOut` / `st3Sole` / `stNoIdentity`），零写入、无前序依赖。

### 边界与残留声明

- **本轮未运行任何破坏性命令**（无 `git rebase` / `reset --hard` / `clean -f` / `push --force`）；**未碰部署面**（`profile/profiles/web/...` 与用户目录 `<USERPROFILE>\.dsh-plugins\dsh-team-link`）；**未碰 `docs/observability-batch-design-2026-09-26.md`**。
- **工作树零新增残留**：本轮没有产生任何临时文件 / 探针 / 备份（红相是「先写断言、在同一棵树里跑」得到的，不换实现、不隔离夹具目录），套件运行由它自己的 teardown 清掉 `<repo>/.test-tmp-team`。`git status --short` 只列本轮允许的 8 个 `M`；根目录下那些 `.log` 与被忽略的 `.test-tmp-r7pre/` 是**更早轮次**留下的（`.gitignore` 已覆盖），本轮既不产生也不清理它们。
- **提交哈希 `12f0874`（2026-09-27 由父会话回填）**（本仓纪律：coder 不碰 git 历史）。

### 同批同步的面

- `lib/index.js`：`probeAgentTeams` 的 service-absent reason（R1）· `set-mode` 的探测复用（R2）与 `teamWritten` 同源（R3）· 两处形态史措辞（R4）· `otherReachableSessions` 的 `selfId` 早返回（R5）· 状态卡 ⑦ 段的判据（R5）；
- `host-half.test.mjs`：9 条新断言 ＋ 1 条改写（新夹具各自一份 workspace，不新增顺序耦合）；
- `README.md`：三处读数 `1184 → 1193`（tests 徽章 / 稳定性行 / §十「当前读数」）· 宿主探测行（只报现象 + 只探一次）· 落笔行（镜像与形态史同源）· 幂等行（首次声明也算一行）· 形态诊断行（无身份不判）；
- `CHANGELOG.md`：本轮条目 ＋ `DIVERGENCE(8)` 条目里 D8 那句声明的收窄；
- `docs/team-mode-batch-design-2026-09-26.md`：状态行（本轮交付说明 ＋ R6 收窄）· §4.2（R4 明示「首次声明也算一行」＋ R6 收窄）；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：状态段（本轮交付说明）· §7 步 3 行（R6 收窄 ＋ 本轮读数）。

---

## 真机冒烟修复轮（L1 时基 / L2 镜像）（2026-09-27；当次实测 `1203 (failed: 0)` / `269 (failed: 0)`，基线 `1193 (failed: 0)` / `269 (failed: 0)`）

> 来源：**真机冒烟** —— 在运行中的壳里对台账做写入冒烟（建临时团队 → `plan/claim/done/dispute` 四种行 → 读回派生视图）时抓到的两条**夹具与审计都没抓到**的问题（它们只在真实运行环境里才看得见）。父侧裁定：L1 把**渲染出来的时间**统一到本地时基；L2 让镜像渲染器**永不打印 `undefined`** 且 `upsert-team` **显式写入**两个形态字段的默认值。**不夹带新功能、不扩范围**：A 批设计 §7 与 B 档 §7「明确不做」继续有效；`docs/observability-batch-design-2026-09-26.md` 本轮一字未动；**不碰部署面**；**不动 `<repo>\team\smoke-test\`**（真机冒烟的数据，留着当证据）。变更史见 [../CHANGELOG.md](../CHANGELOG.md) 的同名条目；口径落在父档 [team-ledger-and-mode-design-2026-09-26.md](team-ledger-and-mode-design-2026-09-26.md) §9.3.3（时间基）与 B 档 [team-mode-batch-design-2026-09-26.md](team-mode-batch-design-2026-09-26.md) §4.1（镜像范围）。

### 病灶与处置（两条）

| # | 现象（真机实测） | 根因（本轮核实） | 处置（父侧裁定） |
| --- | --- | --- | --- |
| L1 🟡 | `team_link_team_read` 的 tasks 块里**同屏混用两个时基**且未标注：派生视图写 `最后主张 done（2026-09-27 01:45 · session-…）`，**同一屏**末尾写 `（读数 2026-09-27 09:45:31，>2min 作废）` —— 差 8 小时（原始行是 `2026-09-27T01:45:31.010Z`） | `taskStamp(iso)` 把 ISO 串**切前 16 位**（UTC），`readStamp(now)` 走 `localStamp(new Date(...))`（本地）⇒ 同一瞬间两个时基 | 派生视图改走与 `readStamp` **同一套本地格式化**（`localStamp(date, withSeconds = false)`，分钟精度不变）；时间的**瞬间**由 `new Date(<ISO 列>)` 解析，不再做字符串切分；**原始行**逐字保留 UTC ISO（事实源不动）。**调用点已核**：`taskStamp` 只有派生视图那一处调用，别处不依赖切串语义 |
| L2 🟡 | `team_link_roster action=upsert-team` 新建的团队，`<workspace>/team/<name>/roster.md` 里两行是 `- 形态（mode）：undefined（闭集 sessions / agent-team；默认 sessions）` 与 `- Lead 会话（leadSessionId）：undefined` | 镜像渲染器读的是**未归一化**的团队对象，而 `applyTeamUpsert` 新建时构造的行**没写**这两个新字段 —— 既有团队走归一化读面（`normalizeTeams` 每次读都补），所以旧团队看不出来；`/team rotate` 的批量建队走同一个函数 ⇒ 同一病灶 | ① 渲染器**永不打印 `undefined`**：两字段按 `normalizeTeams` 的**同一套缺字段语义**（空串 / 非字符串 = 字段缺席）+ 闭集规则归一化；② `upsert-team` 新建时**显式写入** `mode: "sessions"` / `leadSessionId: ""`；③ 断言钉住**新建路径的镜像**与**两个读面（roster get 形态段 / 状态卡 ⑦ 段）的零 `undefined` 泄漏**；④ B 档 §4.1 与 README 补「镜像范围」 |

### 新增 10 条宿主断言 ＋ 改写 10 条的逐条红/负相拆分（测试先行）

方法：10 条新断言与 10 条改写的期望值**先**写进 `host-half.test.mjs`，在**本轮修复前的实现**（= `HEAD` 的 `lib/index.js`）上把两者**一起**整轮跑一次并记下读数。

- 读数（**聚合红相**，逐字两行）：`17 FAILURE(S)` / `assertion total: 1203 (failed: 17)`（`nodeExit=1`）；
- **7 条真红（新断言）**：`L1: 派生视图的时间戳是本地时基…` · `L1: 同一判据在带偏移的时间列上照样成立…` · `L1 ★ 判别钉子…` · `L2 ①: 镜像渲染器永不打印 undefined…` · `L2 ①（闭集外的值）…` · `L2 ②: upsert-team 新建时显式写入…` · `L2 ②（新建路径的镜像）…`；
- **10 条真红（改写的期望值）**：`§9 U12` ×2 · `§9 U13` ×3 · `§9 U15` ×1 · `§9 D6①` · `§9 D6②` · `§9 D5`（这 9 条的期望值原本由 `stampOfRow` 从行里的 ISO 串切出来 —— **与实现同源、自证**，改用同一瞬间的**本地墙钟**之后在旧实现上必红）＋ `U12 零回归: 派生读数…`（TR 夹具那条把 UTC 截断值 `2026-09-26 21:12` 写死，属**既有断言钉错了行为**，本轮改成同源的本地格式化）；
- 另 **3 条新断言在两种实现上都绿** —— 如实标 **★ 负相**（覆盖缺口类 / 反向护栏，**不冒充红相**）：

| # | 在本轮修复前也通过的 3 条 | 为什么（★ 负相） |
| --- | --- | --- |
| 1 | `L1 ★ 负相：时间列不是日期时…` | 两种实现都只是回显那一列（旧实现切 16 码点、新实现 `preview(…, 40)`；该夹具的列只有 7 个码点 ⇒ 逐字相同）⇒ trivially 绿；它的价值是钉住「不编造时间、也不打印 `NaN-NaN-NaN`」这一支 |
| 2 | `L1 ★ 负相：原始行逐字保留 UTC ISO` | 本轮只动渲染，行的写路径一字未动 ⇒ trivially 绿；绿相上它钉住「渲染 = 本地时基」**没有**连累「原始行 = UTC ISO」 |
| 3 | `L2 ★ 负相：两个读面零 undefined 泄漏` | roster get 形态段与状态卡 ⑦ 段读的是**归一化后**的团队行（新字段之前的团队也走这条路）⇒ 旧实现上本就无泄漏；它是给「同类泄漏」上的护栏 |

- **本轮改写的既有断言共 10 条**（全在 `host-half.test.mjs`）：9 条 `§9 U12/U13/U15/D5/D6` 的期望值 ＋ 1 条 TR 夹具的 `U12 零回归`。**夹具的期望值不再自证**：`stampOfRow` 从「切行里的 ISO 串」改成「把那个瞬间按**本地墙钟**独立算出来」（`localMinute`）—— 与实现同源（同一套本地格式化语义）但**不共用同一条串** ⇒ 任何时基改动都会当场变红。
- **判据的机器无关性**：`L1 ★ 判别钉子` 的两行时间列**前 16 位完全相同**（`…01:45:31.010Z` 与 `…01:45:31.010+05:00`）却是**相差 5 小时**的两个瞬间 ⇒ 旧实现渲染成同一条串、新实现必然不同，**在 UTC 机器上同样成立**；带偏移那一行刻意用 `+05:00` 而不是本机偏移 `+08:00`（用本机偏移会让那条断言在旧实现上「因为巧合而绿」，新断言不该有这样的运气）。

### 绿相（本批最终读数，实跑两行原文）

```text
node host-half.test.mjs    → ALL PASS / assertion total: 1203 (failed: 0)
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)
```

基线 `1193` / `269` ⇒ **新增 10 条宿主断言**（`1203 = 1193 + 10`）＋ **改写 10 条**；**浏览器半边本轮一字未改**（仍 `269` —— 本轮 diff 全在宿主半边）。两套件的宿主进程**退出码均为 0**（`host-exit=0` / `client-exit=0` 实测）。

### L1 / L2 逐条「怎么验证它没了」

| # | 怎么验证它没了（皆由本轮断言钉住） |
| --- | --- |
| L1 | 三条真红断言：① t-1 的接活瞬间（`01:45:31Z`）渲染成**本地墙钟**；② 带偏移的时间列（`+05:00`）同样按**瞬间**渲染（旧实现只切串、偏移被整个忽略 ⇒ 任何机器上必红）；③ 判别钉子：两行前 16 位相同、相差 5 小时的两个瞬间**渲染必须不同**（与机器时区无关）。另两条 ★ 负相护栏钉住「不编造时间」与「原始行仍逐字 UTC」。**同屏可比性**由形状保证：派生视图与屏末「读数」现在同出一套本地格式化（`localStamp` / `readStamp`）—— 这正是本轮裁剪掉的失准。 |
| L2 | 四条真红断言：① `renderRosterMirror` 直接喂一个**两个字段都没有**的团队对象 ⇒ 渲染出 `sessions` ＋ 空 Lead，且整份镜像**零 `undefined`**；② 闭集外的 `mode`（`agentTeam`）同样落默认档（镜像里不出现读面不会说的档位名）；③ `upsert-team` 新建的 settings 行**自带**两个默认值（`Object.hasOwn` ＋ 取值 —— 不是靠 schema 兜底、也不是靠读面归一化）；④ **新建路径的镜像**里就是 `sessions` ＋ 空 Lead、零 `undefined`（真机症状的原地复现）。另 1 条 ★ 负相扫两个读面（roster get 形态段 / 状态卡 ⑦ 段）零泄漏。 |

### 边界与残留声明

- **一次性替换探针（如实交代）**：聚合红相是把 `HEAD` 的 `lib/index.js` 用 `cmd /c "git show HEAD:lib/index.js > lib\index.js"`（**字节级重定向，只读命令**）写回工作树跑出来的；跑之前先在 `$env:TEMP` 留了一份 sha256 记录在案的副本，跑完立刻 `Copy-Item` 还原并**再跑一次绿相**（本节绿相读数即还原后实跑）。还原后工作树 `lib/index.js` 的 sha256 与副本一致（`A78C463DEB84E726…`），副本已删除（`Test-Path` = `False`）。**未运行任何 git 写命令**（不是 `checkout` / `restore` / `stash`），git 历史与本轮之前的状态未变。
- **工作树零新增残留**：本轮没有留下任何临时文件 / 探针 / 备份；套件运行由它自己的 teardown 清掉 `<repo>/.test-tmp*`。`git status --short` 只列本轮允许的 5 个 `M`；根目录下那些 `.log` 与被忽略的 `.test-tmp-r7pre/` 是**更早轮次**留下的（`.gitignore` 已覆盖），本轮既不产生也不清理它们。
- **未碰 `<repo>\team\smoke-test\`**：真机冒烟的数据（含那个被渲染成 `undefined` 的 `roster.md`）**原样留着当证据**；本轮断言在 `.test-tmp*` 夹具里自建同名形状，读都不读它。
- **相邻发现（本轮不改、如实留档）**：`renderRosterMirror` 的 `team.rotationBackup !== null` 判断对**缺键**（`undefined`）的裸对象会取到 `undefined.at` 并抛错。该形状在本轮的所有调用点都**不可达**（调用方传的是归一化行、或 `applyTeamUpsert` 写全了的行），且不属 L1/L2 的判据面 ⇒ 未动。

### 同批同步的面

- `lib/index.js`：`localStamp(date, withSeconds)` · `taskStamp` 改本地时基（＋ 解析不出日期时原样回显）· `applyTeamUpsert` 新建时显式写两个默认值 · `renderRosterMirror` 的两个字段归一化；
- `host-half.test.mjs`：5 条 L1 新断言 ＋ 5 条 L2 新断言 ＋ 10 条改写期望值（`stampOfRow` 换成本地墙钟的独立算法）；
- `README.md`：稳定性行与 §十「当前读数」的 `1193 → 1203`（tests 徽章同改）· §四「任务台账」补**时间基**一条 · 团队形态表补**镜像**一行 · 「实现约定」里的时间戳条目改准；
- `docs/team-mode-batch-design-2026-09-26.md`：状态行（本轮读数）· §4.1 补「镜像（`roster.md`）的范围」段；
- `docs/team-ledger-and-mode-design-2026-09-26.md`：§9.3.3 补「时间基（渲染 = 本地时基，原始行 = UTC ISO）」段 · 状态段与 §7 步 3 行的读数；
- `CHANGELOG.md`：本轮条目 ＋ 部署脚本条目里「两条都另立修复条目」那句改为指向本条。
---

## 策略持久化自持化（2026-09-27；当次实测 `1237 (failed: 0)` / `269 (failed: 0)`，基线 `1203 (failed: 0)` / `269 (failed: 0)`）

> 设计档：[`policy-persistence-design-2026-09-27.md`](policy-persistence-design-2026-09-27.md)。判据 U1–U9 见该档 §4（`host-half.test.mjs` 里的可 grep 前缀：`U1 文件后端:` `U2 原子写:` `U3 折叠:` `U4 裁决:` `U5 落点行:` `U6 只写一处:` `U7 路径:` `U8 遗留命名空间:` `U9 迁移可核:`，逐条 `34` 条 —— 与 `1237 - 1203 = 34` 一致）。

### 绿相（实跑两行原文）

```
node host-half.test.mjs    → ALL PASS / assertion total: 1237 (failed: 0)   （exit 0）
node client-half.test.mjs  → ALL PASS / assertion total: 269 (failed: 0)    （exit 0）
```

稳定性：**宿主套件连跑 10 次，`failed: 0` 十次**（每次都核对进程退出码，不只看 FAIL 行 —— 本轮真被这个坑抓到过，见「三条既存抖动」）。

### 红相（文件后端档 S1，测试先行）

```
7 FAILURE(S)
assertion total: 1214 (failed: 7)
```

真红 6 条 ＋ 1 条既有锁：`U19 import-whitelist: …`（import 白名单由六个模块扩到八个）· `U1 文件后端:` ×3 · `U2 原子写:` ×2 · `U7 路径:` ×1（store 级）。

**★ 负相 4 条**（覆盖缺口类，两种实现上都绿，**不冒充红相**）：`U7 路径:` ×3（纯 `resolvePolicyFilePath` 解析器判据）· `U1 文件后端:` 的「全局 home，不落工作区」一条（当时是恒真路径，后已加固为 `existsSync(TEAM_WS) && !existsSync(path.join(TEAM_WS, "team-link"))`）。

### 折叠/可核/迁移档（S2/S3，23 条）：变异验证而非红相

**过程如实**：S2/S3 的判据是**实现之后**才写进套件的，因此拿不到「实施前红相」。不冒充 —— 改用本仓既有的**变异验证**纪律：每个关键机制打一个**单点**变异，跑套件，取「哪些判据变红」的读数，**变异后按 sha256 校验逐字节还原源码**。

| 变异 | 命中（红）的判据 | 退出码 |
| --- | --- | --- |
| M1 `update()` 不看 scope 也写文件（打掉「只写一处」） | `U6 只写一处:` ×2（＋ 3 条既有判据） | 1 |
| M2 折叠后不回写文件 | `U3 折叠:` · `U4 裁决:`（＋ 1 条既有判据） | 1 |
| M3 折叠时跳过 `superseded` 归档 | `U4 裁决:` ×2 | 1 |
| M4 `policyPlacement()` 一律自称仅内存（落点行说谎） | `U5 落点行:` ×2 · `U3 折叠:` ×1 | 1 |
| M5 载入文件不置 `memoryDirty`（文件里已有的状态永不并入服务） | `U3 折叠:` ×3 · `U4 裁决:` ×3 | 1 |
| M6 链尾回写跳过 | `U3 折叠:` · `U4 裁决:` · `U8 遗留命名空间:` | 1 |
| M7 迁移与折叠次序颠倒 | `U8 遗留命名空间:` ×4 | 1 |
| M8 `loadPolicyFile` 永不读（人工导入形同虚设） | `U9 迁移可核:` ×2 · `U3/U4/U8` ×11 | 1 |

> 还原核验：每次变异后 `sha256(lib/index.js)` 与变异前的哈希**逐字节一致**（8 次全部 `restored byte-identical: true`）。
> **M5 是真发现**：它抓出实现的一个真缺陷 —— 启动时从文件读进来的状态没有被置上「可折叠」位，于是「文件有数据、服务后到」这条最常见的路径在**重启后第一次**折叠时不成立（只在本次会话刚写过时才成立）。已修（`loadPolicyFile` 末尾一行）。
> **M6/M7 改的是设计没说死的地方**（见下「如实留档」）。

### 三条既存抖动（本轮暴露，**不是**本轮引入，但账本要记）

1. **`缺口1 超时读数自报真实后果（计时器到点）`**：24 次跑批实测**假红 2 次**。根因是该断言逐字比对两次 claim 的「批准状态：」行，而那行里的**回退窗口到期时刻是秒精度**，两次 claim 相隔几毫秒 —— 跨过秒边界就不同了。已修：比对时把**时刻本身**归一化成占位符（`approvalTailOf`），判据的原意「除了『发生了什么』那半句两行一字不差」一个字没松。
2. **attach 后置链的等待不能靠猜 tick 数**：链尾新增了一次真实 fs I/O（折叠后回写文件），原先「`await tick()` 一次就断言链行」的写法变成竞态（实测 5 次里红 1～3 次，且**同一份代码两次跑结果不同**）。已改为有界等待 `waitForChain(env, n)` —— 等的是**那行日志本身**（最多 500 个 tick）。
3. **变异跑批里的一次误读**：修 1 之前的修补一度把 `check(...)` 的收尾括号吃掉，那一轮 20 次跑批全部**崩溃**，而当时只统计 `FAIL` 行，于是「0 failure」是假的。此后所有跑批**一律核对进程退出码**。

### 真机（本轮未做，由父侧执行）

一次性迁移与真机读数（导入后 `roster get` 看得见 `threat-intel` ＋ 首行 = `存储：文件 <绝对路径>`；重启后仍在）由**父侧**执行，步骤见 `AGENTS.md` §七。**代码侧不读宿主配置**（`cordis.patch.yml` 全程未被本轮任何代码或脚本打开）。夹具里的等价物即 `U9 迁移可核:` 三条断言。

### 如实留档（本轮发现，按设计不夹带）

- **设计档 §3.1 档 4 说「折叠落定后立即把合并结果重写回文件」，没说重写发生在 attach 后置链的哪一步。** 照字面「折叠那一刻」实现时，文件会**缺**随后那一步（旧命名空间 `session-link-pro` → `team-link`）迁移进来的信任数据 —— 下次服务缺席时那一份等于凭空消失。已把重写挂到**链尾**（折叠 → 旧命名空间迁移 → 回写），并在链行日志**之后**才打「post-attach policy chain finished」，使那一行成为「链已落定、可直接去看文件」的信号（`U8` 与 M6 锁住）。**这是对设计字面的收紧，不是改设计**：折叠结果在文件里这件事一字未变，只是「合并结果」的取值范围从「折叠那一刻」扩到「整条链之后」。
- **第三方与文件的关系，设计档未规定。** 实测取舍：折叠**先于**旧命名空间迁移，于是服务命名空间已被文件那一份占上时，迁移按既有规则报「kept (current namespace in use)」并**把旧命名空间原样留在 settings 里**（不删数据、不静默合并）。反过来（先迁移）会让折叠被「已在用」挡掉、文件那一份被归档 —— 那是更坏的一种丢法。U8 的两条断言把这个取舍钉住。
- **损坏/不可读的 `policy.json` 怎么办，设计档没写。** 本轮裁定：当作**拿不到可用落点**（落点行理由 = `文件不可写` ＋ 一行 warn），**绝不覆盖**那个文件（宁可只留内存态，也不把用户可能还能手工抢救的内容冲掉）。这是我加的解释，**不是设计档的原文**。
- **`README.md` 之外还有两处「当前读数 1203」在本轮之后成了过期声称**：`docs/team-ledger-and-mode-design-2026-09-26.md:168`（「当前套件自报 `1203`」）与 `docs/poster/plugin-poster.html:52`（徽章 `断言 1203 + 269`）。两者**不在本轮允许改动的文件清单**内，故**只留档未改**，留给父侧决定。`CHANGELOG.md` 与本账本里那些 `1203` 是**历史读数**（当时那轮的真值），按「只追加、不重写历史」不动。

## 分歧审计修复轮（`DIVERGENCE(10)` 收口，2026-09-27；当次实测 `1244 (failed: 0)` / `269 (failed: 0)`，基线 `1237 (failed: 0)` / `269 (failed: 0)`）

> 设计档：[`policy-persistence-design-2026-09-27.md`](policy-persistence-design-2026-09-27.md)（§3.1 新增第 5 档「快路径折叠」· §4 新增 U10 与 U5 增补 · §3.6 迁移前置 · §7 残留风险 3）
> 父侧裁定：**逐项收口，不打包、不扩范围**。代码侧只碰 2 项（🟡#5 · 🔵#9），其余 8 项是文档层。

### 改了什么（逐项）

| # | 级别 | 收口 | 落点 |
|---|---|---|---|
| 1 | 🔴 | U4 判据行原写「更晚修改者胜」，与 §3.3「服务非默认 ⇒ 服务胜 + 归档 + 留痕」矛盾；**实现本就正确**，改的是判据文字 | 设计档 §4 U4 行 |
| 2 | 🟡 | 回写时点三处说清：设计档 §3.1 补「实为 attach 后置链**末端**」、状态行里那句「本档未规定」删除、README 补链尾限定 | 设计档 §3.1 / §5 状态行 · README §六 |
| 3 | 🟡 | 变异表最后一行编号 `M9` → `M8`（表里 M8 本就缺号），三处「9 次」→「8 次」 | `verification-log.md:1790/1792` · `CHANGELOG.md:38` · `README.md:26` |
| 4 | 🟡 | 键表表头被复制成两遍（表头 + 空行 + 表头），删掉多余那一份 | `README.md` §六 键表（原 `:1075`–`:1076`） |
| 5 | 🟡 | **本次唯一的语义改动**，见下节 | `lib/index.js` ＋ U10 |
| 6 | 🟡 | 两处过期「当前读数 1203」（上一轮只留档未改）＋ README 三处当前读数 | 海报 `:52` · team-ledger `:168` · `README.md:7/26/1198` |
| 7 | 🔵 | 「与上表的键集」——键表在它**下面** | `README.md:1068` |
| 8 | 🟡 | §5 影响面只列了 README 四处，实际改了**八处**；按实际补齐 | 设计档 §5 |
| 9 | 🔵 | 状态卡段①把「来源」写死成「设置」，改为**跟随落点**（设置 / 文件 / 内存三态） | `lib/index.js` ＋ U5 增补 |
| 10 | 🔵 | 架构图**按裁定不改**；设计档 §5 加一句说明「原 `ST --> settings.yaml` 保留，另新增 `PFILE` 边」 | 设计档 §5 |

### 🟡#5：快路径折叠（唯一的语义改动）

- **缺陷**：`loadPolicyFile()` 过去**只有一个**调用点（`if (scope === null)`）⇒ 设置服务在 activation 就在场时**文件从不被读**。纯设置部署里，上一次跑（服务没挂上时）写进 `policy.json` 的团队，在下一次启动里**不可见** —— 正是设计档 §1 现象的形状。U6 的第二条断言把它锁成了「规格」。
- **裁定**：快路径也要折叠，规则与 §3.1 档 4 **同一条**。服务**为默认** + 文件**有状态** ⇒ 折叠（并入 ＋ 留痕 ＋ 合并结果回写并盖 `foldedAt`）；服务**非默认** ⇒ 按 §3.3 服务胜，文件**连读都不读**（U6 第二条断言逐字保留）。
- **实现**：`attach()` 里的 `loadFileIfServiceAtDefaults()` 在链启动前问一次「命名空间还是默认吗」；`loadPolicyFile()` 加上「每个 store 只读一次」的门（`fileLoadAttempted`），晚挂路径的那次读因此**只发生一次**。折叠本身走的是**原来那一个** `adoptMemoryWindow()`，没有第二个折叠实现。
- **留痕分两支**（`enteredUnattachedWindow`）：折叠的是**上一次进程**留在文件后端里的状态时说一句「fast path … 文件里那一份已并入」；折叠的是**本进程**未挂载窗口的写入时，仍是原来那句「unattached startup window」。说成窗口就是编了一个没发生过的现场。
- **归档只发生在快路径**（如实留档，非设计原文）：并入**之前**把文件那一侧原样存成 `policy.superseded-<ts>.json`，让「并进来的是什么」可复核。晚挂路径**不**存 —— 那一支文件里那份就是**本进程**窗口的镜像，与内存里那份同一内容，存副本不增可核性却给同目录多一次写；更重要的是**那一支的折叠行为按裁定保持一字不动**（U9 对照五条断言对链的完成时刻敏感，多一次文件 I/O 会让它们在断言点读不到折叠结果）。

### 断言与两次实测（逐字）

**红相（本轮修复前的实现 ＋ 本轮的新断言）**：

    6 FAILURE(S)
    assertion total: 1244 (failed: 6)

红的 6 条 = U10 五条里的四条 ＋ U5 增补两条；`U10 快路径折叠: 折叠后落点是设置服务` 修复前即绿 ⇒ **★ 负相**（它断言的是折叠**之后**的落点，而修复前的缺陷是折叠压根没发生 —— 落点对、团队空）。

**绿相（修复后）**：

    ALL PASS
    assertion total: 1244 (failed: 0)
    ALL PASS
    assertion total: 269 (failed: 0)

**新增 7 条**：`U10 快路径折叠:` ×5（并入命名空间 / 落点是设置服务 / 原样归档 / 合并结果盖 `foldedAt` / 留痕两行）＋ `U5 落点行:` ×2（段①「来源」跟随三态 / 落点不是设置服务时不再说「来源：设置」）。

### 如实留档（本轮发生，按设计不夹带）

- **`archiveSupersededFile` 的第二参数叫 `kind` 而不是 `outcome`**：`host-half.test.mjs` §12.5 跨半边那条断言用 `/\boutcome[ \t]*(?::|===)[ \t]*"([^"]+)"/gu` 扫 `lib/index.js` 抽取 outcome 词表，名叫 `outcome` 的字面量会被当成**第五个**投递结局（`unphrased: folded`）。参数改名后该锁重新绿。
- **变异表最后一行「M8 · `loadPolicyFile` 永不读」正是本轮这个缺陷**（上一轮已把它记成变异，只是当时编号误写成 M9）。M8 当年证明的是「读不到文件会红」；本轮补上的是「**读得到还不够** —— 读到之后还得并入服务」这半条判据。
- **上一轮留档的两处过期读数**（`team-ledger:168` / 海报 `:52`）本轮按父侧放行改掉了；`CHANGELOG.md` 与本账本里的 `1203` / `1237` 是**历史读数**，按「只追加、不重写历史」一律不动。

---

## 代码评审修复轮（2026-09-27）— 损坏档守卫 / 写失败 warn 按段复位 / `foldedAt` 盖戳门 / `refused` 窗口

> 逐项收口代码评审列出的 6 条（2 🟡 ＋ 4 🔵）。命令与判据见 [`policy-persistence-design-2026-09-27.md`](policy-persistence-design-2026-09-27.md) §4；本节只放读数。

**红相（把本轮 `lib/index.js` 的修复逐条反向后实跑；新断言已就位）**：

    node host-half.test.mjs
    8 FAILURE(S)
    assertion total: 1255 (failed: 8)

红的 8 条（原文）：

    FAIL  U11 损坏档: 载入判坏之后触发写入，磁盘上那份文件**逐字节不变**（修复前：原子 rename 把它整个替换成合并结果）
    FAIL  U11 损坏档: 落点行报**第 5 个原因**「文件损坏（不覆盖；请人工处理）」—— 不翻成「存储：文件」
    FAIL  U11 损坏档: 判坏在载入留痕里说出口，且写路径**每一次**写都再如实留一行（不静默、也不吞掉第二次以后）
    FAIL  U11 损坏档: 状态本身不受影响（写进内存、读面看得见两个团队），只有落点降级 —— 段①也如实说「进程内存」
    FAIL  U12 写失败: 中间那次**写入成功**之后新的一段失败**又报一行**（修复前这道门是进程级一次性的 ⇒ 第二次失败完全静默）
    FAIL  🔵#3 foldedAt 盖戳门: 本次链上没有折叠发生（memory window: none）时**不重盖** foldedAt —— 它继续指上一次真正落定的折叠，不是「最近一次 attach」（修复前：无条件盖新戳）
    FAIL  🔵#4 refused 窗口: 折叠留痕如实说「服务在场但拒绝注册」—— 不说成「服务从一开始就在场」的那句快路径措辞（修复前：走的是快路径措辞）
    FAIL  🔵#4 refused 窗口: 不给本进程自己写的镜像多归档一份（判据与「只有真·快路径才存档」同源 —— 修复前会多出一份 superseded）

另 3 条修复前即绿 ⇒ **★ 负相**（控制/对照项，作用是让上面那几条红**不是空转的绿**）：`U12 ★ 负相`（钉住那两次写真的失败了：同时刻落点行是 `⚠ … 原因：文件不可写`）、`🔵#3 ★ 负相`（钉住夹具真的落在「没有折叠」那一支）、`🔵#4 ★ 负相`（钉住夹具真的挂上并折叠了、窗口期的写入落的是文件）。

**绿相（修复后）**：

    node host-half.test.mjs
    ALL PASS
    assertion total: 1255 (failed: 0)
    node client-half.test.mjs
    ALL PASS
    assertion total: 269 (failed: 0)

基线 `1244` / `269` ⇒ **新增 11 条宿主断言**（`1255 = 1244 + 11`）：U11 ×4（逐字节不变 / 第 5 个原因码 / 每次写都留痕 / 状态仍可用）＋ U12 ×2（一段一行 ★ 负相 ＋ 成功后再失败又一行）＋ 🔵#3 ×2（不重盖 + 对照 ★ 负相）＋ 🔵#4 ×3（夹具真挂上 ★ 负相 + 措辞 + 不多归档）。**浏览器半边一字未改**（`client-half.test.mjs` 不动）。

### 夹具侧的两处如实留档

- **U11 需要「原文落盘的坏 JSON」**：`setup()` 的 `policySeed` 过去一律 `JSON.stringify`，且落盘发生在 `apply(ctx)` **之前** —— 也就是说 `loadPolicyFile()` 那一刻文件已经定形，夹具之后补写的字节插件**读不到**。现在 `policySeed` 收**字符串**时按原文写盘。
- **🔵#4 需要「同一个服务先拒后从」**：cordis 的 `provide` 不允许在 `<root>` 重复注册同一个 key，`provideSettingsFiber()` 换个新 stub 会抛 `service "settings" has been registered at <root>`。改为给 settings stub 一个把手 `stopRefusing()`（与既有的 `markDead()` 同类），让**同一个**服务在窗口期拒注册、之后改口 —— 这才是真实的「服务在场但拒注册、后来才挂上」。

---

## 代码评审第 2 轮（2026-09-27）— catch 支盖戳门 / 数组 policy 也判损坏 / 两因并存并陈

> 逐项收口代码评审第 2 轮的 3 条（1 🟡 ＋ 2 🔵）。判据（4 红 ＋ 3 ★ 负相）由**上一轮**（`eng-dsh-7`，被 DSH 重启打断、无报告）预先写进 `host-half.test.mjs`；本轮从工作区起点实测复核后**只补实现，不新增判据**。命令与判据见 [`policy-persistence-design-2026-09-27.md`](policy-persistence-design-2026-09-27.md) §3.4/§3.5；本节只放读数。

**红相（本轮实现之前，实跑；断言已就位）**：

    node host-half.test.mjs
    4 FAILURE(S)
    assertion total: 1262 (failed: 4)

红的 4 条（原文）：

    FAIL  🟡#1 catch 支盖戳门: 链在折叠结果产出**之前**断掉时**不盖新 foldedAt** —— 文件里那个戳逐字节保留（修复前：catch 支无参调用 ⇒ 照盖新戳，把「最近一次 attach 时刻」冒充「折叠落定时刻」）
    FAIL  🔵#2 数组 policy: `{"schema":1,"policy":[]}` 判为损坏档 ⇒ 落点行报**第 5 个原因**（修复前：`typeof [] === "object"` ⇒ 被当合法空档，落点翻成「存储：文件」）
    FAIL  🔵#2 数组 policy: 判坏之后一次写，磁盘上那份文件**逐字节不变**（不覆盖 —— 修复前那次 upsert 直接用原子 rename 把它整个替换掉了）
    FAIL  🔵#3 两因并存: 服务在场却拒注册 **且** 文件损坏 ⇒ 落点行**并陈**两条原因，roster 与 status 逐字同形（修复前：`no-register` 独占一行，把「文件损坏、请人工处理」整条吞掉）

另 3 条修复前即绿 ⇒ **★ 负相**（控制项，作用是让上面那几条红**不是空转的绿**）：`🟡#1 ★ 负相`（钉住夹具真的走了链的 catch 支，且回写照跑、合并结果已落盘）、`🔵#2 ★ 负相`（钉住数组档真的原样在盘上、团队状态照常可写可读）、`🔵#3 ★ 负相`（钉住并陈**只**发生在两因并存时 —— 四种单因形态逐字不变）。同一簇里上一轮的 `🔵#3 ★ 负相`（foldedAt 盖戳门对照项）本轮也保持绿。

**绿相（修复后）**：

    node host-half.test.mjs
    ALL PASS
    assertion total: 1262 (failed: 0)
    node client-half.test.mjs
    ALL PASS
    assertion total: 269 (failed: 0)

判据上一轮已就位（`1262 = 1255 + 7`，本轮**零新增**）；**浏览器半边一字未改**（`client-half.test.mjs` 不动）。实现 3 处（`lib/index.js`，行号为本轮落点）：attach 后置链 catch 支传 `{ foldHappened: false }`（🟡#1，`:1910`）；损坏判据补 `Array.isArray(doc.policy)`、与「缺失 / null」同一条置坏分支（🔵#2，`:1541`）；`policyPlacement()` 的 memory 支带 `also: fileReason`、`policyPlacementLine()` 拼「；另：…」（🔵#3，`:1631`/`:1640`）。

### 同批同步的面

- `docs/policy-persistence-design-2026-09-27.md`：§3.4（损坏判据写明**含数组**；catch 支「宁可漏盖不冒盖」例外）· §3.5（两因并存的并陈形态与优先序）· §5 两处 README 行号漂移（`:1181`→`:1182`、`:1198`→`:1199`）；
- `README.md`：tests 徽章 `1255 → 1262`、Agent Teams 对照表稳定性一格（附本轮红相）、§十「当前读数」`1255 → 1262`（三处读数同批）；
- `CHANGELOG.md`：新增「代码评审第 2 轮」条目（修了什么 → 怎么验证 → 同批同步的面）。

---

## 代码评审第 3 轮（2026-09-27）— `fold failed` 后链尾不回写 / `detach()` 同步置窗口判据

> 逐项收口代码评审第 3 轮的 2 条 🟡 ＋ 1 条文档滞后（报告项）。判据（2 条）先于实现写进 `host-half.test.mjs` 并取红相；命令与判据见 [`policy-persistence-design-2026-09-27.md`](policy-persistence-design-2026-09-27.md) §3.4/§4；本节只放读数。

**红相（本轮实现之前，实跑；断言已就位）**：

    node host-half.test.mjs
    2 FAILURE(S)
    assertion total: 1264 (failed: 2)

红的 2 条（原文）：

    FAIL  🟡#1 fold failed 不回写: 折叠失败（scope.update 抛错）后链尾**不把服务视图写回文件** —— ① 文件里那份逐字节不变（窗口数据仍在落点里）② foldedAt 不重盖 ③ 留痕说「仍在落点里、未并入」与文件实况一致（修复前：内存与文件两边同时抹掉窗口数据，且无归档、还盖新 foldedAt）
    FAIL  🟡#2 detach 窗口判据: 折叠留痕如实说「provider 被 detach 后又回来」—— 不说快路径措辞、也不说成 startup window（修复前：判据不随 detach 复位，走的还是 activation 写下的那一句）；且不给本进程自己写的镜像多归档一份（detach 也是未挂载窗口，判据与 🔵#4 同源）

红相构成如实说明：两条各为**一条综合断言**，控制条件并入同条 —— 🟡#1 以链上 `memory window: fold failed` ＋「文件里仍有 file-team」钉住夹具真落在折叠失败那一支；🟡#2 以 provider2 命名空间里看得到 `detach-window-team` ＋ 链计数 2 钉住折叠真的发生了。本轮**没有**单独的 ★ 负相控制项，不冒充。

**绿相（修复后，实跑；连跑 8 次全绿）**：

    node host-half.test.mjs
    ALL PASS
    assertion total: 1264 (failed: 0)
    node client-half.test.mjs
    ALL PASS
    assertion total: 269 (failed: 0)

基线 `1262` / `269` ⇒ **新增 2 条宿主断言**（`1264 = 1262 + 2`）。实现 2 处（`lib/index.js`）：attach 后置链对 `fold failed` 加门（那一支不回写、另留一行 info 说明；`foldedAt` 盖戳判据收紧为「确已落定」的两个结局）＋ `detach()` 同步置窗口判据（`"detached"` 支与折叠留痕措辞第四支）。

### 夹具侧的一处竞速修复（本轮实测暴露，先于本轮存在）

调本轮红相时连跑套件，发现第 2 轮的 h1 夹具（catch 支盖戳门）在 Windows 上**间歇假红**（5 连跑中 2 次）：它的文件轮询循环（等 `savedAt` 刷新）与链尾回写的原子 `rename` 并发，rename 偶发被拒 —— `EPERM: operation not permitted, rename '…policy.json.tmp' -> '…policy.json'` ⇒ 回写被拒、`savedAt` 永不刷新、两条断言假红。诊断读数（临时注入、已移除）：armed=0（两个 armed warn 都按序消费）、`post-attach policy chain failed` 一行在、`foldedAt` 正确，唯独 `policy file write failed (EPERM …)` 一行在场。**这不是插件缺陷**（catch 支与回写路径本轮一字未改），是夹具自己的读窗口撞上了回写。修法：轮询在 `policy.json.tmp` 在场（回写在飞）时不打开目标文件（先等 `.tmp` 出现、再等它消失，前 10 拍只 stat 不 open）；修后 8 连跑全绿。

### 同批同步的面

- `docs/policy-persistence-design-2026-09-27.md`：§3.4 新 bullet（`fold failed` 不回写 ＋ 盖戳判据收紧）；§4 两条新判据行 ＋ 红相账本补第 2 轮（4 红 ＋ 3 ★ 负相）与第 3 轮（2 红）；§5 host-half 影响面补第 2/3 轮（含本轮新加的 `settingsUpdateThrows` 夹具把手与 h1 竞速修复一句）；
- `README.md`：tests 徽章 `1262 → 1264`、Agent Teams 对照表稳定性一格（附本轮红相）、§十「当前读数」`1262 → 1264`（三处读数同批）；
- `CHANGELOG.md`：新增「代码评审第 3 轮」条目（修了什么 → 怎么验证 → 同批同步的面）。

## 2026-09-27 真机迁移：把宿主配置里的历史团队导入文件后端

**背景**：本部署 `ctx.get("settings")` 拿得到对象但**没有 `register()`**（落点行的原因码 = `no-register`，见本轮改造的「可核落点行」），
所以插件走「未挂载」路径，状态落 `<DSH_HOME>/team-link/policy.json`。宿主的 `cordis.patch.yml` 里存着历史 `team-link.config`（**11 个团队**），本轮把**真团队**导入新落点。

**命令**（一次性手工动作；**代码侧永不读宿主配置**）：Node + `yaml` 解析 `<profile>/cordis.patch.yml` → 取 `team-link.config` → 写 `<DSH_HOME>/team-link/policy.json`（`{schema:1, savedAt, foldedAt:null, policy:{八键}}`）。

**读数（迁移写入时，2026-09-27 18:2x）**：

- **导入**：`threat-intel`（3 角色）· `0921-main`（**7 角色**：coordinator/main/proposals/ops/memory/worker/verifier）· `0922`（2 角色）⇒ 合计 **12 个角色**
- **跳过**（probe / 自测残渣；**源文件原样保留**，随时可补导）：`h1-probe` · `v038-probe` · `v038d-probe` · `dsh-session-link-pro` · `probe-n3` · `rm-probe-20260922` · `rm-release-20260922` · `dsh-session-link-pro-20260922`
- **其它键原样保留**：`rememberTargets` 23 项 · `pairs` **34 项** · `pendingCreates`/`trustedSenders`/`watchdogs` 各 0
- **文件**：`C:\Users\magic\.dsh\team-link\policy.json` · 30,512 字节 · 前 3 字节 `7b 20`（**无 BOM**，Node `fs.writeFileSync`）· `JSON.parse` ✓ · 中文 note 完好（**用 Node 读 UTF-8**，避免 PowerShell 的 GBK 乱码被固化进 JSON）

**待验（下一次重启后）**：`team_link_roster action=get` 的**首行**应为 `存储：文件 C:\Users\magic\.dsh\team-link\policy.json`，且名册里看得见上述三个团队。
（每个 store **只读一次**文件 ⇒ 写入后必须重启才生效。）

**迁移后读数（2026-09-27 20:42，重启后实测）**：

- `team_link_roster action=get` **首行**：`存储：文件 C:\Users\magic\.dsh\team-link\policy.json` ✓（三态可核红线生效）
- 名册：**共 3 个团队** ✓ —— `threat-intel`（3 角色，workspace `D:\workspace\threat-intel`）· `0921-main`（7 角色）· `0922`（2 角色）
- `team_link_status` 首行同形 ✓，且段①来源行已是 `来源：文件 C:\Users\magic\.dsh\team-link\policy.json 的 teams 键` ✓（分歧审计 🔵#9 的修复在真机成立）
- **文件后端是活的（不只是读了静态文件）**：`policy.json` 的 mtime 由写入时的 `18:25:36` 变为 `20:42:36`、大小 `30,512 → 31,865` 字节 ⇒ 插件启动后**自己读过也写过**该文件 ✓
- 启动后文件内容复核：`teams` 仍是那 3 个（12 角色）· `pairs` 34 项 · `rememberTargets` 23 项 · `savedAt` 已被插件刷新（我写入的那个值不再保留，符合 §3.3「每次成功写入刷新」）

**结论**：「团队重启即失忆」这条真机缺陷**闭环** —— 本部署没有可用的 `settings.register()`（`no-register`），状态改由插件自己的文件承载，重启后仍在。

## 2026-09-27 C 批：客户端团队面板（跨半边取数通道）＋ 形态可视化 ＋ 🔵 登记 4 条 / 本批执行 3 条（① 已在上一批修完）

**设计档**：[`docs/client-panel-batch-design-2026-09-27.md`](client-panel-batch-design-2026-09-27.md)（评审 PASS，判据 W1–W9 ＋ C3-a/b/c）。
**改了哪两个文件**：`lib/index.js`（新增只读路由 `GET /team-link/panel` ＋ 面板载荷构造器 ＋ 六处段体渲染器收敛为一处）· `lib/client.js`（新增面板分区；**本批首次动客户端半边**）。

### 起点读数（实现前，基线复核）

- `node host-half.test.mjs` → `ALL PASS` / `assertion total: 1264 (failed: 0)`（退出码 0）
- `node client-half.test.mjs` → `ALL PASS` / `assertion total: 269 (failed: 0)`（退出码 0）
- `git status --short` → 空（工作树干净）

### 红相与绿相（逐条，均为实跑原文）

**C1（W1–W3 · W5–W7 · W9）**

- 红相：`node host-half.test.mjs` → `23 FAILURE(S)` / `assertion total: 1290 (failed: 23)`；红的 23 条全部落在本批新增段内（**W1 前缀 2 条**：路由不存在 · 栅栏逐例同判 · 拒时零面读 · 非 GET 405 · 挂载期成对门；**W2 1 条**：三面逐字同一串；**W3 4 条**：六段齐全 / 降级载体 / 段体同源 / R4 正反例；**W5·W9 3 条**：字节与 mtime 不变 / 台账不变 / 病灶结构锁；**W6 3 条**：原始行同源 / 派生读数逐字同形 / ★ 负相控制；**W7 5 条**：未读标注 / 本面板措辞 / 只读翻页参数 / 翻页只读 / offset 边界）。
- 红相（客户端）：`node client-half.test.mjs` → `4 FAILURE(S)` / `assertion total: 275 (failed: 4)` —— **★ 覆盖缺口，如实标注不冒充**：被测面（`panelUrl` / `panelSections` / 降级句 / `readPanelState`）**尚不存在**，四条命名守卫各自报出缺哪一面；W2/W3/W5/W6/W7 的正相断言因面缺席而**整块未执行**（红线：不把「没实现」伪装成「块被跳过」）。
- 绿相：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1290 (failed: 0)`；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 296 (failed: 0)`。
- **★ 负相（控制项，红绿两相都成立）**：① **不冒充红相**：同一台栅栏、同一条路由，同源已登录时**照常 200**（三条拒绝因此不是「什么都拒」的空断言）；② 同一款夹具走**会写**的那条读路（`team_read` 的惰性清扫）时过期令牌被清掉、落点文件随之改变 —— 所以面板那条「字节与 mtime 不变」不是「夹具里没东西可清」；③ 未读行的两集合都不空、不相交（窗口内 12 条有真 verdict，窗口外 4 条只有「未读」）；④ `team_read` 自己确实给出「最后主张 / 未消解存疑」这对措辞（W6 的同形断言不是「两边都是空」）。

**C2（W4）**

- 红相：`node host-half.test.mjs` → `assertion total: 1295 (failed: 4)`（三态徽标各就位 · form.badges 与行上徽标同源 · 只读宿主零写调用 · 投影缺席**不冒充** ＋ 对照项）；`node client-half.test.mjs` → `assertion total: 299 (failed: 1)`（档位结论在「团队与角色」段**顶部**那一条；徽标渲染与「不冒充」两条已随 C1 的分区渲染就位，故不冒充红相）。
- 绿相：host `1295 (failed: 0)` · client `299 (failed: 0)`。
- **实测判据细节**：投影可读时 `session-pn-lead → agent-team·Lead` / `session-pn-coder → agent-team·成员` / 非成员 `session-pn-00 → 多会话`；投影缺席时非 Lead 一格 = `档位未判定（成员名册读不到：服务 agentTeams 当前不可见…）`、Lead 一格仍 = `agent-team·Lead`（settings 指针，不因投影缺席而少一格）。**★ 负相对照**：同一台宿主、投影可读时同一格是「多会话」⇒ 前者拒的是缺投影，不是「这一格本来就不给」。

**C3（a/b/c）**

- 红相：`node host-half.test.mjs` → `3 FAILURE(S)` / `assertion total: 1299 (failed: 3)` —— **C3-a**（没折叠落定时不得承诺「随后文件会被改写成合并结果」）· **C3-b**（快路径 ＋ fold failed 的归档数与留痕数必须一致且都为 0）· **C3-c**（`setup()` 签名不再压成一整行）。
- 绿相：host `1299 (failed: 0)` · client `299 (failed: 0)`。
- **★ 负相**：同一份种子、`update` 不抛错时**照旧**归档 1 份并留下「折叠存档」那行（本轮只把它挪到折叠成功之后）⇒ C3-b 的「零归档」拒的是「没折叠」，不是「这一段本来就不归档」。

### 六处「一处事实一处渲染」的收敛（本批顺带，防漂移）

`agentStateLabel()` / `sessionFaceLine()` / `teamRoleLines()` / `pendingLines()` / `watchdogLines()` / `tasksDerivedLines()` —— **六处** —— 从「状态卡 / 列表工具 / team_read 各自一份」收敛为**各一处**：状态卡的 ①②③④ 段与 `team_read` 的派生读数段改成调用它们，团队面板读的是**同一批字节**（既有 1264 条断言全绿即证据）。

**输出等价性的口径（分歧审计 🔵#5 收窄，2026-09-27 修复轮）**：对 `ctx.agents.get` 实际会产生的输入（已定义 / `undefined`）**逐字不变**；`null` 一档**不是**逐字不变的 —— 旧列表工具写「○ 空闲」（`running ? "▶ 运行中" : agent !== undefined ? "○ 空闲" : "✕ 未运行"`）、旧状态卡那一格直接抛（`agent.status`），收敛后两种「没有这个代理」统一判「✕ 未运行」。这一档是**行为修正**、不是静默漂移：判据 `🔵#5 null 判据`，标记（「行为修正」）落在 `lib/index.js` 的 `agentStateLabel()` 自己的源码块里。

### 同批文档

- `docs/hardening-and-recovery-design-2026-09-21.md`：§4.3.2 结构行 ＋ 新增 **§4.3.8 团队面板分区**（入口口径的唯一事实源）；
- `README.md`：§二 行为表新增「团队面板分区」行 · `:584` 的「没有任何跨半边取数通道」**前提更正**（结论不变、理由换成可核的那条）· 架构图补两条读路由与面板 · 设计索引 W1–W8 → **W1–W9** · tests 徽章 / 稳定性行 / §十「当前读数」三处读数 `1264 + 269 → 1299 + 299`；
- `docs/client-panel-batch-design-2026-09-27.md`：§3.0.1 回填**实际响应形状**（每段是 `{present, lines, unavailable?}`；`form` / `sessions` 的字段级形状）；
- `CHANGELOG.md`：新增「C 批」条目。
- **未做（如实登记，需父侧处置）**：`docs/policy-persistence-design-2026-09-27.md` §8 表里 ②③④ 仍写「⏳ 后续项」—— 该档不在本批可改文件清单内。

### 本批未重启、未 commit、未留临时文件

工作树只含本批的可改文件；`git status --short` 的读数由宿主在交付后执行（见交付报告的 check summary 列）。

---

## 2026-09-27 C 批分歧审计修复轮（🔵#2/#3/#4/#5）

**设计档**：[`docs/client-panel-batch-design-2026-09-27.md`](client-panel-batch-design-2026-09-27.md)（🔵 的口径与回填以它为准）。
**分歧审计的读数**：审计 **0 🔴** / **4 条 🔵**（🔵#2 账本计数 · 🔵#3 「4 条 / 3 条」口径 · 🔵#4 §8 第 2 问未回填 · 🔵#5 `null` 一格的「逐字不变」声称；另有观察 ③ 只登记）。**只收这 4 条，别处一字不动。**

### 起点读数（修复前，实跑）

- `node host-half.test.mjs` → `ALL PASS` / `assertion total: 1299 (failed: 0)`（退出码 0）
- `node client-half.test.mjs` → `ALL PASS` / `assertion total: 299 (failed: 0)`（退出码 0）

### 红相与绿相（逐条，均为实跑原文）

- **红相（判据先写、实现后到）**：`node host-half.test.mjs` → `1 FAILURE(S)` / `assertion total: 1300 (failed: 1)`（退出码 1），红的恰是 `🔵#5 null 判据`。
  **如实分解（不冒充红相）**：该条的**行为半**在修复前**已经成立**（`agentStateLabel` 本就含 `null` 分支；旧码见 `git show 2bcf496^:lib/index.js`：列表工具 `running ? "▶ 运行中" : agent !== undefined ? "○ 空闲" : "✕ 未运行"`、状态卡 `agent === undefined ? "✕ 未运行" : agent.status === …`）⇒ 这一半是 **★ 负相**；真红的是另外两半，实测读数 `typeof __testing.agentStateLabel = undefined`（**判据面**缺席）与 `agentStateBlock.includes(行为修正) = false`（**标记**缺席），同一次读数里 `agentStateBlock.includes(=== null) = true`（再次证明行为半本就成立）。
- **绿相（实现后）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1300 (failed: 0)`（退出码 0）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 299 (failed: 0)`（退出码 0）。
- **本轮的断言账**：新增 **1** 条宿主断言（`1300 = 1299 + 1`）；客户端套件未动（`299`）。

### 4 条闭环

| # | 审计条目 | 处置（落点） |
| --- | --- | --- |
| 🔵#2 | 账本「计数与列表不一致」：「三处」vs 列表里的六个 | **闭环**：标题与正文同一次编辑改成「**六处**」（本档 C 批小节的 `:2014` 与 `:2043` 两处，as-of 本轮；正文并点出六个函数名）。代码侧改写点确为 6 处 |
| 🔵#3 | 「4 条 🔵」与「3 条 🔵」同批并存 | **闭环**：口径统一为「**登记 4 条 / 本批执行 3 条（① 已在上一批修完）**」—— 设计档标题 / §1 / §5 标题 / §6 / §7.1、README §十 与设计索引行、CHANGELOG（新条目标题 ＋ C 批 ④ 标题）、本节标题同改 |
| 🔵#4 | 设计 §8 第 2 问仍是问句，而代码已作答 | **闭环**：回填「**面板 = 状态卡的 5（同值）**」＋ 实现取数（`rows.slice(-STATUS_TASKS_TAIL_DEFAULT)`、常量 = 5）与「面板路由不收 `tasksTail`」两句口径；§8 标题改为「两问均已回填」 |
| 🔵#5 | 「收敛后输出逐字不变」在 `agent === null` 一格不成立 | **闭环**：① 补 null 判据（先红后绿，读数见上）并把「**行为修正**」标记钉在 `agentStateLabel` 源码块里；为读真函数，`__testing` 开放 `agentStateLabel`（纯函数）；② 本节「六处收敛」那段把「输出逐字不变」**收窄**为「对 `ctx.agents.get` 实际会产生的输入（已定义 / `undefined`）逐字不变；`null` 一档由旧码的『○ 空闲』改判为更正确的『✕ 未运行』」，CHANGELOG 同批 |

### 后续项登记（本批不做）

- 审计观察 ③（`tasksTail` 的两种「不可读」只降级到 lines 文本、`present` 仍 `true`、无断言覆盖）与本轮新核实的一条收敛残渣（`lib/index.js` 列表工具里的死局部 `const running = …`，as-of 本轮 `:10826`）—— 两条都写进设计档 **§8.1 后续项登记**，**本批不动**。

### 同批文档

- `docs/client-panel-batch-design-2026-09-27.md`：口径**五处**（标题 / §1 一句话 / §5 标题 / §6 分期 / §7.1）· W8 行的当前读数 · §8 第 2 问回填 · 新增 §8.1；
- `README.md`：tests 徽章 / 稳定性格 / §十「当前读数」**三处读数** `1299 → 1300`（`1300 = 1264 + 35 + 1`）· 设计索引行口径；
- `CHANGELOG.md`：新增「C 批分歧审计修复轮」条目 ＋ C 批标题与 ④ 的口径；
- 本节。

### 本轮未重启、未 commit、未留临时文件

工作树只含本轮的可改文件；`git status --short` 的读数由宿主在交付后执行（见交付报告的 check summary 列）。


**⚠ 提交归属更正（2026-09-27，父侧自记）**：提交 `2bcf496` 的消息只写了「§8 三行遗留随 C 批闭合」，但该次用了 `git add -A` ⇒
**实际一并提交了 C 批实现的 9 个文件**（`lib/index.js` / `lib/client.js` / 两个套件 / README / CHANGELOG / 本账本 / C 批设计档 / hardening 设计档）。
**以本注记为准**：C 批的实现内容在 `2bcf496`，其后的修复轮内容在紧随的提交里。公开历史按用户裁定（选项 A）**不改写**，故以更正注记代替。

---

## 2026-09-27 C 批代码评审修复轮（🟡#1/#2 ＋ 🔵#3/#4/#5/#6）

**设计档**：[`docs/client-panel-batch-design-2026-09-27.md`](client-panel-batch-design-2026-09-27.md) §9（本轮口径与闭环表以它为准）。
**评审读数**：C 批交付**代码评审 PASS、零 🔴**；6 条 = **2 🟡 ＋ 4 🔵**。**只闭环这 6 条，不夹带**；改动面 = `lib/index.js` / `lib/client.js` / `host-half.test.mjs` / `client-half.test.mjs` ＋ 文档四处。

### 起点读数（修复前，实跑）

- `node host-half.test.mjs` → `ALL PASS` / `assertion total: 1300 (failed: 0)`（退出码 0）
- `node client-half.test.mjs` → `ALL PASS` / `assertion total: 299 (failed: 0)`（退出码 0）

### 红相与绿相（实跑原文）

- **红相（判据先写、实现后到）**：`node host-half.test.mjs` → `5 FAILURE(S)` / `assertion total: 1306 (failed: 5)`（退出码 1），红的五条 = `🟡#2 翻页不回卷` · `🟡#2 ★ 负相（两页夹具末页）` · `🔵#3 降级句随页走` · `🔵#4 派生行带团队归属` · `🔵#4 归属头只是面板加的那一层`。
  `node client-half.test.mjs` → `4 FAILURE(S)` / `assertion total: 305 (failed: 4)`（退出码 1），红的四条 = `🟡#1 面板类名 ↔ 规则` · `🟡#1 台账行/落点行保留缩进` · `🔵#6 React key` · `🔵#5 wellFormed`。
  **如实分解（不冒充红相）**：本轮 12 条新判据里 **9 条实测红**；另 **2 条是控制 / 对照项（★ 负相，修复前即绿）** —— `🔵#6 ★ 负相（walker 数得出缺 key 的节点）` 与 `🔵#5 对照（没有孤立代理项的响应逐字原样渲染）`。第 3 条不红的判据如实标注：`🟡#2 第 25 行起可达（沿**按钮链**走）` 是**实现之后补强**的形态（首跑红相里它还是旧版「三页读窗并集」写法、首跑即绿），**未取得红相读数**，不冒充。
- **绿相（实现后）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1306 (failed: 0)`（退出码 0）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 305 (failed: 0)`（退出码 0）。
- **本轮的断言账**：host 新增 **6**（`1306 = 1300 + 6`）；client 新增 **6**（`305 = 299 + 6`）。

### 6 条闭环

| # | 评审条目（带行号，as-of 修复前） | 处置（落点） |
| --- | --- | --- |
| 🟡#1 | 面板 13 个 `.dshsl-pn-*` 类一条 CSS 规则都没有（`lib/client.js:57-131` 只定义了别的类；`:92-100` 自己定性过这个缺陷类别） | **闭环**：样式数组末尾补 13 个类的规则（`.dshsl-pn-line` / `.dshsl-pn-placement` 带 `white-space:pre-wrap`；徽标、段落间距照 `.dshsl-relay*`）＋ 源码级对照判据（`className:` 里的每个 `dshsl-pn` 类都要按选择器找得到规则；两侧集合非空）。徽标**一条规则、不按 `data-badge` 分色**（不重复宿主档位词汇，避免踩 W4 源码级代理锁） |
| 🟡#2 | `lib/index.js:11365-11371` 的 `firstUnread` 让第二页起 `nextOffset=0`（翻页回卷；>24 个会话时第 25 行起 UI 不可达） | **闭环**：改「当前页之后」——`windowEnd = 本页 offset + 本页读窗行数`，`>= shown.length` 时 `null`（客户端隐藏按钮）；`firstUnread` 这行删除（`listReadTail` 自带它的提示句，一字未动）。判据：三页逐页前进 12 → 24 → null、**沿按钮链**走完 36 行、两页夹具末页也隐藏 |
| 🔵#3 | `lib/index.js:147` 降级句写死「前 12 行」，分页时读的是 13–24 行 | **闭环**：新增 `panelWindowNote(offset)`（第一页字节不变；分页页说「本面板本次只读了 12 行，从第 13 行起」）＋ 判据（第一页 24 行未读句仍是旧措辞；第二页 24 行未读句改成点名本次这一页） |
| 🔵#4 | `lib/index.js:11317` 各团队派生行顺序拼接、不带团队归属 | **闭环**：新增 `teamDerivedLines(teamName, derivedLines)`（块首 `- <team>/tasks.md：` ＋ 续行四空格；行体逐字仍是 `tasksDerivedLines()` 的字节）＋ 两条判据（两支队伍各有自己的归属头；第二队那一块的行体逐字出现在**它自己**那份 `team_read` 输出里）。W6 判据同步改紧：剥掉归属头后逐字同源 |
| 🔵#5 | `lib/client.js:2187` / `:2214` 把宿主字节直接 `createElement`，未过 `wellFormed()`（`:312`） | **闭环**：面板每一个宿主字符串出口都过 `wellFormed()`（落点行 / 段行 / 档位结论 / 徽标标签 / 台账尾 / 派生行 / 会话行 / 段尾 / 缺段句 / 整页降级句）＋ 判据（八处各塞一个半对代理，渲染出的每一段文本都不含孤立代理项）＋ 对照项（无代理项时逐字原样） |
| 🔵#6 | `:2214` / `:2216` / `:2218` / `:2220` / `:2228` 五处 `push` 缺 React `key` | **闭环**：补齐这 5 处；**同一缺陷类余下 5 处一并补齐**（段标题 `h3` / 缺段句 / 档位结论 / 徽标 `span` / 面板根 `div`）⇒ 判据写成「整棵面板子树 key 完备」（比点名的 5 处更紧）＋ walker 控制项。评审点名的 5 处与同类余下 5 处在交付报告里点名列清 |

### 未做（如实登记）

- **真机 DOM 冒烟**：本轮三条里的 🔵#1 是**源码级**判据（类名↔规则）；🔵#5 / 🔵#6 读的是 stub 树 —— 浏览器里的实际排版（`pre-wrap` 下的缩进对齐、徽标圆角）与 React 的「unique key」警告**没有实测**。
- **不新增翻页导航**：只修回卷；「上一页 / 页码」属于交互设计，不在评审 6 条内（登记在设计档 §9.4）。
- 未重启进程、未 commit、未留临时文件；工作树只含本轮可改文件，`git status --short` 由宿主在交付后执行。

### 同批文档

- `docs/client-panel-batch-design-2026-09-27.md`：**W8 行**读数（host `1300 → 1306` / client `299 → 305`）· 新增 **§9**（六条闭环表 / 三条口径 / 判据与读数 / §9.4 登记）；
- `README.md`：tests 徽章 / 稳定性格 / §十「当前读数」**三处**读数 `1300 → 1306`、`299 → 305`（**本批唯一一处越出「可改文件清单」的改动，事由是读数失准，已在交付报告里点名**）；
- `CHANGELOG.md`：新增「C 批代码评审修复轮」条目；
- 本节。

## 2026-09-27 C 批交付评审修复轮：作业 failed，父侧代验（诚实记账）

- **作业结局**：`eng-dsh-7`（C 批交付评审 6 条修复轮）= **failed（error）**，落盘报告为**空壳**（`Partial output:` 为空 ⇒ 无崩因、无红相读数）。
- **父侧代验（我实跑，命令与原文）**：
  - `node --check lib/index.js` / `lib/client.js` → exit 0
  - `node host-half.test.mjs` → `ALL PASS` / `assertion total: 1306 (failed: 0)`（exit 0）
  - `node client-half.test.mjs` → `ALL PASS` / `assertion total: 305 (failed: 0)`（exit 0）
  - 基线 1300 / 299 ⇒ **+6 / +6**（新增断言：host 7 / client 6）
- **6 条落地核对**（源码级）：`.dshsl-pn-*` 规则 **14 条** ＋ `pre-wrap` ×10 · 翻页算法重写（含旧缺陷注释 ＋ `sessionSegment.page`）· `PANEL_LV_WINDOW_NOTE` 新措辞 · `teamDerivedLines(team.name, …)`（派生行带团队归属）· `wellFormed` ×30 · 16 处带 `key`。
- **断言分量（父侧读源码核）**：类名↔规则那条自带「**两侧集合都非空**（不是两边都空所以相等）」的空转守卫；`key` 那条带 **★负相 walker**（证明它真数得出缺 key 的节点）；`wellFormed` 那条在**八处**各塞一个半对代理项 ＋ 一条「正常字节不被改掉」的对照。
- **诚实缺口**：本轮的「**修复前必红**」读数随作业失败**丢失**（未做单点变异取证）；**评审第 2 轮**因 `DeepSeek Messages transport failed` 未完成（按纪律不重试；用户授权后补跑**一次**）。
- **保险**：`refs/wip/cbatch-fix-20260927` = `4ba403c`（`git stash create`，不碰工作树）。

## 2026-09-29 DSH 0.2.0-rc.1 兼容性闸门：dsh-team-link 被整个跳过（peer 区间修复）

- **症状（用户报告）**：桌面版升级后本插件「没加载进来」—— 10 个 `team_link_*` 工具一个都不在会话工具表里，GUI 无任何提示。
- **换代窗口（实跑读数，闭合）**：
  - `%LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\pending\deepseek-harness-0.2.0-rc.1-win-x64.exe`（288 MB）**下载于 13:54:41**；同目录 `installer.exe` **落盘于 14:06:21**（静默安装）。
  - `DeepSeek Harness.exe` / `resources/app.asar` 的 **CreationTime = 14:10:07 / 14:10:08**（`LastWriteTime` 是构建时间 `2026/9/28 20:28:10`，会被误读成「昨天就装了」，**看 CreationTime**）；宿主进程 CreationDate = **14:10:45 / 14:10:48**。
  - **升级前**的崩溃日志一律写 `app: @deepseek-ai/dsh-desktop 0.1.7-rc.2` —— 共 5 份，最近两份是本地 13:57:01 / 14:08:27（文件名里的 UTC 写作 `05-57-01Z` / `06-08-27Z`）。换代发生在这两份之后、14:10:45 之前。
  - 三代版本号三处一致：exe `FileVersion` = 0.2.0-rc.1 · `app.asar/package.json` = `@deepseek-ai/dsh-desktop` 0.2.0-rc.1 · `resources/runtime/primary-runtime/runtime.json` 的 `desktopVersion` = 0.2.0-rc.1。**闸门真正比对的运行时版本另取一处**：`dsh/node_modules/@deepseek-ai/dsh-app-boot/package.json` 的 `version` = **0.2.0-rc.1**（`getDshRuntimeVersion()`，`dsh-app-boot/lib/index.js:271-275`）—— **不是**桌面壳的版本号。
- **闸门定位（源码逐字复刻）**：
  - `dsh-desktop-host/lib/index.js:221` `loadProfileDirectory("dsh", projectDir, installAnchor)` → `:222` `reportSkippedBundles("dsh", profile)`；`loadProfileDirectory` 在 `dsh-app-boot/lib/index.js:925-945`：逐 bundle `resolveBundleDir` → `readProfileManifest` → **`evaluatePluginCompatibility(bundleManifest, exemptions)`（`:930`）**，`issue !== undefined && !issue.exempted` 即 `throw`（`:931`）。
  - `evaluatePluginCompatibility`（`:286-313`）：**只查**名为 `@deepseek-ai/dsh` 或前缀 `@deepseek-ai/dsh-` 的 peer（`:294`），逐条 `semver.satisfies(runtimeVersion, requirement, { includePrerelease: true })`（`:300`），**任一条不满足**即记入 `peers` 并返回 issue。
  - `throw` 被同一函数的 `catch` 吞掉，推入 `skippedBundles`（`:940-945`）—— **`layers.push` 在闸门之后（`:934-939`），故该 bundle 的 patch 层完全不参与组合**；`cordis.patch.yml` 的 `- id: team-link` 于是指向一个从未存在的 entry。
  - 通知面只有 stderr：`reportSkippedBundles()`（`:515-516`）；桌面壳把宿主 stderr 留在内存 64 KiB 环形缓冲（`lib/main.js:3638` / `:3694`），**仅在宿主异常退出时**随崩溃报告落盘（`:3723` / `:7396`）⇒ 健康运行时的跳过用户侧零提示。
  - 豁免文件 `compatibility.json`（`PROFILE_COMPATIBILITY_FILENAME`，`:328`）在 desktop profile 里**不存在** ⇒ 零豁免（`readProfileCompatibility()` `:359-375` 的 ENOENT 分支 ⇒ `exemptions: {}`）。
- **上游服务来源（复核 inject 是否仍可满足）**：`tools` ← `dsh-base/cordis.patch.yml:499`；`sessionQuery` ← `:149-150`（`dsh-session-query-sqlite`）；`sessionReferenceResolver` ← `dsh-web-app/cordis.patch.yml:94-95`（`dsh-session-reference`）；`agents` ← `dsh-base/cordis.patch.yml:74-75`（`dsh-agent`）。desktop profile 的 `dsh.profile.bundles` 同时含 `dsh-base` 与 `dsh-web-app` ⇒ 四项齐备。
- **修复前读数（实跑，闸门复刻脚本）**：`dsh-team-link@0.4.0` 落在 **SKIPPED**，理由 = 7 条 `@deepseek-ai/dsh-*` peer 全部为 `^0.1.0-rc.6 || ^0.1.5-rc.1`；本轮 **SKIPPED = 14 / PASSED = 15**。同轮被跳过的另有 13 个：`dsh-better-sidebar@0.22.1` · `@deepseek-ai/dsh-token-cost@0.1.0` · `dsh-find-plugin@0.4.0` · `dsh-config-manager@0.1.65` · `dsh-dream-skin@9.27.1` · `@zseven-w/dsh-openpencil@0.1.0-rc.9` · `dsh-ui-ux-pro-max@1.0.2` · `@nagi-ovo/dsh-visualize@0.1.3` · `@yuxianglin/dsh-bridge-browser@0.0.3` · `@changfenhuang/dsh-genui@0.11.2` · `dshmarket@1.66.3` · `dsh-pet@0.2.12` · `dsh-rewind-plugin@0.12.2`。
  - **行为侧旁证（非源码级）**：`dsh-pet` 的 electron helper（userData `%APPDATA%\dsh-pet-electron-helper`）最后写入于本地 **14:07:45 / 14:08:18**（旧宿主最后一次运行），14:10 换代重启后**再未启动**（进程表里没有 pet/helper 进程）。
- **semver 判据本身（实跑）**：`semver.satisfies('0.1.7-rc.2', '^0.1.0-rc.6 || ^0.1.5-rc.1', { includePrerelease: true })` → **true**（所以旧宿主上一直是好的）；同一区间对 `'0.2.0-rc.1'` → **false**（`^0.1.5-rc.1` 展开 = `>=0.1.5-rc.1 <0.2.0`）。
- **0.2.0-rc.1 兼容性复核（静态，逐项对源码行；结论：四项硬注入服务与全部调用面都在、形状未变）**：
  - `tools`：`super(ctx, "tools")` `dsh-tools/lib/index.js:2704`；`register(definition)` `:2878`（插件调用点 10 处）。
  - `sessionQuery`：`super(ctx, "sessionQuery")` `dsh-session-query/lib/index.js:1046`；`listSessions(signal)` `:1070` · `readSession(sessionId)` `:1079` · `filterSessions(filters, signal)` `:1094` · `readTitleSnapshots(sessionIds, signal)` `:1127` · `readSurface(sessionId)` `:1166`。
  - `sessionReferenceResolver`：`super(ctx, "sessionReferenceResolver")` `dsh-session-reference/lib/index.js:440`；`prepare(agent, content, references, signal)` `:606` —— 与插件调用点 `lib/index.js:351` 逐字同形。
  - `agents`：`super(ctx, "agents")` `dsh-agent/lib/index.js:332`；`create(options)` `:451` · `resume(options)` `:464` · `get(id)` `:594` · `list()` `:612` · `roots()` `:621`。
  - 晚挂 / 可选服务：`settings` `dsh-settings/lib/index.js:330` · `goals` `dsh-goal/lib/index.js:592` · `webServer` `dsh-host-webserver/lib/index.js:158` · `connection` ＋ `requestRejection(request)` `dsh-client-connection/lib/index.js:566 / :586` · `workspaceRegistry` `dsh-workspace/lib/index.js:374` · `systemPrompt` `dsh-system-prompt/lib/index.js:213` · `agentDefaultModel` `dsh-agent-default-model/lib/index.js:27`。
  - 过滤描述符形状未变：`dsh-session-query/lib/index.js:753` `case "id": return (record) => filter.values.includes(record.header.id);`，`copyStrings` 要求 `values` 为字符串数组（`:791-793`）—— 与插件 `lib/index.js:6647` 的 `[{ kind: "id", values: [incumbent] }]` 同形。
  - peer 包版本核对（`dsh/node_modules/@deepseek-ai/*/package.json`）：`dsh-api-session-controller` / `dsh-api-workspace-controller` / `dsh-client-locale` / `dsh-client-ui-conversation` / `dsh-client-ui-workspace` / `dsh-session-reference` / `dsh-tools` 全部 **0.2.0-rc.1**；`cordis` **4.0.4**（仍满足 `^4.0.1`，故该条 peer 不动）。
- **修复后读数（同一脚本，实跑）**：`dsh-team-link` → **PASSED**；**SKIPPED 14 → 10 / PASSED 15 → 19**。差额 4 = 本条 ＋ `dsh-better-sidebar`（0.22.1 → **0.24.1**）＋ `dsh-config-manager`（0.1.65 → **0.1.66**）＋ `dshmarket`（1.66.3 → **1.66.5**）—— 后三者在本轮期间**由用户侧更新**（区间分别已是 `^0.2.0-rc.1` / `>=0.1.0-rc.6 <0.3.0-0` / 补了 `^0.2.0-rc.1`），**不是本条的改动**。
- **套件读数（实跑，实现文件零改动）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1306 (failed: 0)`（退出码 0）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 305 (failed: 0)`（退出码 0）。**断言总数不变**（本轮不新增断言，故 README §十 的两处读数不动）。
- **改动面**：`package.json`（7 条 peer 区间补 `|| ^0.2.0-rc.1`）· `README.md`（依赖声明一节的区间句 ＋ 新增一段「区间同时是能不能装上的开关」）· `CHANGELOG.md`（新增未发布条目）· 本节。
- **真机读数（重启后，实调 —— 本节唯一一处非静态证据）**：DSH 以 0.2.0-rc.1 重启后，只读工具 `team_link_status` 成功返回整张状态卡（读数时点 **2026-09-29 15:01:24**）：**首行**是三态之一的 `存储：文件 C:\Users\huangchaowen\.dsh\team-link\policy.json`（AGENTS.md §七 的红线：落点可核的唯一用户可见出口），名册读回 `threat-intel` 的 3 个角色（coordinator / worker-a / worker-b，与 2026-09-28 01:04:47–01:04:52 的登记一致），形态段读出 `形态=sessions`，宿主 `agentTeams` 投影可读。⇒ **工具面回归 = 修复生效的实测证据**（bundle 被跳过时工具根本不在表里，调不到）。
- **未做（如实登记）**：未 commit、未留工作树内临时文件（三份临时脚本在 `%TEMP%`：`asar-probe.mjs` / `compat-check.mjs` / `session-scan.mjs`）；**客户端半边（侧栏团队面板）未做真机 DOM 冒烟** —— 本次验到的是宿主工具面。
- **同一条闸门的其余受害面（不在本仓改动范围，登记备查）**：修复后仍被跳过的 **10** 个 bundle —— `@deepseek-ai/dsh-token-cost@0.1.0` · `dsh-find-plugin@0.4.0` · `dsh-dream-skin@9.27.1` · `@zseven-w/dsh-openpencil@0.1.0-rc.9` · `dsh-ui-ux-pro-max@1.0.2` · `@nagi-ovo/dsh-visualize@0.1.3` · `@yuxianglin/dsh-bridge-browser@0.0.3` · `@changfenhuang/dsh-genui@0.11.2` · `dsh-pet@0.2.12` · `dsh-rewind-plugin@0.12.2`。
- **更正注记（本次落账时由代码评审发现；原文不修 —— 本档只追加）**：本档「2026-09-27 C 批交付评审修复轮：作业 failed，父侧代验」一节里那行 `基线 1300 / 299 ⇒ **+6 / +6**（新增断言：host 7 / client 6）` **自相矛盾**：括号里的 **host 7** 与同一行的 `+6`、「C 批代码评审修复轮」一节的 `host 新增 6（1306 = 1300 + 6）`、以及 `CHANGELOG.md` 的 `host 1306 = 1300 + 6` 三处都不符。本次实跑复核 2026-09-29 的两条总数读数（`host 1306 (failed: 0)` / `client 305 (failed: 0)`）与 `+6 / +6` 一致，**「host 7」没有任何独立读数支持**。此处只登记这处矛盾、**不改写原文**（该轮中间态随作业 failed 丢失，`host 7` 究竟是不是笔误、以及是否有一条断言被合并/删除，需要 `09638ae` 的父提交才能算出）。
- **同轮追加：发布收口为 0.4.1**（用户指令「版本提升」）。`package.json` bump 到 **0.4.1**；按本档惯例把累积的 **10** 个「未发布」条目一次性收口进新的 `## 0.4.1 — 2026-09-29` 一节（`## 未发布 — ` → `### `，10 个顶层标题逐个改）。**同批修正因折叠而失解析的正文指针**：`CHANGELOG.md` 的「见上方「未发布」那节」→「分歧审计修复轮 `DIVERGENCE(10)`」（该节确有 ①）；另两处「未发布 — 真机冒烟修复轮（L1 时基 / L2 镜像）」→ 去掉前缀 —— **这两处自 0.4.0 折叠起就已失解析，非本轮引入**，本轮顺手一并修好。README 同步四处：版本徽章 `0.4.0 → 0.4.1`、**新增「宿主版本支持」一节**（支持矩阵 ＋ 低于 v0.2.0-rc.1 的指引）、「团队面板分区」行去掉 `未发布`、账本索引行 `0.3.1 → 0.3.10（未发布）` → `0.3.1 → 0.4.1`。`AGENTS.md` §四 新增规则「宿主换代必复核 peer 区间」（指针指向本档本节与 README 的「宿主版本支持」一节）。
  **收口后复核（实跑）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1306 (failed: 0)`（exit 0）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 305 (failed: 0)`（exit 0）；CHANGELOG 顶层折叠条目 **10**（与 0.4.1 收口引言声明的「10 个」一致）· 残留 `## 未发布` **0** · 全库失解析的 `未发布 — ` 指针 **0** · README 残留 `未发布` **0** · U+FFFD **0**（五个文件）· `package.json` 前 3 字节 `7B 0D 0A`（无 BOM）且 `JSON.parse` 通过。
  **发布动作（同轮执行完毕）**：commit **`3d7a516`**（5 文件，+116/−27）→ 附注 tag **`v0.4.1`** → `git push origin main` + `git push origin v0.4.1` → GitHub Release **`v0.4.1`**（`gh release list` 标记 **Latest**）。
  **另外补打了 `v0.4.0`**：远端此前只有 `v0.3.7` / `v0.3.8` / `v0.3.10`，**没有任何 `v0.4.0` tag**，而本档同轮写进 README 的「宿主版本支持」要求老宿主留在 0.4.0 ⇒ **那条指引原本不可寻址**；现补 tag（指向发布提交 `d6c2484`）＋ 建 Release（`--latest=false`，不抢 Latest）。若不需要可 `git push --delete origin v0.4.0`。
  **npm 未发布**：`npm view dsh-team-link` → **404**，本仓不在 npm 上 ⇒ 本仓语境里的「发布」= commit ＋ tag ＋ GitHub Release。
  **收尾读数**：`git status --short` 干净 · `git rev-list --left-right --count origin/main...main` → `0 0` · 远端 tag 集合 = `v0.3.7` / `v0.3.8` / `v0.3.10` / `v0.4.0` / `v0.4.1`。
- **同轮追加 · 代码评审第 2 轮 🟡#1 已闭环（我写错的一处声称）**：README「宿主版本支持」表原先写「0.4.1 与 0.4.0 的**实现文件逐字节相同**，本版只多了区间分支」—— **是假的**。实测取证：`git merge-base --is-ancestor d6c2484 HEAD` → **exit 0**（0.4.0 抬升提交 `d6c2484` 是 HEAD 的祖先）；`git diff --stat d6c2484 HEAD -- lib/` → `lib/client.js` 292 行、`lib/index.js` 966 行（合计 **1188 增 / 70 删**）；`lib/index.js` 的 sha256 **`071f3269d89c3881…` → `860d51d7fef54d13…`**。**根因（如实写）**：说这句话时脑子里的对象是**本节的 peer 区间修复**（那一条确实零实现改动），却被写成了**整版**的等价性声明，而 0.4.1 收口了 0.4.0 之后累积的 10 个条目（其中 `feat(persistence)` `4d8f54a` 与两轮面板修复都改了实现）。**修法**：该行改为「区间仍声明支持（`^0.1.x` 未撤，装得上），但本版含 0.4.0 之后 10 个条目、实现相对 0.4.0 有实质改动（1188 增 / 70 删，sha256 亦不同），本轮只在 0.2.0-rc.1 上实测」；同段「请使用 `0.4.0` **那个 release**」改为「请使用 `0.4.0` **版**」—— 本仓只有 `v0.3.7` / `v0.3.8` / `v0.3.10` 三个 tag，**没有 `v0.4.0` tag**，说「release（可下载产物）」无据。CHANGELOG 的 0.4.1 收口引言同步收紧（「仍能通过闸门」取代「仍可正常加载」）。
  **这条修正让用户面的指引反而更硬**：老宿主留在 0.4.0 不是「无代价的保守选择」，而是避开一整批未在 0.1.x 上复测的实现改动。

---

## 2026-09-29 DSH 0.2.0-rc.1 preset pin 换代（`standingKeyFor` → `acquireScope`）

> 同日**第二处** 0.2.0-rc.1 换代断层（第一处是上午的 peer 区间闸门，见上一节——那条让插件装得上，本条让它用得了）。触发面：真机 `/team_session`（团队 mal-analyze-cli-20260929，`n=4 准备接手继续开发`）两次失败（15:35:40 / 15:46:18），回执「批量建队未全部成功」。

- **取证链（全部只读，改动前）**：① 调用方会话日志 `team_link_export` 导出 → `command/done kind=error` 原文逐字 `- worker-1 → team-link-…-worker-1-356b450e：未创建（创建失败（agentPresets.standingKeyFor is not a function））`，worker-2/3/4「前一个 create 失败后按『失败即停』未尝试」；② `policy.json`：`teams` 无该团队（只有 threat-intel），`pendingCreates` 恰两张 worker-1 孤儿票据（TTL 5 分钟，各随本次失败产生，过期清扫自理）；③ 全 `.dsh` 会话树零 `team-link-*` 目录（会话从未落盘）；④ 宿主 `app.asar` 文本检索：`standingKeyFor` **零命中**，官方模板（`createWebhookSession`）同一时序为 `resolve → acquireScope(preset.id)`（`AsyncDisposable`，`:1030872-1030877`）`→ mount`，注册面签名 `async acquireScope(id?): Promise<{ key: ScopeKey } & AsyncDisposable>`（`:293284-293285`）。⇒ 插件按 0.1.x 模板写的 pin 调用，撞上 0.2.0-rc.1 的运行时改名；且默认测试桩此前**只有** `standingKeyFor`，自家套件验不出这层断层（镜像盲区）。
- **修法**：`buildTeamSessionCreateOptions` 的 pin 调用改**双代兼容**——`acquireScope` 在场优先 / 否则回退 `standingKeyFor` / 双缺显式抛错点名断层（批次报可行动原因，不再让裸 TypeError 当文案）；scope 沿既有形状只确认「取得到」、不提前 dispose。改动面：`lib/index.js` 1 处 ＋ `host-half.test.mjs`（`makeAgentPresets` 的 `pinSurface` 四档 + `agentPresetsOptions` 透传 + 4 条新断言）。
- **红相（实跑，夹具先行、实现未动）**：默认夹具换成 0.2.0-rc.1 形状后，套件复刻真机——多条 FAIL 后以 `TypeError: Cannot read properties of undefined (reading 'roles')` 中止于 U16 端到端（`okEnv.store()[0]` undefined＝团队零落地的直接后果），可见与真机**逐字相同**的 `创建失败（agentPresets.standingKeyFor is not a function）`；套件中止故无完整 failed 计数（自报计数只在结尾打印，如实登记）。
- **绿相（实跑）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1310 (failed: 0)`（1306 + 4）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 305 (failed: 0)`；退出码均 0。
- **同批文档**：README 徽章与 §十 当前读数（1306 → 1310，另两处 `1306 + 305 条断言` 领头计数同改）· CHANGELOG「未发布」新条目 · 本节。
- **真机待验（如实登记）**：插件代码随 DSH boot 加载，**重启 DSH 后由用户重发 `/team_session`** 方可闭环；本轮真机证据只有故障面本身。

---

## 2026-09-29 preset 租约释放（同日补：`acquireScope` 是租约，不是可以丢掉的返回值）

> 承接上一节的**更正注记**（本档只追加，原文不修）：上一节「修法」里那句「scope 沿既有形状只确认『取得到』、不提前 dispose」**不成立** —— 它把 `acquireScope` 当成了 `standingKeyFor` 的纯改名。宿主注册面的实现是 `retain(id)` ＋ 一个 `[Symbol.asyncDispose]` 句柄（`users--` ＋ `collect()`），文档原话「**A revision lease; dispose it after the scoped read completes**」。丢掉返回值 ⇒ **每建一个会话泄一个租约**：该 generation 的 `users` 永不归零、`collect()` 永不执行。

- **判据来源（可复核）**：`dsh/node_modules/@deepseek-ai/dsh-agent-preset-registry/lib/index.js:772-788`（`acquireScope` 实现：`retain` ＋ `[Symbol.asyncDispose]` 里做 `generation.users--` 与 `collect`）；官方调用点 `dsh/node_modules/@deepseek-ai/dsh-webhook/lib/index.js:158`（`__addDisposableResource(env_1, await ctx.agentPresets.acquireScope(preset.id), true)`）→ `:216`（`finally` 里 `__disposeResources`）；`standingKeyFor` 在宿主内**零命中**（对 `app.asar` 文本检索）。
- **修法**：照官方模板同一时序 —— 构建器只**取**，可释放句柄经 Symbol 带外通道（`PRESET_SCOPE_RELEASE`）随 options 交给调用方；`createRootAgent` 在 `agents.create` 的 `finally` 里释放（`setup` 里那次 `mount` 在 create **期间**跑，租约必须活到那一刻）。释放失败只留一行 warn，绝不覆盖 create 的原始错误；旧代（`standingKeyFor` 返回纯值）**不伪造** dispose。Symbol 对宿主 `create` 不可见（只读具名键）、对 `Object.keys` / 展开 / `JSON.stringify` 也不可见 ⇒ options 的**可见形状**与既有断言一字不变。
- **夹具同步（本轮的重点）**：桩的 `acquireScope` 原先只返回 `{ key }` —— 只镜像自家实现的调用面，于是「永不释放」这层缺陷被永久挡在套件外（与上一节「桩里只有自家在调的方法名」是**同一个盲区**，只是这次挡的是泄漏、不是改名）。现在连句柄一起建模（`[Symbol.asyncDispose]` ＋ `released` 读数）。
- **新增 4 条宿主断言（可 grep）**：`pin 换代（租约必须释放）` / `pin 换代（失败也要还）` / `pin 换代（旧代不伪造释放）` / `pin 换代（句柄幂等 · 控制项）`。
- **红相（实跑）**：摘掉调用方的释放（＝只改名不还租约）⇒ `FAIL pin 换代（租约必须释放）` ＋ `FAIL pin 换代（失败也要还）`，`host 1314 (failed: 2)`；另 2 条在两种状态下都该绿（旧代形状 / 幂等控制项），**如实记，不冒充 4/4**。还原后 `lib/index.js` sha256 `D078611F61F6D074836CF52CC2AA1F4EBF8521EDAF306AA1D3231ABCB661C8FE` byte-identical。
- **绿相（实跑）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1314 (failed: 0)`；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 310 (failed: 0)`；退出码均 0。

---

## 2026-09-29 客户端团队面板可读性重设计（owner 截图反馈）

> owner 原话：「团队出来了，但是基本不可读，你自己看图，超长文字弹窗超长，而且文字太密集太多根本不知道应该看哪里」。诊断结论：不是没渲染，是**信息架构** —— 五段默认全展开、段标题与正文同为 12px/600 与 12px/400、面板无高度上限（弹窗跟着长）、三行角色文本每行 ~120 字且同一串 session id 写了两遍。

- **诊断方法（模型看不见真机 GUI ⇒ 先造可复现夹具）**：用**逐字复制的面板样式块** ＋ **真实 payload**（`team_link_status` 的实际输出）搭独立 HTML 夹具，浏览器渲染后量测；再用视觉桥（`vision-bridge` CLI，qwen3.7-plus）独立判读 —— 改前判「非常拥挤，有密集文字墙，角色描述非常拥挤」。
- **实测读数（夹具，452px 宽）**：改前 `452×941`（面板自身 782px，无上限）；改后默认态 `452×406`、展开态 `452×425`（面板 `max-height:min(46vh,420px)` ＋ 内部滚动）。**5 个板块标题一屏全可见**（改前只有 2 个：`teams` 段独自吃掉 358px / 视口 378px，后三段标题被挤出滚动区）。视觉桥改后判「**没有密集文字墙，界面非常简洁**，5 个板块一眼列全，第一眼落在首项」。
- **一处过程更正（我自己的错，如实登记）**：夹具第一版把 `team_link_status` **工具输出**的长标题（如「看门狗（policy.watchdogs；…）」）当成了面板标题抄进去，据此差点去「修」一个不存在的问题 —— 面板标题来自客户端字典，本来就是短串（`panelWatchdogs: "看门狗"`）。改夹具对齐真值后复测。
- **改法**（`lib/client.js`，纯呈现，**不解析宿主字节**）：① 面板加 `max-height` ＋ `overflow-y:auto`；② 段标题升 13px/600、独立一行、带 `::before` 折叠标记，`h3` ＋ `role="button"` ＋ `aria-expanded` ＋ Enter/Space；③ **默认全部折叠**（`data-collapsed` ＋ 一条 CSS 规则 `.dshsl-pn-sec[data-collapsed="true"]>:not(.dshsl-pn-h){display:none}` —— 节点全在树里，只是不显示）；④ 段间分隔线、结论行左侧色条；⑤ 缺数段不折叠。**不加新类名**（`dshsl-pn*` 类↔规则判据不破；`data-collapsed` 是属性不是类）。
- **新增 5 条客户端断言（可 grep）**：`可读性①`（高度上限）/ `可读性②`（段标题字号严格大于正文 ＋ cursor / `::before` / 折叠规则）/ `可读性③`（默认全折叠）/ `可读性③ 点段标题即展开该段…逐字相同` / `可读性③ 缺数段不折叠`。
- **红相（实跑）**：`git checkout HEAD -- lib/client.js`（换回修复前实现）⇒ `client 310 (failed: 5)`，**五条全红且套件跑完不崩**。首版判据在旧实现上直接 `header.props.onClick()` 抛 `TypeError` 把套件炸在半路、只报 3 条 —— 正是 `client-half.test.mjs:32-42` 那条 Y7 纪律的坑；给判据加「旧实现形态兜底」（`typeof header.props.onClick !== "function"` ⇒ 判 false）后重跑，取得完整红相。还原后 sha256 `1E86ADF3…` byte-identical。
- **绿相（实跑）**：`node client-half.test.mjs` → `ALL PASS` / `assertion total: 310 (failed: 0)`（305 + 5）；`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1314 (failed: 0)`。
- **已知剩余（如实登记）**：展开「团队与角色」后三行角色文本仍长（宿主给的字节、同一 session id 出现两次；客户端不得重写宿主字节）—— 要治得改宿主的行渲染，会同时影响 `team_link_status` 的工具输出，**不在本版**。

---

## 2026-09-29 发版 0.4.2（收口）

- **本版收口 3 个「未发布」条目**：① preset pin 换代双代兼容（上一节）② preset 租约释放（本节）③ 客户端团队面板可读性重设计（本节）。`package.json` `0.4.1` → **`0.4.2`**；README 徽章与 §十 当前读数同改（`1314 = 1310 + 4` / `310 = 305 + 5`）。
- **跨会话协作声明（如实登记）**：① 与 ② 的实现分别由**另一个会话**（`session-65ac0ae0`，cwd `mal-analyze-cli`）与**本会话**完成，③ 由本会话完成；三者的判据、红绿相读数与文档账均由本会话在提交前**实跑复核**（不是转述）。对方另交了 `team-link-pin-api-fix.patch` ＋ 交接文档，本会话**未采用**：其 6 个文件改动已在工作树里，且本版已在其上补了租约释放。本会话在动文档前确认对方已 `空闲`（末条助手 16:02:53），并靠 FS 版本守卫挡下一次并发写 README。

---

## 2026-09-30 DEFECT-5：`revive` 复活出来的 worker 第一回合必死（resume 面漏了模板时序）

> 用户原话：「看看这个是什么问题，worker会话重启后报错 —— 处理失败 / 本轮运行失败 prompt variable "{{model}}" has no value for this assembly (section "deployment:persona-prefix") / UNKNOWN」。

### ① 真机故障面（逐条可复核的读数）

- **策略档**：`C:\Users\huangchaowen\.dsh\team-link\policy.json` 里团队 `mal-analyze-cli-20260929` 的 `worker-1..4` 各有一条 `recoveries` 行 `verb=revive`，`at` = `1790743666381 / 1790743828705 / 1790743833605 / 1790743838661` ⇒ 本机 **12:47:46 / 12:50:28 / 12:50:33 / 12:50:38**。
- **会话日志**：四条 `~/.dsh/sessions/--D-workspace-mal-analyze-cli--/team-link-mal-analyze-cli-20260929-worker-N-<uuid8>/session.v4.jsonl.zstd`（**逐帧**解 zstd：文件是 header frame + 事件帧的顺序拼接，`zlib.zstdDecompressSync` 只解第一帧，需按 `28 B5 2F FD` 魔数逐帧解 —— 四条共 1015 / 898 / … 帧，0 失败）。每条里 `type=turn/end` + `data.reason.kind=error` 的原文：
  - worker-1：turn 14，`1790743854900`（12:50:54.900）
  - worker-2：turn 18，`1790743855014`（12:50:55.014）
  - worker-3：turn 18，`1790743855284`（12:50:55.284）
  - worker-4：turn 22 / turn 23，`1790743855396`（12:50:55.396）/ `1790743860038`（12:51:00.038）
  - `error.message` 四处逐字相同：`prompt variable "{{model}}" has no value for this assembly (section "deployment:persona-prefix")`。
- **对照**：同一晚**未被 revive 过**的 `team-link-0930-threatintel-worker-1..4` 四条日志里，该字符串 **0 命中**（逐文件计数：0 / 0 / 0 / 0）。worker-1 的日志还留下完整的因果链：`turn/end{kind:interrupted}`（12:34:50）→ `session/end-seed`（12:50:28，即 resume 的载入）→ `agent/inbox/spliced`（12:50:54）→ `turn/start` turn 14 → **第一个 `step/end` 之后立即 `turn/end{kind:error}`**（死在提示词组装阶段，一个工具都没跑）。

### ② 根因（机制层，两半）

- `recoverRevive` 调的是 `ctx.agents.resume({ resumeSessionId })`——**一个键都没多给**（修复前 `lib/index.js:10247`）。宿主 `dsh-agent-loop:1970` 是 `setupAndPublish(…, options.agentOptions ?? {}, options.setup, …)`：
  - **没有 `agentOptions`** ⇒ 复活出来的 agent **没有任何模型选择**；`{{model}}` 的唯一来源是 `ctx.systemPrompt.variable("model", (context) => context.agent?.options.model)`（`dsh-agent-loop:1565`）⇒ 组装 `deployment:persona-prefix` 时该变量无值、抛错（**DEFECT-3 的机制原样复现，文案逐字相同**）。
  - **没有 `setup`** ⇒ preset **组装源没挂**；`standard` preset（`dsh-web-app/presets/standard.patch.yml`）正是这具 agent 的工具面（bash / pwsh / fs / jobs / skill / goal / plan-mode / compaction / delegation / web）⇒ 即便模型那一关过了，复活出来的 worker 也拿不回自己的工具面（**DEFECT-1 的机制**）。
- **参照实现（宿主自己的 resume）**：`dsh-api-session-controller:399-410` 给的是三样 —— `resumeSessionId` + `agentOptions: this.agentOptions()`（= `agentDefaultModel.currentSelection()` 的 `{provider, model}`）+ `setup: composeAgent(presetForObservation(observation)).setup`；其中 `composeAgent`（`:358-371`）是 `presets.resolve(presetId)` → `setup` 里 `presets.mount(agentCtx, resolvedId)`，`presetForObservation`（`:475-478`）读的是 `observation.projections.values.agentPreset`（= 盘上那份 header 的 `agentPreset`；实测四份日志的 header 帧里就是 `"agentPreset":"standard"`）。
- **为什么 0.4.2 没拦住**：DEFECT-1 / DEFECT-3 的修复**全部落在 `agents.create` 面**（`buildTeamSessionCreateOptions`），revive 走的是 `agents.resume`；而旧断言把缺陷**钉成了规格** —— `U26 revive` 原本断言 `Object.keys(resumeCalls[0]).length === 1`（恰好一个键）。

### ③ 修法与判据（`lib/index.js` + 宿主套件）

- **新增 `buildTeamSessionResumeOptions(ctx, sessionId)`**：① 模型选择走与 create 面**同一个**解析器 `resolveTeamSessionModelSelection(ctx, {}, sessionId)`（复活面没有调用方可以给 model ⇒ 永远走「两侧都没给」那一支），解析不出来就**拒绝恢复**；② preset 取 `agent.session.header.agentPreset`（宿主 resume 的 `meta` 就是 `structuredClone(handle.header)`），读不到就传 `undefined` 交给 `resolve` 按宿主缺省解析；③ 模型选择钩子与 create 面同一个 `installTeamSessionModelSelection`。
- **revive 调用点**改为 `ctx.agents.resume({ resumeSessionId, agentOptions, setup })`；组装失败 ⇒ **零复活、零写入**，报告点名原因/后果/出路。两档失败面**不是同一档**（如实区分）：模型选择解析不出 ⇒ 失败在调用**之前**（`resumeCalls.length === 0`）；存量 preset 解析不出 ⇒ 解析发生在 `setup` 里、`resume` 调用**已在飞**（`resumeCalls.length === 1`）并在组装阶段回滚。
- **两档口径（有意不对称，如实登记）**：`agentPresets` 服务**缺席** = **可服务降级**（恰一行具名 warn，复活照常）；服务**在场但组成面形状断层**（缺 `resolve` 或 `mount`）= **显式拒绝**（与创建面同一句判词；一个没有人设、没有工具面的代理正是 DEFECT-1「会建 ≠ 能用」的形状）；存量 preset **解析不出来** = **显式失败**（不静默换成另一支组成源，与 create 面「`preset=` 指了未知 id ⇒ 拒绝创建」同口径）。
- **组装器不取 preset 租约**：`acquireScope` 是 `dsh-webhook` **create** 时序的一环；宿主自己的 resume（`composeAgent`）不取 —— `mount` 自己 `retain` → `bind` → 释放。
- **新增 10 条 + 改写 1 条断言（可 grep）**：`U26 revive:` · `DEFECT-5 ①` / `②` / `③` / `④` / `⑤` / `⑤b` / `⑥` / `⑦` / `⑦ 口径` · `组成面（mount 缺失·形状断层）`。
- **夹具同批修复（同一个盲区第三次出现）**：`agents.resume` 桩原先用 `options.sessionId` 当 setup 上下文的 `agentId`，而 resume 面**只有** `options.resumeSessionId` ⇒ 复活面 `agentId` 恒为 `undefined`、桩的 `mount` 按「无 scope」拒绝，**恰好把 DEFECT-5 要钉的那一层挡在套件外**（与 DEFECT-1 那轮「桩只镜像自家实现的调用面」同一个盲区）。同批：复活 stub 的 header 从**持久化记录**里取 `agentPreset`。
- **红相（实跑，夹具不动、`git checkout -- lib/index.js`）**：`host 1324 (failed: 11)` —— 恰是改写的 1 条 + 新增的 10 条，其余 **1313** 条全绿；还原后 `lib/index.js` sha256 `609F9D47A35BE7AFA07B3C6C31CC192E40209B7F86DDF7AFB4F1811E4F7941E0` byte-identical。
- **绿相（实跑）**：`node host-half.test.mjs` → `ALL PASS` / `assertion total: 1324 (failed: 0)`（1313 + 11）；`node client-half.test.mjs` → `ALL PASS` / `assertion total: 310 (failed: 0)`；退出码均 0。
- **两档失败面的区分（同批把话说准）**：⑥ 档（模型选择解析不出）失败在 `ctx.agents.resume` **调用之前** ⇒ `resumeCalls.length === 0`；⑦ 档（存量 preset 解析不出）的解析发生在 `setup` **内部** ⇒ `resumeCalls.length === 1` 且无代理被发布（真工厂 setup 抛错即回滚发布；夹具同批把「先发布后 setup」改成「setup 成功后发布」，这半条才成为可读读数）。两档都：零复活、零写入、零留痕。
- **代码评审修复轮（advisor，VERDICT: PASS；1 条技术性驳回 + 6 条已处置）**：
  - 🟡#1 README 三处读数滞后 → 同批同步（→ **1324**，含红相 `(failed: 11)` 与 `1324 = 1314 + 10` 的账目；第 2 轮统一复活面口径后多一条断言，计数由 1323 改为 1324，同处一并订正）。
  - 🟡#2 文档称「组装失败 ⇒ 零 resume、零写入」对 preset 档**言过其实** → 按实现事实改写（见上「两档失败面的区分」），并新增 `DEFECT-5 ⑦ 口径` 断言把两档分开钉住。
  - 🟡#3 复活面复用了创建面的「出路」（「传 model=<provider>/<model>」在 `team_link_recover` 上**不可执行**，只有 action/team/role） → `resolveTeamSessionModelSelection` 加 `face` 参数，复活面用自己的判词与出路；**create 面文案逐字未改**（其四条既有断言原样绿）。
  - 🟡#4 质疑「人设文本与实际路由自洽」 → **技术性驳回**，证据两处：`dsh-agent-loop:761` 每个 agent 实例的 `requestHeaderLogged` 初值都是 `false`；`:1167-1178` 的 `prepareRequest` 路由基线取 `this.options.provider/model`，持久化 request header 只在 provider/model 相同那一支里贡献 `reasoningEffort` ⇒ 路由 = `options.model` = `{{model}}` 的取值来源。评审要求的「真机核对一枚『缺省 ≠ 上次用的模型』的 worker」列为**待验项**（本轮无重启窗口）。
  - 🔵#5 新断言直取下标 → 已改为先判 `length === 1`（②③④），避免 break 时抛 `TypeError` 炸掉整轮（本套件 Y7 纪律）。
  - 🔵#6 resume 桩「先发布后 setup」与真工厂回滚语义不符 → 已把发布挪到 setup 成功之后，⑦ 补「失败后不留活代理」读数（`agentFor === undefined` ＋ `agentIsLive === false`）。
  - 🔵#7 create 面只判 `resolve` 就裸调 `mount` → 组成面守卫改**双判**、形状断层显式点名（`resolve=function, mount=undefined` 两个读数都进文案）并拒绝创建；夹具加 `omitMount` 开关，新增 1 条断言。
  - **第 2 轮评审（0 🟡 / 2 🔵，均来源是本轮的修复本身）**：① 复活面在同一形状断层上仍走**降级**（同一断层两个面两种判词，且 warn 把「形状断层」说成 `service unavailable`）⇒ 已把口径统一成三分法（**缺席 ⇒ 降级 / 在场但断层 ⇒ 两面都显式拒绝 / 完整 ⇒ 正常组装**），新增断言 `DEFECT-5 ⑤b`；② 证据账里残留一句旧措辞「组装失败 ⇒ 零 resume、零写入」⇒ 已按两档事实重写。同批发现并修掉一处**夹具透传缺口**：`rotateEnv` 没有把 `agentPresetsOptions` 转给 `setup` ⇒ `omitMount` fixture 会静默退化成「服务完全正常」（判据变空锁）——这正是本轮反复出现的同一类盲区（夹具不保真），已补透传。
- **本轮不动**：`lib/client.js` 零改动（故障在宿主侧组装面，与面板无关）。
- **真机复验（2026-10-01 02:2x，重启窗口之后；读数逐条给命令产物）**：
  - **①「跑的是修复后的代码」有直接铁证**：`request/header` 事件里**内嵌着当时活着的插件所注册的工具描述**。worker-1 的 `session.v4.jsonl.zstd` 里，重启**前**那次 header（`2026-09-29T10:24:03.873Z` `reason=initial`）的 `team_link_recover` 描述**不含**本轮新增句；重启**后**那次（`2026-09-30T05:52:34.097Z` `reason=resume`，本机 13:52:34）**含**「真机缺陷 #5」与「resumeSessionId + agentOptions + setup」⇒ 加载的是本提交的代码（boot `2026-09-30T05:34:17Z` = 13:34:17 本机，晚于改动落盘 13:14:39 与提交 13:24）。
  - **② 故障不再复发**：四份 worker 日志里，`type=turn/end` 且 `data.reason.kind=error` 且 message 为该句的**真失败**，全部落在重启**之前**（worker-1 turn14 `04:50:54.900Z`；worker-2 turn18 `04:50:55.014Z`；worker-3 turn18 `04:50:55.284Z`；worker-4 turn22/23/24 `04:50:55.396Z` / `04:51:30.038Z` / `05:23:29.390Z`）。重启之后：**0 条**。重启后仍命中该字符串的 8 处全部是 `request/header`（工具描述与 header 文本内嵌），**不是失败**——判据按事件类型与会话 id 逐条打印核对，未用 `includes` 一把抓。
  - **③ 会话真的活着并持续工作**：worker-1/2/3/4 重启后新增的 `turn/start` 分别到 `18:19:18.613Z` / `18:22:17.861Z` / `17:52:29.164Z` / `18:22:17.868Z`（本机 02:19–02:22，即读数当时仍在跑）；两个团队（`mal-analyze-cli-20260929` / `0930-threatintel`）的恢复诊断均为 **5/5 有活代理**。
  - **④ 但 `mal-analyze-cli-20260929` 那四个 worker 不是被插件 revive 带回来的**：重启后该团队的协调者会话 `session-640a546a` 在 `2026-09-30T05:50:19Z`（本机 13:50:19）连发的四次 `action=revive`，四次都返回逐字相同的**拒绝**：「该角色的现任 …… **有活动代理**——恢复只用于「现任无人」」。那四个会话实际是由**宿主自己那条 resume 路径**带回来的（该团队策略档 `recoveries` 无新增行；客户端/侧边栏打开会话即走宿主路径）。
  - **④′ 【更正注记 · 2026-10-01 16:2x】上一条曾写成「插件 revive 路径在生产上仍是未走过的路」——该结论**被后续读数推翻**（当时的读窗只覆盖 `mal-analyze-cli-20260929` 一个团队，属**范围写过头**，按本仓「声称要带范围」的纪律在此如实更正）**：插件修复后的 revive 路径**已经在生产上走通**，发生在**同一台机器、同一次重启之后**的另一个团队 ——
    - **审计行**：`policy.json` 的团队 `0930-threatintel` / 角色 `worker-1` 有一条 `verb=revive` 留痕，`at=2026-09-30T05:38:19.847Z`（本机 13:38:19，**晚于**本次 boot `05:34:17Z` 4 分钟 ⇒ 执行者是修复后的代码），`by=session-b6c4b632-2712-43dc-ae45-be5b7f6825e6`（该团队现任协调者，**合法发起者**：现任成员），note=`recovery(revive, vacant-due-to-death, requester=session-b6c4b632…)`。
    - **复活确实发生了**：该会话日志里紧跟着 `session/end-seed @05:39:33.873Z`，随后 `request/header @05:39:57.489Z`（`reason=resume`）—— 这条 header 内嵌的工具描述**含**「真机缺陷 #5」与「resumeSessionId + agentOptions + setup」（重启前的 header 不含）⇒ 这具复活出来的 agent 的请求头是**修复后的插件**组装出来的。
    - **复活后跑得干干净净**：revive 之后的 `turn/end` 共 **14** 个（turn 34 → 47），**全部 `kind=completed`**，末个 `2026-09-30T19:39:45.061Z`（本机 03:39）；该会话**整份日志**里 `turn/end{kind=error}` 且 message 为 `{{model}}` 那句的真失败 **0 条**。
    - **仍未取得的那一格（不冒充）**：这一切只能证明「修复后的代码被真实执行且复活出来的会话能跑」；**反事实**（若不带 `agentOptions` 这一批会话会不会死）无法在真机上直接观测 —— 那一层由宿主测试套件的 `DEFECT-5 ①/③` 与修复前真机那四条错误原文共同支撑。
  - **⑤ 本轮未复验的评审待办**：🔵#4 驳回时登记的「真机核对一枚『缺省 ≠ 上次用的模型』的 worker」仍**待验**。**已取但不足以区分的读数**：`0930-threatintel/worker-1` 复活前后的 `request/header.config` 都是 `deepseek-official/deepseek-flash`（effort=high；`05:32:37.078Z` vs `05:39:57.489Z`）—— 两者同值 ⇒ 这个样本**区分不了**「取当时的缺省」与「取会话上次用的模型」，故仍按待验登记，不冒充已验。

---

## 2026-10-09 dsh-team-link 批 1（FR-7 attach 重挂 + FR-3 工作台 digest）交付读数

**改动面**：`lib/index.js` + `host-half.test.mjs`（提交 `69b9c06`，+833/−46，pathspec，两档）。设计依据：`docs/2026-10-09-team-autonomy-design.md` §5–§9（v1.3）。

**套件读数（串行；父侧与独立验证者各自复跑）**
- 基线（HEAD/pristine 副本）：host `assertion total: 1324 (failed: 0)`；client `310 (failed: 0)`。
- 交付件：host `ALL PASS / assertion total: 1376 (failed: 0)` exit 0；client `ALL PASS / 310 (failed: 0)` exit 0（**+52 断言，零删除**）。
- 红相（新测试 × pristine lib）：**10 FAIL 后于 `:9481 __testing.renderWatchdogDigest is not a function` TypeError 中止**（实现者曾自报「20 FAIL」，**不可复算**，以验证者的可复算读数为准）。

**判据**：U9（无事零投递）· U10 两半（digest 忙时照投 ∧ 告警 tick A1 抑制原样）· U11（auto 不占手工额度）· U12（attach 重挂，含晚挂/折叠/refused/detached 四窗口，**6 条断言守链尾**）· U14（source 恰三成员、零新事件类型）· U15（`inject` 恒 4 项、`writerGate`/`retireGate`/`rotateGate`/`relayUserMessage` 对 HEAD **逐字节相同**）。变异反证 M1–M7 与三轮定向变异（B/C/E③/F/D）全部取到预期红。

**两轮修复（有界）**：t-3 修并发安全 + 断言补强；t-5 撤回一处**未申报**的 `notifyAttached()` 并把 E① 断言改成真有判别力（旧断言在「失败分支记住签名」变异下**照旧绿**，新断言**恰好 3 红**）。

**★ 新纪律（本轮实测逼出，两条）**
1. **同树并发跑 check 会假红**：修前受控实验 A=`1353 (0)` / B=`1353 (failed 13)`；验证者另测 `ENOTEMPTY … .test-tmp-team` at `host-half.test.mjs:1954`（EXIT 1、零断言）。修法＝每进程唯一临时根（`mkdtempSync(path.join(os.tmpdir(),"dsh-team-link-test-"))`），修后 2 路/3 路并发**全部 1376 (failed: 0)**。
2. **核「零残留」断言必须加 `-CaseSensitive`**：PowerShell `Select-String` 默认忽略大小写，会把既有英文散文里的 `mutation` 报成假阳性（不加＝2 条，加后＝0）。

**未验证（如实）**：真机行为（重启后定时器是否真的重挂）本轮**未验**——无 DSH 重启；全部读数为套件级。

## 2026-10-09 D-B6 宿主缺陷登记（三条；**只登记，不在本仓修**）

> 来源：批 3 交付的 D-B6 决策点（设计档 §12 D-B6 裁定＝「登记」）。三条都不是本插件能修的：它们属宿主（DSH）或部署配置面。

| # | 宿主缺陷 | 一手证据（可复核） | 影响 | 建议修法（宿主侧） |
| --- | --- | --- | --- | --- |
| 1 | **CJK 估算低估**：本地 token 估算器对中文重上下文系统性低估 ≈**1.47–1.89×**（n=5 样本） | 同一条压缩事件里 `shadowedTokenCount = 205,127`，而同操作的 API 实测 `cacheReadTokens = 387,200`（≈1.89×）；批 2 交付时把该读数记入本条 | 压缩阈值按估算口径算 ⇒ 真实触发点远超声明窗口（deepseek 1M 档：估算 541K ⇒ 真实 ≈1.02M） | 估算器按 CJK 字符宽度校准，或允许按真实 usage 回灌校正系数 |
| 2 | **大包 idle-timeout 未识别为疑似溢出**：失败码全是 `pi-ai stream idle timeout after 300000ms` / `TRANSPORT`，溢出分支只认 `CONTEXT_WINDOW_EXCEEDED` | worker-2 会话：`CONTEXT_WINDOW_EXCEEDED` **0 次**；`llm/retry` 5 次（同一窗口内） | 大包撞墙时**溢出救援一次都没触发**，5 次重试后该回合失败 | 把「大包 + 长 idle + 重试」的组合识别为**疑似溢出**并走救援分支（或至少给出该提示） |
| 3 | **压缩判定只看本地估算，不看实测 usage**（2026-10-10 **订正措辞**） | 宿主源码实读：`dsh-token-meter/lib/types/usage-projection.js` 的 `pressureFrom = inputTokens + cacheReadTokens + cacheWriteTokens` ⇒ **`contextPressure.pressureTokens` 吃的是 API 实测 usage**（原措辞「压力环只吃估算」**不成立**，此处订正）；真正只看估算的是**压缩判定**：`dsh-compaction-basic/lib/index.js` 里 `const measurement = meter.measure(agent.session)` 与 `thresholdTokens` 比较，错误文案原文也写 `estimated tokens` | 人看到的「压力」是实测值，而**触发压缩的是估算值** ⇒ 两者系统性偏离（中文重上下文下估算低估 ≈1.76×） | 宿主侧二选一：把压缩判定也改为按实测 usage 触发，或让 `contextPressure` 同时暴露「估算口径的触发值」；本插件侧**不猜**，资源行如实标「压缩阈值 未知（宿主投影不含该读数）」 |

**边界声明（如实）**：三条都**没有**在本仓实施任何 workaround —— 本插件不猜宿主内部口径，只把读数如实呈现（资源行/判读行的口径见 README 第六节与批 3 交付报告）。

## 2026-10-09 批 2（FR-1 宪章段 + FR-2 资源段）交付读数

- 提交 `3885824`（2 档 +742/−24）；基线 1376 → **1410**（+34，零删除）。
- 验证：`node host-half.test.mjs` → `ALL PASS / 1410 (failed: 0)`；`node client-half.test.mjs` → `ALL PASS / 310 (failed: 0)`。
- 判据：U1（四条降级路径，各恰一行 warn）· U2（注册参数逐字）· U3（换届 dispose + 新现任挂宪章）· U4（代理消失零残留）· U5（函数型 text 同步且恒返回字符串；渲染异常吞掉）· U6（资源行逐项一致 + 缺字段「未知」+ turns 正反相）· U15（红线逐字节）。
- **真缺陷（独立复验 🔴，已修）**：换届 claim 的段同步**早了「一笔写入」** —— `onRosterSettled()` 落在 `policy.update({…teams})` **之前** ⇒ 旧协调者留着宪章、继任者零段（直到下次名册写入或重载）。修法＝移到写入成功之后；并补真控制器判据（该路径原**零断言**：把那行移动后出货套件照旧全绿）。
- 评审修复：**全过期多行清扫停摆**（原实现只给最新一条过期行挂清扫定时器，它被 `stopTimer` 后其余行永远没有定时器）⇒ `removeWatchdog` 尾部幂等 `rearm()` 接棒；**失败隔离两段文案分开**（update 失败 ≠ schedule 失败；后者带 entry + 一行 warn）；**worker 义务行改角色寻址** `team:TEAM/coordinator`（去掉裸会话 id ⇒ 换届零 churn）。
- 未验证（如实）：真机行为（无重启）；宿主 `systemPrompt` 在夹具里是桩。

## 2026-10-09 批 3（第⑧段 + 判读行 + 轮换标记 + FR-4 + FR-9 + 文档同步）交付读数

- 提交 `2c7f9d8`（5 档 +445/−28）；基线 1410 → **1438**（+28）。
- 验证：host `ALL PASS / 1438 (failed: 0)`；client `310 (failed: 0)`。
- **「全只读」反证（独立复核）**：黑板根先写 **42 个真实文件**，再连调两次 `team_link_status`（第⑧段在场）⇒ settings 命名空间与磁盘**逐字节不变**。
- 判据：U7（「预算耗尽」全卡恰一次且只在判读行；已用「段头塞正说」变异取红）· U8（四边界 99/100/101 与 199.9M/200M/200.1M，**严格大于**）· U13 · U16（首行仍 placementLine、描述「八段」）· U17（三处关断 + 两处都关 ⇒ 零注册 + clear 同进程不自愈）· **U18**（四处重钉面：现任含 / 非现任缺席）。
- **口径（父侧裁定，已同步设计档 v1.4）**：判读行**不做**「低于阈值」比较（宿主投影不含压缩阈值）；「预算耗尽」只允许以**否定式**出现在判读行；第⑧段会话集合＝调用方 + 有界读窗（≤10 行）；**无**「来源 manual/auto」格（那是看门狗属性，会话没有该属性）。
- 修复轮：U18④ 补「队在场 + 现任是别人」夹具 · **`teamEnv([...])` 撒谎夹具改对**（它把数组传给选项对象形参 ⇒ 名册其实是空的，U5 一直测的是空名册；完整修复＝恰 3 处编辑）· clear 前置守卫 · 两个降级原因码补断言 · U19 标签 eight→nine。
- 未验证（如实）：真机行为（无重启）。

## 2026-10-09 doc-sync 两轮收口（设计档 v1.4 / 计划档第二轮）

- **评审累计遗留的三条纯文档项已闭合**：① E2 定义＝「只读 goal 那一半」（台账一半延后，§5.1 已写明，属**已披露的简化**）；② §7.2 `pulseCache` 行删除 + §6 伪代码的压缩阈值改成「未知（宿主投影不含该读数）」；③ U14 的 as-of 行号 `:1440` → `:1536/1539`、U10 的悬置条件（D-A1 已准）删除。
- **登记一条未做的 🔵（不阻断，留后续批次）**：`U17 clear 前置` 守卫的**下游**仍会在「夹具已错」的变异世界里崩（`clear({ id: undefined })` 抛 `INVALID_ARGS` ⇒ 红相跑不到末尾）——属 Y7 同类问题（红相不许撒谎），本次不改，登记在案。
- 设计档 §13 新增 **v1.4** 行；计划档 §7 新增 doc-sync 第二轮行；两轮合计修改面＝需求档未动 / 设计档 / 实施计划 / 本档。

## 2026-10-10 第二次重启后的复验（第 ⑧ 段修复**真机生效**）+ FR-7 取证准备

**部署证据**：重启于 10:36:53（boot pid=13112）；部署版 `lib/index.js` SHA256 `FBBCF033…19D` **等于仓库 HEAD** ⇒ 跑的是含热修（`516bf47`）的构建。

**第 ⑧ 段真机读数（修复后）**
`@
--- 资源/预算（⑧；每会话一行：压力 / 窗口 / 累计 / 轮次；只读 sessionProjections，零写盘）---
- session-9fdfe32c-…：压力 45.7%（窗口 1.00M） · 累计 ≈149.22M · 第 48 轮      ← 活会话：真实读数
- 9003981b-…：不可读（原因：非活动会话）                                      ← 非活会话：如实标注
`@
⇒ 修复前该段**每一行**都是「不可读（原因：投影读取抛错：session.snapshotEvents is not a function）」；现在**活会话真读数 / 非活会话如实标注**，两种情形分得开。

**FR-7 取证准备（真机唯一未验项）**：因为 `policy.watchdogs` 在两次重启间已被 TTL 清扫为空，重挂**没有对象可验**。处置：注册一条**面向取证**的看门狗 —— `wd-75e4e35f-a110-4683-bf15-f47576cefb20`（观察者＝本会话；targets＝两个已死的子代理会话；静默阈值 10min · 巡检 10min · TTL 24h，到期 2026-10-11 10:39:38）。**下一次重启后**若该注册照常巡逻（目标已死 ⇒ 触发 tick 投递），即证明「重挂」在真机生效。

**B5 的判定口径（留给下一次压缩）**：阈值不外暴露 ⇒ 用**首次压缩的触发压力**旁证：本插件配置为 `thresholdRatio: 0.45`（450K **估算**）⇒ 若生效，触发时真实压力应 ≈**79%**；若是旧默认 0.8（541,248 估算）则 ≈**95%**。

**仍未验（如实）**：① 段注册（FR-2）真机生效**无观测面**（会话日志不记系统提示正文；建议后续批加「段注册状态」读面）；② 两次重启的「上次结束」都是**非正常**（末次心跳 → 下次启动的死亡窗口各约 2–10 分钟），像是桌面壳重启路径不写优雅结束标记，非插件问题。

## 2026-10-10 重启后**真机验证**（首次拿到运行期读数）+ 批 4 热修

**环境**：用户于 10:05:37 重启 DSH（boot pid=14012）；`platformVersion = 0.2.0-rc.2`（源自 `dsh-app-boot/package.json`；桌面壳 `@deepseek-ai/dsh-desktop` 同为 0.2.0-rc.2），**九道平台契约锁全绿**。

**新代码是否真在跑（逐字节证据）**：`node_modules\dsh-team-link` 是指向本仓的目录链接；部署版 `lib/index.js` SHA256 `0F842CCB…190` **等于仓库 HEAD（`2c7f9d8` 版本）** ⇒ 跑的是批 3 代码。

**B5（`thresholdRatio: 0.45`）的源码级确认**：宿主 `dsh-compaction-basic` 里 `thresholdTokens = Math.floor(Math.min(contextWindow * policy.thresholdRatio, pressureBudgetTokens))`，触发比较的是 `meter.measure(agent.session).totalTokens`（**本地估算口径**）⇒ 本仓 B5 的换算链（估算器低估中位 1.76× × 0.45 ⇒ 真实 ≈792K）**成立**。
**仍未取到的读数（如实）**：阈值**不外暴露**（`contextPressure` 的 schema 无阈值字段：`{contextWindow?, pressureTokens?, surfaceTokens, sampledSurfaceTokens?, claim?}`），且重启后**尚无任何会话触发压缩**（末次压缩 10-09 19:23）⇒ 「0.45 已生效」缺一枚运行期读数。旁证口径：下一次压缩的**首次触发点**应 ≈**450K 估算**（旧配置为 541,248）。

**★ 真机缺陷（本轮抓到，已修）**：`team_link_status` 第 ⑧ 段在真机上**每个会话行**都渲染「不可读（原因：投影读取抛错：`session.snapshotEvents is not a function`）」。
- 根因：`readSessionUsage` 构造**替身** `{ header: { id: sessionId } }` 传给宿主投影；宿主 `stateOf → materializeCells → session.snapshotEvents()`（asar 实读 `dsh-session-projection/lib/index.js` 与 `dsh-session/lib/index.js`）⇒ 必炸。
- 修法（提交 `516bf47`）：改走 `ctx.agents.get(sessionId)?.session` **真身**，拿不到则如实标「非活动会话」；**并把测试桩改成镜像宿主**（`stateOf` 对不具 `snapshotEvents` 的会话对象逐字抛同一个错）——这是本仓 `AGENTS.md` §四点名的坑（桩只镜像自家调用面 ⇒ 把宿主断层永久挡在套件外）。
- 红相：**实现前自然红 7 条**（先改桩后改码；红集全落在第 ⑧ 段家族），非事后变异红。读数：1438 → **1440**（+2 断言），host `ALL PASS / 1440 (failed: 0)`、client `310 (failed: 0)`。

**仍未验 / 无观测面（如实）**
1. **FR-7 重挂**：重启后 `policy.watchdogs = []`（旧注册已按 TTL 清扫）⇒ **没有可重挂的对象**，该判据在真机上未取得读数。取证办法：先注册一条 → 下次重启后观察巡逻。
2. **FR-2 段注册**：会话日志的 `request/header` 只记 `config/adapterDefaults/tools`、**不记系统提示正文** ⇒ 段是否注入**无法从日志观测**（本插件当前也没有暴露段注册状态的读面）。
3. **重启性质**：上次结束＝**非正常**（末次心跳 10-10T01:55:33Z → 本次启动 02:05:37Z）；本轮无在飞作业，无损失。

**🔵 登记（不阻断）**：`hostShapeAll`（夹具集中造型）当前**零断言覆盖**（改成 no-op ⇒ 全绿 1440/0）——复核者探针查明：真正被断言的会话在构造点就已造型，而 `hostShapeAll` 只兜 `extraAgentObjects`/`createdAgents`，这两类现有夹具里不进第 ⑧ 段读窗。处置：批 4 微修中构造「非调用方活会话进读窗」的夹具使其承重（若实测不可行则降级为「面向未来夹具的造型」并如实标注）。

**口径纪律（本轮学到的）**：任何「XX 未变」的声称都必须**点名基线读数**（本轮曾用「设计档 size 未变」描述相对更早读数已变、但相对本轮未变的事实 ⇒ 正确说法是「已随 v1.4/v1.5 收口并提交，本轮未动」）。
## 2026-10-10 16:23 重启后真机复验（批 5/6 部署 + 两处真缺陷 + FR-7 取证）

**部署确认**：`team_link_watch` 工具描述已含 `action="arm-team"`、状态卡正常渲染 ⇒ 批 5/6 的代码**已加载**。

**缺陷一（⑧段判读行被裁）**：`team_link_status` 读数里 `判读` 命中 **0**、范围句命中 **0**；而卡上 ⑧ 段有 **10 个会话行 + 1 行轮换标记 = 12 行** = `BUDGET_SECTION_MAX_LINES`。⇒ 根因＝`budgetSectionLines` 先拼完整行再 `slice(0, 12)`（lib/index.js:3288-3309），**末行判读行被静默裁掉**；夹具里会话行少 ⇒ 套件 1466 全绿也看不见。批 6 的 FR-14 在**最需要它的忙碌团队**上失效。

**缺陷二（按队补挂零写入）**：`C:\Users\huangchaowen\.dsh\team-link\policy.json` 的 **mtime = 2026-10-10 15:35:47**（早于启动 16:23:55），重启后若 `team_link_status` / `team_link_roster get` 之后仍不变；`policy.watchdogs` 只有 1 条 `origin=manual`（我为 FR-7 注册的探针） ⇒ **FR-10 的 attach 按队补挂零写入、零 warn**。

**FR-7 取证（同日补）**：探针注册 `wd-75e4e35f-a110-4683-bf15-f47576cefb20`（watcher=本会话，targets 含死会话 `9003981b…`）在 **16:33:57** 投来 tick（`verdict=dead 静默 0.0min`）—— 即**启动 16:23:55 + `intervalMinutes=10`**，分秒吻合 ⇒ **「attach 重挂」在真机上生效**（定时器确实挂上了）。取证后已 clear 探针（避免每 10 分钟打扰用户）。

**因果更正（我自己先前说错的一半）**：曾据 mtime 断言「同一次 attach 回调里 `rearm` 与 `ensureTeamAutoWatchdogs` 双双空转」—— **tick 到达即证伪 `rearm` 那半**：`rearm` 生效，**空转的只有补挂**。二者差别说明这不是「回调没跑」，而是**回调里补挂那一步零写入且无声**（本部署 `ctx.logger?.warn?.` 是空操作 ⇒ 失败无处可看）。⇒ 立 **FR-17**（attach 后置链的进程内读面：rearm 计数 / 段同步变化数 / 补挂四态）为批 7 **第一优先**：先补眼睛，再定因果。

**产物**：设计档 §5 FR-15/FR-16/**FR-17**、§8 U25/U26/**U27**、§13 v1.9 + **v1.10**（并把 §5 的 FR 行重排回 FR-1…FR-17 数字序）；实施计划 §3 批 7 行 + §7 两条变更记录；任务 `task-29`（实施）/`task-30`（独立验证）。

**补记（同日）**：同一次 sweep（读数 16:33:57）对**两个目标各投一条** tick（`9003981b…` 与 `e214caa8…`，两条都到）；两条都在我 clear 之前已在途 ⇒ clear 只影响**后续**巡检，不回撤已排队的投递。读数：`team_link_watch action=list` ⇒ **共 0 个**（探针已清，无后续 tick）。

**交付评审（advisor type=code）如实登记**：批 5/6/7 的代码交付在本会话**未能取得 advisor 评审** —— 该工具**连续 3 次超时**（每次吃掉 5–10 分钟，无作业句柄、无落盘档；插件把 `lastReviewType` 翻成 `code` 后输出清空 ⇒ 启动了但没跑完），即便把 runner 切成后台（`round1.runner={"kind":"dsh"}`，session override）仍无效。**替代审计**：三轮独立复核 `task-25`（批 5）/`task-27`（批 6）/`task-30`（批 7 + t-31），每轮都含定向变异（合计 30+ 组红相）、探针与哈希冻结；**本会话的 advisor 不可用按已知限制登记**（与 eng_coder 同源：长树上同步跑不完），待换窗口/换会话再补。