dsh-connect-trae 4.16.0 → 4.17.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 4.17.0 (2026-11-09)
+
+### 自动刷新改为可选项：整个插件一个节奏，默认 5 分钟
+
+改动前，插件对**同两条只读上游路由**用了**两个硬编码节奏**：卡片每 **60 秒**重读一次用量
+文档，输入框读数每 **5 分钟**一次。取哪个取决于你正好在看哪个界面，两个都改不了。而每次
+用量读取是**两次上游请求**，所以「正在看卡片」这件事本身就悄悄把后台流量翻了几倍。
+
+现在是一个字段 `refreshIntervalMinutes`，一处 UI（「设置 → Trae → **能力**」里的
+「自动刷新」），可选 **1 / 5 / 10 / 30 / 60 分钟**，**默认 5**。默认值选 5 是因为它正是
+输入框读数原本的节奏——升级不改变任何人的观感，而卡片的 60 秒被拉到同一个值上。
+
+**为什么是「整个插件一个值」而不是每面板一个。** 它配的是插件的后台噪声，不是某个区域的
+数据：两处打的是同两条路由、同样的代价。按面板存会让同一块屏幕出现两个节奏，而这正是这次
+要消灭的东西。
+
+**写读链路，以及为什么不是简单的 `setInterval` 换个数。**
+
+| 环节 | 做法 | 不做会怎样 |
+| --- | --- | --- |
+| schema | `z.union([1,5,10,30,60])`，默认 5 | 手改文件写个 `7` 会被接受，得到一个没人选过的节奏 |
+| 读取 | `refreshIntervalMinutesOf()`，非集合内一律回落默认 | 认不出的值让刷新**静默停止**，症状只是数字悄悄变旧 |
+| 写入 | `writeSettingsField` 读回校验，比的是**解析后的分钟数** | 写入被接受但没落地时，选择器显示新值而定时器还是旧的 |
+| 定时器 | 间隔进 effect 依赖，cleanup 先清旧定时器、中止在途请求 | 改一次间隔就多一个循环并跑，上游请求翻倍且界面看不出来 |
+| 共享 | 卡片与输入框读数读**同一个** reader | 两个界面漂回两个节奏，正是本版要修的缺陷 |
+
+选项列表本身是**共享常量** `TRAE_REFRESH_INTERVAL_MINUTES`，schema 与选择器都从它渲染：
+两处各写一份字面量，就会出现「选择器给得出、写入拒绝」的选项。
+
+**输入框读数补了一次设置订阅。** 它挂在 gate 之下，而 gate 订阅的是自己的两个开关——
+子组件不会因为父组件订阅了而重渲染。没有这次订阅，改了间隔要等到下一次无关渲染才生效。
+
+### Tests
+
+- 新增 `tests/refresh-interval.spec.tsx`（16 例）：读取器的默认/全集/回落/`{get()}` 实时引用；
+  schema 接受五个值、拒绝 `7` 与 `0`；选择器在「能力」分栏、显示存储值、只写一个字段、
+  只读时拒写；**卡片按存储间隔读**（10 分钟时 1 分钟处零请求、10 分钟处恰好一次）；
+  **改间隔会替换定时器**（旧 60 分钟 → 新 1 分钟，一分钟处恰好一次读）；**输入框读数用同一
+  字段**（1 分钟处就有读，不等旧的 5 分钟常量）。
+- **变异验证 4 次全部被抓**：卡片定时器改回固定 60s → 1 例失败；输入框读数改回自己的常量
+  → 1 例失败；读取器接受任意数字 → 1 例失败；（另有一次改动由既有 `card-styles` 的
+  「每个渲染出来的类都要有规则」守卫抓出，补了 `.dsm-trae-refresh-interval` 的样式）。
+- 全仓 1446 → **1462**。
+
+### 顺带
+
+`styles.ts` 的注释里曾写了一个反引号包住的类名——那个模板字符串会当场截断，整份样式表变成
+语法碎片，而 typecheck 与 build 都不报错。`card-styles` 的「顶层语句只能是变量声明」守卫
+当场抓到，改回普通文字。这个坑本仓库文档里已经记过一次（workbuddy 的 busy veil）。
+
 ## 4.16.0 (2026-11-08)
 
 ### 模型标签槽：按宿主的声明注册，为 `keyed` 做好准备

package/README.en.md

