# Changelog

本项目版本号遵循 `0.x` 阶段的语义化：`0.<minor>.<patch>`；预发布版本带 `-beta.N` 后缀（面板中显示为 `0.3.0beta1`）。

## 0.8.4-stable — 六条线上 issue 修复与顾问闭环

> 发布 tag：`v0.8.4-stable`。本版把 GitHub 上**六个仍开着的条目**逐条修掉（#29 ~ #34），
> 并在 "顾问给出的结论到底能不能用" 这条链上做了一轮收口。不含协议重写，不改用户模型与权限。

### 顾问闭环（本版主线）

- **按具体主张核对证据**：每条结论只对它**实际引用**的材料负责。未引用的补充材料即使被截断或缺失，也只是警告，不再整体否决报告；
  被引用的截断材料仍必须完整定向补读。源码、截图与运行记录**不互相冒充**（内容被读到 ≠ 语义正确 ≠ 真实运行已证实）。
- **前版对照**：同一任务、同一对象的后续改进可以看到**实际已发送过的**改前内容；文件变了只提示"需要比较"，
  不把"文件不同"说成"采用成功"或"质量提高"。`keep` 合法，且不算验收通过。
- **逐轮交付旁注**：按会话 + 事件序号重建**该轮**的复核状态（已知缺陷 / 待验证 / 仅所列范围 / 没有复核），
  不用后续轮次覆盖旧答复，不读"完成了"作裁决，不拦文件分享，也不自动追加模型回合。

### 修复（对应线上 issue）

- **#31 解析被拒时两级兜底不生效** —— `emptyResultReason` 只把 `NO_JSON` 当空产出，
  `BAD_JSON` / `BAD_OPTIMIZER_SHAPE` 直接落到 `parse-rejected` ⇒ 用户看到"失败：no-packet"。
  现在两类同等对待：先重试一次，仍坏则由宿主补一条**如实说明**的兜底条目。真机 429/772 位置上多出来的那个 `}`，
  改由**配对括号扫描**取第一段完整对象解决（内含字符串与转义处理，只对贡献报告做**值不变**的单引号恢复，验收报告不修）。
- **#32 顾问无法接受文件输入** —— `prepareAdvisorMaterials` 的失败路径只把 F 编号放进 `evidence`，**没放进 `evidenceIds`**，
  于是"我读不到这个文件"这句实话没有合法引用 ⇒ 整份报告被判 `advisor-invalid-citation`。现在失败路径同样登记，
  读不到的材料可以正常引用、缺口如实入账；`/po06/api/status` 也不再写死 `readEnabled:false`。
  **保留**：声称 `satisfied` 却没有任何**结果类**证据仍然整份拒绝（这条防线不许松）。
- **#30 复核落账失败 + 失败卡片丢弃产出** —— 读痕迹原先按 (路径, 起止行) 去重，同一文件读 5 段会产生 11 行、
  撞上 8 行上限 ⇒ `invalid-stage-material`，已经通过的结论被丢掉。现在按**文件版本**(路径+sha256)归并，
  同一版本的多段读取合并成一行并保留 `readRanges`；真实多版本不会被吞。失败/中断的卡片同时补上投影三轮投影
  （`partialReasoning` / `activities` / `raw`），并把"保留部分内容"的标题改成**只在真拿到内容时才出现**。
- **#33A 非 delivery 下 `requiredScopes` / `requiredReviews` 误拒** —— 这两个参数的**全部**消费方都在 delivery 分支内，
  非 delivery 下是纯 no-op，却按硬错误拒掉整次调用（真机某会话 21 连败 0 成功）；而 schema 的 enum 又把 8 个值全给，
  照 schema 选值必被拒。现在非 delivery 一律放行（且不改写调用方对象），delivery 内的非法值仍被拒，
  拒绝理由带上**当前值、允许取值与正确用法**，schema 同步收紧。
- **#33B 英文模式翻译中断** —— 上游抖动（503 / 首字节超时）会让翻译流以 error/aborted 收尾，整轮直接红。
  现在：容忍围栏 / 前后散文 / 对象之后的杂尾的翻译 JSON 提取；有界重试（永久性错误与已取消不重试）；
  **每条**失败路径都带 `attempts` 台账，宿主把它写进 wire log 与返回值。
- **#34 顾问无产出时干等满熔断** —— 新增**空闲判死**：只在连续没有任何正文/思考增量与查证事件时才结束（默认 90 秒），
  有任何产出即重置。走的是既有的截断路径，"到点不许抹掉已产出内容"的语义原样保留。
  这不是总截止（默认仍不设总截止）；`DSH_PO06_ADVISOR_STALL_MS=0` 可完全关闭，非法值回落默认。
- **#29 安装分发（文档）** —— 本插件**按设计不发 npm**，插件市场因此回落到 git 安装；README 增加排查表：
  `schannel: SEC_E_INVALID_TOKEN` 是本机 git 的 TLS/代理问题，`allowBuilds` 提示对本包无效（本包没有任何构建脚本）。

### 其它

- 测试：**104 套 / 1141 项**全绿（含打包自足性、文档漂移门禁）。新增 `advisor-stall`、`advisor-open-issue-30`、
  `open-issues-31-32` 三套针对线上 issue 的回归，另有 parity / pipeline / scope 用例按**新契约**更新。
- 界面作用域静态守卫修掉一处**误报**：`props.sessionId` 与对象字面量的键不再被当成自由引用（判据本身没有放松）。

## 0.8.3-stable — 解释协议 v3（短协议）与 CI 可移植性

> 发布 tag：`v0.8.3-stable`。本版重写了**发送前那一轮的优化解释协议**：把工程字段从模型手里拿回来，
> 让模型专注"读懂你的意图 + 贡献有价值的补充"。同时修掉三处只在特定机器/Node 版本上才暴露的失败。

### 解释协议 v3（本版主线）

- **更短、更专注的协议**：模型只收到「共用核心 + 当前档位 + 薄输出格式」（需要时再加只读/语气/英文段）。
  中文普通组合：轻度 596 / 标准 599 / 重度 639 字符——此前是三段叠加的数千字符。
- **输出改为 `intent` / `clarify` / `add` / `ask`**：本轮意图、表达澄清、正向补充与建议、需要反问的点。
  条目 ID、来源绑定、状态补丁、逐字引文比对**由宿主负责**，不再要求模型填写这些工程字段。
- **原意权威不变，但不再靠"逐字引文"一刀切**：你的原话独立保留、原样发出；模型产出的澄清与建议**始终是机器建议**，
  不会被放进"用户明说"那一类。引文比对仍用于旧格式，且继续按条丢弃而不是整份作废。
- **三档按用途区分**（不再靠条数、字数或问题配额）：轻度＝把原意讲清楚、消除歧义、指出必要反问；
  标准＝澄清表达并补足影响结果最大的缺口；重度＝围绕已有目标做全方位正向补充、构思与方法，并呈现实质取舍。
- **零增量是合法结果**：没有值得补充的内容时不再硬造条目、也不再因为"空"而重试。
- **旧上限取消**：新路径不再受 12 条 / 300 字 / 提问配额约束；长建议与多条反问完整进入上下文与审查面板。
- **英文模式改用原生英文协议**：不再"自定义译文 + 英文内置协议"叠加；忠实任务翻译与新增建议分开，
  代码块、路径、URL、JSON 与精确回话继续逐字保留，用户自己的语言要求原样保留。
- **界面可核对**：详情里同时给出「当前设置的完整组合预览」与「本会话最后一次**实际发送**的协议、字符数与思考档位」，
  预览明确标注不是实测请求。拦截浮层继续流式显示新格式的理解、澄清与建议。
- **本机旧默认提示词精确迁移**：只在与内置旧默认**逐字节相同**时替换，替换前原样备份；
  真正改过的自定义文本一律保留（并继续接受旧格式输出）。

### 修复

- **CI 在旧 Node 上必然红（真实缺陷）**：`read-session.mjs` 用具名导入取 zstd 解压 API，
  而该 API 是 Node 22.15+/23 才有 ⇒ 在 Node 20 上**整个模块链接失败**，连"优雅报错"的机会都没有。
  改为命名空间导入 + 能力探测：有就走原逻辑，没有就如实说明缺什么并跳过（附带静态守卫禁止退回具名导入）。
- **安装检查依赖机器上装了 `dsh`**：装配层验证要跑一次 `--dump-config`，而 CI runner 上没有这个命令 ⇒
  那条"无法验证装配层 ⇒ 阻断"的纪律会把测试夹具一起判死。现在 `dsh` 命令可注入（`--dsh` / `DSH_PO06_DSH`），
  单测自带桩命令；同时**只在包确实装上了**才去验证装配层（没装就跳过，不再制造噪声阻断）。
  纪律本身没放松：跑不了 `dump-config` 仍然阻断，并新增一条用例钉住它。

### 工程

- 发版门、CI、套件、变异守卫继续共用同一套计数口径；本轮计数见 `po06/eval/release-check.json`。

### 未验证 / 不声称的部分

- **没有做专业跑分，也没有"更快"的结论**。协议变短不等于模型更快：思考档位、上下文与任务本身都会影响耗时。
- 新协议**不保证**建议一定更好或更少跑偏；它保证的是"不再把工程字段与逐字引文强加给模型"，
  以及"机器建议不会冒充用户要求"。实际价值需要你在同一任务上对照三档自行判断。

## 0.8.2-stable — 英文模式、推理增强（实验性）与发布门修复

> 发布 tag：`v0.8.2-stable`。本版把上一节遗留的 issue 修复（#23 / #25 / #26 / #27 / #14）一并带上，
> 并新增英文模式、实验性推理增强，以及一组发布门与文档修复。

### 新增

- **英文模式（默认关闭）**：面板里与「权限」同款两档滑档。把用户任务、优化策略与辅助文转成英文再送给模型，
  界面仍为中文；状态里的要求正文**回到原话语言**（英文那份只作注入口径），关掉英文模式后状态照样可读。
  - 逐字保护：代码块、内联代码、`@"路径"`、URL、Windows/POSIX 路径、JSON 字面量与精确回话不参与翻译；
  - 翻译与辅助**解耦**：过期输入或已取消的请求不会发出去；翻译失败只回落一次，并保留真实失败原因；
  - 斜杠命令不参与翻译；允许列表内的命令（如 `vmake`）**照旧走拦截审查**（本轮曾因放行条件写错而漏拦，已修并加回归）。
  - **不添加答复语言要求**：答复用什么语言由模型按你的话决定；需要中文就在原话里说。
- **推理增强（实验性）**：置于选项面板最底部并单独分界，含多候选择优 / 循环改进 / 混合三种模式与快速-均衡-跟随三档强度；
  「推理过程」面板只在开关打开时出现。面板内写明了真实代价：**目前无法确定它能否稳定提升模型能力，但会大幅增加模型工作时间，请谨慎开启**。

### 工程

- **CI（本版新增）**：`.github/workflows/ci.yml` + `po06/scripts/run-suites.mjs`（与发版门同一条调用方式与计数口径，
  受限环境自动选择可写临时目录）。套件与发版门从此在每次推送时自动运行，不再依赖人手。
- **变异守卫修复**：两个变异体的锚点仍写着旧节标签 ⇒ 变异**从未被应用**，而门禁把它报成"未被捕获"，方向完全相反。
  已修锚点并逐条实测确认会红；门禁现在把「锚点失效（守卫等于不存在）」与「变异未被执行捕获（测试变弱）」分开报。
- **清理**：删除已被内联取代的重复模块（`lib/bash/client.js`、`lib/bash/bash-tool-contract.mjs`）；
  未接线的 `lib/bash/runtime-integrity.mjs` **保留并写明**，新增用例钉住"一旦接线就会红"。

### 修复

- **#23 内置 Bash 在 win32 上把 `HOME` 显式指向真实用户目录**（此前落在自带 MSYS2 运行时内**不存在的目录**）。
  - 症状：插件内 `git config --global --get <key>` **永远读到空**——静默返回 1，不报错、不崩、日志里什么都没有；
    同一台机器、同一个用户，插件内外是**两份不同的"全局配置"**。
  - 根因：spawn 的 env 只有 `{...process.env}` + `PATH`，**没有 `HOME`**；MSYS2 在被非 MSYS 父进程启动时兜底成
    `/home/<账户>`，而本私有 root 的 `/` 就是 `po06/runtime` ⇒ 落点 `<plugin>/runtime/home/<user>`，该目录不存在、也没人创建。
  - 修法：`win32` **且**本次运行时来源是**自带 bundle** 时才接管；取值 `DSH_BASH_HOME` → `USERPROFILE`
    → `HOMEDRIVE`+`HOMEPATH` → `os.homedir()`。Git for Windows / 系统 MSYS2 / `DSH_BASH_PATH` / 显式 `config.bashPath`
    **一律不动**（它们各自已把 HOME 映射到用户目录）。
  - 来源：**PR #23（作者 @deadbushxw）**；本机已复现（`HOME=/home/WestFox`、`git config --global` 返回 1）并验证修复。
  - 取舍（如实写明）：内置 Bash 不经 ACL 沙箱，交出真实用户目录意味着 `~/.ssh`、`~/.gitconfig`、`~/.netrc` 在其可及范围内。
    本版选的是"配置可用性与插件内外一致"，**不是隔离**；需要隔离的用户请设 `DSH_BASH_HOME`。

- **#27 按会话拨档位（`bySession`）也写启用意图**。
  - 症状：新装后"进会话 → 在面板拨档位"，闸门永远 `gate:rollout-off`，界面报"失败：gate:rollout-off"，
    用户看到的是"插件装了却什么都不做"。
  - 根因：面板切档位走的是 `save({ bySession: … })`，而写启用意图的判据只认**顶层** `tier|assist|detail|budget`
    四个键（#16 的修法只覆盖了全局那条路）。
  - 修法：按会话的档位写入同样补 `enabled:true` + `rollout:{mode:'all'}`；**只开不关**——把某一场设为"关闭"
    不代表整个插件要关，那条不写 gate；只改 `framing` 这类非档位项依旧不碰启用意图。

- **#26 发版门同时认两种套件风格**。
  - 症状：`check-release.mjs` 恒 FAIL，43 项阻断里 **38 项是"输出无法解析"**。
  - 根因：门把每套的**整段 stdout** 当一行 JSON 解析，而仓库里并存两种风格——自研 runner（结束时吐一行 JSON）与
    `node:test`（吐 `ℹ pass N` 汇总行）⇒ 后者一律被判为无法解析。
  - 修法：新增 `readSuiteSummary()` / `lastJsonObject()`——先试末尾 JSON，再试 `ℹ`/TAP 汇总行；两者都不认才记 unparsable；
    并补"自述 fail=0 却非零退出按失败处理"。变异检验与打包演练同样改为末尾 JSON 读法。

- **#25 审计判据读进编译器自己写的【预算不足】降级说明**。
  - 症状：发送条目较多的长消息时，前置拦截报"失败：no-packet"（消息按设计原样发出），台账该条
    `outcome=audit-failed  packetChars=0  packetOverBudget=true  packetOverBy=36`；而 11 秒后同一轮的
    生产路径却 `committed`、`packetChars=1171` —— 内容本身合格，只有前置那一步被拒。
  - 根因：审计规则是 `chars > budget && dropped.length === 0`，而这种情况**恰恰就是** `compose()`
    写【预算不足】的唯一场合（必保内容本身超预算、可丢节全空）⇒ 判据漏读自己写下的降级说明，
    合规产物必被整包拒收（报错文字里的 "and no explanation" 是假的）。
  - 修法：与编译器口径对齐——`overBudget`/`overBy > 0`（说明已写）即视为"有说明"，
    只有"既没丢条目、又没写说明"才报；并补正反两侧用例，确保判据没被架空。

- **#14 认出 DSH Desktop 的路径形态 profile 位置参数**。
  - 症状：桌面端**不传 `--profile`**，把 profile 目录当**位置参数**交给 desktop-host；那些参数含分隔符 ⇒ 被名字正则挡掉
    ⇒ `resolveProfileName` 回落默认 `web`，而进程实际跑的是 `desktop`。于是"旧插件是否仍在装配"的判断问的是
    **另一个 profile**，双重拦截守卫可能给出相反结论（与 EV-0081/EV-0121 同形：不报错、只给错答案）。
  - 修法：裸子命令之后追加一轮**路径形态**候选——取末段并用 `profileExists` 证伪，**不写死 `profiles` 目录名**；
    `--profile X` / `--profile=X` / 裸子命令的优先级不变。
  - 来源：#14（该 PR 基于旧 main，本轮**只移植这一条特性**并补当前基线的回归用例；未整体套用，
    以免回退 `reasoningEffort` 等后续改动）。真机 argv 前后对照：修前 `web`／修后 `desktop`。

### 已知未包含

- **#5 / #12 / #28**：分别疑似扫描器误报、产物已演进的交互建议、推广内容，需答复后关闭，不需要改代码。

## v0.8.1-stable — 2026/10/03（装配修复版）

### 修复（针对「在 DSH 0.2 上装上了却用不了」的反馈）

- **根因：发布产物里的身份标识与包名不一致。** `0.8.0-preview` 的 tgz 中 `package.json` 已是 `@dsh-external/dsh-arbiter-wf`，但 `lib/client.js` 的注册 id、`lib/index.js` 的 `export const name` 与 `PRODUCER_KIND` 仍是旧名 `@dsh-external/dsh-po06`。宿主按包名生成 boot row id 并**只在该 id 下找注册** ⇒ 报 `loaded without registering "@dsh-external/dsh-arbiter-wf"`，**client 半侧整个不激活**（面板、卡片、设置页都不出现）。三处标识连同 `cordis.patch.yml` 的 entry 名一并改正。
  - 这与 DSH 版本**无关**：同一份产物在 0.1.7 上同样注册不上。0.7.8 及更早的产物名字一致，所以只有装了 `0.8.0-preview` 的用户会中招。
  - 新增 `po06/test/identity.test.mjs`：包名、client 注册 id、`export const name`、`PRODUCER_KIND`、patch entry 名**从 `package.json` 动态取真值**再比对——写死字面量会在下次改名时静默通过。
- **#22 `readTools` 恒报 `no-packet`**：判定是否工具包只用了 `/"ops":/` 子串匹配，混着散文的 JSON 直接漏判。改用流水线同一个 `extractJson`。
- **#17 每次 bash 调用都刷 `/tmp` 警告**：内置 MSYS 运行时缺 `/tmp` 时 `bash.exe` 会打印 `could not find /tmp, please create!`。改为**注册期**与**每次执行入口**都确保存在（执行入口早于运行时探测，避免探测阶段就先刷一遍警告）。
- **#16 面板里把档位从 off 调回可用时插件仍是关的**：`writeSettings` 只透传 `enabled`/`rollout`，没有任何代码路径把 `enabled` 写回 true。改为按档位联动门禁（`tier=off` ⇒ 关闭门禁与 rollout；档位可用 ⇒ 重新启用，已处于白名单模式时不覆盖）。
- **#19 切换会话后悬浮球与拦截面板状态不同步**：两处各持一份 `hold` 状态，只有一个组件能收到事件。改为模块级 hold 桥（写状态 + 派发事件，订阅方采纳），并保证卸载时不再 abort 正在进行的回合。
- **#18 浮层被右侧预览栏压住**：改为**排布**方案——量输入卡片得到「会话窗」边界，浮层整块收在窗内（右缘不越过会话窗右缘），会话列变窄时浮层跟着变窄。右侧栏若是不压缩会话列的**固定浮层**，另有一条保守探测取它的左缘当边界。重算由共享观察器驱动：窗口缩放 + 输入卡片尺寸 + `body` 子节点与 `class/style/subtree` 属性变化（侧栏靠 class 显隐时也生效）。拦截浮层、悬浮球、优化选项弹层、帮助弹层、设置面板五处统一走这套边界。

### 新能力

- **拦截面板产出层流式显示**：优化进行中就把产出层的中间结果实时画出来，标注「正在生成 · 尚未校验」，只读；校验完成后才切成可编辑的最终报文。此前整块 UI 在生成期间是静止的，成品突然出现。

### 兼容性（同一份产物同时适配 0.1.7 与 0.2.0-rc.2）

- 对 0.2.0-rc.2 的实际产物做了逐成员契约对照：模块加载契约、`dsh.client` 清单、四个插槽、工具与卡片注册、`clientModules`/`systemPrompt`/`sessionProjections`/`webServer`/`agents`/`llm`/`attachments`/`commands` 全部一致；19 个接触包中 14 个的类型声明与 0.1.7 **逐字节相同**，另外 5 个的差异全是**追加或可选参数**，不触本插件调用点。
- 未验证项如实保留：0.2 的插件装配路径是否仍接受本包的 patch + junction 形态、桌面端是否复用 `platform:"web"` 客户端、`session` 中「中断工具调用修复」带来的运行时行为差异。详见 `docs/DSH-0.2-COMPAT.md`。

## v0.8.0-preview — 2026/10/01（改名首版，未发布 npm）

### 更名与定位

- **插件更名为 `dsh-arbiter-wf`**（原 `@dsh-external/dsh-po06`）：对外显示名、包名、以及 bundle 装配条目（`cordis.patch.yml` 的 entry id 与 `name`）一并更新。
  **配置与台账文件名不变**（`po06.json`、`po06-state/`、`po06-wire.jsonl`、`po06-advisor-ui.json`、`po06-bash-invocations/`）⇒ **旧设置无需迁移**；内部路由前缀 `/po06/api` 与 `DSH_PO06_*` 环境变量维持兼容。
- 描述（插件列表里那行）改写为当前能力：**把你的话编译成可执行约束 → 治理工作区工具运行时 → 交付前独立复核**。不再出现「0.6 beta / P1–P8」旧口径，也不作性能断言（效果证据待后续跑分）。

### 新能力

- **独立顾问 `consult_task`**：另一个模型实例只按原始证据与用户原话复核，沿用优化 AI 的模型与思考档位。
- **分阶段专项复核 scope + focus**：形体与装配 / 画面观感 / 代码正确性 / 交互逻辑 / 性能证据 / 交付覆盖 / 自定义。视觉专项只带图像、不混开发历史与源码；代码专项按相关证据筛选、不带图像。
- **交付覆盖核对**：`requiredReviews:[{scope,focus}]` 精确列对象；材料变更、后续源码写入、覆盖不足时旧结论不得当作当前版本通过；**局部通过不等于整体通过**。
- **材料真实传递**：`files` 有界文本、`images` 经宿主附件服务成为真正的图像块；模型图像能力未知或不支持时明确标「未检查」。卡片逐项显示材料状态、片段与宿主侧栏预览。
- **斜杠命令允许列表 `slashReview`**：仅名单内且宿主确认已注册的命令走「拦截 → 优化 → 可编辑确认」；官方命令与未注册命令照旧直发；查不到命令表时退回名单并标注 `verified:false`。

