dsh-connect-trae 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## 4.3.0 (2026-10-22)
+
+> **设置卡片按「账号 / 模型 / 诊断」分栏，模型栏改回全部铺开。**
+>
+> 卡片原来是一列长页，把两类互不相干的事情混排在一起：运维账号（谁在服务、还剩多少、签到、
+> 账号池及其日志）与编辑目录（勾模型、图片输入、上下文预算）。两者连提交语义都不同——账号改动
+> 点一下即生效，目录改动是草稿、必须点「保存」——于是保存按钮常常离它要保存的东西隔着三屏。
+> 学自同族 `dsh-connect-workbuddy` 的分栏实现。版本号取 **minor**：新增界面与一个只读栏，
+> 接口、配置项与请求结构零变更。
+
+### 新增
+
+- **设置卡片按「账号 / 模型 / 诊断」分栏**（`feat(client)`）。
+  - 顶部地区那排仍是**作用域**（这张卡片讲的是哪个供应商）；其下新增分栏 tablist（账号 / 模型 /
+    诊断），三者共享同一个地区作用域。两排视觉上明确区分：地区是带开关的方框 chip，分栏是设置窗
+    口那种下划线 strip——两排方框会被读成一个六选一。
+  - 非活动栏用 `hidden` 留在页面里：切栏不重新拉取、不丢未保存的模型草稿、账号池日志不重建；
+    `hidden` 同时让非活动栏退出无障碍树，这正是 `role="tabpanel"` 要的语义。
+  - 新增只读「诊断」栏：面板名、供应商 id、服务账号（按名字，不打印 id）、访问令牌与重新登录两个
+    到期时间、目录模型数与已启用数、账号池与签到支持与否、Raw 会话通道状态，以及上游最近一次错误
+    **的原文**（原样引用，不翻译、不概括）。这一栏没有任何会改设置的控件，存在的唯一理由是被整段
+    贴进反馈。
+  - 签出态不画分栏：那一段说明不会被一个看不见的 tab 藏起来。
+  - 文案同时补 en/zh（`row.panel*` / `row.diag*`）；样式新增 `.dsm-trae-panels` /
+    `.dsm-trae-panel-tab` / `.dsm-trae-panel` / `.dsm-trae-diag*`。
+
+- **模型栏把所有模型全部铺开，没有内层滚动条**（`feat(client)`）。
+  - `.dsm-trae-model-list` 不设 `max-height`，`overflow-y` 也不是 `auto`：唯一滚动是卡片自己的
+    页滚。`overflow: hidden` 保留，只为圆角描边——纵向不裁任何内容。
+  - **实测**（`tools/panels-shot.tsx`，30 个模型的目录）：`scrollHeight == clientHeight == 1889`、
+    `clipped: false`、`max-height: none`、面板内自带滚动元素 `0` 个，保存栏落在页面末尾。
+
+### 重构
+
+- **账号栏抽成 `src/client/TraeAccountPanel.tsx`**（520 行），`TraeUsageCard.tsx` 从 2354 行
+  降到 1981 行。拆分是「笨」的那一半：所有判定仍留在卡片里（谁在服务、每行值多少、能不能签到、
+  读数放哪儿），账号栏只接收算好的行视图；这样账号表与账号池表读的是同一份判定，不会各说各话。
+- 卡片与账号栏共用的格式化/判定（`formatNumber` / `formatDateTime` / `dotStyle` /
+  `refreshTokenWarning`）下沉到 `src/client/display.ts`，避免两处各写一份而漂移。
+
+### 修复
+
+- **诊断栏的「每日签到」不再依赖账号池**。原先读 `pool.checkinSupported`，而账号池是**可选功能**，
+  没开池的国内账号会显示「本面板不提供」——恰好与事实相反。改为先读签到文档（`status.checkin`）。
+
+### 测试
+
+- `tests/card-panels.spec.tsx`（10 条，新增）：默认落在账号栏、点模型/诊断可切换、非活动栏仍挂载
+  （草稿不丢）、恰好一个 `aria-selected`、tab 与 tabpanel 互相指向、切栏不改地区作用域、诊断栏无
+  任何可交互控件、签出态无分栏；另加两条：30 个模型全部渲染且列表样式里没有 `max-height` /
+  `overflow-y:auto`，「每日签到」按签到文档而非账号池判定。
+- 顺带修好受影响的既有卡片测试（`card-test-models` / `card-context-bulk` / `card-promo` 的
+  `renderOpen` 先点开模型栏），因为模型控件现在确实在那一栏里。
+- 新增 `tools/panels-shot.tsx` + `pnpm panels:shot`：把三个分栏各自渲染成
+  `/tmp/panels-preview-<section>.html`（真实中文文案、30 模型目录），页面里的 `#audit` 给出
+  面板盒、分栏下划线与模型列表 `scrollHeight`/`clientHeight` 的实测值，用 `--dump-dom` 读回，
+  用来证明「没有内滚」而不是靠肉眼。
+- 全量 `vitest run` = 79 文件 / 961 测试全绿；两份 tsconfig 均 exit 0；`tsdown` 构建成功。
+
+### 文档
+
+- README / README.en 的卡片特性列表补上分栏一节（含「为什么分栏 = 提交语义不同」与「模型全部铺开」）。
+
 ## 4.2.0 (2026-10-21)
 
 > **模型行显示活动优惠徽标：只在上游此刻真在打折时出现。**