@@ -61,11 +61,12 @@ In the account pool, open **More settings** and choose **Claude style** or **Def
   > `4011` is a **rate limit**, not "this model is unavailable" (measured for issue #33): an exhausted balance reports a different code, `4008`, so "I still have plenty of credits" and "I got a 4011" are both true at once. A throttled model answers again after a short wait — do not delete it.
 - **One-click test of all models** — the same probe applied to **every visible model** of the current region, not just the enabled ones. Use it when you want to know whether the models you have switched off could still answer — after a plan change, or after Trae reshuffles its lineup.
 - **Daily check-in claiming (per account)** — on the CN card **every account row carries its own check-in button**, with the day's reward written on it (`Check in +150`). A row reads **Claimed** and disables itself once *that account* has been paid, and reads **Device used** and disables itself when *this machine* has already spent today's slot through some other account — the two are reported honestly, and the second is never dressed up as "claimed". This is the plugin's **only** operation that changes account state, and it runs only when you click; one click targets that one row's account and sends exactly one request. There is deliberately **no "claim for every account"**: Trae allows **one check-in per device per day** (switching accounts does not reset the slot), so a sweep could only manufacture a row of false failures. The international side has no check-in activity, so no button is shown there.
-- **Composer readout** — the composer tool row (between "Expert" and the model selector) shows a clickable readout, refreshing every 5 minutes. **Both regions show it, but they do not show the same quantity, and that is the data's doing**: the CN side is credit-based, so it reads "Trae CN · <general credits>"; the international side is subscription-based and its usage document carries no credit field at all, so it reads "Trae Global · <plan>" (e.g. `Pro` / `Free`). The whole readout is clickable and opens a panel showing a TABLE: one row per account in the region — general credits on CN, plan on international — where clicking a row SWITCHES accounts (through the same merged `accounts` write the card uses, so the other region's selection survives). The panel's top right carries **two controls, Refresh and Settings** (as of 4.9.0 the Settings button targets the settings panel; an interim revision removed it on the belief that this was impossible, which was wrong — the host publishes no id-targeted *service*, but the settings shell pins its store seat to the registration so `slots.entries('sidebar.settings')[0].store.create().actions.openSection(id)` is a real route, and the host's own tests drive the dialog exactly that way). While Refresh runs its icon turns: the batch is serial, so the slowest account decides when it stops. **Refresh** asks every account checked into this panel's account pool to answer once (through the pool's `action=test` route — the same batch the pool section's own button runs) and reports the outcome in the panel's foot: `Pool tested · 2 of 2 answered`. **Two things about that press the label cannot say, so both live in the tooltip and in the foot line**: it tests the **pool's checked-in members**, not every account in the table you are looking at, and it is the **only press in this plugin that spends credits** (one minimal ping per member) — a bare "Refresh" reads as free, so the tooltip is worth reading. To change anything, open **Settings → Trae** — the plugin's only configuration surface. The balance needs no refresh button of its own — it re-reads when the panel opens, on every account switch, and every five minutes, which is why that button was replaced rather than joined by another. It appears **only while the session's selected model belongs to this plugin**, and renders nothing for any other provider — which is what keeps two connector plugins from competing for one shared row (the sidebar foot is a shared root row; the composer row is per-session and provider-scoped).
+- **Composer readout** — the composer tool row (between "Expert" and the model selector) shows a clickable readout, refreshing every 5 minutes by default (the interval is configurable — see the next bullet). **Both regions show it, but they do not show the same quantity, and that is the data's doing**: the CN side is credit-based, so it reads "Trae CN · <general credits>"; the international side is subscription-based and its usage document carries no credit field at all, so it reads "Trae Global · <plan>" (e.g. `Pro` / `Free`). The whole readout is clickable and opens a panel showing a TABLE: one row per account in the region — general credits on CN, plan on international — where clicking a row SWITCHES accounts (through the same merged `accounts` write the card uses, so the other region's selection survives). The panel's top right carries **two controls, Refresh and Settings** (as of 4.9.0 the Settings button targets the settings panel; an interim revision removed it on the belief that this was impossible, which was wrong — the host publishes no id-targeted *service*, but the settings shell pins its store seat to the registration so `slots.entries('sidebar.settings')[0].store.create().actions.openSection(id)` is a real route, and the host's own tests drive the dialog exactly that way). While Refresh runs its icon turns: the batch is serial, so the slowest account decides when it stops. **Refresh** asks every account checked into this panel's account pool to answer once (through the pool's `action=test` route — the same batch the pool section's own button runs) and reports the outcome in the panel's foot: `Pool tested · 2 of 2 answered`. **Two things about that press the label cannot say, so both live in the tooltip and in the foot line**: it tests the **pool's checked-in members**, not every account in the table you are looking at, and it is the **only press in this plugin that spends credits** (one minimal ping per member) — a bare "Refresh" reads as free, so the tooltip is worth reading. To change anything, open **Settings → Trae** — the plugin's only configuration surface. The balance needs no refresh button of its own — it re-reads when the panel opens, on every account switch, and on every refresh interval, which is why that button was replaced rather than joined by another. It appears **only while the session's selected model belongs to this plugin**, and renders nothing for any other provider — which is what keeps two connector plugins from competing for one shared row (the sidebar foot is a shared root row; the composer row is per-session and provider-scoped).
 
   <img src="docs/assets/dsh-connect-trae-composer-credits.png" width="560" alt="Trae credits panel: a table of accounts with their general balance, and the composer readout below" />
 
   **Where that readout sits is a choice** (learned from the sibling `dsh-connect-workbuddy` issue #62). The default is the **composer toolbar** (the position described above); if another plugin occupies it and the readout does not appear, move it **below the input box** — the row carrying the round / step / token statistics, where the readout is APPENDED after the shipped figures rather than replacing them. The seat is set **per panel** (all three are stored separately), in the card's settings block next to the "show credits in the composer row" checkbox. Why a second seat exists at all: the composer toolbar is a **shared list slot** that the shell's own controls and every other plugin register into, and a shared slot **cannot promise that every occupant is visible** — the report behind that issue is a readout that vanished entirely once a third-party plugin was installed (this plugin has been squeezed out of a shared row once before too, down to a clipped "Tr" at the sidebar foot).
+- **The automatic-refresh interval is configurable** — "refresh every" under **Settings → Trae → Capabilities** decides how often the card and the composer readout re-read usage by themselves: **1 / 5 / 10 / 30 / 60 minutes**, **5 by default**. **One value for the whole plugin**, not one per panel: both surfaces hit the same two read-only routes, so a per-panel copy would make one screen refresh at two cadences. A change takes effect **immediately** — the old timer is cleared and its in-flight read aborted before a new one starts at the new period, so a change cannot leave two loops running. **A shorter interval means more requests**: each refresh is two read-only upstream requests and nothing here spends credits. Before this setting the card was hardcoded to 60 seconds while the composer readout was hardcoded to five minutes — two cadences for the same data, decided by which surface you happened to be looking at. Both now read this one field.
 
 - **Optional: put Trae in the sidebar** (learned from the sibling `dsh-connect-workbuddy` PR #188, and **off by default** here too). Ticking "Show Trae in the sidebar" in the card's settings block adds a Trae row to the DSH sidebar; it opens the **full-page version of this same card** — same region tabs, same account / models / diagnostics sections, minus the card frame, with a title, a description and "Back to conversation" at the top. **Why it is off by default**: the sidebar's global rows are the host's own pages, and this row claims a seat **every installed bundle shares** while the settings page already reaches the same content — a nav row nobody asked for re-arranges a surface this plugin does not own. **It takes effect on the click** with no Save: writing `sidebarPanel` registers or disposes the row in the same second (it is not a component rendering null — that would leave a blank but still clickable button), and switching it off while the page is open sends the centre column back to the conversation by itself. The page's back control goes through the host's `layout.selectPanel(null)`; on a host without that service the control is **omitted rather than drawn dead**.
   <img src="docs/assets/dsh-connect-trae-sidebar-page.png" width="720" alt="The sidebar page: back control, title and description at the top, then the same card body below" />

package/README.md

@@ -66,11 +66,12 @@
   > `4011` 是**限流**不是「模型不可用」（issue #33 实测）：它额度耗尽走的是另一个码 `4008`，所以「额度还有很多却报 4011」两句话可以同时成立。被限流的模型**等你一会儿再试**即可，不要删。
 - **一键测试所有模型** —— 同一套探测，作用于当前 region 的**全部可见模型**（不限于已启用的）。想知道「没启用的那些到底还能不能用」时用它——比如套餐降级后，或 Trae 调整了模型阵容之后。
 - **每日签到领取（逐账号）** —— 国内版**每个账号行各有一个签到按钮**，当日奖励直接写在按钮上（`签到 +150`）；该账号当天已领显示「已领取」并禁用，**本机今日名额已被别的账号用掉**时显示「本机已签」并禁用——如实区分「这个账号领了」和「这台设备领过了」，绝不把后者说成「已领取」。这是插件里**唯一会改变账号状态**的操作，由你主动点击触发；一次点击只针对该行账号、只发一次请求。Trae 的签到按「**每台设备每天一次**」计（换账号不会重置当天名额），所以逐账号签到始终是主路径。账号池里另有一个「全部签到」，它**不是**把同一件事盲目重复：一旦上游回 `9095`（本机今日已领），整批立刻停止并把剩余账号如实标成「本机已签」，产出的是真相而不是一排假失败。国际版没有签到活动，因此不显示该按钮。
-- **输入框读数** —— 在输入框工具栏（「专家」与模型选择器之间）显示一块可点击读数，5 分钟自动刷新。**两个区域都显示，但显示的东西不同，这是数据决定的**：国内版是积分制，显示「Trae CN · <通用积分>」；国际版是订阅制，它的用量文档里根本没有积分字段，所以显示「Trae 国际版 · <套餐>」（如 `Pro` / `Free`）。**整块可点击**，弹出浮层显示一张**表格**：本区域**每个账号一行**，国内版列**通用积分**、国际版列**套餐**，**点行即可切换账号**（写入与卡片相同的 `accounts` 字段、合并时不丢掉另一个区域的选择）。浮层右上角是**「刷新」与「设置」两个控件**（4.9.0 起「设置」改指设置面板；中途曾以为做不到而删掉，是错的——宿主确实没有 id 定向的服务，但设置面板把自己的 store 座位钉在注册声明上，`slots.entries('sidebar.settings')[0].store.create().actions.openSection(id)` 是真实可用的路径，宿主自己的测试就是这么驱动的）。按「刷新」时图标会转，直到这批探测结束——它是串行跑的，最慢的账号决定什么时候结束。**「刷新」**把账号池里勾选的成员逐个问一遍「能不能应答」（走账号池那条 `action=test` 路由，与账号池分栏里的测试是同一个动作），结果直接报在浮层底部：`账号池已测 · 2 of 2 可应答`。**这个按钮有两件事标签说不出来，都写在悬停提示与结果行里**：它测的是**账号池里勾选的成员**，不是你眼前这张表里的每个账号；而且它是**插件里唯一消耗额度**的按钮（每个成员一条最小 `ping`）——一个光秃秃的「刷新」读起来是免费的，所以工具提示必须留着看。要改配置就去「设置 → Trae」：那是本插件唯一一处配置界面。积分本身不需要刷新按钮：**打开浮层、切换账号、每 5 分钟**都会重新读一次，所以那个按钮被换掉而不是并排加进来。**只在当前会话选中的模型属于本插件时出现**——选其它供应商的模型时整块不渲染。这样两个连接器插件不会争同一个位置（侧边栏底部是共享的根级行，输入框工具栏是按会话、按供应商的）。
+- **输入框读数** —— 在输入框工具栏（「专家」与模型选择器之间）显示一块可点击读数，默认每 5 分钟自动刷新（间隔可调，见下一条）。**两个区域都显示，但显示的东西不同，这是数据决定的**：国内版是积分制，显示「Trae CN · <通用积分>」；国际版是订阅制，它的用量文档里根本没有积分字段，所以显示「Trae 国际版 · <套餐>」（如 `Pro` / `Free`）。**整块可点击**，弹出浮层显示一张**表格**：本区域**每个账号一行**，国内版列**通用积分**、国际版列**套餐**，**点行即可切换账号**（写入与卡片相同的 `accounts` 字段、合并时不丢掉另一个区域的选择）。浮层右上角是**「刷新」与「设置」两个控件**（4.9.0 起「设置」改指设置面板；中途曾以为做不到而删掉，是错的——宿主确实没有 id 定向的服务，但设置面板把自己的 store 座位钉在注册声明上，`slots.entries('sidebar.settings')[0].store.create().actions.openSection(id)` 是真实可用的路径，宿主自己的测试就是这么驱动的）。按「刷新」时图标会转，直到这批探测结束——它是串行跑的，最慢的账号决定什么时候结束。**「刷新」**把账号池里勾选的成员逐个问一遍「能不能应答」（走账号池那条 `action=test` 路由，与账号池分栏里的测试是同一个动作），结果直接报在浮层底部：`账号池已测 · 2 of 2 可应答`。**这个按钮有两件事标签说不出来，都写在悬停提示与结果行里**：它测的是**账号池里勾选的成员**，不是你眼前这张表里的每个账号；而且它是**插件里唯一消耗额度**的按钮（每个成员一条最小 `ping`）——一个光秃秃的「刷新」读起来是免费的，所以工具提示必须留着看。要改配置就去「设置 → Trae」：那是本插件唯一一处配置界面。积分本身不需要刷新按钮：**打开浮层、切换账号、每个刷新间隔**都会重新读一次，所以那个按钮被换掉而不是并排加进来。**只在当前会话选中的模型属于本插件时出现**——选其它供应商的模型时整块不渲染。这样两个连接器插件不会争同一个位置（侧边栏底部是共享的根级行，输入框工具栏是按会话、按供应商的）。
 
   <img src="docs/assets/dsh-connect-trae-composer-credits.png" width="560" alt="Trae credits panel: a table of accounts with their general balance, and the composer readout below" />
 
   **读数显示在哪里可以选**（学自同族 `dsh-connect-workbuddy` issue #62）。默认在**输入框工具栏**（即上面说的位置）；如果那里被别的插件占了、读数不显示，改成**输入框下方**——那是「轮次 / 步数 / token」统计所在的那一行，读数是**追加**在官方统计之后，不会顶掉它们。位置**按面板分别设置**（三个面板各存各的），在卡片「设置」区紧挨「在输入框工具栏显示积分读数」那个勾选框。之所以要有第二个位置：输入框工具栏是**共享的 list 插槽**，外壳自己的控件和其他插件都注册在那里，而共享插槽**无法保证每个占用者都可见**——同族的报告者装了第三方插件后读数就整个消失了（本插件早年放在侧边栏底部时也被挤成过一个「Tr」的残片）。
+- **自动刷新间隔可调** —— 「设置 → Trae → 能力」里的「自动刷新」决定卡片与输入框读数各自多久自己重新读一次用量，可选 **1 / 5 / 10 / 30 / 60 分钟**，默认 **5 分钟**。**整个插件共用一个值**（不是每个面板一个）：两处打的是同两条只读路由，分开设置只会让同一块屏幕出现两个节奏。改动**即时生效**——旧定时器先被清掉、在途请求被中止，再按新间隔重建，所以不会留下两个循环并跑。**间隔越短请求越频繁**：每次刷新是两次只读上游请求，这里不消耗积分。这个设置之前，卡片硬编码 60 秒、输入框读数硬编码 5 分钟——同一份数据两个节奏，取决于你正好在看哪个界面；现在统一到这一个字段。
 
 - **可选：把 Trae 放进侧边栏**（学自同族 `dsh-connect-workbuddy` 的 PR #188，同样**默认关闭**）。在卡片「设置」区勾上「在侧边栏显示 Trae」，DSH 侧边栏就多一个 Trae 行，点开是**这张卡片的整页版**：同样的地区页签、同样的账号 / 模型 / 诊断分栏，只是没有卡片边框，顶部是标题、说明和「返回会话」。**默认关闭的理由**：侧边栏的全局行是宿主自己的页面，这一行占的是**所有已安装插件共用**的座位，而「设置 → Trae」本来就能看到同样的内容——一行没人要求的导航会改变一个插件并不拥有的界面。**点一下即生效**，不用保存：开关写入 `sidebarPanel` 后，注册与注销在同一秒发生（不是把组件渲染成 null——那会留下一个空白却仍可点的按钮）；页面开着时关掉它，中心栏会自己回到会话。整页的「返回会话」走宿主的 `layout.selectPanel(null)`，宿主没这个服务时**不画**这个按钮，而不是画一个点不动的。
   <img src="docs/assets/dsh-connect-trae-sidebar-page.png" width="720" alt="Trae 侧边栏整页版：顶部是返回会话、标题与说明，下面是同一张卡片的地区页签和账号栏" />

package/lib/client.js

@@ -574,6 +574,45 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			});
 		}
 		/**
+		* The automatic-refresh cadences this plugin offers, in MINUTES.
+		*
+		* The list is the setting's whole value domain: the schema validates against
+		* exactly these, so a hand-edited `7` is refused at write time instead of
+		* silently producing a cadence nobody chose. `1` is the floor because every
+		* usage read costs two upstream requests and a tighter loop would turn a
+		* background refresh into traffic the user never asked for.
+		*/
+		const TRAE_REFRESH_INTERVAL_MINUTES = [
+			1,
+			5,
+			10,
+			30,
+			60
+		];
+		const REFRESH_INTERVAL_SET = new Set(TRAE_REFRESH_INTERVAL_MINUTES);
+		/**
+		* How often the plugin refreshes on its own, in minutes.
+		*
+		* Anything that is not one of {@link TRAE_REFRESH_INTERVAL_MINUTES} reads as
+		* the default — absent (a profile written before the setting existed), a
+		* hand-edited `7`, a string `'5'`, or a live reference that resolves to none of
+		* those. Falling back rather than refusing to refresh is deliberate: a readout
+		* that stops updating because of an unrecognized value is the failure this
+		* setting must never introduce, and the schema already refuses such a value on
+		* the write path.
+		*
+		* `value` is the whole settings section (this field is plugin-wide, not
+		* per-region — see `Config.refreshIntervalMinutes`).
+		*/
+		function refreshIntervalMinutesOf(value) {
+			const stored = unwrapVolatileDeep(value)?.refreshIntervalMinutes;
+			return typeof stored === "number" && REFRESH_INTERVAL_SET.has(stored) ? stored : 5;
+		}
+		/** The same cadence as a millisecond period, for `setInterval`. */
+		function refreshIntervalMsOf(value) {
+			return refreshIntervalMinutesOf(value) * 6e4;
+		}
+		/**
 		* One panel's saved pool PREFERENCES, as the card's settings block edits them.
 		*
 		* Read from the settings document rather than from the usage answer for the same
@@ -1403,6 +1442,19 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
    question and sits beside the words that ask it. */
 .dsm-trae-credit-position{flex:none;max-width:none;margin-top:0;padding:3px 8px;font-size:12px;line-height:16px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:7px;background:var(--dsw-alias-bg-layer-3,#2a2c33);color:var(--dsw-alias-label-primary,#e6e6e6);cursor:pointer}
 .dsm-trae-credit-position:disabled{cursor:default}
+/* The automatic-refresh picker, a sibling of the seat picker above and styled
+   to match it — the two answer the same kind of question ("how this readout
+   behaves") and sit on consecutive lines, so a second visual idiom would read
+   as an unrelated control.
+
+   Its OWN class, deliberately NOT the seat picker's: a test that selects the
+   seat picker by class must not start finding the cadence picker the moment
+   this row is added, which is exactly the failure the seat picker's own comment
+   records. The row borrows the checkbox column's padding for the same reason
+   its sibling does. */
+.dsm-trae-refresh-interval-pref{align-items:flex-start;padding-left:25px}
+.dsm-trae-refresh-interval{flex:none;max-width:none;margin-top:0;padding:3px 8px;font-size:12px;line-height:16px;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:7px;background:var(--dsw-alias-bg-layer-3,#2a2c33);color:var(--dsw-alias-label-primary,#e6e6e6);cursor:pointer}
+.dsm-trae-refresh-interval:disabled{cursor:default}
 /* The card's checkboxes are the platform's own, styled only with
    accent-color 鈥?the SAME idiom .dsm-trae-mainui-switch-label above already
    uses for the composer-line switch, and the one the sibling
@@ -4409,7 +4461,7 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 		* is precisely why this section has no 「保存」 of its own — the model catalog,
 		* which does, lives in its own section.
 		*/
-		function TraeAccountPanel({ t, settingsScope, panel, status, statusLabel, credentialRegionIsAi, regionOn, showPointsInMainUi, onToggleShowPoints, creditPosition, onCreditPositionChange, sidebarPanelOn, sidebarPanelBusy, onToggleSidebarPanel, savingPreferences, creditsLabelId, creditsHintId, rows, busy, rescanNote, onRescan, switchingAccount, onSwitchAccount, onClaim, onTransferChanged, poolDetails, poolClaims, models = [], deviceClaimed = false, onPoolChanged = () => {}, onPoolRefresh = () => {}, creditsUnavailable, creditsExpiry, alternatives, onSwitchToAlternative, section = "all" }) {
+		function TraeAccountPanel({ t, settingsScope, panel, status, statusLabel, credentialRegionIsAi, regionOn, showPointsInMainUi, onToggleShowPoints, creditPosition, onCreditPositionChange, refreshIntervalMinutes, onRefreshIntervalChange, sidebarPanelOn, sidebarPanelBusy, onToggleSidebarPanel, savingPreferences, creditsLabelId, creditsHintId, rows, busy, rescanNote, onRescan, switchingAccount, onSwitchAccount, onClaim, onTransferChanged, poolDetails, poolClaims, models = [], deviceClaimed = false, onPoolChanged = () => {}, onPoolRefresh = () => {}, creditsUnavailable, creditsExpiry, alternatives, onSwitchToAlternative, section = "all" }) {
 			const writable = settingsScope?.getSnapshot().writable === true;
 			const signedIn = status.status === "signed-in";
 			const accounts = signedIn ? status.accounts : [];
@@ -4474,6 +4526,37 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 							})]
 						})
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+						className: "dsm-trae-pref dsm-trae-refresh-interval-pref",
+						title: t("row.refreshIntervalHint"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: "dsm-trae-pref-copy",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dsm-trae-pref-lead",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsm-trae-pref-label",
+									children: t("row.refreshIntervalLabel")
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+									className: "dsm-trae-refresh-interval",
+									value: String(refreshIntervalMinutes),
+									disabled: !writable || savingPreferences,
+									"aria-label": t("row.refreshIntervalAria"),
+									onChange: (event) => {
+										const picked = Number(event.currentTarget.value);
+										const match = TRAE_REFRESH_INTERVAL_MINUTES.find((each) => each === picked);
+										if (match !== void 0) onRefreshIntervalChange(match);
+									},
+									children: TRAE_REFRESH_INTERVAL_MINUTES.map((minutes) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+										value: String(minutes),
+										children: t("row.refreshIntervalOption", { minutes: String(minutes) })
+									}, minutes))
+								})]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dsm-trae-pref-hint",
+								children: t("row.refreshIntervalHint")
+							})]
+						})
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
 						className: "dsm-trae-pref",
 						title: t("row.sidebarPanelHint"),