### 修复（本轮）

- **顾问卡片 token 恒显 `Σ — tok`**：卡片优先取了进度记录里的 provider 原始字段，而格式化只认归一化字段。改为在格式化入口容错归一，**历史卡片刷新后一并恢复**；仍不折算、不估算合计。
- **bash 工具描述**：删除未实测的「跑 Windows 原生程序时 pwsh 通常更快更稳」，移到工具描述本体并改按命令性质给判据；保留「两者都能做时优先 bash」并标明属使用经验。
- **Bash 可靠性整改**：取消信号接入准备与执行阶段；每次调用独立输出目录与 UUID 文件；失败也保留 stdout/stderr；退出状态标记回到末尾；进程与 Job 句柄释放；日志按字节窗口读取；运行时探测可取消并短期缓存（成功 5 分钟、失败不缓存）。
- **Bash 诊断纠偏**：调用记录按会话与 UUID 隔离（不再用全局标记 + 年龄断言「上次崩溃」）；少输出不等于失败或纯损失；链结构只报风险，不断言吞错。
- 发布产物清理：删除 `po06/runtime` 下混入的 3 个探针残留（未跟踪文件，曾被 `files: ["po06/runtime"]` 打进发布包）。

### 边界（未验证项，如实保留）

- 真实 Win32 Job 行为、脱离父链的 MSYS 子孙清空、真实模型识图效果**均未由本轮测试证明**；fallback 收尾无法证明树清空时明确标注 `not-evaluated`。
- 本条目全部断言来自确定性测试与真机日志，**不含性能跑分结论**（计划后续单独进行）。

### 自 0.7.8 起的其它改动（原本地开发条目，随本版一并发布）


- 修正 bash 工具描述：删除未实测的「pwsh 通常更快更稳」并移回工具描述本体，改按命令性质给判据 + 标注来源的 bash 优先经验；加机器守卫。

- 修复顾问卡片 token 恒显 `Σ — tok`：格式化入口对 provider 原始字段与已归一字段两种形状都容错，历史卡片刷新后一并恢复显示；仍不估算合计。

- 新增斜杠命令允许列表 `slashReview`：仅「名单内且已注册」的命令走拦截与可编辑确认；未注册/官方命令照旧直发，命令表不可用时 fail-closed 不拦截。

- 顾问分阶段专项scope+focus：视觉只审图、不混历史代码，代码按相关证据筛选；卡片显示范围与对象。
- delivery精确scope+focus覆盖核对，同真人请求材料版本/源码写操作变化提示，不把局部通过当整体通过。

- Bash可靠性整改：取消接线、并发输出隔离、保留失败stdout/stderr、末尾退出状态、Job句柄释放、有界日志窗口及可失效探测缓存。
- Bash诊断纠偏：按调用会话记录，少输出不等于失败，链结构只报风险；fallback收尾无法证明树清空时明确标注。

- 新增顾问files/images用途清单：有界UTF-8工程内容与正规图像附件块；能力未知/不支持的图片如实标未检查。
- 顾问卡片材料逐项显示状态、用途、片段与宿主侧栏预览，保存当次内容指纹；不自动扩大文件授权。

- 新增 `consult_task` 独立顾问工具，沿用优化 AI 的模型与思考档位。
- `diagnose_failure` 检查失败尝试的信息增量，给最小区分实验与停止条件。
- `review_result` 对照本轮原话及原始工具证据复核成果，排除主模型正文和先前顾问结论。
- 复用项目根内只读工具；默认 5 分钟截止取消（可调），按会话并发保护，卸载取消在途调用。
- 验收区分满足、不满足、未验证；拒绝伪引用和无证据通过，材料不完整时不认整体通过。
- 新增顾问专用卡片（覆盖代码内嵌子工具）：实时阶段、实际思考流、查证记录、规整结论和验收项；支持有界历史回放和中止标识。
- 中止/错误流的局部通过降为未验证，UI 不把部分产出当完整验收。
- 只实现单轮咨询，不含跨轮记忆、强制交付门或自动返工。效果待用户手测。

## v0.7.8 — 2026/09/29（**主线 · 正式版 · 会话级档位 / 交互框架 / bash 判定**）

作者：啃轮胎的西狐

这一版是三件事叠在一起：**档位终于按会话**、**多了一档会改变语域的协作基调**、**bash 调用开始当场判值不值**。

### 一、档位改为会话级（修「点一次正常，之后固定」）

- **成因**：点档位是**合并**写入，而宿主早先把 `tier` 展开成 assist/detail/budget 后**存了回去**；
  于是第二次点击时，新的 `tier` 会与上一次展开的**陈旧三项**合并，读取时那三项盖过新预设
  ⇒ 推导档位不变 ⇒ 界面看起来「点了不动」。第一次之所以正常，是因为覆盖是空的、没有残留可覆盖。
- **修法**：**存意图、读取时展开**——设置层只存用户写的 `tier`，展开挪到 `effectiveSettings`；
  点档位时**整份替换**该会话的覆盖（不合并），从源头杜绝残留。
- 档位与协作基调都按会话存（`bySession`），全局只作默认值；另修掉两处 early-return 导致「加码只第一轮生效」。

### 二、新会话首条消息挑错模型（修宿主方法名）

- `agentDefaultModel` 的真实方法是 `currentSelection()`，而代码里试的是 `current/read/get/selection`——
  **四个全不存在** ⇒ 第③步整段空转 ⇒ 掉到「模型清单第一条」，用与会话无关的模型去优化。
- 修法：把 `currentSelection` 放到候选名首位（实测它返回的正是 `{provider, model}` 形状）。

### 三、交互框架（协作基调）：普通 / 硬邦邦

- **依据**：用户实测——同样字数的正式提示词做不到口语版的效果 ⇒ 起作用的是**语域**，不是信息量。
  机制是分布：正式语域采样「专业助手」那一簇（客套、求稳），口语+高唤醒语域采样「把活干出来」那一簇。
- **分工**：骨架归代码（标签 / 语域 / 越权反制行——三条不变量），加码归模型（按本轮实际写，长度自定、定点爆破）。
  加码插在中间，**边界行永远在最后**；且必须**引用包内真实条目 id**，写不出引用就整段不采用、退回纯骨架。
- 两类例外保持字面、不许修辞：**未决项**（没拍板的事说清楚）与**防御性限制**（不许做什么、范围边界）。

### 四、单轮提升（第一次就把事做对）

- **任务类自查表**：【完成前自检】节，来自代码持有的任务类知识（第一批：单文件可交互 3D/可视化程序）。
  来源是 `project_convention` 而非 human ⇒ 结构上不可能升格成用户要求。
- 质量解释要求落到「**可肉眼判断的维度 + 最低可接受线**」；新增【结构性分叉】规则（选错了后面全要返工的那种选择）。

### 五、bash 调用质量判定

- **长等待 / 低产出**：耗时与字节当场交回（工具一直知道这两个数，却从没告诉过模型）。
- **链结构**：段数 ≥3 且用了吞错型连接符（`;` `|` `||`）⇒ 点明「中间某段失败了你看不出来」。
- **重武器 + 替代路径**：命中无头浏览器 / 装包 / 网络下载 / 重构建时，直接给能照做的更省做法。
- **崩溃/中止探测器**：调用被外层掐掉时（`AbortError`）工具交不出任何东西，故落「进行中」标记，
  **下一次调用开头点明「上次没有正常收尾、那次等待是纯损失」**。

### 六、文档与仓库

- 新增 `docs/0.7.8plan.md`：四个既定突破点 + 更本质的潜在突破 + 单轮表现 + 实施优先级 + 交互框架附录。
- `.gitignore` 补 `po06/runtime/tmp/`（运行期临时目录，此前会被 `files: [runtime]` 带进包）。

**回归**：57 套测试全绿。


## v0.7.6 — 2026/09/26（**主线 · 正式版 · 长输入与 bash 让位**）

作者：啃轮胎的西狐

两处用户反馈：**几万字提示词必然失败**、**关掉内置 Bash 后系统自带的 bash 也回不来**。

### 一、修「几万字提示词必然失败」

- **现象**：提示词几万字时，面板报「失败：连不上宿主服务（它可能刚重启）」。
- **根因**（两处叠加）：① control-api.js 的 MAX_BODY_BYTES 只有 64KB，而它的注释理由是「设置/指令都很小」——
  **这个前提不成立**：readBody 也服务解释端点，而那个 body 里装的是**用户原文**。
  中文一字 3 字节 ⇒ 64KB ÷ 3 ≈ **21800 字**即撞墙（实测 39123 字 ≈ 117KB）。
  ② 超限分支执行 req.destroy()，**直接销毁 TCP 连接**而不是回 HTTP 错误，
  浏览器看到的是「连接断开」，client 归类 unreachable ⇒ **真因被彻底盖掉**。
- **修法**：① 上限 64KB → **2MB**（约 66 万汉字，仍能挡误发的二进制）；
  ② 超限**不再砍连接**，改为如实返回 body-too-large + 实际字节数，由既有调用方回 400，界面可显示真因。
- **顺带**修正同链路另一处旧尺度：session-context.js 的 CTX_MAX_TEXT_CHARS 4000 → 6000、
  CTX_BUDGET_TURNS 12000 → 24000（单段不能等于总预算，否则一段吃光预算挤掉其它上下文）。
  该常量只作用于「存进会话历史供后续轮次当上下文」的那份文本；**本轮解释走 userText，逐字不截断**。

### 二、修「非 Windows 平台：关掉内置 Bash 后什么都没有」

- **现象**：系统自带 bash 的用户（觉得原来那个更好）关掉内置 Bash 后，DSH 里彻底没有 bash。
- **根因**：宿主的 @deepseek-ai/dsh-tool-bash 注册的工具名**也是 bash**，而它在
  @deepseek-ai/dsh-base/cordis.patch.yml:266 写着 disabled: !!js process.platform === win32
  —— **官方只在 Windows 禁用它**，非 win32 平台宿主本来就提供 bash。
  而 po06 此前无差别注册同名工具 ⇒ 在 Linux/macOS 上把宿主那份顶掉；
  宿主只在装配时注册一次、**被顶掉后不会重试** ⇒ 用户一关内置，表里就再没有 bash。
- **修法**：**让位判据取平台这一静态事实**——hostProvidesBash = process.platform !== win32，
  成立则 po06 不注册。于是：非 win32 → 让位（关掉开关即回到宿主那个 bash）；
  win32（宿主被官方禁用）→ 补位（行为不变）。
- **为什么不用「查表里有没有 bash」**：表里只看得到名字、分不清是谁注册的；
  po06 自己刚注册完再查会把自己认成宿主，判据失明。平台不依赖装配时序。
- 新增 po06/test/bash-yield.test.mjs 钉住让位判据，防止日后改回无差别注册。

### 三、仓库结构：文档归入 docs/

- 仓库根由 27 项降为 10 项：只留对外门面（README ×2 / LICENSE / CHANGELOG）与必需文件
  （package.json / .gitignore / .gitattributes），其余 18 项移入 docs/ 并按用途分组，
  新增 docs/README.md 索引。
- 同步修正引用，并**顺带修掉一处早已存在的死链**：README 指向 README-0.5.md，
  而该文件上一轮已随 0.5 源码移入 old/0.5/。
- docs/RELEASING.md 补入「发布前核对所有相对链接」一条（步骤 3 的核对 + 清单第 3b 项）——
  这条正是本次整理踩出来的。

**回归**：50 套测试全绿。


## v0.7.5 — 2026/09/26（**主线 · 正式版 · 档位与仓库结构**）

作者：啃轮胎的西狐

这一版来自两类反馈：**思考档位不生效**（用户实测）与**仓库结构混乱**（外部用户：npm 上是 0.5、Release 是 0.7、而 0.7 在子目录）。

### 一、思考档位：按模型各配，并真正传给调用

- **根因**：po06 调 llm.stream 时只传 provider/model/temperature/messages，**从不传 reasoningEffort**
  （宿主契约 types.d.ts:494 有该字段，:355 写明不传则走 provider 默认）。于是每次都按默认档跑，
  而默认档下**由模型自己决定要不要思考** ⇒ 用户看到「有时有思考、有时没有」。
  插件里其实早有 reasoningEffort 设置项，但它只出现在 migration.js 的迁移清单里，**从未接线**。
- **修法**：新增 effortByModel（{ provider/model: effortId }，**按模型各配**——不同模型档位划分不同，
  且优化模型与会话模型未必是同一个）；resolveInterpreterCfg 在**定完路由之后**按该模型查表；
  两处 llm.stream（默认路径、工具回落）与工具循环都带上 reasoningEffort。
- **档位来源与官方同源**：读宿主 resolveModelInfo 的 reasoning.efforts，写同一个 reasoningEffort 字段，
  不存在第二套档位名。注意宿主 listModels 是白名单返回、**会剥掉 reasoning**，所以档位另走 resolveModelInfo。
- **界面**：优化选项里新增「思考档位」下拉，**两种模式都能配**——选了具体模型就按它查，
  「跟随会话模型」就先问 /session-model 再按会话模型查（档位写在真正会被调用的那个模型名下）。
- **实测（对照实验，同模型同输入只差档位）**：off → 思考 0 字 / 7 秒；max → 思考 40589 字 / 63 秒。

### 二、修「档位选完立刻被覆盖」

- **根因**：键格式三处不一致——前端用 JSON.stringify([provider, model])、后端校验要求键含 /（not-a-route）、
  wire.js 查表用 provider/model。于是每次保存都被判非法、丢弃并回默认。
- **修法**：前端改为 provider/model，与后端校验及查表口径统一。

### 三、修「拦截 UI 不再统计 token」

- **根因**：用量只在解释**完成那一刻**写进进度面，而 client 的阶段一离开 optimizing 就 setProg(null) 并停止轮询
  ⇒ 最后那次写入永远拉不到（那行代码与其上方注释的意图**正好相反**）。
- **修法**：轮询放宽到 optimizing 与 review；收尾时把最后一份用量钉在结果上；显示改为「结果优先、进度面兜底」；
  /interpret 响应也带上 usage。

### 四、修「调 skill 时漏拦截 + 旧包迟到、新包随后才到」

- **根因**（两处叠加，台账为证）：① 去重判据只认**文本逐字相等**，而前置拦截记的是客户端原文、
  订阅侧取的是宿主事件文本，**调 skill 时两者形态不一致** ⇒ 去重失配 ⇒ 同一句话被解释两遍；
  ② 第二遍是 defer 出去的**并发**执行，两遍基于同一旧状态各写一次，**后完成的覆盖先完成的**
  （台账实测 12:35:39 rev=309 → 12:35:40 rev=307，revision 倒退）。
- **修法**：判据增加**时间窗**维度——刚放行后 15 秒内无论文本是否变形都认定为同一条，
  两种跳过在台账里分开记（intercepted-already / intercepted-recently），使「这轮为什么没解释」始终可查。

### 五、仓库结构整理（回应外部用户反馈）

- **仓库根 = 最新版**：0.1~0.6 的历史产物全部移入 old/（38 个 tgz 按主次版本分组 + 0.5 的源码），
  根目录不再有任何 .tgz 与旧源码；old/README.md 给出各代简介与三种下载方式。
- **根 package.json 是薄壳**：逐字段从 po06/package.json 派生，main 指向 po06/lib/index.js。
  此前它曾是 0.5.x 的完整插件包，而安装入口读的正是仓库根 ⇒ 外部用户按仓库地址装到的是 0.5。
- **新增 RELEASING.md**：仓库结构四条不变量 + 9 步发布流程（每步带核对方法）+ 可照抄的检查清单 + 故障排查表。
- **README 写明安装来源**：唯一正确来源是 Release 附件；npm 上的 @dsh-external/dsh-prompt-optimizer 是 0.5 老包，不要装。

### 六、其它

- 台账新增 effort / effortRoute：记录每次调用**实际带出去**的档位与作用模型，便于自查（需重启后生效）。
- 回归：49 套测试全绿。

## v0.7.4 — 2026/09/25（**主线 · 正式版 · 位置无关修复**）

作者：啃轮胎的西狐

修掉一个**只有别人会踩到**的缺陷（外部用户反馈：装上后 bash 跑不起来）。

- **根因**：lib/bash/pg-jobport.mjs 顶部写死了**打包者本机**的绝对路径——
  file:///C:/Users/<打包者>/AppData/Roaming/npm/.../dsh-win32-process/lib/index.js
  ——而且是**顶层 await import**。别人机器上没有这个路径 ⇒ 该 import 抛错 ⇒ 本模块加载失败
  ⇒ index.js 的 load('pg-jobport.mjs') 落到 catch ⇒ **每次调用都回「插件运行时模块加载失败」**。
  工具在工具表里、却完全跑不动。作者本机因为路径恰好存在，一直测不出来。
- **修法**：① 去掉硬编码，改为**多种候选位置运行时解析**（裸包名 → DSH_CHECKOUT → %APPDATA%/npm
  → 从宿主入口脚本 argv 推导 → node 同级的全局 node_modules）；② **全失败也不抛**，
  降级到 spawn + taskkill /T /F 的等价实现（接口与 win32 作业对象版一致）；
  ③ 新增 DSH_BASH_FORCE_FALLBACK=1 强制降级开关，便于自测与排障。
- **实测两条路径**（同一台机器）：win32-job 与 fallback-taskkill 均 exitCode=0、输出正确、超时终止有效。
- 顺带清掉产物里的其它本机痕迹：runtime/manifest.json 的 source（D:/other/Git → bundled），
  以及调试时遗留在 runtime/tmp/ 的 3 个 json。

## v0.7.3 — 2026/09/25（**主线 · 正式版 · 开关修复**）

作者：啃轮胎的西狐

修掉 0.7.2 里两个**用户看得见**的缺陷（均由真机复测指出）：

- **开关关不掉**（严重）：设置与 /status 都显示 false，工具表里却还有 bash，而且照样能跑。
  · 根因不是某行写错，而是**判据本身**错了：它问的是「模块实例记不记得自己注册过」
    （typeof dispose === function，而外层 effect 的返回值靠不住），而不是「工具表里到底有没有」。
  · 修法：① 用**布尔标志**记状态，不依赖返回值类型；② 判「有没有」以**工具表实测**优先；
    ③ 注销之后**再实测一次**确认；④ 关键——**真正的注销器是 bash 内部那个 effect 的 dispose**，
    外层包一层拿不到它，改为**拦截 effect、收集内层注销器**。
  · 实测往返：true → 表 75 / 含 bash；false → 表 74 / 无 bash，可反复切换。
- **卡片外观与原插件不一致**：内置后 bash 调用卡片回落成宿主的通用工具样式。
  · 根因：一个插件的 client 入口**只有一个**，原卡片的注册写在 bash 自己的 client 里，
    并入本包后**没有任何地方加载它** ⇒ 那次注册从未执行。
  · 修法：把原组件**原样复用**进本插件 client 入口（同一份代码，不另做一套），注册同一个 key：bash；
    并补上原插件有、本包缺的 dsh.client.external = [dsh-client-ui-primitives]（取宿主终端原语）。
- 新增回归测试 test/bash-toggle.test.mjs（4 项）：专守「关掉之后工具**真的**从表里消失」，
  以及开→关→开→关 的往返与幂等。

## v0.7.2 — 2026/09/25（**主线 · 正式版 · 内置 Bash**）

作者：啃轮胎的西狐

- **内置 Bash**：原独立插件 dsh-bash-runtime 的实现与运行时并入本包（lib/bash/ 与 runtime/）——
  装上这一个插件就有 bash，无需再装第二个插件。
  · 注册改为**裸 tools.register + 对象根 JSON Schema**：原来依赖宿主的 defineTool / schemastery，
    而这两个包在 tgz 装配环境里解析不到 ⇒ 模块 import 整体失败 ⇒ **bash 工具静默消失**。
  · **详情面板新增开关**：关掉＝**不注册该工具**（模型看不到），不是注册了再拒绝执行；
    开关走 onSettingsWritten 钩子按差额同步，**改完即生效**，不需要重启或重载插件。
- 上一版（0.7.1-beta.1）的策略改动全部保留：三档拉开、控制面信息移出上下文、质量解释=结果方向、
  可逆实现默认、思维层可读进度。
- **验证**：48 套 / 645 项全绿；check-docs --strict 全绿；卸载独立 bash 插件后内置工具仍可用。

## v0.7.1-beta.1 — 2026/09/25（**主线 · 预发布 · 策略与呈现修复**）

作者：啃轮胎的西狐

- **三档真正拉开**（`lib/settings.js`）：补充程度（700 / 1200 / 2000 字）与自主预算（1 / 2 / 3 个问题）
  两个维度逐级递进。此前 `minimal` **从未被任何档位使用**、且 standard 与 heavy 的 detail 相同
  ⇒「重度」实际只等于「标准 + 多问 1 个」（用户 2026-09-24 实测反馈后查证属实）。
- **内部控制面信息移出工作上下文**（`lib/compiler.js`）：注入头部原先带「任务 `default` · 意图修订 N」，
  会被工作模型当成任务语义处理（伪语义与锚定）；现已移除，元数据仍留在宿主 state 与 wire 台账里。
- **质量解释改为「结果方向」**（`lib/interpreter.js` 规则 2）：不把零件、参数、材质、后期效果逐项列成清单；
  一个示例就够，示例不是验收项，同一方向不拆成多条。
- **可逆实现默认**（`lib/interpreter.js` 规则 3）：可逆细节写 `implementation_option` 并说明「默认取什么、为什么可逆」；
  **不可逆的产品方向**（联网与否、交付形式、功能范围、审美取舍）仍只能写 `unknown`。
- **思维层不再显示裸 JSON**（`lib/client.js`）：无 reasoning 时把结构化补丁解析成可读产出条目
  （中间一版只报「已产出 N 字」＝留白，用户反馈「直接没有思考过程了」，同样不可接受）。
- **验证**：48 套 / 645 项全绿；`check-docs --strict` 四条门禁 ✅。
- **未验证（如实登记）**：本版的档位差异是**可测的配置差异**，**不等于效果已被证明**——
  此前的留出评估只跑完 S1（两臂没测出差），等级仍是「实验构建」。

## v0.6.10 — 2026/09/24（**主线 · 正式版 · 兼容性修复**）

作者：啃轮胎的西狐

