dsh-connect-trae 2.2.0 → 2.3.1

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";
@@ -14,6 +13,7 @@ import { createServer } from "node:http";
 import { Readable } from "node:stream";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { existsSync } from "node:fs";
 //#region src/catalog.ts
 /**
 * Bootstrap catalog: identity only where current Trae metadata has not been
@@ -150,12 +150,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 +184,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 ? {} : {
@@ -793,6 +801,43 @@ const LINUX_APP_NAMES = {
 	solo: ["trae-solo-cn", "TRAE SOLO CN"],
 	"solo-sg": ["trae-solo", "TRAE SOLO"]
 };
+/**
+* Windows desktop config directory names.
+*
+* Trae is a VS Code-family Electron app, and that family names its per-user
+* data directory from the installer-registered product name — which on Windows
+* is `product.json`'s `win32DirName`, NOT the macOS bundle spelling. Measured
+* from the shipped bundles (2026-09-26):
+*
+*   Trae CN      -> win32DirName = "Trae CN"       (applicationName trae-cn)
+*   TRAE SOLO CN -> win32DirName = "TRAE SOLO CN"  (applicationName trae-solo-cn)
+*
+* So the macOS spellings happen to be right here, and `win32DirName` is the
+* authority that says so. The lowercase `applicationName` spellings
+* (`trae-cn`, `trae-solo-cn`) are probed as well because the same family uses
+* them for the Linux config directory, and which of the two a given installer
+* writes has never been confirmed on a real Windows host
+* (docs/WINDOWS_TOKEN_PROBE.md). Windows file systems are case-insensitive, so
+* listing `trae cn` beside `Trae CN` would be the same directory twice — only
+* genuinely different spellings are listed.
+*/
+const WINDOWS_APP_NAMES = {
+	cn: ["Trae CN", "trae-cn"],
+	sg: ["Trae"],
+	solo: ["TRAE SOLO CN", "trae-solo-cn"],
+	"solo-sg": ["TRAE SOLO"]
+};
+/**
+* One edition's plausible Windows directory spellings, in probe order.
+*
+* Exported so the identity reader and the credential scanner probe the SAME
+* names: the two resolve different files (the install's `product.json` vs the
+* per-user `storage.json`) but they describe one installation, and a spelling
+* that works for one but not the other is a bug rather than a preference.
+*/
+function traeWindowsAppNames(edition) {
+	return WINDOWS_APP_NAMES[edition];
+}
 function traeStorageCandidates(platform = process.platform, home = homedir(), env = process.env) {
 	const result = [];
 	for (const edition of [
@@ -809,7 +854,7 @@ function traeStorageCandidates(platform = process.platform, home = homedir(), en
 			appNames = [app];
 		} else if (platform === "win32") {
 			roots = [env.APPDATA, join(home, "AppData", "Roaming")].filter((value, index, all) => typeof value === "string" && value !== "" && all.indexOf(value) === index);
-			appNames = [app];
+			appNames = WINDOWS_APP_NAMES[edition];
 		} else if (platform === "linux") {
 			roots = [env.XDG_CONFIG_HOME || join(home, ".config")];
 			appNames = LINUX_APP_NAMES[edition];
@@ -1395,7 +1440,7 @@ async function readTraeIdentity(candidate, options = {}) {
 		if (platform === "darwin") productPaths.push(join("/Applications", `${appName}.app`, "Contents", "Resources", "app", "product.json"));
 		else {
 			const localRoots = [env.LOCALAPPDATA, join(home, "AppData", "Local")].filter((value) => typeof value === "string" && value !== "").filter((value, index, all) => all.indexOf(value) === index);
-			for (const root of localRoots) productPaths.push(join(root, "Programs", appName, "resources", "app", "product.json"));
+			for (const root of localRoots) for (const spelling of traeWindowsAppNames(candidate.edition)) productPaths.push(join(root, "Programs", spelling, "resources", "app", "product.json"));
 		}
 	}
 	let product = {};
@@ -1934,6 +1979,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 +2090,7 @@ var TraeSoloUpstreamClient = class {
 				...config,
 				...detail
 			});
+			const creditMultiplier = wireCreditMultiplier(config);
 			if (byId.has(id)) continue;
 			byId.set(id, {
 				id,
@@ -2019,6 +2098,7 @@ var TraeSoloUpstreamClient = class {
 				...contextWindow === void 0 ? {} : { contextWindow },
 				...maxTokens === void 0 ? {} : { maxTokens },
 				...reasoning === void 0 ? {} : { reasoning },
+				...creditMultiplier === void 0 ? {} : { creditMultiplier },
 				function: directoryFunction
 			});
 		}
@@ -2910,6 +2990,8 @@ function createTraeRawGateway(options) {
 //#endregion
 //#region src/model-cache.ts
 const execFileAsync = promisify(execFile);
+/** Basename of the SQLite cache sitting beside the credential document. */
+const TRAE_STATE_DB_FILENAME = "state.vscdb";
 function positive$1(value) {
 	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
@@ -2937,18 +3019,59 @@ function parseTraeCachedModel(value) {
 	};
 }
 /**
+* The cache paths to try, most-specific first.
+*
+* `state.vscdb` is a SIBLING of the credential document (both sit in
+* `globalStorage`), so a candidate's own path is the authority for its cache —
+* this is why the database is derived from {@link traeStorageCandidates} rather
+* than re-spelled here.
+*
+* It previously hardcoded the single macOS spelling `Trae CN`, which was wrong
+* in two ways on Windows: `paths.ts` probes `Trae CN` AND `trae-cn`, and the
+* edition actually installed is often SOLO (`TRAE SOLO CN`). This module would
+* then point at a directory that does not exist. That went unnoticed only
+* because the Windows `sqlite3` dependency is absent, so the lookup failed and
+* callers fell back — masking the wrong path behind a different error. Sharing
+* one path table means a spelling that works for sign-in also works for the
+* cache.
+*/
+function traeStateDatabaseCandidates(options = {}) {
+	const platform = options.platform ?? process.platform;
+	const home = options.home ?? homedir();
+	const env = options.env ?? process.env;
+	const paths = [];
+	const push = (storagePath) => {
+		const database = join(dirname(storagePath), TRAE_STATE_DB_FILENAME);
+		if (!paths.some((existing) => existing.toLowerCase() === database.toLowerCase())) paths.push(database);
+	};
+	if (options.candidate !== void 0 && options.candidate.source === "desktop") push(options.candidate.path);
+	for (const candidate of traeStorageCandidates(platform, home, env)) {
+		if (candidate.source !== "desktop") continue;
+		if (options.candidate !== void 0 && candidate.edition !== options.candidate.edition) continue;
+		push(candidate.path);
+	}
+	return paths;
+}
+/**
 * Read Trae's own current user's model map via sqlite3 without exposing
 * secrets. The sqlite3 command line is a macOS prerequisite; on Windows it is
 * typically absent, so the call fails and callers fall back gracefully.
+*
+* Every candidate database is tried in order and the first that EXISTS is
+* queried. Existence is checked before spawning because a missing file and a
+* missing `sqlite3` binary are different problems: choosing the wrong directory
+* would otherwise surface as a confusing `sqlite3` failure, hiding a path bug
+* behind a dependency error.
 */
 async function readTraeCachedModel(functionName, modelName, userId, options = {}) {
-	const platform = options.platform ?? process.platform;
-	const home = options.home ?? homedir();
-	const env = options.env ?? process.env;
-	const database = platform === "win32" ? join(env.APPDATA ?? join(home, "AppData", "Roaming"), "Trae CN", "User", "globalStorage", "state.vscdb") : join(home, "Library", "Application Support", "Trae CN", "User", "globalStorage", "state.vscdb");
+	const exists = options.exists ?? existsSync;
+	const databases = traeStateDatabaseCandidates(options);
+	const fallback = databases[0];
+	if (fallback === void 0) throw new Error("trae: no desktop storage candidate to locate the model cache from");
+	const database = databases.find((candidate) => exists(candidate)) ?? fallback;
 	const key = `${userId}_AI.agent.model.model_list_map`;
 	const sql = `select value from ItemTable where key=${JSON.stringify(key)} limit 1;`;
-	const { stdout } = await execFileAsync("sqlite3", [database, sql], { maxBuffer: 8388608 });
+	const { stdout } = await (options.runSqlite ?? ((db, statement) => execFileAsync("sqlite3", [db, statement], { maxBuffer: 8388608 })))(database, sql);
 	const document = JSON.parse(stdout);
 	return parseTraeCachedModel((Array.isArray(document[functionName]) ? document[functionName] : []).find((item) => typeof item === "object" && item !== null && item.name === modelName));
 }
@@ -2960,7 +3083,7 @@ async function resolveTraeRawRuntime(store, modelName) {
 	const candidate = store.candidates().find((item) => item.edition === credential.edition);
 	if (candidate === void 0) throw new Error(`no Trae ${credential.edition} storage candidate for Raw Chat identity`);
 	const identity = await readTraeIdentity(candidate);
-	const cached = credential.edition === "cn" ? await readTraeCachedModel("solo_agent", modelName, credential.userId).catch(() => void 0) : void 0;
+	const cached = credential.edition === "cn" ? await readTraeCachedModel("solo_agent", modelName, credential.userId, { candidate }).catch(() => void 0) : void 0;
 	return {
 		identity,
 		runtime: buildTraeRawChatRuntimeConfig(modelName, cached, {
@@ -3160,6 +3283,12 @@ var TraeUsageClient = class {
 	/**
 	* Daily check-in status. Read-only, and answered with or without the device
 	* header — the claim is what needs it.
+	*
+	* The read DOES carry the header whenever this installation has one, and
+	* that is deliberate rather than incidental: `did_checked_in` is answered
+	* per device, so omitting the header would make a device that already claimed
+	* today look identical to one that never has (measured 2026-09-26, see
+	* {@link TraeCheckinStatus.didCheckedIn}).
 	*/
 	async checkinStatus(signal) {
 		await this.requireCnRegion("check-in status");
@@ -3381,6 +3510,16 @@ function nextRegionEnabled(value, region, enabled) {
 }
 //#endregion
 //#region src/web-status.ts
+/**
+* The upstream's business code for "该设备今日已参与签到" — this DEVICE already
+* used today's check-in (measured 2026-09-26 on a CN account whose claim was
+* refused with exactly this code after an account switch on the same machine).
+*
+* It arrives as HTTP 200 with a non-zero `code`, which is why it has to be
+* matched on the code rather than on the HTTP status: read as a transport
+* failure it looks like the plugin is broken, when the day is simply spent.
+*/
+const CHECKIN_DEVICE_ALREADY_CLAIMED = 9095;
 /** Redact token-like content before it crosses to the browser. */
 function safeMessage(error) {
 	return (error instanceof Error ? error.message : String(error)).replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[redacted token]").replace(/(\b(?:code|token|refresh_token|access_token)=)[^&\s]+/giu, "$1[redacted]").slice(0, 500);
@@ -3577,11 +3716,22 @@ function registerTraeUsageRoute(ctx, deps) {
 		/**
 		* Daily check-in claim — the ONLY route in this plugin that mutates
 		* upstream account state, so it is guarded more tightly than its siblings:
-		* POST only, loopback origin only, and the status read runs FIRST so an
-		* already-claimed day never reaches the upstream claim at all. The upstream
-		* is idempotent per Beijing day anyway (verified 2026-09-24: a repeat claim
-		* answers `code: 0` with the entitlement total unchanged), but relying on
-		* that for correctness would put the guard in someone else's hands.
+		* POST only, loopback origin only, and the status read runs FIRST so a day
+		* the ACCOUNT has already been paid for never reaches the upstream claim.
+		*
+		* `alreadyCheckedIn` and `deviceCheckedIn` are deliberately separate
+		* answers, because the two flags mean different things (see
+		* {@link TraeWebCheckin}): `checkedIn` is the account's reward for today
+		* existing, `didCheckedIn` is this MACHINE having spent its check-in —
+		* possibly for a different account. Treating the latter as "claimed today"
+		* was a shipped bug: after switching accounts the card said "claimed
+		* today" and disabled the button, which is the right call for the wrong
+		* reason and hides that the new account was never rewarded.
+		*
+		* The upstream is idempotent per Beijing day (verified 2026-09-24: a
+		* repeat claim answers `code: 0` with the entitlement total unchanged), but
+		* relying on that for correctness would put the guard in someone else's
+		* hands.
 		*/
 		const disposeCheckin = ctx.webServer.register({
 			kind: "exact",
@@ -3596,16 +3746,27 @@ function registerTraeUsageRoute(ctx, deps) {
 					const client = deps.client(region);
 					const current = await client.checkinStatus();
 					if (!current.enabled) return json(res, 409, { error: "check-in is not enabled for this account" });
-					if (current.checkedIn || current.didCheckedIn) return json(res, 200, {
+					if (current.checkedIn) return json(res, 200, {
 						claimed: false,
 						alreadyCheckedIn: true,
+						deviceCheckedIn: current.didCheckedIn,
+						checkin: toCheckin(current)
+					});
+					if (current.didCheckedIn) return json(res, 200, {
+						claimed: false,
+						alreadyCheckedIn: false,
+						deviceCheckedIn: true,
+						code: CHECKIN_DEVICE_ALREADY_CLAIMED,
+						message: "this device already used today's check-in",
 						checkin: toCheckin(current)
 					});
 					const claim = await client.claimCheckin();
 					const checkin = await client.checkinStatus();
+					const deviceClaimed = claim.code === CHECKIN_DEVICE_ALREADY_CLAIMED;
 					json(res, 200, {
 						claimed: claim.claimed,
 						alreadyCheckedIn: false,
+						...deviceClaimed ? { deviceCheckedIn: true } : {},
 						code: claim.code,
 						message: claim.message,
 						checkin: toCheckin(checkin)
@@ -3722,6 +3883,64 @@ function buildTraeModelDetailRequest(configName = "", custom = false) {
 	};
 }
 //#endregion
+//#region src/redact.ts
+/**
+* Redaction helpers for diagnostics that a user may paste into a public issue.
+*
+* A verification report is only useful if it can be shared, and it is only safe
+* to share if it carries no personal identifiers. Paths are the hard case:
+* `C:\Users\<real name>\AppData\Roaming\Trae CN\...` contains both a real
+* account name AND the single most diagnostic token in the whole report (the
+* Trae data directory spelling). Redacting the whole path would make the report
+* worthless; printing it whole would leak the user's name. So the user segment
+* is replaced and the meaningful tail is preserved.
+*
+* @module dsh-connect-trae/redact
+*/
+/**
+* Replace the user segment of a path with `<user>`, keeping the rest intact.
+*
+* Handles the shapes a Trae install can produce:
+*   - `C:\Users\<name>\...` and `C:\Documents and Settings\<name>\...` (Windows)
+*   - `/Users/<name>/...` and `/home/<name>/...` (macOS / Linux)
+*
+* Anything after that segment — edition directory, `User\globalStorage`,
+* `storage.json` — is preserved verbatim, because that is what a report is
+* actually read for. Cross-platform on purpose: the function is called by
+* Windows-focused diagnostics, but the same helpers run in tests and on other
+* hosts, and a report from the wrong platform must not leak either.
+*/
+function maskUserPath(path) {
+	return String(path).replace(/([A-Za-z]:\\Users\\)[^\\]+/i, "$1<user>").replace(/([A-Za-z]:\\Documents and Settings\\)[^\\]+/i, "$1<user>").replace(/^(\/(?:Users|home)\/)[^/]+/, "$1<user>");
+}
+/**
+* Describe a name by shape instead of by value: a character count, plus whether
+* it is purely numeric.
+*
+* This is the deliberate middle ground for account names. A Trae account name
+* is often a real name or a phone number, so it must never be printed; but the
+* report still needs to show that an account WAS resolved, and the shape
+* distinguishes a real nickname from a generated `用户<n>` id — which is the
+* only thing a reader needs to judge whether account discovery worked.
+*/
+function describeNameShape(name) {
+	const text = String(name ?? "");
+	return `${text.length} 字符${/^\d+$/.test(text) ? "，纯数字" : ""}`;
+}
+/**
+* Describe an identifier by shape instead of by value.
+*
+* A device id (`x-device-id`) is a stable installation identifier and is
+* directly tied to the upstream's per-device rules, so it is never printed.
+* Its shape still proves which resolution path ran: a real `icube-dc` id is
+* 15 digits, while the fallback is a 32-character hex hash.
+*/
+function describeIdShape(value) {
+	const text = String(value ?? "");
+	if (text === "") return "(空)";
+	return `${text.length} 位${/^\d+$/.test(text) ? "，纯数字" : "，含非数字"}`;
+}
+//#endregion
 //#region src/raw-envelope.ts
 /** Stable JSON hash candidate used by the native DTO's arg/args_hash fields. */
 function hashTraeRawChatArg(arg) {
@@ -3761,14 +3980,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
@@ -3800,23 +4039,18 @@ function regionEnabled(config, region) {
 	return regionStateOf(config, region).enabled !== false;
 }
 /**
-* Mark a schema's field as volatile on the DSH lines that support it.
+* Mark a schema's field as volatile.
 *
-* `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.
+* `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.
-*
-* 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();
@@ -3863,6 +4097,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 ?? []);
@@ -4100,7 +4335,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
 		})));
@@ -4115,14 +4350,6 @@ function apply(ctx, config) {
 		}
 		syncRegionRegistration(value);
 	};
-	const sectionHooks = {
-		setSource(source) {
-			current = source;
-		},
-		onChange() {
-			applySelection(current());
-		}
-	};
 	applySelection(config);
 	(async () => {
 		const id = current().accountId;
@@ -4135,18 +4362,9 @@ 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) => {
+	ctx.inject(["settings"], (settingsCtx) => {
 		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.effect(() => settings.configure({ auto: true }, ctx.fiber));
 	});
 	ctx.on("loader/volatile-update", () => {
 		applySelection(current());
@@ -4173,7 +4391,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 [];
@@ -4189,7 +4407,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
 			})));
@@ -4232,4 +4450,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, 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 };
+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_STATE_DB_FILENAME, 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, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, maskUserPath, 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, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };

package/package.json

@@ -1,8 +1,8 @@
 {
   "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.2.0",
+  "description": "把本机登录的 Trae 模型接入 DeepSeek Harness：国内版与国际版双供应商并行，提供用量/积分概览与每日签到领取。",
+  "version": "2.3.1",
   "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,7 +32,9 @@
   },
   "files": [
     "lib",
+    "icons",
     "docs/assets/dsh-connect-trae-usage-card.png",
+    "scripts/verify-windows.mjs",
     "screenshots.json",
     "cordis.patch.yml",
     "README.md",
@@ -72,34 +75,34 @@
     "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/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",