@@ -4881,7 +4964,16 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			}
 			return `HTTP ${status}`;
 		}
-		const POLL_INTERVAL_MS = 6e4;
+		/**
+		* The card's own poll period is NOT a constant: the cadence is the user's
+		* (`Config.refreshIntervalMinutes`, default 5 minutes), read through
+		* {@link refreshIntervalMsOf} so the card and the composer readout cannot drift
+		* apart. It used to be a fixed 60_000 here while the composer readout polled
+		* every five minutes — two cadences for the same two upstream routes, decided
+		* by which surface you happened to be looking at. The floor of the offered
+		* values is one minute; every read is two read-only upstream calls, which is
+		* why the setting does not go below that.
+		*/
 		const TRAE_GITHUB_URL = "https://github.com/dingminhua/dsh-connect-trae";
 		/**
 		* Write one settings field and confirm the value actually landed.
@@ -5248,7 +5340,20 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			* local state: a write made elsewhere (the DSH settings form, another window)
 			* then shows up here instead of being shadowed by a stale copy.
 			*/
-			const committedSettings = { showPointsInMainUi: unwrapVolatileDeep(settingsScope?.getSnapshot().value)?.showPointsInMainUi === true };
+			const committedSettings = {
+				showPointsInMainUi: unwrapVolatileDeep(settingsScope?.getSnapshot().value)?.showPointsInMainUi === true,
+				/**
+				* The automatic-refresh cadence (`Config.refreshIntervalMinutes`).
+				*
+				* Read through the SHARED reader rather than off the document here: the
+				* composer readout reads the same field through the same function, and the
+				* two surfaces disagreeing about the cadence is exactly what a second
+				* interpretation would produce. It also owns the fallback for a document
+				* that never went through the schema (a hand-edited file), so the card
+				* cannot end up on a cadence the write path would have refused.
+				*/
+				refreshIntervalMinutes: refreshIntervalMinutesOf(settingsScope?.getSnapshot().value)
+			};
 			/**
 			* Ids for the block's label/hint wiring. `useId`, not constants: DSH can mount
 			* this card twice at once (the settings ROW and the expanded PAGE), and two
@@ -5260,11 +5365,25 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			* over it. Reading BOTH sources here is what lets the write above stay simple —
 			* it never has to write into component state that a Host refresh would fight.
 			*/