- **修掉 0.1.7 的第二处契约破坏：工具结果的消息形状**。上一版（0.6.9）修的是投递消息的 `source.kind`；
  发完之后按台账复核，发现**开了「只读工具」的每一轮都断在工具循环第 2 轮**。
  证据：`~/.dsh/po06-wire.jsonl` 按部署时点切分——`signal is not defined` 的最后一条在 09-24T00:59Z（部署前），
  部署后 4 行 `rounds = 1..2`、`calls = 2`（**修复生效、循环真的跑起来了**），但**全部**带
  `llm-error: DeepSeek Messages cannot represent user/tool-result content`（`code: UNSUPPORTED_CONTENT`）。
  根因：0.1.7 起工具结果是**一等 `role:'tool'` 消息**
  （`createToolResultMessage({callId, content, isError})`，内容块**直接**是 content、id 由工厂生成），
  而循环仍在造 `role:'user'` + `tool-result` 块并手搓字符串 id。**这条路径此前零测试。**
- **形状只在一处决定**：`lib/llm-lib.js` 新增 `toolResultShape(mod)` —— 有 `createToolResultMessage` ⇒
  `tool-role`；只有 `createUserMessage` ⇒ `legacy-user-block`；**都没有 ⇒ 不猜**（不造消息、循环自然收敛、
  由调用方回落）。`lib/read-tools.js` 的结果消息与"助手请求工具"消息都改走它。
- **顺手修掉一个一直存在的接线缺陷**：`loadLlmLib` 的 `env` 默认空表，而生产调用点从没传过
  ⇒ `DSH_PO06_LLM_LIB` 这类显式覆盖**永远读不到**。现在两处调用点都显式传
  `{env: process.env, argv1: process.argv[1], cwd: process.cwd()}`。
- **验证**：全套 **46 个测试文件 / 620 项全绿**；变异检验 **221 个 / 40 个源文件 / 漏捕 0**；
  `check-release` 全绿。新增守卫（`test/read-tools.test.mjs` 8 → 10）：工具结果必须是 `role:'tool'`
  一等消息、**不得再出现 `tool-result` 块类型**、旧形状退回、形状未知时不造消息；
  配套夹具 `test/fixtures/llm-lib-017.mjs`（按 0.1.7 导出对齐的假宿主模块）。
- **未验（如实登记）**：**真机复验**——判据是一次真实拦截后台账里 `toolLoopError` 消失且能拿到包，
  这一步只能由人在真实对话里触发；观感类结论需真人看；**专业跑分 / 留出评估仍未完成**（只跑完 S1），
  B 臂（冻结的 0.4.4 对照）**成本基线仍缺失**。

## v0.6.9 — 2026/09/24（**主线 · 正式版 · 兼容性与缺陷修复**）

> ⚠️ **本版发布当天即被 `0.6.10` 取代**（同日按台账复核抓出 0.1.7 的**第二处**契约变化：工具结果的消息形状）。
> 装最新版请用 `0.6.10`；本条保留作为当时的事实记录。

作者：啃轮胎的西狐

- **适配宿主 `dsh 0.1.7-rc.1` 的会话格式 v4**（**ADR-0087**）。宿主把会话日志升到 v4，而 v4 的**准入校验会明确
  拒收**我们过去投递通知用的旧来源名——这不是风格过时，是**写入会话日志那一步会抛错**。
  依据读的是宿主源码：`dsh-session-format-v3-to-v4` 里
  `if (… || value["kind"] === "plugin") throw new SessionFormatError("format v4 message requires a producer-owned source kind")`。
  现在投递来源固定为 **`kind: 'plugin:@dsh-external/dsh-po06'`**（宿主迁移表 `producerKind()` 给第三方插件的规范名），
  并去掉 `plugin` 字段。**对两代宿主都成立**：0.1.6 的 v3 对用户消息 kind 不设白名单；"绝不自我触发"那道闸
  本来就是正向白名单（只认 `kind === 'user'`），换名字不会漏；0.1.6 界面也从未特判 `kind === 'plugin'`。
- **台账仪器兼容两代形态**：`scripts/dump-wire.mjs` 新增 `producerOf()`——旧形态取 `plugin` 字段、
  `plugin:<包名>` 归一到裸包名、真人消息不算插件贡献。**只认一代就等于换宿主后旧台账全读不出来**
  （仪器报错方向最危险，ADR-0034）。
- **只读工具（「只读工具:开」）链路补齐**，并配 `test/read-tools.test.mjs`（8 项）。
- **验证**：全套 **46 个测试文件 / 618 项全绿**；变异检验 **221 个 / 40 个源文件 / 漏捕 0**（源文件字节还原）；
  `check-release` 全绿（含打包自足性与文档漂移门禁）。新增守卫：投递来源不得再用被 v4 拒收的 `plugin`（静态守卫，
  注释里允许也必须讨论"为什么不能这么写"）、线缆仪器两代形态单测（旧形态 / 新形态 / 混代台账 / 真人消息排除）。
- **发版过程中抓到并修掉的两处**（都会骗人，所以记下来）：① **测试夹具跟不上产物形状**——
  `check-install` 的假包 `package.json` 只有 `name`/`version`，而宿主 0.1.7 **在装配前会检查 `dsh.bundle`**，
  于是夹具里的包被整块跳过、装配树为空，三条"应放行"用例全红；夹具改成**从仓库那份派生**（只覆盖 `version`）
  并补上包根的两份手册。② **一个变异体长期存活**——删掉"缺 `cordis.patch.yml` 就拦"后，用例的三条断言
  照样全绿（宿主自己也拦了，装配树本来就是空的）；现在断言直接咬住脚本自己的判定出口（`--json` 的 `problems`
  必须点名 bundle 层），**不写死正文措辞**。修完 5 个 `checkinstall` 变异全部被抓住。
- **未验（如实登记）**：0.1.7 上的**真实投递**只到"按宿主源码与迁移表改对形状 + 有守卫"，
  端到端（真模型、真会话）**仍需一次实跑**才作数；观感类结论需真人看；**专业跑分 / 留出评估仍未完成**
  （只跑完 S1），B 臂（冻结的 0.4.4 对照）**成本基线仍缺失**。

## v0.6.8-stable — 2026/09/22（**主线 · 正式版**）

作者：啃轮胎的西狐

- **修掉"思考完却拿不到包"（no-packet）**。台账取证：28 条 `noop` 里 **26 条**的原话只有两个字，
  同一句话反复重试**每次都空**（有会话连续 16 次）——这不是抖动，是"模型交了空产出，宿主照收"。
  现在：① 空产出（空 `ops` / 没吐 JSON）**有界重试一次**（把"你上一轮交了空产出"明确告诉解释层）；
  ② 仍空 ⇒ 宿主补一条**关于这轮原话本身**的待确认条目（`unknown`，不发明要求、不拦下游）⇒ **这一轮必有包**；
  ③ 条目超单轮上限：**截断记账**（原来整轮作废）；④ 销账指向不存在的条目：**逐条丢弃**；
  ⑤ 用户点「跳过/取消」**不再被记成解析失败**（abort 判定提到解析之前，单列 `empty-completion` 与 `aborted`）。
- **浅色模式**：界面颜色改为**由主题驱动**（一份 token 表、两套取值）。两个真因都修了：
  ① 主题信号从 `documentElement` 读，而宿主的 token 写在 **`body`** 上 ⇒ 读空 ⇒ 被判成深色
  （所以"浅色模式看着跟深色没区别"）；② token 选择器只覆盖"标记在自身"，插件里思维层/折叠体**各自**
  带 `data-po06` ⇒ 各自重新声明浅色 ⇒ **深面板里嵌一块浅底**。现在：`body[data-ds-dark-theme]` →
  根 `color-scheme` → 文字亮度三级判定（都读不到按浅色），深色规则同时覆盖"自身/祖先/宿主属性"三条路径。
- **语言跟随 DSH**（`zh`/`en`，含 `?` 手册；改设置即时切换、不用刷新）——本版把界面文案全部收口到中英对照，
  并给英文适配补了静态+运行时守卫。
- **启用判定修对**（`gate:rollout-off` 调查结论）：`rollout` **缺失或写错**时不再把显式 `enabled:true`
  的插件**静默关掉**（只有**显式** `{mode:"off"}` 才是不启用）；顺带修了 `normalizeRollout` 不幂等
  （第二次归一化会把"回落来的 off"洗成"用户显式 off"）。`/status` 增加 `gate` **结论分布**，
  把"配置意图"与"闸门实际放行"分开显示。
- **修掉一次"配置被重置"的数据丢失**（真机发现：`/status` 显示的设置与文件里写的对不上；随后配置被一次设置写入**重置成默认值**，
  `settingsVersion`/`enabled`/`rollout` 三个"启用意图"字段被**静默抹掉** ⇒ 插件不再被认作 0.6 自己的配置
  ⇒ **明明开着却什么都不做**，也就是用户报的 `gate:rollout-off`）。根因是 **BOM**：Windows 上 PowerShell / 记事本写出的
  UTF-8 带 BOM，而设置读路径没剥 BOM（EV-0132 只给 `parseEnableIntent` 补过）⇒ `JSON.parse` 抛 ⇒ 配置被当成"空的"
  ⇒ `writeSettings` 拿空对象合并后写回一份**只有设置项**的文件。
  现在：① 配置读取一律先剥 BOM（`parseJsonText`，设置读路径与 `/status` 共用）；
  ② 万一真的读不出来，先从**最近一份可解析的备份**里把启用意图字段捞回来，并**如实上报** `gateRepaired` / `recoveredGateFrom`；
  ③ 无论如何都保证 `settingsVersion` 标记在（它只是"这份配置是 0.6 写的"，不含任何启用决定）。
  守卫：带 BOM 的配置照常读（不许当空配置重写、不许丢字段）；坏配置写入后启用意图字段必须从备份恢复。
- **验证**：全套 **46 个测试文件 / 618 项全绿**；新增守卫包括 WCAG 对比度（浅/深两套都算）、
  主题信号三级判定、"空产出必有包"、"关档不注入"、"客户端读过的服务必须声明 inject"、BOM 容错与配置字段保全。
- **未验（如实登记）**：观感类结论需真人看；**专业跑分 / 留出评估未完成**（只跑完 S1）——作者的日常实测观察
  （DeepSeek-V4.1-Flash + PTC + PowerShell：one-shot 与长任务迭代效果明显强于同环境同提示词，少量项目统计疑似降低
  token 消耗）见根 README 的「诚实声明」。

## v0.6.8-beta.2 — 2026/09/22（已被 `v0.6.8-stable` 取代 · 英文适配 + 对外文本对齐版）

作者：啃轮胎的西狐

- **英文 UI 适配**：界面语言**只跟 DSH 的语言设置**（`设置 → 通用 → 语言`，`zh`/`en`），插件内**不设**语言
  开关；客户端文案全部走 `L(中文, English)`（49 条），`?` 用户手册按语言取宿主 `GET /help?lang=zh|en`，
  新增 `po06/HELP-0.6.en.md`（带同一 `po06:help-start` 区间标记）并进 `files` 白名单。英文界面不再夹中文。
- **语言探测按真机契约重写（发出后 30 分钟内发现并原地重发）**：`ctx.locale` 是 DSH 的 **LocaleFace 实例**
  （`dsh-client-locale/lib/client.js` 里 `ctx.provide("locale", locale)`），语言在 `getSnapshot().active`；
  第一版按 `v.locale/v.name/v.id/v.language` 猜属性 ⇒ 真机上**永远读不到** ⇒ 恒中文（英文适配等于没做）。
  现在：读 `getSnapshot().active`（兼容 `getLocale()/snapshot.active/字符串` 三种形态，拿不到才回中文），
  并 `subscribe()` 订阅语言变化 ⇒ **在 DSH 里切语言，插件界面即时跟着换，不用刷新页面**。
  > 首发字节（tag 指向 `6f9b972`）已被本次重发取代，tag 与 Release 都指向含本修复的提交；首发字节不再对外。
- **修一次真机白屏崩溃（用户报告："dsh 突然崩溃"、界面停在 `Failed to load plugins`）**：客户端 `apply()` 读
  `ctx.locale`（语言适配）却只声明了 `exports.inject = ['slots']` —— **cordis 对未 inject 的服务 getter 是抛错**
  （`cannot get property "locale" without inject`），于是客户端 entry 进 `FAILED`、引导层整页白屏。
  两条一起修：① `exports.inject = ['slots', 'locale']`（写**服务名**，与宿主客户端插件同一写法）；
  ② 读服务一律走包住的 `readSvc()`，`detectLocale` 也套 try/catch —— 万一某个 profile 没有 locale 服务，
  最坏是**用中文兜底**，绝不再整页崩。
  > 回归守卫（防同类再犯）：① 静态——**代码里读过的每个 `ctx.<服务>` 都必须在 `exports.inject` 里声明**；
  > ② 运行时——用**照 cordis 语义的 ctx**（未声明的服务读就抛）驱动 `apply()`：没有 locale 服务时要照样注册满
  > 3 个插槽、语言回落中文；有 locale 服务时按它定语言。这一版是**同一版本号的第二次原地重发**（首发：缺语言
  > 契约修复；次发：缺本次崩溃修复）。
- **README 对外文本与版本对齐**：更正 0.5 线的版本号（**最后发布 `v0.5.0-beta.1`**；仓库内 0.5 源码版本号
  `0.5.2-beta.1`，未曾单独发 Release）；0.5 的安装不再指向 `releases/latest`（那一页现在是 0.6 线、资产名
  不同 ⇒ 404），改为钉 `v0.5.0-beta.1` 直链；英文 README 结构对齐中文（0.6 在前，0.5 设计说明移入附录并
  标明边界）；两处 README 的 0.6 之前更新日志条目移除，统一指向本文件。
- **测试门禁**：`po06/test/wire.test.mjs` 的两条历史断言按现状改写（覆盖提示词从"全等"改成"以覆盖文件开头 +
  追加会话上下文"；自检判空的静态定位改成锚在自检独有的分支上，不再被同名的变量声明带偏）⇒ **全套 45 个测试
  文件全绿（585 条断言）**，`check-release` 的阻断项从 4 条降到 1 条（只剩变异检验输出解析）。
- **未验**：观感类结论需真人看；真机 + 真模型端到端与效果对比未跑；**本版没有任何"效果更好"的证据**。

## v0.6.8-beta.1 — 2026/09/22（已被 `v0.6.8-beta.2` 取代 · 对外文本对齐版）

作者：啃轮胎的西狐

- **代码与 `v0.6.7` 等价**（没有新增行为改动）；本版按用户要求改用 beta 号发布，
  并把**对外可见的文本**（Release 说明、README 中/英、本 CHANGELOG、仓库描述）与这一版对齐。
- **README 的安装方法已按本版真跑一遍**（隔离 home）：从 Release 直链下载 ⇒ sha256 与 `SHA256SUMS` 一致
  ⇒ 建干净 profile ⇒ `dsh plugin add`（`dependencies` 与 `dsh.profile.bundles` 都写入）⇒
  `check-install --expect-version 0.6.8-beta.1` ⇒ **33/33 lib 与仓库逐字节相同 · 装配树含该层 · ✅ 可以开始试了**。
- **未验**：观感类结论需真人看；真机 + 真模型端到端与效果对比未跑；`check-release` 仍因 `wire.test.mjs`
  2 条过时断言而阻断；**本版没有任何"效果更好"的证据**。

## v0.6.3 ~ v0.6.7 — 2026/09/22（**补记**：这几版当时只登记在 `po06/RELEASE-CHECKLIST.md`，没写进本文件）

- **v0.6.3** 拦截弹窗拖拽回归修复：入场动画的 `transform` 填充盖住了拖拽写的**内联 transform**（关键帧改成只碰 opacity）。
- **v0.6.4** 位置夹紧不再把面板钉死（面板高于视口时旧式夹紧恒等于 8）；引文判据从"整轮作废"改成"只丢那一条并记账"。
- **v0.6.5** 控件栏收成「优化选项」按钮 · **撞 id 改名不再判死整轮**（no-packet 真因：解释层每轮从 `req-1` 起编号，
  而旧条目只退场不删除）· **跳过/取消之后真的停**（连接断开 ⇒ AbortSignal ⇒ 提交前闸门 + 模型调用随信号中止）。
- **v0.6.6** 「优化选项」弹层可见（`position: fixed` 却没给坐标 ⇒ 落在看不见的地方）。
- **v0.6.7** 面板控件**铺满整格**且点击范围与视觉重合 · 模型下拉不再白底白字（跟随主题 `color-scheme`）·
  **DSH 主题副色**克制用在选中/悬停/键盘焦点三处。

## v0.6.2 — 2026/09/22（**主线**）

作者：啃轮胎的西狐

- **拦截弹窗：功能性区域不再被裁** —— 正文区从 `overflow:hidden` 改成 **`overflow:auto`**，内容装不下时
  由**这一处全局滚动**（就是 0.5.x 的那根滑块；细、低调、悬停才明显）。面板本身 `maxHeight: min(78vh,660px)`
  并随窗口重新夹紧（自适应）；思维层仍是它自己那个固定窗口（内部滚动条隐藏）⇒ 不会回到"两根可见滑块"。
- **交互反馈与极简动效**（注入一小段样式表，卸载即摘）：所有插件按钮 130ms 过渡 + 悬停/按下/键盘焦点/禁用态；
  浮层入场 140ms 上浮淡入 · 运行中状态灯呼吸 · 思维层新内容 180ms 淡入；`prefers-reduced-motion` 下一律关闭。
- **观感**：圆角 12→14px、阴影更收敛；配色继续沿用 DSH 自己的变量（`--dsw-*`），浅色/深色主题与 DSH 一致。
- **未验**：无截图证据（我无法对 GUI 截图），观感与动效幅度**需真人在真窗口里看一眼**；
  全量 45 套 · 44 通过（唯一未过是 `wire.test.mjs` 里 2 条早已过时的断言）。

## v0.6.1 — 2026/09/22（**主线**：0.6 线，包名 `@dsh-external/dsh-po06`）

作者：啃轮胎的西狐

- **这是主线**：默认分支 `main` 与最新 Release 都是它；0.5 线（`v0.5.x`）保留在下方历史与 tag 里，仍可用但不再更新。
- **每轮独立产生目标，不遗传**：每轮开始把上一轮的条目与待问问题整体退场（`stale`，留档不删除），
  本轮的包只由「你这轮的原话 + 本轮读入的会话上下文」重新得出 ⇒ 不会再出现"上一轮早已解决的问题又被要求一次"。
  **代价**：长期约束（"只交单个文件""别动别的文件夹"）也要靠上下文每轮重新看出，别把「上下文」调得太小。
- **界面对齐 0.5**：档位 `关闭/轻度/标准/重度` · 两行控件栏 · `?` 用户手册 · 拦截浮层分**思维层 / 产出层**
  · 思维层**固定显示范围、无滚动条、正文不截断**（可往回滚，自动跟到最新）。
- **token 计数**：只用 provider **真实上报**的 `入 / 出 / 缓存` 三分量（过千记 `k`/`M`，拿不到就显示 `—`，从不估算）。
- **只读工具那条必现故障的真因（三条）**：解释层标识符笔误 `TOOL_SYSTEM_NOTE is not defined`；
  一条写坏的来源引用能弄死整轮（`kind:'tool'/'file'` 的 `toolCallId`/`uri` 只有宿主才有 ⇒ 现在只补宿主能机械核对的事实、其余逐条丢弃并记账）；
  `provenance:'machine'` **从未生效**的顺序缺陷。
- **移除**「条目与结案」面板与其宿主通路（目标每轮自动产生，不再需要人工勾选）。
- **文档**：根 README（中/英）改为以 0.6 为主线并写明 30 秒安装；`po06/README.md` 给出照抄即可的下载+安装+自检；
  `?` 帮助写明"不遗传"及其代价。
- **未验**：全量 45 套 · 44 通过（唯一未过是 `wire.test.mjs` 里 2 条早已过时的断言）；真机 + 真模型端到端与效果对比未跑。
  **本版没有任何"效果更好"的证据。**

## v0.5.2-beta.1 — 2026/09/19

作者：啃轮胎的西狐

**交付门（机器替员工验）：任何被 present 的网页类交付物，落盘后由宿主侧真机打开一次，写成机器裁决——不再采信模型的"Everything is verified."** 权威定义见 [SPEC.md](SPEC.md) §0⁵。

**病根（会话日志可复核 · `session-7df19a05`）**：工作会话在 **workspace-write** 档下交付前两次尝试 `msedge --headless --screenshot`，两次都是 `SHOT_MISSING` + `Program 'msedge.exe' failed to run: Access is denied`——**它从没见过自己的产物**；随后退回静态检查（标签平衡 / 19 个 script 块 / 0 处外链）并写下 **"Everything is verified."**。而那两个文件里有：

1. **三层着色器拼装 bug**（`mbt-m1a2-sep-v3.html`）：① `<script>` 块首是换行 → `textContent.indexOf('//@common') === 0` 永不成立 → 15 个块拿不到公共块（含 `#version 300 es`）→ 按 GLSL ES 1.00 编译 → `'layout' : syntax error`；② 只修①会撞上"公共块自己也带换行 → `#version` 落到第 2 行 → ANGLE 报 must occur on the first line"；③ 公共块里的 `fwidth/dFdx/dFdy` 是片元专用，却拼进了 6 个顶点着色器。
2. **画布 0×0 的必现黑屏**（`tank.html`）：`resize()` 先写 `canvas.width=APP.cw` 后算 `APP.cw`（且 `APP` 无 `cw/ch` 初值）→ 0；启动处又 `APP.cw=APP.canvas.width` 把算好的值覆盖回 0 → `viewport=[0,0,0,0]`，263 draw call / 531k 三角照跑，画面必然全黑（**真实 GPU 148fps 同样全黑**，与软件渲染无关）。

**机制**：`deliverables/presented` → 宿主侧无头浏览器 + CDP（Node 内置 WebSocket，零依赖）→ 采**页面自己的覆盖层文案** + JS 异常/console.error + 画布后备缓冲尺寸 + **帧内**（rAF 里 `readPixels`）中心像素 + 现场截图 → 判定 `fatal-overlay` / `page-error` / `blank-canvas-0` / `blank-canvas` / `ok` / `skipped` → 存 `/gate`；硬失败把**实测证据**回注该会话下一轮（`sessionController.prompt(mode:'queue')`），**同一交付物同一版本只回注一次**，`/gate?rework=0` 可关。

