dsh-connect-trae 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # Changelog
 
+## 2.3.0 (2026-09-25)
+
+### Breaking Changes
+
+- **只支持 DSH 0.1.7-rc.1 及以上，不再支持 0.1.7 之前的宿主**。2.2.0 用「双线 + 运行期能力探测」同时服务 0.1.5 与 0.1.7；0.1.5 线的设置面（`installSection` / `settingsScope` / `settings.plugin.item` / 非 volatile 写入）与 0.1.7 的新模型**互不相交**，保留它意味着每条路径都要背两套契约。从本版起删除全部 0.1.5 分支，`peerDependencies` 与 `devDependencies` 一并收窄到 `>=0.1.7-rc.1` / `0.1.7-rc.1`（`cordis >=4.0.4`、`schemastery >=3.18.4`）。做法对齐同级 `dsh-connect-workbuddy`（其 2.1.0 起的 0.1.7-only 改造）。
+
+### Bug Fixes
+
+- **0.1.7 上 provider 被判「未配置」——命名空间必须用宿主服务的那个**（对齐 workbuddy 2.0.16 的实测）。0.1.7 的 `SettingsForms.describe()` 以 **Loader 条目 id** 为键，harness 对 provider 的命名空间做**精确匹配**查表（`namespaces.get(entry.settingsNs)`）。此前硬编码 `settingsNs: 'trae'`，而桌面宿主实际以 `dsh-connect-trae`（或 `include:dsh-connect-trae`）挂载条目，于是查表落空、provider 读作「未配置」，**配置入口与模型发现静默失效**、不报错。
+  - **修法**：新增 `settingsNamespaceOf(ctx)`，采用一线插件（`dsh-llm-pi-ai`）的权威范式 `const settingsNs = ctx.fiber.entry?.options.id ?? TRAE_SETTINGS_NS`，`registerConfigurableProviders` 与 `registerModelDiscovery` 全部改用解析值；`ctx.fiber.entry` 由 Loader 注入（非 Cordis 公共类型），保留探测 + 回落到 `'trae'`。
+  - **回归测试**（`tests/settings-integration.spec.ts`，+4 例）：采纳 Loader 条目 id、无条目/空 id/非字符串时回落、以及**目录实际宣告的就是解析值**（断言目录条目而非常量，否则恒过）。
+- **移除宿主端 `installSection` 双路径，`configure({auto}, owner)` 成为唯一路径**（对齐 workbuddy 的 0.1.7-only 写法）。0.1.7 的 `SettingsForms` 删除了 `installSection`；2.2.0 按能力探测两条路径，本版起无条件调用 `configure`，且把返回的 disposer 挂进 `ctx.effect()`——否则展示策略泄漏到插件销毁之后（一线插件同款：`child.effect(() => child.settings.configure({ auto: false }, …))`）。随 `installSection` 一起删除 `legacyInstallSettingsSection` / `sectionHooks` 及其对 `@deepseek-ai/dsh-settings` 命名空间的依赖。
+- **客户端设置面只走 `configForms`**（对齐 workbuddy 的 0.1.7-only 写法）：删除 `settingsScope.bind` 回退分支与 `settings.plugin.item` 槽位注册，只保留 `configForms.get(entryId)` + `plugins.bundle.config` / `plugins.row.config` 两个槽位。`inject` 维持 `['slots', 'locale']`，设置面仍经 `ctx.get()` 软探测。
+- **卡片的 `view` 行为不再按双线区分**：`page` 视图默认展开、无 `view` 默认折叠；`set()` 契约收窄为 `Promise<boolean>`（0.1.7 表单返回显式布尔，`false` 即拒绝）。
+- **区域开关等设置保存被宿主拒绝（`No configurable plugin entry "trae"`）——客户端命名空间绑定必须跟随 describe 镜像**。卡片此前在 `apply()` 时**一次性**解析命名空间：describe 镜像异步加载，且在运行中的 profile 里新增插件条目（本插件正是这种场景）时，镜像首次 describe 可能早于条目出现；`/trae/i` 匹配落空就**永久**回落到声明的 `'trae'`。`configForms.get('trae')` 把表单控制器永久绑到该 ns——宿主 `configEditor.entries()` 里没有 `options.id === 'trae'` 的条目，每次写入都抛 `No configurable plugin entry "trae"` 被拒；而控件仍可点（controller 对「ns 不在镜像」的派生沿用全局 `writable=true`），表现为「开关翻过去又弹回」。
+  - **修法**：设置面改为**可重绑代理**——`getSnapshot` / `set` 转发到「当前」控制器；别名解析（`served.ns`，`/trae/i` 匹配）在 apply 时尝试一次，并订阅镜像（`describe().subscribe`）在每次变化后重绑；镜像已就绪但缺条目时**一次性**触发 `describe().load()` 补拉（此后宿主 `settings/document-updated` 事件保持新鲜）。绑定前代理返回 `writable: false`，卡片只读而非提供必定失败的控件。
+  - **回归测试**（+3 例）：激活测试的镜像桩改为真实形状（`ns: 'dsh-connect-trae'`，即 patch id，非声明的 fallback），断言绑定到 `dsh-connect-trae`；新增「镜像在 apply 后才出现条目 → 重绑到正确 ns」与「一次性 nudge 补拉镜像」两例。测试桩此前的 `ns: 'trae'` 恰好把 fallback 当成了正解，是这条缺陷没被 CI 拦住的原因之一。
+- **插件管理页 / 市场页的 logo 显示不对**（默认占位/空白，对齐 workbuddy 2.0.17 的实测）。0.1.7 的插件管理页从插件包 `package.json` 的 `icon` 字段读图标（`dsh-client-ui-plugin-manager` 渲染 `row.meta?.icon`），此前没有声明该字段 → 宿主无图可用。
+  - **修法**（照同级 `dsh-connect-workbuddy` 的做法）：新增 `icons/` 目录（64px + 128px 真实 PNG，其中 64px 与既有卡片内嵌 base64 逐字节一致——同族 LD logo），`package.json` 声明 `"icon": "icons/dsh-connect-trae-128.png"`，并把 `icons` 加入 `files` 白名单随包分发。
+  - **验证**：`npm pack --dry-run` 确认两个 PNG 进包（12 → 14 文件）。
+- **模型倍率改回「wire 权威、Remote 兜底」，恢复折后价显示**（回归：b8f09bc 重构时误删 1.4.2 的 `display_contact_config` 解析）。`get_detail_param` 每行的 `display_contact_config`（第二层 JSON）里的 `consumption_rate.data.rate` 才是 Trae IDE 渲染的**折后价**；Remote 目录的 `consumption_rate` 在限时折扣下会报**未折价**（Seed-2.1-Pro：IDE `x0.08` vs Remote `0.80`，差 10 倍）。b8f09bc 改成多 function 并集时把这个解析连带删掉，倍率从此退化成 Remote 值。
+  - **修法**：`solo.ts` 恢复 `wireCreditMultiplier()`（读 `display_contact_config.consumption_rate.data.rate`，`enable` 为真且为正有限数时取值，缺失/损坏留空不虚构），`TraeSoloModel` / `TraeWireModel` 增列 `creditMultiplier`；`mergeTraeModelSources` 合并时 **wire 优先、Remote 兜底**（wire 未提供才用 Remote）。
+  - **国际版（ai）区域**：实测（2026-09-25 只读探测）国际版上游任何目录都不含 `consumption_rate`（订阅制，只有 `cost` 标签与 `manual_usage: 0|1`，官方 App 也只渲染「Lite-friendly」这类标签而非数值倍率），因此 ai 模型行按「解析不出则留空」保持不显示倍率——不虚构数值。
+  - **回归测试**（+2 例）：`solo.spec.ts` 断言 wire 解析出折后价、缺失时不虚构；`catalog.spec.ts` 断言合并时 wire 优先、Remote 兜底、双缺留空。变异验证：把合并改回只读 Remote → 新用例立即失败。
+
+### Dependencies
+
+- `peerDependencies`：全部 `@deepseek-ai/dsh-*` 收窄为 `>=0.1.7-rc.1 <0.2.0-0`；`@deepseek-ai/cordis` 收窄为 `>=4.0.4 <5.0.0`；`@deepseek-ai/schemastery` 收窄为 `>=3.18.4 <4.0.0`（`volatile()` 自 3.18.3 起才有）。
+- `devDependencies`：全部 `@deepseek-ai/dsh-*` 与 `cordis` / `schemastery` 升到 0.1.7-rc.1 线，开发树与用户解析一致。
+- `tests/settings-integration.spec.ts` 的 settings 测试替身改为 **0.1.7 形状**（`SettingsForms` 语义的内存服务：`configure` + `describe` + 只写 volatile 字段的 `update` + `loader/volatile-update`），插件以**活引用配置**（volatile 字段 = `{get(): T}` 指向同一份文档）挂载，模拟真实宿主的写入→重放路径；原先写非 volatile 扁平字段（`lastCatalog` / `imageModelIds` / `enabledModelIds`）的用例改为写 `regions.cn` 槽位——正是 0.1.7 写入门接受且卡片实际采用的形状。
+
+### Tests
+
+- 310 → 316。移除 0.1.5 形态用例（client-activation 的 `settingsScope` 宿主、client-fallback 的 `settingsScope.bind` 回退、card-region-switch 的 void 返回契约），新增 4 例 `settingsNamespaceOf`、3 例命名空间重绑/补拉、2 例 wire 倍率解析与合并优先级。`pnpm run check`（typecheck + test + build）全绿。
+
+## 2.2.0 (2026-09-24)
+
+### Bug Fixes
+
+- **支持 DSH 0.1.7 线，且同一个构建同时服务 0.1.5 与 0.1.7**（修复 [issue #13](https://github.com/dingminhua/dsh-connect-trae/issues/13)）。这不是「多支持一个版本」的可选增强——**在 0.1.7 上插件的浏览器半侧此前根本不激活**：
+
+  ```
+  web boot: 1 entry did not activate
+  dsh-connect-trae: pending (waiting for service: settingsScope)
+  ```
+
+  - **根因：`settingsScope` 被整个移除，而 Cordis 的依赖闸门是硬闸。** DSH **0.1.7-alpha.1** 起客户端设置服务换成 `configForms`，`settingsScope` **不再存在**（不是弃用、没有兼容层；0.1.6-alpha.2 还有，0.1.7-alpha.1 起包内已无此符号）。插件 `inject` 里仍声明它，于是 fiber 永远停在 `PENDING`——**不是某个功能坏掉，是整个客户端插件不激活**，因此「重新登录」「重装插件」一概无效。修法与 workbuddy 一致：`inject` 收窄为两条线都有的 `['slots', 'locale']`，设置面改由 `ctx.get()` **按能力软探测**（属性访问会抛 `cannot get property X without inject`，`?.` 挡不住；`ctx.get` 对缺失服务返回 `undefined`）。
+  - **0.1.7 上另有三处断裂，issue 只报了第一处。** 逐项对照 workbuddy 的实测（该仓库已用同一套适配跑通 0.1.7）：
+
+    | # | 位置 | 0.1.5 | 0.1.7 |
+    |---|---|---|---|
+    | 1 | 客户端设置服务 | `settingsScope` | `configForms` |
+    | 2 | 客户端槽位名 | `settings.plugin.item` | `plugins.bundle.config` / `plugins.row.config` |
+    | 3 | 宿主端注册 | `installSection()` | `configure({auto}, owner)` |
+    | 4 | schema 可写声明 | 无需 | 必须标 `volatile()` |
+    | 5 | primitives 图标名 | `…Outline14` | `…OutlineRegular` |
+
+  - **第 2 条（槽位名）最容易被漏掉**：两条线声明的槽位集合**互不相交**（0.1.5 只有 `settings.plugin.item`；0.1.7 只有 `plugins.*`）。就算设置服务改对了，槽位名不改卡片依然渲染不出来。现在三个槽位**各自独立 try/catch** 逐个注册——一条线上不存在的槽位不能把另一条线的注册一起带走。
+  - **第 3 条（宿主端）在 0.1.7 上是静默失败**：`installSection` 被 `SettingsForms.configure()` 取代。由于该调用位于嵌套的 `ctx.inject` 回调内，抛出的 `installSection is not a function` 落在**那个子 fiber** 上——外层插件照常加载、两个 provider 照常注册，**但 `trae` 设置命名空间从未注册**，表现为卡片设置区无声消失。现在按能力探测：有 `configure` 走 `configure`，否则回落 `installSection`。
+  - **第 4 条（易失声明）**：0.1.7 的 settings 写入门要求插件 schema 把可写字段标为 volatile，否则**写入被直接拒绝**（`Plugin entry "trae" has no volatile fields`），而 `scope.set()` 却正常 resolve——用户会看到开关翻过去又静默复原。新增 `asVolatile()`：运行时探测 `schema.volatile()`，**有则调用、无则退化为 identity no-op**（`volatile()` 自 schemastery 3.18.3 起才有，0.1.5 线锁在 3.18.2）。**故意不手写 `meta.volatile = true`**——那会绕过 schemastery 自身的 `validateVolatileSchema` 校验，产出一个它自己都不认的 schema。
+  - **0.1.7 以「活引用」交付配置值。** 该线把 volatile 字段以 `{get(): T}` 形式交给消费方；不解包则 `config.regions`、`value.accounts[region]`、`config.authFile` 静默变成对象或 `undefined`，表现为「设置明明写了却读不到」。更隐蔽的是**展开一个活引用得到的是 `{get: <function>}` 而不是值**——卡片「写一个区域、保留另一个」的合并会因此**丢掉兄弟区域并把函数泄进设置文档**。新增 `unwrapVolatile()` / `unwrapVolatileDeep()` 并在所有读取与合并路径上解包，同时监听 `loader/volatile-update` 在每次写入后重读选择。
+  - **第 5 条（图标）会让整个客户端包挂掉**：两条线 primitives 的图标名不重叠（`IconChevronDownOutline14` vs `IconChevronDownOutlineRegular`），**没有任何一个静态 import 能同时服务两边**——静态导入 0.1.5 的名字会让 0.1.7 上的客户端包解析失败，整个卡片随之消失。折叠箭头改为**纯 CSS caret**（`border` + `rotate`），与版本无关。
+  - **设置写入改为「写入后回读校验」**：`set()` 的 promise resolve **不代表值已落盘**（0.1.7 上被拒绝的写入会重新加载 Host 状态然后正常返回，0.1.5 上则可能被文件占用丢弃）。四处写入（账号选择、账号重扫、区域开关、模型目录）统一走 `writeSettingsField()`：写入后回读，未落盘即抛错并在卡片上明确显示，而不是「点了没反应」。0.1.7 的 `set()` 还会返回显式布尔值，`false` 同样按拒绝处理。
+  - **卡片的 `view` 属性**：0.1.7 的插件管理器通过 owner props 向每个配置条目索取两种视图（`summary` 一句话简介 / `page` 带保存控件的完整表单）。卡片接受该属性并在 `page` 下默认展开——否则在 0.1.7 的插件页里卡片会是折叠的一行。
+  - **开发环境的 schemastery 从 3.18.2 提到 3.18.4**（`pnpm-workspace.yaml` 的 override，与 `devDependencies` 对齐）。此前 dev 树锁在 3.18.2，那里没有 `volatile()`，`asVolatile()` 退化为 no-op——**于是 volatile 真正生效的那条路径（每个 0.1.7 用户都会走的那条）在本地从未被执行过**，这类缺陷可以同时躲过评审与 CI。这与 workbuddy 记录的教训同源。
+
+### Tests
+
+测试总数 282 → 310。
+
+- **新增 `tests/client-activation.spec.tsx`（3 例，本次最关键的一组）**：用真实的 cordis `Context` **启动真实的客户端入口模块**，分别对 0.1.7 形态（有 `configForms`、**无** `settingsScope`）、0.1.5 形态（有 `settingsScope`、无 `configForms`）、以及**两者都没有**的形态断言 fiber 到达 `ACTIVE`、槽位注册齐全、scope 取自正确的服务。之所以能直接导入真实入口，是因为它运行期只依赖 React 与本地文件，所有 DSH 包都是**类型导入**、构建时即被擦除。
+  - 此前 `client-fallback.spec.ts` 抓不到这个缺陷：它**手工镜像**入口函数体，因此验证的是「思路」而**从不执行真实的 `inject` 数组**——而恰恰是那个数组让 fiber 卡在 PENDING。
+  - **变异验证**：把 `inject` 改回 `['slots','locale','settingsScope']`，0.1.7 与「无设置面」两例立即变红（fiber 停在 0/1，永远到不了 `ACTIVE`），0.1.5 那例仍绿——精确复现了 issue 报的现象。
+- **新增 `tests/dsh-017-compat.spec.ts`（13 例）**：活引用的单层/深层解包、数组与嵌套、**不就地改写调用方对象**；`regionEnabledOf` / `regionStateOf` / `regionEnabled` 穿透活引用读值；合并时**保留兄弟区域且不泄露函数**；`asVolatile()` 的两条分支按运行时能力确定性断言；以及**宿主端 `configure()` 优先于 `installSection()`**（用一个只有 `configure` 的真 Service 装配，断言走的是 `configure({auto:true})` 且没有 `installSection` 报错）。
+  - **变异验证**：把 `configure` 探测改回无保护裸调 `installSection` → 1 条立即变红；把 `nextRegionSlots` 的深解包去掉 → 1 条立即变红。
+- `client-fallback.spec.ts` 的镜像同步更新，并补 2 例：**两条线都提供时 `configForms` 优先**（0.1.7 的写入闸门只认它），以及 **`configForms` 缺席时回落 `settingsScope.bind()`**。
+- **`card-region-switch.spec.tsx` 新增 8 例**（渲染真组件、点真按钮）：穿透活引用读区域开关；合并时**保留兄弟区域且不泄露函数**；Host 明确拒绝（`set()` 返回 `false`）与**「接受了但没落盘」**（`set()` 返回 `true` 而文档未变）两种失败都必须显式报错；0.1.5 的 `void` 返回视为成功；`view: 'page'` 时默认展开、无 `view` 时默认折叠；无设置面时渲染为只读。
+  - **变异验证**：去掉 `regionsMapOf` 的解包 → 1 条失败；去掉 `view` 判断 → 1 条失败；去掉 `false` 判断 → 0 条失败（回读校验兜住了，说明两层防护确实互补）；去掉回读校验 → 1 条失败；**两层都去掉 → 1 条失败**。
+  - 顺带移除了该文件对 `dsh-client-ui-primitives` 的整包 `vi.mock`：图标已改纯 CSS，不再需要这个桩。
+
+**双版本验证**：同一份代码在 schemastery **3.18.4**（volatile 生效）与 **3.18.2**（no-op 分支）下**均为 310 通过**。
+
 ## 2.1.0 (2026-09-24)
 
 ### Features

package/README.en.md

@@ -94,6 +94,18 @@ npm install dsh-connect-trae
 
 Restart the DSH process after install/update/uninstall.
 
+## DSH version compatibility
+
+**Requires DSH 0.1.7-rc.1 and up** (since 2.3.0 the plugin no longer targets hosts older than 0.1.7; the peer dependency ranges are narrowed accordingly).
+
+0.1.7 rebuilt the settings machinery, and the plugin follows the 0.1.7 contract:
+
+- **Host registration**: `SettingsForms.configure({auto}, owner)` (`installSection` was removed in 0.1.7), and the namespace is the **Loader entry id the host actually serves** (`ctx.fiber.entry?.options.id`, falling back to `trae`) — the harness looks a provider's namespace up by exact match, so hard-coding `trae` made the provider read as "not configured".
+- **Client settings surface**: `configForms` (`settingsScope` was removed in 0.1.7). `inject` declares only `slots` / `locale`; the settings surface is probed with `ctx.get()`. Cordis' dependency gate is hard — any `inject` entry the running line does not provide keeps `apply()` from ever running (this is why 2.2.0 and earlier sat at `pending (waiting for service: settingsScope)` on 0.1.7).
+- **Config card slots**: `plugins.bundle.config` / `plugins.row.config` (`settings.plugin.item` was removed).
+- **Schema writable marker**: writable fields must be marked `volatile()` (`asVolatile`), or 0.1.7's write gate rejects every write; 0.1.7 delivers config values as `{get(): T}` live references, so every read and merge path unwraps them first (`unwrapVolatile` / `unwrapVolatileDeep`).
+- **The collapse caret is pure CSS**, with no static primitives icon import — icon naming changes across releases, so a static import is not a stable contract.
+
 ## Windows notes
 
 - **Account data directory**: the plugin reads `%APPDATA%\Trae CN` / `%APPDATA%\TRAE SOLO CN` → `User\globalStorage\storage.json` (unrelated to the install directory). The folder names match macOS, so no extra config is needed; if the name does not match, point the `authFile` + `edition` plugin options at the exact path.

package/README.md

@@ -96,6 +96,18 @@ npm install dsh-connect-trae
 
 安装、更新或卸载 bundle 后，需要重启对应的 DSH 进程。
 
+## DSH 版本兼容
+
+**要求 DSH 0.1.7-rc.1 及以上**（2.3.0 起不再支持 0.1.7 之前的宿主；peer 依赖范围已按此收窄）。
+
+0.1.7 把设置体系整体重建，插件按 0.1.7 的契约工作：
+
+- **宿主端注册**：`SettingsForms.configure({auto}, owner)`（0.1.7 起 `installSection` 已删除），命名空间取**宿主实际服务的 Loader 条目 id**（`ctx.fiber.entry?.options.id`，回落到 `trae`）——harness 按精确匹配查找 provider 的命名空间，写死 `trae` 会让 provider 被判「未配置」。
+- **客户端设置面**：`configForms`（0.1.7 起 `settingsScope` 已移除）。`inject` 只声明 `slots` / `locale`，设置面用 `ctx.get()` 软探测——Cordis 的依赖闸门是硬闸，`inject` 里任一服务在运行线上不存在，`apply()` 就永远不会执行（这正是 2.2.0 及更早版本在 0.1.7 上卡在 `pending (waiting for service: settingsScope)` 的原因）。
+- **配置卡片槽位**：`plugins.bundle.config` / `plugins.row.config`（`settings.plugin.item` 已删除）。
+- **schema 可写声明**：可写字段必须标 `volatile()`（`asVolatile`），否则写入被 0.1.7 的写入门直接拒绝；0.1.7 以 `{get(): T}` 活引用交付配置值，所有读取与合并路径都先解包（`unwrapVolatile` / `unwrapVolatileDeep`）。
+- **折叠箭头用纯 CSS**，不静态导入任何 primitives 图标——图标命名族随版本变动，静态导入不是稳定契约。
+
 ## Windows 说明
 
 - **账号数据目录**：插件读取 `%APPDATA%\Trae CN` / `%APPDATA%\TRAE SOLO CN` 下的 `User\globalStorage\storage.json`（与安装目录无关）。目录名与 macOS 一致，无需额外配置；若目录名对不上，可用插件配置项 `authFile` + `edition` 直接指定完整路径。

package/lib/client.js

@@ -5,7 +5,6 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react = require("react");
-		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region src/status-paths.ts
 		/** Plugin-owned usage endpoint consumed by its browser half. */
@@ -31,6 +30,42 @@ window.__ModuleLoader__.load({
 			return `${path}?${TRAE_REGION_PARAM}=${region}`;
 		}
 		/**
+		* Peel ONE `{get(): T}` live reference, the shape DSH 0.1.7 delivers a
+		* volatile-marked settings field as (see {@link unwrapVolatileDeep}).
+		*/
+		function unwrapVolatile(value) {
+			if (value !== null && typeof value === "object" && typeof value.get === "function") return value.get();
+			return value;
+		}
+		/**
+		* Deep copy of a value with every `{get(): T}` live reference replaced by the
+		* value it resolves to.
+		*
+		* DSH 0.1.7 hands volatile-marked fields back as live references, and a live
+		* reference is still `typeof === 'object'` — so it passes a naive object check
+		* and every lookup on it is `undefined`. Worse, spreading one (`{ ...ref }`)
+		* does NOT read the field: it produces `{ get: <function> }`. Any merge that
+		* spreads a resolved field to preserve its siblings — the card's "write one
+		* region, keep the other" write, or the account map's spread — would otherwise
+		* DROP every sibling and leak a function into the document.
+		*
+		* Both halves therefore unwrap before touching a resolved field. This lives in
+		* the node-free host↔client bridge because the browser half needs it too.
+		*
+		* Non-reference values are recursed into so a nested volatile field is caught
+		* as well; arrays and objects are rebuilt rather than mutated, so the caller's
+		* value is never touched.
+		*/
+		function unwrapVolatileDeep(value) {
+			if (value === null || typeof value !== "object") return value;
+			if (typeof value.get === "function") return unwrapVolatileDeep(value.get());
+			if (Array.isArray(value)) return value.map((entry) => unwrapVolatileDeep(entry));
+			const source = value;
+			const out = {};
+			for (const key of Object.keys(source)) out[key] = unwrapVolatileDeep(source[key]);
+			return out;
+		}
+		/**
 		* Build the next `regions` settings value for the card's save. The write
 		* targets ONLY the signed-in account's region slot; every other region's slot
 		* is carried over untouched, so switching accounts never clobbers the other
@@ -38,8 +73,9 @@ window.__ModuleLoader__.load({
 		* from an empty document.
 		*/
 		function nextRegionSlots(regions, region, slot) {
+			const unwrapped = unwrapVolatileDeep(regions);
 			return {
-				...typeof regions === "object" && regions !== null && !Array.isArray(regions) ? regions : {},
+				...typeof unwrapped === "object" && unwrapped !== null && !Array.isArray(unwrapped) ? unwrapped : {},
 				[region]: slot
 			};
 		}
@@ -50,17 +86,23 @@ window.__ModuleLoader__.load({
 		* where the map was expected was a real shipped bug — the lookup then read
 		* `section['cn']` (absent), so the card's checkbox reported `true` forever and
 		* clicking it appeared to do nothing even though the write succeeded.
+		*
+		* Unwraps live references first: on DSH 0.1.7 the `regions` field arrives as a
+		* `{get(): T}` reference, which passes the `typeof === 'object'` check below
+		* and would otherwise be returned as if it were the map — making every region
+		* read back as absent (and the enabled flag read as "on" forever).
 		*/
 		function regionsMapOf(value) {
-			if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
-			const record = value;
+			const unwrapped = unwrapVolatileDeep(value);
+			if (typeof unwrapped !== "object" || unwrapped === null || Array.isArray(unwrapped)) return {};
+			const record = unwrapped;
 			const nested = record["regions"];
 			if (typeof nested === "object" && nested !== null && !Array.isArray(nested)) return nested;
 			return record;
 		}
 		/** One region's stored slot as a plain object; any other shape reads as empty. */
 		function regionSlotOf(value, region) {
-			const slot = regionsMapOf(value)[region];
+			const slot = unwrapVolatile(regionsMapOf(value)[region]);
 			return typeof slot === "object" && slot !== null && !Array.isArray(slot) ? slot : {};
 		}
 		/**
@@ -123,7 +165,11 @@ window.__ModuleLoader__.load({
 .dsm-plugin-card-head{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}
 .dsm-plugin-card-title{color:var(--dsw-alias-label-primary,#e6e6e6);font-size:15px;font-weight:600;line-height:1.4}
 .dsm-plugin-card-description{color:var(--dsw-alias-label-tertiary,#999);font-size:13px;line-height:1.5}
-.dsm-plugin-card-chevron{color:var(--dsw-alias-label-tertiary,#999);flex:none;display:inline-flex;transition:transform .16s}
+/* Pure-CSS caret: the host primitives' chevron icon names are not part of any
+   stable contract across DSH releases, so no static import is used — a border
+   caret in the plugin's own CSS is version-proof. */
+.dsm-plugin-card-chevron{color:var(--dsw-alias-label-tertiary,#999);flex:none;width:16px;height:16px;position:relative;transition:transform .16s}
+.dsm-plugin-card-chevron::before{content:"";display:block;position:absolute;left:4px;top:5px;width:7px;height:7px;border-right:1.6px solid currentColor;border-bottom:1.6px solid currentColor;transform:rotate(45deg)}
 .dsm-plugin-card-chevron-open{transform:rotate(180deg)}
 .dsm-plugin-card-body{border-top:1px solid var(--dsw-alias-border-l2,#36373b);margin:0 16px;padding:0 0 8px}
 .dsm-plugin-card-icon{width:32px;height:32px;flex:none;border-radius:7px}
@@ -230,11 +276,49 @@ window.__ModuleLoader__.load({
 		*/
 		const POLL_INTERVAL_MS = 6e4;
 		const TRAE_GITHUB_URL = "https://github.com/dingminhua/dsh-connect-trae";
-		/** Read the per-region account selections out of the settings snapshot. */
+		/**
+		* Read the per-region account selections out of the settings snapshot.
+		*
+		* Deep-unwraps first: on DSH 0.1.7 a volatile field arrives as a `{get(): T}`
+		* live reference, which passes the `typeof === 'object'` check below and would
+		* be returned as if it were the map. Every lookup on it is then `undefined`,
+		* and the card's merge (`{ ...configured, [region]: id }`) would spread a
+		* reference into `{get: <function>}` — dropping the other region's selection
+		* and leaking a function into the settings document.
+		*/
 		function configuredAccountsOf(configured) {
-			const accounts = configured?.accounts;
+			const accounts = unwrapVolatileDeep(configured)?.accounts;
 			return typeof accounts === "object" && accounts !== null ? accounts : {};
 		}
+		/**
+		* Write one settings field and confirm the value actually landed.
+		*
+		* `configForms.set()` resolving is NOT proof that anything was stored: a write
+		* can be accepted by the transport and still not materialize — a rejected
+		* write reloads Host state and merely RETURNS, so the caller's `await`
+		* succeeds while the document is unchanged. The form answers with an explicit
+		* boolean for exactly this reason.
+		*
+		* Either way the caller must not report success on an unpersisted write: the
+		* user would see the control flip and then silently revert.
+		*
+		* @throws {TraeSettingsWriteError} when the write was refused or did not land.
+		*/
+		var TraeSettingsWriteError = class extends Error {
+			constructor(field, detail) {
+				super(detail === void 0 || detail === "" ? `trae: settings field "${field}" was not persisted by the settings write` : `trae: settings field "${field}" was not persisted by the settings write (${detail})`);
+				this.name = "TraeSettingsWriteError";
+			}
+		};
+		async function writeSettingsField(scope, field, value, landed) {
+			if (await scope.set(field, value) === false) throw new TraeSettingsWriteError(field, "the Host refused the write");
+			if (!landed(unwrapVolatileDeep(scope.getSnapshot().value))) throw new TraeSettingsWriteError(field);
+		}
+		/** Read one region's stored `regions` slot out of an unwrapped settings value. */
+		function regionSlotsOf(value) {
+			const regions = value?.regions;
+			return typeof regions === "object" && regions !== null ? regions : {};
+		}
 		/** Inject the shared card CSS once. */
 		if (typeof document !== "undefined") {
 			const cssId = "dsh-connect-trae/client.css";
@@ -271,9 +355,9 @@ window.__ModuleLoader__.load({
 			return { background: status === "signed-in" ? "var(--dsw-alias-state-success-primary, #22a06b)" : status === "error" ? "var(--dsw-alias-state-error-primary, #d92d20)" : "var(--dsw-alias-label-dimmed, #9aa0a6)" };
 		}
 		/** Render Trae sign-in state and the total usage summary as one expandable card. */
-		function TraeUsageCard({ t, settingsScope }) {
+		function TraeUsageCard({ t, settingsScope, view }) {
 			if (t === void 0) throw new Error("Trae usage card requires its translation function");
-			const [open, setOpen] = (0, react.useState)(false);
+			const [open, setOpen] = (0, react.useState)(view === "page");
 			/** The region whose tab is on screen; each tab is its own provider stack. */
 			const [activeRegion, setActiveRegion] = (0, react.useState)("cn");
 			/** Last-known usage per region, so tab dots survive tab switches. */
@@ -304,6 +388,12 @@ window.__ModuleLoader__.load({
 			const [claiming, setClaiming] = (0, react.useState)(false);
 			/** Last claim refusal, shown until the next successful refresh. */
 			const [claimError, setClaimError] = (0, react.useState)(void 0);
+			/**
+			* A refused or unpersisted settings write, surfaced instead of silently
+			* reverting. On 0.1.7 a rejected write resolves normally, so without this
+			* the control would flip and then quietly snap back on the next snapshot.
+			*/
+			const [writeError, setWriteError] = (0, react.useState)(void 0);
 			const mounted = (0, react.useRef)(true);
 			(0, react.useEffect)(() => {
 				mounted.current = true;
@@ -399,6 +489,7 @@ window.__ModuleLoader__.load({
 			]);
 			const rescanAccounts = async () => {
 				setBusy(true);
+				setWriteError(void 0);
 				try {
 					const response = await fetch(withTraeRegion(TRAE_ACCOUNTS_REFRESH_PATH, activeRegion), {
 						method: "POST",
@@ -409,11 +500,13 @@ window.__ModuleLoader__.load({
 					if (!response.ok || !Array.isArray(body.accounts)) throw new Error(`HTTP ${response.status}`);
 					const selected = body.accounts.find((account) => account.selected)?.id;
 					const configured = configuredAccountsOf(settingsScope?.getSnapshot().value);
-					if (selected !== void 0 && selected !== configured[activeRegion] && settingsScope?.getSnapshot().writable === true) await settingsScope.set("accounts", {
+					if (selected !== void 0 && selected !== configured[activeRegion] && settingsScope !== void 0 && settingsScope.getSnapshot().writable === true) await writeSettingsField(settingsScope, "accounts", {
 						...configured,
 						[activeRegion]: selected
-					});
+					}, (readBack) => configuredAccountsOf(readBack)[activeRegion] === selected);
 					await refreshUsage(activeRegion);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
 				} finally {
 					if (mounted.current) setBusy(false);
 				}
@@ -421,13 +514,15 @@ window.__ModuleLoader__.load({
 			const switchAccount = async (accountId) => {
 				if (settingsScope === void 0) return;
 				setSwitchingAccount(true);
+				setWriteError(void 0);
 				try {
-					const configured = configuredAccountsOf(settingsScope.getSnapshot().value);
-					await settingsScope.set("accounts", {
-						...configured,
+					await writeSettingsField(settingsScope, "accounts", {
+						...configuredAccountsOf(settingsScope.getSnapshot().value),
 						[activeRegion]: accountId
-					});
+					}, (readBack) => configuredAccountsOf(readBack)[activeRegion] === accountId);
 					await refreshUsage(activeRegion);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
 				} finally {
 					if (mounted.current) setSwitchingAccount(false);
 				}
@@ -474,8 +569,11 @@ window.__ModuleLoader__.load({
 			const toggleRegion = async (item, enabled) => {
 				if (settingsScope === void 0 || settingsScope.getSnapshot().writable !== true) return;
 				setTogglingRegion(item);
+				setWriteError(void 0);
 				try {
-					await settingsScope.set("regions", nextRegionEnabled(settingsScope.getSnapshot().value, item, enabled));
+					await writeSettingsField(settingsScope, "regions", nextRegionEnabled(settingsScope.getSnapshot().value, item, enabled), (readBack) => regionSlotsOf(readBack)[item] !== void 0 && regionSlotsOf(readBack)[item].enabled === enabled);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
 				} finally {
 					if (mounted.current) setTogglingRegion(void 0);
 				}
@@ -523,7 +621,7 @@ window.__ModuleLoader__.load({
 					if (mounted.current) setBusy(false);
 				}
 			};
-			const settingsValue = settingsScope?.getSnapshot().value;
+			const settingsValue = unwrapVolatileDeep(settingsScope?.getSnapshot().value);
 			const region = activeRegion;
 			const configuredRegions = typeof settingsValue === "object" && settingsValue !== null && typeof settingsValue.regions === "object" && settingsValue.regions !== null ? settingsValue.regions : {};
 			const regionSlot = configuredRegions[region];
@@ -594,9 +692,10 @@ window.__ModuleLoader__.load({
 			const saveModels = async () => {
 				if (settingsScope === void 0) return;
 				setSaving(true);
+				setWriteError(void 0);
 				try {
 					if (status.status !== "signed-in") return;
-					await settingsScope.set("regions", nextRegionSlots(configuredRegions, activeRegion, {
+					const nextSlot = {
 						enabled: regionOn(activeRegion),
 						lastCatalog: visibleModels.map((model) => ({
 							...model,
@@ -605,9 +704,15 @@ window.__ModuleLoader__.load({
 						enabledModelIds: [...activeEnabledIds],
 						imageModelIds: [...activeImageIds].filter((id) => activeEnabledIds.has(id)),
 						contextBudgets: activeContextBudgets
-					}));
+					};
+					await writeSettingsField(settingsScope, "regions", nextRegionSlots(configuredRegions, activeRegion, nextSlot), (readBack) => {
+						const ids = regionSlotsOf(readBack)[activeRegion]?.enabledModelIds;
+						return Array.isArray(ids) && ids.length === nextSlot.enabledModelIds.length && nextSlot.enabledModelIds.every((id) => ids.includes(id));
+					});
 					discardModels();
 					await refreshUsage(activeRegion);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
 				} finally {
 					if (mounted.current) setSaving(false);
 				}
@@ -642,8 +747,7 @@ window.__ModuleLoader__.load({
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							"aria-hidden": "true",
-							className: `dsm-plugin-card-chevron${open ? " dsm-plugin-card-chevron-open" : ""}`,
-							children: (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { size: 14 })
+							className: `dsm-plugin-card-chevron${open ? " dsm-plugin-card-chevron-open" : ""}`
 						})
 					]
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -695,6 +799,11 @@ window.__ModuleLoader__.load({
 								className: "dsm-trae-tab-hint",
 								children: t("row.tabHint")
 							}),
+							writeError === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dsm-trae-usage-error",
+								role: "alert",
+								children: t("row.settingsWriteFailed", { message: writeError })
+							}),
 							regionOn(activeRegion) ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								className: "dsm-trae-tab-off-notice",
 								role: "status",
@@ -1069,6 +1178,7 @@ window.__ModuleLoader__.load({
 			"row.tabSwitchHint": "Uncheck to switch this provider off. Its models disappear from the DSH model picker; its account, usage, and model settings are kept and return when you check it again.",
 			"row.tabSwitchAria": "Offer the {region} provider to DSH",
 			"row.tabOffNotice": "This provider is switched off: none of its models are offered to DSH. Your account, usage, and model settings are kept — check the box above the tab to bring it back.",
+			"row.settingsWriteFailed": "The setting was not saved: {message}",
 			"row.signedOut": "Not signed in",
 			"row.signedOutHint": "Sign in once in the Trae desktop app; this plugin follows that sign-in automatically.",
 			"row.searchedTitle": "Paths checked",
@@ -1146,6 +1256,7 @@ window.__ModuleLoader__.load({
 			"row.tabSwitchHint": "取消勾选即关闭该供应商：它的模型不再出现在 DSH 模型选择器里；账号、用量与模型设置都会保留，重新勾选即恢复。",
 			"row.tabSwitchAria": "是否向 DSH 提供{region}供应商",
 			"row.tabOffNotice": "该供应商已关闭：它的模型不会提供给 DSH。账号、用量与模型设置均已保留——勾选上方复选框即可恢复。",
+			"row.settingsWriteFailed": "设置未能保存：{message}",
 			"row.signedOut": "未登录",
 			"row.signedOutHint": "在 Trae 桌面 App 里登录一次即可，插件会自动跟随当前登录的账号。",
 			"row.searchedTitle": "已检查的路径",
@@ -1216,12 +1327,16 @@ window.__ModuleLoader__.load({
 		//#region src/client/index.tsx
 		/** Stable browser-plugin name. */
 		const name = "dsh-connect-trae-client";
-		/** Client services required by the Plugin configuration contribution. */
-		const inject = [
-			"slots",
-			"locale",
-			"settingsScope"
-		];
+		/**
+		* Client services required by the Plugin configuration contribution.
+		*
+		* Deliberately only the two services the 0.1.7 line provides unconditionally:
+		* `slots` (card injection) and `locale` (copy). The settings surface is probed
+		* through `ctx.get()` (which returns undefined, never throws, for an absent
+		* service), so the card degrades to read-only rather than failing to load if
+		* configForms is not served yet.
+		*/
+		const inject = ["slots", "locale"];
 		/**
 		* Register card copy and the Trae card under Plugin configuration.
 		*
@@ -1234,6 +1349,8 @@ window.__ModuleLoader__.load({
 		* NOTE: the try/catch boundary of this function is mirrored (duplicated) in
 		* `tests/client-fallback.spec.ts`, because the real client entry imports
 		* browser-only DSH packages that cannot load in the Node test environment.
+		* If you change the guarded body, the soft probe, or the per-slot
+		* registration here, update that mirror too.
 		*/
 		function apply(ctx) {
 			try {
@@ -1243,16 +1360,93 @@ window.__ModuleLoader__.load({
 					en
 				}), "dsh-connect-trae: settings copy");
 				const t = ctx.locale.bind(namespace);
-				const settingsScope = ctx.settingsScope.bind({ namespace: "trae" });
-				ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
-					name: "settings.plugin.item",
-					key: "trae",
-					priority: 30,
-					inject: () => ({
-						t,
-						settingsScope
-					})
-				}, TraeUsageCard));
+				const softGet = (name) => ctx.get(name);
+				const forms = softGet("configForms");
+				/**
+				* The card's settings scope, bound to whichever namespace the Host actually
+				* serves — resolved from the describe mirror, and RE-BOUND whenever the
+				* mirror changes.
+				*
+				* The mirror answers asynchronously relative to this plugin's `apply()`
+				* (and, on a profile reload, may gain namespaces that did not exist at
+				* boot — this plugin's entry is exactly such a case). Resolving the
+				* namespace ONCE at apply time and falling back to the declared constant
+				* is a real failure: the form controller is bound to its namespace forever,
+				* so a card whose entry appeared after the mirror's first load writes to
+				* `trae` — a namespace the host does not serve — and every write is
+				* refused (`No configurable plugin entry "trae"`), while the controls stay
+				* enabled (the mirror reports global `writable` even when the namespace is
+				* missing).
+				*
+				* The scope therefore forwards every read/write to the CURRENT controller:
+				* once the mirror lists the trae namespace (any name matching `/trae/i`,
+				* e.g. `dsh-connect-trae` or `include:dsh-connect-trae`), the card lands on
+				* the right namespace and re-renders through its own subscription. Before
+				* the mirror answers, the scope reports `writable: false` so the card is
+				* read-only rather than offering controls that cannot save.
+				*/
+				const settingsScope = (() => {
+					let current;
+					let currentOff;
+					let refreshedOnce = false;
+					const listeners = /* @__PURE__ */ new Set();
+					const notify = () => {
+						for (const listener of [...listeners]) listener();
+					};
+					const scope = {
+						getSnapshot: () => current?.getSnapshot() ?? {
+							status: "unavailable",
+							value: void 0,
+							writable: false
+						},
+						subscribe: (listener) => {
+							listeners.add(listener);
+							return () => {
+								listeners.delete(listener);
+							};
+						},
+						set: (field, value) => current !== void 0 ? current.set(field, value) : Promise.resolve(false)
+					};
+					const rebind = () => {
+						let served;
+						try {
+							served = (forms?.describe().getSnapshot().view?.namespaces ?? []).find((entry) => entry.ns === "trae" || /trae/i.test(entry.ns));
+						} catch {}
+						const next = served === void 0 || forms === void 0 ? void 0 : forms.get(served.ns);
+						if (next !== current) {
+							currentOff?.();
+							current = next;
+							currentOff = current?.subscribe(notify);
+							notify();
+						}
+						if (next === void 0 && !refreshedOnce) {
+							refreshedOnce = true;
+							try {
+								(forms?.describe()).load?.();
+							} catch {}
+						}
+					};
+					rebind();
+					forms?.describe().subscribe?.(rebind);
+					return scope;
+				})();
+				const registerCard = (slotName, key) => {
+					try {
+						ctx.slots.inject(slotName, () => ctx.slots.register({
+							name: slotName,
+							key,
+							priority: 30,
+							inject: () => ({
+								t,
+								settingsScope
+							})
+						}, TraeUsageCard));
+					} catch (error) {
+						console.error(`[dsh-connect-trae] card slot "${slotName}" failed to register (host provider unaffected):`, error);
+					}
+				};
+				registerCard("plugins.bundle.config", "dsh-connect-trae");
+				registerCard("plugins.row.config", "dsh-connect-trae#dsh-connect-trae");
 			} catch (error) {
 				console.error("[dsh-connect-trae] client card failed to load (host provider unaffected):", error);
 			}

package/lib/index.d.ts

@@ -175,6 +175,13 @@ interface TraeWireModel {
   contextWindow?: number;
   maxTokens?: number;
   reasoning?: TraeReasoningCapability;
+  /**
+   * Effective (post-discount) credit multiplier, read from the row's
+   * `display_contact_config` — the figure the Trae IDE renders (see
+   * `wireCreditMultiplier` in solo.ts). Wins over the Remote directory's own
+   * `consumption_rate`, which reports the undiscounted value.
+   */
+  creditMultiplier?: number;
   /**
    * The `get_detail_param` function this config_name came from. Trae splits its
    * callable roster across several functions (SOLO modes), and a model is only
@@ -191,12 +198,19 @@ interface TraeWireModel {
  * skeleton: it supplies the display id, display name, context windows, credit
  * multiplier, reasoning and multimodal flags. `wire` (from `get_detail_param`)
  * supplies the real `llm_utils_chat` `config_name` — the only id the chat
- * endpoint actually accepts. A remote row is only callable when it maps to a
- * wire `config_name`, so a remote row with no wire match is DROPPED (it would
- * otherwise be sent as an invalid `config_name` and rejected with 4001
- * "param is invalid"). Verified 2026-08-30: the Remote directory advertises
- * `Doubao-Seed-Code` and `glm-5.3`, neither of which is a current `config_name`;
- * both fail every request, so they must not be exposed.
+ * endpoint actually accepts — plus the authoritative post-discount credit
+ * multiplier when `display_contact_config` carries one. A remote row is only
+ * callable when it maps to a wire `config_name`, so a remote row with no wire
+ * match is DROPPED (it would otherwise be sent as an invalid `config_name` and
+ * rejected with 4001 "param is invalid"). Verified 2026-08-30: the Remote
+ * directory advertises `Doubao-Seed-Code` and `glm-5.3`, neither of which is a
+ * current `config_name`; both fail every request, so they must not be exposed.
+ *
+ * Credit multiplier precedence: the wire's `display_contact_config` rate wins
+ * whenever present (it is the post-discount figure the Trae IDE renders — the
+ * Remote directory can report up to 10x the undiscounted value, see
+ * `wireCreditMultiplier` in solo.ts); the Remote `consumption_rate` is the
+ * fallback when the wire row carries none.
  *
  * Joining is two-tier, in priority order:
  *  1. `wire.id` (the `config_name`) equals the remote id — the model's display
@@ -1054,6 +1068,8 @@ interface TraeSoloModel {
   contextWindow?: number;
   maxTokens?: number;
   reasoning?: TraeReasoningCapability;
+  /** Effective (post-discount) credit multiplier, as the Trae IDE shows it. */
+  creditMultiplier?: number;
   /** The directory function that listed this config (replayed when calling it). */
   function?: string;
 }
@@ -1435,6 +1451,31 @@ interface TraeWebSearchPath {
   reason: 'missing' | 'unreadable' | 'invalid';
   message?: string;
 }
+/**
+ * Peel ONE `{get(): T}` live reference, the shape DSH 0.1.7 delivers a
+ * volatile-marked settings field as (see {@link unwrapVolatileDeep}).
+ */
+declare function unwrapVolatile<T>(value: T): T;
+/**
+ * Deep copy of a value with every `{get(): T}` live reference replaced by the
+ * value it resolves to.
+ *
+ * DSH 0.1.7 hands volatile-marked fields back as live references, and a live
+ * reference is still `typeof === 'object'` — so it passes a naive object check
+ * and every lookup on it is `undefined`. Worse, spreading one (`{ ...ref }`)
+ * does NOT read the field: it produces `{ get: <function> }`. Any merge that
+ * spreads a resolved field to preserve its siblings — the card's "write one
+ * region, keep the other" write, or the account map's spread — would otherwise
+ * DROP every sibling and leak a function into the document.
+ *
+ * Both halves therefore unwrap before touching a resolved field. This lives in
+ * the node-free host↔client bridge because the browser half needs it too.
+ *
+ * Non-reference values are recursed into so a nested volatile field is caught
+ * as well; arrays and objects are rebuilt rather than mutated, so the caller's
+ * value is never touched.
+ */
+declare function unwrapVolatileDeep<T>(value: T): T;
 /**
  * Build the next `regions` settings value for the card's save. The write
  * targets ONLY the signed-in account's region slot; every other region's slot
@@ -1573,13 +1614,30 @@ declare const name = "dsh-connect-trae";
 declare const inject: string[];
 /**
  * Settings namespace, as a plain lowercase literal. DSH 0.1.2 removed the
- * `settingsNamespace` brand constructor from the npm package (the Desktop
- * host still ships it as a legacy shim), and every consumer of this constant —
- * `registerModelDiscovery`, `registerConfigurableProviders`,
- * `settings.installSection`, the settings test — takes it as a kebab string,
- * so no branding is needed for either host generation.
+ * `settingsNamespace` brand constructor from the npm package, and every
+ * consumer of this constant takes it as a kebab string — so no branding is
+ * needed. It is the FALLBACK namespace; the namespace the host actually serves
+ * comes from {@link settingsNamespaceOf} (0.1.7 keys settings by the Loader
+ * entry id, which a profile patch may mount as `dsh-connect-trae` or
+ * `include:dsh-connect-trae`).
  */
 declare const TRAE_SETTINGS_NS = "trae";
+/**
+ * The namespace the HOST actually serves this plugin under.
+ *
+ * On DSH 0.1.7 `SettingsForms.describe()` keys every namespace by the Loader
+ * entry id, and the harness looks a provider's namespace up by EXACT match —
+ * advertising `trae` while the host serves `include:dsh-connect-trae` made the
+ * provider read as "not configured": its configure affordance and model
+ * discovery both silently went dead.
+ *
+ * `ctx.fiber.entry` is added by the Loader, not by Cordis itself, so it is not
+ * in Cordis's public types and is absent on hosts that mount a plugin without a
+ * Loader entry (a test harness, or `ctx.plugin()` called directly). Hence the
+ * probe plus the documented fallback, mirroring the first-party plugins:
+ * `const settingsNs = ctx.fiber.entry?.options.id ?? NS`.
+ */
+declare function settingsNamespaceOf(ctx: unknown): string;
 /** One region's saved model state: its own directory and the user's selection within it. */
 interface TraeRegionState {
   /**
@@ -1655,7 +1713,22 @@ declare function regionStateOf(config: Config, region: TraeRegion): TraeRegionSt
  * disagree about a region's state.
  */
 declare function regionEnabled(config: Config, region: TraeRegion): boolean;
+/**
+ * Mark a schema's field as volatile.
+ *
+ * `volatile()` exists from schemastery 3.18.3; since 2.3.0 the peer range
+ * requires `>=3.18.4`, so it is always present on a supported host. The probe
+ * is kept as a safety net for a consumer that resolves an older schemastery
+ * anyway (where the helper must degrade to identity — hand-writing
+ * `meta.volatile = true` would bypass schemastery's own `validateVolatileSchema`
+ * checks) and to keep both arms deterministically testable.
+ *
+ * Without the marker, 0.1.7's settings write gate REJECTS every write with
+ * `Plugin entry "trae" has no volatile fields` while the scope's `set()` still
+ * resolves — so the card would look like it saved and silently revert.
+ */
+declare function asVolatile<S>(schema: S): S;
 declare const Config: z<Config>;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeRefreshDevice, type TraeRegion, type TraeRegionGateways, TraeRegionState, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, withTraeRegion };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeRefreshDevice, type TraeRegion, type TraeRegionGateways, TraeRegionState, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };

package/lib/index.js

@@ -1,5 +1,4 @@
 import z from "@deepseek-ai/schemastery";
-import * as dshSettings from "@deepseek-ai/dsh-settings";
 import { createProvider } from "@earendil-works/pi-ai";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
@@ -150,12 +149,19 @@ function displayKey(name) {
 * skeleton: it supplies the display id, display name, context windows, credit
 * multiplier, reasoning and multimodal flags. `wire` (from `get_detail_param`)
 * supplies the real `llm_utils_chat` `config_name` — the only id the chat
-* endpoint actually accepts. A remote row is only callable when it maps to a
-* wire `config_name`, so a remote row with no wire match is DROPPED (it would
-* otherwise be sent as an invalid `config_name` and rejected with 4001
-* "param is invalid"). Verified 2026-08-30: the Remote directory advertises
-* `Doubao-Seed-Code` and `glm-5.3`, neither of which is a current `config_name`;
-* both fail every request, so they must not be exposed.
+* endpoint actually accepts — plus the authoritative post-discount credit
+* multiplier when `display_contact_config` carries one. A remote row is only
+* callable when it maps to a wire `config_name`, so a remote row with no wire
+* match is DROPPED (it would otherwise be sent as an invalid `config_name` and
+* rejected with 4001 "param is invalid"). Verified 2026-08-30: the Remote
+* directory advertises `Doubao-Seed-Code` and `glm-5.3`, neither of which is a
+* current `config_name`; both fail every request, so they must not be exposed.
+*
+* Credit multiplier precedence: the wire's `display_contact_config` rate wins
+* whenever present (it is the post-discount figure the Trae IDE renders — the
+* Remote directory can report up to 10x the undiscounted value, see
+* `wireCreditMultiplier` in solo.ts); the Remote `consumption_rate` is the
+* fallback when the wire row carries none.
 *
 * Joining is two-tier, in priority order:
 *  1. `wire.id` (the `config_name`) equals the remote id — the model's display
@@ -177,12 +183,13 @@ function mergeTraeModelSources(remote, wire) {
 	for (const model of remote) {
 		const wireModel = wireById.get(displayKey(model.id)) ?? wireByName.get(displayKey(model.name));
 		if (wireModel === void 0) continue;
+		const creditMultiplier = wireModel.creditMultiplier ?? model.creditMultiplier;
 		result.push({
 			id: model.id,
 			name: model.name,
 			...model.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow },
 			...model.maxContextWindow === void 0 ? {} : { maxContextWindow: model.maxContextWindow },
-			...model.creditMultiplier === void 0 ? {} : { creditMultiplier: model.creditMultiplier },
+			...creditMultiplier === void 0 ? {} : { creditMultiplier },
 			input: ["text"],
 			reasoningSupported: model.reasoningSupported,
 			...model.reasoning === void 0 ? {} : {
@@ -1934,6 +1941,39 @@ function prepareSoloBody(source, defaultModel = "glm-5.2", functionName) {
 	}
 	return JSON.stringify(body);
 }
+/**
+* Read the effective credit multiplier from a `get_detail_param` row.
+*
+* The rate the Trae IDE renders lives in `display_contact_config` — a *string*
+* holding a second JSON document — and its `consumption_rate.data.rate` is
+* already the post-discount value (verified 2026-09-13, commit 1.4.2: the
+* Remote directory reports the undiscounted figure, e.g. `0.8`, while the IDE
+* and this field both say `0.08` under a 限时 1 折 promotion — up to a 10x
+* difference). The wire figure therefore wins over the Remote one during the
+* merge; this parser is what feeds it.
+*
+* The international (ai) gateway serves no `consumption_rate` anywhere (its
+* subscription models carry only `features.cost` tags), so rows without the
+* field keep their bare name — parsed-but-absent, never fabricated.
+*/
+function wireCreditMultiplier(config) {
+	const raw = config["display_contact_config"];
+	if (typeof raw !== "string" || raw === "") return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const consumption = parsed["consumption_rate"];
+	if (typeof consumption !== "object" || consumption === null) return void 0;
+	const entry = consumption;
+	if (entry["enable"] !== true) return void 0;
+	const data = entry["data"];
+	if (typeof data !== "object" || data === null) return void 0;
+	return finitePositive$1(data["rate"]);
+}
 var TraeSoloUpstreamClient = class {
 	options;
 	fetchImpl;
@@ -2012,6 +2052,7 @@ var TraeSoloUpstreamClient = class {
 				...config,
 				...detail
 			});
+			const creditMultiplier = wireCreditMultiplier(config);
 			if (byId.has(id)) continue;
 			byId.set(id, {
 				id,
@@ -2019,6 +2060,7 @@ var TraeSoloUpstreamClient = class {
 				...contextWindow === void 0 ? {} : { contextWindow },
 				...maxTokens === void 0 ? {} : { maxTokens },
 				...reasoning === void 0 ? {} : { reasoning },
+				...creditMultiplier === void 0 ? {} : { creditMultiplier },
 				function: directoryFunction
 			});
 		}
@@ -3269,6 +3311,42 @@ function regionOfTraeStatusUrl(url) {
 	return TRAE_REGIONS.includes(value) ? value : void 0;
 }
 /**
+* Peel ONE `{get(): T}` live reference, the shape DSH 0.1.7 delivers a
+* volatile-marked settings field as (see {@link unwrapVolatileDeep}).
+*/
+function unwrapVolatile(value) {
+	if (value !== null && typeof value === "object" && typeof value.get === "function") return value.get();
+	return value;
+}
+/**
+* Deep copy of a value with every `{get(): T}` live reference replaced by the
+* value it resolves to.
+*
+* DSH 0.1.7 hands volatile-marked fields back as live references, and a live
+* reference is still `typeof === 'object'` — so it passes a naive object check
+* and every lookup on it is `undefined`. Worse, spreading one (`{ ...ref }`)
+* does NOT read the field: it produces `{ get: <function> }`. Any merge that
+* spreads a resolved field to preserve its siblings — the card's "write one
+* region, keep the other" write, or the account map's spread — would otherwise
+* DROP every sibling and leak a function into the document.
+*
+* Both halves therefore unwrap before touching a resolved field. This lives in
+* the node-free host↔client bridge because the browser half needs it too.
+*
+* Non-reference values are recursed into so a nested volatile field is caught
+* as well; arrays and objects are rebuilt rather than mutated, so the caller's
+* value is never touched.
+*/
+function unwrapVolatileDeep(value) {
+	if (value === null || typeof value !== "object") return value;
+	if (typeof value.get === "function") return unwrapVolatileDeep(value.get());
+	if (Array.isArray(value)) return value.map((entry) => unwrapVolatileDeep(entry));
+	const source = value;
+	const out = {};
+	for (const key of Object.keys(source)) out[key] = unwrapVolatileDeep(source[key]);
+	return out;
+}
+/**
 * Build the next `regions` settings value for the card's save. The write
 * targets ONLY the signed-in account's region slot; every other region's slot
 * is carried over untouched, so switching accounts never clobbers the other
@@ -3276,8 +3354,9 @@ function regionOfTraeStatusUrl(url) {
 * from an empty document.
 */
 function nextRegionSlots(regions, region, slot) {
+	const unwrapped = unwrapVolatileDeep(regions);
 	return {
-		...typeof regions === "object" && regions !== null && !Array.isArray(regions) ? regions : {},
+		...typeof unwrapped === "object" && unwrapped !== null && !Array.isArray(unwrapped) ? unwrapped : {},
 		[region]: slot
 	};
 }
@@ -3288,17 +3367,23 @@ function nextRegionSlots(regions, region, slot) {
 * where the map was expected was a real shipped bug — the lookup then read
 * `section['cn']` (absent), so the card's checkbox reported `true` forever and
 * clicking it appeared to do nothing even though the write succeeded.
+*
+* Unwraps live references first: on DSH 0.1.7 the `regions` field arrives as a
+* `{get(): T}` reference, which passes the `typeof === 'object'` check below
+* and would otherwise be returned as if it were the map — making every region
+* read back as absent (and the enabled flag read as "on" forever).
 */
 function regionsMapOf(value) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
-	const record = value;
+	const unwrapped = unwrapVolatileDeep(value);
+	if (typeof unwrapped !== "object" || unwrapped === null || Array.isArray(unwrapped)) return {};
+	const record = unwrapped;
 	const nested = record["regions"];
 	if (typeof nested === "object" && nested !== null && !Array.isArray(nested)) return nested;
 	return record;
 }
 /** One region's stored slot as a plain object; any other shape reads as empty. */
 function regionSlotOf(value, region) {
-	const slot = regionsMapOf(value)[region];
+	const slot = unwrapVolatile(regionsMapOf(value)[region]);
 	return typeof slot === "object" && slot !== null && !Array.isArray(slot) ? slot : {};
 }
 /**
@@ -3718,14 +3803,34 @@ const name = "dsh-connect-trae";
 const inject = ["llm"];
 /**
 * Settings namespace, as a plain lowercase literal. DSH 0.1.2 removed the
-* `settingsNamespace` brand constructor from the npm package (the Desktop
-* host still ships it as a legacy shim), and every consumer of this constant —
-* `registerModelDiscovery`, `registerConfigurableProviders`,
-* `settings.installSection`, the settings test — takes it as a kebab string,
-* so no branding is needed for either host generation.
+* `settingsNamespace` brand constructor from the npm package, and every
+* consumer of this constant takes it as a kebab string — so no branding is
+* needed. It is the FALLBACK namespace; the namespace the host actually serves
+* comes from {@link settingsNamespaceOf} (0.1.7 keys settings by the Loader
+* entry id, which a profile patch may mount as `dsh-connect-trae` or
+* `include:dsh-connect-trae`).
 */
 const TRAE_SETTINGS_NS = "trae";
 /**
+* The namespace the HOST actually serves this plugin under.
+*
+* On DSH 0.1.7 `SettingsForms.describe()` keys every namespace by the Loader
+* entry id, and the harness looks a provider's namespace up by EXACT match —
+* advertising `trae` while the host serves `include:dsh-connect-trae` made the
+* provider read as "not configured": its configure affordance and model
+* discovery both silently went dead.
+*
+* `ctx.fiber.entry` is added by the Loader, not by Cordis itself, so it is not
+* in Cordis's public types and is absent on hosts that mount a plugin without a
+* Loader entry (a test harness, or `ctx.plugin()` called directly). Hence the
+* probe plus the documented fallback, mirroring the first-party plugins:
+* `const settingsNs = ctx.fiber.entry?.options.id ?? NS`.
+*/
+function settingsNamespaceOf(ctx) {
+	const id = ctx?.fiber?.entry?.options?.id;
+	return typeof id === "string" && id !== "" ? id : TRAE_SETTINGS_NS;
+}
+/**
 * One region's saved state. A config written before the region split has only
 * the flat fields: those were always captured from the CN endpoint (the
 * plugin had no international support), so they are read as the CN state and
@@ -3735,7 +3840,7 @@ const TRAE_SETTINGS_NS = "trae";
 * picks (the same failure workbuddy fixed with its region split).
 */
 function regionStateOf(config, region) {
-	const stored = config.regions?.[region];
+	const stored = unwrapVolatile(unwrapVolatile(config.regions)?.[region]);
 	if (stored !== void 0) return stored;
 	if (region !== "cn") return {};
 	return {
@@ -3756,6 +3861,24 @@ function regionStateOf(config, region) {
 function regionEnabled(config, region) {
 	return regionStateOf(config, region).enabled !== false;
 }
+/**
+* Mark a schema's field as volatile.
+*
+* `volatile()` exists from schemastery 3.18.3; since 2.3.0 the peer range
+* requires `>=3.18.4`, so it is always present on a supported host. The probe
+* is kept as a safety net for a consumer that resolves an older schemastery
+* anyway (where the helper must degrade to identity — hand-writing
+* `meta.volatile = true` would bypass schemastery's own `validateVolatileSchema`
+* checks) and to keep both arms deterministically testable.
+*
+* Without the marker, 0.1.7's settings write gate REJECTS every write with
+* `Plugin entry "trae" has no volatile fields` while the scope's `set()` still
+* resolves — so the card would look like it saved and silently revert.
+*/
+function asVolatile(schema) {
+	if (typeof schema.volatile === "function") return schema.volatile();
+	return schema;
+}
 const modelConfig = z.object({
 	id: z.string().required(),
 	name: z.string().required(),
@@ -3777,17 +3900,17 @@ const accountSelectionConfig = z.object({
 	ai: z.string().description("Selected international account id (never a token)")
 });
 const Config = z.object({
-	authFile: z.string().description("Optional Trae storage.json path override"),
-	edition: z.union([
+	authFile: asVolatile(z.string().description("Optional Trae storage.json path override")),
+	edition: asVolatile(z.union([
 		"auto",
 		"cn",
 		"sg",
 		"solo",
 		"solo-sg"
-	]).default("auto").description("Trae edition hint"),
+	]).default("auto").description("Trae edition hint")),
 	accountId: z.string().description("Deprecated: pre-split account selector, attributed to its own region"),
-	accounts: accountSelectionConfig.description("Per-region account selections, keyed cn | ai"),
-	regions: z.dict(regionStateConfig).default({}).description("Per-region model directory and selection, keyed cn | ai"),
+	accounts: asVolatile(accountSelectionConfig.description("Per-region account selections, keyed cn | ai")),
+	regions: asVolatile(z.dict(regionStateConfig).default({}).description("Per-region model directory and selection, keyed cn | ai")),
 	lastCatalog: z.array(modelConfig).description("Deprecated: pre-region-split CN model directory"),
 	enabledModelIds: z.array(z.string()).default([]).description("Deprecated: pre-region-split CN selection"),
 	contextBudgets: z.dict(z.number().step(1).min(1)).default({}).description("Deprecated: pre-region-split CN context budgets"),
@@ -3797,6 +3920,7 @@ const Config = z.object({
 /** Every region, in card tab order. */
 const REGION_KEYS = ["cn", "ai"];
 function apply(ctx, config) {
+	const settingsNs = settingsNamespaceOf(ctx);
 	let current = () => config;
 	const enabledSet = (value, region) => new Set(regionStateOf(value, region).enabledModelIds ?? []);
 	const imageSet = (value, region) => new Set(regionStateOf(value, region).imageModelIds ?? []);
@@ -3846,7 +3970,7 @@ function apply(ctx, config) {
 	*/
 	let legacyAccountRegion;
 	const effectiveAccountFor = (region, value) => {
-		const explicit = value.accounts?.[region];
+		const explicit = unwrapVolatile(value.accounts)?.[region];
 		if (explicit !== void 0) return explicit;
 		return legacyAccountRegion === region ? value.accountId : void 0;
 	};
@@ -3887,10 +4011,12 @@ function apply(ctx, config) {
 			try {
 				preferred = (await store.current())?.edition;
 			} catch {}
-			const hint = (config.edition !== void 0 && config.edition !== "auto" ? config.edition : void 0) ?? preferred;
-			return resolveTraeIdentity(config.authFile === void 0 ? traeStorageCandidates().filter((item) => item.source === "desktop" && (hint !== void 0 ? item.edition === hint : regionOfEdition(item.edition) === region)) : [{
+			const authFile = unwrapVolatile(config.authFile);
+			const edition = unwrapVolatile(config.edition);
+			const hint = (edition !== void 0 && edition !== "auto" ? edition : void 0) ?? preferred;
+			return resolveTraeIdentity(authFile === void 0 ? traeStorageCandidates().filter((item) => item.source === "desktop" && (hint !== void 0 ? item.edition === hint : regionOfEdition(item.edition) === region)) : [{
 				edition: hint ?? (region === "ai" ? "sg" : "solo"),
-				path: config.authFile,
+				path: authFile,
 				source: "desktop"
 			}], hint ?? (region === "ai" ? "solo-sg" : "cn"));
 		};
@@ -3912,8 +4038,8 @@ function apply(ctx, config) {
 		};
 		const store = new TraeCredentialStore({
 			region,
-			...config.authFile === void 0 ? {} : { storagePath: config.authFile },
-			edition: config.edition ?? "auto",
+			...unwrapVolatile(config.authFile) === void 0 ? {} : { storagePath: unwrapVolatile(config.authFile) },
+			edition: unwrapVolatile(config.edition) ?? "auto",
 			refresh: async (credential) => refreshTraeCredential(credential, void 0, await refreshDeviceSafe())
 		});
 		const solo = new TraeSoloUpstreamClient({
@@ -4032,7 +4158,7 @@ function apply(ctx, config) {
 		registration.cn.directory?.replace(REGION_KEYS.filter((region) => regionEnabled(value, region)).map((region) => ({
 			provider: TRAE_PROVIDERS[region],
 			displayName: TRAE_PROVIDER_DISPLAY_NAMES[region],
-			settingsNs: TRAE_SETTINGS_NS,
+			settingsNs,
 			settingsPath: [],
 			declared: false
 		})));
@@ -4041,20 +4167,12 @@ function apply(ctx, config) {
 	const applySelection = (value) => {
 		for (const region of REGION_KEYS) {
 			const stack = stacks[region];
-			stack.store.setSource(value.authFile, value.edition ?? "auto", effectiveAccountFor(region, value));
+			stack.store.setSource(unwrapVolatile(value.authFile), unwrapVolatile(value.edition) ?? "auto", effectiveAccountFor(region, value));
 			stack.catalog.set(configuredModels(value, region));
 			stack.invalidateAdapter();
 		}
 		syncRegionRegistration(value);
 	};
-	const sectionHooks = {
-		setSource(source) {
-			current = source;
-		},
-		onChange() {
-			applySelection(current());
-		}
-	};
 	applySelection(config);
 	(async () => {
 		const id = current().accountId;
@@ -4067,10 +4185,12 @@ function apply(ctx, config) {
 			}
 		} catch {}
 	})();
-	const legacyInstallSettingsSection = dshSettings.installSettingsSection;
-	if (typeof legacyInstallSettingsSection === "function") legacyInstallSettingsSection(ctx, TRAE_SETTINGS_NS, Config, config, sectionHooks);
-	else ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.installSection(ctx, TRAE_SETTINGS_NS, Config, config, sectionHooks);
+	ctx.inject(["settings"], (settingsCtx) => {
+		const settings = settingsCtx.settings;
+		ctx.effect(() => settings.configure({ auto: true }, ctx.fiber));
+	});
+	ctx.on("loader/volatile-update", () => {
+		applySelection(current());
 	});
 	let stopped = false;
 	ctx.effect(() => () => {
@@ -4094,7 +4214,7 @@ function apply(ctx, config) {
 				};
 				registration[region].adapter = region === "cn" ? ctx.llm.registerAdapter([TRAE_PROVIDER], trae.adapter) : ctx.llm.registerAdapter([TRAE_AI_PROVIDER], trae.adapter);
 			}
-			ctx.llm.registerModelDiscovery(TRAE_SETTINGS_NS, async (request, signal) => {
+			ctx.llm.registerModelDiscovery(settingsNs, async (request, signal) => {
 				const region = regionOfTraeProvider(request.provider ?? "");
 				if (region === void 0) return [];
 				if (!regionEnabled(current(), region)) return [];
@@ -4110,7 +4230,7 @@ function apply(ctx, config) {
 			registration.cn.directory = ctx.llm.registerConfigurableProviders(REGION_KEYS.map((region) => ({
 				provider: TRAE_PROVIDERS[region],
 				displayName: TRAE_PROVIDER_DISPLAY_NAMES[region],
-				settingsNs: TRAE_SETTINGS_NS,
+				settingsNs,
 				settingsPath: [],
 				declared: false
 			})));
@@ -4153,4 +4273,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, SseDecoder, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, TraeCatalog, TraeCredentialStore, TraeDelegatingUpstreamClient, TraeFallbackUpstreamClient, TraeGatedUpstreamClient, TraeRawCapabilityController, TraeRawCapabilityState, TraeRawChatUpstreamClient, TraeSoloBridge, TraeSoloRemoteCatalogClient, TraeSoloUpstreamClient, TraeUsageClient, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, withTraeRegion };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, SseDecoder, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, TraeCatalog, TraeCredentialStore, TraeDelegatingUpstreamClient, TraeFallbackUpstreamClient, TraeGatedUpstreamClient, TraeRawCapabilityController, TraeRawCapabilityState, TraeRawChatUpstreamClient, TraeSoloBridge, TraeSoloRemoteCatalogClient, TraeSoloUpstreamClient, TraeUsageClient, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-trae",
   "displayName": "DSH Connect Trae",
   "description": "Connect locally signed-in Trae models to DeepSeek Harness, with a usage/credits summary and daily check-in claiming.",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "author": "dingminhua",
   "copyright": "Copyright (c) 2026 LaoDing",
   "license": "MIT",
@@ -20,6 +20,7 @@
   },
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
+  "icon": "icons/dsh-connect-trae-128.png",
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
@@ -31,6 +32,7 @@
   },
   "files": [
     "lib",
+    "icons",
     "docs/assets/dsh-connect-trae-usage-card.png",
     "screenshots.json",
     "cordis.patch.yml",
@@ -72,35 +74,35 @@
     "url": "https://github.com/dingminhua/dsh-connect-trae/issues"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-atomic-write": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-attachment": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-0 <0.2.0-0",
-    "@deepseek-ai/schemastery": "^3.18.1-rc.1",
+    "@deepseek-ai/cordis": ">=4.0.4 <5.0.0",
+    "@deepseek-ai/dsh-atomic-write": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-attachment": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/schemastery": ">=3.18.4 <4.0.0",
     "@earendil-works/pi-ai": ">=0.85.1",
     "react": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-atomic-write": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-atomic-write": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-home-paths": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@earendil-works/pi-ai": "^0.85.1",
     "@testing-library/dom": "^10.4.2",
     "@testing-library/react": "^16.3.3",