-			const settingsEdits = { showPointsInMainUi: optimisticSettings.current.showPointsInMainUi ?? committedSettings.showPointsInMainUi };
+			const settingsEdits = {
+				showPointsInMainUi: optimisticSettings.current.showPointsInMainUi ?? committedSettings.showPointsInMainUi,
+				refreshIntervalMinutes: optimisticSettings.current.refreshIntervalMinutes ?? committedSettings.refreshIntervalMinutes
+			};
 			const settingsIds = (0, react.useId)();
 			const creditsLabelId = `${settingsIds}-credits`;
 			const creditsHintId = `${settingsIds}-credits-hint`;
 			/**
+			* The poll period, in milliseconds, as the CARD uses it.
+			*
+			* Derived from the committed-plus-optimistic value above rather than from the
+			* document directly, so a pick shows its effect immediately: the timer is
+			* rebuilt from this on the next render (see the poll effect's dependency
+			* list). Reading it here also keeps the number and the picker in one place —
+			* a picker on one cadence and a timer on another is precisely the class of
+			* bug this setting replaced.
+			*/
+			const refreshIntervalMs = settingsEdits.refreshIntervalMinutes * 6e4;
+			/**
 			* Write ONE preference switch, on the click that flipped it.
 			*
 			* This replaced a draft + 「保存」/「放弃」 pair, which is what the sibling
@@ -5302,6 +5421,47 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 				}
 			};
 			/**
+			* Change how often the plugin refreshes on its own
+			* (`Config.refreshIntervalMinutes`).
+			*
+			* Same shape as {@link writePreference}, and for the same reason: this is a
+			* standing preference, so it commits on the pick and is read-back verified —
+			* a picker that merely LOOKS changed while the timer keeps its old period is
+			* the failure mode worth guarding against here. The read-back compares
+			* through `refreshIntervalMinutesOf`, so the value has to land as one of the
+			* offered cadences rather than merely being present.
+			*
+			* The write alone changes nothing on screen until the settings snapshot
+			* notifies, which the poll effect below is keyed on: the interval is rebuilt
+			* from the new value on the next render, so the old timer is cleared and a
+			* fresh one started. That is deliberate — a cadence change must take effect
+			* without a reload, and it must not leave the previous interval running.
+			*/
+			const writeRefreshInterval = async (value) => {
+				if (settingsScope === void 0 || settingsScope.getSnapshot().writable !== true) return;
+				setSavingSettings(true);
+				setWriteError(void 0);
+				optimisticSettings.current = {
+					...optimisticSettings.current,
+					refreshIntervalMinutes: value
+				};
+				setSettingsRevision((revision) => revision + 1);
+				try {
+					await writeSettingsField(settingsScope, "refreshIntervalMinutes", value, (readBack) => refreshIntervalMinutesOf(readBack) === value);
+				} catch (error) {
+					if (mounted.current) setWriteError(error instanceof Error ? error.message : t("row.requestFailed"));
+				} finally {
+					if (mounted.current) {
+						optimisticSettings.current = {
+							...optimisticSettings.current,
+							refreshIntervalMinutes: void 0
+						};
+						setSettingsRevision((revision) => revision + 1);
+					}
+					if (mounted.current) setSavingSettings(false);
+				}
+			};
+			/**
 			* Flip the OPTIONAL sidebar row on or off (`Config.sidebarPanel`).
 			*
 			* Two things happen on a verified write, and BOTH are required:
@@ -5563,7 +5723,7 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 				const controller = new AbortController();
 				const timer = window.setInterval(() => {
 					refreshUsage(activeRegion, controller.signal);
-				}, POLL_INTERVAL_MS);
+				}, refreshIntervalMs);
 				return () => {
 					window.clearInterval(timer);
 					controller.abort();
@@ -5573,7 +5733,8 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 				activeRegion,
 				activeRegionOn,
 				refreshUsage,
-				status.status
+				status.status,
+				refreshIntervalMs
 			]);
 			const rescanAccounts = async () => {
 				setBusy(true);
@@ -6635,6 +6796,10 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 							onCreditPositionChange: (position) => {
 								changeCreditPosition(activeRegion, position);
 							},
+							refreshIntervalMinutes: settingsEdits.refreshIntervalMinutes,
+							onRefreshIntervalChange: (minutes) => {
+								writeRefreshInterval(minutes);
+							},
 							sidebarPanelOn,
 							sidebarPanelBusy,
 							onToggleSidebarPanel: (value) => {
@@ -6715,6 +6880,10 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 							onCreditPositionChange: (position) => {
 								changeCreditPosition(activeRegion, position);
 							},
+							refreshIntervalMinutes: settingsEdits.refreshIntervalMinutes,
+							onRefreshIntervalChange: (minutes) => {
+								writeRefreshInterval(minutes);
+							},
 							sidebarPanelOn,
 							sidebarPanelBusy,
 							onToggleSidebarPanel: (value) => {
@@ -7644,9 +7813,17 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			}
 		}
 		/**
-		* Automatic refresh period. Five minutes, matching the sidebar line: a credit
-		* balance moves on the scale of model calls, not seconds, and each read is two
-		* read-only upstream calls.
+		* Automatic refresh period when nothing says otherwise.
+		*
+		* Five minutes, matching the sidebar line: a credit balance moves on the scale
+		* of model calls, not seconds, and each read is two read-only upstream calls.
+		*
+		* The LIVE period is the user's `Config.refreshIntervalMinutes` (see
+		* {@link refreshIntervalMsOf}), whose default is this same five minutes — so
+		* this constant is now the fallback for a caller that renders the readout
+		* without a settings scope (a test, or a host that serves none), not the rule.
+		* Both polling surfaces read that ONE field, so the composer row and the card
+		* cannot end up refreshing the same routes at different rates.
 		*/
 		const COMPOSER_POINTS_REFRESH_INTERVAL_MS = 3e5;
 		/**
@@ -7745,6 +7922,16 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			if (t === void 0) throw new Error("Composer points readout requires its translation function");
 			const owned = provider === void 0 ? void 0 : TRAE_COMPOSER_PROVIDERS[provider];
 			const activeRegion = region ?? owned;
+			/**
+			* The poll period, from the user's own cadence setting.
+			*
+			* Read through the SHARED reader (the card's poll reads the same field the
+			* same way), with the constant above as the fallback when this readout is
+			* rendered with no settings scope at all. It re-reads on every render, so the
+			* scope's notification after a write is enough to rebuild the timer — the
+			* effect below lists it as a dependency for exactly that reason.
+			*/
+			const refreshIntervalMs = settingsScope === void 0 ? COMPOSER_POINTS_REFRESH_INTERVAL_MS : refreshIntervalMsOf(settingsScope.getSnapshot().value);
 			const [usage, setUsage] = (0, react.useState)(void 0);
 			const [accountCredits, setAccountCredits] = (0, react.useState)(void 0);
 			/**
@@ -7816,6 +8003,23 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 					mounted.current = false;
 				};
 			}, []);
+			/**
+			* Re-render when the settings document changes, so a cadence picked in the
+			* card reaches THIS readout without a reload.
+			*
+			* The scope is a stable injected reference, so the subscription is set up once
+			* per scope. `settingsRevision` is not read anywhere — bumping it is the whole
+			* point, since `refreshIntervalMs` above is recomputed on every render.
+			*
+			* The gate above (`ComposerPointsGate`) already subscribes for its own two
+			* switches, but a child does not re-render because its PARENT subscribed: this
+			* component is mounted through that gate, so without its own subscription a
+			* cadence change would only land on the next unrelated render.
+			*/
+			const [, setSettingsRevision] = (0, react.useState)(0);
+			(0, react.useEffect)(() => settingsScope?.subscribe(() => {
+				setSettingsRevision((revision) => revision + 1);
+			}), [settingsScope]);
 			const position = useAnchoredPosition({
 				open: open && activeRegion !== void 0,
 				anchorRef: rootRef,
@@ -7877,14 +8081,18 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 					if (cancelled) return;
 					timer = window.setInterval(() => {
 						fetchUsage(controller.signal);
-					}, COMPOSER_POINTS_REFRESH_INTERVAL_MS);
+					}, refreshIntervalMs);
 				});
 				return () => {
 					cancelled = true;
 					if (timer !== void 0) window.clearInterval(timer);
 					controller.abort();
 				};