**两个实测踩到的坑（都写进实现）**：① **不许一见覆盖层就判死**——`mbt-m1a2-sep-v3.fixed.html` 在 2s 时 DOM 里还挂着上一次尝试的"初始化失败"，45s 时已在 165fps 跑场景 → 改为"只在确实好了时提前收工，否则跑满预算按最后一次采样判"；② **不用 `--virtual-time-budget`**——它把定时器按虚拟时间快进，页面自己的 watchdog 会在真实渲染完成前触发，把好页面判成"初始化超时"。

**实测验收**：`mbt-m1a2-sep-v3.html` → **fatal-overlay**（原文带 `[scene.vs] ERROR: 0:3: 'layout' : syntax error`，21s）；`tank.html` → **blank-canvas-0**（21s）；两个修好件 → **ok**（**4.0s**，提前收工）；`present` 事件自动触发链路两件全中（好件 3.2s / 对照件 21s 且 `注入=injected`，测试用返工条已 `/queued/remove` 撤回）。

**新增取证/修复工具（全部只读或只写副本）**：`render-probe.cjs`（真机渲染探针，含 `--gpu` A/B）、`diagnose-shader-bug.cjs`、`audit-shader-assembly.cjs`、`fix-shader-assembly.cjs`、`fix-canvas-resize.cjs`、`session-of-artifact.cjs`（找产出会话并回答"交付前它跑没跑"）、`probe-black-expr.js`、`probe-artifact-state.js`。

**验证**：`verify-delivery-gate.cjs` **30/30**（必现坏一个不漏；好页面零误判；返工只在该发时发、同版本不重复、关掉真的一条不发）；`verify-capability-facts.cjs` 25/25；既有套件全绿。

## v0.5.1-beta.1 — 2026/09/19

作者：啃轮胎的西狐

**能力事实（实测，不猜）：给每个会话注入一段"本会话现在到底能做什么"的实测事实。** 与任务无关的通用机制，走**运行时事实通道**（`systemPrompt.context`，order 118），对 0.4.4 策略正文**一字未动**。权威定义见 [SPEC.md](SPEC.md) §0⁗。

**病根（会话日志可复核）**：工作 AI 手里**没有一句"我这条会话现在能做什么"的实测事实**，唯一证据是自己那一次尝试——而三种失败在它眼里**一模一样**：

1. **真被拒**（受限档）：`Program 'msedge.exe' failed to run: Access is denied`；
2. **假失败·异步落盘**：浏览器启动器 **106ms 就返回**，截图 0.3–1s 后才出现 → 立刻 `Test-Path` ＝ `NOFILE`（本插件作者排查时**自己也先踩了一次**）；
3. **假失败·参数被吞**：已开着的浏览器实例接管，回一句中文「…会话中打开。」（日志里的乱码就是它）。

**实证**：会话 `04ade894` 06:54 受限档下被真拒 → **07:05 用户切到 danger-full-access** → 07:24 它仍在汇报「本机沙箱禁止启动浏览器」，中间 **18 分钟一次都没重测**；`4cd41964` 在已是全权的会话里还去申请提权，拿到 `sandbox escalation … is not strictly wider`（读起来像"你没被授权"，实际意思是"你已在最高档"）。工具说明里那段受限档警告的判据是 `escalationModes.length > 0`（`dsh-tool-pwsh/lib/index.js:229`，只要配了部署默认档即为真）——**与当前档位无关**，全权会话里它全是假话，却比"不限制文件修改"那一句长得多。

**解法**：每次装配注入一小段实测事实——① 权限档 ＋ 审批（`never` ＝ **没有任何操作需要审批**，不是"没有权限"）；② 三个**通道**实测：`子进程`／`视觉截图（无头浏览器）`／`外部工具服务器`，✗ 一律带**原始原因**；③ 一条通用规则：**失败不是结论**（只能由当场复测确认；档位或环境变过，旧结论作废；能自动验证的**不许交给用户**）。

**实测三档（同一台机器、同一分钟，`/prompt-optimizer/api/capability?sessionId=…&probe=1&mode=…` 可复核）**：

| 档位 | 子进程 | 视觉截图 | 注入文本里的原始原因 |
| --- | --- | --- | --- |
| danger-full-access | ✓ | **✓（msedge.exe 1s 出图 3797B）** | —（并附"受限档警告在本会话不适用"一句） |
| workspace-write | ✓ | **✗** | `Program 'msedge.exe' failed to run: Access is denied` |
| read-only | ✓（**受限语言模式：.NET/Add-Type/COM 不可用**） | **✗** | crashpad `file_io_win.cc` 创建文件被拒 |

**工程约束**：探测**不阻塞装配**（首次渲染 <20ms 返回，结果下一步补上）；缓存 key ＝ **档位**（**切档必然重测**）；TTL 10 分钟；探测脚本自带三个坑的解法（私有 `--user-data-dir` ＋ 软件渲染 ＋ **轮询等落盘**）；注册失败只留痕，不拖垮插件。

**取证工具（本次新增，全部只读）**：`evidence/zstd-frames.cjs`（Node 只解第一帧，这里按 magic 切帧逐帧解：28MB/18565 帧/1.1s，0 坏帧）、`evidence/browser-launch-timeline.cjs`（档位变更事件 vs 浏览器启动尝试按时间对齐——**取最后一次档位会把受限档的失败误记到全权档头上**）、`evidence/survey-permission-claims.cjs`（647 会话全量普查）、`evidence/session-facts-audit.cjs`、`evidence/recent-verify-audit.cjs`。

**验证**：`evidence/verify-capability-facts.cjs` **25/25**；既有套件全绿：`verify-tier-strategies`（三档＝三套策略、极端档＝0.4.4 原样、交付只投影两行）、`verify-context-scope` 13/13、`verify-run-context` 15/15、`verify-read-tools` 8/8、`verify-ask-contract`、`verify-closing-check` 7/7、`verify-length-gate` 6/6、`verify-i18n-parity` 201/201、`dsh-compat-now` 19 探针全在位。

## v0.5.0-beta.1 — 2026/09/18

作者：啃轮胎的西狐

**架构基线 v0.5：优化器从"提示词作家"改成「依据搬运 + 缺口补齐器」。** 权威定义是 [SPEC.md](SPEC.md)；`DELIVERY.md` / `PROMPT-OPTIMIZATION.md` 等旧文档自本版起降级为历史记录。

**为什么要改（判据错位的复盘）**：前几轮加的全是"优化器自己该怎么表现"的规则（档位轴、形态投影、身份层、i18n、字数基线），验证也全是**自证**的（投影不变、条款在位、字数对得上）——**没有一条验证在回答"下游一次能不能做对"**。而真实失败是"一半概率连正常目标都做不到、坦克有渲染问题"，那是**能力 + 一次性执行**的问题，不是措辞问题。按模型特性重定方向：v4.1-flash 这类**不主动、不猜、一次做完**——没写进去、它又推不出来的就是**必然缺失**；写进去的它**一定照做**（提示词不是建议，是**指令集**，多写一条就多一条硬约束）。

1. **契约层重写（先砍）**：`V6_CORE` 改为【前提／依据／只补这五类／范围／歧义／不要写／语言】。**五类缺口**＝① 指代与定位 ② 验收判据 ③ 约束与边界 ④ 隐含决定 ⑤ 入口与锚点。删掉"输出结构：目标 → 现状事实 → 步骤"这类**形式模板**、`验收（≤3 条，可机器判定）`、以及全部**没有具体指向**的验证套话（"请充分验证／请自测"）。档位正文同步瘦身：组织方式与篇幅仍由交付形态投影，其余只留"依据预算"。逐行差异见 `evidence/diff-v6-prompts.cjs`（本轮对照 `evidence/v6-prompt-baseline-beta6.json`）。
2. **档位 ＝ 依据预算**（不是文风）：普通＝只用原话＋上下文（补①②）；高级＝按需读项目文件（五类全补）；极端＝深读交叉核对（五类全补 ＋ **每条改动带出处** ＋ 正向丰富）。轴语义重锚：`depth` = `precise` / `grounded` / `exhaustive`（旧 `phased` 的"分阶段"语义取消；阶段↔清单由 ④ 组织方式表达）。**模型、reasoning effort、上下文开关三者与档位解耦。**
3. **上下文机制（W1b）**：范围**只由 UI「回合／全文」决定**——回合＝最近 N 个用户回合（**用户一次 ＋ AI 一次 = 1 回合**；**0 = 不读**，不再被兜底成 1）；全文＝与工作 AI 现在看到的一致的那份**会话投影**。**预算不足只降详细度、不改范围**（双方全文 → 助手截断 → 助手省略 → 逐条截断），只有最简形式仍放不下才由远及近丢范围**内**的条目并写明丢了几条。**解析不到会话就不注入**（删掉 `renderObserverBlock` 里"回落到列表里第一个会话"的隐式路径——那是同一类"猜"的病根）。注入块显式声明**旁观者身份**（"你是旁观者与指挥者，不是执行者"），否则优化 AI 会以为自己是干活的。
4. **依据索引**（原"证据账本"）：工具结果按**依据类型**分开——**读到内容**的文件（可引用内容与位置）、grep **命中**（可引用 `路径:行号`）、**只列过目录**的文件（只能陈述"存在"，**不得**描述里面写了什么，SPEC 明令）；并要求把出处写进命令。分类在工具循环里结构化落进 `toolLoopDebug.evidencePaths / evidenceHits / evidenceListed`。
5. **一次交付可用率（唯一目标指标）**：`POST/GET /outcome` ＋ 迷你窗产出后的「成了 / 要返工」两个按钮——记的是**人给的裁决**，不推断、不自评；分档位统计便于看"档位到底有没有用"。
6. **验收工具（可证伪）**：`verify-context-scope.cjs`（上下文范围桩单测 **13/13**）、`audit-provenance.cjs`（**出处审计**：产物引用的路径必须在依据索引里；无出处的事实性断言＝缺陷）、`compare-referent.cjs`（**同题对照**：长迭代里一句「修复这个 bug」有／无上下文）、`snapshot-v6-prompts.cjs` 重冻**必须带 `--reason`**（防止悄悄改判据）。
7. **判据调整（如实记录）**：`delivery=chat` 逐字节不变**不再是验收**（契约层已按 SPEC 重写），降级为**回归护栏**：基线重冻（`spec` / `reason` 落盘），上一版存档 `evidence/v6-prompt-baseline-beta6.json`。

**实测（本轮，会话 `D:\0中转站\html`）**

- 真实场景 A/B/C **9/9**：工具根＝该会话目录；产出无假事实 / 无"已核实" / 无事实段；不给 sessionId → 不派工具、不注入观察者（`no-session:no-session-id`）；未设置形态 → `default-ptc` ✓；v5 对照仍短（0.4.3 体量特征）。
- 同题对照「修复这个bug」：**有上下文 468 字 / 无上下文 578 字**——两边都先声明"**未找到指代来源**"，再给**一个**最小发现动作（有上下文时用上了上一轮的 `tank.html` 线索）。**同一题在改前是 2201 / 1009 字的"通用流程填充"**——这正是"几百上千字乱猜、反而误导原 AI"的实测病灶。
- 出处审计（真实任务"让坦克的炮塔能独立转动"，只列过目录、没读到内容）：产物 2344 字 / 22 条目，**无出处的事实 0 处**，且产物自己写明"我这次只拿到目录清单、没读到任何文件内容"。

**已知边界（如实记录）**：出处审计是**启发式**判据（词表 + 结构），本轮它自己就误报过三次（否定句"其中没有 tank.html"、`HTML/CSS/JS` 缩写、条件句"若已有"），三条都已修进脚本；它的作用是"把可疑行挑出来给人看"，不是自动定罪。

## v0.4.6-beta.6 — 2026/09/18

作者：啃轮胎的西狐

**根治"假事实"：身份层 + 证据层 + 契约层。**

**背景**（真实项目实测，8 条运行记录）：46 次工具调用里 **34 次是 `glob`**、`read` 只有 2 次；工具根目录落到了 `C:\Users\WestFox\.dsh`——**不是**该次运行所属会话的目录——产出却写着"工作目录下不存在任何工程文件…只有 `attachments/v1/objects/**` 二进制对象"，还标注"**已核实，不要再去找别的资料**"，下游据此不再看真实项目；同一句原话三次跑出**互相冲突的硬约束**（一次"唯一允许的外部资源是 CDN three.js"，另一次"不得出现 `https://`"＝要求从零手写 WebGL 渲染器，用户从没要求）；6/8 次观察者上下文为空。

1. **身份层（唯一入口）**：新增 `resolveRunContext()` —— 按**本次运行上报的 sessionId** 解析会话 / cwd / agent preset。**解析不到就不猜**：不派工具、不注入观察者、形态回落 chat，退化成"纯需求重述"（0.4.3 行为），**绝不产出假事实**；判定写进 `/runs.context` 与 `run.toolRoot` 供事后核对。
   原先三处**各自猜会话**：工具根取"会话列表里第一个有 cwd 的"、形态判定取"最后一个会话"、观察者再按 id 找一次——三者可能指向不同会话，且都不留痕。
   实测：指定 ptc 会话 → `cwd=D:\0中转站\html`（真实项目目录）✓；不给 sessionId → `chat` + `no-session:no-session-id` ✓。单测 `verify-run-context.cjs` **9/9**（含"目标会话不在列表首位"这条回归用例）。
2. **证据层**：新增 `renderEvidenceLedger()` —— 把"本次**实际读到**了什么"作为**结构输入**交给模型（与观察者块同构），而不是再加一句提醒。规则由机制背书：只能引用账本里出现过的路径 / 符号；**只列过目录不等于知道内容**；一次文件内容都没读到，就不许写"事实 / 现状"段。
3. **契约层**（`V6_CORE`，三档通用）：新增【事实必须有出处】【只写下游无法自知的】，并把【歧义】扩写为"**保守不得升级成新的硬约束**"（用户没提 ≠ 禁止；不得据此禁掉依赖 / 网络 / 外部库 / 文件数量，也不得放大工作量）。prompt 变更可由 `evidence/diff-v6-prompts.cjs` **逐行审计**——本轮差异只有这三条 + 歧义扩写，无夹带。
4. **形态表述精化**：`sequence=unordered` 从"不写先后顺序"改为"**真实依赖写进条目本身**"——去掉往返节奏，保留依赖（对从零构建类任务，依赖是有意义的）。
5. **止血杠杆**：策略可在**运行时**拨动（状态文件 `strategy` 或 `DSH_PO_STRATEGY`）；`strategy=v5` 即回到 0.4.3 的"纯需求重述"，用于同题对照与快速回退，**不必改代码**。`/runs` 新增 `strategy` 字段。

**判据调整（如实记录）**："`delivery=chat` 逐字节不变"这条判据在本轮**主动终止**——契约层按设计变更，逐字节相等不再是正确的锚。替代判据：① 投影不变式（`delivery` 只动 `sequence` / `budget`）② 契约条款在 3 档 × 2 形态齐备 ③ 与上一版基线的**逐行差异审计**。基线已重新冻结，上一版存档为 `evidence/v6-prompt-baseline-beta5.json`。

**新增脚本**：`verify-run-context.cjs`（身份层单测）、`diff-v6-prompts.cjs`（提示词差异审计）、`verify-real-scenario.cjs`（真实会话 A/B/C 验证）、`probe-stream-timeline.cjs`（事件流时间线）。

## v0.4.6-beta.5 — 2026/09/18

作者：啃轮胎的西狐

**让「优化 AI 思考强度」真正生效（此前是装饰品），并给守卫补上确定性验证。**

1. **接线**：`streamWithTools` 现在会把 `reasoningEffort` 带进 `llm.stream({...})`；工具循环分支、普通分支与 `runToolLoop` 贯通同一条 `selection`。此前只有**内部自检路径** `streamOnce` 会发该字段，正式优化路径从不发。
   `/runs` 现在同时给出三个值：`effort`（配置）/ **`effortSent`（实发，null = 没发）** / `effortNote`（为什么没发）。
2. **守卫**（避免"换过模型后的残留档位把正式优化打死"）：**只在该模型确实声明了该档位时才发**。守卫全部分支由 `evidence/verify-effort-guard.cjs` 用 stub 定死（**7/7**）——其中"模型声明了档位但没有 max → 不发"这条在本机跑不到（目录里 5 个模型都声明全部四档），所以用确定性单测补上，而不是让它成为永远没验过的死代码。
3. **可证伪实验**（同一请求、basic 档、各 4 次；`evidence/effort-live.json`）：`off` 组思考文本 **0 / 0 / 0 / 0 字**，`max` 组 **3260 / 1974 / 2193 / 2274 字（中位 2234）**，两组 `effortSent` 分别为 `"off"` / `"max"`、`effortNote` 均为 `declared`。**类别级差异（0 vs 2234）**证明该字段确实抵达了模型。
4. **纠正一条旧结论**：v0.4.5 曾写"off 均值 8745 / max 8300，行为层面的强度差异尚未被证实"——那三组当时**实际发出去的东西完全一样**（字段从不发送），差异全是噪声，该结论的前提不成立。README 对应历史条目已加更正注，并由上面的实验取代。
5. 弹层提示补一句"该模型未声明所选档位时不会发送"（中英条目继续一一对应）。

**未改动**：档位定义、delivery 投影、只读权限、收件人契约——`delivery=chat` 三档 system 仍**逐字节不变**（15/15），投影不变式与 i18n parity 回归全过。
**新增脚本**：`verify-effort-live.cjs`（同题 off/max 对照）、`verify-effort-guard.cjs`（守卫 7 分支单测）。

## v0.4.6-beta.4 — 2026/09/18

作者：啃轮胎的西狐

**下游形态投影：同一份档位定义，两种消费形态（PTC / 对话式）。**

本质判断：**PTC 惩罚的是工序，不是深度。** PTC 执行体用一个程序组合多步、每次往返都要重新起程序，它怕的是"分阶段停下 / 逐阶段汇报 / 先建 goal·todo"这类**节奏要求**；而"细到改哪个文件的哪个函数"对它是**收益**。原先这两件事被写在同一个字段 `decompose: 'exhaustive'` 里，于是"让极端档更适配 PTC"看起来像"必须削掉极端档"——拆开就不必削。

1. **拆轴**：档位改由五轴描述——`grounding`（查证深度）/ `depth`（写到多细）/ `enrich`（正向丰富许可）+ **`sequence`（工序 ↔ 清单）** / **`budget`（不设限 ↔ 够用即止）**。前三个是能力定义，后两个是表达方式。
2. **形态投影**：`delivery = ptc` **只**把 `sequence→unordered`、`budget→single-pass`；**不变式：绝不动 depth / enrich / grounding**。档位正文由 `renderV6TierText(tier, axes)` 渲染——全仓只有这一处写"步骤 / 阶段 / 长度"这些句子。
3. **运行时判定**：手动覆盖 → 会话 `header.agentPreset`（自带预设 `ptc`）→ 回落 `chat`；新增只读诊断路由 `/delivery` 回报"判成了什么、依据是什么"。UI 在「优化模型」弹层新增一行「下游执行体：自动 / 对话式 / PTC」（三态，未从宿主读到就不上报）。
4. **消费形态声明块**：`delivery=ptc` 时注入一个与 `observerBlock` 同构的结构参数，**只声明读者是谁**（一个程序一次做完、往返极贵、有预算），规则本身由轴渲染写一次。
5. **顺带修一个真缺陷**：产出预算改为**单一来源 + 停顿看门狗**——硬上限 240s（绝对兜底）+ **45s 无增量才收手**（`DSH_PO_STALL_MS`）。原先按总时长 60s 一刀切，砍掉的是**还在稳定产出**的健康请求 → 半截命令（同批 10 题里 1 题）。改后：两题复核均正常完成（一题跑到 **10929 字 / 127 秒**），极端档 ptc 复测 **10/10 done、0 中断**。

**实测**（同一把尺 `ptc-ab.cjs`、同批 10 题、同档 extreme、无工具）——**两次独立采样，如实并列**：

| 采样 | 形态 | 真实字数 | 流程开销/条 | 逐步/条 | 单程序/条 | 验收/条 | PTC 分 |
|---|---|---|---|---|---|---|---|
| 同批配对 | chat | 5143 | 0.4 | 0.4 | 1.1 | 0.5 | 3.6 |
| 同批配对 | **ptc** | 3711 | **0.1** | **0** | 1.9 | **4.5** | 9.9 |
| 复测（n=10） | **ptc** | 4179 | **0** | 0.2 | 0.4 | **5.7** | 6.12 |
| 改前基线 | chat | 3381 | 0.2 | 0 | 0.9 | 0.7 | 6.93 |

**稳健结论（跨采样都成立）**：

- **流程开销与逐步必然更低**：ptc 两次采样 **0.1 / 0**，chat 三次 0.4 / 0.2 / 0.2；
- **验收判据必然更高**：ptc **4.5 / 5.7**，chat 0.5 / 0.7（该指标跨批噪声 sd 仅 0.75，差距 6–8 倍，**远超噪声**）；
- **同批配对 8/10 题变好，均值 +5.8**（配对可消掉跨批漂移）。

**不稳健、因此不作为结论的**：综合 PTC 分与字数——该量尺**跨批噪声大于效应**（同一 chat 提示词两批之间条目数 sd = **9.85**、综合分 ±3.2），ptc 两次 9.9 / 6.12 与 chat 两次 3.6 / 6.93 **区间重叠**，n=10 下不足以下结论；字数同理（3711 / 4179 vs 5143 / 3381）。**零回归不靠分数证明，靠"逐字节相同"这条结构事实**（15/15）。

- **档位次序在投影后仍成立**（`evidence/tier-ordering.json`，ptc 形态内、各 n=10）：条目数 极端 **31.6** > 高级 **22.3** > 普通 **18.3**；字数 3711 / 2438 / 1160。
- **中断**：改前 chat/ptc 各 1/10 被总时长砍成半截；改后（停顿看门狗）**累计 42 次运行 0 中断**（basic/advanced 各 10、extreme 两次各 10、复核 2），其中一题跑到 **10929 字 / 127 秒**正常完成。
- 帮助面板新增「下游执行体」一节（中英条目 **197/197 一一对应**，0 漏译 / 0 孤儿；`i18n-demo` 中英各 pass）。

**一处判据更正（如实记录）**：初版判据写的是"条目数与位置引用 ptc ≥ chat"，实测不达标（41.3→31.6 / 4.2→2.7）。复核后确认**判据本身写错**：① 该量尺的**跨批噪声就有这么大**（同一提示词两批之间条目数 sd = **9.85**、区间 [−6,+28]）；② `budget=single-pass` 的**目的就是减篇幅**（−28%），要求条目不减等于要求篇幅不减；③ 该看的是**每条目的具体度**（位置引用/条目 0.13→0.11，噪声内）与**可验收性**（验收判据 0.5→**4.5**，9 倍）。"定义不丢失"改用**档位次序**判定，那才是"档位没被抹平"的正判据。

