dsh-connect-trae 2.0.5 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 2.1.0 (2026-09-24)
+
+### Features
+
+- **新增「每日签到领取」**（对齐 `dsh-connect-workbuddy` 的签到能力）：
+  - **交互**：国内版卡片在积分面板下方多一行签到：显示每日奖励（基础 + 额外，本机实测 `150 + 50`）与一个「立即领取」按钮；领取中显示「领取中…」，当日已领取显示「今日已领取」并禁用。国际版没有签到活动，因此**不显示该行**。
+  - **这是插件里唯一的写操作**，也是唯一会改变账号状态的调用（`POST /trae/api/v2/ug/checkin_credits/claim`）；其余查询全部只读。README 顶部与特性列表都按此措辞改写，不再把整个用量面板称为「只读」。
+  - **根因级发现：缺 `x-device-id` 会被静默拒绝**。同一份 Authorization，只加这一个头，结果从「HTTP 200 + 业务码 `9004`（The submitted order parameters are incorrect）」变成「`code: 0`，奖励到账」——**HTTP 状态始终是 200**，只看状态码会把它误判为成功。设备号取自本机 `iCubeAuthInfo://icube-dc:<id>`，即 `identity.ts` 里聊天通道同源的那个 `deviceId`（官方客户端在 `main.js` 的 `fb(headers)` 里给每个 ug 请求都补上它）。`deviceId` 由 `index.ts` 惰性注入；读不到时降级为不发该头——**只影响领取，不影响状态查询**（状态接口两种情况下都正常返回）。
+  - **领取前的守卫比上游更强**：路由 `POST /plugins/dsh-connect-trae/checkin` 仅接受 POST、仅接受回环来源、仅服务 `cn` 区域，并且**先读状态**——已领取（`checked_in` 或 `did_checked_in` 任一为真）就直接返回 `alreadyCheckedIn` 且**根本不发领取请求**；活动关闭答 409。国际版直接答 404 并说明原因，而不是把上游的 HTML 404 当成网络故障抛给用户。
+  - **已实测上游按北京自然日幂等**：重复领取仍回 `code: 0`，而权益总额（`total=1600, consumed=390.8`）逐字节不变，**不会重复发放**。插件仍然自行守卫——「不会重复发放」是上游的行为，不是插件可以依赖的保证。
+  - **业务拒绝不当成故障**：`claimed: false` + 原始业务码与 message 原样回给卡片并显示出来，而不是包成 500。否则用户只会看到「领取失败」，而丢掉唯一能解释原因的 `9004`。
+  - **对齐官方客户端的状态判定**：`checked_in` 与 `did_checked_in` 是**两个独立字段**，官方在「今日已领取」上同时看后者（即使状态读回 `checked_in: false` 也保持按钮禁用）。插件在**卡片与路由两侧都**按同一规则判定，`extra_credits` 也一并展示，避免把当天实际到账的 200 说成 150。
+  - 卡片新增 8 条真实点击测试（`tests/card-checkin.spec.tsx`，渲染**真组件**、`fireEvent.click` 真按钮、断言真发出去的请求），`usage.spec.ts` 补 6 条、`web-status.spec.ts` 补 7 条，共 21 条新测试（全仓 261 → 282）。做过**变异验证**：去掉路由的 `did_checked_in` 守卫 → 2 条失败；去掉卡片的同款判定 → 1 条失败；把卡片的 `POST` 改成 `GET` → 1 条失败；删掉「已领取则不发请求」的守卫 → 2 条失败。
+  - 取证与接口契约：`docs/USAGE_API_RESEARCH.md` 新增「每日签到领取」一节（含决定性请求头对照表、幂等性实测表、区域限制与官方字段语义）。
+
+## 2.0.6 (2026-09-22)
+
+### Features
+
+- **新增「可单独关闭任一版本的供应商」**（issue #11：用户问「能禁用国际版或国内版吗，有没有配置的地方」——「比如说我根本用不到国际版」）：
+  - **此前确实无解，而且最容易被误用的那条路走不通**：`edition` 配置只收窄**凭据扫描范围**（找账号用），不参与 provider 注册；`src/index.ts` 的注册循环对 `REGION_KEYS = ['cn','ai']` 是无条件注册的，所以设 `edition: "cn"` 之后 `trae-global` 依旧出现在模型选择器里。卸载国际版 App 同理——无账号时该区域回落到**插件内置的兜底目录**（Gemini / GPT / MiniMax / Kimi 共 7 条），这些模型一个都调不通，却和可用模型并排显示（这正是 issue #8 的成因）。DSH 侧也没有「停用某供应商」的入口。
+  - **交互**：设置卡片两个 tab 各带一个勾选，**默认都勾选**（老用户零感知）；取消勾选即关闭该供应商，重新勾选即恢复。
+  - **关闭是「真撤掉」，不是「藏 tab」**：抽掉 adapter 路由（`AdapterRegistrationHandle.replace([])`）——这是让模型**从 DSH 模型选择器消失**的那一步；同时抽掉供应商目录条目（`DirectoryRegistrationHandle.replace([])`），否则「设置 → 模型」仍会列出它。DSH 的类型契约明确允许持零路由而保持注册（"An empty array is legal here ... unlike an empty initial registration"），因此实现是**先正常注册、再 `replace([])`**，两步在同一同步段内完成，无可观测的路由空窗，且开关**立即生效、无需重启**。
+  - **顺带消掉一个失败面**：关闭的区域连启动时的模型目录拉取都跳过，不再发任何 Remote/SOLO 请求——「没装国际版每次启动报一次错」那类噪音一并消失。
+  - **状态不丢**：开关写入只改目标槽位的 `enabled` 一个字段，该区域的目录 / 勾选 / 图片开关 / 上下文预算与另一区域的整个槽位原样带过，所以「关掉 → 再打开」能完整恢复。配套地在卡片保存模型目录时**回写 `enabled`**——那次写入会替换整个槽位，漏掉它就会「保存一次模型列表 = 悄悄重新打开已关闭的供应商」。
+  - **已知代价（明确提示而非静默失败）**：若某会话此前选中了被关闭供应商的模型，路由撤掉后再调用会报 `NO_ADAPTER`；这是「彻底移除」的必然结果，卡片在该 tab 上给出明确文案说明设置均已保留、勾选即可恢复。
+  - **两侧读同一条规则**：Host 的 `regionEnabled()` 与卡片的 `regionEnabledOf()` 共用「仅显式 `false` 关闭」的判定，回归测试用 8 种正常/畸形形状交叉比对二者，锁定永不分歧；卡片另读 Host 随文档下发的 `enabled`（signed-in / signed-out 两个分支都带），因为**未登录的区域恰恰是用户最想关掉的那一个**。
+  - **修复开发期发现的「勾选点了没反应」**：卡片把**整个 settings 段**传给了只接受 **`regions` 子对象**的判定函数，于是它去查 `section['cn']`（不存在）并**永远返回 `true`**——复选框恒定显示为勾选、点击看起来毫无变化；而**写入其实已经成功**（设置里确实落下了 `enabled: false`），Host 侧路由也确实撤掉了，问题只在卡片的读取。修复方式不是「把参数改对」了事，而是让 `regionsMapOf()` 统一收口、**同时接受整段与子对象两种入参**，使传错一半在结构上不再可能静默返回 `true`；并补 2 条回归测试覆盖「整段入参」与「返回值必须是 `regions` 子对象」（把拆包逻辑改回原样，这 2 条立刻失败，已实测）。
+  - **补齐「真实点击」测试，堵住让该 bug 溜过的结构性缺口**：此前 `vitest.config.ts` 只收 `tests/**/*.spec.ts` 且 `environment: 'node'`，**根本无法渲染 React 组件**——仓库里唯一的客户端测试还是自己标注了 DRIFT WARNING 的「手工镜像副本」，不是产品代码，所以「点一下复选框」从来没有被自动化验证过（这正是 bug 能发布出去的原因）。现在 `tests/card-region-switch.spec.tsx` 在 jsdom 里渲染**真组件**、`fireEvent.click` 真实 `<input type="checkbox">`，断言 settings 落值与勾选态翻转，8 条用例覆盖空配置/已关闭/点击写入/重新启用保留选择/点第二个框/不切 tab/关闭态文案/不可写禁用。**变异验证**：把拆包逻辑改回出 bug 的样子，4 条立刻失败（含「存了 false 却显示已勾选」这一条，与用户症状一致）。配套：放开 `.spec.tsx`、`tsconfig` 分派、新增 `jsdom` / `@testing-library/react` / `@testing-library/dom` / `react-dom@18` 四个 devDependencies；`dsh-client-ui-primitives` 因带浏览器专用 CSS modules 在测试中整体 mock（产品依赖契约不变）。
+  - 新增 10 条回归测试（区域开关判定与两侧一致性、整段/子对象双入参、开关往返不丢状态、关闭后 `listProviders()` 与目录条目同步消失且不影响另一侧、**模型选择器分组也消失**、重启后仍生效、两个都关仍可恢复、旧配置两边都开、`enabled` 在两种文档分支都下发）。开发中做过**变异验证**：把「抽掉路由」改成「照常注册」（即只隐藏 tab 的假实现），集成测试立刻失败；把目录 `replace` 改回按区域调用，4 条测试失败；把整段入参的拆包逻辑去掉，2 条测试失败——测试确实咬得住。
+  - 取证与回复草稿：`docs/ISSUE11_DIAGNOSIS.md`、`docs/ISSUE11_REPLY_DRAFT.md`。
+
 ## 2.0.5 (2026-09-22)
 
 ### Fixes