-			}, [owned, fetchUsage]);
+			}, [
+				owned,
+				fetchUsage,
+				refreshIntervalMs
+			]);
 			/**
 			* Every account's PLAN, one status read per account — ai only.
 			*
@@ -8844,6 +9052,10 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			"row.creditPositionStats": "below the input box",
 			"row.creditPositionAria": "Credit readout position for {region}",
 			"row.creditPositionHint": "The default position is on the model picker row. If another connector occupies the same position, the readout loaded later moves left automatically. Choose below the input box to show it beside the round, step and token statistics.",
+			"row.refreshIntervalLabel": "refresh every",
+			"row.refreshIntervalOption": "{minutes} min",
+			"row.refreshIntervalAria": "Automatic refresh interval",
+			"row.refreshIntervalHint": "How often the card and the composer readout re-read usage by themselves, every 5 minutes by default. Each refresh is two read-only upstream requests, so a shorter interval means more traffic; nothing here spends credits. A change takes effect immediately, and turning a panel off stops its reads.",
 			"composer.switchTo": "Switch to {account}",
 			"composer.noAccounts": "No account in this region",
 			"composer.panelTitle": "Trae credits",
@@ -9263,6 +9475,10 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			"row.creditPositionStats": "输入框下方",
 			"row.creditPositionAria": "{region} 的积分显示位置",
 			"row.creditPositionHint": "默认与模型选择同一行显示；遇到其他连接器占用排序位置时，后加载的读数自动向左排列。也可选择「输入框下方」，与轮次、步数和 token 统计同一行显示。",
+			"row.refreshIntervalLabel": "自动刷新",
+			"row.refreshIntervalOption": "{minutes} 分钟",
+			"row.refreshIntervalAria": "自动刷新间隔",
+			"row.refreshIntervalHint": "卡片与输入框读数各自多久重新读取一次用量，默认 5 分钟。每次刷新是两次只读的上游请求，间隔越短请求越频繁；这里不消耗积分。改动即时生效；面板关闭后该面板不再自动读取。",
 			"composer.switchTo": "切换到 {account}",
 			"composer.noAccounts": "该区域暂无账号",
 			"composer.panelTitle": "Trae 积分",

package/lib/index.d.ts

@@ -1331,6 +1331,18 @@ declare function regionCreditPositionOf(value: unknown, panel: TraePanel): TraeC
  * 'regions', ...)` needs.
  */
 declare function nextRegionCreditPosition(value: unknown, panel: TraePanel, position: TraeCreditPosition): Record<string, unknown>;