**新增脚本**：`snapshot-v6-prompts.cjs`（chat 逐字节基线）、`verify-delivery-axes.cjs`（投影不变式）、`verify-delivery-score.cjs`（形态 A/B）、`verify-delivery-noise.cjs`（噪声 vs 效应）、`verify-tier-ordering.cjs`（档位次序 + 中断复核）、`patch-readme-delivery.cjs`（README 口径）。

## v0.4.6-beta.3 — 2026/09/18

作者：啃轮胎的西狐

**修好"高级/极端看不到思考过程"；问号面板文案与三档实际行为对齐；README 口径与实测数字同步。**

1. **思考透传修复**（三处断点，全部有代码依据）：`runToolLoop` 调 `streamWithTools` 时**漏传第 9 个参数 `onDelta`**（`lib/index.js:1516` 已传入）；循环只回传 `reasoningChars` 计数、**原文被丢弃**（`:1546` 改为同时回传 `reasoning`）；`executeLiveRun` 工具分支把 `reasoning` **硬编码为空串**（`:2065` 改为 `looped.reasoning`）。
   工具分支的 `onDelta` 只转发 `reasoning-delta` / `usage`——**正文不走这里**：工具循环是多轮的，正文以最后一轮为准，仍由原来那一次 `publishRun` 定稿，不重复推送。
   **未改动**基础/高级/极端三档的定义（`V6_TIERS` 的 grounding / decompose / enrich 与温度一字未动）。
   实测（同一请求、同一模型、同一 effort）：思考文本字数 基础 3333（未受影响）、高级 **0 → 2817**、极端 **0 → 7396**；浏览器内实跑极端档，「思考」折叠栏摘要 = **`— tok · 6497 字`**。
2. **问号面板（使用帮助）文案与行为对齐**：原先那一节写的是 v0.2.1 / v5 时代的规则（"实质优先 / 流程长度 / 硬约束 / 防过度"），而 v6 明确"不写流程仪式与通用教学"——两者相反、自相矛盾。现按三档定义与实际行为重写为：**档位**（三档各补到什么程度，并注明**三档的思考过程都显示在「思考」栏**）、**只读权限**（默认开启、能读什么、关掉会怎样）、**优化器会做什么**（收件人 / 语言层 / 保真 / 歧义 / 产出即命令，与 `V6_CORE` 五段一一对应）、**上下文**（回合＝最近 0~10 回合**双方全文**；超限按六级分级压缩并声明）。
   同时修掉两条**过时描述**：回合模式"只保留你的原话"（0.4.6 起是双方全文）、"上限 回合 1.2 万 / 全文 6 万字符、按整回合丢弃"（活路径注入的是观察者块，预算 1.2 万 + 分级压缩）。
   中英**逐条对齐**：面板在中英两种语言下**各 7 节 / 各 24 行**；`i18n-demo` 自检断言同步改为校验新条目（`secHasReadOnly` / `rowHasAddressee` / `rowHasFidelity` / `rowHasTierFacts`），中英各跑一次 `pass: true`。
3. **README 一类文档与实际行为 / 版本号同步**：修掉 6 处口径（中英同改，脚本 `evidence/patch-readme-behavior.cjs`，每条断言"恰好命中 1 次"）：
   "0.4 = 需求补全器"框里"**不写步骤、不写验收清单**"（与高级/极端档明确要求阶段性任务 / 步骤相反）→ 改为按档位说明补到什么程度；
   "系统提示词 **515 字符**、产出 **422 字符**"→ 实测 高级 **2542** / 极端 **2687** 字符（含观察者块），产出 普通 **306** / 高级 **2008** / 极端 **3954**；
   "提示词组装：`RELAY_IDENTITY` → … → `PROCESS_RULES`"（v4/v5 遗留常量）→ 改为 `V6_CORE` → 档位正文 → 观察者块 → 收件人契约；
   "只发送你的输入文本 +（高级/极端档）目录树摘要"（`projectContext` 在活路径**从未注入**）→ 改为实际范围（会话上下文 + 只读权限开启时读项目文件）。
   `PROMPT-OPTIMIZATION.md:61` 的"活路径不带工具"→ 更正为**带工具**（默认开）。

**新增验证脚本**：`verify-i18n-parity.cjs`（中英条目一一对应审计：0 漏译）、`verify-reasoning.cjs`（三档思考通道对照）、`probe-reasoning-ui.cjs`（浏览器内实跑读「思考」栏）、`probe-cmd.cjs`（通用 UI 探针）、`patch-readme-behavior.cjs`（README 口径同步）。

## v0.4.6-beta.2 — 2026/09/18

作者：啃轮胎的西狐

**两处按原话改动 + 一处治根：把「产出物的收件人」写进架构。**

1. **只读权限默认开**（原话："让读取工具默认开启"）。改成**三态**：状态文件里**缺失该键 = 开**，只有**显式 `false`** 才算关（已保存的显式值不被改写）；读取异常也按开处理。
   实测：把 `readTools` 键从状态文件删掉后 `GET /state` → `true`；不传任何参数跑一次极端档 = **6 次真实工具调用**（`glob`/`grep`）；显式 `false` = 0 次调用、产出 4000 字。
   浏览器侧同步改成三态（`null` = 未读到就**不上报该字段**），否则"未设置（默认开）"会被 UI 的首次落盘误写成显式 `false`。
2. **文案与位置**（原话："只读查证（让优化 AI 真的读项目）改成「只读权限：」，按钮放在右边"）。标签改为 `只读权限：`（en：`Read-only access:`），
   开关控件移到标签**同一行的右侧**，说明保留在下一行。真实 DOM 实测：`toolsLabel="只读权限："`、`toolsOn="true"`、`sameLine=true / dy=0 / btnRightOfLabel=true / overflowRight=-25`（不出界、标签未截断）。
3. **治根：产出物的收件人**。原话指出极端档产物第一句是**对老板说的**——"把下面这段整条发给工作 AI（原话里的两件事：…）"——直接转发容易误导会话 AI：**优化 AI 是领导，只能对员工（会话 AI）说话**。
   病根不是"少了一条注意事项"，而是契约只规定了"内容要像一条能发出去的命令"，**从未规定产出物的收件人**，模型于是把产出物当成"回给老板的信"。两层根治：
   - **契约层** `OUTPUT_ADDRESSEE_CONTRACT`：收件人写进 system，`buildSystem` **统一追加**（全策略、全档位生效，放最后＝模型看到的最后一条产出规则）；
   - **闸门层** `enforceAddressee`：宿主在**唯一产出出口**上强制剥离转交语与包装——只扫**首尾**（正文里的"复制到 / 告诉我"不误伤，判官自检含 4 条误伤压力用例），剥完不足 20 字**整段回退原文**（绝不返回空），处理结果写进 `run.addressee` 供 `/runs` 复核；`done.text` 成为**定稿**，流式 delta 只作预览。
   实测（复现用例＝这一轮的原话）：极端档产出 `addressee = {triggered:false, action:"no-hit"}`——**转交语根本没生成**（契约层生效）；闸门判官自检 **13/13**（坏标全拦、金标一字未动）。
   降级实测：`forceToolError` 让只读工具链失败 → `toolLoopError` 记录在案、回落无工具路径、产出 **3816 字非空**。

**硬约束**：只读权限**默认开启**（本版起覆盖上一版的"默认关闭"）；工具链任何失败**降级为无工具运行且结果非空**；闸门任何异常原样放行。
**一处判断**：降级/失败声明落在**运行记录**（`toolLoopError`、`/runs`），**不写进产出物**——产出物是给会话 AI 的指令件，在里面写"已降级"就又变成对老板说话。
**新增验证脚本**：`verify-addressee.cjs`（闸门判官自检）、`verify-046b2.cjs`（默认开/显式关/降级/收件人四项）、`probe-tools-row.cjs`（真实 DOM 读只读权限行）。

## v0.4.6-beta.1 — 2026/09/17

作者：啃轮胎的西狐

**三步改造完成：只读查证 / 观察者上下文 / 预算与压缩。**

1. **只读查证（工具路径）修通**。根因：`relayMessage()` 返回的是**消息数组**（非工具路径当 `messages` 用），而 `runToolLoop` 的 `userText`
   需要**字符串**，于是数组被塞成 `content:[{type:'text',text:<对象>}]` → provider 报
   `messages[0].content: invalid type: sequence, expected a string`。宿主六种形态复刻均成功、只有插件失败，正是这个接线错误。
   修复后实测：开关 ON = **10 次真实工具调用**，产出含**真实事实**（"只有顶层目录 `attachments/`，其下 `attachments/v1/objects/`，按哈希前 2 位分桶"）；
   OFF = 0 次调用、泛化建议。另有一例它读 5 次后**如实说明**"我可见的目录里没有 package.json，需要你在真实仓库里定位"——读了就报实情，没编造。
2. **上下文观察者视角**。数据源改为会话**投影** `derived`（会话 AI 真正看到的投影消息，实测 1418 条），**不走事件重放**；
   经 `buildSystem(tier, { observerBlock })` 作为**结构参数进入 system**（不再塞进用户消息）。
   三模式对照验证：turns `{24672 字符/65 行}`、full `{35232/120}`、off `{0/0}`；前两者产出**引用真实历史**，off 组零命中且明说"无法定位就说明缺少上下文，不要猜测"。
3. **预算与压缩**。预算默认 12000 字符（`DSH_PO_OBSERVER_BUDGET` 可覆盖），六级压缩：
   未压缩 → 最近 4 回合+助手截 600 字 → 最近 2 回合+截 200 字 → 仅用户原文 → 逐条丢弃 → 整体省略；**每一级都写进注入文本**。
   实测 turns 24672 → **2860** 字符、full 35232 → **2855** 字符，声明为"仅保留最近 4 个回合、助手截断 600 字"；压缩后仍命中历史话题。

**硬约束**：只读开关默认关闭；工具路径异常**降级回正常路径**（绝不给空结果）；观察者渲染异常返回空串（保持原行为）。
**新增验证脚本**：`verify-readtools.cjs`、`verify-readtools-workspace.cjs`、`verify-observer.cjs`、`verify-observer2.cjs`、`verify-observer-budget.cjs`。

## v0.4.4-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**修掉两个已上报缺陷（issue #9 / #8）；优化策略未变（v5「只补全要求」）。**

- **#9 客户端「控件自愈」每 1.2 秒抛一次 pageerror**：slot 注册按 **id** 去重，自愈循环却用同一个 `id` 再注册 → 抛
  `already has an entry with id "prompt-optimizer"`；改 `order` 绕不开（`order` 不是冲突键）。修复：重挂前**先释放上一次的重挂**
  （保存并调用 `ctx.slots.inject(...)` 的 disposer，定时器清理时一并释放）；`shell.overlay` 自愈同构，一并修；重挂失败现在会记 beacon。
- **#8 本会话拦截次数显示为真值两倍**：同一次发送会走两条路径（`keydown-enter` 与随之触发的 `click-send`），每次 push 两行。
  修复：互补路径标 `coalesced`（遥测保留），新增 `interceptCount()` 供三处显示使用；自检与遥测仍用原始行数。
- 发布流程：`gh-api.cjs` 新增 `publish`（一次完成 建/更新 release → 版本化资产 → **版本无关别名资产** → 标记 latest → 回读校验）。
  本次同时避免重演 issue #6（tag 指向提交里的 package.json 版本落后）：发版前先提交推送版本号，再打 tag 并核对。

## 0.4 与 0.1 的区别（先看这一页）

**0.1 = 改写器**：把用户的话改通顺（病句、错别字、标点、指代），输出仍是那句话的润色版——**它不补内容**，用户没写到的部分，下游 AI 照样不知道。

**0.4 = 需求补全器**：用户通常只说一句（10–200 字），它把这句话补成一份**完整、具体的要求说明**——对象落到具体文件/界面/模块、结果是什么样子、在哪些使用情形下要成立（双击打开/离线/窄窗口/换语言主题）、边界怎么处理、范围到哪里。
**不写流程、不写步骤、不写验收清单、不写验证纪律、不写禁止事项**——这些是下游 AI 自己的能力；写进去只会占它的注意力预算、收束它的解法空间。

| 版本 | 系统提示词 | 同一句 20 字请求的产出 | 管理性文字 |
| --- | --- | --- | --- |
| 0.3.x | 6478 | — | 大量（阶段／闸门／证据清单） |
| 0.4（v4） | 2069 | 4588 | 大量 |
| 0.4.1（v4.1） | 2118 | 2164 | 部分 |
| **0.4.3（v5）** | **515** | **422** | **全 0** |

管理性文字是有代价的：旧策略要求"逐步验证并贴证据"，把下游程序撑爆，**10/24 格被判预算截断而白扔**。
（详细推导见 `evidence/ARCHITECTURE-v5.md`；以下按版本倒序保留历史记录。）


## v0.4.3-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**策略 v5：只补全要求（Requirement Completion Only）—— 一次减法**

v2/v4/v4.1 都默认"优化器应当管理员工的工作方式"（给步骤、给验收清单、给验证纪律、给禁止事项）。这个假设被推翻：

1. **优化器的唯一价值是补上用户没说的内容**；除此之外写的每个字，都在替员工做它本来就会做的事。
2. **复述通用能力＝教它已经会的东西**：v4.1f 具备基本验收与认知能力，写进去只占它的注意力预算
   （实测：旧策略要求"逐步验证并贴证据"，把执行端程序撑爆，**10/24 格被判预算截断白扔**）。
3. **禁止性措辞有副作用**：把注意力引到被禁止的事上并收窄解法空间（与"权限太少、限制太多"的观察一致）。

分工改为：**优化器只管"要什么"（内容层）；怎么做、怎么验全归员工（能力层）。**
"验收"不再是检查清单，而是写成**使用情形与结果的样子**（例："用户双击这个文件就能看到坦克，不需要装任何东西、也不需要联网"）。

实现：系统提示词 **515 字符**（v4 为 2069、v4.1 为 2118）；删除流程编排、步骤安排、验收清单、验证纪律、探针、回执格式、禁止事项、通用教学。

**活实例实测**（同一句 20 字请求）：产出 **422 字符**（v4 为 4588、v4.1 为 2164）；
管理性痕迹 **全 0**（验收/验证/探针/必须/步骤/回执/pass/fail/基线均为 0；唯一一处"不要"是内容里的"加载异常时不要静默隐藏"）。
覆盖度仍完整：对象消解、结果形态、常见使用情形（窗口大小/缩放/主题/语言）、边界（资源缺失/路径错误/逻辑隐藏）、范围限定。

工程：旧策略全部保留作 A/B（测试台策略清单已有 v5/v41/v4/v011/v0310/v038/norefine）；零依赖不变；UI 与功能未改。
发布资产 224540 bytes，本地与 GitHub 回读 sha256 一致（`d0052d04…9f6c`）。


## v0.4.2-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**策略 v4.1：覆盖优先 + 终局单次验证**

底层推理（不是手感调整）：
1. **出错几乎全因"提示词没考虑到"**，而**再多的检查也找不出一个从没被写进去的要求**——检测无法弥补遗漏；
2. 每次检查在 PTC 里都要占**程序篇幅 + 执行时间 + 下一轮上下文**（实测：要求"逐步验证并贴证据"的旧策略把执行端程序撑爆，10/24 格被判预算截断白扔）；
3. 唯一与"用户将来满不满意"**同分布**的观测，是**完成后在真实媒介里对成品看一次**——其余都是代理的代理。

于是：**预算的绝大部分给"覆盖"，验证降级为一次终局观测。**

五节结构：**目标** → **完成时应当是什么样**（＝验收清单，覆盖度全部载体，逐条写明"什么情况算没做到"）→ **要做的事**（纯动作，**不挂验证、不挂"预期"**）→
**隐含要求**（只加检查与约束，不加工作量）→ **交付物与最后一次观测**（做完对成品看一次，逐条回执 + 未验证清单）。
验证只有三条纪律：不边做边验（中途最多"偶尔看一眼"，不是门、不产生分支）；只在真实媒介里对成品看一次；那一次必须能失败。
修复类任务＝动手前一张基线 + 修完一张对比（两次截图够了）。探针能省就省，优先"构造上稳健"（直接本地内联资源，而不是先探 CDN）。

**活实例实测**（坦克履带 20 字请求）：产出 **2164 字符**（v4 为 4588，减半）；逐步验证痕迹归零（`预期：`=0、`探针清单`=0、`观测点与基线`=0）；
步骤为纯动作，第 3 步给出**病因分类**（资源 404 / 节点可见性 / 材质 opacity·alphaTest·色彩空间·背面剔除 / UV 与图集 / 遮挡与深度 / 加载时序被静默 catch / canvas 与 DOM 层叠）；
中途仅保留"重新加载真实画面看一眼（**不作为关卡**）"。

工程：旧策略全部保留可作 A/B；零依赖不变；UI 与功能未改。发布资产 222438 bytes，本地与 GitHub 回读 sha256 一致（`a28ea32b…7250`）。

## v0.4.1-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**策略换代：探针优先的适应式计划（V4）**

不再试图预先枚举领域约束（那需要人工维护清单、换个领域就废、无法交付他人维护），改为规定**如何从真实媒介里把未知问出来**：
把每个"我不确定"改写成一次能用是／否回答的最小实验（探针），并写清"失败长什么样、失败时改走哪条路"。

三条不变式（均有实测支撑）：① 员工只做明说的 → **覆盖率＝完成率**；② 优化器在想象里写、员工在真实里做 → **不确定的事实一律改写成探针，不许断言**；
③ **不能失败的检查＝装饰**（实测：验证桩把 `COMPILE_STATUS` 硬编码为 true，等于把最容易出事的判定从验收里删掉）。

产出固定六节：**目标与判据**（成功/失败长什么样 + 主观词翻译）→ **观测点与基线** → **步骤**（风险优先；动作｜预期｜若不符怎么办）→
**探针清单** → **隐含要求**（只加检查与约束，不加工作量）→ **交付物与回执**（原始证据 + pass/fail + 未验证清单）。
另有：手段全开／范围冻结；代理只能定位不能判定；观测点建不起来就停下报告；不得把该员工做的事推给用户。

**活实例实测**（坦克履带那句 20 字请求，输出 4588 字符、六节齐全）——它自行推导出了此前三轮才踩到的坑：
"跑不起来先解决，不算修履带"；用 Network 看履带资源状态码；临时改高饱和色区分"没渲染"与"同色看不见"；有头/无头各开一次；
并写死"无头模式只能作辅助定位，不能单独作为'完成'的判定依据"。

工程：`release-local.cjs` 新增自动同步 `lib/client.js` 的 build 标签（此前手工维护，实测漂移停在 `v0.3.10-beta.2`）；
策略文本 2069 字符（三档一致）；旧策略全部保留可作 A/B；零依赖不变；UI 与功能未改。
发布资产 219535 bytes，本地与 GitHub 回读 sha256 一致（`67b9af68…6e5f`）。

## v0.3.13-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**修复：settings 命名空间自愈注册**

现象（重启后实测）：`/api/state` 的 `settings` 从 `error: TypeError: schema is not a function`（0.3.11 已修）
变成 **`no-settings-service`** —— 插件初始化时没拿到 settings 服务，命名空间未注册、设置镜像未启用。

诊断（宿主探针实测）：此刻 `ctx.get('settings')` **可用**（`register` 是函数），且 `describe()` 的命名空间清单里
没有 `prompt-optimizer` ⇒ **settings 服务晚于本插件挂载**，而 `initSettingsNamespace(ctx)` 只在 apply 时执行一次，
一次性查询永久错过。

修法：在既有 1.2s 看门狗里加自愈重试 —— 状态仍为 `no-settings-service` 时再试注册（幂等，成功即停）。

校验：`node --check` 通过；提示词逐字节未变（1273/1627/1736）；`lib/index.js` 123347 bytes / sha256 前缀
`fa4a6dd58415a8ba`；`lib/client.js` 未改动。发布资产 211989 bytes，本地与 GitHub 回读 sha256 一致（`a66c841f…9c9c`）。
**需再次重启才在活实例生效**（重启后应看到 `settings: registered`）。

## v0.3.12-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**仅代码卫生（P1），优化策略与提示词逐字节未变**（basic/advanced/extreme = 1273/1627/1736 字符，与 0.3.10 一致），UI 与功能不受影响。

| 项 | 改动 |
| --- | --- |
| `buildSystem` 死分支 | 改显式开关 `const STRATEGY = 'v011-ptc' \| 'v03x'`；注明"停用不等于删除"（`TIER_PARTS`/`HISTORY_RULES_*` 仍被 tier-compare、自检引用） |
| 历史纪律 | 新增 `const HISTORY_INJECTION = false` —— 明确"不注入"而非"参数被静默忽略"；置 true 即恢复按 `historyMode` 追加 `HISTORY_RULES_*` |
| 内存边界 | `liveRuns` / `optSessions` 改用 `CappedMap(64)`：超限按插入序淘汰最旧，**running 条目永不淘汰**（避免掐断 SSE 流） |
| 生产包卫生 | 新增总开关 `DSH_PROMPT_OPTIMIZER_DIAG=0`：关闭本插件写入 `evidence/` 的全部诊断流；实现在 `appendFileSync` 外包一层统一守卫（6 处调用点无需逐处改，新增写入自动受控） |

校验：`node --check` 通过；提示词快照与 0.3.10 逐字节一致；`lib/index.js` 122949 bytes / sha256 前缀 `4be06956cbb26553`；
`lib/client.js` 未改动。发布资产 211183 bytes，本地 sha256 与 GitHub 回读一致（`4cc7e3ef…dafd`）。
**需重启 DSH 才在活实例生效。**

## v0.3.11-beta.1 — 2026/09/16

作者：啃轮胎的西狐

**修掉线上真实报错：`settings: "error: TypeError: schema is not a function"`**

根因：插件把 **zod** 对象当 schema 传给 `settings.register(ns, schema)`，而 DSH 的 settings 服务要求
**schemastery** schema（schema 必须是**可调用对象**，字段自带默认值与校验）—— zod 对象是普通对象，
服务内部的 `schema(...)` 调用直接抛 TypeError。用宿主探针实测确认：`@deepseek-ai/schemastery`
从 profile 可解析，`S.object({...})` 返回 `typeof === 'function'`，默认值/校验行为正常。