package/README.en.md

@@ -4,7 +4,7 @@
 
 <h1 align="center">dsh-connect-trae</h1>
 
-<p align="center"><b>Connect locally signed-in Trae models to DeepSeek Harness with local DSH tools and a read-only credits overview.</b></p>
+<p align="center"><b>Connect locally signed-in Trae models to DeepSeek Harness with local DSH tools, a credits overview, and daily check-in claiming.</b></p>
 
 <p align="center">
   <a href="README.md">中文</a> ·
@@ -24,11 +24,14 @@
   <a href="https://dshfind.com/plugins/dingminhua/dsh-connect-trae"><img src="https://dshfind.com/api/badge/dingminhua/dsh-connect-trae" alt="dshfind plugin"></a>
 </p>
 
-A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle plugin that connects locally signed-in Trae models (**both CN and international installs**) to the DSH model picker. Trae generates structured tool calls while DSH executes its own local tools, with a read-only usage overview (Work/general credits on CN, subscription status on international) and model-management panel. **The CN and international sides are two parallel providers (`trae` / `trae-global`) that can be used at the same time**; the settings card separates them with tabs for convenient management.
+A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle plugin that connects locally signed-in Trae models (**both CN and international installs**) to the DSH model picker. Trae generates structured tool calls while DSH executes its own local tools, with a usage overview (Work/general credits on CN, subscription status on international), daily check-in claiming, and a model-management panel. **The CN and international sides are two parallel providers (`trae` / `trae-global`) that can be used at the same time**; the settings card separates them with tabs for convenient management.
+
+> Apart from the daily check-in claim, every query this plugin makes is read-only and consumes nothing; the claim only happens when you click the button.
 
 ## Features
 
 - **Dual parallel providers** — the CN side registers as the `trae` provider (e.g. `DeepSeek-V4-Flash`, `DeepSeek-V4-Pro`), the international side as `trae-global` (the Gemini/GPT/MiniMax roster), and **both rosters appear in the DSH model picker simultaneously**: different sessions can each pick a side without interfering.
