dsh-connect-trae 2.7.2 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,165 @@
 # Changelog
 
+## 2.10.0 (2026-10-07)
+
+> **新增：在 DSH 主界面侧边栏常驻一行「Trae通用积分」**（[#26](https://github.com/dingminhua/dsh-connect-trae/issues/26)，**实现由报告人 JiewiW 贡献**）。
+>
+> 看积分原先必须打开插件设置卡片、展开、找到额度区。现在侧边栏底部（工作区列表下方、设置上方）常驻一行「Trae通用积分：<数值>」与刷新按钮，**默认显示**，每 5 分钟自动更新，也可手动刷新。
+
+> 这是 2.9.0 起五个版本合并后的首个公开版本：npm 上的 `latest` 此前仍是 2.8.0，因此**从 2.8.0 升级会一次拿到下面全部内容**。
+
+### Features
+
+- **侧边栏积分行**：在 `sidebar.footer.action` 槽位渲染「Trae通用积分：<数值>」+ 「刷新」按钮。
+  - **默认显示**（opt-out）：`showPointsInMainUi` 默认 `true`。
+  - **关闭即彻底消失**：行内的 `×` 或卡片里的复选框都能关闭，关闭后**侧边栏不留任何 DOM**，轮询一并停止。
+  - 开启后**先立即抓取一次，完成后再启动 5 分钟周期**的定时器，不叠加；关闭或卸载即清除定时器并中止在途请求。
+  - 抓取失败保留上一次数值并提示；刷新进行中忽略重复点击。
+  - 显示的是**通用积分**（`credits.generalAvailable`，SOLO 聊天实际消耗的那个池子），与卡片上的数字口径一致。
+  - 侧边栏收起（56px 导轨）时整行不渲染；国际版为订阅制、无可比数字，因此不显示。
+- **开关在三处，写同一个字段**（`showPointsInMainUi`），永不冲突：侧边栏那一行的 `×`、卡片顶部、卡片「模型」区标题旁（在「从 Trae 刷新」「一键测试启用模型」左侧）。
+
+### 为什么不只用插件卡片里的复选框
+
+第一版把开关**只**放在插件卡片里，结果在装了 **dshmarket** 的宿主上等于不存在：市场插件接管了插件页，而它的 UI **完全不渲染插件自带的配置卡片**（其客户端 bundle 里 `plugins.row.config` / `plugins.bundle.config` **0 处引用**）。于是积分行被挡住、开关又在打不开的页面里。现在把开关同时放在**模型区**（用户管理模型时视线所在）与**积分行本身**，并默认显示——不再依赖任何一个可能不可达的页面。
+
+### 修复（本版合并的 2.9.1–2.9.4）
+
+- **2.9.1**：积分行默认显示，关闭入口移到行内（原为默认关闭 + 开关藏在插件卡片）。
+- **2.9.2**：标签由「通用积分」改为「**Trae通用积分**」，避免与侧边栏里其他插件的数字混淆。
+- **2.9.3**：**补上复选框缺失的 CSS**——移植贡献者实现时只搬了侧边栏积分行的样式，漏掉了卡片里复选框的样式，导致它一直在渲染但**没有布局与配色、等同于不可见**；同时在「模型」区标题旁加了同一个复选框。
+- **2.9.4**：关闭后**彻底不显示**，不再残留「积分」小按钮（回到开关的路已在卡片两处）。
+
+### Tests
+
+- 全仓 423 → **435**：开关默认即显示；关闭后容器内**无任何 DOM**（`container.innerHTML === ''`）且轮询停止；行内 `×` 与卡片两处复选框**写同一字段、互相同步**；`preferStrongerRow` 等既有用例不变。
+- **变异验证多次全部被抓**：关闭时残留元素 → 2 例失败；去掉模型区的复选框 → 2 例失败；「缺失即开启」改回「必须显式 true」→ 1 例失败；收起态不退出 → 1 例失败。
+
+### 致谢
+
+报告人 **JiewiW** 独立完成了实现、430 个测试（含假定时器），并在独立 DSH 实例上做了端到端验证——包括「关闭开关后跨越两个应触发周期点无任何请求」这类定时器泄漏检查，还明确声明未改动版本号与无关代码。他当初在说明里提醒的「该 rc.2 宿主未内联挂载插件配置面板」后来被证明是真实的坑，本版据此把开关放到了可达位置。
+
+## 2.9.4 (2026-10-07)
+
+### 变更
+
+- **关闭积分显示后，侧边栏彻底不留任何东西**（`×` 或取消勾选都是如此）。之前关闭后会在原位置留一个「积分」小按钮，理由是可以随时找回开关；但 2.9.3 已经把同一个复选框放进卡片**两处**（卡片顶部 + 模型区），回到开关的路本来就在配置它的地方。**用户要的是清干净，残留一个按钮仍然占着他们想腾空的位置。**
+- 随之删除不再使用的样式（`.dsm-trae-sidebar-points-off` / `-show`）与文案键（`sidebar.show` / `sidebar.showHint`）。
+
+### Tests
+
+- `sidebar-points` 的用例改为断言**关闭后容器里没有任何 DOM**（`container.innerHTML === ''`），而不是「还剩一个可恢复的入口」；并断言轮询也随之停止。行内 `×` 的用例同样断言完全清空。
+- **变异验证被抓**：关闭时改为残留一个元素 → 2 例失败。
+
+## 2.9.3 (2026-10-07)
+
+> **修复：「显示积分」复选框实际上看不见**——它一直在卡片里渲染，但**没有任何 CSS**，所以读起来像是不存在。
+
+### 问题
+
+2.9.0 移植贡献者的实现时，我只搬了侧边栏积分行的样式，**漏掉了卡片里那个复选框的样式**（`.dsm-trae-mainui-switch*`）。复选框本身渲染了，但没有布局、没有间距、没有配色——在卡片里等同于不可见。用户因此反复找不到「在DSH主界面显示积分状态」这个开关。
+
+### 修复
+
+- **补上缺失的样式**（`.dsm-trae-mainui-switch` / `-label` / `input`），复选框现在正常显示、可点、有品牌色。
+- **在「模型」区标题旁再加一个同样的复选框**（就在「从 Trae 刷新」「一键测试启用模型」两个按钮的左侧）。理由：管理模型时视线就在那里，而**需要用户去找的设置等于没有设置**——这正是这个开关此前丢失的原因。两处写**同一个字段**，永不冲突；顶部的那个也保留。
+
+### Tests
+
+- 全仓 435（用例数不变，但 `card-mainui-switch` 的两条被**加强**）：现在断言卡片里**两处都有**复选框、默认都未勾选、且**勾任意一处另一处同步**（共享字段）；「配置已开启」的用例也改为断言**两处都是勾选态**。
+- **变异验证被抓**：删掉模型区那一个复选框 → 2 例失败。
+
+## 2.9.2 (2026-10-07)
+
+### 变更
+
+- **侧边栏积分行的标签改为「Trae通用积分」**（英文 `Trae credits`）。原先只写「通用积分」，而侧边栏底部可能同时出现其他插件的数字，读者无法确定这个余额属于谁。加上产品名前缀后一眼可辨。
+
+## 2.9.1 (2026-10-07)
+
+> **修复：积分行默认不显示，而它的开关在一个部分宿主上根本打不开。**
+
+### 问题
+
+2.9.0 把积分行做成 **opt-in**（`showPointsInMainUi` 默认 `false`），开关只放在插件卡片里。这在部分宿主上等于**功能不存在**：
+
+- 用户装了 **dshmarket**，插件页默认停在市场的 tab，而市场 UI **完全不渲染插件自带的配置卡片**（我在它的客户端 bundle 里搜 `plugins.row.config` / `plugins.bundle.config`，**0 处引用**；它只注册自己的卡片，key 是 `dshmarket`）。
+- 于是积分行被 Gate 挡住不渲染，而唯一能打开它的开关在用户到不了的页面里 —— 既看不到功能，也找不到开关。
+
+**根因是我把「可关闭」实现成了「默认关闭」**：用户的原话是「**如果要加这个显示**，再加一个开关让不想显示的用户可以关闭」——那本该是**默认显示 + 可关闭**。
+
+### 修复
+
+- **`showPointsInMainUi` 默认改为 `true`**（opt-out）。侧边栏底部直接显示通用积分。
+- **关闭开关移到积分行自己身上**：积分行右侧多一个 `×`，点一下即隐藏；隐藏后**同一位置留一个极小的「积分」按钮**，一点即恢复。
+  - 两个控件写的是**同一个字段**（`showPointsInMainUi`），因此与插件卡片里的复选框永不冲突。
+  - 关键点：**控制入口和功能渲染在同一处**，所以「宿主能画这一行」就等于「用户能控制它」，不再依赖任何设置页。
+- 侧边栏收起（56px 导轨）时仍然整行不渲染：收起态塞不下标签+数值+按钮，会变成「积…」。
+
+### 兼容性说明
+
+- 之前**明确关闭过**该开关的用户不受影响（显式 `false` 仍是关闭）；「字段缺失」现在按**开启**处理（原先按关闭），所以升级后会直接看到积分行。
+- 插件卡片里的复选框**保留**：在能渲染卡片的宿主上（如内置插件管理器），它依然可用。
+
+### Tests
+
+- 全仓 433 → **435**：新增「默认即显示」「关闭后留下可恢复的入口」「行内关闭按钮写入共享字段」；并把原「关闭时不渲染任何 DOM」的用例改写为**「关闭时仍留一个可操作入口」**——那条旧断言正是把这次的问题固化下来的地方。
+- **变异验证 2 次全部被抓**：把「缺失即开启」改回「必须显式 true」→ 1 例失败；关闭时改为不渲染入口 → 1 例失败。
+
+## 2.9.0 (2026-10-06)
+
+> **可选：在 DSH 主界面侧边栏常驻一行通用积分**（[#26](https://github.com/dingminhua/dsh-connect-trae/issues/26)，**由报告人 JiewiW 提交实现**）。
+>
+> 看积分原先必须打开插件设置卡片、展开、找到额度区；现在勾一个开关，侧边栏底部（工作区列表下方、设置上方）常驻一行「通用积分：<数值>」与刷新按钮。
+
+### Features
+
+- **侧边栏积分行**（开关 `showPointsInMainUi`，**默认关闭**）：在 `sidebar.footer.action` 槽位渲染「通用积分：<数值>」+ 「刷新」按钮；`title` 显示最近刷新时间；抓取失败保留上一次数值并提示；刷新进行中忽略重复点击。
+  - 开关关闭时**不渲染任何 DOM**（不是隐藏），因此不产生任何请求；关闭开关或插件卸载即清除定时器并中止在途请求。
+  - 开启后**先立即抓取一次，完成后再启动 5 分钟周期**的定时器，不叠加。
+
+### 合入时相对贡献者实现的三处调整
+
+1. **数字口径：`credits.generalAvailable`（通用积分），不是 `credits.available`。** `available` 是上游汇总（`summary.totalAmount - consumedAmount`），而卡片展示的是按额度包分出的 Work / 通用两桶；汇总**不保证**等于任一桶。一个用户在侧边栏找不到对应数字的余额，比没有数字更糟。通用桶也正是 SOLO 聊天路径消耗的那个。
+2. **轮询 60s → 5 分钟。** 卡片的轮询本身就是 60s，而每次 usage 读取会打**两个**上游请求；积分以「模型调用」而非秒为单位变化，60s 的边际价值很低。
+3. **侧边栏收起时整行不渲染**（`wide === false` → `null`）。宿主 CSS 并**不会**在收起时隐藏底部区域，而是把它压成 56px 居中窄条（`SidebarRoot.module.css` 的 `.collapsed .footerActions`）；标签 + 余额 + 按钮塞进 56px 会被裁成「积…」。而**收起正是长时间工作的常态**——这个功能最需要成立的时刻不能是它最坏看的时刻。提前退出也意味着收起期间不启动抓取循环。
+
+### Tests
+
+- 全仓 423 → **433**：移植贡献者的 7 例（开关默认关闭/持久化/读回/回显；挂载即抓取、首次抓取后启定时器、卸载即清除；失败保留上次数值；进行中点击被忽略；Gate 关闭时零 DOM），并新增 3 例锁定上述调整。
+- **测试加固**：贡献者的 fixture 让 `available` 与 `generalAvailable` **恰好相等**，所以换成哪个字段测试都过——这正是能悄悄退回汇总口径的盲区。现已让两者**不相等**，字段选错会立刻失败。
+- 同时把 `card-region-switch` 的取元素方式从「按下标取前两个 checkbox」改为**按 aria-label 精确匹配区域开关**：新开关让卡片多了第三个 checkbox，按下标会开始断言到错误的控件。
+- **变异验证 3 次全部被抓**：收起态不再退出 → 1 例失败；取字段改回 `available` → 3 例失败；轮询改回 60s → 1 例失败。
+
+### 致谢
+
+报告人 **JiewiW** 独立完成了实现、430 个测试（含假定时器）、并在独立 DSH 实例上做了端到端验证（含「关闭开关后跨越两个应触发周期点无任何请求」这类定时器泄漏检查），还明确声明未改动版本号与无关代码。
+
+## 2.8.0 (2026-10-06)
+
+> **绑定账号额度耗尽时不再是一块没有解释的空面板**（[#25](https://github.com/dingminhua/dsh-connect-trae/issues/25)，报告人 JiewiW）。
+>
+> 账号选择是**持久化**的：你一旦把某个账号绑上去，它就长期生效。于是「绑定的那个账号额度用尽」在卡片上表现为**一个永远为 0 的面板，没有任何解释**；而「刷新账号与 Token」会返回 200 和同一份账号列表，看起来和失败一模一样。报告人遇到的正是这个：TRAE SOLO CN 卸载后其凭据仍留在 `%APPDATA%`，CN 区一直绑着那个已耗尽的残留账号，而他以为绑的是自己正在用的 Trae CN。
+
+### Features
+
+- **「刷新账号与 Token」现在会报告结果**（`rescanAccounts`）：成功后显示「找到 N 个账号 · 仍绑定 X」，失败时显示原因并保留原错误。用户从此能区分「刷新成功但无变化」与「刷新失败」。
+- **绑定账号额度耗尽且本机另有可用账号时，卡片给出明确提示并支持一键切换**（仅国内版，额度接口只存在于 CN）：
+  - 仅当**已选账号自身额度为 0** 时才去查其他账号，账号健康时**不产生任何额外请求**；
+  - 提示里带上可用账号的名字、产品与可用积分数，一键写入绑定并立即刷新；
+  - 其他账号同样为空、或来自另一区域（国际版）的，一律不提示——避免给出「切过去也用不了」或「数字不适用本区」的建议。
+- **账号下拉显示可读的产品名**：`Trae` / `Trae 国际版` / `TRAE SOLO` / `TRAE SOLO 国际版`，取代原先裸露的 `cn` / `sg` / `solo` 标记——正是这个标记让报告人分不清哪个凭据来自已卸载的产品。
+
+### Implementation notes
+
+- 新增只读的 `TraeCredentialStore.credentialOf(accountId)`：查某个**指定**账号的凭据而不改绑。原先只能靠 `selectAccount` 切换来读，而那会与共用同一 store 的在途聊天请求竞争，并持久化一次用户并未做出的选择。这个方法是纯查询：只读、无刷新副作用、`accountId` 不变。
+- 探测其他账号的额度用一个**临时** usage client，并复用与绑定账号**完全相同**的 `toCredits`（Work/general 分桶），避免出现「提示里的数字和旁边显示的数字算法不一致」。
+
+### Tests
+
+- 全仓 419 → **423**（+4）：绑定账号为空时才出现替代账号；账号健康时**一次都不探测**（断言探测次数为 0）；同样为空、以及**跨区域**的账号既不被提示也不被探测；单个账号探测抛错时安全降级。
+- **变异验证 3 次全部被抓**：永不触发探测 → 1 例失败；去掉「无额度」过滤（空账号也会被当作出路）→ 1 例失败；去掉区域限制（会去探测国际版账号）→ 1 例失败。
+
 ## 2.7.2 (2026-10-05)
 
 > **补完 #23 的确定性**：2.7.1 修好了 Max 档随机丢失，但**在 max 相等时仍保留了先到者**，于是 **dev 基础窗口**还会随货架顺序漂移。报告人 JiewiW 在 Windows 复测时发现并给了修法（`glm-5.2`：`chat_v3` 的 dev=116000 与 `solo_agent_remote` 的 dev=200000 都带 max=1000000，谁先到就取谁）。

package/README.en.md

@@ -40,10 +40,11 @@ A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bund
 - **Dual-region detection (CN / international)** — detects local sign-ins across Trae CN, TRAE SOLO CN, Trae, and TRAE SOLO installs. The region is derived from the credential's own `userRegion` claim (host suffix and edition label as fallbacks), with no manual switch.
 - **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.
 - **Vision follows Trae's own declaration** — when Trae marks a model `multimodal`, the plugin advertises it as such with no manual tick per model (issue #16). The rule is "**models you tick ∪ models Trae marks multimodal**": models Trae marks `false`, or does not mark at all, stay text-only and can still be turned on by hand. A row enabled automatically is shown ticked and read-only, with the reason. See "Image input" below.
-- **Account switching** — refreshes the token list and lets users select an account without storing tokens in DSH settings.
+- **Account switching** — refreshes the token list and lets users select an account without storing tokens in DSH settings. **Your choice is remembered and stays in effect**: the plugin will never switch accounts on its own just because the bound one ran out of credit or another usable one was found (switching bills a different person). So when the bound account is exhausted the card **says so explicitly** and lists the other accounts on this machine that still have credit, with their balances, for you to switch to in one click — instead of showing an empty panel or quietly rebinding you. "Refresh accounts & tokens" now always reports what happened (how many accounts were found, who is still bound) instead of appearing to do nothing. The dropdown names the product (`Trae` / `TRAE SOLO` / international) so a credential left behind by an uninstalled app is recognisable.
 - **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.
 - **One-click test of the enabled models** — sends each **enabled** model one minimal message (a single `ping`, no tools) and reports whether it actually answers: **works** / **needs a higher plan** (Trae `1005`; your plan does not cover it) / **not served** (`4001`/`4011`; no SOLO function serves it) / **throttled** / **sign-in rejected** / **not determined**. The last one is a first-class outcome: a timeout, a dropped connection, a proxy or a 5xx is **never** reported as unusable — only an explicit upstream refusal is a negative verdict. This is the plugin's **only** operation that spends quota (check-in changes account state but spends nothing), it runs only when you click, and its results live in the current session rather than in your settings.
 - **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 that account has been paid). This is the plugin's **only** operation that changes account state, and it runs only when you click. Trae allows **one check-in per device per day**: after switching accounts, if this machine's slot is already spent (by any account), the selected account cannot claim here that day — the card explains that rather than pretending the account was paid. The international side has no check-in activity, so no button is shown there.
+- **Sidebar credits** — a permanent "Trae credits: <n>" line with a refresh button sits at the bottom of the left sidebar (below the workspace list, above Settings), refreshing every 5 minutes and on demand. **Shown by default**; the `×` on its right hides it completely (to bring it back, tick the switch in the plugin card — the same switch appears at the top of the card and beside the model actions). It shows the **general** credit pool — the one SOLO chat actually spends — so the number matches the card, and the line disappears when the sidebar is collapsed. The international region is subscription-based and has no comparable number, so nothing 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

package/README.md

@@ -40,10 +40,11 @@
 - **国内国际双区域自动识别** —— 自动发现 Trae CN / TRAE SOLO CN / Trae / TRAE SOLO 四个本地安装的登录账号；区域由凭证自带的 `userRegion` 声明自动判定（host 后缀与 edition 标签兜底），无需手动指定。
 - **目录与勾选按区域隔离** —— 国内版与国际版各一套模型目录、勾选、图片开关与上下文预算，两个供应商各自读各自的槽位。
 - **识图能力跟随 Trae 自身的标注** —— Trae 把某个模型标为 `multimodal` 时，插件直接按多模态对外声明，无需你在卡片上逐一手勾（issue #16）。判据是「**你手动勾选的 ∪ Trae 标注多模态的**」：Trae 明确标 `false` 或未标注的模型保持纯文本，你可以照旧手动为它们打开图片输入。卡片上被自动开启的那一行显示为已勾选且只读，并说明原因。详见下方「图片输入（识图）」。
-- **多账号切换** —— 支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。
+- **多账号切换** —— 支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。**你的选择会被记住并长期生效**：插件不会因为某个账号额度用尽、或检测到另一个可用账号就自作主张替你切换（换账号意味着换人计费）。所以当绑定的账号额度耗尽时，卡片会**明确告诉你**，并把本机其他还有额度的账号连同其可用积分数列出来，由你一键切换——而不是让面板一直空着、也不自动把你切走。「刷新账号与 Token」每次都会回报结果（找到几个账号、当前仍绑定谁），不会再「点了没反应」。下拉里显示的是产品名（`Trae` / `TRAE SOLO` / 国际版），便于分辨凭据来自哪个安装。
 - **只读用量与模型管理** —— 国内版查看 Work 积分与通用积分，国际版查看订阅/试用状态；刷新/启用 Trae 模型；只读查询不消耗额度。
 - **一键测试启用模型** —— 给**已启用**的每个模型发一条最小消息（一句 `ping`、不带工具），逐个告诉你能不能真的应答：**可用** / **需要更高档位**（Trae `1005`，你的套餐不覆盖）/ **上游不提供**（`4001`/`4011`，SOLO 通道没有这个模型）/ **被限流** / **登录凭据被拒** / **本次未测出**。最后一项是一等公民：超时、断连、代理、5xx **一律不算「不可用」**——只有上游明确的拒绝才算负面结论。**这是插件里唯一消耗额度的操作**（签到改变的是账号状态，不消耗），只在你点击时运行，结果只留在当前会话里不写入设置。
 - **每日签到领取** —— 国内版卡片上一键领取当日签到积分（按钮显示每日奖励，该账号已领取则显示「今日已领取」并禁用）；这是插件里**唯一会改变账号状态**的操作，由你主动点击触发。Trae 的签到按「**每台设备每天一次**」限制：切换账号后如果本机今天的名额已经用掉（无论是哪个账号用的），当前账号在本机当天无法再签，卡片会说明原因而不是谎报「已领取」。国际版没有签到活动，因此不显示该按钮。
+- **侧边栏积分** —— DSH 左侧边栏底部（工作区列表下方、设置上方）常驻一行「Trae通用积分：<数值>」与刷新按钮，每 5 分钟自动更新，也可手动刷新。**默认显示**；右侧的 `×` 可隐藏，关闭后**侧边栏不再留任何东西**（要重新显示就回到插件卡片里勾选，卡片顶部与模型区各有一个同一开关）。显示的是**通用积分**（SOLO 聊天实际消耗的那个额度池），与卡片上的数字一致；侧边栏收起时该行自动消失。国际版为订阅制、没有可比数字，因此不显示。
 - **安全 loopback shim** —— 每区域一个随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。
 
 ## 工作原理

package/lib/client.js

@@ -263,7 +263,22 @@ window.__ModuleLoader__.load({
 .dsm-trae-model-name-rate{color:var(--dsw-alias-label-tertiary,#999);font-size:11px;font-weight:400;line-height:16px;flex:none}
 /* The two head actions sit together; the probe one SPENDS quota, so it carries
    the hint tooltip rather than looking like its read-only sibling. */
+/* The sidebar-credit switch. Two instances share this style: the card's own
+   row at the top and the copy beside the model actions (2.9.3). Without it the
+   checkbox rendered unstyled and read as absent — the whole reason the switch
+   looked missing. */
+.dsm-trae-mainui-switch{padding:2px 0 0}
+.dsm-trae-mainui-switch-label{display:flex;align-items:center;gap:9px;font-size:13px;line-height:18px;color:var(--dsw-alias-label-secondary,#c6c9d0);cursor:pointer;white-space:nowrap}
+.dsm-trae-mainui-switch-label input{margin:0;accent-color:var(--dsw-alias-brand-primary,#5686fe)}
+.dsm-trae-mainui-switch-label:has(input:disabled){opacity:.6;cursor:default}
 .dsm-trae-models-actions{display:flex;align-items:center;gap:8px;flex:none}
+}
+.dsm-trae-usage-alternative{display:flex;align-items:flex-start;gap:10px;margin-top:10px;padding:10px 12px;border:1px solid var(--dsw-alias-state-warning-border,#7a5b12);border-radius:10px;background:var(--dsw-alias-state-warning-bg,#2a2313)}
+.dsm-trae-usage-alternative-text{margin:0;flex:1 1 auto;font-size:12px;line-height:18px;color:var(--dsw-alias-label-primary,#e6e6e6)}
+.dsm-trae-usage-switch-button{flex:0 0 auto;padding:5px 10px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:8px;background:var(--dsw-alias-bg-layer-3,#2c2f36);color:var(--dsw-alias-label-primary,#e6e6e6);font-size:12px;line-height:16px;cursor:pointer}
+.dsm-trae-usage-switch-button:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4,#333740)}
+.dsm-trae-usage-switch-button:disabled{opacity:.5;cursor:not-allowed}
+.dsm-trae-usage-note{margin:8px 0 0;color:var(--dsw-alias-label-tertiary,#999);font-size:11px;line-height:16px}
 .dsm-trae-models-hint{margin:4px 0 0;color:var(--dsw-alias-label-tertiary,#999);font-size:11px;line-height:16px}
 /* Verdict badge. Only a real refusal is coloured as a warning; an unknown
    verdict stays neutral because an inconclusive probe is not evidence against
@@ -303,6 +318,24 @@ window.__ModuleLoader__.load({
    an error: it is Trae's one-per-device-per-day rule, and the day is simply
    spent. Rendering it in the error colour would read as a plugin fault. */
 .dsm-trae-checkin-note{margin:8px 0 0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary,#c6c9d0)}
+`;
+		/**
+		* Sidebar credit line styles, injected by the sidebar component itself.
+		*
+		* Separate from the card bundle because the line lives in the shell's sidebar,
+		* not inside the plugin card; a card that is closed still shows this.
+		*/
+		const TRAE_SIDEBAR_CSS = `
+.dsm-trae-sidebar-points{display:flex;align-items:center;gap:8px;padding:4px 2px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary,#c6c9d0)}
+.dsm-trae-sidebar-points-line{display:flex;align-items:center;gap:6px;min-width:0;flex:1 1 auto}
+.dsm-trae-sidebar-points-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-variant-numeric:tabular-nums}
+.dsm-trae-sidebar-points-failed{color:var(--dsw-alias-state-error-primary,#ef4444);font-size:11px;line-height:16px;white-space:nowrap}
+.dsm-trae-sidebar-points-hide{appearance:none;flex:none;font:inherit;font-size:14px;line-height:1;padding:2px 6px;border:0;border-radius:6px;color:var(--dsw-alias-label-tertiary,#999);background:transparent;cursor:pointer}
+.dsm-trae-sidebar-points-hide:hover{color:var(--dsw-alias-label-primary,#e6e6e6);background:var(--dsw-alias-bg-layer-3,#2c2f36)}
+.dsm-trae-sidebar-points-refresh{appearance:none;flex:none;font:inherit;font-size:11px;line-height:16px;padding:2px 8px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:7px;color:var(--dsw-alias-label-secondary,#c6c9d0);background:transparent;cursor:pointer}
+.dsm-trae-sidebar-points-refresh:hover:not(:disabled){color:var(--dsw-alias-label-primary,#e6e6e6);border-color:var(--dsw-alias-label-dimmed,#777)}
+.dsm-trae-sidebar-points-refresh:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5686fe);outline-offset:1px}
+.dsm-trae-sidebar-points-refresh:disabled{opacity:.5;cursor:default}
 `;
 		//#endregion
 		//#region src/client/TraeUsageCard.tsx
@@ -368,7 +401,7 @@ window.__ModuleLoader__.load({
 				document.head.appendChild(styleTag);
 			}
 		}
-		function formatNumber(value) {
+		function formatNumber$1(value) {
 			return new Intl.NumberFormat(void 0, {
 				minimumFractionDigits: 0,
 				maximumFractionDigits: 0
@@ -387,7 +420,7 @@ window.__ModuleLoader__.load({
 			if (value === void 0) return unknown;
 			if (value >= 1e6 && value % 1e6 === 0) return `${value / 1e6}M`;
 			if (value >= 1e3 && value % 1e3 === 0) return `${value / 1e3}K`;
-			return formatNumber(value);
+			return formatNumber$1(value);
 		}
 		/**
 		* The subscription row's verdict.
@@ -479,8 +512,37 @@ window.__ModuleLoader__.load({
 			*/
 			const [claiming, setClaiming] = (0, react.useState)(false);
 			/** Last claim refusal, shown until the next successful refresh. */
+			/**
+			* Toggle the global "show credits at the DSH sidebar foot" switch. Unlike the
+			* per-region provider switch this is one top-level boolean shared by both
+			* regions; only that field is written, and the read-back must show the new
+			* value before success is reported.
+			*/
+			const toggleShowPointsInMainUi = async (enabled) => {
+				if (settingsScope === void 0 || settingsScope.getSnapshot().writable !== true) return;
+				setTogglingMainUi(true);
+				setWriteError(void 0);
+				try {
+					await writeSettingsField(settingsScope, "showPointsInMainUi", enabled, (readBack) => unwrapVolatileDeep(readBack)?.showPointsInMainUi === enabled);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
+				} finally {
+					if (mounted.current) setTogglingMainUi(false);
+				}
+			};
 			const [claimError, setClaimError] = (0, react.useState)(void 0);
 			/**
+			* Outcome of the last "refresh accounts" press (issue #25).
+			*
+			* The rescan answers 200 with a fresh account list whether or not anything
+			* changed, and the selection is PERSISTED, so a rescan of a machine whose
+			* bound account is still the one it was yesterday looks identical to a
+			* failure. Reporting the outcome is the difference between "it did nothing"
+			* and "it found the same 2 accounts, still on X".
+			*/
+			const [togglingMainUi, setTogglingMainUi] = (0, react.useState)(false);
+			const [rescanNote, setRescanNote] = (0, react.useState)(void 0);
+			/**
 			* Whether this MACHINE has spent today's check-in while the selected account
 			* has not been paid — the "switched account" state. Kept separate from
 			* `claimError` because it is not a failure: it is the upstream's one-per-
@@ -599,15 +661,24 @@ window.__ModuleLoader__.load({
 					});
 					const body = await response.json();
 					if (!response.ok || !Array.isArray(body.accounts)) throw new Error(`HTTP ${response.status}`);
-					const selected = body.accounts.find((account) => account.selected)?.id;
+					const selected = body.accounts.find((account) => account.selected);
 					const configured = configuredAccountsOf(settingsScope?.getSnapshot().value);
-					if (selected !== void 0 && selected !== configured[activeRegion] && settingsScope !== void 0 && settingsScope.getSnapshot().writable === true) await writeSettingsField(settingsScope, "accounts", {
+					const followed = selected !== void 0 && selected.id !== configured[activeRegion] && settingsScope !== void 0 && settingsScope.getSnapshot().writable === true;
+					if (followed && settingsScope !== void 0) await writeSettingsField(settingsScope, "accounts", {
 						...configured,
-						[activeRegion]: selected
-					}, (readBack) => configuredAccountsOf(readBack)[activeRegion] === selected);
+						[activeRegion]: selected.id
+					}, (readBack) => configuredAccountsOf(readBack)[activeRegion] === selected.id);
 					await refreshUsage(activeRegion);
+					if (mounted.current) setRescanNote(body.accounts.length === 0 ? t("row.accountsRefreshedNone") : t("row.accountsRefreshed", {
+						count: String(body.accounts.length),
+						selected: followed ? "" : ` · ${t("row.accountsKept")} ${selected?.accountName ?? selected?.id ?? "—"}`
+					}));
 				} catch (error) {
-					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
+					if (mounted.current) {
+						const message = error instanceof Error ? error.message : t("row.requestFailed");
+						setRescanNote(t("row.accountsRescanFailed", { message }));
+						setWriteError(message);
+					}
 				} finally {
 					if (mounted.current) setBusy(false);
 				}
@@ -968,6 +1039,21 @@ window.__ModuleLoader__.load({
 					children: open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dsm-trae-usage",
 						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dsm-trae-mainui-switch",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dsm-trae-mainui-switch-label",
+									title: t("row.showPointsInMainUiHint"),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										type: "checkbox",
+										checked: settingsValue?.showPointsInMainUi === true,
+										disabled: settingsScope?.getSnapshot().writable !== true || togglingMainUi,
+										onChange: (event) => {
+											toggleShowPointsInMainUi(event.currentTarget.checked);
+										}
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.showPointsInMainUi") })]
+								})
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: "dsm-trae-tabs",
 								role: "tablist",
@@ -1047,30 +1133,58 @@ window.__ModuleLoader__.load({
 									children: busy ? t("row.accountsScanning") : t("row.refreshTokens")
 								})]
 							}),
-							status.status !== "error" && status.accounts.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
+							status.status !== "error" && status.accounts.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 								className: "dsm-trae-account-picker",
 								"aria-label": t("row.accountsTitle"),
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-									className: "dsm-trae-usage-select-wrap",
-									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
-										className: "dsm-trae-usage-select",
-										value: status.status === "signed-in" ? status.accountId : "",
-										disabled: switchingAccount || settingsScope?.getSnapshot().writable !== true,
-										onChange: (event) => {
-											switchAccount(event.currentTarget.value);
-										},
-										children: status.accounts.map((account) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {
-											value: account.id,
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: "dsm-trae-usage-select-wrap",
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+											className: "dsm-trae-usage-select",
+											value: status.status === "signed-in" ? status.accountId : "",
+											disabled: switchingAccount || settingsScope?.getSnapshot().writable !== true,
+											onChange: (event) => {
+												switchAccount(event.currentTarget.value);
+											},
+											children: status.accounts.map((account) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {
+												value: account.id,
+												children: [
+													account.accountName,
+													" · ",
+													account.region === "ai" ? t("row.regionAi") : t("row.regionCn"),
+													" · ",
+													t(`row.edition${account.edition === "cn" ? "Cn" : account.edition === "sg" ? "Sg" : account.edition === "solo" ? "Solo" : "SoloSg"}`)
+												]
+											}, account.id))
+										})
+									}),
+									status.status === "signed-in" && status.alternatives !== void 0 && status.alternatives.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "dsm-trae-usage-alternative",
+										role: "status",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+											className: "dsm-trae-usage-alternative-text",
 											children: [
-												account.accountName,
-												" · ",
-												account.region === "ai" ? t("row.regionAi") : t("row.regionCn"),
-												" · ",
-												account.edition
+												t("row.creditsExhausted", { account: status.accountName }),
+												" ",
+												t("row.creditsAlternative", { accounts: status.alternatives.map((alt) => `${alt.accountName}（${t(`row.edition${alt.edition === "cn" ? "Cn" : alt.edition === "sg" ? "Sg" : alt.edition === "solo" ? "Solo" : "SoloSg"}`)}：${formatNumber$1(alt.workAvailable + alt.generalAvailable)}）`).join("、") })
 											]
-										}, account.id))
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "dsm-trae-usage-switch-button",
+											disabled: switchingAccount || settingsScope?.getSnapshot()?.writable !== true,
+											onClick: () => {
+												const target = status.alternatives?.[0];
+												if (target !== void 0) switchAccount(target.id);
+											},
+											children: t("row.creditsAlternativeSwitch")
+										})]
+									}) : null,
+									rescanNote === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+										className: "dsm-trae-usage-note",
+										role: "status",
+										children: rescanNote
 									})
-								})
+								]
 							}) : null,
 							status.status === "signed-in" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 								status.payStatus === void 0 || payPlan === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1130,7 +1244,7 @@ window.__ModuleLoader__.load({
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dsm-trae-usage-stat-value dsm-trae-usage-stat-value-work",
-													children: formatNumber(status.credits.workAvailable)
+													children: formatNumber$1(status.credits.workAvailable)
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dsm-trae-usage-stat-hint",
@@ -1152,7 +1266,7 @@ window.__ModuleLoader__.load({
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dsm-trae-usage-stat-value dsm-trae-usage-stat-value-general",
-													children: formatNumber(status.credits.generalAvailable)
+													children: formatNumber$1(status.credits.generalAvailable)
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dsm-trae-usage-stat-hint",
@@ -1169,8 +1283,8 @@ window.__ModuleLoader__.load({
 								status.checkin === void 0 ? null : (() => {
 									const accountClaimed = status.checkin.checkedIn;
 									const deviceSpent = !accountClaimed && (status.checkin.didCheckedIn || deviceSpentNotice);
-									const reward = formatNumber(status.checkin.credits);
-									const bonus = status.checkin.extraCredits === void 0 ? "" : ` + ${formatNumber(status.checkin.extraCredits)}`;
+									const reward = formatNumber$1(status.checkin.credits);
+									const bonus = status.checkin.extraCredits === void 0 ? "" : ` + ${formatNumber$1(status.checkin.extraCredits)}`;
 									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 										className: "dsm-trae-checkin",
 										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -1224,27 +1338,42 @@ window.__ModuleLoader__.load({
 												children: t("row.modelsSummary", { count: activeEnabledIds.size })
 											})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 												className: "dsm-trae-models-actions",
-												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-													type: "button",
-													className: "dsm-btn dsm-btn-outline",
-													disabled: busy,
-													onClick: () => {
-														refreshModels();
-													},
-													children: busy ? t("row.modelsRefreshing") : t("row.modelsRefresh")
-												}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-													type: "button",
-													className: "dsm-btn dsm-btn-outline",
-													disabled: busy || testing !== void 0 || activeEnabledIds.size === 0,
-													title: t("row.modelsTestHint"),
-													onClick: () => {
-														testEnabledModels();
-													},
-													children: testing === void 0 ? t("row.modelsTestEnabled") : t("row.modelsTesting", {
-														done: testing.done,
-														total: testing.total
+												children: [
+													/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+														className: "dsm-trae-mainui-switch-label",
+														title: t("row.showPointsInMainUiHint"),
+														children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+															type: "checkbox",
+															checked: settingsValue?.showPointsInMainUi === true,
+															disabled: settingsScope?.getSnapshot().writable !== true || togglingMainUi,
+															onChange: (event) => {
+																toggleShowPointsInMainUi(event.currentTarget.checked);
+															}
+														}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.showPointsInMainUi") })]
+													}),
+													/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+														type: "button",
+														className: "dsm-btn dsm-btn-outline",
+														disabled: busy,
+														onClick: () => {
+															refreshModels();
+														},
+														children: busy ? t("row.modelsRefreshing") : t("row.modelsRefresh")
+													}),
+													/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+														type: "button",
+														className: "dsm-btn dsm-btn-outline",
+														disabled: busy || testing !== void 0 || activeEnabledIds.size === 0,
+														title: t("row.modelsTestHint"),
+														onClick: () => {
+															testEnabledModels();
+														},
+														children: testing === void 0 ? t("row.modelsTestEnabled") : t("row.modelsTesting", {
+															done: testing.done,
+															total: testing.total
+														})
 													})
-												})]
+												]
 											})]
 										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -1411,6 +1540,236 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/SidebarPoints.tsx
+		/**
+		* Compact credit line contributed to the DSH main sidebar foot
+		* (`sidebar.footer.action`).
+		*
+		* Mounted only while the plugin-card switch `showPointsInMainUi` is on, so the
+		* slot renders nothing when the feature is off. On mount it fetches the bound
+		* CN account's remaining credits ONCE and only then starts the periodic
+		* refresh timer; the timer is cleared on unmount (switch off / plugin unload),
+		* so timers never stack.
+		*
+		* A failed refresh keeps the last known value and surfaces a short failure
+		* note; an in-flight refresh ignores further clicks (debounce).
+		*/
+		/**
+		* Automatic refresh period. The first fetch happens immediately on enable;
+		* this is the gap between subsequent automatic fetches.
+		*
+		* Five minutes, not the card's 60s: a credit balance moves on the scale of
+		* model calls, not seconds, and this line is a glanceable reminder rather than
+		* a live meter. Each poll is two read-only upstream calls, so a tighter period
+		* would buy nothing a user can act on.
+		*/
+		const SIDEBAR_POINTS_REFRESH_INTERVAL_MS = 3e5;
+		/** Inject the sidebar-line CSS once. */
+		if (typeof document !== "undefined") {
+			const cssId = "dsh-connect-trae/sidebar.css";
+			if (!document.querySelector(`style[data-plugin-css="${cssId}"]`)) {
+				const styleTag = document.createElement("style");
+				styleTag.dataset.plugin = "dsh-connect-trae";
+				styleTag.dataset.pluginCss = cssId;
+				styleTag.textContent = TRAE_SIDEBAR_CSS;
+				document.head.appendChild(styleTag);
+			}
+		}
+		function formatNumber(value) {
+			return new Intl.NumberFormat(void 0, { maximumFractionDigits: 0 }).format(value);
+		}
+		function formatClock(value) {
+			return new Intl.DateTimeFormat(void 0, {
+				hour: "2-digit",
+				minute: "2-digit",
+				second: "2-digit"
+			}).format(new Date(value));
+		}
+		/**
+		* The GENERAL credit balance out of one usage-route document.
+		*
+		* Deliberately `generalAvailable`, NOT `credits.available`. The latter is the
+		* upstream aggregate (`summary.totalAmount - consumedAmount`), while the card
+		* shows two buckets derived from the entitlement packs; the aggregate is not
+		* guaranteed to equal the buckets, and a sidebar number the user cannot match
+		* against the card is worse than no number at all. The general bucket is the
+		* one the SOLO chat path spends, so it is the one worth watching.
+		*/
+		function generalCreditsOf(usage) {
+			if (usage.status !== "signed-in") return void 0;
+			return usage.credits?.generalAvailable;
+		}
+		/** One fetch+render cycle. Returns false when the request failed. */
+		function SidebarPoints({ t, onHide }) {
+			if (t === void 0) throw new Error("Sidebar points line requires its translation function");
+			const [points, setPoints] = (0, react.useState)(void 0);
+			const [signedIn, setSignedIn] = (0, react.useState)(true);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [failed, setFailed] = (0, react.useState)(false);
+			const [lastRefresh, setLastRefresh] = (0, react.useState)(void 0);
+			/** True while a request is in flight; debounces repeated refresh clicks. */
+			const inFlight = (0, react.useRef)(false);
+			const mounted = (0, react.useRef)(true);
+			(0, react.useEffect)(() => {
+				mounted.current = true;
+				return () => {
+					mounted.current = false;
+				};
+			}, []);
+			const fetchPoints = (0, react.useCallback)(async (signal) => {
+				if (inFlight.current) return false;
+				inFlight.current = true;
+				if (mounted.current) setBusy(true);
+				try {
+					const response = await fetch(withTraeRegion(TRAE_USAGE_PATH, "cn"), {
+						headers: { accept: "application/json" },
+						credentials: "same-origin",
+						...signal === void 0 ? {} : { signal }
+					});
+					if (!response.ok) throw new Error(`HTTP ${response.status}`);
+					const value = await response.json();
+					if (!mounted.current || signal?.aborted === true) return true;
+					const general = generalCreditsOf(value);
+					if (general !== void 0) {
+						setPoints(general);
+						setSignedIn(true);
+					} else setSignedIn(value.status === "signed-in");
+					setFailed(false);
+					setLastRefresh(Date.now());
+					return true;
+				} catch {
+					if (mounted.current && signal?.aborted !== true) setFailed(true);
+					return false;
+				} finally {
+					inFlight.current = false;
+					if (mounted.current) setBusy(false);
+				}
+			}, []);
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				let timer;
+				const controller = new AbortController();
+				fetchPoints(controller.signal).finally(() => {
+					if (cancelled) return;
+					timer = window.setInterval(() => {
+						fetchPoints(controller.signal);
+					}, SIDEBAR_POINTS_REFRESH_INTERVAL_MS);
+				});
+				return () => {
+					cancelled = true;
+					if (timer !== void 0) window.clearInterval(timer);
+					controller.abort();
+				};
+			}, [fetchPoints]);
+			const titleText = lastRefresh === void 0 ? void 0 : t("sidebar.lastRefresh", { time: formatClock(lastRefresh) });
+			const valueText = !signedIn ? t("sidebar.signedOut") : points === void 0 ? "—" : formatNumber(points);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "dsm-trae-sidebar-points",
+				title: titleText,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: "dsm-trae-sidebar-points-line",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: "dsm-trae-sidebar-points-text",
+							"aria-live": "polite",
+							children: [
+								t("sidebar.points"),
+								"：",
+								valueText
+							]
+						}), failed ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "dsm-trae-sidebar-points-failed",
+							role: "status",
+							children: t("sidebar.refreshFailed")
+						}) : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "dsm-trae-sidebar-points-refresh",
+						disabled: busy,
+						"aria-label": busy ? t("sidebar.refreshing") : t("sidebar.refresh"),
+						title: busy ? t("sidebar.refreshing") : t("sidebar.refresh"),
+						onClick: () => {
+							fetchPoints();
+						},
+						children: busy ? t("sidebar.refreshing") : t("sidebar.refresh")
+					}),
+					onHide === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "dsm-trae-sidebar-points-hide",
+						"aria-label": t("sidebar.hide"),
+						title: t("sidebar.hide"),
+						onClick: onHide,
+						children: "×"
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/SidebarPointsGate.tsx
+		/**
+		* Gate between the `sidebar.footer.action` slot and the compact credit line.
+		*
+		* Kept in its own module (rather than inside the browser-plugin entry) so it
+		* can be imported from the Node/jsdom test suite: the entry imports
+		* browser-only DSH packages the test environment cannot load, but this gate
+		* depends only on React, the card's settings-scope shape and the line
+		* component.
+		*
+		* TWO states:
+		*
+		*  - on  → {@link SidebarPoints}, which owns the fetch loop and its timer;
+		*  - off → NOTHING. The row is absent from the DOM, not hidden.
+		*
+		* Off used to leave a small "积分" chip behind, on the theory that a switch you
+		* cannot find is no switch at all (2.9.1). That safety net is no longer needed:
+		* the card carries the same checkbox twice — at the top of the card and beside
+		* the model actions — so the way back is always where the feature is
+		* configured. What the user asked for is for the row to be gone, and a leftover
+		* chip still occupies the footer they wanted cleared.
+		*
+		* The collapsed rail also renders nothing: the shell squeezes the footer to a
+		* 56px strip rather than hiding it, and the line does not read well there — see
+		* the bail-out below.
+		*/
+		/**
+		* Read the sidebar-credit switch out of a committed settings snapshot.
+		*
+		* Absent means ON: the field defaults to true on the host, and a settings
+		* scope that has not populated yet must not blink the line away. Only an
+		* explicit `false` (the user turned it off, from the line or the card) hides
+		* the balance.
+		*/
+		function sidebarPointsEnabledOf(scope) {
+			if (scope === void 0) return true;
+			return unwrapVolatileDeep(scope.getSnapshot().value)?.showPointsInMainUi !== false;
+		}
+		function SidebarPointsGate(props) {
+			const { t, settingsScope, wide } = props;
+			const [enabled, setEnabled] = (0, react.useState)(() => sidebarPointsEnabledOf(settingsScope));
+			(0, react.useEffect)(() => settingsScope?.subscribe(() => {
+				setEnabled(sidebarPointsEnabledOf(settingsScope));
+			}), [settingsScope]);
+			/**
+			* Write the switch back through the same field the card writes, so the two
+			* controls can never disagree. The read-back is not awaited for its value:
+			* the subscription above re-renders when the committed snapshot changes, and
+			* an unwritable scope simply leaves the current state alone.
+			*/
+			const setShown = (0, react.useCallback)((next) => {
+				if (settingsScope === void 0 || settingsScope.getSnapshot().writable !== true) return;
+				settingsScope.set("showPointsInMainUi", next).catch(() => {});
+			}, [settingsScope]);
+			if (wide === false) return null;
+			if (!enabled) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarPoints, {
+				t,
+				onHide: () => {
+					setShown(false);
+				}
+			});
+		}
+		//#endregion
 		//#region src/client/locales.ts
 		/**
 		* Plugin-card copy registered under the settings.trae locale namespace.
@@ -1484,6 +1843,26 @@ window.__ModuleLoader__.load({
 			"row.modelsTestEnabled": "Test enabled models",
 			"row.modelsTesting": "Testing {done}/{total}…",
 			"row.modelsTestHint": "Sends one minimal message per enabled model to see which ones actually answer. Costs a small amount of quota.",
+			"row.showPointsInMainUi": "Show credits in the DSH main UI",
+			"row.showPointsInMainUiHint": "Keep a general-credit line with a refresh button at the bottom of the DSH sidebar (hidden while the sidebar is collapsed; refreshes every 5 minutes).",
+			"sidebar.points": "Trae credits",
+			"sidebar.refresh": "Refresh",
+			"sidebar.refreshing": "Refreshing…",
+			"sidebar.lastRefresh": "Last refreshed {time}",
+			"sidebar.refreshFailed": "Refresh failed",
+			"sidebar.signedOut": "Not signed in",
+			"sidebar.hide": "Hide credits",
+			"row.accountsRefreshed": "Accounts refreshed: {count} found{selected}",
+			"row.accountsKept": "still bound to",
+			"row.accountsRefreshedNone": "Accounts refreshed: no usable Trae account found",
+			"row.accountsRescanFailed": "Could not refresh accounts: {message}",
+			"row.editionCn": "Trae",
+			"row.editionSg": "Trae (international)",
+			"row.editionSolo": "TRAE SOLO",
+			"row.editionSoloSg": "TRAE SOLO (international)",
+			"row.creditsExhausted": "The bound account ({account}) has run out of credit",
+			"row.creditsAlternative": "Another account on this machine still has credit: {accounts}",
+			"row.creditsAlternativeSwitch": "Switch to it",
 			"row.modelsTestEmpty": "Enable at least one model first.",
 			"row.modelsTestError": "Test failed: {message}",
 			"row.modelsTestDone": "{available} of {total} answered.",
@@ -1576,6 +1955,26 @@ window.__ModuleLoader__.load({
 			"row.modelsTestEnabled": "一键测试启用模型",
 			"row.modelsTesting": "正在测试 {done}/{total}…",
 			"row.modelsTestHint": "给每个已启用模型发一条最小消息，看哪些真的能应答。会消耗少量额度。",
+			"row.showPointsInMainUi": "在DSH主界面显示积分状态",
+			"row.showPointsInMainUiHint": "在 DSH 侧边栏底部常驻一行通用积分与刷新按钮（收起侧边栏时不显示，每 5 分钟自动刷新）。",
+			"sidebar.points": "Trae通用积分",
+			"sidebar.refresh": "刷新",
+			"sidebar.refreshing": "刷新中…",
+			"sidebar.lastRefresh": "最近刷新 {time}",
+			"sidebar.refreshFailed": "刷新失败",
+			"sidebar.signedOut": "未登录",
+			"sidebar.hide": "隐藏积分",
+			"row.accountsRefreshed": "已刷新账号：找到 {count} 个账号{selected}",
+			"row.accountsKept": "仍绑定",
+			"row.accountsRefreshedNone": "已刷新账号：未找到可用的 Trae 账号",
+			"row.accountsRescanFailed": "刷新账号失败：{message}",
+			"row.editionCn": "Trae",
+			"row.editionSg": "Trae 国际版",
+			"row.editionSolo": "TRAE SOLO",
+			"row.editionSoloSg": "TRAE SOLO 国际版",
+			"row.creditsExhausted": "当前绑定账号（{account}）额度已用尽",
+			"row.creditsAlternative": "本机还有可用账号：{accounts}",
+			"row.creditsAlternativeSwitch": "切换到它",
 			"row.modelsTestEmpty": "请先启用至少一个模型。",
 			"row.modelsTestError": "测试失败：{message}",
 			"row.modelsTestDone": "{total} 个里有 {available} 个正常应答。",
@@ -1725,6 +2124,32 @@ window.__ModuleLoader__.load({
 				};
 				registerCard("plugins.bundle.config", "dsh-connect-trae");
 				registerCard("plugins.row.config", "dsh-connect-trae#dsh-connect-trae");
+				/**
+				* General-credit line at the sidebar foot (`sidebar.footer.action`, a
+				* root-scope list slot), contributed by JiewiW (issue #26).
+				*
+				* Registration is unconditional for the slot's lifetime; the component
+				* renders nothing until the card switch is on, and nothing again while the
+				* sidebar is collapsed — so an off switch (or a collapsed rail) leaves zero
+				* DOM and no fetch loop.
+				*/
+				const registerSidebarPoints = () => {
+					try {
+						ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
+							name: "sidebar.footer.action",
+							id: "dsh-connect-trae-points",
+							order: 4,
+							locale: namespace,
+							inject: () => ({
+								t,
+								settingsScope
+							})
+						}, SidebarPointsGate));
+					} catch (error) {
+						console.error("[dsh-connect-trae] sidebar points slot failed to register (host provider unaffected):", error);
+					}
+				};
+				registerSidebarPoints();
 			} catch (error) {
 				console.error("[dsh-connect-trae] client card failed to load (host provider unaffected):", error);
 			}

package/lib/index.d.ts

@@ -483,6 +483,22 @@ declare class TraeCredentialStore {
   private preferred;
   accounts(): Promise<TraeAccountChoice[]>;
   current(): Promise<TraeCredential | undefined>;
+  /**
+   * The stored credential of one specific account, without changing which
+   * account this store is bound to (issue #25).
+   *
+   * The card needs to answer "the account I am bound to has run out of credits
+   * — is another account on this machine usable?" and {@link resolve} cannot
+   * help: it always returns the BOUND account, and switching the bound account
+   * just to read one number would race every in-flight chat request sharing
+   * this store, and would persist a selection the user never made.
+   *
+   * So this is a pure lookup: read-only, no refresh side effects (a stale token
+   * is returned as-is and the caller's request then fails honestly), and
+   * `accountId` is left untouched. An unknown id yields undefined rather than a
+   * fallback, for the same reason {@link current} refuses to fall back.
+   */
+  credentialOf(accountId: string): Promise<TraeCredential | undefined>;
   resolve(): Promise<TraeCredential>;
   status(): Promise<{
     state: 'signed-in' | 'signed-out';
@@ -1673,6 +1689,22 @@ interface TraeWebAccount {
   tokenExpiresAtMs: number;
   selected: boolean;
 }
+/**
+ * Another account on this machine that still has credit, surfaced only while
+ * the BOUND account is exhausted (issue #25).
+ *
+ * The account switch is persisted, so a user whose bound account ran out sees
+ * a permanently zeroed card with no explanation. This carries just enough to
+ * name the alternative in the UI — identity plus the two CN credit buckets —
+ * and is only ever produced by a read-only upstream call.
+ */
+interface TraeWebCreditAlternative {
+  id: string;
+  accountName: string;
+  edition: TraeWebAccount['edition'];
+  workAvailable: number;
+  generalAvailable: number;
+}
 /** One probed candidate path and why it did not yield an account. */
 interface TraeWebSearchPath {
   path: string;
@@ -1789,6 +1821,13 @@ type TraeWebUsage = {
   };
   credits?: TraeWebCredits;
   creditsError?: string;
+  /**
+   * Present only when the bound account is out of credit AND another account
+   * on this machine has some (issue #25). The card then offers a one-click
+   * switch instead of leaving a permanently empty panel. Absent in every
+   * other case so a healthy account never pays for the extra read.
+   */
+  alternatives?: readonly TraeWebCreditAlternative[];
   /**
    * Daily check-in state (CN only). Absent on the international region,
    * whose check-in surface does not exist — probed 2026-09-24: the
@@ -1817,6 +1856,12 @@ interface TraeUsageRouteOptions {
   store(region: TraeRegion): TraeCredentialStore;
   /** The region-scoped usage client (CN work credits / international pay status). */
   client(region: TraeRegion): TraeUsageClient;
+  /**
+   * CN credit balances of an account OTHER than the bound one, read without
+   * changing which account is bound (issue #25). Optional: when absent the
+   * exhausted-account hint is simply not offered.
+   */
+  creditsOfAccount?(region: TraeRegion, accountId: string): Promise<TraeWebCredits | undefined>;
   /** The requested region's last-refreshed raw directory (one entry per upstream model). */
   displayModels(region: TraeRegion): readonly TraeModelInfo[];
   /** The user's model selection in the requested region, stored as model id (= Trae name). */
@@ -1977,6 +2022,22 @@ interface Config {
    * its own slot; tokens remain outside settings.
    */
   accounts?: Partial<Record<TraeRegion, string>>;
+  /**
+   * Show the CN account's general credit balance as a permanent line at the
+   * bottom of the DSH sidebar (issue #26, contributed by JiewiW).
+   *
+   * ON by default and opt-out since 2.9.1. It was opt-in first, on the theory
+   * that a user who never asked for a periodic usage read should not get one —
+   * but the switch lived only in the plugin card, and the card is not reachable
+   * in every host: a market plugin can own the Plugins tab and never dispatch
+   * `plugins.bundle.config`, so the line was permanently off with no discoverable
+   * way to turn it on. The line now carries its own on/off control in the
+   * sidebar, which is reachable exactly where the feature renders.
+   *
+   * Declared volatile alongside `accounts`/`regions` so the settings form can
+   * both read and write it.
+   */
+  showPointsInMainUi?: boolean;
   /**
    * Per-region model state, keyed `cn` | `ai`. The CN and international apps
    * expose different rosters, so each keeps its own directory and selection

package/lib/index.js

@@ -1198,6 +1198,25 @@ var TraeCredentialStore = class {
 		if (this.accountId === void 0) return this.preferred(credentials);
 		return credentials.find((credential) => traeAccountId(credential) === this.accountId);
 	}
+	/**
+	* The stored credential of one specific account, without changing which
+	* account this store is bound to (issue #25).
+	*
+	* The card needs to answer "the account I am bound to has run out of credits
+	* — is another account on this machine usable?" and {@link resolve} cannot
+	* help: it always returns the BOUND account, and switching the bound account
+	* just to read one number would race every in-flight chat request sharing
+	* this store, and would persist a selection the user never made.
+	*
+	* So this is a pure lookup: read-only, no refresh side effects (a stale token
+	* is returned as-is and the caller's request then fails honestly), and
+	* `accountId` is left untouched. An unknown id yields undefined rather than a
+	* fallback, for the same reason {@link current} refuses to fall back.
+	*/
+	async credentialOf(accountId) {
+		if (accountId === "") return void 0;
+		return (await this.readAll()).find((credential) => traeAccountId(credential) === accountId);
+	}
 	async resolve() {
 		const credential = await this.current();
 		if (credential === void 0) throw new Error(`trae: no signed-in account found (${this.candidates().map((item) => item.path).join(" or ")})`);
@@ -4081,6 +4100,8 @@ function json(res, status, body) {
 	});
 	res.end(payload);
 }
+/** Bound on how many OTHER accounts one status read may probe (issue #25). */
+const TRAE_CREDIT_ALTERNATIVE_LIMIT = 8;
 /**
 * Read the ids to test from a POST body.
 *
@@ -4125,7 +4146,14 @@ function loopbackOrigin(req) {
 		return false;
 	}
 }
-/** Map the credit snapshot to the card's compact credit document. */
+/**
+* Map the credit snapshot to the card's compact credit document.
+*
+* Exported so the "is another account usable?" probe (issue #25) derives its
+* two buckets through the SAME endpoint classification the bound account uses
+* — a second implementation of the Work/general split would be free to disagree
+* with the number shown next to it.
+*/
 function toCredits(snapshot) {
 	const { totalAmount, consumedAmount } = snapshot.summary;
 	const credit = (value) => Math.round(value * 1e4) / 1e4;
@@ -4221,14 +4249,51 @@ async function traeWebUsage(deps, region) {
 		};
 	}
 	const [snapshotResult, checkinResult] = await Promise.allSettled([client.snapshot(), client.checkinStatus()]);
+	const credits = snapshotResult.status === "fulfilled" ? toCredits(snapshotResult.value) : void 0;
+	const alternatives = credits !== void 0 && credits.workAvailable <= 0 && credits.generalAvailable <= 0 ? await creditAlternatives(deps, region, accounts) : void 0;
 	return {
 		status: "signed-in",
 		...account,
-		...snapshotResult.status === "fulfilled" ? { credits: toCredits(snapshotResult.value) } : { creditsError: safeMessage(snapshotResult.reason) },
-		...checkinResult.status === "fulfilled" ? { checkin: toCheckin(checkinResult.value) } : { checkinError: safeMessage(checkinResult.reason) }
+		...credits === void 0 ? { creditsError: snapshotResult.status === "rejected" ? safeMessage(snapshotResult.reason) : "unknown" } : { credits },
+		...checkinResult.status === "fulfilled" ? { checkin: toCheckin(checkinResult.value) } : { checkinError: safeMessage(checkinResult.reason) },
+		...alternatives === void 0 ? {} : { alternatives }
 	};
 }
 /**
+* Other accounts on this machine that still have credit, when the bound one has
+* none (issue #25).
+*
+* Only ever called for a bound account whose own credits came back at zero, so
+* a healthy setup pays nothing for it. Each candidate is read through
+* `creditsOfAccount`, which must not disturb the bound account; a candidate
+* that fails is simply absent from the answer rather than reported as a broken
+* account, because a stale token on an unrelated login is not this card's
+* problem to explain. The list is capped so a machine with many stale
+* credentials cannot turn one status read into a burst of upstream calls.
+*/
+async function creditAlternatives(deps, region, accounts) {
+	if (deps.creditsOfAccount === void 0) return void 0;
+	const candidates = accounts.filter((account) => !account.selected && account.region === region).slice(0, TRAE_CREDIT_ALTERNATIVE_LIMIT);
+	if (candidates.length === 0) return void 0;
+	const alternatives = (await Promise.all(candidates.map(async (account) => {
+		try {
+			const credits = await deps.creditsOfAccount(region, account.id);
+			if (credits === void 0) return void 0;
+			if (credits.workAvailable <= 0 && credits.generalAvailable <= 0) return void 0;
+			return {
+				id: account.id,
+				accountName: account.accountName,
+				edition: account.edition,
+				workAvailable: credits.workAvailable,
+				generalAvailable: credits.generalAvailable
+			};
+		} catch {
+			return;
+		}
+	}))).filter((entry) => entry !== void 0);
+	return alternatives.length === 0 ? void 0 : alternatives;
+}
+/**
 * The region a request addresses, or a 400 answer. Absent parameter means the
 * domestic tab; an unknown value is refused rather than guessed.
 */
@@ -4704,6 +4769,7 @@ const Config = z.object({
 		"solo-sg"
 	]).default("auto").description("Trae edition hint")),
 	accountId: z.string().description("Deprecated: pre-split account selector, attributed to its own region"),
+	showPointsInMainUi: asVolatile(z.boolean().default(true).description("在DSH主界面显示积分状态（可在侧边栏那一行上随时关闭）")),
 	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"),
@@ -4893,6 +4959,22 @@ function apply(ctx, config) {
 				credential: () => store.resolve(),
 				deviceId: async () => (await identity()).deviceId
 			}),
+			/**
+			* Credit balance of one named account, WITHOUT rebinding the store
+			* (issue #25). The card asks this only after it saw the bound account
+			* come back empty, so it can point at a login that still works.
+			*
+			* A throwaway client is used on purpose: the shared `usageClient` reads
+			* `store.resolve()`, which is bound to the selected account, and calling
+			* `selectAccount` to look at a neighbour would both race concurrent chat
+			* requests and persist a switch the user never made. A stale token simply
+			* fails here and the account is left out of the answer.
+			*/
+			creditsOfAccount: async (accountId) => {
+				const credential = await store.credentialOf(accountId);
+				if (credential === void 0) return void 0;
+				return toCredits(await new TraeUsageClient({ credential: async () => credential }).snapshot());
+			},
 			discoverModels: async (signal) => {
 				const merged = mergeTraeModelSources(await withDirectoryRetry(() => remoteCatalog.fetchModels(signal)), await solo.fetchModels(signal));
 				wire.callableKeys.clear();
@@ -4951,7 +5033,8 @@ function apply(ctx, config) {
 		regionEnabled: (region) => regionEnabled(current(), region),
 		discoverModels: (region, signal) => stacks[region].discoverModels(signal),
 		probeModels: (region, ids) => stacks[region].probeModels(ids),
-		rawDiagnostic: (region) => stacks[region].rawDiagnostic()
+		rawDiagnostic: (region) => stacks[region].rawDiagnostic(),
+		creditsOfAccount: (region, accountId) => stacks[region].creditsOfAccount(accountId)
 	}));
 	/**
 	* Live registration handles per region, filled once the shim is listening.

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-trae",
   "displayName": "DSH Connect Trae",
   "description": "把本机登录的 Trae 模型接入 DeepSeek Harness：国内版与国际版双供应商并行，提供用量/积分概览与每日签到领取。",
-  "version": "2.7.2",
+  "version": "2.10.0",
   "author": "dingminhua",
   "copyright": "Copyright (c) 2026 LaoDing",
   "license": "MIT",