dsh-connect-trae 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## 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,25 @@ npm install dsh-connect-trae
 
 Restart the DSH process after install/update/uninstall.
 
+## DSH version compatibility
+
+**One build serves both the DSH 0.1.5 and 0.1.7 lines** — no per-version package.
+
+The two lines differ in their settings machinery, and the plugin probes for capability at runtime instead of assuming either:
+
+| | 0.1.5 line | 0.1.7 line |
+|---|---|---|
+| Client settings service | `settingsScope` | `configForms` |
+| Config card slots | `settings.plugin.item` | `plugins.bundle.config` / `plugins.row.config` |
+| Host registration | `installSection()` | `configure({auto}, owner)` |
+| Schema writable marker | not needed | `volatile()` required |
+| Primitives icon names | `…Outline14` | `…OutlineRegular` |
+
+Two decisions matter most:
+
+- **`inject` declares only the services BOTH lines provide** (`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 (0.1.7 removed `settingsScope`, which is why 2.1.0 and earlier sat at `pending (waiting for service: settingsScope)` on that line).
+- **The collapse caret is pure CSS**, with no static icon import: the two lines' icon names do not overlap, so any static import fails to resolve on one of them.
+
 ## 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,25 @@ npm install dsh-connect-trae
 
 安装、更新或卸载 bundle 后，需要重启对应的 DSH 进程。
 
+## DSH 版本兼容
+
+**同一个构建同时服务 DSH 0.1.5 与 0.1.7 两条线**，无需按版本安装不同的包。
+
+两条线的设置体系不同，插件在运行期按能力探测，而不是假定某一条：
+
+| | 0.1.5 线 | 0.1.7 线 |
+|---|---|---|
+| 客户端设置服务 | `settingsScope` | `configForms` |
+| 配置卡片槽位 | `settings.plugin.item` | `plugins.bundle.config` / `plugins.row.config` |
+| 宿主端注册 | `installSection()` | `configure({auto}, owner)` |
+| schema 可写声明 | 无需 | 必须标 `volatile()` |
+| primitives 图标名 | `…Outline14` | `…OutlineRegular` |
+
+两处关键做法：
+
+- **`inject` 只声明两条线都有的服务**（`slots` / `locale`），设置面用 `ctx.get()` 软探测。Cordis 的依赖闸门是硬闸——`inject` 里任一服务在运行线上不存在，`apply()` 就永远不会执行（0.1.7 上 `settingsScope` 已被移除，这正是 2.1.0 及更早版本在 0.1.7 上卡在 `pending (waiting for service: settingsScope)` 的原因）。
+- **折叠箭头用纯 CSS**，不静态导入任何图标：两条线的图标名不重叠，静态导入必然在其中一条线上解析失败。
+
 ## 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,13 @@ 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 differ per DSH line
+   (0.1.5 IconChevronDownOutline14 vs 0.1.7 IconChevronDownOutlineRegular),
+   so no static import can serve both — importing the 0.1.5 name makes the
+   client bundle fail to resolve on 0.1.7, taking the whole card down. 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 +278,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.
+		*
+		* `settingsScope.set()` / `configForms.set()` resolving is NOT proof that
+		* anything was stored. On DSH 0.1.7 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 0.1.7 form also 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 +357,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 +390,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 +491,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 +502,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 +516,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 +571,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 +623,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 +694,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 +706,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 +749,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 +801,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 +1180,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 +1258,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 +1329,17 @@ 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 that exist on BOTH host lines. Cordis'
+		* dependency gate is hard: any `inject` entry the running line does not provide
+		* keeps `apply` from ever running at all — which is exactly how this plugin
+		* ended up `pending (waiting for service: settingsScope)` on 0.1.7. Probing the
+		* settings surface through `ctx.get()` (which returns undefined, never throws,
+		* for an absent service) is what lets one build serve both lines.
+		*/
+		const inject = ["slots", "locale"];
 		/**
 		* Register card copy and the Trae card under Plugin configuration.
 		*
@@ -1234,6 +1352,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 +1363,36 @@ 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);
+				let settingsScope;
+				const forms = softGet("configForms");
+				const legacy = softGet("settingsScope");
+				if (forms !== void 0) {
+					let ns = "trae";
+					try {
+						const served = (forms.describe().getSnapshot().view?.namespaces ?? []).find((entry) => entry.ns === "trae" || /trae/i.test(entry.ns));
+						if (served !== void 0) ns = served.ns;
+					} catch {}
+					settingsScope = forms.get(ns);
+				} else if (legacy !== void 0) settingsScope = legacy.bind({ namespace: "trae" });
+				const registerCard = (slotName, key) => {
+					try {
+						ctx.slots.inject(slotName, () => ctx.slots.register({
+							name: slotName,
+							key,
+							priority: 30,
+							inject: () => settingsScope === void 0 ? { t } : {
+								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");
+				registerCard("settings.plugin.item", "trae");
 			} catch (error) {
 				console.error("[dsh-connect-trae] client card failed to load (host provider unaffected):", error);
 			}

package/lib/index.d.ts

@@ -1435,6 +1435,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
@@ -1655,7 +1680,27 @@ 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 on the DSH lines that support it.
+ *
+ * `volatile()` exists from schemastery 3.18.3 (the DSH 0.1.7 line, which is the
+ * only line whose settings write gate reads the marker). Older pinning (3.18.2,
+ * the 0.1.5 line) has no such method, and the schema must stay byte-identical
+ * to the unmarked original there: hand-writing `meta.volatile = true` would
+ * bypass schemastery's own `validateVolatileSchema` checks and produce a schema
+ * no 0.1.5 consumer understands — so on that line this degrades to an identity
+ * no-op.
+ *
+ * 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.
+ *
+ * Exported so BOTH arms are testable on any machine: the capability is decided
+ * by whichever schemastery the dependency tree resolves, so without a seam the
+ * no-op arm would silently stop being exercised the moment the pin moved up.
+ */
+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, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };

package/lib/index.js

@@ -3269,6 +3269,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 +3312,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 +3325,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 : {};
 }
 /**
@@ -3735,7 +3778,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 +3799,29 @@ function regionStateOf(config, region) {
 function regionEnabled(config, region) {
 	return regionStateOf(config, region).enabled !== false;
 }
+/**
+* Mark a schema's field as volatile on the DSH lines that support it.
+*
+* `volatile()` exists from schemastery 3.18.3 (the DSH 0.1.7 line, which is the
+* only line whose settings write gate reads the marker). Older pinning (3.18.2,
+* the 0.1.5 line) has no such method, and the schema must stay byte-identical
+* to the unmarked original there: hand-writing `meta.volatile = true` would
+* bypass schemastery's own `validateVolatileSchema` checks and produce a schema
+* no 0.1.5 consumer understands — so on that line this degrades to an identity
+* no-op.
+*
+* 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.
+*
+* Exported so BOTH arms are testable on any machine: the capability is decided
+* by whichever schemastery the dependency tree resolves, so without a seam the
+* no-op arm would silently stop being exercised the moment the pin moved up.
+*/
+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 +3843,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"),
@@ -3846,7 +3912,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 +3953,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 +3980,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({
@@ -4041,7 +4109,7 @@ 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();
 		}
@@ -4070,7 +4138,18 @@ function apply(ctx, config) {
 	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);
+		const settings = settingsCtx.settings;
+		if (typeof settings.configure === "function") {
+			settings.configure({ auto: true }, ctx.fiber);
+			return;
+		}
+		if (typeof settings.installSection === "function") {
+			const entry = unwrapVolatileDeep(config);
+			settings.installSection(ctx, TRAE_SETTINGS_NS, Config, entry, sectionHooks);
+		}
+	});
+	ctx.on("loader/volatile-update", () => {
+		applySelection(current());
 	});
 	let stopped = false;
 	ctx.effect(() => () => {
@@ -4153,4 +4232,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, 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.2.0",
   "author": "dingminhua",
   "copyright": "Copyright (c) 2026 LaoDing",
   "license": "MIT",
@@ -100,7 +100,7 @@
     "@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/schemastery": "3.18.4",
     "@earendil-works/pi-ai": "^0.85.1",
     "@testing-library/dom": "^10.4.2",
     "@testing-library/react": "^16.3.3",