+- **Either side can be switched off** — each tab carries its own checkbox (both checked by default): unchecking **withdraws that provider from the DSH model picker entirely** (not merely hiding the tab) and stops all of its requests; checking it again restores it with the account, directory, picks, and context budgets intact. If you never use the international side, just uncheck it.
 - **Tabbed settings card** — the card's top carries a "Domestic / Global" tab bar; each tab holds its own account picker, usage overview, and model management. Account, directory, selection, and unsaved drafts are fully isolated per tab — switching accounts or refreshing models on one tab never touches the other side's runtime catalog or sessions.
 - **Multiplier in the model name** — model names show the credit multiplier in Trae's own menu format (e.g. `GLM-5.2 · x0.79`), updated with each directory refresh.
 - **DSH local tool loop** — gets pending structured `tool_calls` from Trae `llm_utils_chat`, lets DSH execute its own local tools, then returns tool results to the model.
@@ -36,6 +39,7 @@ A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bund
 - **Region-isolated directories and selections** — CN and international each keep their own model directory, enabled picks, image opt-ins, and context budgets, and each provider reads only its own slot.
 - **Account switching** — refreshes the token list and lets users select an account without storing tokens in DSH settings.
 - **Read-only usage and model management** — Work/general credits on CN accounts, subscription/trial status on international ones; enable Trae models freely. Read-only queries consume nothing.
+- **Daily check-in claiming** — a one-click claim on the CN card (the button shows the daily reward, and reads "Claimed today" and disables itself once done). This is the plugin's **only** operation that changes account state, and it runs only when you click. The international side has no check-in activity, so no button is shown there.
 - **Secure loopback shim** — one random port + in-process random secret per region; the real Trae token is never handed to pi-ai.
 
 ## How it works
@@ -53,7 +57,7 @@ DSH PiAiAdapter (one stack per provider)
 
 The CN and international sides each own a complete runtime stack — credential store, model catalog, wire map, upstream clients, loopback shim, adapter — with visibility filtered by the credential's own region claim, so **both regions' accounts can be signed in and used by different sessions at the same time**.
 
