# Changelog
## 4.6.12 (2026-10-31)
> **4.6.11 的上下文窗口守卫补上了第二条出口。** issue #72 指出：#70 把兜底做进了
> `toPiModel`（适配器出口），但 `registerModelDiscovery` 回调——模型发现走向 DSH 的
> 另一条出口——仍把 `contextWindow` 原样透出，而宿主对发现行**不做任何校验**。一条
> 畸形的目录行因此能绕过 #70。
### 变更
- **发现回调永远发出正整数窗口**（issue #72 的主点，`src/index.ts`）。
- **问题**：宿主 `discoverModels()` 只按 id 去重，`contextWindow`/`maxTokens`
原样透传；模型管理界面把发现行**逐字**采纳进 `models` 配置项，而那一项的 schema
要求 `step(1).min(1)`。所以原样透出意味着两件事之一：畸形值被带进下游，或者
（目录省略窗口时）行以「无窗口」抵达 DSH——正是 #70 的故障形态，只是绕开了
适配器。症状同为一条坏行 ⇒ `INVALID_MODEL_CONTEXT` ⇒ 整个区域离线。
- **改法**：回调改为永远发出 `contextWindow: servedContextWindow(model)`——
与适配器出口同一条规则、同一个兜底值（200 000）。两条「字段缺失即不发」的
分支合并成一条恒发字段，两个出口对同一行给出的值因此不可能分叉。
- **目录层把「在场但畸形」归一化（三处），「省略」依旧合法**（issue #72 的后半 +
评审判断，`src/catalog.ts`）。
- `mergeTraeModelSources` 的目录分支、`mergeTraeModelSources` 的 wire 提升分支、
`discoveredCatalog` 各加一条 `servedContextWindow` 归一化：窗口缺失仍按缺失
上报（`tests/catalog.spec.ts` 里钉住这条既有契约的用例保持绿），但**在场**的
值必须是正整数，否则换成兜底。
- **为什么目录层也值得补**：上游解析门 `finitePositive` 只查 `isFinite && > 0`，
所以 `200000.5` 能活着走完解析；一个分数窗口若跟着目录行存进 `lastCatalog`，
会让**整次设置写入**被 schema 拒绝（`modelConfig` 的 `step(1).min(1)`）。
归一化留在生产侧，坏值就永远进不了持久化。
- **评审修正**：报告者建议 wire 提升分支不打守卫，理由是其上游
（`get_detail_param`）「结构上产不出畸形值」。核对该分支的取值链
`contextWindow = prompt_max_tokens ?? context_window_tokens.dev`——两个来源
都出自 `finitePositive`，分数值（如 `300000.5`）**能**从那里活着到达。
故本次三个出口一起补；`FALLBACK_CONTEXT_WINDOW` 与 `servedContextWindow`
自 `src/adapter.ts` 移入 `src/catalog.ts` 导出（无循环依赖），两处出口共用。
- **`maxTokens` 有意不动**：宿主对发现行的 `maxTokens` 同样不校验，但它的
校验发生在 `normalizeModelInfo`（`INVALID_MODEL_MAX_TOKENS`，适配器路径，
#70 已覆盖）；目录行里 `maxTokens` 畸形只影响「最大输出」展示，没有
`INVALID_*` 硬失败面。与 #70 的口径保持一致：本补丁只管上下文窗口。
- **未采纳（留待单独评估）**：把 `finitePositive` 收紧为 `finitePositiveInteger`
——报告者自己标注的行为变更，会同时改变目录解析与 wire 解析的入站语义，
不适合作为一个守卫补丁的顺车。
### 测试
- 新增 **6** 例（1240 总例，较 4.6.11 净增 6）：
- **真实路径**（`tests/discovery-context-window.spec.ts`，5 例）：与
`tests/settings-integration.spec.ts` 同款宿主挂具（`LlmRuntime` +
0.1.7 形状的内存 settings + 临时 DSH_HOME + 临时 storage.json 凭据，含
`readTraeIdentity` 要求的 `telemetry.*` 身份字段），`vi.stubGlobal('fetch')`
桩出目录 / wire 花名册 / IDE 花名册三个端点，走
`ctx.llm.discoverModels(TRAE_SETTINGS_NS, { provider: 'trae' })` 断言宿主
**读回**的行：分数目录行 → 兜底、省略窗口行 → **显式**兜底（`Object.hasOwn`
钉住「恒发字段」）、正常 168 000 原样保留（兜底是背板不是钳位）、wire 提升
行的分数 `prompt_max_tokens` → 兜底、以及一条「所有行都是正整数」的全量扫描。
- **目录单元**（`tests/catalog.spec.ts`，1 例，覆盖
分数/0/负数/NaN × 三处出口 + 正常值不动）。
- **变异验证**：把发现回调改回原样透出 → 真实路径 5 例中 2 例转红（全量扫描、
省略窗口）；把 `src/catalog.ts` 三处守卫改回原样 → 目录单元例转红。恢复守卫后
全绿。
- 全仓 **1240** 例通过（97 文件），双 tsconfig 类型检查通过。
## 4.6.11 (2026-10-30)
> **英文界面下的「最近刷新」不再显示成中文式的时间。** issue #71 里顺带提到的那点：
> `formatClock` 把 locale 硬编码成 `'zh-CN'`，所以英文界面印的是 `23:59` 而不是
> `11:59 PM`。
### 变更
- **`formatClock` 不再硬编码 locale**（issue #71 的第 1 节「顺带一提」）。
- **问题**：`formatClock` 写死 `'zh-CN'`，于是英文界面按中文习惯排 24 小时制，
显示 `23:59` 而不是 `11:59 PM`。同一文件里的 `formatDateTime` 用的是
`undefined`（跟随读者语言）——两个函数对「按谁的格式」各说各话。
- **改法**：`toLocaleTimeString('zh-CN', …)` → `toLocaleTimeString(undefined, …)`，
与 `formatDateTime` 对齐。
- **影响面**：`formatClock` 现在只剩一个调用点——`composer.lastRefresh`
（「最近刷新」）。到期时刻早已改用 `formatDateTime`（4.6.7），所以本次**不影响**
到期提示的渲染。
- **姊妹插件暂未同步**：`dsh-connect-workbuddy` 与 `@dmh2002/dsh-connect-qoder`
各自的 `formatClock` 里也有同样的硬编码（`ComposerCredits.tsx`），但它们不在
issue #71 的范围内，故本次**只改 trae**。三家的差异见下。
### 测试
- 新增 **2** 例（1234 总例，较 4.6.10 净增 2）：
- **源码级**：`formatClock` 不得再出现硬编码的 locale。这一条不依赖测试环境的
locale——行为级断言在 zh-CN 环境下会因两种写法结果相同而失效，源码级不会。
- **行为级**：渲染出的「最近刷新」戳必须等于**读者 locale** 对该时刻的写法。
`composer.lastRefresh` 是「最近一次刷新的时刻」（即当前时间），所以期望值取
渲染前后两个瞬间，容许跨过一分钟边界。
- **变异验证**：把 locale 改回 `'zh-CN'`，两条用例**同时**转红（源码级点名
「still pins a locale」，行为级报出实际渲染值 `19:31` 与期望的 `07:31 PM`）。
- 全仓 **1234** 例通过（96 文件），双 tsconfig 类型检查通过。
## 4.6.10 (2026-10-30)
> **到期提示加了一档「3 天内」。** 一个两天后过期的套餐，之前显示的是「7 天内过期」
> ——话没错，但粗了三倍，而这句通知唯一的职责就是告诉你**还剩多久**。上游一直有
> `within3d` 这个桶，插件却没用它。
### 变更
- **到期提示新增「3 天内」一档**（issue #71 的第三条建议）。
- **动机**：档位只有 24 小时和 7 天两档，而上游的桶是三个。两天后到期的积分
落进 7 天桶，于是被报成「7 天内过期」——真话，但粗了三倍。要么现在用掉这个
桶，要么永远让「还剩多久」这件事只能精确到 24 小时或 7 天这种量级。
- **口径：累积，每档报自己那个桶。** 上游的三个桶是**嵌套且累积**的
（`within24h` ⊆ `within3d` ⊆ `within7d`），所以每一档报的
「N 天内过期的总额」单独看都是真的；而且**同一时刻只显示一档**，读者永远
不需要把两个数字相加。
- **为什么不报排他金额**：曾考虑让 3 天档只报「1~3 天那一段」的金额，好处是
各档互不重叠、可相加。但那会与现有两档的语义**不一致**（7 天档报的一直是
`within7d.total` 这种累积额），而且平白多出一个数据字段和一处「档位顺序 +
档位口径」要同时维护的地方。累积口径下每句话单独成立，更简单也更不容易错。
- **数据层零改动**：`within3d` 桶本来就在上游摘要里算好了，本次只是把它接进
阶梯。`src/web-status.ts` 的取数逻辑一行未动。
- **文案**：新增 `row.expiryWarningDays`（中英各一条）。
「24 小时内」「3 天内」「7 天内」三档读起来是同一套量词，不引入新的说法。
- **语气**：新增 `dsm-trae-expiry-days`，视觉上**介于另外两档之间**——保留警示
边框（三天内到期不该被一眼扫过去），但不要警示底色（三天的量级不是 24 小时
那种急事）。于是四档从急到缓是：soon（警示底色）→ days（警示边框）→
week（普通）→ lapsed（更淡）。
### 顺带修掉的两处结构性隐患
**一、卡片与面板现在共用同一个阶梯**（新增 `src/client/expiry-ladder.ts`）。
两处渲染的是**同一批 locale key**（`row.expiryWarning*`、`row.expiryEarliest`）、
同一份上游桶，却各自写了一套档位判断。这正是 4.6.7 那个 bug 的根源——那张卡上
写 `2026/10/31 23:59`、面板写 `23:59`，**差了一整天**，而当时没有一个测试
失败。现在档位由一个模块选出（`expiryNotice`），两处都调用它，并且新增一条
测试**从源码层面**钉住这件事：两个界面都不得直接读 `expiry.within24h` /
`within3d` / `within7d` / `expired`，必须走共享阶梯。变异验证：让卡片私自读一个
桶，该用例立刻红并点名是哪个界面读的哪个桶。
**二、卡片的样式表缺一条守卫**。
面板侧有「面板渲染的每个 class 都得有规则」的守卫（`composer-styles.spec.tsx`），
卡片侧**没有**对应的——而卡片渲染的是同一批 `dsm-trae-expiry-*` class，规则却在
另一个常量 `TRAE_CARD_CSS` 里。实测：删掉卡片的 `dsm-trae-expiry-days` 规则，
全仓测试依然全绿。现补一条守卫覆盖卡片的四个语气 class 与两条共享规则。
### 测试
- 新增 **8** 例（1232 总例，较 4.6.9 净增 8）：
- 24 小时 / 3 天 / 7 天三档各自被选中，且报的是**自己那个桶**的金额与份数
（不是更宽的桶的数字）；
- 3 天档的「最早到期」报的是该档自己的时刻；
- 卡片与面板共用阶梯的**源码级**守卫；
- 卡片样式表覆盖四个语气 class 的守卫。
- **变异验证**（每一项都确认会转红）：
- 删掉 3 天档的分支 → 档位测试红；
- 让卡片私自读一个桶 → 一致性守卫红并点名；
- 删掉面板侧的 `dsm-trae-expiry-days` 规则 → 面板样式守卫红；
- 删掉卡片侧的同一条规则 → 新增的卡片样式守卫红。
- 全仓 **1232** 例通过（96 文件），双 tsconfig 类型检查通过。
## 4.6.9 (2026-10-30)
> **三家插件的积分读数现已统一在 `conversation.input.right`（模型选择器左边）。**
> 4.6.8 只迁了 trae 一家，另两家当时仍在左侧——现在 workbuddy 5.15.1 与
> qoder 1.16.2 已同步，**位置分叉的中间状态结束**。
### 文档
- **更正 4.6.8 里那句已过时的说明**：4.6.8 发布时写的是「本版只改 trae 一家……
另两家仍在左侧。这是已知且有意的中间状态；同步改动待单独发布」。现在同步
已完成，那句「分叉」不再成立。
- **为什么不直接改 4.6.8 的 CHANGELOG**：`CHANGELOG.md` 是随包文件，已发布的
tag 是不可变的历史锚点；改它会让 `verify:release` 对 v4.6.8 正确地报「tag
之后改动了发布内容」。更正随新版本发布，这是本仓库既有的做法。
### 同步结果
| 插件 | 版本 | 座位 |
| --- | --- | --- |
| `dsh-connect-trae` | 4.6.8 | `conversation.input.right` |
| `dsh-connect-workbuddy` | 5.15.1 | `conversation.input.right` |
| `@dmh2002/dsh-connect-qoder` | 1.16.2 | `conversation.input.right` |
- 三个发布包内的 `lib/client.js` 均已核对：`conversation.input.right` 出现，
`conversation.input.left` 零出现。
- 两个姊妹仓库各自补了一条**真正的座位断言**（此前都没有）：
workbuddy 补的是「`inject()` 的座位名与 `register({ name })` 必须相等」
（只改后者时原守卫全绿，而 `name` 才是注册表实际索引的字段）；
qoder 补的是「`input.right#…` 在册，且 `input.left#` 前缀不存在」
（此前该文件完全没有座位断言）。
### 测试
- 本版仅更正文档，**插件代码零改动**。
- 全仓 **1224** 例通过（96 文件），双 tsconfig 类型检查通过。
## 4.6.8 (2026-10-30)
> **积分读数从「权限切换器旁边」挪到「模型选择器左边」。** 两者原本相隔 8px 且都是
> 可点元素——想去点「完全权限」，结果点到读数、弹出积分浮层。读数不是操作按钮，
> 紧贴操作按钮只会制造误触。宿主的 `conversation.input.right` 正是渲染在模型选择器
> 之前的座位，迁过去即可，宿主无需改动。
### 变更
- **积分读数改挂 `conversation.input.right`**（#71 第二条建议）。
- **动机**：`conversation.input.left` 渲染在 `div.tools` 的**最末尾**，紧挨
`div.modes` 里的权限选择器，间距只有 8px。两个都是可点元素，误触后弹出的是
积分浮层——一个纯读数被当成了操作目标。
- **新位置**：宿主把 `conversation.input.right` 渲染在 `div.trailing` 的
`standardControls` 内、`conversation.input.model`（模型选择器）**之前**，
引用 `dsh-client-ui-conversation` 的 `InputBar` 结构：
`standardControls: [ renderSlot("conversation.input.right"), renderSlot("conversation.input.model") ]`。
迁过去后与权限选择器之间隔开整段空白。
- **宿主不需要改**：`conversation.input.right` 早已是 `kind: list` / `scope: session`
的现成座位。
- **老 profile 无需迁移**：`creditPosition` 的两个取值（`composer` / `stats`）、
设置名、`order: 4` 全部不变。`composer` 的含义是「带模型选择器的那一行」，
而 `input.right` 渲染的正是那一行——所以已保存的设置照旧生效。
- **「输入框下方」那一档不受影响**：`stats` 仍挂 `conversation.composer.dock`，
未改动。
- **文案不改（重要，且与 issue 的建议相反）**：设置里的 `row.creditPositionComposer`
值是「输入框工具栏」，hint 写的是「与模型选择同一行」——描述的是**整行**，
不是行内某个位置。迁移后读数仍在「与模型选择同一行」，文案依然准确。
这一条是核对原文后确认的，不是想当然。
### 说明：本版只改 trae 一家
`dsh-connect-workbuddy` 与 `dsh-connect-qoder` 目前仍注册在
`conversation.input.left`。三家同步是 issue #71 的第三条建议，但本版刻意只做
trae 一家，原因：
- 先在单仓验证视觉效果与挤占情况，回退成本最低（一家的包 vs 三家的包）；
- 那两个仓库当时工作树不干净（workbuddy 有未提交改动、qoder 有 `.tmp-restore/`），
在其上改位置会让问题归因变难。
**因此本版发布后，同一台机器上三个插件的读数位置是分叉的**——trae 在右侧，
另两家仍在左侧。这是已知且有意的中间状态；同步改动待单独发布。
### 测试
- `tests/client-activation.spec.tsx` 的座位名单断言与座位过滤条件同步改为
`conversation.input.right`。
- **变异验证**：把注册改回 `conversation.input.left`，该用例立刻转红
（完整名单 `toEqual` 不等），证明守卫真的锁住了座位。
- 全仓 **1224** 例通过（96 文件），双 tsconfig 类型检查通过。
- 实测：构建后宿主进程存活（无 `DEVELOPMENT.md` 记录的渲染进程崩溃），
`lib/client.js` 中只剩一处座位注册且指向 `conversation.input.right`。
## 4.6.7 (2026-10-30)
> **「最早到期：23:59」是明天晚上，不是今晚。** 输入框积分面板用一个只输出时分的
> 格式化函数渲染「未来某天」的到期时刻，于是 36 小时后的到期被显示成今晚——整整差一天，
> 而这句文案的全部价值就在「还剩多久」。同一个插件里，同一句文案在卡片中用另一套格式化，
> 渲染出的是带日期的正确结果。
### 修复
- **积分面板的「最早到期」补上日期**（#71，报告人
[@ManYue259](https://github.com/ManYue259)）。
- **现象**：国内版输入框积分面板显示
`有 164 积分将在 7 天内过期（1 个套餐）` / `最早到期：23:59`，读起来是「今晚 23:59」。
实际那一包是 **明天** 23:59 到期（取样时刻 2026-10-30 11:26 +08:00，
`earliestExpiresAtMs = 1793462399000` → `2026-10-31 23:59:59`，距取样 36.6 小时）。
- **根因**：`ComposerPoints.tsx` 用 `formatClock` 渲染到期时刻，而 `formatClock` 只为
**同一天内**的时刻而写（`composer.lastRefresh` 也在用它，那个用途是对的）。它被顺手
复用到「未来某天」的到期上，于是丢掉日期这一半。更糟的是它把 locale 硬编码成
`'zh-CN'`，英文界面下仍按中文习惯排。
- **修法**：该处改用 `display.ts` 早已导出、卡片就在用的 `formatDateTime`（跟随读者
locale，年月日时分）。`formatClock` 保留，但补上注释说明它只可用于同一天的即时时刻，
并写明被误用过一次、造成什么后果。
- **为什么这是缺陷而非取舍**：同一个 locale key `row.expiryEarliest` 在同一个插件里有
两套渲染粒度——卡片 `TraeAccountPanel.tsx` 走 `formatDateTime`（`最早到期：2026/10/31 23:59`），
面板走 `formatClock`（`最早到期：23:59`）。同一个 key 不该有两种含义。
- **不变的部分**：文案 key 与全部文案原样不动；「最近刷新」仍是纯时分（它永远是当天）；
卡片的渲染路径未改；`soonestExpiryOf` 的取值逻辑未改。
### 测试
- 新增 **2** 例 `tests/composer-points.spec.tsx`：
- **到期行必须带日期**：用 issue 给出的真实样本，断言渲染文本包含 `formatDateTime` 的结果
与一个四位年份，并且**不等于**旧代码产出的那个字符串。此前全仓对到期渲染**没有任何断言**
（该文件 24 例中零命中），格式化走偏无人挡。
- **同一行的「最近刷新」仍是纯时分**：防止修复越界，把 `lastRefresh` 也改成带日期而撑宽
窄面板的底部。
- **变异验证**：把该处改回 `formatClock`，新增用例立刻转红（1 failed / 25 passed）。
- 全仓 **1224** 例通过（96 文件，较 4.6.6 净增 2 例，已用 `git stash` 基线对拍确认），
双 tsconfig 类型检查通过，构建通过。
### 说明
- 本版**不含** issue #71 的另外两条位置建议（积分读数从 `conversation.input.left` 挪到
`conversation.input.right`、以及三姊妹插件同步），那是视觉/交互口径变更而非缺陷，
待单独决策后处理。
- issue 提到的 `within3d` 桶未参与 `soonestExpiryOf`／文案阶梯一事，经核对**结论正确**
（`within7d ⊇ within3d`，且 24h 桶为空时两桶取到同一个最小 `earliestExpiresAtMs`），
但「2 天后到期显示 7 天内」属产品口径，留待单独 issue。
## 4.6.6 (2026-10-30)
> **对齐宿主 DSH 0.2.1-rc.5（经停 rc.4）：纯版本推进，插件代码零改动。**
> 两版之间 13 个提交里约 240 个文件只是各包 `package.json` 的版本号行，有实质代码的
> 只有四处——而四处都不落在本插件消费的面上。插件消费的 13 个宿主包在
> rc.3→rc.5 之间**逐字节相同**。
### 变更
- **对齐宿主 DSH 0.2.1-rc.5**：13 个 `@deepseek-ai/dsh-*` devDependency 从 `0.2.1-rc.3`
推进到 `0.2.1-rc.5`。`cordis`（`4.0.5`）/ `schemastery`（`3.18.5`）/ `pi-ai`（仍 `1.1.0`）
均未变——宿主 `app.asar` 实测随包的 pi-ai 仍是 `1.1.0`，3.4.2 起的双向适配结论原样成立。
- **peer 范围无需改动**：`0.2.1-rc.4` / `0.2.1-rc.5` 对 `>=0.1.7-rc.1 <0.3.0-0` 已判通过。
### 已核对确认无变化
- 逐字节比对 npm 上 `0.2.1-rc.3` 与 `0.2.1-rc.5` 两版的全量文件树（`lib/**.js` 汇总哈希，
忽略 `package.json` 的版本号行）：插件消费的 13 个包——`dsh-llm`、`dsh-llm-pi-ai`、
`dsh-settings`、`dsh-host-webserver`、`dsh-atomic-write`、`dsh-home-paths`、`dsh-attachment`、
`dsh-client-ui-renderer`、`dsh-client-ui-settings`、`dsh-client-ui-settings-plugins`、
`dsh-client-ui-slots`、`dsh-client-locale`、`dsh-client-ui-primitives`——**全部逐字节相同**。
（rc.3 时唯一有代码变化的是 `dsh-client-ui-primitives`；本版它停住了。）
- 本插件注册的 5 个槽位（`plugins.bundle.config`、`plugins.row.config`、
`conversation.input.left`、`conversation.composer.dock`、`conversation.input.model.label`）
在 rc.5 中**仍然存在且契约未变**。
- 浏览器外壳的 `staticModules` 白名单（`dsh-web-frontend` 的 `index-*.js`）在 rc.3 与 rc.5
之间**文件哈希相同**；本插件 bundle 实际 `require` 的 `react` / `react-dom` /
`react/jsx-runtime` 全部在表内。
### rc.4 的两处行为变化为什么不击中本插件
- **`conversation.chat.reasoning.body` 新增 `rawText`，`text` 改为显示用文本**（会剥掉
`…` 前缀），上游专门发了升级指南。本插件全仓不注册、不消费任何
`conversation.chat.*` 槽位（`grep -rn "conversation.chat" src tests` 零命中），也不包装
reasoning 渲染。
- **把目录加载的诊断从 stdout 改到 stderr**（理由是「ACP 保留 stdout」）。本插件宿主侧
从不用 stdout：`grep` `console.log|info|debug` 与 `process.stdout` 在 `src` 与
`lib/index.js` 中均零命中，诊断走卡片自己的诊断面板（`raw-diagnostic.ts`）。这条修复
对本插件是**已满足的前提**，不是需要跟随的范式。
### 测试
- `tests/dsh-peer-range.spec.ts` 的 `MUST_ADMIT` 补入 `0.2.1-rc.4` / `0.2.1-rc.5`——
保持「当前正在使用的宿主版本必须在放行清单里」这条不变量。
- 双 tsconfig 类型检查通过，全仓 **1222** 例测试全绿（96 文件），`tsdown` 构建通过；
重建后 `lib/client.js` 的 `require` 仍只有 react / react-dom / react/jsx-runtime，
宿主进程存活（无渲染进程崩溃）。
### 文档
- 新增 `docs/DSH_0.2.1_RC1_SYNC.md` 第十一节：`0.2.1-rc.5` 复核记录（取证、上游改动、
契约面、槽位核对、外壳共享模块表、peer 门禁）。
- `README.md` / `README.en.md` 的宿主版本结论推进到 `0.2.1-rc.5`，并新增
「`0.2.1-rc.5` 同步结论」小节。
## 4.6.5 (2026-10-30)
> **一条没带上下文窗口的目录行，会让整个 `trae` 区域不可用。** 失效的不是
> 那条模型，而是**整条路由**——DSH 逐模型校验，且校验失败是 provider 级的。
> 插件早就写好了 `FALLBACK_CONTEXT_WINDOW` 作为「最后防线」，但它被赋给了一个
> 本插件**从不会走**的字段，于是从未生效过。这一版把回退落到模型行本身。
### 修复
- **一条没带上下文窗口的目录行不再拖垮整个区域**（#70，贡献者
[@beibing173](https://github.com/beibing173)）。
- **现象**：模型选择器里 `trae` 整个区域加载失败，报
`adapter returned invalid context metadata for provider "trae" model "doubao_1.8"`。
失败粒度是 **provider 级**，不是单模型级。
- **根因**：`FALLBACK_CONTEXT_WINDOW` 只被赋给 profile 的
`defaultContextWindow`，而那个字段由**内核自己的目录解析步骤**读取——本插件
从不走那条路径。它用 `createProvider({ models })` 手工装配 pi-ai provider，
`Models.getModel()` 直接返回 `toPiModel` 产出的原始行，**不做任何补默认值**；
而 `toPiModel` 在 `contextWindow === undefined` 时**省略**该字段。于是
`PiAiAdapter.modelInfo()` 解析出 `context: { contextWindow: undefined }`，
DSH 拒绝，且拒绝的是整条路由。常量写了，没有生效点。
- **修法**：把回退**落到行本身**。新增 `servedContextWindow()`，`toPiModel`
现在**总是**输出 `contextWindow`：行自己的正整数窗口原样保留，其余一切
（缺失、`NaN`、`0`、负数、小数）回退到 `FALLBACK_CONTEXT_WINDOW`——因为
DSH 只接受正整数。profile 上的 `defaultContextWindow` 保留（内核路径仍会读），
但注释改成与事实一致：真正的保证在 `toPiModel`，那只是保险带。
- **为什么小数也要回退**：目录解析器的 `finitePositive` 只校验 `isFinite` 与
`> 0`，所以上游若发布 `context_window_tokens.dev = 200000.5`，它会原样进到
适配器；DSH 对非整数的拒绝与缺失完全相同。这条此前没有任何用例锁住。
- **测试**：`tests/context-window-fallback.spec.ts` 走宿主的真实路径
（`adapter.current()` → `profiles` → `models.getModel()`，以及
`adapter.resolveModel()`），覆盖未定尺寸行、混合目录逐行可解析、行自带窗口
不被覆盖，以及小数/零/负数/NaN 四种畸形窗口一律回退。
**变异验证**：把 `toPiModel` 的改动回退，8 例中 7 例转红。
- **不变的部分**：不改变任何已有窗口的行；不改变名称、reasoning、图像能力、
计费倍率等元数据；兜底目录本身仍然每行手写真实窗口（`tests/catalog.spec.ts`
继续锁这个不变量）。本修复只是让「万一漏了一条」退化成一条保守尺寸的模型，
而不是死掉一个区域。
## 4.6.4 (2026-10-28)
> **缓存命中恒为 0% 不是插件丢了数字，是上游没有分配缓存池。** Trae 的
> `metadata` 事件里 `prompt_cache_pool_record` 非空才代表这次请求挂了前缀
> 缓存池；实测 CN/AI 双区、4 个账号、7 个模型、4 种 function，该字段
> **100% 为 `null`**。没有池，`cache_read_input_tokens` 只能是 0 —— 0% 是
> 正确读数。本版把这个事实变成可观测的，用户不必再怀疑插件吞了数据。
### 修复
- **上游的缓存池事实与管线名不再被丢弃**（#67）。
- **现象**：无论简单还是复杂提问，缓存命中恒为 0%，十个会话一致；
同时 tps 在 60–80 之间浮动。
- **根因**：不是插件。issue #10 的转发修复仍在（`lib/index.js` 含
`cached_tokens`，同版本下 `workbuddy`/`dsh-opencode-go` 命中显示正常），
是上游 `llm_utils_chat` 改由 `llm_raw_chat_v2` 管线、火山方舟 `ep-…`
端点承载后，不再为这些请求分配前缀缓存池。当初产出 5248/9216 的
`scripts/probe-cache-convention.mjs` 原样重跑，现在三轮全是 0。
- **修法**：`sse.ts` 新增 `diagnostic` 事件类型，解码 `metadata`
（`prompt_cache_pool_record`）与 `timing_cost`（`name` 管线名、
`provider_model_name`）；`solo-bridge.ts` 通过可选 `log` 上报
`promptCachePoolRecord` / `pipeline` / `providerModelName`；
`index.ts` 四个 `TraeSoloBridge` 构造点接入 `ctx.logger.warn`。
诊断事件不进答案文本、不改 usage 映射，**对外行为不变**。
- **为什么区分 `null` 与「字段不存在」**：`null` 是上游明确表示「没挂池」，
字段缺失只是没这条信息；两者混为一谈就又回到「看不出是谁的问题」。
### 修复（顺带守住一个回归）
- **`metadata` 不能被 peek 当成「上游已应答」**。它现在是被认识的事件类型，
若据此停止 peek，紧跟其后的拒绝（如 `1005` 未订阅）会退化成截断的 200 流
—— 正是 issue #19 的故障形态。`openTraeSource` 显式把 `diagnostic` 排除在
「已应答」之外。
### 测试
- `tests/sse.spec.ts`：`metadata` / `timing_cost` 解码为 `diagnostic`，
保留 `prompt_cache_pool_record: null`，且区分字段缺失。
- `tests/solo-bridge.spec.ts`：诊断事实上报（含 `null` 原样保留、事件不泄漏进
答案）；`metadata` 之后紧跟的 `1005` 仍转成 402 `hard_credit`。
### 说明
- 诊断细节与完整证据链见 `docs/ISSUE67_DIAGNOSIS.md`（不随 npm 包发布）。
- 上游若开始分配缓存池，`cached_tokens` 会自动恢复显示，插件侧无需再改。
## 4.6.3 (2026-10-27)
> **国际版美国区账号不会再被当成新加坡区。** 它的凭据明明写着
> `host = https://grow-normal.traeapi.us`、`userRegion = "US"`，插件却因为
> 「不认识 US」回落到 edition 标签（`sg → ai`），把 US token 发去 `*.trae.ai`
> ——那边只会回 401；刷新模型拿到的 401 又被路由包成 500。用户看到的是
> 「拉模型失败，请重新登录」，而重登拿到的还是同一份 US 凭据，于是无限循环。
### 修复
- **美国区成为显式区域，不再静默回退成新加坡区**（#66）。
- **现象**：`pay_status` 401；「刷新模型」500
`{"error":"SOLO remote models returned HTTP 401"}`；宿主日志
`live ai model directory unavailable; serving the configured catalog`。
- **根因**：`regionOfUserRegion` 只认 CN/SG、`regionOfHost` 只认
`.trae.ai`/`.trae.cn`，两级都落空后由 `regionOfEdition("sg")` 决定——
US 被判定为 `ai`。而 `REGION_GATEWAYS` 只有 cn/ai 两个键，于是「查不到」
变成了「拿另一个区的网关」。
- **修法**：新增 `TraeServiceRegion = 'cn' | 'ai' | 'us'`；`TraeRegion`
（存储/路由桶）仍是 `cn | ai`。`assertSupportedRegion()` 是唯一从区域
身份进到路由桶的入口，US 在**选择网关之前**抛
`TraeUnsupportedRegionError`。所有读网关的客户端（用量、SOLO wire、远程
目录、Raw Chat、IDE 名册）都走这一道，注入 `baseUrl` 的测试/诊断路径也
不例外。
- **为什么不是一行 `us → ai` 映射**：`ai` 的网关/目录/chat 契约都是按新加坡
实测出来的，而报告里的 US 实测恰好相反（远程目录 404、`llm_utils_chat`
403 `40006`、`create_agent_task` 的 config 绑定未知）。映射过去只是换一种
方式发错请求。**美国区本身仍未接入**，本版只保证它不再被误路由。
- **上游 401/403 不再被包成 500**（#66）。
- 新增 `src/failure.ts`：`TraeHttpError` 携带上游状态，`httpFailureOf()` 把
401/403 映射为原状态 + `code: authentication`，本地「区域不支持」映射为
501 + `code: unsupported-region`，真正没有状态可言的失败仍 500。状态、
额度、账号表、模型刷新、模型测速、签到与账号池签到/测速这些路由全部改用
它。
- 卡片改为显示**服务端原文**（账号刷新、模型刷新、状态读取），不再只打印
`HTTP 401`——「网关拒绝了你」和「插件坏了」从此可以分辨。
- **US 凭据不可选中、不计费，但会被点名**（#66）。
- `readAll()` 过滤掉本版本不服务的区域（作用域与无作用域 store 都过滤），
因此它不会被 refresh、不会进账号表、不会发出任何请求；
`unsupportedCredentials()` 单独把它读出来给卡片点名。
- 未登录态显示「美国区（US）暂不支持」并列出账号名，写明请求不会发往新加坡
网关、重新登录没有变化；诊断面板多一行「未支持的区域」。
- `resolve()` 在「只有 US 凭据」时抛明确错误，而不是笼统的
`no signed-in account found`；导入的区域门控同步把 `us` 当外区跳过。
### 测试
- `tests/issue66-us-region.spec.ts`（23 例）：US 的三条解析路径（claim / host /
完整凭据）都得到 `us` 而不是 `ai`；`payStatus` / 远程目录 / wire 名册 /
Raw Chat / chat 面对 US 凭据**零 `fetch` 调用**（含注入 `baseUrl` 的两例）；
作用域与无作用域 store 都不解析它、但都能点名；401/403/404/US/普通异常的
状态映射；模型刷新路由逐条断言 401、501、500；状态文档携带通告且不重复英文
异常文本。
- `tests/issue66-card-us-notice.spec.tsx`（2 例）：未登录文档带
`unsupportedRegion` 时卡片点名账号；失败请求显示服务端 `error` 原文而非
`HTTP 401`。
- **变异验证**：去掉 `regionOfUserRegion` 的 US 分支 → 2 例转红；刷新路由的
`failJson()` 改回 500 → 2 例转红；删掉 `readAll()` 的区域守卫 → 1 例转红。
- 全量 **95 files / 1211 tests** 通过（原 93 / 1186 + 新增 2 files / 25 例）。
### 说明
- **没有对 US 网关发过真机请求**：开发机没有美国区凭据。结论来自报告人给出的
实测对照（同一 token 打 US 200、打 SG 401）与代码路径；测试断言的是「不会
发出请求」，不是模拟 US 响应。
- 美国区的目录与 chat 仍待接入：目录需要 `get_detail_param` 的 `function`
单数 + `agent_type: null` 形态，chat 需要一次 IDE 侧的 `/api/agent/*`
实抓。拿到报文后即可按现有 `REGION_GATEWAYS` 的形状补齐。
- 诊断与取舍全文见仓库内 `docs/ISSUE66_DIAGNOSIS.md`（该文档不随包发布）。
## 4.6.2 (2026-10-27)
> **从插件市场装完，重启后插件不会再消失。** 安装其实失败了，但失败发生在
> 「已提升到 live」之后的一行——用户看到的是「装好了」，下一次启动才发现插件没了。
### 修复
- **`@earendil-works/pi-ai` 改标为可选 peer，安装不再被 generation 校验拦下**（#65）。
- **现象**：从 DSH 插件市场安装后，日志先报
`generation-install: promoted to dsh-connect-trae+4.6.1+…`，紧接着报
`generation-install: generation peer validation failed: @earendil-works/pi-ai
does not resolve from the generation or installation closure`。这次安装因此
`exit=1`、**不登记进持久化清单**（`.generations/desired.json`、
`desktop-workbenches/market-installs.json`）；DSH 下次启动按清单重建
`.generations/live`，未登记的 generation 被清掉（`logs/harness.log`:
`swept 3 unreferenced plugin generation(s)`）——表现为「装完没问题，重启后消失」，
重装必然复现。
- **根因不是 pi-ai 特殊，而是宿主核心包的判定方式是包名前缀。** 插件市场
（`dshmarket` 的 `corePackageNames()`）从 DSH 安装目录的 `node_modules` 反推核心包集合，
规则是 `/^(?:dsh|cordis)/` 匹配于 `@deepseek-ai/` 之下；命中者的 peer 允许从**宿主锚点**
解析，未命中者必须出现在插件自己的安装闭包里。`@earendil-works/pi-ai` 两个前缀都不匹配，
而 DSH 只在运行时注入它，闭包里从来没有——于是必然失败。
- **修法**：进 `peerDependenciesMeta` 标 `optional`（同作者的 `dsh-connect-workbuddy`
早就是这个写法，本仓库是漏了，不是设计如此）。**peer 范围保留不动**
（`>=0.85.1 <2.0.0`）：它编码的是适配器能吃哪几代 pi-ai（见 `src/pi-ai-runtime.ts`
与 issue #27），与「装不装」是两件事，删范围会丢掉代际判据。
- **为什么这次专门加测试**：修复是纯声明式的，构建期没有任何东西会察觉——`tsc` 只看到
字符串；`devDependencies` 里有实体 pi-ai，本地每次测试都能解析成功；CI 照常绿。
故障只在用户机器上、重启之后才出现。故新增 `tests/peer-optional.spec.ts`（6 例）
直接读随包 manifest 断言该标记，并把规则推广为「任何不在 `@deepseek-ai/{dsh,cordis}`
前缀下、却由宿主提供的 peer 都必须 optional」，避免下一个宿主依赖重开同一个洞。
- 贡献者：[@674830790](https://github.com/674830790)（issue #65，附完整日志与因果链）。
### 测试
- `tests/peer-optional.spec.ts` 6 例：pi-ai 必须 `optional: true`；非核心前缀的宿主提供 peer
一律 optional；`optional` 必须是字面量 `true`（`"yes"`/`1` 之类 npm 不认，改了看着像修好
其实没修）；`peerDependenciesMeta` 不得出现未声明的 peer；pi-ai 仍须被 `devDependencies`
钉住。**变异验证**：删掉 `peerDependenciesMeta` 后该文件 2 例转红，确认守卫不是恰好绿。
- 全量 **93 files / 1186 tests** 通过（原 1180 + 新增 6）。
### 说明
- 本次修复的判据来自插件市场的源码规则与同类插件的既有写法，**未在真机上复现那条
generation 校验**（开发机为 0.2.1-rc.3、报告人用 rc.2，该校验器的报错串不在本机应用包内）。
若 4.6.2 在报告人机器上仍复现，则说明该校验器不认 `optional` 标记而要求闭包里存在实体
文件，届时应改走「把 pi-ai 移出 peer 名单、改为运行时软探测」。
## 4.6.1 (2026-10-26)
> **4.6.0 说「图片字节插件拿不到」，这一版把这句话纠正过来。** 那条按
> `?prompt=&image_size=` 再打一次 GET 的路确实不是取图、而是**又一次生成**，但
> 「uri → 字节」不是没有通道，只是请求体形态特殊。现在图片会被取回来、落成会话文件、
> 直接显示在聊天里。
### 修复
- **文生图把图片真的取回来了**。
- **取图通道**：`POST /api/ide/v1/get_resource_url`，body 必须正是
`{"uri_list":[""]}`——`{uri}`/`{path}`/`{resource_uri}`/`{uris:[…]}`/
`{resources:[…]}`/`{scene:'report',uri}` 以及 GET `?uri=` 统统只回 200 + 空
`url_map`（不报错、也不给地址）。应答是
`{"url_map":{"":""}}`，再直接 GET 那个签名地址（**不带任何
Trae 头**，签名在 query 里）即得字节——实测 `image/jpeg`、1,155,578 字节、头
`ffd8ffe0`。对已有 key 这一步**零成本**，不会重新生成。
- **图片落成会话文件并直接显示**：`generate` 返回 `{url, credit?, bytes, mimeType}`，
`execute` 把字节写进 `/trae-images/trae-YYYYMMDD-HHMMSS-.`
（扩展名跟 mime 走），`output.schema` 恢复 `path` 并进 `required`，`render` 输出
``。DSH 的聊天按 session cwd 解析相对路径、再过宿主的
`api/file` 鉴权路由取字节，所以图真的显示出来，不需要用户去 Trae 客户端翻历史。
- **失败语义**：图已生成、积分已扣、但字节取不回来（`url_map` 里没有这个 key / CDN 非
2xx / 0 字节 / 落盘失败）→ `IMAGE_UNAVAILABLE`，进 30 秒冷却，文案明说「积分已经扣了」
并给出对象 key 供排障，要求模型**不要重试**。
- 改图与文生视频仍然**不做**，也不留半截入口。
- **图片现在落在会话目录，不再落到宿主进程的 cwd**。
- 用户在实际 web 会话里跑了一次：工具返回 `trae-images/trae-20261026-034146-1c0a91.jpg`，
聊天里却显示「图片无法预览」。文件确实生成了（789,453 字节真 JPEG），但落在**启动 DSH
的那个目录**里，而不是会话目录。
- 根因：宿主的 `ToolExecution` 不带会话目录。`cwd` 字段 4.15.x 仍标 `Reserved`（不填），
`agent.session.cwd` 这个字段不存在，`agent.session.header.cwd` 又只是**创建时**目录
（`/cd` 之后就不对）。插件此前只能回退到 `process.cwd()`。
- 现在照宿主自己的 `dsh-tool-*` 取法：`ctx.inject(['workingDirectory'])` 后调
`workingDirectory.ensure(exec.agent, exec.signal)`（它读 session projection
`workingDirectory`，即实时目录，并确认目录还在）。阶梯：宿主 service →
`agent.session.header.cwd` → `process.cwd()`。`TraeImageToolDeps` 新增可选
`directoryOf`，service 读取放在 `src/index.ts` 注入，`image-tool` 保持纯函数可单测。
- **取图那一跳的 HTTP 错误不再谎报成因**。
- 此前它复用生图那套状态码映射，取图接口回 403 会报 `AUTH`（「上游拒绝了凭据」）、回
429 会报 `RATE_LIMIT`——可这时图早已生成、积分早已扣掉，用户照这句话去重新登录，
钱花了图还是拿不到。
- 现在取图阶段（解析地址、下载字节）的 HTTP 失败一律归 `IMAGE_UNAVAILABLE`，文案保留
状态码与上游原文、附上对象 key。冷却判据只看 code，`IMAGE_UNAVAILABLE` 仍在冷却集合里，
不会因此变成可重试。
- **下载回来的东西必须是图片**。签名地址过期时 CDN 常拿 `200` 回一页 HTML，而
`content-type` 可能仍写着 `image/jpeg`。现在按字节魔数判定
（JPEG/PNG/GIF/WebP/BMP），认不出就如实报 `IMAGE_UNAVAILABLE`（带前 4 字节），
不再落一个打不开的 `.jpg`。
### 变更
- **删掉已证明是「又一次生成」的配套代码**：`src/image-gen-trae.ts` 里的
`traeImageFetchUrl()`、`computeTraeIdeSign()`、`traeImageSignFields()` 与
`TRAE_IMAGE_SIGN_SALT` 全部移除（连同它们的测试）。取图跟 prompt 没有任何关系，
留着只会诱导后人再打一次那条会再扣费的 GET。
### 测试
- `tests/image-tool-download.spec.ts` 5 例：stub fetch 断言**三跳**（POST 生图 →
POST `get_resource_url` → GET 签名地址），且**没有任何**带 `image_size=` 的请求；
`uri_list` 请求体；CDN 请求不带 `Authorization`、只带 `Accept: image/*`；
空 `url_map` → `IMAGE_UNAVAILABLE`；取图跳回 401/403/429/500/502 一律
`IMAGE_UNAVAILABLE`（断言文案含状态码与对象 key，且**不含**「拒绝了凭据」「限流」）；
取图跳回 `200` 但字节不是图片（HTML 错误页）→ `IMAGE_UNAVAILABLE`。
- `tests/image-gen-trae.spec.ts` 21 例：新增 `buildTraeResourceUrlBody`（只产出
`uri_list`、去空白、空 uri → `INVALID_ARGS`）、`parseTraeResourceUrlMap`（去空白、
坏形状回空表、丢弃非字符串/空串）、`signedTraeResourceUrl`（取到地址、缺 key 即
`IMAGE_UNAVAILABLE` 并带 key）三组纯函数单测。
- `tests/image-tool-render.spec.ts` 12 例：字节真落盘、文件名与后缀、markdown 用相对路径
且不含 key、credit 回显、写盘失败即 `IMAGE_UNAVAILABLE`、`IMAGE_UNAVAILABLE` 进冷却而
`INVALID_ARGS` 不进；以及会话目录阶梯三条——只有 `agent.session.header.cwd` 时写进它、
实时 `workingDirectory` 优先于创建时目录、`directoryOf` 注入（`index.ts` 接 projection
的方式）优先于两者。
- 全量 **92 files / 1180 tests** 通过（16 个 live 探针被 `TRAE_LIVE` 跳过且未提交，
跑一次烧一次积分）；CI 在 `ubuntu-latest` 与 `windows-latest` 双平台通过。
- 真机（零成本，复用既有 key）：签名 → 1,155,578 字节 JPEG → 落盘同样字节 →
render 输出 markdown 图片，整条链路跑通。除 POST 之外整条链路都在真账号上验过。
### 文档
- `README.md` / `README.en.md` 的「文生图」条目与协议表改成「两步取图 + 落盘 + 相对
路径显示」，并保留「那条 GET 是又一次生成」的实测记录作为反面证据。
## 4.6.0 (2026-10-26)
> **文生图先只在国内版面世，并且必须由用户亲手勾选。** 企业版的租户网关是另一条
> 计费面，国际版按另一套套餐计费，两者的生图行为都没有测过——所有取证都在
> `trae-api-cn.mchost.guru` 上做的。
### 新增
- **文生图接进会话：`trae_draw_image`**（`feat(tools)`）。
- 用登录账号画一张图，返回 Trae 的**图片对象 key**（形如 `tos-cn-i-…/cn//gen_image/…`，
图在 Trae 客户端的历史里能看到；字节插件拿不到，见下）。默认关闭、**按面板单独开**：
卡片模型栏勾上「允许模型自主生图」（`drawImageEnabled`）该面板才注册这个工具，
取消勾选立即撤下。
- **协议是实测出来的，不是从二进制里猜的**：`POST /api/ide/v1/tool_text_to_image`
（另有 SSE 变体），请求体**只认** `{prompt, image_size?}`——多带 `mode_type`/`session_id`/
`image_urls` 之类的已知字段直接 400 空 body，未知字段反被忽略；成功响应是**扁平**的
`{"message":"success","uri":"tos-cn-i-…"}`，没有 `{code,msg,data}` 信封。模型 `seedream_5`。
- **尺寸边界**：总像素必须落在 **3686400 ~ 16777216**（`1024x1024` 报
`image size must be at least 3686400 pixels`、`4608x4608` 报 at most，两者都**不扣费**）；
预设 `2k`/`3k`/`4k` 可用，缺省 `1920x1920`。
- **计费口径写进工具文案**：实测 `1920x1920` 一张约 **8.8 积分**（国内版价），上游不回传
扣费数字。失败后加 **30 秒冷却**（按张计费，不过冷却的重试等于再买一张）。
- **不取图，只回 key**：同路径的 GET 不是取图，**是又一次生成**。决定性探针（CN 个人版）：
POST 拿到 `…/1792954795741_44f94116_jpeg_1920x1920` 之后，用同一 `(prompt, size)` 带
全套网关头 + `x-ide-sign` 打 GET，回来的是**另一个** uri
（`…/1792954810505_b107ac11_jpeg_1920x1920`），耗时 27 秒、**一个像素都没有**——等于又画
一张、又扣一次（两次共约 17.6）。非法尺寸探针（`100x100`）同样印证：报错直接来自 Ark 的
`[callArkImageGeneration]`。所以发版代码**不再发这条 GET**：`generate` 只发一次 POST，
返回 `{url, credit?}`，渲染层把 key 显示成**行内代码**并注明「不能直接打开」，绝不拼进
``（key 不是路径，拼进去只会得到以当前目录为基准的碎图标）。要真正把 uri 变成
字节，需要另一条通道（iCube material 的 `get_url` + `x-icube-token`，基址来自运行时
boot config），目前**没有打通**，代码里也不留假装能取的入口。
两例 `tests/image-tool-render.spec.ts` 与两例 `tests/image-tool-download.spec.ts`
（现已改名口径）用 stub fetch 断言**每次生成只发一次请求**。
- **只有国内版面板提供**（`DRAW_IMAGE_PANELS = ['cn']`，见 `src/status-paths.ts`）。
企业版走租户网关、国际版按另一套套餐计费，两者的生图行为都**没有测过**：企业版原先
就因为这一点被拒绝，国际版没有理由凭「面板是消费者版」放行——而且工具文案里的
8.8 积分是国内价，放到国际版就是错的。两处的勾选框都**置灰并写明原因**（不隐藏：
隐藏会让人以为插件漏了这个功能），理由与「加进白名单必须先补实测证据」写在同一处注释里。
- **注册开关是一个可测的纯函数**：`drawImagePanelsOf()` 三道门——面板在白名单内、
该面板的 provider 开着（opt-out 语义，旧配置仍算开）、用户显式勾选（**只认字面量
`true`**，`'yes'`、`1` 之类的手改值不算同意）。企业版即使被勾上也**结构性**拒绝，
不靠白名单列表的书写顺序。首版把这条规则写在 `apply()` 的闭包里，只能靠读代码确认，
现在由 `tests/image-tool-optin.spec.ts` 的 12 例钉住（缺省/非法形状/非布尔真值/关掉的
provider/企业版/国际版/多面板顺序/整段 section 与裸 `regions` map 同答）。
- **开关就在卡片里，不是一个只有 schema 的字段**：真值是 `regions..drawImageEnabled`
（Host 的工具解析按面板读它，所以写的是 `regions` 而不是顶层设置键）。勾选即写、不经过
「保存」，写后**回读文档**核对——一个谎报授权的勾选框会让「工具没出现」看起来像 bug。
4 例卡片测试 `tests/card-draw-image-switch.spec.tsx` 断言写入字段是 `regions`、该槽位的
模型目录/图片模型/上下文预算/账号池一个都不能丢。
- **范围**：改图（需先走 TOS 上传预签名）与文生视频（异步素材轮询）**不做**，也不留半截入口。
### 文档
- `README.md` / `README.en.md` 新增「文生图」一节与功能列表条目：开关语义（含只有国内版
提供）、实测协议表、计费，以及为什么那条「取图」GET **是又一次生成**、插件只回 key。
## 4.5.2 (2026-10-25)
> **思考档位不再被吞，也不再被谎报。** 插件原先只认识三档，未知档位一律按 `high`
> 发出去——用户选 Max、实际收到 high，无报错也无日志。这一版把词表与 Trae 客户端
> 对齐（`low / medium / high / extra_high / max`），并把「不认识的档位」从谎报改成
> 丢弃，让上游用它自己的默认值。
>
> 词表变宽，**声称没变**：能选哪些档位仍然只取决于上游为该模型实际下发的
> `options`，所以今天只发三档的模型不会凭空多出 Max。
### 修复
- **思考档位词表配平，未知档位不再静默降档成 high**（#60）。
- **三处吞档位**：解析侧 `EFFORT_MAP` / `TRAE_REASONING_EFFORTS` 缺 `medium` 与
`max`；`toPiModel` 的 `thinkingLevelMap` 把 `minimal / medium / max` 硬编码成
`null`；反向映射写成三元链
`effort === 'low' ? 'light' : effort === 'xhigh' ? 'extra_high' : 'high'`。
- **最坏的是第三处**：任何未预期档位都被映射成 `high` 发给上游。Trae 客户端自己
认识五档（`reasoning_effort.{low,medium,high,extra_high,max}`），并按 agent model
灰度下发，所以上游哪天发 `max`，用户选 Max 就会被静默降成 high。**静默降档比
不给选择器更坏**——它给出一个便宜了、但用户没要的答案。
- **改法**：反向映射抽成 `WIRE_EFFORT_MAP` 查表 + `wireEffortsOf()`，三处调用点
统一走它（报告人点到两处，第三处在 wire 行提升的分支里，一起改才不会有同一份
目录两种行为）。查不到即**丢弃**，而不是猜一个默认值。
- **实测**（2026-10-25，本机 CN 凭据，98 行目录）：当前 `options` 只有
`["light","high"]`、`["high","extra_high"]`、`["light","high","extra_high"]`
三种，`max` 尚未下发——所以这是「今天就备好、明天才用上」，不是伪造档位。
- 测试：新增 10 例（词表、丢弃未知档位、既有三档逐字不变、`discoveredCatalog`
同步、不伪造档位、`thinkingLevelMap` 按模型而非硬编码）。三处均做变异验证：
恢复旧映射 → 5 例红；恢复硬编码 `null` → 1 例红；去掉解析侧新键 → 1 例红。
- 贡献者：[@ahian-lee](https://github.com/ahian-lee)（issue #60，附诊断与补丁）。
### 文档
- **卡片模型栏写明「上下文预算只影响 DSH 侧」**（#60 的顺带问题）。
- 每行显示的是 Trae 自己公布的最大窗口，而下面的预算单选只写 DSH 的本地预算；
请求体里既没有窗口字段、也没有 `max_mode`，所以把预算提到 1M 并不会让上游按
1M 服务。原先的标签读起来像「已经放开到 1M」。
- 上游是否接受 `v2_max_mode_enabled` 这类字段**尚未取证**，所以这次不动请求体
（乱加字段可能让每次请求 400），只把事实说出来：常驻说明，不用悬停提示。
## 4.5.1 (2026-10-25)
> **只在租户池上架的模型不再隐形。** 插件的模型目录只问了 `solo.trae.cn` 一处，
> 而它并不发布租户池的完整名单——`DeepSeek-V4.1-Flash-1017` 就在其中。这一版把
> `console.enterprise.trae.cn` 的目录**并入**主目录，两个池的模型都保留。
>
> 成因不是合并层丢行，而是**读错了 host**：目录基址循环在第一个答非空的 host 就
> `return`，而主目录总会答——所以只在租户池上架的模型，即便拿着租户凭据也永远看不到
> （#46）。
### 修复
- **模型目录并入租户池，只在租户侧上架的模型不再隐形**（#46）。
- **实测**（2026-10-24，真实 CN 租户凭据）：`solo.trae.cn` 答 36 个 id、**没有**
`DeepSeek-V4.1-Flash-1017`；`console.enterprise.trae.cn` 答 24 个、**有**。
4.4.7 与 4.5.0 表现一致，所以升级修不了。
- **并集而非替换**：两侧没有一方包含另一方——主目录的 36 个里有 **19** 个不在租户
应答中，其中就包括 `deepseek-v4.1-flash`。换 host 等于用 1 个模型换掉 19 个。
- **也不能做成兜底候选**：基址循环在第一个答非空的 host 就返回，而主目录总会答，
候选恰好在唯一会出错的情形下被跳过。因此额外 host 单独读取后再并入
（`TraeSoloRemoteCatalogOptions.unionBaseUrls`）。
- **冲突保留主目录的拼写**，按不区分大小写比较。这里不能用 `preferStrongerRow`
打擂台：`deriveCatalog` 用 `enabled.has(model.id)` **精确匹配**，改名会让用户
已存进 `enabledModelIds` 的那一项静默失配、模型从选择里消失。
- **逐 host 尽力而为**：传输失败、非 2xx、响应体读不出、应答为空，都记日志后跳过，
只有调用方 abort 才向上抛。某个额外 host 坏掉，损失的是它的模型，而不是整份目录。
- **门控按凭据、不按面板**：只登录租户账号的机器，在 Trae（消费端）面板下
`store.resolve()` 依然会返回租户凭据（`offered()` 是「藏光了就回退」），所以按
面板判会漏掉这类用户。现在判「解析出的凭据 `tenantId` 非空」，个人凭据在发出请求
前就跳过。
- **`unionRegion` 挡住跨区域请求**：`DSH_TRAE_TENANT_IN_CONSUMER` 是环境变量、不分
区域，原先国际版面板也会挂上 CN 租户 host（用 SG 凭据实测确实发出、拿 401 后被
跳过）。现在区域不符即跳过。
- **额外 host 有负缓存**：`discoverModels()` 不传 signal、超时回落到 30 秒，原先企业
host 不可达时每次刷新都要多等。失败后与主 host 同款冷却 5 分钟。
- **它不是别名**：用插件自己的 bridge 驱动真实网关，两个 id 派往不同后端
（`DeepSeek-V4.1-Flash-1017` → `deepseek-v4.1-flash-economic-ark`，
`DeepSeek-V4.1-Flash` → `deepseek-v4.1-flash-ark`）。
- 测试：`tests/solo-remote.spec.ts` 新增 8 例，覆盖并集、仅大小写不同的冲突、
额外 host 不可达/被拒/应答为空、个人凭据跳过、跨区域跳过、冷却、已经是主 host 时
不重复请求，以及未配置 `unionBaseUrls` 时行为与改动前完全一致。
- 贡献者：[@yuantao313](https://github.com/yuantao313)（PR #59）。
## 4.5.0 (2026-10-24)
> **宽窗模型多一个 500K 上下文中间档。** Trae 每个模型公布两个窗口——默认（dev）档和
> Max 档——从 200K 直接跳到 1M 是 5 倍，而 1M 的计费并不是每个会话都用得上。这一版在两者
> 之间加了一个本地的半步。
>
> 500K **不是上游公布的窗口**，所以它有门槛、也有校验：只有当模型的 Max 真的够宽、500K
> 又确实落在它的两个窗口之间时才出现；落盘校验用同一条规则，旧值撑不破模型的真实窗口。
### 新增
- **宽窗模型多一个 500K 上下文中间档（国内版 / 国际版都有）**。
- Trae 每个模型公布两个窗口：默认（dev，实测 200K / 256K / 272K 三种）与 Max
（实测 1M，MiMo 为 981504）。从默认直接跳到 Max 是 5 倍，而 1M 的计费并不是每个
会话都用得上——所以加一个 500K 的半步。
- **500K 不是上游公布的窗口**，是本地的选择，因此有门槛：只有当该模型的
`maxContextWindow >= 500000`、且 500K 严格宽于它的 dev 窗、又严格窄于它的 Max
时才出现（`contextBudgetOptions`）。dev 本身已是 500K、或 Max 正好 500K 时不会
出现重复选项。
- **落盘校验用的是同一条规则**：`applyContextBudgets` 只接受该模型可选窗口里的值，
所以旧配置里留下的 500K 在某模型 Max 被上游调小之后会安静失效、退回 dev 档，
而不是把模型撑到它没有的窗口。
- 卡片每行因此可能是 1 / 2 / 3 个单选（无 Max 的行仍是一个只读选项）；新增整区按钮
「整区切到 500K」，只作用于 Max ≥ 500K 的行，写入值与逐行单选完全一致。
- 测试：`tests/context-budget.spec.ts`（9 例，含「Max 不足 500K 不出现」「Max 正好
500K 不重复」「Max 调小后旧 500K 失效」）与 `tests/card-context-500k.spec.tsx`
（3 例，含「只给合格行第三个单选」「整区按钮只写合格行」「逐行与整区落盘一致」）。
两组均做过变异验证：去掉 500K 档 → 5 例红；放宽接受规则 → 3 例红。
### 修复
- **发布核验不再重建工作树，宿主不再被核验动作掀翻**（`fix(scripts)`）。
- **事故**（2026-10-24 14:40:08 / 14:41:01 / 14:42:16）：桌面版渲染进程连崩三次
（`EXC_BREAKPOINT`/`SIGTRAP`），应用白屏，最后要人工重启。取证在
`~/Library/Logs/DiagnosticReports/DeepSeek Harness Helper (Renderer)-*.ips`。
- **成因**：开发者常态是把 bundle 以**软链**装进 profile
（`node_modules/dsh-connect-trae -> <本仓库>`），于是运行中的 DSH 宿主服务的正是本仓库
`lib/` 的字节；而 `scripts/verify-release.mjs` 的第 4 步（确定性重建比对）原本
**在工作树里**跑 `npm run build`——等于当着活着的宿主改写它正在服务的客户端 bundle，
宿主重新 import，渲染进程崩。
- **修法**：重建改到**临时 worktree**（`git worktree add --detach ` + 软链
`node_modules`）里做，工作树的 `lib/` 一个字节都不动；`git worktree remove` 在收尾时
清理。用 worktree 而不是 `git archive | tar -x`，是因为测试机上的 PATH 上有**假的
`tar`**（发布测试用它冒充 registry），走 tar 会解出错的树。
- **守卫**：`tests/verify-release.spec.ts` 新增一例「工作树不被重建」。变异验证：把重建
改回 `cwd: repo` → 该例立刻变红（fixture 的 build 会真的写 `lib/`）。
- **构建前会提醒「这次会改写正在被宿主服务的字节」**（`chore(scripts)`）。
新增 `scripts/warn-live-host.mjs`，接到 `prebuild` 钩子：检查「有没有 profile 软链到本仓库」
且「有没有活着的宿主进程」，两者同时成立就打印警告。**它从不失败构建**——热更新的正当
流程必须还能走；崩了重启应用即可。
### 文档
- `DEVELOPMENT.md` 新增首节「危险动作：不要在宿主运行时重建 `lib/`」：讲清软链装法、
事故时间线与三种场景下该怎么做（不开了随便构建 / 只验证发布用 `verify:release` /
要热更新就接受代价 / 发版前先关宿主）。
- `RELEASING.md` 第 8 步补一句：第 4 步的重建在临时 worktree 里做，理由与对策指向上面那节。
- **在核心位置写明「不做插件之间的联动」这条边界**。
- `README.md` 开头加一条醒目的边界声明，并新增 `## 与其它插件的关系` 一节（英文版同步）：
不共享状态、不做跨插件的账号/额度调度、不协商槽位、不共享开关，以及立这条边的理由。
- `src/index.ts` 的**模块头**加 SCOPE BOUNDARY 注释：本模块只与 DSH Host 和 Trae 上游
两方对话，不读写任何其它插件的文件或状态。
- 补一条区分：同一族插件之间**互相学习**（workbuddy 的教训被写进本仓库的注释与测试），
但**不互相调用**——学习是编译期的事，联动是运行时的事。
## 4.4.7 (2026-10-24)
> **4.4.6 把「读不出来的账号副本」改名留住了，但这件事一直是静默的——现在卡片会把它点名，
> 包括未登录那一屏。被顶掉的账号「去哪了」，从此不必再去 `~/.dsh` 里翻文件名。**
>
> 这一版不改任何账号、刷新、镜像的行为：读不懂的文件依然被隔离、依然不被覆盖。
> 改的是**看得见**：隔离发生的证据本来就在磁盘上，只是没人告诉用户它在那儿。
### 新增
- **隔离过的账号副本会被点名**（`feat(card)`）。
- 宿主侧新增 `TraeCredentialStore.quarantinedCopies()`：**扫描**副本文件旁边的
`.corrupt-*` 兄弟文件——不另设一本账，**证据本身就是证据**，用户删掉留存文件，提示也就跟着
消失，没有第二处状态要清理。报告内容是它原来的路径、现在的路径、字节数，以及
**能读成 JSON 时的账号数**（读不成就不猜：一个猜错的账号数比没有更糟）。
- 状态文档新增 `quarantined` 字段，**signed-in 与 signed-out 两种形状都带**。
- 卡片「诊断」栏新增一行「损坏副本留存」，点名那份留存文件。
- **未登录那一屏也显示同一条通知**：账号消失之后用户落地的正是那一屏，而那一屏根本不渲染分栏，
诊断栏根本看不到——只把通知放进诊断栏，等于没做。
- 一台健康的机器上什么都不显示：没有通知，也没有空盒子。
### 测试
- 新增 **9** 例：`tests/auth.spec.ts`（2 条——报告隔离文件、用户删掉后通知随之消失）、
`tests/web-status.spec.ts`（2 条——signed-out 与 signed-in 文档都带上通知）、
`tests/card-quarantine.spec.tsx`（5 条——诊断栏点名、未登录屏可见、账号数可读/不可读、健机器保持沉默）。
- 全仓 **1093** 例 / 85 个测试文件通过，双 tsconfig 类型检查通过。
### 文档
- `README.md` / `README.en.md` 的诊断栏说明补上这一行新事实，以及「未登录那一屏也会显示」。
> **给 #56 报告人的补充**：4.4.6 的隔离是静默的，所以「出现过隔离文件」这件事过去只能靠翻目录发现。
> 4.4.7 之后，卡片会直接把那份文件指给你——如果你的 `~/.dsh` 下已经有 `.corrupt-*` 文件，
> 升级后打开设置页就能看到它曾经存在，不必再自己找。
## 4.4.6 (2026-10-24)
> **对齐宿主 DSH 0.2.1-rc.3（纯版本推进，插件代码零改动），并修掉账号链路上三处
> 会静默丢数据的问题——其中一处可能正是 #56「被顶掉的账号若干时间后消失」的成因。**
>
> 宿主这一版只落地 5 个提交：三个是「导航项自定义」（面板固定/取消固定、More 菜单、埋点），
> 一个是 DeepSeek API-key 通道改走官方 `/models` 目录，一个是版本号——**均与本插件不相干**。
> 插件消费的 13 个宿主包里只有 `dsh-client-ui-primitives` 有代码变化，且全是新增，
> 而本插件对它只有类型层引用，因此**不需要任何适配**。
>
> 真正的风险在插件自己身上：一份读不懂的副本文件会被当成「一个账号都没有」，
> 而三条合并写路径又以它为基底——一次损坏读 + 一次刷新 = 其余账号的副本被无声抹掉。
### 修复
- **副本文件损坏不再清掉全部账号**（`fix(auth)`，PR #58）。
`parseOwn` 此前对「无法解析的文件」（半截写入、手改损坏、未知版本）一律返回空数组，而镜像 /
刷新 / 导入三条合并写路径都以它的结果为合并基底——一次损坏读 + 下一次刷新 = **其余全部账号的
副本被无声抹掉**，账号行随下一个轮询消失，且因为异常全被吞掉，日志里什么都看不到。
- `parseOwn` 改为三态（合法 / 合法空 / **无法解析返回 `undefined`**），新增 `readOwnForMerge`
收口三条写路径：遇到无法解析的文件先隔离为 `.corrupt-<时间戳>`（字节保留、可找回），
再从干净文件开始；**隔离失败则放弃本次写入，绝不覆盖读不懂的字节**。
- `deleteAccount` 对不可解析文件**拒绝**而非当空。
- 这可能是 #56（被顶掉的账号若干时间后消失）的一种成因——值得让报告者检查
`$DSH_HOME/.trae-auth.cn.json` 及其同目录的 `.corrupt-*` 隔离文件。
- **墓碑读-改-写收进一把锁**（`fix(auth)`，PR #58）。墓碑文件被两个并发流读改写：镜像
（清失效墓碑）与删除（加墓碑），此前都是锁外读、锁内写，丢更新的两个方向都疼——丢一个墓碑＝
已删账号在下一轮镜像复活；丢一次清理＝墓碑永久残留，该账号之后永远无法再被镜像。
收口为锁内 `updateTombstones(mutator)`。
- **池测量的删除不再丢并发写入**（`fix(pool)`，PR #58）。`dropTraePoolProbe` 的读取挪进锁内
（对齐同文件 `writeTraePoolProbes` 的范式）：此前锁外读的快照会把并发批次刚写入的测量覆盖掉。
### 变更
- **对齐宿主 DSH 0.2.1-rc.3**：13 个 `@deepseek-ai/dsh-*` devDependency 从 `0.2.1-rc.2`
推进到 `0.2.1-rc.3`。`cordis`（`4.0.5`）/ `schemastery`（`3.18.5`）/ `pi-ai`（仍 `1.1.0`）
均未变——宿主 `app.asar` 实测随包的 pi-ai 仍是 1.1.0，3.4.2 起的双向适配结论原样成立。
- **peer 范围无需改动**：`0.2.1-rc.3` 对 `>=0.1.7-rc.1 <0.3.0-0` 已判通过（实测）。
- **插件代码零改动**：rc.3 对本插件消费的 13 个宿主包里，只有 `dsh-client-ui-primitives`
存在代码变化，且全部是**新增**（`TooltipSide` 增加 `'left'` 并改用实测边框盒换边放置、
`MenuItemButton` 增加 `current`、`Menu` 增加 `minWidthFromAnchor`、新增 `IconAppsAddOutline*`）。
本插件对 `dsh-client-ui-primitives` 只有**类型层引用**（`import type {} from ...`），
运行时不消费这些组件，故无需适配。
### 已核对确认无变化
- 逐字节比对 npm 上 `0.2.1-rc.2` 与 `0.2.1-rc.3` 两版的全量文件树：
`dsh-llm`、`dsh-llm-pi-ai`、`dsh-settings`、`dsh-host-webserver`、`dsh-atomic-write`、
`dsh-home-paths`、`dsh-attachment`、`dsh-client-ui-renderer`、`dsh-client-ui-settings`、
`dsh-client-ui-settings-plugins`、`dsh-client-ui-slots`、`dsh-client-locale`
——**除 package.json 的版本号与内部依赖号外逐字节相同**。
- 本插件注册的 5 个槽位（`plugins.bundle.config`、`plugins.row.config`、`conversation.input.left`、
`conversation.composer.dock`、`conversation.input.model.label`）在 rc.3 中**仍然存在且契约未变**；
宿主新增的 `conversation.session.header.views.actions` 等槽位与本插件无交集。
- rc.3 宿主上实测：宿主侧 Config 条目 `include:dsh-connect-trae` 在册，客户端
`plugins.bundle.config` / `plugins.row.config` / `conversation.input.left` 三处注册均 active。
### 测试
- PR #58 新增回归用例：损坏副本文件被隔离且字节保留、合法文件中坏一行只丢该行、
隔离失败时放弃写入且原字节不动、墓碑并发删除/写入序列化冒烟、池测量的 drop 与 write 不互相覆盖。
- `tests/dsh-peer-range.spec.ts` 的 `MUST_ADMIT` 补入 `0.2.1-rc.3`——此前这份「必须放行的版本」
清单里没有当前正在使用的版本，范围若被误收窄到当前宿主之外，测试仍会全绿。
- 全仓 **1084** 例通过（84 个测试文件），双 tsconfig 类型检查通过。
### 文档
- 新增 `docs/DSH_0.2.1_RC1_SYNC.md` 第十节：`0.2.1-rc.3` 复核记录（取证、依赖面、契约面、
槽位核对、peer 门禁）。
- `README.md` / `README.en.md` 的宿主版本结论推进到 `0.2.1-rc.3`，并新增
「`0.2.1-rc.3` 同步结论」小节。
## 4.4.5 (2026-10-23)
> **模型列表不再倒出官方已下架的历史配置：按 Trae IDE 名册退役 12 行、改钉 6 行，
> 剩下的按通道分组、固定顺序、默认只看常用通道。**
>
> 合并自 PR #55，修 issue #52。报告人问「为啥 trae 的模型数量这么爆炸」并提醒「拿 code 的
> 模型请求 solo 的潜在风险」——查下来是同一个洞：插件列的是 12 个目录 function 的**并集**
> （46 行），而 Trae 客户端**一次只渲染一个 function**（14–24 行）。本版接入第三条上游信号
> （IDE 名册的 `is_invisible_to_user`），把「官方还展不展示」这个问题交回上游自己回答，
> 目录 **46 → 34 行**（本机 CN 账号实测），一行都没删错、一次都没猜。
### 修复
- **模型列表不再把官方已下架的历史配置倒出来，并把钉错通道的行改回官方通道**（`fix(catalog)`，issue #52）。
报告人问「为啥 trae 的模型数量这么爆炸」，同时提醒「拿 code 的模型请求 solo」。查下来是**同一个洞**：
插件列的是 12 个目录 function 的**并集**（46 行），而 Trae 客户端**一次只渲染一个 function**（14–24 行）；
#46 为了让带日期的快照可见，给「能调但骨架没收录」的行开了提升通道，而这条通道**没有上限** ——
`isPromotableWireModel` 只问「能不能调、有没有真名字」，不问「官方还展不展示」。
- **接入了第三条上游信号**：`batch_get_detail_param`（IDE 选择器渲染的那份名册）里的
`is_invisible_to_user`。端点与请求体本来就为 #46 备好了（`src/model-detail.ts`），缺的只是一个
client 与解析器 —— 现在在 `src/official-roster.ts`。
- **它是逐 (config, function) 的「模式名册」，不是生命周期标记**。实测 2026-10-23：
`DeepSeek-V4-Pro` 在 `solo_work_remote` 下被隐藏（那个模式展示的是 `-Official` 那份），
但在 `chat_v3` / `solo_coder` 下是可见的；`glm-5` 在 `solo_work_remote` / `solo_agent_remote`
隐藏、在 `solo_work_lite` / `solo_coder` 可见。把它读成「模型下架了」会**误删 6 个在用模型**，
所以判定分三种：
- **退役**：所有 `llm_utils_chat` 接受的 function 都隐藏它（`glm-4.7` 只在
`code_review_summary` 可见 —— 那是代码评审的助手配置，不是对话通道）。这类共 **12 行**，
正是截图里「尾部整屏的老模型」。
- **改钉**：自己的通道隐藏、但别的对话通道展示。改用官方自己那个通道，而不是我们先前猜的
并集首个 —— 这正好回答「拿 code 的模型请求 solo」：`Doubao-Seed-2.0-Code` / `glm-5.1` /
`qwen-3.5` 落到 `solo_coder`，`glm-5` / `DeepSeek-V4-Flash` / `DeepSeek-V4-Pro` 落到
`solo_work_lite`（按 `TRAE_DIRECTORY_FUNCTIONS` 的优先级选，不按文档顺序，所以两次刷新结果一致）。
共 **6 行**。
- **保留**：名册没提到这个 config（实测 `kimi-k2.8-preview`、`qwen3.8-flash` 只存在于 Remote
目录的 `chat_v3` 分组）、只把它当工具配置、或压根没有对话通道能判 —— **沉默不是判决**。
- **默认开启而且是 fail-open 的**，这是敢不设开关的理由：名册读不到（受限网络、没有 `X-Ide-Token`
的设备身份、超时、HTTP 非 2xx、文档为空）就返回 `undefined`，一行都不动。它只是给一次**已经成功**
的刷新做减噪，永远不会把刷新搞失败。名册成功读一次缓存 10 分钟，失败也缓存同样时长，
避免每次刷新都赔一个超时。
- **`config_switch` 只记录不判决**：这个字段的语义没实测过，拿它删模型风险太大。
- **实测**（本机 CN 账号，只读探针，零额度）：名册 105 configs / 544 pairs，耗时 343 ms；
`46 → 34`（退役 12、改钉 6），通道分布 `solo_work_remote=20 solo_coder=7 solo_work_lite=3
chat_v3=2 solo_agent_remote=1 默认=1`。
- **测试**：`tests/official-roster.spec.ts`（23 条）覆盖解析器容错、三种判决、按通道优先级选目标、
`wireConfigName` 而非显示 id 取值、大小写不敏感、工具配置不算模型、fail-open、缓存窗口，
以及一条走真实 `mergeTraeModelSources` 的端到端；全量 `1042 条 / 82 文件` 通过。
- **模型区按通道分组、可搜索、顺序固定**（`feat(client)`，issue #52 P0）。
上一段修的是「多出来的行」，这一段修的是「剩下的行怎么摆」。报告里那半句「一屏平铺、顺序乱」
有两个独立的成因：
- **顺序原本不是排出来的，是到达顺序**。旧卡片直接渲染合并结果的顺序，而 `src/solo-remote.ts`
自己写着分组顺序**每次调用都可能不同** —— 同一个账号刷新两次，同样的行可以排出两个样子。
现在顺序是**行的集合的纯函数**：先按区域自己的通道优先级（`solo_work_remote` →
`solo_work_lite` → `solo_agent_remote` → `chat_v3` → `solo_coder`），组内按显示名排序
（大小写不敏感，内嵌版本号按**数字**比较，所以 `GLM-5.10` 排在 `GLM-5.9` 之后），
同名再按 id 兜底 —— 因此结果是全序，与到达顺序无关。
- **「一屏」看不出这是一份并集**。现在每行归到**它会被调用的那个通道**下，表头写明是哪个模式、
有多少行：本机 CN 账号实测 34 行 → 6 组（`solo_work_remote` 20 / `solo_coder` 7 /
`solo_work_lite` 3 / `chat_v3` 2 / `solo_agent_remote` 1 / 未标注 1），
而不是 34 行平铺。分组用小 ``，默认全开 —— 默认折叠会把用户特意来找的模型藏起来。
- **搜索框**匹配显示名、id 与 **config_name**（排查 `4001 config_name rejected` 的人手上拿的是
上游名，而它正好在 `DeepSeek-V4-Flash` 这类行上与屏幕上的名字不同）。搜索**只是视图**：
「测试所有模型」与批量上下文按钮仍然作用于**整个目录**，不会因为搜索框里有字而悄悄缩小范围
（那是要花额度的动作）。开始搜索会把折起来的组重新展开一次。
- **排序写在两处，各管一半**：发现流程排一次（`lastCatalog` 因此有序，DSH 自己的模型选择器
按目录顺序渲染，也一并变稳），卡片再排一次（升级前保存的目录同样被扶正，不必先刷新一次）。
- 通道优先级表从 `solo.ts` 搬到纯模块 `src/model-order.ts` 并**由 `solo.ts` 反向重新导出** ——
卡片要 import 它，而 `solo.ts` 带着 `node:crypto`。两份拷贝会让「线上先问哪个通道」与
「界面上先画哪个通道」悄悄分叉，而分叉是不可见的。
- **测试**：`tests/model-order.spec.ts`（21 条：通道优先级、组内排序、版本号数字比较、
无通道行排最后、未知通道归位、与到达顺序无关、同名兜底、不改入参、分组不丢不重、搜索三种匹配）
与 `tests/card-model-groups.spec.tsx`（7 条：渲染顺序、组头计数、搜索计数、按 config_name 命中、
无匹配提示、**搜索时「测试所有」仍覆盖全量**、折叠与搜索重新展开）。全量 `1070 条 / 84 文件` 通过。
- **模型列表默认只看「常用通道」，并把藏起来的已启用模型说出来**（`feat(client)`，issue #52 P2）。
诊断里设想的是三档（`当前通道 / 常用通道组 / 全部`），P1 落地后重新数一遍只剩两档站得住：
- **「常用通道组」= 全部**。P1 已经退役了所有「任何对话通道都不展示」的 config，剩下的每一行
都至少有一个对话通道在展示它，这一档没有内容。
- **「当前通道」= 20 行，会藏掉在用的 `glm-5`**。它的真实含义是「只留第一优先的
`solo_work_remote`」；`glm-5` 只由 `solo_work_lite` 提供，不是 `-Official` 那份的影子。
为了「看起来像客户端」而把在用的模型从默认视图里拿掉，不划算。
所以是两档，默认 **24**（`solo_work_remote` + `solo_work_lite` + 未标注行），「全部」**34**
（再加 `solo_coder` 7 / `chat_v3` 2 / `solo_agent_remote` 1）。24 同时落在客户端「每个模式
展示 14–24 个」的上沿 —— 默认视图第一次和报告人拿来比较的那个列表是同一个量级，而**一行都没删**。
- **视图只影响绘制**：「一键测试所有」「整区切到 Max」「全部恢复默认上下文」仍作用于完整目录。
这些动作花额度或改设置，若因为屏幕少了 10 行就缩小范围，用户会以为「都测过了」。
- **被藏起来的「已启用」行必须说出来**：默认视图藏 10 行，用户之前勾选过的那些勾选框就不在
屏幕上了。保存路径本来就安全（写的是 state 里的 `activeEnabledIds`，不是从渲染出的 checkbox 读），
但不说的话，数一遍勾选框只会得出「那些模型被关了」。列表下方固定一行
「另有 N 个已启用的模型不在此视图内 —— 查看全部」。
- **搜索不撒谎**：搜索在视图内进行（全局搜索会和眼前的组头矛盾），所以空结果分两种 ——
「没有匹配」与「常用通道内没有，全部目录里有 N 个」+ 一键切过去。搜 `kimi` 时
`kimi-k2.5` 就在 `solo_coder` 组里，混成一句是搜索框最不该犯的错。
- **视图控件只在真有行被排除时才渲染**：一个能在两个相同列表之间切换的开关，比没有更糟。
- **按下态用 `bg-layer-3` 压在 `bg-layer-2` 轨道上**。第一版写的是 `bg-layer-1`，
`card-styles.spec.tsx` 立刻拒了 —— 那不是 DSH 定义的 token，回退值会在两个主题里同时生效，
正是这个测试存在的理由。
- **顺带**：`row.modelsChannelDefault` 字样改成「未标注模式（走 solo_work_lite）」，把这行的
真实调用路径写出来，而不是含糊的「默认通道」。
- **实测截图**（真机 34 行目录、真卡片组件、中文文案）：默认态 20+3+1 三组 24 行，
「另有 1 个已启用的模型不在此视图内」；切到全部后按下态与组数一同变化。
- **测试**：`tests/model-order.spec.ts` +5 条（`solo_work_*` 保留、未标注行按默认通道归入常用、
`all` 保持顺序且返回副本、按 region 判定、常用通道必须是该 region 优先级表的子集）与
`tests/card-model-groups.spec.tsx` +5 条（默认范围与计数、切换与 `aria-pressed`、
视图外命中提示与跳转、已启用行被藏时的提示与勾选状态、无可排除行时不渲染控件）；
原有 7 条按默认范围调整（涉及专用通道的断言先切「全部」）。全量 `1080 条 / 84 文件` 通过。
- **体积实测**（发版时在 main 基线上对照，更正 PR 描述里「与 4.4.4 一致」的说法）：
client 387.12 → **412.87 kB**、index 438.67 → **457.48 kB** —— 增长来自两个新模块与
分组 UI，属预期。
## 4.4.4 (2026-10-23)
> **同价的会员分支不再被读成第二重折扣；顺手补上官方客户端渲染链路的取证。**
>
> 合并自 PR #53。真机截图比对时发现：同一个 `deepseek-v4.1-flash`，插件胶囊写「闲时 5 折」、
> 官方客户端写「会员 5 折」、详情栏又并排列出两段一模一样的 5 折——查下来不是渲染错，
> 是我们把**同一个折后价的两条资格路径**讲成了两层折扣。
### 修复
- **不再把「同价的会员分支」说成第二重折扣**（`fix(promo)`，真机截图比对时发现）。
`deepseek-v4.1-flash` 的活动 `off_peak_member_discount_18_9` 里，`member` 与 `off_peak` 是
**同一个折后价的两条资格路径**（实测 2026-10-23：两者都是 `0.12 → 0.06, discount 50`；
会员全天可享，非会员只在闲时窗口内可享）。旧悬停无条件引用 `member` 并写「会员价另有 5 折」，
读起来就是 0.06 再打五折 = 0.03 —— 上游从来没有这个价。现在 `badgeOf()` 比较两条分支的
**折后价**，只有 `member.rate < 现价` 才带会员价，且文案改成给绝对数
（`会员价 0.06 积分/百万 token（5 折）` / `subscription price is 0.06 credits/Mtoken (50% off)`）；
等值时整句不出现。
**顺带**：`current` 判定出来的「闲时」徽标，若本地时钟确认某个窗口正开着，现在会把该窗口
（起止 + 时区）挂上去 —— 以前只有本地窗口算出来的徽标带时段，于是有「写着闲时 5 折、
悬停却说不出时段」的形状。时钟与上游不一致时不补，宁可少说。
**取证**：官方客户端同一行显示「会员 5 折」、详情栏并排列出两段 5 折，是因为它读的是服务端
下发的渲染配置（`featureOrder` + Jexl + `tag`/`tooltip.sections`），不是自己判折扣；
链路与实测写入 `docs/PROMO_CLIENT_RENDER.md`，`docs/PROMO_BADGE.md` §3/§4 同步补注。
**测试**：`promo.spec.ts` 新增「同价会员分支不引用」「上游闲时判定补时段」「时钟不认时不补」
三条；`card-promo.spec.tsx` 与 `model-label-slot.spec.tsx` 各新增一条悬停断言。
**验证**：`tsc` 两端静默；`vitest run` **81 文件 / 1019 条全过**（4.4.3 基线 1014 + 新增 5，
合并后 main 上复核实测）；`tsdown` 两个 build 通过，体积与 4.4.3 持平。
## 4.4.3 (2026-10-23)
> **模型选择器里也看得见活动优惠；账号池信息架构对齐 workbuddy；顺带修一个会让已保存设置
> 读回空值的区域映射缺陷，和三处「写了等于没写」的样式。**
>
> 合并自 PR #51（issue #50 的落实）。两条从姊妹插件 `dsh-connect-workbuddy` 搬来的账：
> **模型的活动优惠该在「挑模型的地方」就看得见**，以及一个会让**已保存的设置读回空值**的
> 区域映射缺陷。搬的是结论与陷阱，不是代码 —— 两边的促销协议不同（Trae 发 `activity_discount`
> 规则，WorkBuddy 发 `badge` + `displayMode`），所以只有「怎么判、什么时候判、显示几个数字」
> 这三件事是共通的。
### 新增
- **模型选择器里也画活动优惠胶囊**（`feat(client)`，移植自 workbuddy 的 #120）。
DSH 的模型选择器由宿主编排，插件能塞进去的只有一个字符 —— 而字符的颜色由 emoji 字体决定，
不是我们能定的。宿主为此留的唯一缝隙是 `conversation.input.model.label` 插槽（契约原文：
「渲染非交互的内联内容，例如带颜色的名称或徽标」，官方自己就用它挂 DeepSeek 的发布徽标）。
插件在该插槽注册 `TraeModelLabel`：
- **只显示一个倍率**。`traeModelDisplayName` 已经把目录倍率拼进名字（`Kimi-K2 · x0.55`），
宿主原样渲染该字符串，所以插槽若再追加一个倍率就会印成 `· x0.55 · x0.55` —— 这正是
workbuddy 的 #120 回归。现在后缀被**按形状**拆回名字之外（`/ · x(\d+(?:\.\d+)?)$/`），
再画在那个能承载折后价的 span 里：有折扣时显示折后价，没有时显示目录价，**永远只有一个数字**，
且是此刻成立的那个。
- **在渲染时刻判定，不在解析时刻**。判据是钟点（闲时窗口开合、活动到期），所以快照只取一次、
胶囊每次渲染现算，并挂一只**共享的分钟定时器**（20 行标签只花一个 interval）；夜间折扣不会
在第二天早上继续挂着。
- **取数走 `detail=fast`**（issue #77）。插槽在卡片之外，读不到卡片的 React state，只能自己问
宿主；用的是卡片轮询的同一个 `/usage` 路由，但取**首屏文档**：模型名册、`creditMultiplier`
与未解析的 `activityDiscount` 都是本地已知的，所以**打开选择器不会触发一次上游读**。
结果缓存 60 秒。
- **归属按 provider 判**：`panelOfProvider`（`src/region.ts`）把 `trae` / `trae-enterprise` /
`trae-global` 映射到各自的 panel，**企业版读自己的名册**（同一凭据、不同计费池、不同阵容）；
别人的 provider 一个徽标都不画、**连请求都不发**。
- **语言不靠注入的 `t`**：插槽拿不到卡片的 `t`，所以直接读浏览器语言并查同一张
`locales.ts` 表（中文「5 折」/ 英文「50% off」，两个占位符都传，各自取用的那个）。
- 关键样式内联兜底：插槽渲染在卡片之外，卡片样式表不一定在位（从未打开过卡片的页面），
所以胶囊的颜色/边框/圆角由组件自带，与 `.dsm-trae-model-promo-*` 同源同值。
- **测试**：`tests/model-label-slot.spec.tsx`（13 条）覆盖「拆后缀」「折扣优先于名字里的倍率」
「按形状而非数值拆」「`detail=fast` 与 panel 路由」「无价格就不画」「别人的 provider 不 fetch」
与「中文文案」；`tests/client-activation.spec.tsx` 的注册计数 4 → 5。
### 修复
- **三处新样式被后定义的基础类吃掉**（`fix(styles)`，真机截图比对时发现）。
这三个元素都同时挂两个类，而修饰类的规则写在基础类**之前** —— 特异性相同时后定义者胜，于是
「写了的样式」在页面上等于「没写」：
- `.dsm-trae-pool-modebar`（462 行）被 `.dsm-trae-pool-settings`（518 行）的
`padding:0` / `border` / `background` 抹平，蓝色描边与淡蓝渐变全部消失，模式条塌成一条普通分隔行；
- 免费模型缺失的警示语 `.dsm-trae-pool-serving-note`（471 行）被 `.dsm-trae-pool-note`（501 行）
的 tertiary 灰覆盖，该显示橙色的地方显示成灰；
- 账号下拉 `.dsm-trae-pool-account-select`（511 行）的 `max-width:min(320px,50%)`
被 `.dsm-trae-select`（600 行）的 `max-width:220px` 覆盖，框比设计值窄。
三处都改成双类选择器（`.a.b`，特异性 0-2-0），与规则顺序解耦。姊妹插件 `promo` 没有这个问题
—— 是搬样式时把新规则插错位置的连带伤。
**验证**：写脚本扫两端 JSX 里全部 33 组多类组合，按「交集属性 + 定义行号」判定谁覆盖谁，
Trae 修完 0 处、promo 本来 0 处；`tsc` 两端静默，`vitest run` 81 文件 / 1014 条全过。
- **`regionsMapOf` 不再跳到过期的同名区域**（`fix(region)`，已单独提交，移植自 workbuddy 的 5.5.x）。
旧规则是「有 `regions` 键就往下跳」，但 **`regions` map 自己也可能带 `regions` 键** —— 早期构建
往 map 里写过旧兄弟字段（真实 profile 里 `accounts` / `regions` / `cliBridge` 就并排躺在
`cn` 旁边）。跳下去读到的是**同一 panel 的另一份更旧的拷贝**，于是已保存的开关/手动排序读回空值，
表现为「设置没保存」，而文件里其实还在。
- 新规则按**形状**判定：外层只要含 panel id（`cn` / `enterprise` / `ai`）就是 map，不跳；
否则才视为整段设置文档。
- **变异验证**：把判定改回旧行为，新增用例必红（实测 1 条失败）；恢复后 22 条全绿。
### 重构
- **「更多设置」下面三段说明收进折叠块**（`refactor(pool)`，与 workbuddy 的「本池如何挑选账号」同形）。
副本路径、保存规则、删除行为三段原本平铺，在标题下占掉八行，把两个真正的控件（目标测速模型、
测试请求体积）顶出首屏。改用 `/`：键盘可操作、展开状态对屏幕阅读器原生可见，
不需要拿按钮和 state 去追 DOM；`open` 受控，因为这张卡片每次轮询都会重渲染，非受控会在用户
刚点开时把它收回去。文案一字未删，副本路径那句照样在（「插件留了真副本」是主张，「这两个 id
此刻就在这个文件里」是用户能打开来核对的事实）。顺带删掉从未写过样式的死类名
`dsm-trae-pool-copyfile`。新增双语 key `row.poolMoreRulesTitle`。
- **账号池的信息架构重排**（`refactor(pool)`，结论移植自 workbuddy 的 5.4.0，代码按 Trae 的结构重写）。
这一批不是改功能，是改**同一件事说几次、在哪里说**。十条原则里 Trae 欠九条，逐条落地：
1. **总开关移到标题下方**。它原本是「账号池设置」框的最后一行，被它控制一切的成员表在它上方
一百多行；池开/池关意味着「未入池」这一列**有没有意义**，所以选模式的控件必须排在
依赖模式的控件之前。开关那一行同时给出**运行中的模式**（自动挑号 / 手动选号）——
读的是已保存的值而不是草稿，因为开关本身已经显示待保存的编辑，旁边的「未保存」胶囊
说明这件事，模式胶囊因此可以回答另一个问题：池此刻在做什么。
2. **手动选号搬进标题行**。原来它自己占一整块，重复写着账号名。现在它与「当前计费：X」
徽标**共用一个槽位**：池关闭且有绑定路由时是选择器（控件自带名字），否则是徽标。
一个控件回答一个问题，不并存。
3. **「派单中」不再与「未入池」同框**。这两件事正交：Host 在池里没有可用成员时会回退到
已保存的选择，于是「正在计费的账号」完全可能不在池中。同一行还顶着「已选 0 / 1」，
正确状态因此读起来像 bug。现在行内只留成员关系（且跟随**草稿**而非已保存列表），
谁在计费由标题回答；两者真的冲突时，模式条下方给**一句话**解释。整行着色保留，
计费行仍然一眼可辨。
4. **批量按钮搬进成员区**。顺序改为「先声明范围（已选 N / M · 全部 / 清空）→ 再给动作
（一键测试 / 重新检测）→ 再列账号」。它原先是整块页头工具条，按钮在问「对哪些账号下手」
时，回答这个问题的控件还在一整块之外。「为什么按钮是灰的」紧贴动作行，不再隔一屏。
5. **保存条 sticky**。两个生效按钮原本在整页最底部：改完一行偏好，按钮在视口之外。
6. **「账号池设置」降级为「更多设置」**，它是「剩下那些」而不是页面主标题，不该与顶部的
「账号池」争主次。
7. **账号导入/导出搬到「更多设置」之上**。它们点一下立即生效，而它们下方那句提示写的是
「点保存才生效」——立即生效的动作不能住在只承诺保存的区块里。
8. **测试模型只说一遍**。设置区「目标测速模型」、表头「目标模型」、行尾各说一次，
同一个名字在一屏里出现三遍。表头改为「**状态**」（它描述的是结果），行尾仅在
**实际测的模型 ≠ 本池保存的模型**时才点名——那才是看着像 bug 而其实不是的情形。
来源（实时请求 / 批量测试）仍然保留，它不在这两个地方说过。
9. 顺带删掉因此变死的两条规则（`.dsm-trae-pool-bind`、`.dsm-trae-pool-tag-current`）
与一个死键（`row.poolCurrentBadge`）；`row.poolCurrentHeader` 原本已定义却从未使用，
这次终于用上。
- **测试相应重写**：`「派单中」 names only the pool's own answer` 那组改为断言**信息搬到了哪里**
——标题行的计费账号、池外旁注、以及池关闭时槽位里是选择器而不是徽标。新增三组共 10 条
结构断言：开关在成员表之前且标签读运行态；批量按钮在「已选」之后、表格之前；保存条
`position:sticky`；表头是「状态」、相同模型不复述而不同模型必点名。
- **变异验证**（通过 ≠ 有效）：把 `modelDiffers` 改回「有模型就显示」→ **2 条必红**；
把动作条移出成员区 → **1 条必红**；恢复后 50 条全绿。
### 验证
- `tsc -p tsconfig.json` 与 `tsc -p tsconfig.client.json` 均无输出。
- `vitest run` **81 文件 / 1014 条全过**（合并后 main 上复核实测；PR 写作过程中为 1007，末两个提交又加了 7 条）。
- `tsdown` 两个 build 通过。
## 4.4.2 (2026-10-23)
> **带工具的对话在 deepseek-v4.1-flash 上整轮 400/4027 拒绝。这个版本在两个工具出口
> 把 draft-3 风格的 `required: true` 归一化为 draft-4。**
>
> 接 issue #48 的后续证据（issue #49）：上游校验**分后端**。同一凭证、同一 SOLO 出口、
> 同一工具 schema，`glm-5.2`（智谱后端）放行属性内的 `required: true`，而
> `deepseek-v4.1-flash` 按 JSON Schema draft-4+ 严校验，直接回
> `4027 … tools.N.function.parameters/properties/X/required: invalid JSON Schema` ——
> 且 `tools.N` 是**按批校验**，一个不合格即全挂，所以「带工具必 400」。
> 之前 #48 判「上游已放行」是因为只在宽松的智谱后端上试过。
### 修复
- **工具 schema 出口统一归一化为 draft-4**（`fix(protocol)`，issue #49）。
DSH schemastery 生成的工具参数是 draft-3 风格 —— `required: true` 写在属性**内部**：
```json
{ "type": "object", "properties": { "tool": { "type": "string", "required": true } } }
```
JSON Schema draft-4 起已把 per-property boolean `required` 移除，改为父级字符串数组
`{ "required": ["tool"] }`。deepseek-v4.1-flash 这类严校验后端对前者直接判
`invalid JSON Schema`，整请求被拒。由于模型路由到哪个后端由上游决定、随 config 变化，
凡带工具的请求都必须是 draft-4 干净的，与探针上次试过后端无关。
- 新增 `normalizeTraeToolSchema` / `normalizeTraeToolSchemas`（`src/raw-chat.ts`）：
递归把属性内 boolean `required` 提升到父级 `required` 数组（与既有数组去重合并）后
删除 boolean；覆盖 `items` / `anyOf` / `oneOf` / `allOf` 等任意嵌套。**幂等** ——
已是 draft-4 的 schema 原样返回（同一对象，零拷贝），不改变合法载荷。
- **两个工具出口都套上归一化**：`prepareSoloBody`（SOLO `llm_utils_chat` 主路径，
`parameters` 在 `JSON.stringify` 前归一化）与 `buildTraeRawChatDraft`（raw chat 路径，
`structuredClone` 后的 `tools` 归一化）。纯本地、不碰凭据、不改调用方入参。
- 归一化后的载荷形态与 issue #49 的 D3 对照实验（draft-4 提升后经
deepseek-v4.1-flash 后端 200 正常 SSE）一致。
### 测试补强
- **989 例测试全绿**（`pnpm run test`），新增 **7 例**：draft-3 提升、嵌套
`items`/`anyOf` 递归、与既有 `required` 数组合并、draft-4 幂等（字节不变）、
`properties` 之外的 boolean `required` 与 `required: false` 不误伤、调用方 `tools`
不被原地修改、SOLO 信封 wire 载荷为 draft-4。
### 已知边界
- 归一化只处理 draft-3 boolean `required` 这一种已实测命中的非法形态；上游若日后
收紧到拒绝更多 draft-3 残留（如属性内其他 boolean 关键字），需另行取证后处理。
- 本次修复未经本机真实凭据实测（修复者无 Trae 凭据）；上游行为依据 issue #49 报告人
的三步对照实验（D1 无工具 200 / D2 draft-3 4027 / D3 draft-4 200）。本地验证为
单测 + 构造载荷核验。
## 4.4.1 (2026-10-22)
> **4.4.0 的修复自己藏掉了 `kimi-k2-0905`。这个版本把它捞回来，并补上 4.4.0 缺的实测。**
>
> 一条自我纠正。4.4.0 发布后作者对提升的模型做了**真实调用**实测，实测把 4.4.0 的
> 一个缺陷暴露出来：为了防止重名孪生行，4.4.0 加了「显示名已被占用就跳过」的规则 ——
> 这条规则把 `kimi-k2-0905` 也丢掉了，而它**是另一个真模型**（168K 上下文，实测可调用）。
> 于是报告人 `yuantao313` 抱怨的那一类「带日期的快照 ID」在 `kimi-k2-0905` 上**依然拿不到** ——
> 成因从「合并只遍历骨架」换成了「去重按名字判断」，**症状没变**。
> 详见 [`docs/ISSUE46_DIAGNOSIS.md`](https://github.com/dingminhua/dsh-connect-trae/blob/main/docs/ISSUE46_DIAGNOSIS.md) 第 9 节。
### 修复
- **重名判断改为「能力测试」而非「名字测试」**（`fix(catalog)`，issue #46）。
`claimedNames` 记录每个显示名下**最大的**上下文窗口；一个重名行只有在**严格更大于**
该最大值时才提升，并被追加 id 以便区分（两行都渲染成 `Kimi-K2-0905` 的 picker 是在撒谎）。
- **实测依据**（2026-10-22，CN 凭据）：`kimi-k2` 是 28000 而 `kimi-k2-0905` 是 168000，
名字相同、能力差 6 倍，且 `kimi-k2-0905` 在 `solo_coder` 与 `chat_v3` 下**都能调用**。
- 反面对照：`glm-4.7` 与 `glm-4.7-auto` 元数据**完全相同**（100000/16000/`chat_v3`），
是真重复，仍然只留一行；`glm-5.2_advisor_default`（168000）比 skeleton 的 `glm-5.2`
（200000）**更小**，是内部改道，仍被排除。
- **实测结果**：目录 **42 → 46 行**，提升行 7 → 11。新增
`kimi-k2-0905`、`minimax-m2-auto`、`minimax-m2.1-auto`、`glm-4.6-auto`
（全部为 168K / `solo_coder`，显示名形如 `MiniMax-M2 (minimax-m2-auto)`）。
- 比较基准是**最强的占用者**，因此与 wire 名单的顺序无关（有回归测试钉住）。
### 测试补强
- **982 例测试全绿**（`pnpm run test`），新增 **4 例**：重名但更强者被提升且名字带 id、
重名且相等/更弱者仍被排除、`-auto` 孪生按能力取舍、比较基准取最强占用者。
### 实测记录（4.4.0 遗留边界现已关闭）
`4.4.0` 的 CHANGELOG 曾记「新提升的 7 个模型未逐个实测可调用性」。现已实测，**全部通过**
（真调用，走插件自己的 bridge，每个一次最小 `ping`）：
| 模型 | function | 结果 |
| --- | --- | --- |
| `seed-code-pro-0430` / `glm-5-turbo` | `solo_work_remote` | AVAILABLE |
| `glm-4.7` / `glm-4.6` / `minimax-m2` / `minimax-m2.1` / `qwen3-coder` | `chat_v3` | AVAILABLE |
| `kimi-k2` | `inline_chat` · `chat_v3` · `solo_work_remote` | 三个 function 全部 AVAILABLE |
| 4.4.1 新增的 4 行 | `solo_coder` | 全部 AVAILABLE |
合计 21 次真实调用，消耗 **约 11 额度**（约 0.43/次）。
因此 `4.4.0` 中「`kimi-k2` 归属 `inline_chat`、可调用性尚未取证」这条边界**一并关闭**。
### 已知边界
- fix A 多问 function 带出的 `doubao_1_8`（`Doubao-Seed-1.8`）**实测 4001 拒绝**：它没有
`wireFunction`、也没有上下文与输出元数据，是条残缺的骨架行。按 issue #19「全部呈现 +
如实报错」的策略这是合规行为（选中会得到明确的上游原文错误），但它确实是一条新增的、
调不通的行 —— 记在这里，不假装它可用。
- 取证仍在维护者本机的 CN 账号上完成。报告人账号上是否真有
`deepseek-v4.1-flash-1017` 这一行，仍需他升级后确认（本机 roster 上无此行）。
## 4.4.0 (2026-10-22)
> **模型表不再系统性排除「带日期的快照配置」；账号池开关不再被模型目录的保存冲掉。**
>
> 两条都来自 [issue #46](https://github.com/dingminhua/dsh-connect-trae/issues/46)
> （yuantao313：「模型列表不对齐，无法获取DeepseekV4.1 Flash 1017模型ID · 插件中无法获取Trae的1017模型，
> 只能使用正式版」）。诊断见 [`docs/ISSUE46_DIAGNOSIS.md`](https://github.com/dingminhua/dsh-connect-trae/blob/main/docs/ISSUE46_DIAGNOSIS.md)。
> 版本号取 **minor**：模型名录的行为变了（多出一批此前拿不到的模型），接口与配置项零变更。
### 修复
- **模型表补齐 wire 名单里有、Remote 目录里没有的模型**（`fix(catalog)`，issue #46）。
- 目录是「Remote 骨架 × wire 名单」两张表 join 出来的，而 `mergeTraeModelSources()`
**只遍历骨架** —— wire 有、骨架没有的行被整体丢掉。这不是零星遗漏，而是**一整类别的系统性缺失**：
**实测**本机 CN 账号上，Remote 骨架里带日期的 config_name **一个都没有**（`kimi-k2-0905`、
`seed-code-pro-0430`、`search_agent_qwen_fast-0710` 全在 wire 名单里），于是**每一个带日期的
模型插件都拿不到**。这正是报告人「IDE 有 `DeepSeek-V4.1-Flash-1017`、插件没有」的直接成因。
- 提升**不是无条件的**：`isPromotableWireModel()` 要求四个上游信号同时成立 ——
`usage === 'chat_completion'`（真模型，不是 IDE 的工具配置也不是账号的自定义模型）、
`config_source === 1`（Trae 预设，不是用户自己的 custom model）、
显示名是**真名字**（非空、非上游占位符 `-`、非 config 标识符、且不等于自己的 id）、
显示名**未被已存在的行占用**（否则同一模型会以两个 id 出现两次）。
**实测**：50 行 wire-only 收敛为 7 个真模型，其余 43 行（工具配置 / 自定义模型 / 别名 /
`-auto` 孪生行 / codename config）仍被正确排除。
- 被提升的行是**完整的目录行**：带自己的 id（那就是它的 `config_name`，所以不产生
`wireConfigName`）、所属 function、上下文窗口、输出上限、倍率与促销规则。
- **Remote 目录多问几个 function**（`fix(solo-remote)`，issue #46）。
`TRAE_REMOTE_DIRECTORY_FUNCTIONS` 增加 `chat`、`inline_chat`、`solo_agent_lite`、
`solo_design_lite`、`solo_design_remote`。`kimi-k2` 在 Remote 侧**只**归属 `inline_chat`，
而插件没问它 —— 这就是 `Kimi-K2-0905` 那一族拿不到的原因。
**实测**：Remote 骨架 33 → 35 行，新增 `kimi-k2`（`Kimi-K2-0905`）与 `doubao_1_8`
（`Doubao-Seed-1.8`）。问网关不提供的 function 无害（未知名字被忽略，不报错）。
- **账号池开关不再被「保存模型列表」冲掉**（`fix(client)`）。
插件有 4 处写 `regions`，其中 3 处都**先展开旧 slot 再覆盖自己管的字段**；只有
「保存模型列表」那处是**从零重建整个 region slot** 的，而它并不知道 slot 里还有 `pool`
这个字段 —— 整体替换把账号池偏好冲掉了。症状：**开账号池 → 保存模型列表 → 池被关掉 →
重开插件显示「未保存」**。
修法：新增 `nextRegionDirectory()`（`src/status-paths.ts`），展开旧 slot 再用目录字段覆盖。
**顺带修掉**同一处的另一个受害者：`creditPosition`（积分读数的座位）也一直被冲掉，
保存模型列表会把读数重置回默认位置。
> 这与 issue #42 记录的 `wireConfigName` 丢失是**同一类缺陷**：整块替换 slot 时，
> 保存方不知道的字段就消失了。#42 丢的是 `wireConfigName`（每次保存都 4001），
> 这次丢的是 `pool` 与 `creditPosition`。
- **同一模型在不同 function 下发布不同显示名时，取最充实的那一份**（`fix(solo)`）。
上游对同一个 config 在不同 function 下发布不同的 `display_name`（实测：`doubao-for-auto`
在 `chat_v3` 下为空、在 `solo_coder` 下是 `Seed-Code`），而插件的 wire client 是**先到先得**，
于是「拥有它的 function 恰好不知道名字」的模型在插件里显示成 config id 本身。
现在**行归拥有者**（function 决定可调用性，必须不动）、**名字取最充实的那一份**。
上游对无名字 config 发布的占位符 `-` 不算真名字。
### 行为说明
- **显示名仍以 Remote 目录为准，刻意没有改成 wire 名单的**（issue #46）。
最初的方案是「以 wire 为准，因为 IDE 渲染的是 wire 的 `display_name`」——
**这个假设被实测否掉了**：wire 名单与 IDE 名单**32/81 行不一致**，而 Remote 骨架只有 **3/33**。
原因是 wire 名单**按 function 分片**，插件的 wire client 读的是聊天 function，
常落在 IDE 选择器并不渲染的那个名字上。代码与回归测试里把这个**被否掉的结论**钉住了，
以免日后凭「听起来合理」再改回去。
### 测试
- **978 例测试全绿**（`pnpm run test`），其中新增 **17 例**：
- `tests/catalog.spec.ts`（+6）：显示名保持骨架（钉住被否掉的方案）、提升 wire-only 模型、
不提升工具/自定义/别名、别名不重复、`isPromotableWireModel` 的五种边界。
- `tests/solo.spec.ts`（+4）：读 `usage` / `config_source`、上游没说时保持 undefined、
跨 function 取最充实的名字。
- `tests/issue46-regressions.spec.ts`（+5，**新文件**）：账号池开关与积分座位在
每一种写入后都还在、模型目录多问 function、wire-only 模型被提升、
工具/自定义/别名仍被排除。
- `tests/solo-remote.spec.ts`：5 处硬编码的 function 列表 URL 改为引用常量。
### 文档
- 新增 [`docs/ISSUE46_DIAGNOSIS.md`](https://github.com/dingminhua/dsh-connect-trae/blob/main/docs/ISSUE46_DIAGNOSIS.md)
与 [`docs/ISSUE46_REPLY_DRAFT.md`](https://github.com/dingminhua/dsh-connect-trae/blob/main/docs/ISSUE46_REPLY_DRAFT.md)。
- 新增三个只读探针（`scripts/probe-issue46-*.mjs`），只读、零额度，输出诊断与修复后验证的全部结论；
`scripts/decrypt-block.js` 是从 `probe-toolcalls.mjs` 原样抽出的解密例程，供各探针共用。
### 已知边界
- **取证在维护者本机的 CN 账号上完成。** 名单按账号/套餐裁剪，报告人账号上很可能**真的有**
`deepseek-v4.1-flash-1017` 这一行（本机没有）—— 它正好落在「骨架排除、wire 有」这一类，
**修复后应当会出现**，但需报告人升级后确认。
- **新提升的 7 个模型未逐个实测可调用性**（调用会产生额度消耗）。按 issue #19 的既定原则
「名单的沉默不能证明模型不可调用」，缺的是证据而不是行；但「能否真的调用」仍需实测。
- `kimi-k2` 归属 `inline_chat`，而可调用 function 列表里没有它 —— 它的可调用性尚未取证。
## 4.3.0 (2026-10-22)
> **设置卡片按「账号 / 模型 / 诊断」分栏，模型栏改回全部铺开。**
>
> 卡片原来是一列长页，把两类互不相干的事情混排在一起：运维账号（谁在服务、还剩多少、签到、
> 账号池及其日志）与编辑目录（勾模型、图片输入、上下文预算）。两者连提交语义都不同——账号改动
> 点一下即生效，目录改动是草稿、必须点「保存」——于是保存按钮常常离它要保存的东西隔着三屏。
> 学自同族 `dsh-connect-workbuddy` 的分栏实现。版本号取 **minor**：新增界面与一个只读栏，
> 接口、配置项与请求结构零变更。
### 新增
- **设置卡片按「账号 / 模型 / 诊断」分栏**（`feat(client)`）。
- 顶部地区那排仍是**作用域**（这张卡片讲的是哪个供应商）；其下新增分栏 tablist（账号 / 模型 /
诊断），三者共享同一个地区作用域。两排视觉上明确区分：地区是带开关的方框 chip，分栏是设置窗
口那种下划线 strip——两排方框会被读成一个六选一。
- 非活动栏用 `hidden` 留在页面里：切栏不重新拉取、不丢未保存的模型草稿、账号池日志不重建；
`hidden` 同时让非活动栏退出无障碍树，这正是 `role="tabpanel"` 要的语义。
- 新增只读「诊断」栏：面板名、供应商 id、服务账号（按名字，不打印 id）、访问令牌与重新登录两个
到期时间、目录模型数与已启用数、账号池与签到支持与否、Raw 会话通道状态，以及上游最近一次错误
**的原文**（原样引用，不翻译、不概括）。这一栏没有任何会改设置的控件，存在的唯一理由是被整段
贴进反馈。
- 签出态不画分栏：那一段说明不会被一个看不见的 tab 藏起来。
- 文案同时补 en/zh（`row.panel*` / `row.diag*`）；样式新增 `.dsm-trae-panels` /
`.dsm-trae-panel-tab` / `.dsm-trae-panel` / `.dsm-trae-diag*`。
- **模型栏把所有模型全部铺开，没有内层滚动条**（`feat(client)`）。
- `.dsm-trae-model-list` 不设 `max-height`，`overflow-y` 也不是 `auto`：唯一滚动是卡片自己的
页滚。`overflow: hidden` 保留，只为圆角描边——纵向不裁任何内容。
- **实测**（`tools/panels-shot.tsx`，30 个模型的目录）：`scrollHeight == clientHeight == 1889`、
`clipped: false`、`max-height: none`、面板内自带滚动元素 `0` 个，保存栏落在页面末尾。
### 重构
- **账号栏抽成 `src/client/TraeAccountPanel.tsx`**（520 行），`TraeUsageCard.tsx` 从 2354 行
降到 1981 行。拆分是「笨」的那一半：所有判定仍留在卡片里（谁在服务、每行值多少、能不能签到、
读数放哪儿），账号栏只接收算好的行视图；这样账号表与账号池表读的是同一份判定，不会各说各话。
- 卡片与账号栏共用的格式化/判定（`formatNumber` / `formatDateTime` / `dotStyle` /
`refreshTokenWarning`）下沉到 `src/client/display.ts`，避免两处各写一份而漂移。
### 修复
- **诊断栏的「每日签到」不再依赖账号池**。原先读 `pool.checkinSupported`，而账号池是**可选功能**，
没开池的国内账号会显示「本面板不提供」——恰好与事实相反。改为先读签到文档（`status.checkin`）。
### 测试
- `tests/card-panels.spec.tsx`（10 条，新增）：默认落在账号栏、点模型/诊断可切换、非活动栏仍挂载
（草稿不丢）、恰好一个 `aria-selected`、tab 与 tabpanel 互相指向、切栏不改地区作用域、诊断栏无
任何可交互控件、签出态无分栏；另加两条：30 个模型全部渲染且列表样式里没有 `max-height` /
`overflow-y:auto`，「每日签到」按签到文档而非账号池判定。
- 顺带修好受影响的既有卡片测试（`card-test-models` / `card-context-bulk` / `card-promo` 的
`renderOpen` 先点开模型栏），因为模型控件现在确实在那一栏里。
- 新增 `tools/panels-shot.tsx` + `pnpm panels:shot`：把三个分栏各自渲染成
`/tmp/panels-preview-.html`（真实中文文案、30 模型目录），页面里的 `#audit` 给出
面板盒、分栏下划线与模型列表 `scrollHeight`/`clientHeight` 的实测值，用 `--dump-dom` 读回，
用来证明「没有内滚」而不是靠肉眼。
- 全量 `vitest run` = 79 文件 / 961 测试全绿；两份 tsconfig 均 exit 0；`tsdown` 构建成功。
### 文档
- README / README.en 的卡片特性列表补上分栏一节（含「为什么分栏 = 提交语义不同」与「模型全部铺开」）。
## 4.2.0 (2026-10-21)
> **模型行显示活动优惠徽标：只在上游此刻真在打折时出现。**
>
> Trae 把促销放在模型目录的同一次响应里——remote 目录的 `features.activity_discount`、wire 名单的
> `display_contact_config.activity_discount`（都是 JSON 字符串）。上游发的是**规则**（折扣比例、原价、
> 闲时时段与命名时区），不是文案。插件解析规则、在卡片**每次渲染时**按当前时钟判定，在模型名旁边画一枚
> 胶囊：`5 折` / `闲时 5 折` / `限时 5 折`，悬停给出原价→现价与时段。请求数、请求身份、积分语义全部不变。
>
> 判定放在渲染时刻而不是解析时刻，是因为 `time_windows` 是「Asia/Shanghai 周一到周五 00:00–09:00、
> 12:00–14:00、18:00–24:00，周末全天」这种墙钟时段：若在解析时挑定结论，夜里读到的「闲时 5 折」会在
> 第二天早上继续挂着。实测同一份规则，时钟平移 +0/6/12/24/36h 分别画出 3/5/5/3/5 枚（2026-10-21 18:16）。
### 新增
- **模型行显示活动优惠徽标**（`feat(model)`）。解析 Trae 目录里的 `activity_discount` 规则，按渲染时刻判定后
在模型名旁边画一枚胶囊：`5 折` / `闲时 5 折` / `限时 5 折`，悬停给出原价→现价、时段与时区。
- 解析层只留规则、不挑徽标；规则随 `lastCatalog` 持久化，判定在卡片每次渲染时做，胶囊随窗口自动出现和消失。
- **先信上游的 `current`**（服务端算好的「此刻状态」）：`discount_type !== 'none'` 且折后价真比折前低才显示；
只有它报「没打折」时才用 `off_peak.time_windows` 按模型声明的时区自己算（跨零点不推断、`start` 含 `end` 不含）。
- 文案只认上游明说的：只有 `limited_discount` 写「限时」，其余按「补贴 / 闲时」；颜色是插件自己的选择。
- **不从倍率反推折扣**：那一行本来就显示 `x0.40`，再挂「5 折」是同一句话说两遍。
- 纯提示：不新增请求、不改计费语义；国际区（订阅制）目录里没有这份数据，显示路径同一条、上游补齐即生效。
- 详见 `docs/PROMO_BADGE.md`；复算脚本 `scripts/probe-promo.mjs`（只读，不消耗积分）。
### 修复
- **跨 group 去重不再丢促销规则**（`fix(solo-remote)`）。同一次目录响应里，同一个模型在部分 group 带
`activity_discount`、在部分 group 完全没有，而 group 顺序每次调用都可能不同（issue #23 的同一现象）。
`preferStrongerRow` 原先只按容量选行（等容量时先到先得），会把带规则的那一行丢掉，导致同一份上游数据
相邻两次调用一次 1 枚徽标、一次 0 枚。现在选行仍按容量，但把另一行携带的规则**并到赢家身上**；
没有改成「选带规则的行」，因为那会丢掉 1M Max 档——徽标不能以用户失去上下文预算为代价。
- **活动徽标的两处边界收紧**（`fix(promo)`）。
- 两条规则评分并列（都没有 `current`、各 1 个窗口）时，原先留先到的那条，今晚有没有徽标就取决于网关的
分组顺序；改按规则内容的规范化 JSON（键名排序）取定，任意分组顺序结果一致。
- 上游 `time_zone` 写坏时，判定退回账号时区但悬停仍报那个读不出来的名字；改为报**实际用于判定的**时区。
### 文档
- 新增 `docs/PROMO_BADGE.md`（两处字段位置、逐字抓包、判定规则、与 WorkBuddy #91 的能力对照、实机复核输出）。
- README / README.en 功能列表各加一条「活动优惠徽标」。
- `docs/PROMO_BADGE.md` 按 2026-10-21 17:14 复测校正：wire 侧实测 214 行 / 26 行带规则 / 9 个模型
（旧记 54 行 / 8 行 / 3 行在打折）；补记判不了的窗口直接丢弃（不推断「全天」或跨零点）、
`limited` 分支的 `end_at` 未被读取（实测限时活动 `current` 报 `none`，所以「限时」暂不会真的出现）。
### 测试
- 新增 `tests/promo.spec.ts`（20 例）：`enable: false` 丢弃、JSON 字符串形态、两段价格字段（`consumption_rate` /
`after_consumption_rate`）、窗口过滤与丢弃（缺周几、空区间、越界）、时区判定、坏时区退回账号时区、
跨零点不外推、`current` 优先、非 `limited` 不写「限时」、无数字不画、以及「同一份规则在框内/框外判定不同」。
- 新增 `tests/card-promo.spec.tsx`（6 例）：胶囊渲染在模型名旁边、三种类型的颜色类、悬停数字、无规则不渲染、
窗口外不渲染。
- `tests/solo-remote.spec.ts` 补跨 group 去重 4 例：容量与规则并存、评分排序、并列按内容取定、
同一份数据换 group 顺序结果不变。
- 全仓 **78 文件 951 例**通过；`tsc` 两个工程干净；`build` 通过（CJS 344.00 kB / ESM 426.33 kB）；
CI（ubuntu + windows）全绿。
## 4.1.0 (2026-10-21)
> **受限网络（企业网只放行少数域名）下「刷新模型 500 / 聊天 4001」的完整修复。**
>
> 链路是三段式的：`solo.trae.cn` 的 CONNECT 被代理拒绝（403）→ 目录 `fetch failed`（刷新 500）→
> 模型丢失 `wireFunction` → 聊天按默认 `solo_work_lite` 发请求 → 模型不在该 function 的 config 名单里就
> 4001 `config_name rejected`。本版对三段各有一处改动：目录 host 回退到聊天网关的同路径（带冷却重试）、
> 目录分组的 function 兜底 `wireFunction`（只认可聊分组）、bridge 对「只带 function」的目录行保留
> resolver 的 `config_name` 大小写（issue #38 的坑）。
>
> 合并 PR #43 前做了对抗性复现，修掉了四处会伤到真实用户的回归——**最关键的一处**：原实现把功能名
> 属于 `solo_agent`/`builder_v3` 的目录行整行丢弃，而受限网络下那正是 9 个只在 `solo_agent` 分组里
> 出现的模型（`gpt-5.5`、`gpt-5.6-*`、`gpt-6-astra`、`glm-5.2`、`kimi-k2.7-code`、`Dola-Seed-2.0-Code`、
> `deepseek-v4-flash-0731`），它们正是 issue #19 修复要暴露的那批、且实测在默认 chat function 下
> 都能正常应答。现在只把非可聊 function **降级清空**，行保留。
### 修复
- **受限网络下模型目录走聊天网关备用 host，目录分组 function 兜底 `wireFunction`**（`fix(cn)`）。修复分三层：
- **目录 host 回退**：官方 remote host 网络错误 / 超时 / 5xx 时，按序尝试聊天网关的同一路径
（CN 为 `trae-api-cn.mchost.guru/api/remote/v1`，实测同路径同响应结构）；401/403/404 等语义性拒绝**不回退**。
进程内记住最近一次**给出了非空目录**的 host。官方 host 失败后进入 5 分钟冷却：冷却期内先走记住的备用
host、官方 host 排在链尾（备用也挂了时仍有一次机会），冷却到期后官方 host 重新排第一 —— 只把官方 host
「排在第二」并不能让它被重试，因为循环在第一个成功处返回，所以必须显式冷却重试，恢复的网络才会在
一个冷却窗口内重新接管。空目录（200-but-empty）既不算成功（不记忆）也不终止链路（继续试下一个 base），
否则一个还没同步的镜像会永久堵死官方 host。回退只作用于 remote/v1 目录这一个 base；
`get_detail_param`、`llm_utils_chat` 照旧走各自原有 host。
- **目录分组 function 归因**：`fetchModels` 不再丢弃 `data.list[].function`——解析时把**可聊**分组的 function
附到每个模型（同一模型出现于多个分组时按 `TRAE_DIRECTORY_FUNCTIONS` 的实测优先级取，而非请求参数
`functions=` 的顺序；后者是历史列表，与 wire roster 自己的收集顺序不同，混用会让同一模型在「roster 有没有
返回」两种网络下拿到不同 function，`solo_agent_remote` 在 Remote 付费门后，优先它会多出 1005）。
`mergeTraeModelSources` 的 `wireFunction` 优先取 `get_detail_param` 的结论，目录分组兜底（roster 知道
账号的付费/可用状态，目录不知道）。同一 function 名重复出现时按名分桶保留全部，不再只留最后一组。
- **非可聊 function 只降级、不丢行**：`solo_agent`、`builder_v3` 是 IDE/Remote-agent roster，聊天通道实测
4011/4001，所以**不把这两个 function 写进 `wireFunction`**；模型本身**保留**，改由默认 chat function
调用。把它们整行丢掉等于在本次修复针对的受限网络里重新藏起 issue #19 的成果（详见上方导语）。
仅带 `wireFunction`（无 `wireConfigName`）的目录行，聊天请求会带上该 function，但 `config_name` 仍由
resolver 提供（目录 id 只是展示名，网关 `config_name` 大小写敏感，见 issue #38）。默认 function 与
fallback 模型常量未动。
- 已知取舍：模型被目录放在 `chat_v3` 分组下、但实际不可聊时，插件仅凭目录数据无法区分，仍会展示，
聊天失败走现有 4001 提示翻译（诊断入口见 `docs/ISSUE19_DIAGNOSIS.md`）。
### 测试
- 回归用例：host 回退（官方网络错误 → 备用 host 同路径同查询；401 不回退；5xx 回退；**空目录继续尝试下一个
base 且不被记住**；记住最近成功 host；**冷却到期后官方 host 重新排第一**；显式 baseUrl 钉住单 host）、
分组 function 归因（可聊分组优先；**同一 function 名重复出现时不丢模型**；容量来自后分组时保留先到先得的
function）、合并兜底与 `withChatCallableFunctions` 的**降级而非丢弃**、bridge 对 wireFunction-only 目录行
保留 resolver 的 `config_name`（大小写）、以及受限网络端到端（wire roster 为空时 9 个 `solo_agent`-only
模型仍然在目录里）。
- 全仓 **921** 例通过，0 skipped；`tsc` 两个工程干净；`build` 通过；CI（ubuntu + windows）全绿。
## 4.0.1 (2026-10-19)
> CN 区模型卡「最大输出」整列空白（issue #42）修复：上游**是**发布输出上限的——`get_detail_param` 的
> CN 80 个 config **80/80** 都带 `model_detail_list[].max_tokens`——但目录合并 `mergeTraeModelSources()`
> 把 wire 侧的 `maxTokens` 丢掉了。这个字段从合并函数诞生那天（1.1.0）起就没被复制过，卡片、
> `/models/refresh` 与 DSH 模型注册因此永远收到「未知」。附带落地同一 issue 的批量请求：整区上下文
> 一键切换两个按钮。
### 修复
- **目录合并带上 wire 的 `max_tokens`**（`fix(catalog)`）。合并时其余字段（contextWindow / maxContextWindow /
倍率 / reasoning / multimodal / config_name）一路都复制了，唯独漏了 `maxTokens` 一行。修复后 CN 实测
32 行目录 30 行带值；**仍空白的行是诚实的**——`kimi-k2.8-preview`、`qwen3.8-flash` 这类 TraeCode 通道行
在 SOLO 名单里没有对应 config，拿不到候选值，宁空白不编造。取值链其余部分不动：`collectModels` 读
`model_detail_list[0]` 实测无损（71/80 config 的双项 `__dev`/`__max` 上限恒等）。该值是**元数据**，
请求体照旧不下发 `max_tokens`（上限由 Trae 服务端决定），行为无变化。
- 报告人「想确认的一点」（输出上限是否挂在后面的 detail 项或别的键）已逐项 dump 排除，全文见
`docs/ISSUE42_DIAGNOSIS.md`，取证脚本 `scripts/probe-cn-maxtokens.mjs`（只读，随仓库提交）。
### 新增
- **卡片模型管理区两个批量上下文按钮**（`feat(card)`，issue #42 附带需求）：「**整区切到 Max**」给本区
每个带 Max 档的模型一次性写入其 `maxContextWindow`（正是 `applyContextBudgets` 认的精确值），
没有 Max 档的行不动、已有手动预算保留；「**全部恢复默认上下文**」清空本区预算。二者作用于草稿、
按「保存」生效，落盘形状与逐行单选完全一致——因此**没有**新增 `contextBudgetMode` 配置键，
运行时零新分支、旧配置零迁移。报告人数的 18 次点击现在是一次。
- README 新增「最大输出与上下文预算」一节（issue #42 建议 1 换内容采纳：事实已变，文档写明上游发布该值、
空白行另有其因）。
### 测试
- 新增合并回归用例（修复前必红：wire 行带 `maxTokens` → 合并行必须保留；join-miss 行必须缺席）与
5 例卡片用例（批量按钮的落盘内容、既有手动预算的保留、两按钮各自禁用条件）。
- 全仓 **901** 例通过，0 skipped；`tsc` 两个工程干净；`build` 通过。修复前后各跑一次实时探针对照
（0/32 → 30/32）。
## 4.0.0 (2026-10-19)
> 移除 issue #29 的「跟随 Trae 桌面端当前登录」整套机制，连同它派生的两处 UI。
>
> **原因：账号池功能无法兼容原需求。** #29 要的是「插件始终跟着 App 当前的登录走」，而账号池要的是
> 「每个账号都能被长期保留、随时选中、按可用性换号」——池里选中的账号往往正是那个已经不在 App 里
> 登录的账号，它必须照常可用。「跟随当前登录」与「账号池」是互斥的两条规则，只能是后者。
>
> 这是**大版本**：一个配置字段与两处界面被移除。
### 移除
- **设置卡片里的「跟随 Trae 当前登录的账号」开关**。连带删除 `Config.followAppLogin` 字段、每次设置
生效时的自动重绑、以及启动时的那次跟随。插件不再有「不点也会自己换绑计费账号」的路径。
该开关默认关闭，所以从未打开过它的用户没有任何行为变化；存过 `true` 的旧配置里的这个键会被忽略。
- **账号区上方的「Trae 已登录 X，但本插件绑定的是 Y。改用 Y」提示条**。连带删除 Host 侧
`TraeCredentialStore.liveLogin()`、usage 文档的 `appLogin` 字段及其读取路径、`TraeWebAppLogin` 类型。
usage 文档不再携带这个字段。
- **账号池设置里的「每登录一个账号，就刷新一次」黄色警告框**。账号副本是每次读取就补齐一次的，
这句「没刷新就换号，上一个账号不会被保存」与实现不符。
- 顺带清掉只服务于跟随开关的 Host 侧 `writeSettings` 写入通道（`settings.update` + revision 冲突重试），
它的唯一消费者就是那个开关。
### 不变
- **没有显式选择账号时，仍然默认使用 App 当前登录的账号**（`preferred()` 对 `source === 'desktop'`
的凭据优先）。这是本次移除后仍然保留的「跟随」行为，且不需要任何开关。
- **账号副本机制不变**：本机每个 Trae 登录都会被复制成自己的一份（`~/.dsh/.trae-auth..json`），
换号不会顶掉任何账号，之前的账号仍可被重新选回来。
### 测试
- 删掉随功能退役的用例：`auth.spec.ts` 的 `liveLogin()` 三态、`web-status.spec.ts` 整个
`app sign-in follow hint (issue #29)` describe、`card-accounts-table` 的提示条两条、`card-pool` 的
警告框一条。`card-styles` 的遮罩用例改用 `showPointsInMainUi` 开关驱动。
- 全仓 **895** 例通过，0 skipped；`tsc` 两个工程干净；`build` 通过。
## 3.10.2 (2026-10-19)
> 设置页的账号列表**先出、积分后补**。打开卡片原本要等**一整份**用量文档组装完才画第一笔：那份文档的
> 尾巴上挂着「逐账号读上游余额」和「逐账号读签到状态」，每个账号一次网络往返，单次超时 30 秒、没有重试，
> 上游一慢就层层等待——这正是兄弟插件 dsh-connect-workbuddy 的 issue #77（实测 30–60 秒才看到账号）。
> Trae 这边同一份文档里 `poolMembersOf` 甚至被调了 **4 次**（`members`、`effectiveMemberAccountIds`、
> `memberNames`、`otherAccounts` 各一次），签到那条路还要再触发一次，所以同样的机器上比 workbuddy 更慢。
> 本版把首屏与「测量」拆开：首屏只用本机已存的东西，测量结果随后补上。
### 修复
- **账号列表不再等上游余额**。`GET /usage?region=…&detail=fast` 返回一份只用本机状态的「首屏文档」：
`store.current()` 读已存凭据（不做网络刷新）、账号行来自新增的 `localMembers`（就是请求路径本来就在用的
`localPoolMembers`，零上游调用）、签到状态来自本进程已测过的缓存。**实测 0 次上游请求**，本机 1.3 秒的
完整文档变成毫秒级首屏。
- **卡片分两笔画**：先请求 `detail=fast` 上屏，再请求完整文档补齐积分/签到/模型探测结果。首屏文档**永不
覆盖**已经在屏的完整文档——否则每次轮询都会把积分闪回「—」。
- **首屏之前不再谎称「未登录」**。旧代码在 `statusByRegion` 里预置了一份 `signed-out` 占位文档并直接渲染，
于是整段等待时间里已登录的用户看到的是「去登录」引导；现在状态表初始为空，未拿到任何文档时显示新增的
「正在加载账号…」，真正的 `signed-out` 文档到了才显示登录引导。
- **完整文档故意保持不变**：`detail` 缺省、或值不是精确的 `fast`（比如大小写写错、拼成 `fastest`）时一律
退回完整文档——宁可慢一会儿，也不能给出一份更空的卡片。
- Host 侧配套：`TraePoolDeps` 新增可选 `localMembers` / `cachedCheckinState`，`src/index.ts` 里分别接到
`localPoolMembers` 与新增的签到状态缓存（`CHECKIN_CACHE_MS = 10 * 60_000`）。老版本 Host 没有这两个
dep 时，首屏文档**省略** pool 段而不是回头去付那次昂贵读取。
### 测试
- 新增 `tests/issue77-fast-first-paint.spec.ts`（11 例）：首屏文档的上游调用数为 0、用的是 `current()`
而不是 `resolve()`、缺 dep 时省略 pool 段、`detail` 缺省/拼错一律退回完整文档。
- 新增 `tests/issue77-card-first-paint.spec.tsx`（3 例）：完整文档还在路上时账号行已经上屏、未拿到任何
文档时显示「正在加载账号」而不是「未登录」引导、迟到的首屏文档不会覆盖已在屏的完整文档。
- 全仓 **902** 例通过，0 skipped。
## 3.10.1 (2026-10-19)
> 「一键签到所有账号」下线。Trae 限制**每台设备每天只能签到一次**：本机任一账号签过之后，这个按钮
> 对整批账号在当天剩余时间里只能是灰的——一个永远点不动的控件，还得在下方专门写一句话解释它为什么灰。
> 单账号签到仍在名册表里，那才是能真正执行的入口。
### 变更
- **移除账号池动作行里的「一键签到所有账号」按钮**，动作行现在只剩「一键测试所有账号」。连带移除
批量签到的请求逻辑（`runCheckin`）、`busy` 的 `checkin` 态、签到进行中的状态行，以及只服务于这个
按钮的 8 个文案键（中英各一份：`poolCheckinAll` / `poolCheckingIn` / `poolLogCheckinStart` /
`poolLogCheckinClaimed` / `poolLogCheckinAlready` / `poolLogCheckinFailed` / `poolLogCheckinDone` /
`poolActionNoteCheckinDevice`），并删掉卡片里已不可达的 `checkin-unsupported` 409 分支。
- **单账号签到不受影响**：名册表（「Trae 账号」表格）的签到列仍按账号逐个签到，签到列的状态文字与
本机设备限制提示照旧。
- Host 侧 `?action=checkin` 路由与 `checkinSupported` 字段保留不删：浏览器里可能还有旧的 client
bundle 在调它，删掉会让它们直接 503。新卡片不再调用该 action。
### 测试
- `card-pool` 的批量签到用例改为断言按钮缺席：不再渲染 `poolCheckinAll`、不再出现「本机今日的签到
已用掉」提示行；同时保留「成员为空」「面板无免费模型」两条原因断言，确保这次删除没有顺带删掉测试
按钮的说明。全仓 **888** 例通过，0 skipped。
## 3.10.0 (2026-10-18)
> 本版把「账号在本机到底存了几份、删一个账号到底删掉了什么」讲清楚并做对：本机每个 Trae 登录都会
> 自动变成插件的一份副本，卡片只显示、也只使用副本；「删除」现在也真的落到 Trae 应用本身（连同它在
> `storage.json` 里的登录一起注销，改写前留备份、应用运行中则拒绝并点名）。另外修掉了一批让测速与
> 池子「看起来坏了」的问题：目标模型不在已启用列表时的假 4001、重启后立刻测速的 4001、一处点击
> 两条日志、一次整批等待才上屏。默认测试套件不再有 skipped。
### 新增
- **本机每个 Trae 登录都会自动变成插件的一份副本，卡片只显示、也只使用副本。** Trae 应用只有一个
登录槽，下次登录就把上一个覆盖掉；插件改为每次刷新（读账号列表）时把本机现有登录**镜像**成自己的
副本，因此换号不再丢号：已有副本的账号**不动**（副本里可能是插件刷新过、比应用更新的令牌）；没有
副本的本机登录**补建**一份，写进该区域自己的凭据文件；卡片与账号池只列副本，来源统一显示「插件副本」。
镜像在插件加载时就跑一遍（三个面板各一次），不必等用户点开那个面板。
- **一张卡片上同时支持多号**：登录 A 号后刷新 → 生成 A 副本；在 Trae 里换 B 号后刷新 → A 的副本仍在、
B 也生成副本，池子里两个号都能用。
- **设置区写明了「登录一个号就刷新一次」这条规则。** 卡片顶部的账号说明与账号池设置区都提示：Trae 只有
一个登录位，登录任意账号后要刷新一次（打开卡片或点「重新检测账号」），插件才会把这次登录保存成副本；
没刷新就换号，上一个账号不会被保存——它会被 Trae 里的新登录覆盖。设置区是一条警示框，因为漏掉这一步
的代价是静默丢号。
- **导出 / 导入也只针对副本。** 导出写出去的是**插件自己保存的副本**令牌（`copyOf`），不再从合并视图里
取 Trae 应用那一份；导入的账号一律作为**插件副本**写入本区域的凭据文件，不触碰 Trae 的
`storage.json`。界面文案同步写明「账号副本」。
- **账号池的每一行只有一个销毁动作：「删除」。** 原来的「移除」被整体撤掉——它只改成员草稿、不动本机
凭据，和「删除」并排出现时是同一个坑的两条岔路，用户反复把它当成「删不掉」。删除 = 插件副本 +
Trae 应用登录一起清（见下一条）。路由 `?action=remove` 与 `removeOne` 仍保留不删：浏览器里可能还有
旧的 client bundle 在调它，删掉会让它们 503；新卡片不再使用。
### 变更
- **「删除」现在也落到本机：连 Trae 自己那份登录一起注销，并留备份。** 上一版只删插件自己写的
`~/.dsh/.trae-auth.*.json`，可账号同时也登录在 Trae 应用里（桌面 `storage.json` 的
`iCubeAuthInfo://icube.cloudide`），Trae 每次都会把它再报上来，于是行永远回来。现在 `deleteAccount`
先删自己那几份，再改写各版本 `storage.json`（删掉该键、从 `iCubeAuthInfo://usertag` 里摘掉该
userId、其余键原样保留），为此 `decrypt.ts` 补了 `encryptTraeStorageValue` / `traeStorageValueType`
（同一套固定盐值 AES-128-CBC，与解密器互为逆运算）。
- **应用开着就不写**：Trae 把 `storage.json` 放在内存里、退出时回写，运行中改写一定会被覆盖。新增
`src/trae-process.ts` 的 `probeRunningTraeApps`（macOS/Linux 读 `ps`，Windows 读 `tasklist` 保守判定），
运行中的版本进 `blockedApps`，卡片写明「先完全退出 X 再删」——这是用户能自己执行的下一步，而不是
一个读不懂的失败。进程名互为前缀（`Trae` vs `Trae CN`），匹配按最长优先并消费已匹配项，否则只开
Trae CN 时会误报国际版在运行。
- **可回退**：改写前在同目录留 `storage.json.dsh-backup-<时间戳>`，写后回读校验，`encoded` 还在就
视为失败（可能被别的写入者覆盖）。
- 返回值扩展为 `{deleted, stillSignedIn, hadCopy, signedOutApps, blockedApps}`；`deleted` 的语义从
「插件不再持有」升级为「**本机任何地方都不再持有**」。`stillSignedIn:true` 时卡片不再谎报成功，
而是按 `hadCopy` 区分「已删副本但仍登录在 Trae 里」与「本来就没有副本，只存在于应用登录」。
- 删除的进行中态是瞬时 in-flight 集合（沿用「成功后按钮不能一直转圈」的教训）；设置落盘失败时报错且
**不**写成功日志——否则下一次刷新就把账号带回来，与日志互相打脸。
- **成员关系只有一个写者：卡片。** Host 侧的 `removeOne` 只忘掉这条测速记录（成员关系不在它那里），
卡片负责把 `regions.<面板>.pool.memberAccountIds` 落盘，写完读回校验；开关 / 目标模型 / 测试体积
一律按**已保存值**原样写回（它们是「改完要保存」的偏好，不该被一次移除顺带提交）。草稿的重置从
「整份设置一变就全量回滚」拆成**按字段**重置，因此这次落盘不会把用户正在编辑、尚未保存的开关或
目标模型悄悄改回去。
- **「派单中」只在池开启且这一行确实是池成员时显示。** 池子被清空时 Host 会故意回退到面板绑定的账号
继续计费，于是那个账号的 `current` 仍为 `true`，卡片照旧给它打上「派单中」，与同一屏上方「尚未勾选
任何池成员」互相打脸。手动模式（池关闭）下绑定就是答案，徽标照常显示。
- **无副本的残留成员行不再冒充正常账号。** 设置里仍保存、但本机已没有任何登录的成员（`reachable:false`）
原来有绿点和空白说明，读起来像「插件没建副本」。现在名字回退成 id、点变灰、带「本机无副本」标签
（`row.poolNoCopyTag`），一眼能认出是残留并点删除清掉。
### 修复
- **池子的「目标模型」不在已启用模型列表里时，测速会假报「上游不提供」。** Trae 把它答成
`4001 config_name rejected`，卡片再把它渲染成「所有已选成员当前均不可用」，于是每个账号都像是坏的。
根因是同一个模型在两套目录里各取一半：目标模型的下拉来自**完整**目录，而请求走的是**已启用**子集
（`enabledModelIds`）——子集里没有该模型的行，桥接层就拿不到它所属的 SOLO function，只能按默认
`solo_work_lite` 发送；`Doubao-Seed-Code` 只被 `solo_agent_remote` 收录，于是稳定的 4001。现在启动时的
wire 解析表**登记合并目录里的每一行**（`configName = wireConfigName ?? id`，并带上 `wireFunction`），
不再只登记「wire 名与显示 id 不同」的行；显示名回退按**先到先得**，避免同名（`Seed-Code`）互相覆盖。
桥接层另外在目录行只带 config_name、不带 function 时**从解析表借用 function**——仅当两边 config_name
一致，不一致时保留目录答案。
- **重启后立刻点测速不再 4001。** wire 表要等宿主刷新模型列表才会填上，这段时间里探针仍然只能按默认
function 发送。池子的「测速 / 一键测试」与「测试模型」现在在 wire 表未解析时先补一次目录发现：失败
不阻断，探针照旧报告上游的真实答案。
- **测速不再「卡住」：按行流式读取 + 3 分钟硬超时。** Host 的 `action=test` 本来就是一行一个账号的
NDJSON，卡片原来 `await response.text()` 才解析，等于整批跑完才一次性上屏；改 `testLinesOf()` 用
`response.body.getReader()` 边到边解析，每个账号测完立刻出现，`response.body` 缺失时回退 `text()`。
另外加 `TEST_TIMEOUT_MS = 180_000` + `AbortController`：连接被重启/断流吊住时（Host 重启后旧页面
开着的请求就是这种）按钮原来会永久禁用、只能刷新页面；现在到点自动取消、按钮恢复，日志给出
`row.poolLogTimeout`。
- **一次点击只记一条测速日志。** Host 的 `test` 流先逐账号推 `{row}`，末尾再推一份 `{rows}` 汇总重复
同样的行；卡片把两处都当新结果，于是一次点击出现两条「LaoDing：正常。」。现在按 `accountId` 去重，
第二次只刷新单元格、不再记日志（单号测速路径同样去重）。
- **移除之后按钮不再永远停在「移除中…」。** 移除成功后写下的标记，与按钮显示「移除中…」读的是同一个
状态，于是按钮从此一直是转圈的禁用态——点成功了也长得像点坏了。现在进行中的账号只在一个集合里停留
到本次请求结束，结束后按钮恢复。
- **幽灵成员没有存名字时不再渲染成空行。** 行名回退到它在设置里被索引的 id，用户才能找到并删掉那份副本。
### 构建
- **默认测试套件不再有 skipped。** 旧的 `tests/card-shot.spec.tsx` 是 `CARD_SHOT=1` 才跑的手动截图工具
（写 `/tmp/card-preview.html`、要靠 headless Chrome 量几何）。它被默认 glob 收集，导致 `pnpm test`
永远报 **1 skipped**，「全绿」因此不再等价于「全都跑了」。现移到 `tools/card-shot.tsx`（不匹配
`tests/**/*.spec.*`）、去掉 `describe.skipIf`、新增 `vitest.card.config.ts` 与 `pnpm card:shot`；
`tools/**/*.tsx` 纳入 `tsconfig.client.json`，仍受 typecheck 保护。
### 测试
- `auth` 两例锁定删除语义：① 「连应用登录一起删（并留下备份）」——断言 `signedOutApps:['cn']`、
插件副本与桌面登录都不再含该账号、目录里恰有一份 `dsh-backup`、之后再登录会被重新镜像；② 「应用
运行中拒绝并点名」——断言 `deleted:false` / `blockedApps:['cn']`、桌面文件原样、无备份、插件副本仍被删。
- 新增 `trae-process` 4 例覆盖进程名前缀歧义（只开 `Trae CN` 不误报国际版、只开 `Trae` 不误报 CN 等）。
- `solo-bridge` 3 例锁定 wire 表：给**每一行**都登记 function（含 id 即 config_name 的 `Doubao-Seed-Code`）、
同名显示名先到先得、目录行缺 function 时借用解析表的 function 且 config_name 不一致时不借。
- `card-pool` 覆盖：删除语义 9 例（无 `deleteSupported` 时不渲染删除、成功落盘与日志、`hadCopy` 两种
措辞、运行中提示退出应用且不写设置不刷新）、成员移除 6 例、徽标语义 3 例、流式与超时 2 例、日志去重、
幽灵成员名字回退、无副本行的标签。
- 全仓 **889** 例通过，0 skipped。
## 3.9.2 (2026-10-18)
### 新增
- **批量按钮被禁用时在行内说明原因**：「一键签到所有账号」「一键测试所有账号」变灰时，动作行下方
直接写出为什么——本机今日已签到 / 面板里没有可解析出的目标模型 / 一个成员都没勾。此前只是一个
不可点的按钮，看不出缘由。
### 修复
- **签到列不再渲染永远点不动的按钮**：已领取 / 本设备今日已用原本各带一个灰色死按钮，现在只留状态
文字；账号名册表同样处理（不可再签时渲染文字而不是禁用按钮），信息不丢。
- **池工具行与导入 / 导出区不再各印一遍标题**：两处原本都写了「导入 / 导出账号」，现在是同一行一个
标题加两个按钮，并去掉多余的分隔线。
- **放弃 / 保存的按钮尺寸**：不再套用行内小按钮的紧凑内边距，显式声明为与卡片其它按钮一致（高度
32px、13px 字），不再依赖某条规则「缺席」才正确。
### 变更（卡片外观）
- 池成员表下的勾选说明句删除；卡头补回 12px 下边距，表格分隔线不会贴着标题。
- 保存条改与模型区底部同款：左侧「鼓励一下 ★」，右侧放弃 / 保存；其下的面板说明文字删除（三面板
tab 已写明各自独立）。
### 测试
- 全仓 **849** 例通过（另有 1 例是 `CARD_SHOT=1` 才跑的截图用例，默认跳过）。新增：批量按钮禁用
原因 3 例、死按钮移除 7 例（断言「按钮缺席 + 状态文字在场」，含名册与池两张表），`card-checkin`
的 5 例改写为同样的断言方向。
## 3.9.1 (2026-10-18)
> **3.9.0 从未发布到 npm**（发版时卡在 OTP 认证），本版本是同一套账号池功能加上 tag 之后
> 的十三处修正与重排。功能面见下面的 3.9.0 段；这里只列 3.9.0 tag 之后的改动。
### 新增
- **测试请求体积**（`regions.<面板>.pool.probeInputTokens`，默认 `0`）：测速时向上游发多少
文本。`0` 是**一个词的最小探针**，其余选项 1 万 / 2 万 / 3 万 / 5 万 / 10 万 token。默认
保持最小而不是「像真实对话」——填多少就扣多少积分，插件没有证据说明 Trae 在小请求上会
误判，就不该让默认值替你花钱。老 Host 不认识这个字段时，卡片**不渲染这一行**（否则保存
必然读回失败）。
- **读余额前按需刷新 token**：单个账号的凭证过期后，读它的余额/签到/探针会先刷新一次
（同一账号并发只刷一次，失败时不重试而是返回旧凭证让上游如实 401）。此前只有「当前
绑定」的账号会被刷新，池里其他账号过期后余额永远是空的；现在读不到余额的行会明确标
「登录已失效」，而不是只显示一个 `—`。
### 修复
- **「本机今日已签到」是设备级事实，不是账号级**：Trae 的每日签到绑在 `x-device-id` 上，
同一台机器第二次签到必被 9095 拒。此前按账号记账，于是池表里第二个账号照样给一个「签到」
按钮——点了注定失败。现在任一账号当日已领即视为整台机器已用：其余行的按钮禁用、状态写
「本设备今日已用」，「一键签到所有账号」同样禁用并说明「一台设备一天一次」。
- **无签到面板的行列数错位**：表格换成四列时，行里仍渲染五个格子，动作按钮被挤到第二行。
- **绑定下拉里列出幽灵账号**：设置里存着、本机已无登录的账号没有凭证，选中后什么都不会
发生；现在从「手动选择计费账号」里剔除（仍留在成员表里可移除）。
- **刷新失败改为五分钟退避**：被吊销的账号每轮轮询都触发两次注定失败的上游刷新。
- **`tokenExpired` 只在真的读不到余额时上报**：不再出现「登录已失效」与有效余额并排。
- **药丸开关只作用于设置行**：它曾被写成全局 `.dsm-trae-switch input`，导致面板 tab 里的
开关也长成药丸；配色也改用能分清明暗的令牌（此前取到的 `brand-primary` 在浅色主题里近黑）。
### 变更（卡片外观）
- **池区块按参考卡片重排**：顶部只留动作行（一键签到 / 一键测试 / 重新检测），成员表自成
一张卡（卡头装「已选 N / M」+ 全选 / 清空），每格都是「主行 + 灰副行」，账号管理控件放进
虚线工具区，保存行移出设置盒并与「鼓励一下」同排。不再有第二张账号表重复同样的名字、
积分和签到状态。
- **一套尺度**：内边距 14 / 10，圆角 14（面）、10（面内的盒）、999（药丸），字阶 10–14，
区块用分隔线而不是再套一层框，同一行各格首行对齐。
- **成员状态写成字**：「已在池中」/「未入池」不再只靠勾选框表达；勾选框的 label 只包 input，
点账号名不会改计费对象。
### 测试
- 全仓 **841** 例通过（3.9.0 tag 时为 809）。新增：`tests/card-shot.spec.tsx`（用真实组件
渲染成静态页 + 几何审计 + Chrome headless 截图，`CARD_SHOT=1` 才跑，CI 零副作用）、
尺度守卫（间距变量、圆角白名单）、设备级签到的三条断言（含反向验证：改回按账号即失败）。
## 3.9.0 (2026-10-18)
> **账号池：多账号不再只是「列出来让你手点」。** 本机读完几个账号之后，可以打开一个
> **按规则自动选号、请求失败自动换号**的池（默认关闭）。此前多账号的全部能力止步于
> 「卡片把还有额度的账号列出来，你自己点一下切过去」——额度耗尽发生在一次对话中途时，
> 你只会看到一条失败，然后回去点按钮、再重发。这个版本把「谁付钱」变成一条可以委托给
> 插件的规则，同时**不偷偷替你换计费对象**：池默认关闭，打开它本身就是一次显式选择。
### 新增
- **账号池（逐面板，默认关闭）**：`enabled` / `targetModelId` / `memberAccountIds` 三个字段
落在 `regions.<面板>.pool`。名单是**显式 opt-in**（默认空，空名单意味着「谁都不服务」，
而不是「全员」）。
| 规则 | 为什么是这个顺序 |
| --- | --- |
| 先排除不可用 | `credential-rejected` / `plan-gated` / `not-found` 永久出池（这三种都不是「等一会儿就好」）；`rate-limited` / `out-of-credit` / `unavailable` / `failed` 在重试时间后回池；`model-busy` 用 2 分钟短时钟 |
| 再优先快到期 | 同样是额度，先花掉 3 天内会过期的那部分，否则它过期后等于没拿到 |
| 然后比可用额度、token 新鲜度 | 额度高者先；同额度取 token 更新者 |
| 最后按账号 id 兜底 | 排序必须是**全序**，否则卡片与路由器会在两行之间来回抖 |
- **失败换号（真实请求路径）**：一次请求最多试 3 个账号。只有**账号级**失败才换号
（`authentication` / `hard_credit` / `soft_rate` / `server`）；`not_found` / `client`
不换——模型 id 写错换号只会把同一个错误烧两遍，还会冤枉一个没机会服务的账号。换号
仍然失败时，错误消息尾部会带一句**为什么没有别的账号能接**（全部试过 / 剩余全被排除
+ 原因），而不是只留一个裸的上游错误。
- **实盘失败落盘**：换号过程中学到的结论以 `live-request` 探针写进
`$DSH_HOME/.trae-pool.<面板>.json`（0o600、原子写、永不抛错、**不存任何凭证**），
卡片能分辨「批量测出来的」与「真实流量告诉我的」。
- **卡片上的池区块**：成员表（草稿勾选框、状态点、当前计费徽标、在池标记、排除原因、
**通用积分**列并标注 Work 不可花、探针结论 + 相对时间 + 模型作用域、签到列只在支持的
面板出现、行内测速/移除）、幽灵成员（设置里存着但本机已无登录，仍渲染成可移除的行）、
「全部签到」与「全部测速」（NDJSON **逐行**返回，跑一个显示一个）、目标模型选择
（`''` = 自动挑免费模型；已下架的模型单独成一个选项并给「切回自动」按钮）、保存/放弃
草稿与未保存徽标、活动日志。
- **三条路由**：`POST /plugins/dsh-connect-trae/pool?action=checkin|test|remove`
（`test` 走 `application/x-ndjson`）。守卫：仅 POST（405）、仅环回来源（403）、池不可用
（503）、`action` 必须可解析（400）、`accountId` 必须是 24 位十六进制（400，且**在任何
写入或上游调用之前**校验——这个 id 会进文件名与凭证查找）、空池 409 区分 `no-members`
与 `no-live-members`、签到不支持的面板 409 `checkin-unsupported`（**在花掉一次只能失败
的请求之前**）。
### 修复
- **`checkinSupported` 按面板判定**：只有国内版有个人签到活动（国际版与企业版网关直接
404）。此前没有任何地方表达这件事，卡片只能靠「请求失败」来发现。
- **`toCredits` 补 `endpoint`**：Trae 的额度分 General（SOLO 聊天实际扣的）与 Work（够不到）
两个桶。池的排序与卡片显示统一用 **General**，此前只能拿到两桶之和——一个 Work 余额很
大、General 已空的账号会排在一个真能服务的账号前面。
### 测试
- 新增 **5 个文件 / 112 例**：`tests/account-pool.spec.ts`（56：排序全分支、出池规则、
冷却时钟、`billableMembers`、`resolveTargetModel` 的 stale 不给 id、批处理串行与流式、
9095 中止整批、落盘合并规则、`parseUpstreamResetAt` 无时区一律 undefined）、
`tests/account-pool-store.spec.ts`（20：往返/合并/按面板隔离/坏 JSON/版本不符/读时修补/
文件不含凭证/池文档组装与幽灵成员）、`tests/account-pool-route.spec.ts`（14：五种拒绝、
坏 id 时上游调用次数为 0、NDJSON 三行、409 两种空池、签到不支持时零次 claim）、
`tests/account-pool-failover.spec.ts`（12：轮转压倒绑定、清空恢复绑定、**refresh 落在被
轮转的账号上**、企业店拒绝个人轮转、shim 只在账号级失败换号、三次上限 + shortfall 文本、
池 hook 抛异常仍正常作答）、`tests/card-pool.spec.tsx`（10：草稿勾选→写 `regions`、
放弃还原、stale 目标、签到列按能力隐藏、NDJSON 增量渲染、幽灵成员可移除、**以及「区块里
每个 class 都真有样式规则」**——这条守卫此前只覆盖输入框读数，池区块曾在零 CSS 的情况下
通过全部行为断言）。
- 全仓 **823** 例通过（3.8.1 为 711）。
## 3.8.1 (2026-10-18)
> **signed-out 不再吞掉账号列表。** 2026-10-18 的现场报告是「本地突然刷不出账号了」：
> 绑定的账号 access token 过期、refresh 被上游 401，这本身是要重登的凭据问题；真正致命的是
> 卡片在 `signed-out` 状态下把整张账号表藏起来、只留一行状态——明明列表里还有一个可用账号，
> 屏幕上却一个都看不见，而唯一能自救的那一下点击（改绑另一个账号）在界面上不存在。
> 本版修复这条恢复路径。3.8.0 从未发布到 npm，所以本版即「3.8.0 全部内容 + 本修复」。
### 修复
- **账号面板 signed-out 时仍列出账号名册**（`src/client/TraeUsageCard.tsx`）：渲染门控从
`status !== 'signed-in' || accounts.length === 0` 改为 `status !== 'error' && accounts.length > 0`。
Host 在「有名册但绑定的账号用不了」时回的就是 `signed-out` + 原因 + 名册——三者同一条响应，
此前名册被状态丢弃。改绑完成后原因仍单独显示在表格下方一行，不再连带吞掉账号行。
### 测试
- 新增 1 例（`tests/card-accounts-table.spec.tsx`）：断言 signed-out 时原因可见、表头与两行都渲染、
已绑定行标为当前且不重复给按钮、**另一行的绑定按钮点击后确实写入 `accounts.cn`**。
变异验证：把门控还原成 `=== 'signed-in'`，恰好只有这一例变红。
- 全仓 **711** 例通过（710 + 1）。
## 3.8.0 (2026-10-18)
> **本版未发布到 npm**（tag `v3.8.0` 与 GitHub Release 已建、不可移动；发布被 npm 2FA 的
> PUT 401 挡住）。其全部内容随 3.8.1 一起上线，以下保留原文。
> **国内区多了一个面板：企业版。** 同一张 CN 凭据若属于 `tob_online` 租户，会被两个网关
> 同时服务——消费池扣个人积分，租户池扣企业额度。同一模型、两种付费方，所以「谁付钱」
> 必须由你选，不能由插件猜。同时修好 `config_name` 大小写导致的 `4001`，以及企业网关
> 用 HTTP 200 + `event:error` 拒绝时被当成「这轮助手什么都没说」的问题。
### 新增
- **卡片新增「企业版」面板**：供应商开关从「按区域」改为「按面板」，国内版、企业版、
国际版三者并列，各有**独立开关、独立账号绑定、独立模型选择**。
| 面板 | provider | 默认开关 |
|---|---|---|
| 国内版 | `trae` | 开 |
| 企业版 | `trae-enterprise` | **关**（原来两个面板的用户不受影响） |
| 国际版 | `trae-global` | 开 |
关掉企业版不会影响国内版；两个 CN 池的模型选择也不再互相覆盖。企业版默认关闭，
因为纯个人账号用不了企业池——默认放开等于给所有人塞一条一用就失败的 provider。
- **`trae-enterprise`（显示名「Trae 企业版」）**：现在 `cn` 区并列发布两个 provider：
| provider | 计费池 | 说明 |
|---|---|---|
| `trae` | 消费 SOLO | 行为与此前完全一致，永不碰企业网关 |
| `trae-enterprise` | 企业租户 | **不回落**，失败如实报错 |
`TRAE_PROVIDER_IDS` 描述每个区发布哪些 id，`routeOfTraeProvider` 把 id 映射到计费池；
**路由在构建 provider 的客户端时固定**，不存在「按调用猜一次」。shim 为每个 provider
提供一条 bearer 路由并按 bearer 分派，未知 token 直接 401，不会退回第一条路由。
### 修复
- **计费账号与卡片显示可能不是同一个（本版最重要的一个）**：`accounts()` 从**已经为展示
过滤过**的列表推导 `selected`，而 `current()` 从**全量**登录里解析真正计费的凭据。
开着 `hideTenantAccounts` 且企业号排序在前时，两者分歧——卡片高亮个人号，聊天扣企业池，
而卡片里的 `rescanAccounts` 还会把这个错误绑定**存下来**。现在 `inUse` 拆成两个入参：
显式绑定走全量（展示过滤不得缩小「用户选的号」的查找范围），无绑定时默认值走过滤后列表
（隐藏企业号是计费决定，不是展示细节）；`current()` 与 `accounts()` 传同一对参数，
结构上不可能再分歧，正在计费的账号也永不会被从列表里隐藏。
- **`deepseek-v4.1-flash` 等模型报 `4001`（`param is invalid`）**：网关的 `config_name`
**区分大小写**，而 Remote 目录给的是小写、网关只认 `DeepSeek-V4.1-Flash`。三处一起修：
1. `modelConfig` 补上 `wireConfigName`。DSH 设置通道用它重建文档，未声明的字段会在
**每次保存时被丢掉**——映射一丢，该模型就要等到下一次发现才能用。
2. `fetchModels` 改为从**客户端所钉的那条网关**读名录。两个池的名录不同
（`DeepSeek-V4.1-Flash` 只有企业池列），原本钉在企业池的客户端去读消费池名录，
永远发现不了自己池的独占模型。
3. `TraeSoloBridge` 查表改为大小写不敏感，映射都落空时退回目录行自己的 id。
- **企业网关的拒绝形态**：它是 **HTTP 200**，但首帧是 `event:error`（`code 4001`）。
现在会被转成真正的客户端错误，正常流则逐字节重放给调用方——否则拒绝会表现成
「这一轮助手什么都没说」。
- **企业网关要求每次调用带 `session_id`**，而消费网关会拒绝带它的请求体，所以只在该路由上加。
### 自测
- 企业版相关新增 **38** 项（`enterprise-provider` 17、`card-enterprise-panel` 9、auth 租户
作用域 4、web-status 过滤 3、catalog 费率 1、solo-bridge 错误码 1……详见 PR 描述第 3 节）。
覆盖按 bearer 分派、`session_id` 只在该路由、200/`event:error` 识别、流原样透传、
名录按路由读取、大小写映射与 schema 往返、租户账号作用域、4222 可读等。
- 计费一致性新增 2 例：`accounts()` 里 `selected` 的那一行必须就是 `current()` 计费的那个账号；
被隐藏的账号正在计费时仍须留在列表里。两例在修复前均变红（`expected 'tenant-user' to be 'personal-user'`）。
- 用真实 `tob_online` 帐号实测：企业路由返回 PONG、带 `session_id`、个人 `consumed_amount` 不变。
- 全仓 **710** 例通过，双 tsconfig 类型检查通过。
## 3.7.1 (2026-10-18)
> **对齐 DSH 0.2.1-rc.2，并把发布后核验收敛为一条命令。** 宿主 rc.1 → rc.2 对本插件消费的
> API 是**零变化**（逐字节核对确认），所以本版没有行为改动——它做的是两件事：把开发树钉到
> 用户实际运行的那份宿主上，以及让「npm 上的包是否等于 tag 指向的源码」不再依赖手工核对。
### 变更
- **对齐宿主 DSH 0.2.1-rc.2**：13 个 `@deepseek-ai/dsh-*` devDependency 从 `0.2.1-rc.1`
推进到 `0.2.1-rc.2`。`cordis` / `schemastery` / `pi-ai`（仍 `1.1.0`）均未变。
- **peer 范围无需改动**：`0.2.1-rc.2` 对 `>=0.1.7-rc.1 <0.3.0-0` 已判通过（实测）。
### 新增
- **`pnpm run verify:release`**（`scripts/verify-release.mjs`）：把 RELEASING.md 第 8 步
从手工核验变成一条命令，21 项检查一次做完 —— tag 版本、tag 之后的提交、工作树状态、registry 收录、
`latest` 指向、**发布包每一个文件**与 tag 逐字节比对、`lib/` 由 tag 源码重建后比对。
退出码即结论：`0` 一致 / `1` 不一致 / `2` 前置条件不满足。
> 手工版本的三个已知盲点被闭合：核对清单只写了 8 个文件而发布包有 15 个
> （`icons/`、`docs/assets/`、`scripts/verify-windows.mjs` 从未被核对）；
> 拿本地 `lib/` 当基准会掩盖「构建自未提交工作树」；`git show` 默认按 UTF-8 解码，
> 把 PNG 当文本会得到假的不一致 —— 本脚本第一版就踩了这个坑，三个图片文件全部误报。
### 文档
- RELEASING.md 第 8 步改为脚本优先，手工等价步骤保留在折叠区并注明其局限。
- **新增 `docs/PENDING_CHANGELOG.md` 暂存机制**：`CHANGELOG.md` 是随包文件，在已发布的 tag
之后改动它会让 `verify:release` 正确地报「tag 之后改动了发布内容」。未发布版本的条目因此
暂存在 `docs/`（`docs/*.md` 不进包），发版时并入 CHANGELOG 再删除。RELEASING.md 第 3 步
已加入对应指引。
### 测试
- `tests/dsh-peer-range.spec.ts` 的 `MUST_ADMIT` 补入 `0.2.1-rc.1` / `0.2.1-rc.2` / `0.2.1`。
此前这份「必须放行的版本」清单里**没有当前正在使用的版本**——范围若被误收窄到
当前宿主之外，测试仍会全绿。变异验证：把上界改到 `<0.2.1-rc.2` → 对应用例立刻变红。
- 新增 7 例（`tests/verify-release.spec.ts`），用 PATH 上的假 `npm`/`tar` 提供受控发布包，
子进程跑**真脚本**：一致→0、篡改→1、多出文件→1、无 tag→2、未发布→2、二进制逐字节比对、
tag 之后有提交仍→0。
- **变异验证**：把 `git show` 改回 UTF-8 解码 → 2 例变红；让比对恒返回「一致」→ 1 例变红。
- 全仓 **670** 例通过。
### 已核对确认无变化
- 逐字节比对插件消费的宿主包（`.d.ts` 与 `lib/*.js`）——`dsh-llm`、`dsh-llm-pi-ai`、
`dsh-settings`、`dsh-host-webserver`、`dsh-atomic-write`、`dsh-home-paths`、
`dsh-attachment`、`dsh-client-ui-renderer`，以及 `dsh-app-boot` 的 peer 门禁：**全部相同**。
- pi-ai 仍为 `1.1.0`，`openai-completions.js` 与 `utils/transcript.js` 未变，
上一轮的双向适配结论原样成立。
- 线上请求体探针在真实 rc.2 栈上复跑，结果与 rc.1 一致。
## 3.7.0 (2026-10-17)
> **对齐 DSH 0.2.1-rc.1。** 宿主把 `@earendil-works/pi-ai` 从 `^0.85.1` 抬到 `^1.1.0`，
> 这是 0.2 线里唯一有行为影响的变更。本插件的请求体**没有**回归——但那是靠 3.4.2 的双向适配
> 兜住的，本版把这条结论从「推理」变成「被测住的对照」。
### 变更
- **开发树对齐宿主实际随包版本**：13 个 `@deepseek-ai/dsh-*` devDependency 固定为 `0.2.1-rc.1`，
`cordis` → `^4.0.5`，`schemastery` → `3.18.5`（`pnpm-workspace.yaml` 的 override 同步抬升），
`@earendil-works/pi-ai` → **`1.1.0`（精确固定，不用 `^`）**，使本地 typecheck 与测试
跑在与用户**字节一致**的契约上。
- **`@earendil-works/pi-ai` peer 上界收窄为 `<2.0.0`**：原先 `>=0.85.1` 无上界，会默默放行
未审阅的 2.x。两端均已实测（0.85.1 ✅、1.1.0 ✅、1.3.0 ✅、2.0.0 ❌）。
### 修复
- **pi-ai 1.1.0 的类型契约**：1.1.0 把 `ProviderStreams` 的第二参改成带 `unique symbol`
品牌标记的 `TranscriptContext`，只有 `normalizeContext()` 能产出，于是 `withContextAdaptation`
在两处调用点报 `TS2345`（升级后才暴露，0.85.1 下类型可通）。适配层本来就在归一化器
**下方**、且旧代分支**必须**产出无品牌形状，所以在这唯一一条边界上做显式转型，
并在 `src/adapter.ts` 与测试侧 `send()` helper 处写明理由。
### 测试
- 新增 **线上请求体矩阵**（`tests/pi-ai-context.spec.ts`）：起一个真实 SSE 端点，走
`createProvider` + 真实 `openAICompletionsApi()`，断言线上 body 里 `roles[0] === 'system'`、
system 文本等于原提示、`tools` 长度为 1；并覆盖「已归一化输入不二次包裹」的幂等性。
- 新增 **反向对照**：**不**套适配器时，现代副本会把提示与工具全部丢光（`roles: ["user"]`、
`system: null`、`tools: 0`，且**不报错**）——这条钉住适配器为什么是承重的。
- 全仓 **663** 例测试通过（原 660 + 3），双 tsconfig 类型检查通过，构建通过。
### 已核对、无需改动
- **peer 范围**：DSH 用 `satisfies(runtime, range, { includePrerelease: true })` 求值且只校验
`@deepseek-ai/dsh*`，`0.2.1-rc.1` 对 `>=0.1.7-rc.1 <0.3.0-0` 已判通过（实测）。预发布悬崖
只在**默认选项**下成立，不适用于本插件的门禁。
- **宿主 API**：`dsh-llm` / `dsh-settings` / `dsh-host-webserver` / `dsh-llm-pi-ai` 消费点签名未变。
- **客户端外壳**：产物仍只 `require` react / react-dom / react/jsx-runtime，槽位与主题令牌未变。
## 3.6.1 (2026-10-16)
> **「自动续期」不再是一句没有期限的承诺。** 卡片现在会告诉你**刷新令牌**何时到期 ——
> 在那之前访问令牌会自动续期，在那之后自动续期就彻底停了，必须重新登录一次 Trae。
### 修复
- **刷新令牌的到期时间对用户完全不可见（issue #37 追问引出）**：
- **问题**：卡片一直只写「访问令牌 {时间} 过期（自动续期）」。这句话是对的，
而且一直对 —— 直到**刷新令牌**到期的那个瞬间，自动续期就永久停止了。
一个读了几个月「自动续期」的用户，没有任何理由预期这件事。
- **根因**：刷新令牌的到期时间**被解析了、也被存下来了，但从来没送到浏览器** ——
状态接口里根本没有这个字段，所以卡片无从显示。
- **现在**：状态接口暴露刷新令牌到期时间，卡片**按账号**在临近到期时给出一行提示：
- 剩余 **30 天**以内 → 提醒（警告色），写明**到期时间**与**还剩几天**；
- **已到期** → 明确说明「自动续期已停止」，并给出恢复方式（重新登录一次 Trae）；
- **还很久 / 没有该字段**（CLI 凭据本身不带）→ **不显示任何东西**。
健康的令牌不该在每一行都占一行文字，伪造的期限比不显示更糟。
> 这条不是理论问题：我们在排查 `#38` 时**亲身遇到过** —— 某区域插件自存的凭据访问令牌已过期，
刷新也返回 401，而卡片上一直写着「自动续期」。当时只能靠人肉发现。
### 测试
- 新增 5 例覆盖三种状态与两个边界（健康不显示、临近显示截止日与剩余天数、已过期显示错误态、
无该字段不伪造、最后一天仍算「未过期」）。
- **变异验证**：去掉 30 天提醒窗口 → 2 例变红；在缺少字段时伪造一个期限 → 1 例变红。
- 全仓 **660** 例测试通过，类型检查通过。
## 3.6.0 (2026-10-16)
> **多个账号可以并存了。** 本版新增**账号导入 / 导出**：不再需要每次把某台机器的登录凭据
> 手工写进默认路径来顶掉上一个账号 —— 导出一份 JSON、在另一处导入即可。同时补上
> `#39` 那条诊断：上游没下发 function 配置时，报错不再读起来像本地故障。
这是一次 **minor** 升级（新增用户可见的界面与能力）。
### 新增
- **账号导入 / 导出（issue #37）**：账号区新增一行「导入 / 导出账号」，
- **导出**：勾选若干账号 → 下载一个 JSON 文件（`trae-accounts-YYYY-MM-DD.json`）；
- **导入**：选择文件 → **脱敏预览**（只显示账号标识与「是否有 Token」，不显示凭据）→ 勾选 → 导入；
- 文件格式与同族 `dsh-connect-workbuddy` **互通**（顶层 snake_case：`access_token` / `refresh_token` /
`uid` / `nickname` / `domain` / `expiresAt`(毫秒) / `refreshExpiresAt` / `auth_raw`），
所以两边导出的文件可以互相导入。
- **顺带把存储升级成多账号**：本插件原先每个区域只保存**一个**凭据，导入的第二个账号无处可放。
现改为**每区域一个文件保存凭据数组**（格式版本 1→2），**旧文件仍可读**、在下一次写入时自动升级。
- 导入按钮在**未登录时也可用** —— 一台从没登录过的机器，正是最需要导入别处导出的文件的时候。
> **区域门禁是正向匹配**：导入文件里的 `domain` 是文件作者可控的值，而本插件「认不出就当作国内版」
> 的规则对**上游下发**的数据是对的、对**导入文件**是危险的（伪造域名会被塞进国内版）。
> 因此导入走一条**只认正向识别**的通道：空值、认不出的值、以及明确属于另一区域的值一律**跳过并计数**，
> 绝不静默落库。国内版与国际版是两个并行的供应商栈，跨区导入会导致跨区计费。
### 修复
- **修复一个会导致账号丢失的写入缺陷（本次实现导入功能时发现）**：本插件的刷新路径原先把
「刚刷新好的那一个凭据」当作**整个文件**写回。在单凭据时代这没问题；一旦一个区域能保存多个账号
（正是导入带来的），**刷新一个账号就会把同区域的其他账号全部删掉**。
已改为**读-改-写**：只替换被刷新账号自己那一条，其余条目原样保留。回归测试专门钉住了这一点。
- **上游未下发 function 配置时，报错读起来不再像本地故障（issue #39）**：
- 报告者遇到的现象是每次调用都返回 `2001 no function config found for appId=…`，
他据此排查了一圈本地凭据与插件版本，最后才发现问题在服务端 —— 上游的
`get_detail_param` 当时对**每个** SOLO function 都返回空的 `config_info_list`，随后**自行恢复**。
- 现在（a）`2001` 有了明确文案：**「上游尚未下发本通道的 function 配置（这是上游侧的状态，
不是本地凭据或配置问题）」**；（b）当**所有** function 都返回 200 却一条配置都没有时，
目录读取会抛出专用的 `TraeEmptySoloDirectory`，把「上游没下发」与「所有 function 都请求失败」
区分开。两者都不暗示需要重新登录，因为这个条件是**会自行恢复**的。
### 测试
- 新增 4 个测试文件、共 34 例：导入导出格式（解析 / 脱敏预览 / 往返 / 区域门禁）、
导入路由（HTTP 边界上的伪造区域拒绝、导入前重新解析文件而非信任预览）、
存储升级与**刷新不吞账号**、以及端到端的「一处导出 → 另一处导入」。
- 区域门禁做了**变异验证**：把门禁改成 fail-open（正是同族插件 `#42` 修过的那个缺陷）后，
格式层与路由层**各有用例变红**；把毫秒单位改成错误的换算同样被抓住。
- 全仓 **655** 例测试通过，类型检查通过。
## 3.5.1 (2026-10-16)
> **DeepSeek-V4 四个模型行不再必然报 4001。** 本版修一处 wire 名单合并的方向错误：
> 同名的多行里，旧代码让**最后**一行取胜，于是一个元数据残缺的小写尾行抢走了展示名，
> 桥接层把 `config_name` 改写成了上游不认的小写拼写。改为**每张映射表先到先得**后，
> 规范行留在原位，不再发生任何改写。
### 修复
- **DeepSeek-V4 四行（`DeepSeek-V4-Flash` / `-Flash-Official` / `-Pro` / `-Pro-Official`）选中发送必报 4001**（issue #38）：
- **上游名单的形状**：CN 区 wire（`get_detail_param`）把同一族列了**三行**，共享同一个展示名，其中尾行是
元数据残缺的小写行 —— `DeepSeek-V4-Flash` 展示名同时对应 `DeepSeek-V4-Flash-Official`、
`DeepSeek-V4-Flash`、`deepseek-v4-flash` 三个 id；`DeepSeek-V4-Pro` 完全同构。
- **改坏它的那一步**：`mergeTraeModelSources` 用 `wireByName.set(...)` / `wireById.set(...)`
**无条件写入**，所以后到的那一行会覆盖先到的同名键。尾行的 `name` 正好是小写 id，
于是 `displayKey("DeepSeek-V4-Flash")` 被它抢占，桥接层据此把 `config_name` 改写成
`deepseek-v4-flash`，上游回 `4001 the param is invalid`。
- **为什么 `-Official` 行也一起废**：`TraeSoloBridge` 在 catalog 取不到 `wireConfigName` 时
会退回 `wireResolver(entry?.name)`，而 `entry.name` 同样是 `DeepSeek-V4-Flash`，
于是又落到那一行上 —— **两行一起废**。
- **修法**：两张映射表都改成**先到先得**（`if (!map.has(key)) map.set(...)`）。
`displayKey("DeepSeek-V4-Flash")` 于是命中 id 完全相同的规范行，该行的 `config_name`
本就是 `DeepSeek-V4-Flash`（与展示名一致），**不再发生改写**。
- **本机 CN 实测**（插件真实请求形状 `{messages, model, config_name, function, stream}`）：
- 修前：`DeepSeek-V4-Flash` → 发出 `deepseek-v4-flash` → 流内 `4001`；`DeepSeek-V4-Pro` 同；
- 修后：四行发出 `DeepSeek-V4-Flash` / `DeepSeek-V4-Pro`（`-Official` 两行发出自身 id）→ **HTTP 200 + 完整正文**；
- 对照探测：大写能通、小写必 `4001`，`glm-5.2` 作基线正常 —— 证实「号码牌本身是好的，是被改写坏的」。
> 注意：`4001` 是**流内** `event:error`（外层 HTTP 仍是 200），所以只看状态码会把它误判成成功。
### 测试
- 新增 2 例回归：`mergeTraeModelSources` 在「同名 + 尾行小写」的 wire 上必须让规范行取胜；
以及「按展示名 join」在改为先到先得后仍然生效（防止过度修正）。
两例在旧代码上均失败、在新代码上通过。
- 全仓 **619** 例测试通过。
## 3.5.0 (2026-10-14)
> **积分读数不再只有一个固定位置。** 本版向同族 `dsh-connect-workbuddy` 学来它的 issue #62
> 修法：把「读数显示在哪里」做成每个区域一个选项，默认值与升级前完全一致。
### 新增
- **输入框读数的显示位置可选：输入框工具栏 / 输入框下方**（学自 `dsh-connect-workbuddy` issue #62）：
- **为什么需要**：那个位置本身是脆的。`conversation.input.left`（输入框工具栏）是一个**共享的 list 插槽**，
外壳自己的控件和**任何其他 bundle** 都注册在那里，而 list 插槽**无法保证每个占用者都可见** ——
同族的报告者装了第三方插件（`dsh-auto-continue`）之后，积分读数就**整个消失了**。
本插件其实已经因为这个原因丢过一次这行读数：它早年放在**侧边栏底部**，那是一个共享的**根级行**，
与 `dsh-connect-workbuddy` 的两行并排时被挤成只剩一个「Tr」的残片（2.12.0 才迁到输入框工具栏）。
**同一个坑踩了两次，这次把位置交给用户。**
- **两个席位**：
- `composer`（**默认**）—— 输入框工具栏 `conversation.input.left`，与模型选择同一行，即现在的样子；
- `stats` —— 输入框下方 `conversation.composer.dock`，外壳自己渲染「轮次 / 步数 · tok/s · token ·
缓存命中」那一行；`order: 10` 排在 shell 统计**之后**，所以官方那几颗统计仍在最左，读数是**追加**而不是顶替。
- **判定顺序：归属 → 区域开关 → 显示开关 → 席位。** 席位排在**最后**，所以一个被关掉的区域在
**两个席位都不渲染**，而不是先在非当前席位画一帧再被拒。
### 修复
- **区域被关闭后，它的积分读数仍在输入框工具栏里渲染**（本次移植时由新守卫发现）：
- 把某个区域的供应商关掉时，Host 会把该区域的 adapter 路由与可配置供应商条目**一并撤下**，
模型选择器里也不再有它 —— 但 gate 只检查了「显示积分」那个开关，**从未检查区域开关**。
于是一个已被关闭的区域只要模型投影还指着它的 provider，读数就会继续画在那里，
并且它的取数请求注定失败。
- 现按 Host 的同一套 opt-out 规则（`regionEnabledOf`：只有显式 `false` 才算关闭）在 gate 里补上这一判。
这与卡片上那个区域开关**用的是同一个 reader**，所以卡片和 gate 不可能对「这个区域开没开」产生分歧。
- 同族的 gate 一直有这一判，是本插件漏了。
### 设计取舍（两条，都写下来免得后人改回去）
- **两个席位都无条件注册，决定权在 gate 里一处**（席位不符就 `return null`）。
若改成「按设置只注册当前席位」，则每次改设置都要**重新注册插槽** —— 而本仓库的文件头已经写明
这种绑定是脆的（rc.6→rc.7 的 `id`/`order` → `key`/`priority` 改名就是同类问题），
且用户是「一边看着结果一边改」的。现在改设置只是一次 settings 写入。
- **卡片控件读的是设置文档，不是 Host 的 usage 应答**（这里**故意与同族不同**）。
同族那样做是因为它的 0.1.7 部署上浏览器设置镜像**实测是过期的那份**；本仓库没有复现到这种过期，
而读镜像才能让控件**首帧就是对的** —— 只靠 usage 文档喂值的控件会先停在默认值上等一次网络往返，
这正是「看起来没生效」的观感。这一点有守卫钉住（见下）。
### 测试
- **+19**（全仓 **598 → 617**）：
- `tests/credit-position.spec.tsx`（新增 13 例）：默认 `composer`（含设置存在之前的 profile、
手改的未知值 `'sidebar'`）；**按区域**而非全局读取；整段设置与裸 `regions` 映射两种入参都接受
（传错形状在本卡片上真的出过货）；写入只改该区域该字段（模型列表 / 预算 / enabled / 兄弟区域都不动）；
席位与两个开关相互独立；gate 在**指定席位渲染 / 另一席位渲染 0 个 / 两个席位都不渲染（隐藏或区域关闭）/
别的 provider 两个席位都不渲染 / 按会话所指区域取席位（CN 与 AI 各在各自席位）**；
以及 Host 侧 `creditPosition()` 与浏览器侧 `regionCreditPositionOf()` **两边答案一致**（含 schema 默认值）。
- `tests/card-composer-credits-switch.spec.tsx`（新增 6 例）：控件默认值、**跟随标签页切换**
（按区域而非一个全局值）、写入是**整槽合并**（不丢模型选择、不动另一个区域）、
区域关闭时**禁用而不是隐藏**（控件消失会读成功能没了）、与显示开关相互独立（隐藏后仍保留所选席位）、
只读 scope 拒绝写入。
- `tests/client-activation.spec.tsx`（更新 2 处 + 新增 1 条断言）：插槽清单由 3 个变 4 个，
并**钉住两个席位的 slot id 互不相同** —— 两个注册共用一个 id 会让后一个静默替换前一个，
于是设置能选到一个已不在册的席位、读数反而彻底消失（正是本特性要修的那个缺陷）。
测试替身原先只认 `key` 字段，现在同时认 `id`/`key`（真实的 0.1.7 注册表两者都用），
否则一条关于 slot 身份的新断言会静默读到 `undefined` 而假绿。
- **变异验证**（各自变红后恢复）：删掉 gate 的席位判定 → 4 例红；把读取的默认值去掉（升级前的 profile
读成 `undefined`）→ 4 例红；只注册一个席位 → 2 例红；控件不读所存席位 → 2 例红。
- 构建产物核对：`lib/client.js` 内两个插槽名与两个 slot id 均在。
## 3.4.3 (2026-10-13)
> **保存模型列表时终于有了「正在进行」的反馈。** 本版对齐同族 `dsh-connect-workbuddy` 4.4.2
> 对忙碌遮罩做的修正（该处修的是同族共有的缺陷），并把当初核实过的依据一并带过来。
### 新增
- **保存 / 写设置时有一层忙碌遮罩**（新增 `src/client/BusyOverlay.tsx`，共用组件）：
- **此前完全没有。** 保存状态只表现为控件变灰加按钮文案从「保存」变「保存中…」——
用户盯着某个具体行等它落地时，屏幕上没有任何「正在进行」的迹象。
- 遮罩由卡片的**两条**写路径共同驱动：`saveModels` 的 `saving`（保存模型列表）与
`writePreference` 的 `savingSettings`（跟随登录 / 输入框读数两个开关）。
- 遮罩在该写路径的 `finally` 里随忙碌标记一起落下，也就是 **Host 重读落地的时刻**——
延迟从「看不见」变成「看着它发生」。
### 修复
- **遮罩的配色与动效改用宿主自己的令牌与节奏**（对齐同族 workbuddy 4.4.2）：
- **遮罩卡片底色**若沿用同族的旧值 `--dsw-alias-bg-primary`，那个变量**在宿主令牌集里根本不存在**
（实测宿主 bundle 零命中；宿主只有 `bg-base` / `bg-layer-1..3` / `bg-module-platform` / `bg-overlay` 等），
于是一路回退到写死的近黑 —— 卡片变成一块黑板子，上面的字看不清。现改用宿主给弹层用的
`--dsw-alias-bg-layer-2`，亮暗两套主题各自成立；阴影也从手写的 drop shadow 换成宿主的
`--dsw-elevation-prominent`。
- **遮罩底色**原写死 `rgba(0,0,0,.38)`，既不跟随主题、也没有宿主的模糊。改用宿主自己遮罩用的
`--dsw-alias-bg-mask-1`（亮 `.24` / 暗 `.5`）+ `--dsw-mask-blur`，与外壳里其他遮罩一致。
- **提示行**用 `label-secondary` —— 原先的 `label-tertiary` 是宿主最暗的一档
（亮 `neutral-bluish-600`、暗 `neutral-bluish-400`），给元数据用的，不该承载一句要等的人必须读的话。
- **spinner 换成宿主同款弧线**。此前那种 18px 的 CSS border 环、`.7s` 匀速转，比宿主自己的状态
转圈（`_dsh-state-dot-spin`：SVG 弧线 + dash 呼吸、`1.5s`）快了近一倍 —— 比起形状本身，
**这个速度差才是它看着廉价的主因**。现按宿主 bundle 实测到的几何逐条对齐：
`viewBox 0 0 20 20`、`r=8`、`stroke-width 2`、track `opacity .25`、弧线 `stroke-dasharray 12 150`
与 dash 呼吸、`1.5s`、`currentColor` 继承所在层级；reduced-motion 降级为**静态弧线**
（与宿主降级方式一致），并补 `aria-hidden`，免得 `role="status"` 之外多报一次。
### 测试
- **+4**（`tests/card-styles.spec.tsx` 5 → 9，全仓 **594 → 598**）：
- 遮罩选择器守卫：逐条钉住五个遮罩规则，且要求整条 `{` 结尾匹配，避免改名前缀后被子串误判为存在。
- 弧线节奏守卫：钉住 `dsm-trae-veil-dash` 关键帧与 reduced-motion 降级，防止退回到自绘 border 环。
- **渲染守卫（唯一能证明「遮罩真的出现」的断言）**：jsdom 不做层叠，前几条都只证明样式表里有这些
名字。这条在 `scope.set` 挂起的条件下点「跟随 Trae 当前登录的账号」，断言遮罩确实进 DOM
（`role=status` / `aria-busy=true` / `aria-live=polite`）、文案为 `row.veilSaving`、弧线与卡片都在，
写盘落地后卸载。
- 令牌白名单补三条（`--dsw-alias-bg-mask-1` / `--dsw-mask-blur` / `--dsw-elevation-prominent`），
三者均经宿主 bundle 实测存在。白名单断言「大小必须等于实际用到的令牌数」，遮罩引入新令牌后必须同步补齐。
- 变异验证（各自变红后恢复）：把 `.dsm-trae-veil{` 改成 `.dsm-trae-veilz{` → 仅选择器守卫变红；
把 `visible={saving || savingSettings}` 改成 `visible={false}` → 仅渲染守卫变红。
- **一处诚实记录，不夸大守卫能力**：本仓库的 `vite/oxc` 与 `tsdown` 比 workbuddy 严格，模板字符串被
反引号截断后会**直接报解析错误**（构建同样失败），所以「顶层语句数」那条截断守卫在本仓库
不会比它们更早报警。真正拦不住截断的是 `tsc`（实测被截断的文件 `tsc` 仍 `exit 0`）——
这正是同族当初能静默中招的原因。那条守卫作为「解析器不再拦时的兜底」保留。
### 文档
- 无。本版只含上述新增、修复与配套测试。
## 3.4.2 (2026-10-13)
> **插件现在与它自己解析到的那份 `@earendil-works/pi-ai` 代数对齐了**——这是 [issue #27](https://github.com/dingminhua/dsh-connect-trae/issues/27)
> 的修复。起因是报告人用任意模型都拿到 `PI_AI_ERROR / Cannot read properties of undefined (reading 'length')`，
> 且 usage 恒为 0：崩溃发生在**请求发出之前**的本地 token 估算里，所以既与模型无关，也看不到任何 HTTP 痕迹。
> 取证见 `docs/ISSUE27_DIAGNOSIS.md`。
### 修复
- **插件现在会在两种上下文形状之间双向适配，而不是把宿主的形状原样交给自己的 api**（issue #27）：
- **原行为**：`createTraeAdapter` 把 `openAICompletionsApi()` 直接交给 `createProvider`，没有任何适配层。
插件声明 pi-ai 为 peer（`>=0.85.1`），所以它解析到哪一份**由安装环境决定**，未必是宿主那一份。
- **为什么这是必崩**：pi-ai **0.86 起**在每个公开入口调一次 `normalizeContext()`，于是 provider 收到的是
*归一化 transcript*：`{ messages: [ { role:'system', content:<字符串>, toolsAdded }, … ] }`——系统提示与工具声明
**只**挂在这条 system 消息上，顶层 `systemPrompt` / `tools` 已被删除。而 ≤0.85 的 `estimateMessageTokens`
**没有 `role === 'system'` 分支**：它 `for (const block of message.content)` 迭代一个**字符串**，逐字符拿到
`block`，再读 `block.name.length` → `TypeError`。因为这一步位于 `buildBaseOptions` 内、早于任何 HTTP 构造，
所以现象就是「105ms 内本地崩溃 + usage 恒 0 + 换模型无效」。
- **两个方向都要修**，因为 **DSH 自己也横跨两代**（`dsh-llm-pi-ai` ≤0.2.0-rc.1 声明 `^0.85.1`，0.2.0-rc.2 起声明
`^0.87.1`，0.2.1-alpha.2 已到 `^1.0.2`），而本插件声明支持 `>=0.1.7-rc.1 <0.3.0-0`：
- **新宿主 + 旧库**（issue #27 本尊）：必崩。
- **旧宿主 + 新库**：不崩，但现代 api 只从 system 消息读提示与工具，顶层字段被**静默忽略** → 系统提示与
**全部工具声明**丢失（模型永远不会产生 toolCall）。只修前者会把一个响亮的故障换成一个安静的故障。
- **改后**：新增 `withContextAdaptation(api, generation)`，按**本插件自己解析到的那一代**决定折返方向；
两个适配函数都以**形状**做幂等短路（普通路径返回同一个对象，零分配）。
- `adaptLegacyPiAiContext`（transcript → 旧形状）：把 system 文本提升为 `systemPrompt`，并把
`toolsRemoved`/`toolsAdded` **按序回放**成顶层 `tools`——工具那一步不能省，`normalizeContext` 之后它是
工具声明的**唯一**载体。
- `adaptModernPiAiContext`（旧形状 → transcript）：把 `systemPrompt`/`tools` 提到一条首部 system 消息上，
并移除顶层字段，避免后续的形状判据误判。
- **提示文本的三条载体都要搬，`sections` 不能漏**：新代 `SystemMessage` 的提示文本有 `content` 与
`sections` 两条载体（`Record`），库自己的 `getSystemMessageText` 是
「`content` + 全部非 null section」按空行连接。只读 `content` 会让以 section 形态到达的提示整体折成
`undefined`——与该适配器要防的「静默丢失」完全同类。现已逐字对齐库的语义（`content` 在前、
按声明顺序接 section、跳过 `null`）。
- **折上的语义与 `normalizeContext` 逐字对齐，包括「混合形状」**：当上下文**同时**带顶层字段和
system 消息时（部分归一化的宿主），pi-ai 自己的做法是**前插**（于是有两条 system 消息，provider 再按
空行折叠），本插件因此同样前插。实测该输出经真实 0.87.1 的 `resolveTranscript` 折叠后，与
`normalizeContext` 的结果**逐字相同**。早先版本在混合形状下直接原样返回，会静默丢掉顶层提示与其
工具——这条是评审的变异测试暴露的（见「测试」）。
- **代际判据落在 0.86，不是 0.87**（issue #27）：
- 报告与兄弟插件的既有实现都按 `>= 0.87 → modern` 划分。实测**真实边界是 0.86.0**——
`dist/utils/transcript.js`、`normalizeContext`、估算器的 system 分支、以及「不再读 `systemPrompt`/`tools`」
四件事**同时**出现在 0.86.0。
- **为什么这个偏差有害**：若插件解析到 **0.86.x**，`>= 0.87` 的判据会把它当旧代而执行折返，而 0.86+ 的 api
根本不读顶层字段 → 系统提示与全部工具被静默丢弃。即「照抄现成实现」反而会引入一个新的静默故障。
- **新增 `src/pi-ai-runtime.ts`：世代探测不依赖版本号字符串**（issue #27）：
- 主判据是解析到的那份包 manifest 的版本，用**数值**比较（`major > 0` 或 `minor >= 86` 即现代），
因此 `0.9.0` 不会被误判为高于 `0.86.0`，已发布的 `1.x` 也无需改动即可正确归类。
- 版本读不到时退化为**包布局**判据（`dist/utils/transcript.js` 是否存在）。
- **刻意不使用 `import.meta.resolve()` 做能力探测**：bundler 风格的解析器（vite，以及在它之上的 vitest）
会把 exports map 里的 `"./utils/*"` 通配符展开成路径**并直接返回，不检查文件是否存在**，于是对 0.85.1
也回答「有」——实测该假阳性会把 0.85.1 判成 modern，从而**在声称按能力判断的同时放过 issue #27**。
读包目录则不会被这样骗过。
- 解析不到 pi-ai（宿主外探测的市场安装）时取 `modern` 透传：每个做归一化的宿主都同时提供现代代，
且透传不可能破坏一个本来就正确的上下文。
### 诊断
- **启动时打印解析到的 pi-ai 版本与代数**（issue #27）：混代安装是「安静坏掉」的那一类，日志里一行
`dsh-connect-trae: pi-ai 0.85.1 (legacy generation)` 让它在下次出现时立刻可见，而不是只表现为一次崩溃。
### 测试
- **全仓 549 → 594（+45）**：
- `tests/pi-ai-context.spec.ts`（38 例）：代际判定（含 0.86/0.87 边界、数值排序、`1.x`、不可读版本）、
`decidePiAiGeneration` 的三条分支（含本机**永不可达**的「什么都没探测到」——市场安装的默认答案，
必须显式钉住）、折返（提示提升、**工具提升**、`toolsRemoved`/`toolsAdded` 顺序回放、既有顶层 `tools`
权威、空文本 system 消息只丢文本不丢工具、文本块、**`sections` 三条载体**、混合形状、畸形输入）、
折上（提升、移除顶层字段、幂等、空提示、**混合形状前插**）、
`withContextAdaptation`（两个入口都适配、同形状透传为**同一对象**、保留 `fetchDeferred` 等其余字段），
以及**对真实解析到的那份 pi-ai 的集成对拍**：`estimateContextTokens` 不抛错、`convertMessages` 后
`messages[0].role === 'system'` 且 `tools` 仍在。
- `tests/pi-ai-adapter-wiring.spec.ts`（7 例）：**接线层**用例。上面那批函数级用例在把适配层从工厂里删掉后
**依然全绿**（已用变异验证），正是「函数没问题、只是没人调用」这一原始缺陷的形状；本文件 mock 掉
`openai-completions.lazy`，经 `adapter.current() → piProvider → streamSimple` 走真实装配路径断言交付给
api 的形状。
- **变异验证 8 次，8 次全部被抓**（①–⑤ 为自查，⑥–⑧ 由独立评审提出）：
① 工厂里移除适配层 → 5 例失败；② 折返只搬 prompt 不搬 tools → 6 例失败；③ 边界写成 `>= 87` →
1 例失败；④ 折上时不移除顶层字段 → 2 例失败；⑤ 折返不做幂等短路 → 5 例失败；
**⑥ 折返忽略 `sections` → 2 例失败**；**⑦ 折上跳过多 system 消息的混合形状 → 1 例失败**；
**⑧ 不可探测时默认 `legacy` → 1 例失败**。恢复后 57 文件 594 例全绿。
- 确认新增用例真的在跑：改动前基线 **549**、改动后 **594**，净增 45，与新增用例数一致。
### 独立评审
发布前由独立评审对 diff 做了对抗性复核（真实发布包 + 真实 api 模块），确认：双向四组合均不丢提示、
不丢工具、不重复 system 消息；**0.86 边界**在 0.85.1/0.86.0/0.86.1/0.87.1/1.0.2 五个真实 tarball 上
逐项复核成立；**`import.meta.resolve` 的假阳性被独立复现**（该模块在 0.85.1 磁盘上不存在，vite 仍返回
其 URL）；接线层用例确实覆盖工厂路径。
评审同时提出 **3 条有效缺陷**，均已修复并补上用例（即上表 ⑥⑦⑧）：`sections` 载体被漏读、
混合形状下折上会静默丢弃顶层提示与工具、以及不可探测分支的默认值无任何用例约束。
### 文档
- `docs/ISSUE27_DIAGNOSIS.md`：对外部报告的逐条核验——链路 6 跳的取证、双向错配四组合矩阵的实测结果、
DSH 各版本与 pi-ai 代数对照，并明确指出该报告的 **3 处硬错误**（代际边界实为 0.86 而非 0.87；
CASE B 实测为 `{"tokens":25}` 而非 `15`；`undefined maxTokens` 实为 `NaN` 而非「夹回正整数」）
与 **2 处需修正的修复建议**（「收紧 peer 即可在安装期被拒」不成立——DSH 内核预检
`evaluatePluginCompatibility` 只覆盖 `@deepseek-ai/dsh*`，pi-ai 不在其中，报告引用的 `install-compat`
告警来自 dshmarket 社区插件且属只告警不阻止的 `soft-incompatible`；以及「升级 DSH」解决不了问题，
报告人本就在最新的 0.2.0-rc.2 上，而升级只会把他更牢地留在「新宿主」一侧）。
## 3.4.1 (2026-10-12)
> **`4011` 的含义改正了：它是 Trae 对 SOLO 通道的限流，不是「该 function 不提供此模型」。**
> 起因是 [issue #33](https://github.com/dingminhua/dsh-connect-trae/issues/33)：报告人用 `GLM-5.3` 拿到
> `Trae code 4011`，报文原文写着 `your requests have exceeded the rate limit`，而他额度充足、
> Trae 客户端的 SOLO 里同一模型正常。**两边都没错**——Trae 把「额度」和「限流」分成两个码，
> 插件此前把限流读成了「function 归属错误」，于是用一个与上游原文矛盾的结论来解释，用户只能来问。
> 取证过程见 `docs/ISSUE33_DIAGNOSIS.md`。
### 修复
- **`4011` 的文案不再断言一个与上游原文矛盾的原因**（issue #33）：
- **原行为**：`TRAE_ERROR_HINTS[4011]` 写死为「Trae refused this model under the SOLO function the request used」，并把 Trae 自己的原文降级成 `· upstream:` 后缀。用户看到的主句是「模型/function 错了」，于是按那个方向去查。
- **为什么那个断言站不住**：本机 CN 实时凭据上跑 **22 个 function × 6 个模型**的最小请求矩阵，
「模型不在该 function 名单里」**无一例外回 `4001`**（`the param is invalid`）——22 个 function 全部如此，**没有一次回 4011**；而报告人用的 `glm-5.3` 归属的正是 `solo_work_remote`（插件本来就发这个 function），同一份请求体**正常出字**。也就是说「function 选错」这个条件已经被 `4001` 占用了，4011 不可能是它。
- **改后**：`4011` 如实描述为「Trae 限流了这条 SOLO 通道（是限流，不是余额）」，Trae 原文照旧附在后面。
- **`4011` 的 HTTP 状态改为 `429`（`soft_rate`），让状态码、文案与内核判定三者一致**：
- **原行为**：4011 被归类为 `400 / client`（按本插件 `fallback-upstream.ts` 的语义，`client` 属于「可换通道重放」的一类，绝不是「等一下再来」的一类）。但内核 `@deepseek-ai/dsh-llm-pi-ai` 是**按消息文本**分类的（`/\b429\b|rate.?limit/i` → `RATE_LIMIT`），而 `RATE_LIMIT` 在 `DEFAULT_RETRYABLE_CODES` 里、`maxRetries = 5`。
- **后果（issue #33 截图逐项吻合）**：失败的 4011 被内核当限流重试——`已重试模型请求 (5/5)`、重试延迟 7328 毫秒、右侧 `RATE_LIMIT` 徽标；而同一行正文却说「该 function 不提供此模型」。**被限流的通道 8 秒内又挨了 5 发请求。**
- **改后**：4011 → `429 / soft_rate`，三处判定不再打架；`soft_rate` 也正是 `fallback-upstream` 拒绝换通道重放的类别（限流不是通道兼容性问题，是对的）。
- **一键测试不再把「被限流」判成「上游不提供」**（issue #33）：
- `UNSUPPORTED_CODES` 此前是 `{4001, 4011}`，于是 4011 会得到 `unsupported`——卡片文案「上游不提供」，是一个**永久性的负面结论**。这与该模块自己写在文件头的原则直接冲突（「the verdict must never turn an inconclusive answer into "unavailable"」）。报告人用一键测试时会被告知一个能用的模型已经死了。
- **改后**：4011 归入 `rate_limited`（卡片「被限流」），`unsupported` 只由 `4001` 产生。
- **顺带把「一个码只能有一个 verdict」变成结构性约束**：原来每个 verdict 一个 `Set`，一个码同时出现在两个集合里时，结果取决于分支书写顺序——实测把 4011 加回「unsupported」集合**所有测试都过**。现在改成单一 `CODE_VERDICTS` 映射表 + 加载期唯一性断言，并补了交叉断言用例钉住它。
- **登记两个此前不认识的错误码**：
- **`4008` = 额度/配额耗尽**（原文 `Your requests have exceeded the quota.`）。它与 `4011` **是两个不同的码**：Trae 把「额度用完」和「被限流」分开报，所以 issue #33 里「我额度还有很多」与「我被 4011 拦住」可以同时成立。只登记文案与分类，**不改它的既有语义**（仍 `400 / client`）。本机只在国际版账号上观察到（该账号当前对多数模型都回 4008），CN 未触发——属**未验证项**。
- **`4023` = 模型名不存在**（原文 `the model is unknown`）。
- 一键测试里 `4008` 归入 `unknown`：它是**账号级**状态，不能变成对某个**模型**的判决。
### 测试
- **全仓 541 → 549（+8）**：
- `tests/solo-bridge.spec.ts`：4011 文案改为「限流」并保留 Trae 原文、`4008` 与 `4011` 文案分开、`4023` 命名、未登记码回退；`bridgeTraeSoloStreamOrFail` 的 4011 用例改为断言 `429 / soft_rate`；`4008` 的既有用例改为断言新文案。
- `tests/model-probe.spec.ts`：4011 → `rate_limited`（含「消息里只有码、没有 429 状态」的路径与「流中拒绝」路径）、`4008` → `unknown`、`4001` → `unsupported`，以及一条**表级交叉断言**（每个已知码都只映射到一个 verdict）——它正是为上面那个「顺序依赖」缺陷加的。
- **变异验证 6 次，6 次全部被抓**：① 去掉 4011 的 429 映射 → 1 例失败；② 恢复旧 4011 文案 → 2 例失败；③ 把 4011 在映射表里改回 `unsupported` → 4 例失败（**这条在改造前是抓不到的**）；④ 去掉 4008 的 `unknown` 映射 → 2 例失败；⑤ 删除「表内唯一性」的交叉断言依赖的行为 → 2 例失败；⑥ 其余组合。恢复后 55 文件 549 例全绿。
- 确认新增用例真的在跑：改动前基线 **541**、改动后 **549**，净增 8，与新增用例数一致。
### 文档
- `docs/ISSUE33_DIAGNOSIS.md`：完整取证——`4008`/`4011`/`4001`/`4023`/`1001`/`1005` 的码→语义对照、
22 function × 6 模型的调用矩阵、`glm-5.3` 的归属验证、本机 30 并发未触发限流的对照，以及内核
`dsh-llm-pi-ai` 按文本分类 + `DEFAULT_RETRYABLE_CODES` 的证据链（为什么截图里是 5/5 与 7328 毫秒）。
同时明确列出**未证实项**（4011 的粒度是「通道」还是「账号」、`4008` 的边界与恢复时间、CN 是否也用 4008）。
## 3.4.0 (2026-10-12)
### 新增
- **积分即将过期时给出提醒**（贡献者 [JeffTsuiCUG](https://github.com/JeffTsuiCUG)，PR [#32](https://github.com/dingminhua/dsh-connect-trae/pull/32)）。剩余额度只回答「还有多少」，回答不了「**哪一笔先到期**」，而后者才是「该先用哪个」的依据。此前一个 1 小时后过期的包和一个下个月才过期的包在界面上看起来完全一样，只盯总额的用户会毫无察觉地丢掉最先到期的那个。
- **数据在上一版（3.3.0，PR #31）已就绪**：`credits.accounts[].expiresAtMs` 已逐包携带到期时刻；本版在其之上加提醒 UI，**不新增任何上游读、卡片也不因此多一次请求**。原始起因见 [issue #26](https://github.com/dingminhua/dsh-connect-trae/issues/26)（DSH 主界面侧边栏显示积分状态的长期目标；`credits.expiry` 这份数据将来做 #26 可直接复用，同一个计费请求的结果）。
- **`toCredits` 按到期时刻把有余额的积分包分桶汇总为 `credits.expiry`**：`within24h` / `within3d` / `within7d` / `expired` 四桶，每桶带金额合计、套餐数量与最早到期时间。
- 只统计**正余额**的包：已用尽的包即使今天到期也不计入，否则长命账号会看起来永远「迫在眉睫」。
- 已过期的包**单独计桶**，不进入前瞻窗口——剩余毫秒数为负时会满足所有前瞻条件（`end - now < 24h`），混在一起会让一个早就死掉的包看起来永远临近。
- 抽出 `usableExpiry()` 谓词（`> 0` 且有限），与每包投影共用同一判断，两者不可能对同一批数据得出矛盾结论。`0` 与 `NaN`/`Infinity` 均被排除。
- **`TraeWebCreditExpiry` / `TraeWebExpiringCredits` 仅当有包携带可用到期时间时才存在**——「没拿到数据」不得渲染成「没有要过期的」，这与 #31 里 `expiresAtMs` 缺省即省略的设计一致。
- **两处 UI 不再一视同仁**：使用量标签页新增到期提示条，按 **7 天 → 24 小时 → 已过期**逐级加重，写明金额、套餐数和最早到期时间；输入框下面的积分面板（真正常驻看额度的地方）同样渲染提示条。仅国内版：国际版是订阅制（`payStatus`），没有逐包到期数据。
- 中英双语文案（`row.expiryWarningSoon` / `row.expiryWarningWeek` / `row.expiryWarningLapsed` / `row.expiryEarliest`）。
- 新增测试覆盖分桶边界、正余额排除、已过期/未到期分离、最早到期选取、非有限值与 `0` 的处理，以及「无数据」与「没有要过期的」这两个必须区分的状态。
### 测试
- `tests/composer-styles.spec.tsx` 的 fixture 补上带 `expiry` 的数据，让输入框面板的到期提示条真正被渲染并接受「每个渲染出的 class 在样式表里有规则」的守卫检查；并做了负向验证——临时删掉一条样式规则，测试精确报出缺失的 class（`dsm-trae-expiry-detail`），确认守卫是真的在覆盖而不是假通过。
- `tests/web-status.spec.ts` 新增 `expiry summary` 一组，钉住分桶与两种状态的区分。
## 3.3.0 (2026-10-11)
### 新增
- **一键测试所有模型**：模型区在「一键测试启用模型」旁新增「一键测试所有模型」，对当前 region 的**全部可见模型**发起可用性探测。两个按钮共用同一套探测路径，唯一区别是提交的 id 集合（勾选的行 / 全部可见行）。
- **`/usage` 的每个积分包携带自己的到期时刻**（`credits.accounts[].expiresAtMs`）。剩余额度只回答「还有多少」，回答不了「哪一笔先到期」，而后者才是「该先用哪个」的依据。上游本来就在 `user_entitlement_pack_list[].entitlement_base_info.end_time` 里逐包给出该时刻，这里只是把它投影进卡片文档——**不新增任何上游读**，卡片自身也不因此多一次请求。没有可用时刻的包**不带该字段**（而不是给 0）：0 是 1970，会排在所有真实日期之前，读起来像「早已过期」。
### 新增（国际版的输入框读数）
- **输入框工具栏读数扩展到国际版**（用户反馈「国际版也要这个显示，现在没有」）。此前只有国内版显示「Trae CN · <积分>」，选中国际版模型时整块读数消失。
- 原限制是**数据决定的**，不是偏好：国际版的用量文档由 `payStatus` 构建，从不带 `credits`（`webStatusFor` 对 `region === 'ai'` 提前返回），把订阅制成的东西套进数字槽位只会渲染一个破折号。但正确的修法是**渲染那一边真正有的东西**，而不是什么都不渲染——所以国际版显示**套餐**（`Pro` / `Free`），与卡片账号行的额度列同源。
- 三处文案随之区域化：产品名（`Trae CN` / `Trae 国际版`）、面板标题（`Trae 积分` / `Trae 国际版套餐`）、列头（`通用积分` / `套餐`）。在国际版面板里写「通用积分」而下面是 `Pro`，是在命名一个不存在的量。
- 面板的**逐账号套餐**走的是卡片名册用的那条**账号状态路由**（它对 ai 返回 `payStatus`），而不是积分路由——后者是 CN 形状的（它调用积分快照）。仍然**只在面板打开时读**，5 分钟周期不为它付费。
- 顺带把套餐判定抽成 `src/client/plan-text.ts`：卡片账号行的额度列、这里现在共用一个实现。此前卡片里另有一个独立订阅框与账号行各读各的源，正因如此才对同一账号给出不同档位（该框已删除，见下）。
### 修复（「刷新账号与 Token」显示已绑定，设置里却是空的）
- **刷新账号后显示的账号，就是真正被写进设置的账号**。报告的现象是：刷新后提示「找到 1 个账号 · 仍绑定 丁敏华」，而设置文档里 `accounts.cn` **一直是空的**。
- 根因是把路由的 `selected` 标志读成了「已经绑定过」。该标志回答的是「**哪个账号正在使用**」，而不是「哪个账号被显式保存过」：没有保存过绑定时，存储层会用**探测到的默认值**（Trae App 当前登录的那个）来回答。于是「从未显式绑定」被读成「检测到的默认值正在使用，无需写入」——刷新恰好**什么都没保存**，而卡片却把它显示成已绑定；下一次存储重建（重启、或 Trae 换登录）就静默改回别的账号。
- 现在按「**这个区域实际在用的账号**（存储层的裁决，也正是卡片显示的那个）写盘」，仅在路由完全没给出裁决时才退回该区域自己的名册；**已经是保存中绑定**的行不重复写——一次点击不该为无变化重写设置文档（那会触发 `loader/volatile-update`、重跑 `applySelection` 并重建两个存储）。
- 提示语随之区分两件事：`已绑定 X`（这次真的写入了）与 `仍绑定 X`（这次没写，X 是既有绑定）。旧措辞把「保存了」和「本来就没动」压成同一句话，正是这个缺口看不见的原因。
- `tests/card-accounts-rescan.spec.tsx`（新增 6 条）钉住不变式：**刷新后卡片显示为在用的账号，必须就是设置文档记录的账号**——显示一个、保存零个是 bug，而它在截图里完全看不出来。覆盖：未绑定时必须写入、必须携带另一区域的绑定（不能把国内版的选择刷掉）、已是保存绑定时不得重写、路由未标 `selected` 时仍绑定它、只读 scope 不写且如实报告、以及提示语必须区分「已绑定」与「仍绑定」。
### 新增（输入框读数开关扩展到国际版）
- **「在输入框工具栏显示积分读数」不再只在国内版出现**。该开关此前是 CN 专属，理由是它背后的读数只服务国内版；读数扩展后它服务**两条供应商路由**（`trae` 上显示余额、`trae-global` 上显示套餐），继续藏起开关等于让国际版的读数**从任何入口都够不着**。
- 仍是**同一个设置、同一次写入**，不是第二个开关——按区域各存一份会让读数与设置它的 tab 对不上。
- 提示文案按所在 tab 取值（新增 `row.showPointsInMainUiHintAi`）：原提示一句话描述了两个区域（「…国内版为…，国际版为…」），那是它只在一个 tab 上渲染时写的；现在两个 tab 都渲染，提示只说自己这一边，勾之前就能知道会得到什么。
### 移除（国际版独立的「订阅状态」框）
- **卡片里那个独立的「订阅状态」框已删除**，订阅档位**只由账号表「额度」列渲染**。
- 它当初是为了补「国际版没有那个积分框」的不对称而恢复的（595e01e），但账号表的额度列此后已经吸收了同一个数字，于是它**直接重复了正上方那一行**。同一份裁决有两个渲染器正是 `plan-text.ts` 存在要防的漂移，而该框能说的永远只是被标为「当前使用」的那行已经说过的内容。
- `tests/card-subscription.spec.tsx` 的三条框测试替换为**反向守卫**：国际版 tab 上不得再出现 `row.subscriptionLabel` / `row.payStatusUnknown`，包括**读失败**这一路也不得把它以降级形态复活。
### 界面重做（用户反馈「现在的样式太难看了，而且内容也复杂」）
- **账号区改为定宽网格表格**（用户反馈「选择的样式……都和 WorkBuddy 有区别」，随后确认推翻上一版的列表要求）。每账号一行，四列：**账号 / 额度 / 签到 / 操作**，上方带表头行。
- 「Token 到期」整列不再保留：它独占一列却没有人据此做决策。
- 同一信息原本出现三次（状态点、名字旁的徽标、操作列又写一遍「当前使用」），现在只保留名字旁一个标记；当前绑定账号不再渲染任何动作按钮。
- 国内版额度（积分）与国际版订阅（套餐）落在**额度列**，不再各占一个独立统计块。
- **列宽用容器的分数**（`grid-template-columns:1.7fr 1.1fr 1fr 1.1fr`），这是关键：上一版四列各自按内容撑开，列与列在行间对不齐，才是「表格难看」的真正原因；定宽后可以沿列向下读。国际版没有签到列（该 region 无签到接口），列数降为 3，让出的宽度给账号名。
- 当前使用中的行用**左侧强调竖条 + 淡色底**标记：只有 7% 透明度底色时，长表格里它会被误读成斑马纹的隔行底色。
- 行内「切换」按钮改用共享的 `dsm-btn dsm-btn-outline` 原语并缩小，不再自造一套按钮。
- **设置区改为裸行开关、即点即存**（同一轮对齐）。去掉边框盒子、标题与「保存 / 放弃修改」按钮，两个开关各自成为一行带复选框的 `