修法：按候选名解析 `@deepseek-ai/schemastery`（回退 `schemastery`）→ 构造 schema → **显式自检
`typeof schema === 'function'`**；解析不到或形态不符时给出准确状态串（`schema-unavailable` /
`schema-not-callable`），不再抛含混的 TypeError。

**优化策略未变**：仍是 0.1.1 原样提示词 + PTC 规则（A 交付形态对齐 PTC / B 验收≤3 条可机器判定 / C 删失败预案）。

发布校验：`lib/index.js` 120752 bytes / sha256 前缀 `1beb58f2820a6ac1`；tgz 209436 bytes，
本地 sha256 与 GitHub 资产回读一致（`70aa20678df1928bd72ec73ba51e94f3a66be939723fe35d92135dd50c19ef57`）。

**⚠️ 需重启 DSH 才在活实例生效**（loader entry 按包名重新解析；只改 junction 或热重载不会切换）。

## v0.3.10-beta.2 — 2026/09/15

作者：啃轮胎的西狐

**同批代理指标验证 A/B/C 生效（5 题 × 3 策略，同一次运行）**

| 策略 | 平均字数 | 硬约束/条 | 流程闸门·阶段/条 | 计划(goal/todo)/条 | 失败预案/条 | 一次成程序/条 |
|---|---|---|---|---|---|---|
| 0.1.1（回退基线） | 1769 | 3.6 | 8.6 | 1.0 | 1.2 | 0 |
| 0.3.8（旧重约束） | 3004 | 35.6 | 11.2 | 1.0 | 0.6 | 0 |
| **0.3.10（0.1.1 + A/B/C）** | **807** | **2.0** | **0.2** | **0** | **0** | **0.6** |

- 读法：A（交付形态）把"流程闸门/阶段"从 8.6~11.2 压到 **0.2**、"计划(goal/todo)"压到 **0**；B/C 把"失败预案"压到 **0**、硬约束从 3.6（0.1.1）/35.6（0.3.8）压到 **2.0**；平均字数比 0.1.1 还短 54%（**807 vs 1769**），并首次出现"一次成程序"类表述（0.6/条）。
- 数据：`evidence/ptc-proxy-compare.json`（逐题明细）；脚本 `evidence/ptc-ab.cjs` 与 staging 工具 `ptcproxy`。
- **诚实标注**：这是**关键词代理指标**（测"有没有出现"，不测效果），且**未在真 PTC 中验证**；本版**不声称提升**。真实验证入口：`evidence/ptc-manual-packet-v0310.md`（B 组已用 0.3.10 重生成）。
- 本轮同时修正上一版文档里的数字偏差（预估 1726/1835 → 实测 **1627/1736**）。
## v0.3.10-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**在 0.1.1 基础上加"面向 PTC 的交付形态"（A+B+C），不再走 0.3.x 的重约束路线**

### 为什么（结构分析，见 evidence/ptc-gap-analysis.cjs / .json）

| 指标（extreme 档） | 0.1.1 | 0.3.8 |
|---|---|---|
| 提示词字数 | 1421 | 6478（4.6×） |
| 小标题数 | 0 | 18 |
| 必须/不得类硬约束 | 7（4.9/千字） | 93（14.4/千字） |
| 流程编排（分阶段/todo/goal） | 6 | 16 |
| **流程闸门（切片/逐层/停手）** | **0** | **16** |
| **失效模式清单（逐域）** | **0** | **29** |
| 自检证据（贴输出/明细/对账） | 2 | 29 |

机制：PTC 执行体用**一个程序**组合多步、没有逐步工具，**每次往返都要重新起程序**。因此"切片/逐层验收/每阶段贴输出"在 PTC 里等于强制多轮往返（耗时暴涨），"十几条领域清单"则挤占程序需要的上下文并压掉模型自己的判断——这与"过度约束→随机应变下降、调试拘谨、时间变长"的实测反馈一致。

### 本版三条补丁（只加这三条，其余保持 0.1.1 原文）
- **A 交付形态**：下游是 PTC 型执行体（一个程序一次做完）；**不得**要求分阶段、逐步、每阶段贴输出、先建 goal/todo、先规划再动手。
- **B 验收瘦身**：验收标准**最多 3 条**，每条必须**可机器判定**（数值/存在性/逐字符相等/退出码/可解析）。
- **C 删预案**：不写失败预案，压成一句"任何不确定处走最保守路径并在交付里注明"；拿不准处宁可留白，不要堆"必须/不得"。
- 规模：advanced 1312 → **1627**，extreme 1421 → **1736** 字符（实测值；此前脚本预估写成 1726/1835，已更正）（仍远低于 0.3.8 的 6480/6478）；普通档保持 0.1.1 原文（1273）。

### 诚实边界
- 上述差距是**关键词代理指标**（测"有没有出现"，不测效果）；机制推理是解释性的，**尚未在真 PTC 中验证**。
- 本版**不声称提升**：它只声称"移除了与 PTC 消费方式冲突的要求，并补上一条交付形态指引"。真实验证用 `evidence/ptc-manual-packet.md`（人工 PTC 测试包）。
- 待修 bug：插件活实例热重载后 `/run` 仍走旧策略（0.3.8 指纹），需单独排查路由/模块缓存。
## v0.3.9-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**优化策略回退到 0.1.1（PTC 口径实测确认假设；UI 与功能不受影响）**

### 为什么回退：同口径 PTC 适配度实测（10 题 × 2 采样 = 20 格/条件）

| 条件 | 平均字数 | 硬约束/条 | 每千字 | 流程开销/条 | 自由度/条 | **PTC 适配分** | 旧评分卡 |
|---|---|---|---|---|---|---|---|
| **0.1.1 旧策略** | 1822 | **3.2** | 1.8 | **2.85** | 0.2 | **+1.93** | 71.9% |
| **0.3.8 现策略** | 2699 | **30.6（≈10×）** | 11.3 | **9.9（≈3.5×）** | 0.1 | **−17.52** | 92.8% |

- 结论：0.3.x 的**硬约束数量高一个量级、流程开销高约 3.5 倍、命令长 48%**，与"AI 被过度约束、随机应变下降、调试拘谨、开发时间变长、UI/操作反而退步"的真实反馈一致。
- **同时暴露量尺问题**：旧评分卡给 0.3.8 更高的分（92.8% vs 71.9%）——说明它测的是"约束齐全度"，**不是**对 PTC 消费者的适配度。此前基于该量尺的"提升"结论**不再作为效果证据**。

### 本版改了什么（只回退优化策略）
- `buildSystem()` 增加回退分支：三档 system 直接返回 **0.1.1 原文**（内联常量 `LEGACY_V011`，逐字节取自 `prompt-snapshot-v011.json`）；
- **逐字校验通过**：basic 1273 / advanced 1312 / extreme 1421 字符，与 0.1.1 快照 `一致=true`；
- **UI、i18n、上下文模式、迷你窗、模型弹层、进度面板等功能一概未动**（仅提示词策略回退）。

### 文档：中英文最上方新增 PTC 使用警示
> **本插件针对 PTC 模式进行优化**；建议在 PTC 模式下使用，否则可能无法实现明显的效果提升，**不排除其他模式倒退的可能性**。（English 版同样置顶）

### 诚实标注
- `evidence/prompt-invariants.cjs`（34 项"0.3.x 约束不丢失"断言）**对本版已过期**：本版有意回退到 0.1.1 策略，该闸门必然失败；它现在只能用于"若将来再引入 0.3.x 规则"的对照，不应作为本版回归证据。
- PTC 适配分是**文本层代理指标**（硬约束密度、流程开销、自由度、单程序友好、交互覆盖），衡量的是"命令对 PTC 消费者的友好度"，**不等于**真实任务成功率；真实成功率需要在 PTC 环境里端到端跑（待办）。
## v0.3.8-beta.1 — 2026/09/15（收尾轮）

作者：啃轮胎的西狐

**第三方口径复检（⑦c）——候选改动，尚未测**

- 诊断（来自上一轮）：0.3.5~0.3.7 三份 H3 候选样本中 **2 份"假完成"**（自检说修好了、独立审计实测 24 / 21 个内向面）⇒ 问题已从"入口没落地"转移到"**自检结果与真实几何不一致**"。
- 改动（⑦c）：自检必须**逐项给出被检查对象明细**（几何逐面判定或用"检查面数 = 网格面数"对账并给出反向面索引；数据逐条或抽样明细）；检查数少于实际对象数时必须说明跳过了什么、为什么；**只给汇总数字不算完成**，且第三方按明细能复算出同一个数字。
- **诚实标注：本改动尚未测量**（本轮无剩余采样预算）。它作为候选进入 0.3.8，下一轮按同口径测 H3（目标 n≥2/条件）后再决定保留或回退；**不声称任何提升**。

**0.3.1 → 0.3.8 能力与指标汇总（同口径，n≥2 处已标注）**

| 版本 | 主线改动 | 命令侧（满分 180） | 产物级 0~3 分档（三题） |
|---|---|---|---|
| 0.3.1-beta.1 | 先防后查（押注首要失效/最小切片/机器可判定不变量/惯例优先/失败即报告） | **169（93.9%）**，配对 9-0-1 | — |
| 0.3.2-beta.1 | ＋切片闸门、统一自检入口（"或等价"） | 165（91.4%），噪声内 | — |
| 0.3.3-beta.1 | 自检入口**写死**（`__selfcheck` 结构 + 真实输出） | 165（91.9%） | 12/36（33.3%） |
| 0.3.4-beta.1 | ＋命令侧子指标（入口要求 100% vs 发布版 0%） | 165（91.9%） | 12/36 |
| 0.3.5-beta.1 | 入口与交付物同体 | 未测（规格澄清） | H3 仍 0/18（后判定为量具混淆） |
| 0.3.6-beta.1 | 量具修复后 H3 首次可信测量 | — | **17/45（37.8%）**；H3 4/6 对 0/6 |
| 0.3.7-beta.1 | ＋改完必须复检（⑦b） | — | H3 仍出现假完成（21 个内向面） |
| **0.3.8-beta.1** | ＋第三方口径对账（⑦c，**未测**） | — | 待测 |

- 发布版对照（0.2.2-beta.1）：命令侧 125（69.2%）· 产物级 0/45（0%）。
- 两条主指标的分工：**命令侧**量"要求是否写进命令"（规格层，n=2 有噪声估计）；**产物级 0~3 分档**量"执行体是否真的做到并可被第三方复跑"（执行层）。

**仍未解决（如实列出）**
1. **假完成**：入口能落地，但自检数字与真实几何不一致（H3 三样本里 2 份）；⑦c 是针对它的候选对策，未验证。
2. **产物级样本小**（每格 n≤4），且 H3 单次生成 2~18 分钟，采样成本高。
3. **H2/H3 的"2 分档"从未出现**（要么全过要么 0/1），说明中间档判据还不够敏感。
## v0.3.7-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**加"改完必须复检"（⑦b）——但"假完成"仍在，如实记录**

- 改动（⑦b）：任何修复/优化之后必须**重跑同一个自检入口**并贴出输出，且**修复前后数字都要给**（例："反向面 24 → 0"）；只声称"已修好"而没有复检输出视为未完成。动机来自上一轮抓到的那份"声称修好、实测 24 个内向面"。

**复测（H3 两条件各 1 份，n=1）**

| 条件 | 得分 | 明细 |
|---|---|---|
| **v0.3.7-beta.1** | **1** | 统一自检入口**已具备**（上版常缺），但独立审计仍测到 **21 个内向面** ⇒ "假完成"模式**依旧存在** |
| 发布版 0.2.2-beta.1 | 0 | 无统一自检入口；但独立审计 `inwardFaces=0`（几何本身修对了） |

- **诚实结论**：本版改动**没有消除假完成**（n=1，样本极小，只说明"仍然存在"，不足以说明频率）。把 0.3.5~0.3.7 三份候选样本合起来看：**1 份满分（inward=0）、2 份假完成（24 / 21 个内向面）** ⇒ 该题的核心问题已经清晰：**入口能落地了，但"几何真的修好了没有"仍靠不住**。
- 第二主指标：**V3 17/45 = 37.8%（分布 8/2/0/5）· 发布版 0/45 = 0%（15/0/0/0）**；"1 分档"（部分做到）样本增至 2 份。
- 规模：极端档 6314 字符（普通档仍 1405）；约束闸门 34 项断言全 PASS。
## v0.3.6-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**H3 首次可信测量：候选版 4/6 对发布版 0/6，并抓到真实产物缺陷**

量具修复后（执行体声明"无工具、直接产出完整文件"）重测 H3（审计并修复反向面网格），两条件各 2 份：

| 条件 | 新样本得分（0~3 分档） | 明细 |
|---|---|---|
| **v0.3.6-beta.1** | **4/6** | r1 = **3 分**（入口齐备 + 修复正确 + 独立审计通过，inwardFaces=0）；r0 = **1 分**（有入口，但独立审计发现 **24 个内向面**） |
| 发布版 0.2.2-beta.1 | 0/6 | r0 = 0 分（无入口，且 **10 个内向面**未修好）；r1 = 0 分（无入口，法线本身正确） |

- **真实缺陷**：候选版那份"声称修好、实测 24 个内向面"的产物，正是用户最初描述的失效模式（该看见的面看不见）；说明"要求写明自检 + 第三方复跑"确实能把这类假完成揪出来。
- **可靠性而非能力**：候选版 2 份里 1 份拿满、1 份假完成 ⇒ 能力存在但**不稳定**；这正是下一轮要压的方向。
- 第二主指标（三题 0~3 分档）：**V3 16/42 = 38.1%（分布 8/1/0/5）· 发布版 0/42 = 0%（14/0/0/0）**——首次出现"1 分档"（部分做到）样本，区分度提升。
- 诚实标注：H3 每格 n=2，样本很小；结论只针对"该题该量具下的形态差异"，不外推。
## v0.3.5-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**规格澄清：自检入口与交付物同体（H3 前沿未攻下，如实记录否定结果）**

- 改动（⑦ 的补充）：`window.__selfcheck()` 必须**在脚本顶层直接可调用**（不得只挂在 `load`/`DOMContentLoaded` 回调里、不得依赖用户先操作才挂载）；**交付前必须真跑一次并把输出原样贴出**。
- 动机：H3（审计并修复反向面网格）六份产物**全部缺统一自检入口**，怀疑是"挂载时机"造成第三方取不到。

**H3 近空产物的诊断（本轮，测量端混淆）**

逐份查原始产出后发现：近空产物并非"做不出来"，而是**执行 AI 开始"干活"就停了**——
- SHIP 的一份（1536 字节）只输出 TODO 清单（遵循了命令里"先列 todo"）；
- 候选版的一份（640 字节）写着 `Step 1 — 侦察：查找工作目录下的几何文件`，并输出 `<tool_calls>` 想执行 `pwd` / `ls` / `find *.obj`。

**但测量台的执行 AI 没有任何工具**（无文件系统、无 shell），于是它卡在第一步、产出近空文件。
结论：**H3 的测量被"无工具执行体 + 命令要求先查证"这对矛盾污染**，不能据此判断提示词优劣。
处置：在产物级执行体的系统提示里明确"你没有工具、不要输出计划或工具调用，直接产出完整单文件 HTML"，下一轮用**修好的量具**重测 H3。

**复测（同口径，H3 两条件各 3 份）**

| 条件 | H3 得分（0~3 分档） | 分布 0/1/2/3 |
|---|---|---|
| 发布版 0.2.2-beta.1 | 0/18 | 6/0/0/0 |
| **0.3.5-beta.1** | **0/18** | **6/0/0/0** |

- **否定结果（诚实标注）**：本版改动**没有让 H3 有任何一份满足判据**（0/6 对 0/6），因此**不声称提升**；该改动仅作为规格澄清保留（对 H1/H2 亦无副作用：三题合计 V3 12/42 = 28.6%、发布版 0/42 = 0%，V3 的 4 份满分仍全部来自 H1/H2）。
- **新观察到的执行侧现象**：H3 本轮出现 **528 字节与 1072 字节的近空产物**（执行 AI 基本没产出）——说明该题对执行侧本身偏难，第三方复跑失败未必全是"入口形态"问题，下一轮需要先排查"为什么 H3 的产物会近乎为空"。
- 规模：极端档 6192 字符（普通档仍 1405）；约束闸门 34 项断言全 PASS。
## v0.3.4-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**补齐量尺：0.3.3 的"统一自检入口"要求在命令侧首次被测到**

- 背景：前两轮发现 0.3.3 的改动在**命令侧评分卡上测不到**（评分卡没有该要点），于是补一个**独立确定性子指标**，用同一批命令直接量它（零额外 LLM 成本，脚本 `evidence/selfcheck-metric.cjs`）。
- 子指标三项：① 命令是否要求统一自检入口 ② 是否写明返回结构（`checks` / `pass` / `evidence`） ③ 是否要求附**真实运行输出**。

**同批命令（10 题 × 2 次采样 = 60 格，291 秒）**

| 条件 | 子指标：三项齐备 | 命令侧总分（满分 180） | 配对 |
|---|---|---|---|
| **0.3.4-beta.1（=0.3.3 提示词）** | **100%（20/20）** | **331/360 = 91.9%**（165/180） | **9 胜 / 0 负 / 1 平** |
| 发布版 0.2.2-beta.1 | **0%（0/20）** | 249/360 = 69.2%（125/180） | — |
| 无优化 | 0% | 8/360 = 2.2% | — |

- 噪声：同格重复采样平均极差 **0.87 分/18**（最大 5）。
- 子指标明细：V3 提到入口/结构/要求实跑输出 **各 100%**；发布版分别 **0% / 0% / 5%**。
- **诚实标注**：子指标测的是"**要求是否写进命令**"（规格层），不等于执行方真的照做——执行侧落地率见产物级指标（H1/H2 各 2/4 对 0/4、旧基线 0/14）。两条指标一起看才算完整。

**产物级 0~3 分档（第二主指标升级，本轮）**

规则：**3** = 统一自检入口齐备 + 独立法线审计通过 + 其余判据全过；**2** = 入口 + 法线审计过但仍有判据未过；**1** = 有入口但审计未过/无法审计；**0** = 连入口都没有（第三方无法复跑）。

| 条件 | 得分 | 百分比 | 分布 0/1/2/3 |
|---|---|---|---|
| **v0.3.4-beta.1** | **12/36** | **33.3%** | **8 / 0 / 0 / 4** |
| 发布版 0.2.2-beta.1 | 0/36 | 0% | 12 / 0 / 0 / 0 |

- 分题：V3 的 H1 法线 **6/12**、H2 操控 **6/12**、**H3 审计并修复反向面 0/12**（四份都缺统一自检入口 —— 这是尚未攻下的前沿）。
- 诚实标注：V3 的得分是"全有或全无"形态（4 份拿满 3 分、8 份因缺入口得 0），说明当前瓶颈是**入口落地率**而不是判据质量；样本仍小（每格 n=4）。

**产物级（同一把尺子，v0.3.3 起写死的判据）**：H1 法线 2/4 对 0/4 · H2 操控 2/4 对 0/4 → **合计 4/12（33.3%）对 0/12（0%）**，旧产物基线 0/14；独立法线审计两条件均 0 内向面。
## v0.3.3-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**把"统一自检入口"写死（不留"或等价"口子），并测到该判据上的真实变化**

- 改动：`⑦ 统一自检入口` 由"如 `window.__selfcheck()` 或等价"改为**写死**——必须提供 `window.__selfcheck()`，返回 `{checks:[{name,pass,evidence}],pass}`（每项带证据字符串、顶层 pass 为全部通过的布尔），**交付必须附真实运行输出**；只给 `__selftest` 等单项函数、或换个名字，都算未交付。
- 动机（上轮基线）：14 份既有产物 **0/14** 提供统一自检入口 —— "或等价"的写法在实践中没有被执行，导致第三方无法复跑（这正是产物级失败的根因）。

**复测（新判据：统一自检入口 + 独立法线审计）**

| 条件 | H1 产物通过 | 独立审计 inwardFaces |
|---|---|---|
| 发布版 0.2.2-beta.1 | **0/2** | [0, 0]（法线本身正确） |
| **0.3.3-beta.1** | **1/2** | [0, 0]（法线本身正确） |
| （上轮基线：全部 14 份旧产物） | 0/14 | — |

- **诚实标注**：样本很小（H1 两条件各 2 份），提升只体现在"统一自检入口"这一判据上（0/2 → 1/2），**不能外推为"产物质量整体提升"**；法线审计在发布版与候选版都已是 0 内向面（即该题的法线正确性本来就达标）。
- 另记：发布版有一份 H1 产物只有 167 字节（执行 AI 基本没产出），属执行侧失败，未计入判据结论。
- **n=4 复核（两题，同一把尺子）**：
  - H1 法线盒体：**0.3.3 = 2/4 通过 · 发布版 = 0/4**（上轮 n=2 为 1/2 对 0/2）；独立审计法线均为 0 内向面。
  - H2 操控题：**0.3.3 = 2/4 通过 · 发布版 = 0/4**；独立审计法线均为 0 内向面。
  - 合计：**0.3.3 = 4/12（33.3%）· 发布版 = 0/12（0%）**；旧产物基线 0/14。判据相同：产物是否提供 `window.__selfcheck()` 且返回 `{checks:[{name,pass,evidence}],pass}`。
  诚实标注：样本仍小（n=4），且该差异**只体现在"统一自检入口"这条判据**上；发布版从不满足它，是因为发布版提示词没有这条要求（而非产物法线有问题）。
- 规模：极端档 6115 字符（普通档仍 1405）；约束闸门 34 项断言全 PASS。
## v0.3.2-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**先防后查再加两条机制级要求（命令侧未测到提升，如实记录）**

- ⑥ **切片闸门**：命令必须写明"先交一个能跑通的最小版本 + 判据实跑输出"并给出**明确通过条件**（哪个数字/哪种现象算过）；**通过前不得扩展**，每扩一层再附一次复跑输出。
- ⑦ **统一自检入口（可被外部复跑）**：所有不变量由一个入口统一暴露（如 `window.__selfcheck()` 返回 `{checks:[{name,pass,evidence}],pass}` 或等价命令行自检），**交付必须附真实运行输出**；只写"我已检查"不算证据，第三方取不到入口即视为未交付。
  （动机来自产物级实测：四份失败全是"接口取不到、第三方无法复跑"。）

**同口径 n=2 复测（10 题/满分 180）**