-Usage overview hits the read-only `https://api.trae.cn/trae/api/v2/pay/*` and `/trae/api/v2/ug/*` endpoints (international accounts read their own gateway's subscription status). Refreshed tokens are kept per region in `$DSH_HOME/.trae-auth.cn.json` and `$DSH_HOME/.trae-auth.ai.json` (two simultaneously signed-in accounts never overwrite each other; the legacy single file `.trae-auth.json` is still read as a migration source).
+Usage overview hits the read-only `https://api.trae.cn/trae/api/v2/pay/*` and `/trae/api/v2/ug/*` endpoints (international accounts read their own gateway's subscription status); the daily check-in claim is the one write among them, going to `POST /trae/api/v2/ug/checkin_credits/claim` with this installation's device id (`x-device-id`, the same identity the chat path sends). Refreshed tokens are kept per region in `$DSH_HOME/.trae-auth.cn.json` and `$DSH_HOME/.trae-auth.ai.json` (two simultaneously signed-in accounts never overwrite each other; the legacy single file `.trae-auth.json` is still read as a migration source).
 
 > See `docs/IMPLEMENTATION_PLAN.md`, `docs/SOLO_ROUTE_DECISION.md`, `docs/USAGE_API_RESEARCH.md`.
 

package/README.md

@@ -4,7 +4,7 @@
 
 <h1 align="center">dsh-connect-trae</h1>
 
-<p align="center"><b>把本机登录的 Trae 模型接入 DeepSeek Harness，并提供只读的用量/积分概览。</b></p>
+<p align="center"><b>把本机登录的 Trae 模型接入 DeepSeek Harness，并提供用量/积分概览与每日签到领取。</b></p>
 
 <p align="center">
   <a href="README.en.md">English</a> ·
@@ -24,11 +24,14 @@
   <a href="https://dshfind.com/plugins/dingminhua/dsh-connect-trae"><img src="https://dshfind.com/api/badge/dingminhua/dsh-connect-trae" alt="dshfind plugin"></a>
 </p>
 
-一个独立的 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle 插件。它把本机已登录的 Trae 账号（**国内版与国际版均支持**）接到 DSH 的模型选择器：模型负责生成结构化工具调用，`bash` / `read` / `write` / `edit` 等工具由 DSH 本地执行；同时提供**只读**的用量概览（国内版 Work/通用积分、国际版订阅状态）与模型管理界面。**国内版与国际版是两个并行的供应商（`trae` / `trae-global`），可同时使用**；插件设置卡片以 tab 区分两者，方便统一管理。
+一个独立的 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle 插件。它把本机已登录的 Trae 账号（**国内版与国际版均支持**）接到 DSH 的模型选择器：模型负责生成结构化工具调用，`bash` / `read` / `write` / `edit` 等工具由 DSH 本地执行；同时提供用量概览（国内版 Work/通用积分、国际版订阅状态）、每日签到领取与模型管理界面。**国内版与国际版是两个并行的供应商（`trae` / `trae-global`），可同时使用**；插件设置卡片以 tab 区分两者，方便统一管理。
+
+> 除每日签到领取外，插件的所有查询都是只读的、不消耗额度；签到领取也只在你点击按钮时才发生。
 
 ## 功能特性
 
 - **双供应商并行接入** —— 国内版注册为 DSH 的 `trae` provider（`DeepSeek-V4-Flash`、`DeepSeek-V4-Pro` 等），国际版注册为 `trae-global`（Gemini / GPT / MiniMax 阵容），**两边模型同时出现在 DSH 模型选择器里**：不同会话可以各选一边，互不干扰。
+- **可单独关闭任一版本** —— 两个 tab 各带一个勾选（默认都勾选）：取消勾选即把该版本的供应商**整个从 DSH 模型选择器撤掉**（不是只藏起 tab），并且不再发起任何请求；重新勾选即恢复，账号、目录、勾选与上下文预算全部保留。用不到国际版就把国际版关掉即可。
 - **插件卡片 tab 切换** —— 设置卡片顶部为「国内版 / 国际版」两个 tab，各含独立的账号选择、用量概览与模型管理；每个 tab 的账号、目录、勾选与未保存草稿完全隔离——在一个 tab 里切账号或刷新模型，不会触碰另一边的运行时目录与会话。
 - **倍率内嵌模型名** —— 模型名称按 Trae 自身菜单的格式显示积分倍率（如 `GLM-5.2 · x0.79`），倍率随目录刷新更新。
 - **DSH 本地工具循环** —— 通过 Trae `llm_utils_chat` 获取待执行的结构化 `tool_calls`，交由 DSH 自带的本地工具执行，再将工具结果回传模型。
@@ -36,6 +39,7 @@
 - **目录与勾选按区域隔离** —— 国内版与国际版各一套模型目录、勾选、图片开关与上下文预算，两个供应商各自读各自的槽位。
 - **多账号切换** —— 支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。
 - **只读用量与模型管理** —— 国内版查看 Work 积分与通用积分，国际版查看订阅/试用状态；刷新/启用 Trae 模型；只读查询不消耗额度。
+- **每日签到领取** —— 国内版卡片上一键领取当日签到积分（按钮显示每日奖励，已领取则显示「今日已领取」并禁用）；这是插件里**唯一会改变账号状态**的操作，由你主动点击触发。国际版没有签到活动，因此不显示该按钮。
 - **安全 loopback shim** —— 每区域一个随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。
 
 ## 工作原理
@@ -53,7 +57,7 @@ DSH PiAiAdapter（每个 provider 一套）
 
 国内版与国际版各持一套完整的运行时栈——凭据 store、模型 catalog、wire 映射、上游客户端、回环 shim、adapter——按凭证自带的区域声明隔离可见账号，所以**两个区域的账号可以同时在线、同时被不同会话使用**。
 
-用量概览走 `https://api.trae.cn/trae/api/v2/pay/*` 与 `/trae/api/v2/ug/*` 只读接口（国际账号走其自有网关的订阅状态端点）。刷新得到的 token 按区域存放在 `$DSH_HOME/.trae-auth.cn.json` 与 `$DSH_HOME/.trae-auth.ai.json`（两个账号同时在线互不覆盖；旧的单文件 `.trae-auth.json` 作为迁移来源保留读取）。
+用量概览走 `https://api.trae.cn/trae/api/v2/pay/*` 与 `/trae/api/v2/ug/*` 只读接口（国际账号走其自有网关的订阅状态端点）；每日签到领取是其中唯一的写操作，走 `POST /trae/api/v2/ug/checkin_credits/claim`，需要携带本机安装的设备号（`x-device-id`，与聊天通道同源）。刷新得到的 token 按区域存放在 `$DSH_HOME/.trae-auth.cn.json` 与 `$DSH_HOME/.trae-auth.ai.json`（两个账号同时在线互不覆盖；旧的单文件 `.trae-auth.json` 作为迁移来源保留读取）。
 
 > 详见 `docs/IMPLEMENTATION_PLAN.md`、`docs/SOLO_ROUTE_DECISION.md`、`docs/USAGE_API_RESEARCH.md`。
 

package/lib/client.js

@@ -14,6 +14,11 @@ window.__ModuleLoader__.load({
 		const TRAE_MODELS_REFRESH_PATH = "/plugins/dsh-connect-trae/models/refresh";
 		/** Plugin-owned local account rescan endpoint. */
 		const TRAE_ACCOUNTS_REFRESH_PATH = "/plugins/dsh-connect-trae/accounts/refresh";
+		/**
+		* Plugin-owned daily check-in claim endpoint. POST, loopback-only, and the only
+		* route in this plugin that changes upstream account state.
+		*/
+		const TRAE_CHECKIN_PATH = "/plugins/dsh-connect-trae/checkin";
 		/** Query parameter naming the region a card request addresses. */
 		const TRAE_REGION_PARAM = "region";
 		/** Every region, in card tab order. */
@@ -38,6 +43,61 @@ window.__ModuleLoader__.load({
 				[region]: slot
 			};
 		}
+		/**
+		* Narrow a settings value to the `regions` map. Accepts EITHER the whole
+		* settings section (`{ regions: {...}, ... }`) or the `regions` map itself, and
+		* unwraps the former. This tolerance is deliberate: passing the whole section
+		* 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.
+		*/
+		function regionsMapOf(value) {
+			if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
+			const record = value;
+			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];
+			return typeof slot === "object" && slot !== null && !Array.isArray(slot) ? slot : {};
+		}
+		/**
+		* Whether one region's provider is switched on. Opt-out semantics: only an
+		* explicit `false` disables it, so a config written before this switch existed
+		* (and the pre-region-split flat fields, which never carry `enabled`) keep both
+		* providers running exactly as before. The Host reads the same rule through
+		* `regionStateOf`, so card and Host can never disagree about a region's state.
+		*
+		* `value` may be the whole settings section or the `regions` map (see
+		* {@link regionsMapOf}).
+		*/
+		function regionEnabledOf(value, region) {
+			return regionSlotOf(value, region)["enabled"] !== false;
+		}
+		/**
+		* Build the next `regions` settings value for a provider on/off toggle. ONLY
+		* the target region's `enabled` flag changes: every other field of that slot
+		* (its directory, selection, image opt-ins, context budgets) and every other
+		* region's slot are carried over verbatim, so switching a provider off never
+		* discards the user's model picks and switching it back on restores them.
+		*
+		* This is deliberately separate from {@link nextRegionSlots}: that helper
+		* writes a whole slot from a signed-in tab's draft, while this one must work
+		* for a region that is signed OUT — which is precisely the region a user wants
+		* to switch off (no international install, no international account).
+		*
+		* `value` may be the whole settings section or the `regions` map; the RETURN
+		* value is always the `regions` map, i.e. exactly what `settingsScope.set(
+		* 'regions', ...)` needs.
+		*/
+		function nextRegionEnabled(value, region, enabled) {
+			return nextRegionSlots(regionsMapOf(value), region, {
+				...regionSlotOf(value, region),
+				enabled
+			});
+		}
 		//#endregion
 		//#region src/client/icon.ts
 		/**
@@ -77,12 +137,18 @@ window.__ModuleLoader__.load({
 .dsm-btn-primary:hover:not(:disabled){opacity:.9}
 .dsm-trae-usage{display:flex;flex-direction:column;gap:16px;margin:0;padding:16px 0 4px}
 .dsm-trae-tabs{display:flex;gap:6px;padding:4px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:10px;background:var(--dsw-alias-bg-layer-3,#2a2c33)}
-.dsm-trae-tab{appearance:none;font:inherit;cursor:pointer;flex:1;border:0;border-radius:7px;padding:7px 10px;color:var(--dsw-alias-label-tertiary,#999);font-size:13px;font-weight:500;line-height:18px;background:transparent;transition:color .15s,background .15s;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dsm-trae-tab-cell{display:flex;align-items:center;gap:2px;flex:1;min-width:0}
+.dsm-trae-tab{appearance:none;font:inherit;cursor:pointer;flex:1;min-width:0;border:0;border-radius:7px;padding:7px 10px;color:var(--dsw-alias-label-tertiary,#999);font-size:13px;font-weight:500;line-height:18px;background:transparent;transition:color .15s,background .15s;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .dsm-trae-tab:hover:not(:disabled):not(.dsm-trae-tab-active){color:var(--dsw-alias-label-primary,#e6e6e6)}
 .dsm-trae-tab:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5686fe);outline-offset:1px}
 .dsm-trae-tab-active{color:var(--dsw-alias-label-primary,#e6e6e6);background:var(--dsw-alias-bg-layer-2,#232529);box-shadow:inset 0 0 0 1px var(--dsw-alias-border-l2,#3a3d45)}
+.dsm-trae-tab-off{opacity:.55}
+.dsm-trae-tab-switch{display:inline-flex;align-items:center;flex:none;padding:0 8px 0 2px;cursor:pointer}
+.dsm-trae-tab-switch input{margin:0;cursor:pointer;accent-color:var(--dsw-alias-brand-primary,#5686fe)}
+.dsm-trae-tab-switch input:disabled{cursor:not-allowed}
 .dsm-trae-tab-dot{display:inline-block;width:7px;height:7px;border-radius:50%;margin-right:6px;vertical-align:baseline}
 .dsm-trae-tab-hint{margin:0;color:var(--dsw-alias-label-tertiary,#999);font-size:12px;line-height:18px}
+.dsm-trae-tab-off-notice{margin:0;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:10px;color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:12px;line-height:18px;background:var(--dsw-alias-bg-layer-3,#2a2c33)}
 .dsm-trae-usage-account{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 14px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:14px;background:var(--dsw-alias-bg-layer-2,#24262c)}
 .dsm-trae-usage-account-copy{display:flex;flex-direction:column;gap:3px;min-width:0}
 .dsm-trae-usage-expiry{padding-left:19px;color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:12px;line-height:18px}
@@ -148,6 +214,11 @@ window.__ModuleLoader__.load({
 .dsm-trae-searched-list code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;line-height:16px;color:var(--dsw-alias-label-secondary,#b8b8b8);word-break:break-all}
 .dsm-trae-searched-reason{color:var(--dsw-alias-label-tertiary,#999);font-size:11px}
 .dsm-trae-usage-cheer:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5686fe);outline-offset:2px}
+.dsm-trae-checkin{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 16px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:14px;background:var(--dsw-alias-bg-layer-2,#24262c)}
+.dsm-trae-checkin-copy{display:flex;flex-direction:column;gap:2px;min-width:0}
+.dsm-trae-checkin-label{color:var(--dsw-alias-label-primary,#e6e6e6);font-size:13px;line-height:18px;font-weight:600}
+.dsm-trae-checkin-hint{color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:12px;line-height:17px}
+.dsm-trae-checkin-button{flex:none}
 `;
 		//#endregion
 		//#region src/client/TraeUsageCard.tsx
@@ -223,6 +294,16 @@ window.__ModuleLoader__.load({
 			const [drafts, setDrafts] = (0, react.useState)({});
 			const [saving, setSaving] = (0, react.useState)(false);
 			const [switchingAccount, setSwitchingAccount] = (0, react.useState)(false);
+			/** Region whose on/off checkbox write is in flight, so its box can't race. */
+			const [togglingRegion, setTogglingRegion] = (0, react.useState)(void 0);
+			/**
+			* Whether a check-in claim is in flight. A single flag rather than a
+			* per-region map: the claim exists only on the CN tab, and one shared flag
+			* keeps a tab switch from stranding a second concurrent claim.
+			*/
+			const [claiming, setClaiming] = (0, react.useState)(false);
+			/** Last claim refusal, shown until the next successful refresh. */
+			const [claimError, setClaimError] = (0, react.useState)(void 0);
 			const mounted = (0, react.useRef)(true);
 			(0, react.useEffect)(() => {
 				mounted.current = true;
@@ -233,6 +314,21 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => settingsScope?.subscribe(() => {
 				setSettingsRevision((value) => value + 1);
 			}), [settingsScope]);
+			/**
+			* Whether one region's provider is switched on, read off the SAME committed
+			* settings document the Host reads (`regionEnabledOf` mirrors the Host's
+			* `regionStateOf` opt-out rule: only an explicit `false` disables). Reading
+			* the stored value rather than echoing local state means a rejected write,
+			* another window's change, or a restart all converge on the truth.
+			*
+			* The whole settings section is passed deliberately: `regionEnabledOf`
+			* accepts either it or the bare `regions` map, because passing the section
+			* where the map was expected was a shipped bug (the lookup read
+			* `section['cn']`, found nothing, and reported `true` forever — the checkbox
+			* stayed checked and clicking it appeared dead while the write succeeded).
+			*/
+			const regionOn = (item) => regionEnabledOf(settingsScope?.getSnapshot().value, item);
+			const activeRegionOn = regionOn(activeRegion);
 			const refreshUsage = (0, react.useCallback)(async (region, signal) => {
 				try {
 					const response = await fetch(withTraeRegion(TRAE_USAGE_PATH, region), {
@@ -260,7 +356,7 @@ window.__ModuleLoader__.load({
 				}
 			}, [t]);
 			(0, react.useEffect)(() => {
-				if (!open) return;
+				if (!open || !activeRegionOn) return;
 				const controller = new AbortController();
 				refreshUsage(activeRegion, controller.signal);
 				return () => {
@@ -269,14 +365,23 @@ window.__ModuleLoader__.load({
 			}, [
 				open,
 				activeRegion,
+				activeRegionOn,
 				refreshUsage
 			]);
 			const status = statusByRegion[activeRegion] ?? {
 				status: "signed-out",
 				accounts: []
 			};
+			/**
+			* Drop a claim refusal when the tab changes. The error belongs to the region
+			* it came from — carrying it onto the other tab would attribute an
+			* international account's problem to the CN one (or the reverse).
+			*/
 			(0, react.useEffect)(() => {
-				if (!open || status.status !== "signed-in") return;
+				setClaimError(void 0);
+			}, [activeRegion]);
+			(0, react.useEffect)(() => {
+				if (!open || !activeRegionOn || status.status !== "signed-in") return;
 				const controller = new AbortController();
 				const timer = window.setInterval(() => {
 					refreshUsage(activeRegion, controller.signal);
@@ -288,6 +393,7 @@ window.__ModuleLoader__.load({
 			}, [
 				open,
 				activeRegion,
+				activeRegionOn,
 				refreshUsage,
 				status.status
 			]);
@@ -326,6 +432,54 @@ window.__ModuleLoader__.load({
 					if (mounted.current) setSwitchingAccount(false);
 				}
 			};
+			/**
+			* Claim today's check-in reward for the active tab's region.
+			*
+			* The Host route owns every guard that matters — POST only, loopback origin
+			* only, CN only, and a status read before the claim — because a browser-side
+			* check is not a guard. The button's own `disabled` is therefore a courtesy
+			* (it stops an obviously pointless click), not the protection.
+			*
+			* A refusal is not thrown away: the route answers `claimed: false` with the
+			* upstream's business code and message, and the card shows it. The upstream
+			* also reports success for an already-claimed day, so `alreadyCheckedIn`
+			* refreshes the state without pretending a new reward landed.
+			*/
+			const claimCheckin = async () => {
+				setClaiming(true);
+				setClaimError(void 0);
+				try {
+					const response = await fetch(withTraeRegion(TRAE_CHECKIN_PATH, activeRegion), {
+						method: "POST",
+						headers: { accept: "application/json" },
+						credentials: "same-origin"
+					});
+					const body = await response.json().catch(() => void 0);
+					if (!response.ok) throw new Error(body?.error ?? `HTTP ${response.status}`);
+					if (body?.claimed === false && body.alreadyCheckedIn !== true) throw new Error(body.message === void 0 || body.message === "" ? t("row.checkinRefused", { code: String(body.code ?? "") }) : `${t("row.checkinRefused", { code: String(body.code ?? "") })}: ${body.message}`);
+					await refreshUsage(activeRegion);
+				} catch (error) {
+					if (mounted.current) setClaimError(error instanceof Error ? error.message : t("row.requestFailed"));
+				} finally {
+					if (mounted.current) setClaiming(false);
+				}
+			};
+			/**
+			* Switch one region's provider off or on (issue #11). The write carries the
+			* region's whole slot through untouched — only `enabled` changes — so the
+			* user's directory, model picks, image opt-ins and budgets survive a
+			* round trip. The Host withdraws or restores the provider route on the next
+			* `onChange`, which is what actually removes it from DSH's model picker.
+			*/
+			const toggleRegion = async (item, enabled) => {
+				if (settingsScope === void 0 || settingsScope.getSnapshot().writable !== true) return;
+				setTogglingRegion(item);
+				try {
+					await settingsScope.set("regions", nextRegionEnabled(settingsScope.getSnapshot().value, item, enabled));
+				} finally {
+					if (mounted.current) setTogglingRegion(void 0);
+				}
+			};
 			const refreshModels = async () => {
 				setBusy(true);
 				try {
@@ -443,6 +597,7 @@ window.__ModuleLoader__.load({
 				try {
 					if (status.status !== "signed-in") return;
 					await settingsScope.set("regions", nextRegionSlots(configuredRegions, activeRegion, {
+						enabled: regionOn(activeRegion),
 						lastCatalog: visibleModels.map((model) => ({
 							...model,
 							input: ["text"]
@@ -503,19 +658,36 @@ window.__ModuleLoader__.load({
 								"aria-label": title,
 								children: TRAE_REGIONS.map((item) => {
 									const regionStatus = statusByRegion[item];
-									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-										type: "button",
-										role: "tab",
-										"aria-selected": item === activeRegion,
-										className: `dsm-trae-tab${item === activeRegion ? " dsm-trae-tab-active" : ""}`,
-										onClick: () => {
-											setActiveRegion(item);
-										},
-										children: [regionStatus === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-											"aria-hidden": "true",
-											className: "dsm-trae-tab-dot",
-											style: dotStyle(regionStatus.status)
-										}), item === "cn" ? t("row.tabCn") : t("row.tabAi")]
+									const on = regionOn(item);
+									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "dsm-trae-tab-cell",
+										role: "presentation",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+											type: "button",
+											role: "tab",
+											"aria-selected": item === activeRegion,
+											className: `dsm-trae-tab${item === activeRegion ? " dsm-trae-tab-active" : ""}${on ? "" : " dsm-trae-tab-off"}`,
+											onClick: () => {
+												setActiveRegion(item);
+											},
+											children: [regionStatus === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												"aria-hidden": "true",
+												className: "dsm-trae-tab-dot",
+												style: dotStyle(regionStatus.status)
+											}), item === "cn" ? t("row.tabCn") : t("row.tabAi")]
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+											className: "dsm-trae-tab-switch",
+											title: t("row.tabSwitchHint"),
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+												type: "checkbox",
+												checked: on,
+												disabled: settingsScope?.getSnapshot().writable !== true || togglingRegion !== void 0,
+												"aria-label": t("row.tabSwitchAria", { region: item === "cn" ? t("row.tabCn") : t("row.tabAi") }),
+												onChange: (event) => {
+													toggleRegion(item, event.currentTarget.checked);
+												}
+											})
+										})]
 									}, item);
 								})
 							}),
@@ -523,6 +695,11 @@ window.__ModuleLoader__.load({
 								className: "dsm-trae-tab-hint",
 								children: t("row.tabHint")
 							}),
+							regionOn(activeRegion) ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dsm-trae-tab-off-notice",
+								role: "status",
+								children: t("row.tabOffNotice")
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dsm-trae-usage-account",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -668,6 +845,45 @@ window.__ModuleLoader__.load({
 									className: "dsm-trae-usage-error",
 									children: t("row.creditsError", { message: status.creditsError })
 								}),
+								status.checkin === void 0 ? null : (() => {
+									const done = status.checkin.checkedIn || status.checkin.didCheckedIn;
+									const reward = formatNumber(status.checkin.credits);
+									const bonus = status.checkin.extraCredits === void 0 ? "" : ` + ${formatNumber(status.checkin.extraCredits)}`;
+									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "dsm-trae-checkin",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+											className: "dsm-trae-checkin-copy",
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dsm-trae-checkin-label",
+												children: t("row.checkinLabel")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+												className: "dsm-trae-checkin-hint",
+												children: [t("row.checkinReward", { reward: `${reward}${bonus}` }), done ? ` · ${t("row.checkinDoneHint")}` : ""]
+											})]
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "dsm-btn dsm-btn-primary dsm-trae-checkin-button",
+											disabled: !status.checkin.enabled || done || claiming,
+											onClick: () => {
+												claimCheckin();
+											},
+											children: claiming ? t("row.checkinClaiming") : done ? t("row.checkinClaimed") : t("row.checkinClaim")
+										})]
+									});
+								})(),
+								status.checkin !== void 0 && !status.checkin.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: "dsm-trae-usage-error",
+									children: t("row.checkinDisabled")
+								}) : null,
+								status.checkinError === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: "dsm-trae-usage-error",
+									children: t("row.checkinError", { message: status.checkinError })
+								}),
+								claimError === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: "dsm-trae-usage-error",
+									role: "alert",
+									children: t("row.checkinError", { message: claimError })
+								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 									className: "dsm-trae-models",
 									"aria-label": t("row.modelsTitle"),
@@ -850,6 +1066,9 @@ window.__ModuleLoader__.load({
 			"row.tabCn": "Domestic",
 			"row.tabAi": "Global",
 			"row.tabHint": "Each tab is a separate provider (trae / trae-global) with its own account, usage, and models. Both sides are live at once: different sessions can pick from either side, and changes on one tab never touch the other.",
+			"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.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",
@@ -873,6 +1092,15 @@ window.__ModuleLoader__.load({
 			"row.creditsConsumedLabel": "Consumed",
 			"row.creditsTotalLabel": "Total",
 			"row.creditsError": "Usage unavailable: {message}",
+			"row.checkinLabel": "Daily check-in",
+			"row.checkinReward": "{reward} credits per day",
+			"row.checkinClaim": "Claim today",
+			"row.checkinClaiming": "Claiming…",
+			"row.checkinClaimed": "Claimed today",
+			"row.checkinDoneHint": "come back tomorrow",
+			"row.checkinRefused": "Trae refused the check-in (code {code})",
+			"row.checkinError": "Check-in failed: {message}",
+			"row.checkinDisabled": "This account has no check-in activity available.",
 			"row.regionCn": "CN",
 			"row.regionAi": "International",
 			"row.subscriptionLabel": "Subscription",
@@ -915,6 +1143,9 @@ window.__ModuleLoader__.load({
 			"row.tabCn": "国内版",
 			"row.tabAi": "国际版",
 			"row.tabHint": "每个 tab 是一个独立供应商（trae / trae-global），各有自己的账号、用量与模型。两边同时生效：不同会话可各选一边，一侧的改动不影响另一侧。",
+			"row.tabSwitchHint": "取消勾选即关闭该供应商：它的模型不再出现在 DSH 模型选择器里；账号、用量与模型设置都会保留，重新勾选即恢复。",
+			"row.tabSwitchAria": "是否向 DSH 提供{region}供应商",
+			"row.tabOffNotice": "该供应商已关闭：它的模型不会提供给 DSH。账号、用量与模型设置均已保留——勾选上方复选框即可恢复。",
 			"row.signedOut": "未登录",
 			"row.signedOutHint": "在 Trae 桌面 App 里登录一次即可，插件会自动跟随当前登录的账号。",
 			"row.searchedTitle": "已检查的路径",
@@ -938,6 +1169,15 @@ window.__ModuleLoader__.load({
 			"row.creditsConsumedLabel": "消耗",
 			"row.creditsTotalLabel": "合计",
 			"row.creditsError": "用量查询失败：{message}",
+			"row.checkinLabel": "每日签到",
+			"row.checkinReward": "每日 {reward} 积分",
+			"row.checkinClaim": "立即领取",
+			"row.checkinClaiming": "领取中…",
+			"row.checkinClaimed": "今日已领取",
+			"row.checkinDoneHint": "明天再来",
+			"row.checkinRefused": "Trae 拒绝了本次签到（业务码 {code}）",
+			"row.checkinError": "签到失败：{message}",
+			"row.checkinDisabled": "该账号当前没有可用的签到活动。",
 			"row.regionCn": "国内版",
 			"row.regionAi": "国际版",
 			"row.subscriptionLabel": "订阅状态",