package/README.en.md

@@ -36,6 +36,7 @@ A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bund
 - **Enterprise is a separate billing channel, not an alias for CN** — the same CN credential, when it belongs to a `tob_online` tenant, is served by **two** gateways: the consumer pool (billed against personal credits) and the tenant pool (billed against the enterprise allowance). Same model, two payers, so **you** choose who pays; the plugin never guesses. `trae` never touches the enterprise gateway, and `trae-enterprise` **never falls back** — a refusal is reported as a refusal instead of quietly re-running on personal credits. Enterprise is **off by default**: a personal-only account cannot use the tenant pool, so shipping it enabled would mean handing everyone a provider that fails on first use.
 - **Any panel can be switched off on its own** — each tab carries its own checkbox (CN and international checked by default, enterprise not): unchecking **withdraws that provider from the DSH model picker entirely** (not merely hiding the tab) and stops all of its requests; checking it again restores it with the account, directory, picks, and context budgets intact. If you never use the international side, just uncheck it.
 - **Tabbed settings card** — the card's top carries a "Domestic / Enterprise / Global" tab bar; each tab holds its own account picker, usage overview, and model management. Account, directory, selection, and unsaved drafts are fully isolated per tab — switching accounts or refreshing models on one tab never touches the other side's runtime catalog or sessions. CN and enterprise share one CN credential pool but keep **separate account bindings and model picks**: the two rosters differ (`DeepSeek-V4.1-Flash` is listed only on the enterprise pool), so picks never overwrite each other.
+- **The card then splits into "Account / Models / Diagnostics"** (learned from the sibling `dsh-connect-workbuddy`). The region row above is the **scope** — which provider this whole card is about — while these are sections of that one card: Account covers who serves, what is left, the check-in and the pool; Models covers which models to tick, image input, the context budget and Save; Diagnostics read-only lists the panel, the provider id, the serving account, both token deadlines, the catalog/enabled model counts, whether the pool and the check-in are offered, and the **verbatim** text of this panel's last reported failure. The split exists because the two halves **commit differently**: an account change lands on the click, a catalog change is a draft until Save — so a single long column put the save button three screens away from what it saves. Switching sections never refetches, never drops a half-filled model draft, and never rebuilds the pool's log. A signed-out card renders no section strip, so its one screen of instructions cannot be hidden behind a tab the user cannot see. **The Models section lays every model out at once, with no inner scrollbar** — it is not a little window scrolling inside a page that already scrolls; the card's own page is the only scroll.
 - **Multiplier in the model name** — model names show the credit multiplier in Trae's own menu format (e.g. `GLM-5.2 · x0.79`), updated with each directory refresh.
 - **Promotion badge** — Trae publishes its discount rules in the model directory (`activity_discount`: pay ratio, list price, off-peak windows with their time zone). The plugin judges them against **the clock at render time** and paints one capsule beside the model name (`5 折` / `off-peak 5 折` / `limited 5 折`), with the old price, the new price and the window on hover. Judging at render time is what keeps a night-time discount from still hanging there the next morning; when upstream says nothing is discounted right now no badge is painted, the multiplier is never used to guess a promotion, and no campaign without an end time is labelled "limited". It is information only: no request and no billing changes, and the international region (subscription) has no such data and therefore shows no badge. See [docs/PROMO_BADGE.md](docs/PROMO_BADGE.md).
 - **DSH local tool loop** — gets pending structured `tool_calls` from Trae `llm_utils_chat`, lets DSH execute its own local tools, then returns tool results to the model.

package/README.md