| 版本 | 得分 | 换算 180 | 配对 | 噪声（同格平均极差/最大） |
|---|---|---|---|---|
| **0.3.1（先防后查）** | 338/360 = 93.9% | 169 | 9 胜 / 0 负 / 1 平 | 0.83 / 4 |
| **0.3.2（+切片闸门+统一自检）** | 329/360 = 91.4% | 165 | 9 胜 / 0 负 / 1 平 | 0.73 / 4 |
| 发布版 0.2.2-beta.1 | 261/360 = 72.5% | 131 | — | — |
| 无优化 | 8/360 = 2.2% | 4 | — | — |

- **诚实结论**：本版比 0.3.1 **低 2.5 分，落在噪声内、配对计数不变** ⇒ **命令侧没有测到提升**，因此不声称提升。
- **量尺不匹配（重要）**：现有 10 题评分卡里**没有**"切片闸门/统一自检入口"这两条要点——命令侧本就不是验证它们的合适工具。它们真正的作用点是**产物侧**（第三方能否复跑），需产物级复测才能判定；本轮未做（单份产物 2~13 分钟）。
- 版本命名：继续线性迭代（0.3.2、0.3.3 …）。提示词规模：高级/极端 6038 / 6036 字符（普通档仍 1405）；约束闸门 34 项断言全 PASS。
## v0.3.1-beta.1 — 2026/09/15

作者：啃轮胎的西狐

> 命名变更：自本版起线性迭代（0.3.1、0.3.2 …），不再使用 v0.4 / 0.3.0-beta.N 这套叫法。

**"先防后查"跑分定论（同口径 n=2）**

| 版本（同口径 n=2，10 题/满分 180） | 复杂题 | 配对 | 简单任务回归 |
|---|---|---|---|
| 仅硬闸门（0.3.0-beta.3 口径） | 88.9%（160/180） | 7 胜 / 2 负 / 1 平 | PASS（泄漏 0/4、长度 1.37×→修正后 0.95×） |
| **本版：闸门 + 先防后查** | **93.9%（169/180）** | **9 胜 / 0 负 / 1 平** | **PASS（泄漏 0/4、长度 0.39×、越权索取流程 0/4）** |
| 发布版 0.2.2-beta.1（对照） | 70.8%（127/180） | — | — |
| 无优化（对照） | 2.2%（4/180） | — | — |

- 噪声：同格重复采样平均极差 **0.83 分/18**（最大 4）。结论表述：**先防后查把硬闸门付出的约 5 分补了回来**（88.9% → 93.9%，配对由 7-2-1 改善到 9-0-1），且简单任务比之前更克制（长度 0.95× → **0.39×**、越权索取流程 0/4）。
- 提示词规模：高级/极端 5755 / 5753 字符（普通档仍 1405，闸门含"普通档不得出现能力包"反向断言）；约束闸门 34 项断言全 PASS。

**先防后查（本版能力核心）**：① 先押注首要失效 ② 最小可跑切片 + 逐层验收 ③ 机器可判定不变量（几何/交互/数据/并发/性能五域给数值判据） ④ 惯例优先（默认键位取自平台惯例） ⑤ 失败即报告、不许静默降级。详见 0.3.0-beta.5 条目的诊断表。

**进度可视化**：`node evidence/dashboard.cjs --watch` 每 3 秒重写 `evidence/dashboard.html`（单文件、内嵌数据、浏览器自动刷新），面板含命令侧各条件得分、产物级通过率与分题、数据新鲜度与"近期活动"。
## v0.3.0-beta.5 — 2026/09/15

**先防后查（v0.4 突破点）——从"事后检查清单"改为"先防后查"**

逻辑诊断：v0.3 的能力包本质是**事后检查清单**（列了要查什么），因此仍有五处系统性不足，逐条给了对策：

| 不足 | 突破点（写进命令的硬要求） |
|---|---|
| 不先押注首要失效 → 细节 bug 层层叠加 | ① **先押注首要失效**：命令开头一句话写"最可能坏在哪一处"，先做对、先验证，再铺其余 |
| 全部做完才验证 → 返工大、漏检多 | ② **最小可跑切片 + 逐层验收**：先跑通最小切片再过判据，每扩一层重跑关键断言 |
| 检查项是散文 → 执行 AI 可以"看着还行" | ③ **机器可判定的不变量**（按域给数值）：几何＝外观面朝外比例 1/无内向面/无 NaN/碰撞不超出网格；交互＝Esc 释放捕获/灵敏度 0~1 且默认值明确/反转布尔/每动作有反馈；数据＝保存→读取往返一致/迁移幂等/半截文件不作正式存档；并发＝同一请求只处理一次/锁顺序固定且超时可释放；性能＝先基线、改后复测帧率与画质均不下降 |
| 交互默认值靠自创 → 不人性化 | ④ **惯例优先**：默认键位取自平台惯例（WASD/方向键、鼠标看、Esc 释放、手柄死区），偏离必须写理由 |
| 断言没过可以静默略过 | ⑤ **失败即报告，不许静默降级**：未过项必须点名列出"未过项 + 证据 + 影响" |

规模：高级/极端 5755 / 5753 字符（普通档仍 1405）；约束闸门 34 项断言全 PASS。

跑分（命令侧 10 题/满分 180，本轮 n=1）：**v0.4 164/180 = 91.1%** · 发布版 129/180 = 71.7% · 无优化 2.2%；配对 7 胜 / 2 负 / 1 平。
**诚实标注**：上一版（v0.3，n=2）为 88.9%，本版 n=1 为 91.1% —— 差约 2 分，落在既有噪声范围内（同格极差最大 5），**因此本轮不能声称"突破点已被分数证明"**，需同口径 n=2 复测后才能定论。

**进度可视化**：新增 `evidence/dashboard.cjs`（`--watch` 模式每 3 秒重写 `evidence/dashboard.html`，单文件、内嵌数据、浏览器自动刷新，无需服务器），面板显示命令侧各条件得分、产物级通过率与分题、数据新鲜度与"近期活动"，避免把"没在跑"误看成卡死。


作者：啃轮胎的西狐

**产物级 n=7/条件 + 验证器三项修正 + 一次结论更正**

1. **产物级采样翻倍到 n=7/条件**（H1 法线盒体 1、H2 操控 2、H3 审计并修复反向面 4）：**发布版 5/7 = 71.4% · v0.3 5/7 = 71.4%（打平）**。
   - H1、H2 两条件**全部通过**，独立审计 inwardFaces 全 0（"该看见的面都看得见"在产物级成立）。
   - H3 两条件各 2/4，**四份失败全部是"接口未暴露到全局"**（验证器取不到几何，无法独立审计）；命令侧 4/4 都已要求该接口 ⇒ 瓶颈在执行 AI 的接口一致性。
   - 如实结论：**产物级目前不区分两个条件**；有区分度的是命令侧（88.9% vs 73.9%）。
2. **验证器三项修正**（上一轮误判的根因，已更正）：
   - "单文件"判定：允许 CDN 引入 three.js，只把"依赖本地外部脚本"视为非单文件；
   - "操控取值可用"：键位值接受字符串 / 数组 / 子映射对象三种形态，灵敏度须 0<s≤1、反转须为布尔（比"只看键名存在"严格）；
   - 题型感知：法线/修复题不把操控项计入失败（H2 操控题才要求）。
   - 自证保持：gold **16/16 PASS**；bad（绕序反转）**FAIL 且独立审计 inwardFaces=12**。
3. **结论更正（诚实标注）**：上一轮曾报告"v0.3 的 H2 产物 0/2、键位在但取值不可用"，并据此声称做了一次优化——复核后确认那是**验证器过严**造成的误判，该"优化"**没有被证据支持**；本版不再声称它带来提升，仅保留"可配置项须给出可校验取值"这一规格澄清。
4. **命令侧（同批，未变）**：无优化 2.2% · 发布版 73.9%（133/180）· v0.3 **88.9%（160/180，目标线）**；配对胜 7 / 负 2 / 平 1；同格重复采样平均极差 0.93 分/18。
## v0.3.0-beta.4 — 2026/09/15

作者：啃轮胎的西狐

**产物级接入 H2/H3 并做一键通过率统计 + 一次定向优化**

1. **一键产物级检查**：新增 `evidence/artifact-check.cjs` —— 扫描所有单文件 HTML 产物、按题型调用验证器、汇总"条件 × 题"通过率与独立审计数字，落盘 `evidence/artifact-check.json`（可复核）。
2. **产物级扩到三类题**：H1 法线盒体 / H2 操控人性化 / H3 审计并修复反向面，两条件各 2 次采样。实测（5 份/条件）：**发布版 4/5 = 80%、v0.3 4/5 = 80%**；H1、H2 两条件**各自 100%**（独立审计 inwardFaces 全为 0），H3 两条件各 1/2。
3. **定向优化（可自动化验收的接口独立性）**：产物级数据显示 v0.3 在 H3 上 0/2（产物把几何构造藏进闭包，第三方取不到）。据此把要求写死为"几何构造与自检写在**同一个可独立取用的函数**里（或把依赖一并导出）"——重跑后 **v0.3 H3 追平发布版（1/2），产物级总通过率 60% → 80%**。
4. **诚实边界**：① 产物级样本太小（每题 n≤2），两条件在产物级**打平**，不能据此说产物质量有差异；② H3 剩余失败仍是"接口未暴露到全局"，属执行 AI 的接口一致性；③ 一次真跑要约 2~13 分钟，故采样受限。
5. **命令侧（同批复测，未变）**：无优化 2.2% · 发布版 73.9%（133/180）· v0.3 **88.9%（160/180，目标线）**；配对胜 7 / 负 2 / 平 1；噪声平均极差 0.93 分/18。
## v0.3.0-beta.3 — 2026/09/15

作者：啃轮胎的西狐

**"可自动化验收"能力 + 简单/复杂平衡的取舍（本轮）**

1. **新增能力：可自动化验收**。用户说"我要能自动化验收 / 能自测 / 我要跑检查"时，命令必须把**验收接口原样带进命令**
   （接口名、返回值、判据），并要求该自检**能在无浏览器/无引擎的纯计算环境独立跑通**（不依赖 DOM 事件、不依赖闭包外部变量、不递归爆栈）、**接口挂到全局**。
   理由是实测出来的：产物级验证台发现"命令里没说清楚接口"时，产出的单文件 HTML 有 2/4 连 window.__selftest 都没暴露，无法自动验收。
2. **复杂度闸门加固（取舍，如实记录）**：未命中复杂信号时，命令里**不得出现**（现象量化 / 失效模式 / 全局验收场景 / 不得降级清单 / 本轮不做项 / 停手条件 / 证据形式 / 可自动化验收），且长度 ≤ 原话 1.5 倍或 800 字。
   - 加固前：复杂题 **93.9%**，但**简单任务回归不合格**（复杂包泄漏 1/4、长度 1.37×）。
   - 加固后：复杂题 **88.9%**（仍在目标线 83% 以上），简单任务回归 **PASS**（泄漏 0/4、长度 **0.95×**，比发布版还短）。
   - 结论：用约 5 分（复杂题）换回了"简单任务不被撑长/不越权"，这是有意的取舍，不是纯提升。
3. **产物级验证台（单文件 HTML，独立审计）**：不依赖浏览器（本会话 Edge 无法无头渲染），把产物脚本放进 Node 沙箱执行，
   **由验证器自己**从 `buildGeometry()` 取几何、算每个三角面的法线朝向并与质心比较，得出 `inwardFaces / facesOutwardRatio`；产物自报只作次要证据。
   - 验证器自证：`html-fixtures/gold.html`（按"从外看逆时针"构造）**15/15 PASS**；`html-fixtures/bad.html`（绕序整体反转）**FAIL 且独立审计 inwardFaces=12**。
   - 真实产物（H1 法线盒体 / H3 审计并修复反向面，两条件）：**通过 3/6**；SHIP H1、SHIP H3、V3 H1 三份 PASS 且独立审计 `inwardFaces=0`；
     其余三份 FAIL 的原因都是**产物没把接口挂到全局**（验证器取不到几何）。命令侧 4/4 都写了该要求 → **瓶颈在执行 AI 的接口一致性，不在优化器**。
   - 期间抓到的真实缺陷：V3 某次 H3 产物 `buildGeometry` 调用即**爆栈**；另一份 60 面中 **22 面朝内**（比例 0.63）——正是"该看见的面看不见"。

**命令侧实测（10 题 × 2 次采样 = 60 格，并发 4，共 265 秒，满分 180）**

| 条件 | 得分 | 换算满分 180 | 达标 |
|---|---|---|---|
| 无优化（对照） | 8/360 = 2.2% | 4 | 未达标 |
| 发布版 0.2.2-beta.1（极端档） | 266/360 = 73.9% | 133 | 及格线 |
| **v0.3.0-beta.3（极端档）** | **320/360 = 88.9%** | **160** | **目标线** |

- 配对：**胜 7 / 负 2 / 平 1**；同格重复采样平均极差 **0.93 分/18**（最大 5）。逐题差距最大的是 C1 3D 场景（+11.5）。
- 提示词规模：高级/极端 **5088 / 5086** 字符（普通档 1405）；约束闸门 **34 项断言全 PASS**（含"普通档不得出现能力包"反向断言）。
- 简单任务回归：复杂包泄漏 **0/4**、长度 **0.95×**、流程索取不比发布版重 → **PASS**。

## v0.3.0-beta.2 — 2026/09/15

作者：啃轮胎的西狐

**测试集扩容 + 答案侧测量 + 一个能力缺口修复**

1. **测试集 8 题 → 10 题、满分 144 → 180**：新增 **C9 载具物理细节**（斜坡打滑/抖动/陷地/穿模、物理帧与渲染同步）与 **C10 存档与配置持久化**（原子写入、版本迁移、损坏恢复、并发写、可观测）。
2. **能力缺口修复**：复查逐题得分发现"跨模块重构"被能力包漏掉（C5 一度 −2）→ 在分域清单补上 **重构/多模块** 域（调用面盘点、对外兼容或薄适配、分阶段且每阶段可验证、回归验证方案、可回退/开关/灰度、不趁机扩大范围）。修复后 C5 两次采样均满分（18/18）。
3. **答案侧测量（首轮，带局限说明）**：relay → solve → judge 三段真跑 5 题 × 3 条件 = 15 格（全部评分成功）：
   无优化 51.1% · **v0.3 47.8%** · 发布版 23.3%。数据/持久化题（可纯文本回答）v0.3 **17/18 vs 发布版 0/18**；
   但**无工具执行 AI 在 3D 题上全体贴地板**（C1 2/18、C2 5/18），且"无优化"因输出宽泛而虚高 —— 因此答案侧**只作辅证**，主指标仍是命令侧。

**命令侧实测（10 题 × 2 次采样 = 60 格，并发 4，共 289 秒，满分 180）**

| 条件 | 得分 | 换算满分 180 | 达标 |
|---|---|---|---|
| 无优化（对照） | 8/360 | 4 | 未达标 |
| 发布版 0.2.2-beta.1（极端档） | 273/360 = 75.8% | 136 | 及格线 |
| **v0.3 候选（极端档）** | **325/360 = 90.3%** | **163** | **目标线** |

- 逐题（两次采样均值/18）：C1 15.5 vs 4、C2 17.5 vs 10、C3 12.5 vs 13.5、C4 16 vs 12.5、C5 18 vs 18、C6 18 vs 18、C7 17 vs 16、C8 15 vs 13.5、C9 15.5 vs 16.5、C10 17.5 vs 14.5。
- 诚实标注：C3/C9 的 −1 分**落在噪声内**（同格重复采样平均极差 1.07 分/18、最大 7）；配对计数随批次波动（本轮 6 胜 2 负 2 平，上一轮 8 胜 1 负 1 平）。稳定结论是**总分 90% vs 76%**，不是"每题都赢"。
- 简单任务回归（4 道原题）：复杂包泄漏 0/4、长度比 1.11×、流程索取不加重 → PASS。

## v0.3.0-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**复杂任务能力包：细节逐项过关（v0.3 主功能）**

针对真实使用反馈 —— 一次性搭大场景 / 做精细可驾驶模型时，反复出现"法向量反向导致该看见的面看不见、不该看见的面看得见"、各类操控与交互 bug、交互方式不人性化 ——
在高级/极端档新增 `COMPLEX_RULES`（命中域信号才展开，普通档不注入）：

1. **现象量化**：先给\"怎么观测到问题\"的动作（数值审计 + 视觉对照两条路），不许凭感觉。
2. **分域失效模式清单，逐条变成可检查的要求**：
   - 3D/几何：法线朝向一致且外观面朝外、坐标与单位/尺度约定、不得穿插悬空、碰撞体与网格一致、光照阴影不受朝向影响、判定标准（应从外部可见/不应从内部可见）、导入后检查固化（防复发）。
   - 交互：用户主流程、**输入映射表**（键鼠/手柄各一套）、每操作有可见反馈、可发现、可恢复、可配置（灵敏度/反转/重绑）、**无障碍**（键鼠手柄并存/对比度/字号/色盲）。
   - 数据：幂等、回滚并演练、边界数据、一致性校验、上线顺序与并发写入、回归验证方案。
   - 并发：前端去重 + 后台幂等 + 失败/超时/重试语义 + 可观测 + 压测 + **不得引入死锁**（锁粒度/顺序/超时释放）。
   - 性能：先量化基线 → 按影响排序定位瓶颈 → 优化不得降画质（给等价替代）→ 目标值与达标线 → 每次改动后同时复核帧率与画质。
3. **全局验收场景** + 4. **不得降级清单**（逐条列出不得被砍的能力）+ 5. **影响面排序、范围边界与回退方式、本轮不做项与停手条件** + 6. **判定标准与证据形式**（没有证据不算完成）。
7. **细节缺陷自检**：交命令前逐条对照（法线/朝向/可见面、坐标单位、碰撞、输入映射与反馈、可恢复可配置、幂等回滚、并发去重与锁顺序、边界数据、性能预算与画质）。
8. **细节要求不得变成流程开销**：是否建 goal/todo/分阶段仍只由"流程长度"规则决定；不得写与本题无关的模板段落。

**新测试集（可复核）**：`evidence/lab-cx.cjs` —— 8 道复杂题（3D 场景 / 可驾驶坦克 / 法向量审计 / 交互人性化 / 跨模块重构 / 数据迁移 / 竞态 / 性能预算），
每题 6 条要点 × 4 档（0 缺失 / 1 模糊提及 / 2 可判定要求 / 3 可判定 + 验证或边界），**每题满分 18、全表满分 144**，
并给出 60% / 83% / 100% 三条达标线；判分**确定性执行**（概念级同义扩展，0 次额外 LLM 调用）。

**实测（同一批 8 题 × 2 次重复采样 = 48 格，并发 4，共 230 秒）**

| 条件 | 得分 | 换算满分 144 | 达标 |
|---|---|---|---|
| 无优化（对照） | 6/288 | 3 | 未达标 |
| 发布版 0.2.2-beta.1（极端档） | 201/288 | 101 | 及格线 |
| **v0.3 候选（极端档）** | **265/288 = 92.0%** | **132** | **目标线** |

- 配对（每题两次采样均值，满分 18）：**v0.3 胜 7 / 负 0 / 平 1**；逐题：C1 场景 +11.5、C2 坦克 +4.5、C3 法向量 +3.5、C4 交互 +4、C5 重构 +4.5、C6 数据 ±0、C7 竞态 +2.5、C8 性能 +1.5。
- 同格重复采样波动：平均极差 **0.75 分/18**（最大 5）。
- **简单任务回归**（`lab-simple.json` 4 道原题）：复杂包泄漏 **0/4**、命令长度比 **1.11×**、流程索取不比发布版重 → PASS（细节要求没有变成流程开销）。
- 提示词约束闸门：**34 项断言全 PASS**（新增 4 条能力包正向断言 + 1 条"普通档不得出现能力包"反向断言）。

## v0.2.2-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**界面国际化（本版主功能）：插件 UI 跟随 DSH 的语言设置，中英双语**

- 客户端读取 DSH 的 `locale` 服务（`getSnapshot().active` ＝ `zh` / `en`）并订阅变化，**切换即时生效、无需重启**。
- 覆盖范围：控件行（档位/权限/上下文/模型）、上下文「回合 / 全文」按钮、模型弹层、**迷你窗**（栏目标题、按钮、状态行、token 行）、通知提示、`?` 帮助面板全部 6 节 21 行、悬浮球与署名行。
- 文案表 `EN_TEXT` 以**中文原文为键**（179 条，无重复键），查不到即原样返回中文 → **漏翻只会显示中文，永不空白**；读不到 locale 服务时同样按中文兜底。
- 帮助面板「怎么用」新增第 ④ 行：说明界面语言跟随 DSH 设置。
- **英文档位名定为 `Off / Low / High / Ultra`**（中文仍为 关闭 / 普通 / 高级 / 极端）；档位名一律经 `L()` 翻译，
  提示文案不再直接暴露内部 id（原先英文会显示 `tier extreme`）。自检断言：EN 四个档位名渲染为 `["Off","Low","High","Ultra"]`、ZH 为 `["关闭","普通","高级","极端"]`（`tierLabelsOk:true`），
  英文提示条实测 `"Sent the result optimized at tier Ultra"`。
- 自检（全部实测，客户端 beacon 回执）：
  - `i18n-demo` **PASS** —— EN 必须命中 `Help` / `Tier` / `Substance first` / `Process weight` / 语言行，ZH 对应中文；`rows=21 / sections=6`。
  - `i18n-overlay-demo` **PASS** —— EN 迷你窗 **26 个文本节点中文残留 `cjk=[]`**、按钮 `["‹ Roll back","Confirm & send","Regenerate"]`；模型弹层 `popCjk=[]`。
  - `locale-switch-demo` **PASS（真·跟随 DSH 设置）** —— 真调 locale 服务 `setLocale("en")`：档位标签变 `"Off"`、帮助按钮 aria 变英文；切回后 `after:"zh"`（用户语言已还原）。
  - `i18n-missing.cjs` 静态扫描：渲染代码里未包裹 `L()` 的中文字面量 **0**。
  - `lang-probe.cjs` **真跑实测产出语言**（走宿主生产路径 `POST /run`，不进会话、不发消息）：英文输入 → 产出全文 **3511 字符、中日韩字符 0**；中文输入 → 1353 字符、中日韩 **1037**（占 0.766）；`pass:true`，原始数据 `evidence/lang-probe.json`。

**本轮顺手修掉的三个真缺陷**

1. `frame()` 等两次 `requestAnimationFrame` —— **后台标签页 rAF 不触发**，探针/自检会永久挂住（实测演示通道假死 90s 无回执）；改为 rAF 与 150ms 超时竞速。
2. 探针互斥标记 `__DPO_PROBE_RUNNING__` 卡死无自愈 → 整个演示通道假死；加 90s 陈旧自愈（`probe-stale-reset`）与 `probe-skip` 留痕。
3. 英文界面残留中文（浮层状态行「上下文 N 回合」、查证行「N 步 / N行」、按钮「放行本条」等 40 处 + 43 条词典补齐）。