+/**
+ * The automatic-refresh cadences this plugin offers, in MINUTES.
+ *
+ * The list is the setting's whole value domain: the schema validates against
+ * exactly these, so a hand-edited `7` is refused at write time instead of
+ * silently producing a cadence nobody chose. `1` is the floor because every
+ * usage read costs two upstream requests and a tighter loop would turn a
+ * background refresh into traffic the user never asked for.
+ */
+declare const TRAE_REFRESH_INTERVAL_MINUTES: readonly [1, 5, 10, 30, 60];
+/** One accepted cadence. */
+type TraeRefreshIntervalMinutes = typeof TRAE_REFRESH_INTERVAL_MINUTES[number];
 /** Subscription status of an international (ai) account, rendered instead of the CN credit packs. */
 interface TraeWebPayStatus {
   isDollarUsageBilling: boolean;
@@ -4821,6 +4833,23 @@ interface Config {
    * where the entry seeds the switch at page load).
    */
   sidebarPanel?: boolean;
+  /**
+   * How often the plugin refreshes its own readouts, in MINUTES.
+   *
+   * ONE plugin-wide number rather than one per region, because the thing it
+   * paces is the plugin's background chatter, not a region's data: both
+   * surfaces that poll (the card's usage document and the composer readout)
+   * read the same routes at the same cost, and a per-region copy would let the
+   * same screen refresh at two cadences.
+   *
+   * `undefined` means the default (5 minutes), which is what both surfaces
+   * already used before this was settable — so an upgrade moves nothing.
+   * The accepted values are exactly {@link TRAE_REFRESH_INTERVAL_MINUTES}
+   * (1 / 5 / 10 / 30 / 60); the schema below refuses anything else, and the
+   * readers fall back to the default for a document that never went through
+   * it (a hand-edited file, or a profile written before this field existed).
+   */
+  refreshIntervalMinutes?: TraeRefreshIntervalMinutes;
   /**
    * 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

@@ -2411,6 +2411,23 @@ function nextRegionCreditPosition(value, panel, position) {
 	});
 }
 /**
+* The automatic-refresh cadences this plugin offers, in MINUTES.
+*
+* The list is the setting's whole value domain: the schema validates against
+* exactly these, so a hand-edited `7` is refused at write time instead of
+* silently producing a cadence nobody chose. `1` is the floor because every
+* usage read costs two upstream requests and a tighter loop would turn a
+* background refresh into traffic the user never asked for.
+*/
+const TRAE_REFRESH_INTERVAL_MINUTES = [
+	1,
+	5,
+	10,
+	30,
+	60
+];
+new Set(TRAE_REFRESH_INTERVAL_MINUTES);
+/**
 * Panels whose text-to-image path this plugin has actually MEASURED, in
 * `TRAE_PANELS` tab order.
 *
@@ -11652,6 +11669,7 @@ const Config = z.object({
 	accountId: z.string().description("Deprecated: pre-split account selector, attributed to its own region"),
 	showPointsInMainUi: asVolatile(z.boolean().default(false).description("在输入框工具栏显示积分读数「Trae CN · <数值>」（仅当选中的模型属于本插件时出现，可点击查看账号与积分明细）")),
 	sidebarPanel: asVolatile(z.boolean().default(false).description("在 DSH 侧边栏显示「Trae」面板：点开是这张卡片的整页版。默认关闭——这一行占的是所有插件共用的全局侧边栏座位，而「插件」页本来就能看到同样的内容。点一下即生效，不用保存。")),
+	refreshIntervalMinutes: asVolatile(z.union(TRAE_REFRESH_INTERVAL_MINUTES).default(5).description("自动刷新间隔（分钟）：卡片与输入框读数共用。可选 1 / 5 / 10 / 30 / 60，默认 5。每次刷新会读取用量（两次只读的上游请求），间隔越短请求越频繁。")),
 	accounts: asVolatile(accountSelectionConfig.description("Per-panel account selections, keyed cn | enterprise | ai")),
 	regions: asVolatile(z.dict(regionStateConfig).default({}).description("Per-panel model directory and selection, keyed cn | enterprise | ai")),
 	lastCatalog: z.array(modelConfig).description("Deprecated: pre-region-split CN model directory"),

package/package.json

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