@@ -36,6 +36,7 @@
 - **企业版是独立计费通道，不是国内版的别名** —— 同一张 CN 凭据若属于 `tob_online` 租户，会被**两个**网关同时服务：消费池（扣个人积分）与租户池（扣企业额度）。同一模型、两种付费方，所以「谁付钱」由你显式选，插件不替你猜。`trae` 永不碰企业网关；`trae-enterprise` **不回落**，被拒绝就如实报错，不会悄悄改用个人额度重跑。企业版**默认关闭**——纯个人账号用不了企业池，默认放开等于塞一条一用就失败的 provider。
 - **可单独关闭任一面板** —— 三个 tab 各带一个勾选（国内版与国际版默认勾选，企业版默认不勾）：取消勾选即把该面板的供应商**整个从 DSH 模型选择器撤掉**（不是只藏起 tab），并且不再发起任何请求；重新勾选即恢复，账号、目录、勾选与上下文预算全部保留。用不到国际版就把国际版关掉即可。
 - **插件卡片 tab 切换** —— 设置卡片顶部为「国内版 / 企业版 / 国际版」三个 tab，各含独立的账号选择、用量概览与模型管理；每个 tab 的账号、目录、勾选与未保存草稿完全隔离——在一个 tab 里切账号或刷新模型，不会触碰另一边的运行时目录与会话。国内版与企业版共用同一份 CN 凭据池，但**各有各的账号绑定与模型勾选**：两个池的名录并不相同（`DeepSeek-V4.1-Flash` 只有企业池列），所以勾选互不覆盖。
+- **卡片内再按「账号 / 模型 / 诊断」分栏**（学自同族 `dsh-connect-workbuddy`）—— 上面那排地区是**作用域**（这张卡片讲的是哪个供应商），这一排是同一张卡片里的**分栏**：账号栏管「谁在服务、还剩多少、签到与账号池」，模型栏管「勾哪些模型、图片输入、上下文预算、保存」，诊断栏只读地列出面板名、供应商 id、服务账号、两种令牌到期时间、目录/已启用模型数、账号池与签到支持与否，以及本面板最近一次报错的**原文**。分栏的理由是**提交语义不同**：账号改动点一下即生效，模型改动是草稿、必须点「保存」——一列长页会把保存按钮放到离它要保存的东西三屏之外。切栏不重新拉取、不丢未保存的模型草稿、账号池日志也不重建；未登录时不出分栏，那一屏说明不会被看不见的 tab 藏起来。**模型栏把所有模型一次性铺开，没有内层滚动条**——不再是一个套在滚动页面里的小窗口，唯一滚动的就是卡片自己那一页。
 - **账号池：自动选号 + 失败换号（默认关闭）** —— 本机读完几个账号后，「该用谁的额度」可以交给插件按规则排序：**先排除不可用的**（凭据被拒、套餐不覆盖、账号已不存在、限流未到重试时间、额度耗尽），再在可用账号里**优先快到期的那点额度**（与其放着过期，不如先花掉），最后才比总额、token 新鲜度，并以账号 id 兜底成**全序**（同样的输入永远得到同样的顺序，不会在两行之间来回抖）。三个面板**各有各的池**：国内版与企业版共用同一份 CN 凭据，但企业版只挑租户账号、国内版不会漂到租户号上。开着池时，发请求前先按上面的顺序选中一个账号，并且**真实请求失败会换下一个账号重试（最多 3 个）**——只有账号级失败才换（`401` 凭据被拒、额度耗尽、限流、上游 5xx）；模型 id 写错、请求本身不合法**不换号**，因为那不是账号的问题，换号只会把同一个错误烧两遍、还冤枉一个没机会服务的账号。换号失败的真相会写进池的探针记录，下一次排序直接把它排到后面，而每一次结论都能在卡片上看到：`可用` / `限流` / `额度耗尽` / `凭据被拒` / `套餐不覆盖` / `上游不提供` / `本次未测出`，以及「什么时候可以重试」。**关掉池就回到严格绑定**，不会有任何残留 override。卡片里的「全部测速」会把每个成员按目标模型各测一次，结果**边跑边显示**（一行一个答案，不等整批跑完），并落盘成下次排序的依据。
 
   > 池是**显式选择**：默认关闭。它不会替你在没打开池的情况下换账号——「换账号等于换人计费」，所以这件事只能由你点头。池打开后卡片会明确写出**当前是谁在付费**（Host 报告的是「下一个真正发送请求的账号」，不是保存的那个绑定）。