**产出语言跟随用户原话**

- `RELAY_IDENTITY` 增加硬规则：**输出语言＝用户原话的语言**（英文原话通篇英文，含小标题与清单项，不中英混排；中文原话中文输出；其他语言同理跟随）。

**版本与文档**

- 版本号 0.2.1-beta.2 → **0.2.2-beta.1**；`README.md` / `README.en.md` 按新版本**重构**：两份文档**顶部互相提供大号跳转按钮**、
  五点声明更新（明确「已支持中英双语，跟随 DSH 语言设置」，不再是"仅中文"），新增「更新介绍 What's new」与
  「实测数据与证明」两节（命令侧 / 答案侧数据 + 四条限制说明 + 复现入口），并写明当前适配 `dsh-0.1.6-alpha.1`。
- 插件内 `?` 面板署名版本同步为 `0.2.2beta1`。

## v0.2.1-beta.2 — 2026/09/15

作者：啃轮胎的西狐

**答案侧测量：修掉两个"把活推回去"的缺陷（0.2.1-beta.1 的补充）**

beta.1 只量了命令侧；这一轮补上**下游回答侧**（严格评分 0/1/2、盲评），并加了两道硬题：
T5 条件概率陷阱（"至少有一个是女孩"→ 1/3，naive 答 1/2）、T6 物理量级估算（缓冲距离主导 → 约 20~100 倍体重）。

**答案侧结果（满分 10/题）**

| 条件 | T5 陷阱题 | T6 物理估算 | T4 工程题 |
|---|---|---|---|
| 无优化 | 8 | 4~5 | 9 |
| 0.1.1 旧 | 10 | 9 / 7 | 9 |
| 0.1.9 当前 | 8 / 10 | 9 / 9 | **4** |
| 0.2.1-beta.1 | 10 / 10 | 10 / 9 | **4** |
| **0.2.1-beta.2** | **10** | **10** | **10（高级档）** |

**测出并修掉的两个真缺陷（都属"把活推回给用户"）**

1. **项目事实未知 → 写成"停下等我确认"**：题目只说"给一个 Python 函数加缓存"，relay 判断"没指定哪个函数"，
   于是命令写成"先列候选、停下等我确认，确认前不得改任何源码" → 执行 AI 卡在第一轮（T4 只得 4/10）。
   修法：`FACT_RULES` 增加**两种"不知道"的区分** —— 项目事实未知（哪个文件/函数/测试命令）→ 写成工作 AI
   **自己去查**的动作；用户意图未知（要改什么、做到什么程度）→ 才写"先向我确认"。
2. **过度把设计选择退给用户**：修完第 1 条后，命令变成"7 条确认清单等你答复"，仍然卡住。
   修法：`SUBSTANCE_RULES` 增加**"能定的自己定"**（能从目标推出的实现细节与默认选择直接写进命令并说明取舍；
   该问的一次最多 1~2 条、必须带推荐默认值）与**"查不到也要能推进"**（给出"无法唯一确定时选影响面最小的那个、
   写明依据继续做完"的兜底路径）。

**实测效果**：高级档在 T4/T5/T6 三题上 **10/10/10 全满**；活路径实测输出已含兜底路径与默认选择
（"若无法唯一确定是哪个函数，选调用点最多、影响面最小的那个，写明依据后继续做完；只有破坏对外接口兼容
或涉及持久化数据时才停下来先问我，不得空等"）。

**诚实标注**：极端档 T4 的答案侧分数（1~6/10）属**测量台局限** —— 台里的执行 AI 没有文件系统/命令工具，
而命令要求它"先扫工作目录"，于是只能停下；该格不作为提示词缺陷记入（命令本身经逐字检查质量最高）。

## v0.2.1-beta.1 — 2026/09/15

作者：啃轮胎的西狐

**修复"提示词相对 0.1.1 反而退化"：实质优先（SUBSTANCE）重新前置，合规机器让位**

结论先说：用户体感属实，并且量到了。用控制变量测量台（同题、同执行 AI、同评分卡）在 4 道题上比对
「无优化 / 0.1.1 旧提示词 / 0.1.9 当前提示词 / 新候选」，命令侧评分＝优化器产出的命令本身注入了多少实质要求（满分 5/题）：

| 题（高级档） | 0.1.1 旧 | 0.1.9 当前 | 0.2.1 发布版 |
|---|---|---|---|
| T1 数学·注水 | 5 | 4 | 5 |
| T2 数学·Ramsey 定理 | 5 | 4 | 4 |
| T3 物理·碰撞估算 | 5 | 5 | 5 |
| T4 工程·线程安全缓存 | 4 | 3 | 4 |
| **合计 /20** | **19** | **16** | **18** |

极端档（n=2~3 重复采样）：0.1.1 **18.7**、0.1.9 当前 **15.3**、0.2.1 发布版 **18**；
其中 **发布版 ≥ 当前版 10/10 次配对比较**（p≈0.001），不是噪声。

- 根因诊断：0.1.6~0.1.9 累积加的「交付闸门 / 流程长度 / 事实纪律」约 600 字符，把注意力从"注入实质要求"拉到了"别违规"，
  产出变得**合规但浅**；0.1.1 只有「身份 + 档位正文 + 禁止元话语」≈1.3KB，实质反而更足。
- 修法（按实测选出的赢家 C7）：新增 **`SUBSTANCE_RULES` 实质优先**段，置于身份之后、档位正文之前 ——
  要求先在推理通道里把事推一遍（必要假设 / 领域必需量 / 中间步骤 / 边界与异常 / 不确定处写成查证动作），
  再把结论变成对工作 AI 的要求；其余合规段精简（`交付契约` 3 条、`事实与硬度` 4 条、`流程长度` 压成两行放末尾）。
- 规模：普通档 1319 → **1172** 字符（−11%）；高级 1857 → **1815**；极端 1877 → **1813**（更短且更强）。
- 约束零丢失：`prompt-invariants.cjs` 29 正向 + 4 反向断言全 PASS（仅"完成判据"一条按新措辞同步更新）。
- 四档都测：**关闭**＝无优化对照（只得 2/12 要点，证明优化确有效果）；**普通**＝只做语言层（4/20，设计如此、不新增需求）；
  **高级 18/20**、**极端 18/20**。

**兼容性声明**：本版本适用于 **dsh-0.1.6-alpha.1**（升级后在 0.1.6 上完成全链路验收；0.1.5-rc.1 亦可运行）。详见 `DSH-COMPAT.md`。

## v0.1.9-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**修复：放行/回退后仍被自动发出第二条（表现为「排队发送」）**
- 根因：`releaseOriginal()` / `rollbackYes()` 只清了 `store.run`，但 SSE 事件闭包里持有的那份 run 对象依旧存活；`done` 事件只看 `store.permission === "auto"` 就调用 `autoSend()` → 用户已经放行或回退之后，又自动提交了一次（第二次撞上正在处理的会话，于是变成「排队发送」）。回退路径更严重：面板明确承诺「不发送任何消息」。
- 修法：给运行加"已被用户终结"标记（`run.settled = released / rolled-back`），`autoSend()` 与 `done` 分支都先看这个标记；`autoSend` 自身置 `settled = auto-sent` 保证同一次运行只自动发送一次；放行时同时关流并向后端 `/run/abort`（不再白烧 token）。
- 回归测试 `release-race-demo`（客户端自检，提交用计数桩、不真发消息）：放行后 `submit` 增量必须是 1、回退必须是 0、以及"流仍活着且 `done` 真的到达"时必须是 0（该场景打出 `done-after-settle` 证据）。
- 负对照（保留同一份自检、只拆掉守卫）实测 `PASS=false`：放行用例 `submitDelta=2`、`sentFlag=true`，第二次发出的正是优化后的文本；守卫用例漏发 1 次 —— 证明该缺陷真实存在且此测试抓得住它。
- 修复版复验：`PASS=true`，`submitDelta` 分别 1 / 0 / 0，客户端报错 0 行。

**同批一并发布：传话 AI 提示词的提效与硬化（详见 PROMPT-OPTIMIZATION.md）**
- 三档 system 改为共用部件 + `buildSystem(tier, { historyMode })` 组装；重复表述三处合一，普通档 1445 → 1319 字符（−8.7%）。
- 约束力硬化：长度上限、逐句回溯删除、软措辞禁令（尽量/最好/建议… → 必须/不得/判据）、硬约束三分类 + 每条违反时的处置 + 不得替用户承诺、事实纪律白名单化。
- 新增**难度 → 开发长度**判定：轻（默认，禁止建 goal/todo/计划）/ 中（3~6 条 todo）/ 重（建 goal + 分阶段 + 每阶段验证）；高危信号命中即不得停留在轻档；未命中不得升档、不得因字数多升档。带标准答案的判定用例终测 12/12，漏隐患 0、徒增开销 0。
- 修复全文模式下的提示词谎报（旧文案称"工作 AI 回复只留长度"，而全文模式恰恰发送全文）——拆成回合/全文两份纪律，按 `run.historyMode` 注入。

## v0.1.8-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**上下文模式：回合（0~10）/ 全文（与工作 AI 看到的上下文一致）**
- 回合量程从 0~100 收到 **0~10**：100 回合足以把优化模型的上下文撑爆；宿主夹紧同步改为 10（写 999 → 10、写 12 → 10、写 -5 → 0）。
- 滑块右侧**贴着**一枚「回合 / 全文」转化按钮（同一胶囊内、竖线分隔、点一下换一态）：
  - **回合**：滑块 0~10 档，只带用户原话（工作 AI 回复只留长度与工具次数，防污染）。
  - **全文**：滑块两档 **关 / 开**；开启后把工作 AI 当前看到的完整上下文（双方全文）交给优化模型，总预算 **60000 字**，超限**整回合省略**、绝不截断单条约束。
- 实测（活会话 `session-ae0b2c09…`）：回合态 `turns=10 → 10 回合 / 10356 字 / 省略 0`；全文态 → `25 回合 / 57591 字 / 整回合省略 93`；全文态关闭 → 不带历史（`history:null`）。
- 模式与开关随配置落盘（`historyMode` / `fullOn`），非法值自动回落 `turns`（写 `bogus` 读回 `turns`）。

**UI 扁平化极简（对齐 DSH 观感）+ 底栏压缩**
- 去掉渐变、内阴影、玻璃拟态与"实体感"高光：胶囊 / 滑块 / 模型钮 / 帮助钮统一 **26px 高**、**7px 圆角**、单层平色底 + 1px 描边；轨道 3px、圆钮 12px 平色。
- 底栏行高 26px 且贴底：实测宿主容器 28px、控件行 26px、底边对齐 → **不再把输入框挤上去**。
- 圆钮两端各内缩 6px（新增 `.dpo-range-inner` 行程道）：0% / 100% 时圆钮**不再越出轨道**（修复前实测越界 8px）。
- 交互与无障碍不变：拖动 / 点击 / ←→（Shift ±10）/ PageUp-Down / Home-End；`role=slider` 落在轨道上（胶囊去掉 slider 语义，避免按钮嵌进 slider），回合态 aria `max=10`、全文态 `max=1` 且文案「全文 关 / 开」。
- 修复：底栏内的按钮不再被「发送」判定误吞（`[data-dpo="controls"]` 直接放行）。

**自检**
- `range-demo`：两模式共 5 个采样点（回合 0/5/10、全文 关/开），文本、几何（圆钮居中比例与设计值逐点一致）、aria、按钮两态切换、扁平化（无渐变 / 无阴影 / 26px）全部通过 —— `pass:true`。
- 模式按钮经两次合成点击实测 `turns → full → turns`。

## v0.1.7-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**UI 归一化：上下文控件改为「数字滑块」+ 三控件统一尺寸**
- 上下文控件去掉中文标签（不再显示「上下文 12 / 上下文 关」），**滑块上直接显示当前回合数**（等宽数字，避免宽度抖动），一眼可知当前设定。
- 形态改为**固定宽度滑块 + 数字写在滑块上**：原实现"每格一个标签"，100 档时每格仅约 8px，文字必然溢出边框；新实现滑块恒为 40px 宽，数字永远在框内。
- 三枚胶囊统一 **30px 高**、12px 字号、同圆角同配色；模型胶囊与帮助按钮同高 → 整行视觉归一。
- 交互：拖动 / 点击 / ←→（Shift 加速 ±10）/ PageUp-Down / Home-End；`role=slider` + `aria-valuenow/valuetext`。

**默认值与会话回退**
- 读取回合数默认 **0**（= 改动前的等价行为），客户端与宿主默认值同步为 0；随时可调大。
- 历史总预算 **12000 字**：超出时**按整回合丢弃最早的**，并在上下文里标注省略了几个回合——**绝不截断单条约束条款**。
- 实测：`N=0 → 无历史`；`N=10 → 10 回合 / 2855 字 / 省略 0`；`N=100 → 保留 26 回合 / 10082 字 / 整回合省略 74`。
- 配置往返与夹紧实测：写 12 读回 12；写 999 → 100；写 -5 → 0。

## v0.1.6-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**优化 AI 读入最近 N 回合上下文（0~100，可调）+ 防污染设计**

- 新增「上下文」胶囊滑块（与档位/权限同款长圆框 + 内部小滑块）：0 = 不读，档位为非线性刻度 ,1,2,3,4,6,8,12,16,24,32,48,64,80,100，兼顾"近几回合"的精度与 100 回合的量程；格内只显示当前档文字，避免糊成一团。
- 宿主通过 `ctx.sessions.get(id).ownEvents()` 读取真实会话事件：**用户原话全文**进入上下文（单条上限 4000 字）；
  **工作 AI 的回复被刻意只保留长度与工具调用次数，内容一律不喂**——只借"用户想要什么"，绝不吸收工作 AI 的方案/结论/术语/口吻。
- 提示词里新增 `HISTORY_RULES`（三档共用）+ 历史块自带纪律行；历史与用户原话冲突时以原话为准。
- 运行状态行新增「上下文 8 回合 · 873 字」徽标（`run.history`），可直观确认这次究竟读了多少。
- 落盘新增 `turns`（全局偏好，0~100 夹紧）；`/runs` 遥测暴露 `turns` 与 `history`。
- 实测：`turns=8 → history={turns:8, userTurns:8, chars:873, degraded:false}`（`chars` 只累计用户文本，证明工作 AI 内容确实未进入上下文）。
- 隐私说明更新：上下文**在本机读取**，只有用户文本会随优化请求发给优化模型；工作 AI 的回复内容不会离开本机。
## v0.1.5-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**胶囊滑块（更简洁的控件形态）**
- 档位/权限改为**一个长圆框、里面一个小滑块滑动**：取消外侧标签与数值胶囊，控件行更短更干净。
- **单元对齐**：滑块覆盖当前档位整格（left=i/N、宽=1/N），点击/拖动命中用同一套单元坐标 floor(t*N) —— 视觉、命中、键盘三者同源。
- 语义色延续：档位 灰/蓝/紫/橙、权限 绿/琥珀，滑块底色与选中文字同色系；hover 强调色描边 + 外发光。
- 无障碍保留：role=slider / aria-valuenow / aria-valuetext / tabIndex + ←→ Home/End。
- 宽度显式化（内部绝对定位）：档位 152px、权限 98px，并按窗口宽度三档收缩。

## v0.1.4-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**修复：探针标记可能泄漏进真实会话（作者失误的根因修复）**

事故：作者发了一条**未知命名的自检命令**，而当时浏览器里是旧版客户端 → 命令没有匹配到任何自检分支，**回落到通用探针分支**并启动了整套 19 步探针；随后热重载把探针**中途打断**，其收尾自清场没跑完，于是探针用于"真投递验证"的 `DPO-基线测试-<token>` 标记被提交进了真实会话。

三道闸门（都已实测）：
1. **未知命令一律拒绝**：`run` 不等于 `selftest` 时只记 `cmd-unknown` 埋点并返回，**绝不回落探针**。回归实测：`run=slider-demo-TYPO` → 仅 `cmd-unknown`，无 `probe-start`。
2. **探针需显式投递授权**：`selftest` 还必须带 `deliver:true`，否则记 `probe-refused` 并跳过 —— 探针的投递步骤再也不会"顺手"发生。
3. **两侧兜底清扫**：客户端启动 1.2s 后 + 每 60s 调一次 `/inbox/sweep`；宿主开机时对 `DPO-` 做一次权威清扫。实测队列：全部会话 `nextTurn/nextStep` 为空，**零残留**。
## v0.1.3-beta.1 — 2026/09/14

作者：啃轮胎的西狐

**采纳社区 PR 报告的真实缺陷（已修复并实测）**
- **长草稿被截断**（PR#4 @ChinaBuleSky）：`record()` 是遥测行、会把 text 截到 160 字，而拦截路径把它的返回值当成了功能载荷 → 超过 160 字的输入只有前 160 字进入优化器。现改为另取草稿原文；实测 255 字长草稿完整送达（`sent=255, captured=255`）。
- **滑块刻度与拇指坐标不一致**（PR#1 @NekoDD-wow、PR#2 @S-AN-Shu）：刻度点用 flex 中心 `(i+0.5)/n`、拇指/填充用 `i/(n-1)`，四档里有三档会点错。现刻度层与拇指同用 `i/(n-1)`；实测四点偏差全为 0，逐点点击 4/4 命中。
- **滑块可达性**：补 `role=slider` / `aria-valuenow` / `aria-valuetext` / `tabIndex` 与 ←→ Home/End 键盘操作。

**学自社区风格的 UI 升级**
- **语义化颜色**：档位 关闭=灰 / 普通=蓝 / 高级=紫 / 极端=橙；权限 审查=绿 / 自动=琥珀 —— 填充、拇指、刻度、数值标签同色系，一眼看出状态。
- **刻度层重做**：独立层、与拇指同源，灰点 11px/72% + 描边，选中态外扩；仍保留逐档可点与 tooltip。
- **结果悬浮球**（PR#1 思路）：发送成功后把结果收成一颗按档位配色的小球（可拖动、单击展开回看），并新增**已发送只读**态（「已发送 · 仅供查看」，不再出现「确认提交」，`confirmSubmit` / `releaseOriginal` 在已发送态直接短路，杜绝重复发送）。
- 控件行自愈重挂改用不同优先级，消除 `list slot ... already has an entry` 报错。
## v0.1.2-beta.1 — 2026/09/11

作者：啃轮胎的西狐

UI 迭代：更合理、更人性化、更极简、更优雅。

**控件行**
- 两个滑块加**内联名称**（档位 / 权限），首次使用不必靠 tooltip 猜。
- 移除会顶动布局的**行内提示条** → 改为**浮动通知气泡**（固定于输入框上方，不参与行内布局）。
- 移除行内**拦截累计徽标** → 收进标题栏小徽标与帮助面板抬头（信息不丢，行更干净）。
- 滑块与模型胶囊之间加**发丝分隔线**，形成"强度 / 权限 ｜ 模型 ｜ 帮助"的分组；帮助按钮改为无边框幽灵样式。

**迷你窗**
- 标题栏极简：状态点 + 「提示词优化」+ **本次运行档位徽标** + 拦截计数；尺寸提示改为悬浮才显形。
- 删除冗余的「档位/权限/拦截累计」信息行。
- **思考 / 原文 / 查证动作** 三块改为**可折叠**（默认收起，各带一行摘要：token 与字数 / 原文字数 / 查证步数）；运行中思考自动展开，完成后自动收起，把空间让给产出。
- 审查态**不再重复渲染只读产出面板**（可编辑文本框即产出）；错误重试/默认模型重试移入常驻底栏。
- 回退按钮统一到**常驻底栏一处**（审查态底栏为 回退 / 确认提交 / 重新生成 三键）；回退确认改为内联卡片。

**其他**
- 折叠箭头带旋转动效、通知气泡带弹入动效；`prefers-reduced-motion` 下全部关闭。
- 自检扩充：`run-demo` 上报标题栏/折叠状态/底栏按钮/whether-toast，`controls-demo` 上报内联标签与行内冗余元素是否存在。
## v0.1.1-beta.1 — 2026/09/11

作者：啃轮胎的西狐

首个对外分享版本。核心能力：

- **发送接管**：捕获阶段拦截回车与发送按钮（`Shift+Enter`、`/` 命令、空草稿、卡片外回车一律放行）。
- **传话者语义**：优化 AI 明确是"把用户意思转达给工作 AI"的传话器 —— 不回答用户、不替用户干活、不向用户提问；产出是**可直接发送的命令正文**，无「优化后的提示词 / 改动说明」这类元话语。
- **三档强度**：普通（语言精确化，约 3 秒）／高级（补"显然需要"的约束与验收，约 20 秒）／极端（只读查证项目结构 → 分阶段行动计划 + 验收标准 + 多情况预案，约 20 秒）。
- **两种权限**：需要审查（产出可编辑，确认后发送）／自动输出（完成即发送；失败也按原文发出，绝不静默吞消息）。
- **迷你窗**：可拖动、可改尺寸（记忆）、按会话隔离、常驻底部操作栏（窗口再小按钮也不消失）、思考/产出双通道流式 + 流式光标 + 自动跟随滚动、**思考 token 计数**。
- **按会话独立的档位与权限**：A 会话的设置不影响 B。
- **模型独立**：优化模型与对话模型互不影响；目录预热 + 双层缓存 + 单家超时，死模型自动回退。
- **使用帮助**：控件行 `?` 面板（怎么用 / 档位 / 权限 / 迷你窗按钮 + 推荐组合）。
- 测试与证据：`ACCEPTANCE.md` 逐格验收清单；`evidence/` 内为自检报告、三档对照、几何与产物形态回归等机器留痕。

### 已修复的典型缺陷（详见 `ACCEPTANCE.md`）

- 回退 / × 点击无效（pointerdown 的 `preventDefault` 抑制了 click）。
- 审查态看不到确认提交 / 重新生成（浮层内容被裁且不可滚动）。
- 浏览器缩小后弹窗出现在不可见坐标（开窗未夹紧）。
- 开启档位后"无法发送"（优化模型不可用 + 失败被静默吞掉）。
- 弹窗不再显示（React #310：hook 写在 early return 之后）。
- 模型目录加载不出来（客户端从未拉取 `/models`）。
- 右下角拖不动改尺寸（手柄被常驻底栏盖住 + `onSizeUp` 丢掉最后一次位移）。
- 优化 AI 误以为在跟用户对话（角色与用户消息都缺少"传话"框架）。