dsh-router-core 0.4.4 → 0.4.5

package/docs/pool-sticky-block.md

@@ -206,7 +206,8 @@ pick():
   前置,二者可叠加(亲和负责选号、块负责驻留)。
 - **积分感知换挡**:`credits` 已持久化,可做「积分跌破阈值才换挡」。
   但 `credits` 只存最后一次值不带时间戳,需先确认 `status()` 刷新频率,
-  否则触发失真。当前未启用。
+  否则触发失真。**「积分归零」这一档已于 2026-10-14 落地**(见 §12),
+  「跌破阈值(还有余额但快用完)」这一档仍未启用。
 - **TTL 仍未知**:87.5% 是保证下限,实际可能更高。要精确 N 需反推 TTL
   (同号相邻请求间隔 vs 命中率拟合驱逐拐点)。
 
@@ -413,3 +414,60 @@ Lead 与 T1 撞同一个号,T2 独占)。改为**占用感知分配**(`allocSess
 - **每会话一份样本 → 内存随会话数增长**:`samples` 按会话分叉,长跑多会话
   场景条目变多。当前无上限(随进程存亡),量大时再加 LRU(对齐 `AFFINITY_MAX`
   的做法)。
+
+## 12. 积分用完的号退出选号(2026-10-14 落地)
+
+### 12.1 症状
+
+`test` 组合里一个 traework 账号积分归零,请求报错但**没有换到还有额度的号**;
+手动测这个连接,报的是「连接 "4135677434275728" 不存在（可能已被删除）」——
+而它明明在面板的账号列表里。
+
+### 12.2 根因(两处,各修一半)
+
+1. **插件报 `ok`**:traework 的 `pool.list()` 只按凭证判状态——`accessToken === ''`
+   才是 `session_dead`,其余一律 `ok`。积分归零没被解读成 `quota`,核心**根本
+   不知道**这个号没额度。
+
+2. **核心不读插件报的状态**:`pick()`/`healthy()` 只查自己的冷却表,插件报的
+   `state` 从不参与选号。所以就算插件报 `quota`,核心照样会选它。
+
+后果:积分归零的号一直"看起来健康",被选中的那次请求必然失败;而 traework 的
+**积分耗尽失败是流式失败**(HTTP 200 + 流内 `event:error code=4008`),响应已经
+提交,这次请求**救不回来**——只能等失败后 `onLateFailure` 记账,下个请求才换号。
+即用户每次都要先白撞一次。
+
+### 12.3 修法
+
+- **插件侧**(`dsh-router-traework` 的 `pool.list()`):`credits === 0` 报 `quota`。
+  严格区分 `CREDITS_UNKNOWN(-1)`——那是「还没拉到」,不是「用完了」。
+- **核心侧**(`account-pool.servableByReport`):`quota` / `session_dead` 的号
+  不进候选。只认这两个**账号级、要靠外部动作恢复**的事实;`transport`/`unknown`/
+  `unavailable` 是某次采样的瞬时观察,拿它排除等于「一次抖动就踢号」,那些仍走
+  冷却单元。
+- **诊断侧**(`router/index.ts`):指定连接测试失败后重试时,不再把上游真因覆盖成
+  「连接不存在」。`tried` 里已有该 uid = 它刚试过并失败,保留 `trace.lastError`。
+
+**核心不自己比 `credits`**:openrouter / nvidia 没有积分概念,报的就是
+`credits: 0, state: 'ok'`,核心若拿 `credits === 0` 当「用完」会把它们整池排除。
+是否"用完"由**插件解读**成 `state` 后报上来(契约:插件报「现在怎么了」,核心决定
+「怎么办」)。
+
+### 12.4 回归测试
+
+- `account-pool.test.ts`:`quota`/`session_dead` 不进选号、全池没额度时的
+  `lastWhy` 不谎称「都在冷却」、充值后立刻回候选、`credits: 0 + state: 'ok'`
+  的号不受影响、瞬时状态不排除号、亲和绑定撞上 `quota` 时换号。
+- `supplier-switch.test.ts`:报 `quota` 的号请求直接落到有额度的号;指定连接
+  失败报上游真因、不说成「不存在」。
+- `loader.test.ts`:插件报的 `quota` 原样到达核心。
+- traework `pool.test.ts`:0 报 `quota`、`-1` 仍报 `ok`、`session_dead` 优先。
+- `account-badge.test.ts`:面板不把被排除的号显示成「健康」。
+
+### 12.5 天花板(ponytail)
+
+- **仍是「撞一次才换」的兜底**:`refreshingCredits` 有 10 分钟 TTL,积分在实际
+  用完到插件报 `quota` 之间有个窗口;而且本次请求已提交,补救只对后续请求生效。
+  要做到"用完前就换"需要**余额阈值换挡**(§8 仍标未启用)。
+- **不排除「余额快用完」**:只处理归零。阈值需要可信的刷新时间戳,`credits`
+  目前只存最后一次值。

package/docs/suppliers.md

@@ -74,7 +74,7 @@ js 报告**此刻**观察到的账户状况,而不是把上游原始响应丢给
 |---|---|
 | `ok` | 正常 |
 | `rate_limit` | 限流(429 类) |
-| `quota` | 额度/权益不足 |
+| `quota` | 额度/权益不足(**积分/额度用完也报它**,见下) |
 | `session_dead` | 凭证失效/凭证被上游拒(403 类,含风控误伤) |
 | `unavailable` | 上游不可用(404 / 服务下线) |
 | `transport` | 网络/连接层失败(没拿到 HTTP 状态) |
@@ -82,6 +82,25 @@ js 报告**此刻**观察到的账户状况,而不是把上游原始响应丢给
 | `no_such_model` | **这个模型不属于本供应商**(不是账号的失败) |
 | `bad_request` | **请求本身不合法,被上游拒**(参数错/图片认不出/tool_call 配对断裂;不是账号的失败) |
 
+**`status()` 里报 `quota` / `session_dead` 会影响选号**:这两个是「要靠外部动作
+才能恢复」的账号级事实(充值、重新登录),核心**不把它们选进候选**
+(`account-pool.servableByReport`)。所以有积分概念的 js 应在积分归零时直接报
+`quota`,不要报 `ok`:
+
+```ts
+// traework 的做法(src/api/pool.ts list()):0 是真值,就是「用完了」
+state: accessToken === '' ? 'session_dead' : credits === 0 ? 'quota' : 'ok'
+```
+
+**但 `credits === 0` 不等于「没额度」——不要用积分数字代替状态判断。** 有些
+供应商(openrouter / nvidia)压根没有积分概念,它们的 `0` 是「这个字段不适用」,
+报的是 `credits: 0, state: 'ok'`,核心**不会**因此排除它们(核心只看 `state`,
+不自己比 `credits`)。有积分概念的供应商才做上面那个映射。**`-1` 更不是 0**:
+那是「还没拉到」,此刻对这个号一无所知,必须保持 `ok`。
+
+其它状态不参与选号(只用于失败后的处置),报瞬时抖动为 `quota` 一样会让好号
+白躺 10 分钟。
+
 **`no_such_model` 是必须的,不能拿 `unavailable` 顶替。** 后者在核心策略里会
 把**这个号 × 这个模型**冷掉——组合里每有一个别人家的模型,js 就会对每个账号
 都报一次,于是一个都选不出来(表现为「组合越用越没号可用」)。所以「这个模型

package/lib/client-registry.js

@@ -17,6 +17,26 @@ window.__ModuleLoader__.load({
 		/** Same-origin API base the client panel fetches (host half serves it). */
 		var ROUTER_API_BASE = "/router/api";
 		//#endregion
+		//#region src/client/account-badge.ts
+		function statusBadge(account) {
+			if (account.cooling) return {
+				text: "冷却中",
+				cls: "dshr-badge-warn"
+			};
+			if (account.state === "quota") return {
+				text: "额度用完",
+				cls: "dshr-badge-warn"
+			};
+			if (account.state === "session_dead") return {
+				text: "凭证失效",
+				cls: "dshr-badge-warn"
+			};
+			return {
+				text: "健康",
+				cls: "dshr-badge-ok"
+			};
+		}
+		//#endregion
 		//#region src/client/Modal.tsx
 		/**
 		* 通用弹窗：遮罩 + 居中对话框，ESC / 点遮罩关闭。9router 风格。
@@ -116,16 +136,6 @@ window.__ModuleLoader__.load({
 			if (minutes < 60) return `剩余 ${minutes} 分钟`;
 			return `剩余 ${Math.ceil(minutes / 60)} 小时`;
 		}
-		function statusBadge(account) {
-			if (account.cooling) return {
-				text: "冷却中",
-				cls: "dshr-badge-warn"
-			};
-			return {
-				text: "健康",
-				cls: "dshr-badge-ok"
-			};
-		}
 		function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRefresh }) {
 			const hasCap = (name) => supplier.capabilities?.includes(name) ?? false;
 			const canLogin = hasCap("generateLoginUrl") || hasCap("addApiKey");
@@ -4515,7 +4525,7 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/typeof.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
 		function _typeof(o) {
 			"@babel/helpers - typeof";
 			return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -4525,7 +4535,7 @@ window.__ModuleLoader__.load({
 			}, _typeof(o);
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPrimitive.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
 		function toPrimitive(t, r) {
 			if ("object" != _typeof(t) || !t) return t;
 			var e = t[Symbol.toPrimitive];
@@ -4537,13 +4547,13 @@ window.__ModuleLoader__.load({
 			return ("string" === r ? String : Number)(t);
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPropertyKey.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
 		function toPropertyKey(t) {
 			var i = toPrimitive(t, "string");
 			return "symbol" == _typeof(i) ? i : i + "";
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/defineProperty.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
 		function _defineProperty(e, r, t) {
 			return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 				value: t,

package/lib/client.js

@@ -17,6 +17,26 @@ window.__ModuleLoader__.load({
 		/** Same-origin API base the client panel fetches (host half serves it). */
 		var ROUTER_API_BASE = "/router/api";
 		//#endregion
+		//#region src/client/account-badge.ts
+		function statusBadge(account) {
+			if (account.cooling) return {
+				text: "冷却中",
+				cls: "dshr-badge-warn"
+			};
+			if (account.state === "quota") return {
+				text: "额度用完",
+				cls: "dshr-badge-warn"
+			};
+			if (account.state === "session_dead") return {
+				text: "凭证失效",
+				cls: "dshr-badge-warn"
+			};
+			return {
+				text: "健康",
+				cls: "dshr-badge-ok"
+			};
+		}
+		//#endregion
 		//#region src/client/Modal.tsx
 		/**
 		* 通用弹窗：遮罩 + 居中对话框，ESC / 点遮罩关闭。9router 风格。
@@ -116,16 +136,6 @@ window.__ModuleLoader__.load({
 			if (minutes < 60) return `剩余 ${minutes} 分钟`;
 			return `剩余 ${Math.ceil(minutes / 60)} 小时`;
 		}
-		function statusBadge(account) {
-			if (account.cooling) return {
-				text: "冷却中",
-				cls: "dshr-badge-warn"
-			};
-			return {
-				text: "健康",
-				cls: "dshr-badge-ok"
-			};
-		}
 		function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRefresh }) {
 			const hasCap = (name) => supplier.capabilities?.includes(name) ?? false;
 			const canLogin = hasCap("generateLoginUrl") || hasCap("addApiKey");
@@ -4515,7 +4525,7 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/typeof.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
 		function _typeof(o) {
 			"@babel/helpers - typeof";
 			return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -4525,7 +4535,7 @@ window.__ModuleLoader__.load({
 			}, _typeof(o);
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPrimitive.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
 		function toPrimitive(t, r) {
 			if ("object" != _typeof(t) || !t) return t;
 			var e = t[Symbol.toPrimitive];
@@ -4537,13 +4547,13 @@ window.__ModuleLoader__.load({
 			return ("string" === r ? String : Number)(t);
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPropertyKey.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
 		function toPropertyKey(t) {
 			var i = toPrimitive(t, "string");
 			return "symbol" == _typeof(i) ? i : i + "";
 		}
 		//#endregion
-		//#region \0@oxc-project+runtime@0.151.0/helpers/esm/defineProperty.js
+		//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
 		function _defineProperty(e, r, t) {
 			return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 				value: t,

package/lib/index.js

@@ -275,6 +275,24 @@ var AccountPool = class {
 		return c.until <= now;
 	}
 	/**
+	* 插件报的「现在状态」是否意味着这个号此刻不该被选中。
+	*
+	* 只认两种**账号级持久事实**（要靠外部动作才能恢复，不是抖动）：
+	*  - `quota` —— 额度/积分用完，充值才能恢复（traework 积分归零时报它）
+	*  - `session_dead` —— 凭证失效，重新登录才能恢复
+	*
+	* 其余一律不看：`transport`/`unknown`/`unavailable` 是插件某一次采样的瞬时
+	* 观察，拿它排除等于「一次抖动就踢号」，而且没有冷却计时器兜底；`rate_limit`
+	* 的指数退避由核心的冷却单元管，比状态采样准。
+	*
+	* 这是「插件只报现在怎么了、核心决定怎么办」的分工落地：插件报出它观察到
+	* 的事实，核心决定此刻不选它。恢复同样自动——充值/重登后插件报回 `ok`，
+	* 该号立刻回到候选（没有额外状态要清）。
+	*/
+	servableByReport(a) {
+		return a?.state !== "quota" && a?.state !== "session_dead";
+	}
+	/**
 	* 为「某个模型」选一个健康账号 —— **会话亲和选号，无策略旋钮**。
 	*
 	* 旧的两策略（fallback 取第一个 / round-robin 轮转）都删了：前者让所有
@@ -289,11 +307,17 @@ var AccountPool = class {
 	*     "策略"，是无会话身份时的替身。
 	*  4. 块统计不驱动轮转（亲和已保证驻留），只保留 `BLOCK_MAX` 次不达标 →
 	*     降权该号（缓存无效，可恢复）。
+	*  5. 插件报的 `quota`/`session_dead`（额度用完 / 凭证失效）→ **直接不选它**：
+	*     这类失败要靠充值/重登才能恢复，选它必是白撞一次（还有的供应商失败在
+	*     流已提交之后，这次请求根本救不回来）。见 `servableByReport`。
 	*
 	* 天花板：号数 < 并发会话数时必然有会话共用号 → 互踩，无法用选号手法消除
 	* （缓存空间是账号侧物理限制）。见 docs/pool-sticky-block.md §10。
 	*
-	* @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）
+	* @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）。
+	*   `state` 会被读：`quota`/`session_dead` 的号不进候选（见 `servableByReport`）。
+	*   `credits` **不读** —— 不同供应商的 0 含义不同（openrouter/nvidia 的 0 是
+	*   「没有积分这个概念」），是否已用完由插件解读成 `state` 后报上来。
 	* @param poolOrder 用户在面板拖出来的顺序（核心管）
 	* @param modelId 当前要路由的模型（决定查哪个 (model, uid) 冷却单元）
 	* @param messages 请求体的 messages（算亲和指纹的内容兜底）
@@ -303,9 +327,9 @@ var AccountPool = class {
 	pick(accounts, poolOrder, modelId, messages, session) {
 		const now = Date.now();
 		const byUid = new Map(accounts.map((a) => [a.uid, a]));
-		const healthy = [...poolOrder.filter((uid) => byUid.has(uid)), ...accounts.map((a) => a.uid).filter((uid) => !poolOrder.includes(uid))].filter((uid) => this.healthy(uid, modelId, now));
+		const healthy = [...poolOrder.filter((uid) => byUid.has(uid)), ...accounts.map((a) => a.uid).filter((uid) => !poolOrder.includes(uid))].filter((uid) => this.healthy(uid, modelId, now) && this.servableByReport(byUid.get(uid)));
 		if (healthy.length === 0) {
-			this.lastWhy = "全池无健康号（都在冷却）";
+			this.lastWhy = "全池无健康号（都在冷却，或插件报的额度/凭证已不可用）";
 			return;
 		}
 		const usable = healthy.filter((uid) => !this.isDemoted(uid, modelId, now, session));
@@ -320,8 +344,12 @@ var AccountPool = class {
 		if (fp === "") why.push("无指纹（拿不到 messages/会话）");
 		else if (bound === void 0) why.push("该指纹无绑定（会话首次出现）");
 		else if (!healthy.includes(bound)) {
-			const c = this.cooldowns.get(this.key(modelId, bound));
-			why.push(`原绑定 ${bound} 正在冷却${c?.reason ? `(${c.reason})` : ""}`);
+			const ba = byUid.get(bound);
+			if (!this.servableByReport(ba)) why.push(`原绑定 ${bound} 插件报额度/凭证不可用（${ba?.state}）`);
+			else {
+				const c = this.cooldowns.get(this.key(modelId, bound));
+				why.push(`原绑定 ${bound} 正在冷却${c?.reason ? `(${c.reason})` : ""}`);
+			}
 		} else if (!usable.includes(bound)) why.push(`原绑定 ${bound} 被降权（本会话样本不达标）`);
 		else why.push(`原绑定 ${bound} 不在当前健康池`);
 		const block = this.blocks.get(this.blockKey(modelId));
@@ -1984,6 +2012,21 @@ var Router = class {
 	log;
 	/** 每条降级腿的首字节预算（ms）。只给测试一个入口，生产恒为 FIRST_BYTE_BUDGET_MS。 */
 	firstByteBudgetMs;
+	/**
+	* 组合增删改**成功提交后**的通知出口。
+	*
+	* 为什么必须有：模型选择器（`ui-model-selection`）的目录是**客户端缓存**的，
+	* 只在宿主转发过来的事件上失效重载（`llm/adapters-updated` /
+	* `settings/document-updated` / 凭据事件 / 重连）。而组合只是本插件
+	* `combos.json` 里的一份状态：改完名字若不发通知，选择器会一直拿着旧快照 ——
+	* 用户能看到的症状是「面板里明明有这个名字，模型选择器里却找不到、切不过去」，
+	* 且新建的组合永远不出现（2026-10-14 实测）。
+	*
+	* 通知与落盘分开（{@link saveCombos} 先 {@link commitCombos} 落盘、再发通知）：
+	* 落盘失败、或 `stateFile` 为空（单测/独立运行时）时内存已经改了，客户端的
+	* 状态同样过期，所以这两条路径都必须照发。
+	*/
+	onCombosChanged;
 	/** 用量统计（概览看板）。 */
 	usage;
 	constructor(stateFile = "", store, log, opts) {
@@ -1991,6 +2034,7 @@ var Router = class {
 		this.store = store ?? new SupplierConfigStore(stateFile);
 		this.log = log ?? (() => {});
 		this.firstByteBudgetMs = opts?.firstByteBudgetMs ?? FIRST_BYTE_BUDGET_MS;
+		this.onCombosChanged = opts?.onCombosChanged;
 		this.usage = new UsageStore(stateFile);
 		this.loadCombos();
 	}
@@ -2025,7 +2069,23 @@ var Router = class {
 			}).filter((c) => c.models.length > 0);
 		} catch {}
 	}
+	/**
+	* 提交组合变更：落盘 + 通知拓扑观察者。
+	*
+	* `onCombosChanged` 的失败必须被吞掉：它是**通知**不是事务参与者，
+	* 监听方（宿主事件总线）出问题不能把一次已经生效的增删改报成失败 ——
+	* 那会让用户重试一个其实已经成功的操作（同 `schedule/changed` 的口径）。
+	*/
 	saveCombos() {
+		this.commitCombos();
+		try {
+			this.onCombosChanged?.();
+		} catch (err) {
+			this.log(`combo change notification failed: ${err.message}`);
+		}
+	}
+	/** 组合落盘（通知由 {@link saveCombos} 单独发，落盘失败不阻断它）。 */
+	commitCombos() {
 		if (this.combosFp === "") return;
 		try {
 			const dir = dirname(this.combosFp);
@@ -2512,7 +2572,7 @@ var Router = class {
 		for (;;) {
 			const uid = onlyUid !== void 0 ? s.accounts().some((a) => a.uid === onlyUid) && !tried.has(onlyUid) ? onlyUid : void 0 : pool.pick(s.accounts().filter((a) => !tried.has(a.uid)), cfg.poolOrder, req.model, messages, req.session);
 			if (uid === void 0) {
-				if (onlyUid !== void 0 && trace !== void 0) {
+				if (onlyUid !== void 0 && !tried.has(onlyUid) && trace !== void 0) {
 					trace.lastState = "unknown";
 					trace.lastError = `连接 ${JSON.stringify(onlyUid)} 不存在（可能已被删除）`;
 				}
@@ -4895,7 +4955,9 @@ function apply(rawContext) {
 	if (!hostSupported) ctx.logger.warn(`[dsh-router] 宿主版本 ${hostVersion ?? "未知"} 低于本插件支持的 0.2.0 —— 插件仍会加载，但设置卡片、「最近命中」徽章与工具结果转发会走错路径。请把宿主升到 0.2.0 及以上。`);
 	const store = new SupplierConfigStore(stateFile);
 	const credentials = new CredentialStore(join(dataDir, "auths"));
-	const router = new Router(stateFile, store, log);
+	const router = new Router(stateFile, store, log, { onCombosChanged: () => {
+		ctx.emit("llm/adapters-updated");
+	} });
 	const keys = new KeysStore(stateFile);
 	const disposers = [];
 	const route = (path, handler) => {

package/lib/types/router/account-pool.d.ts

@@ -66,6 +66,22 @@ export declare class AccountPool {
      *  - 且此 (supplier, model, uid) 冷却单元不在冷却中。
      */
     private healthy;
+    /**
+     * 插件报的「现在状态」是否意味着这个号此刻不该被选中。
+     *
+     * 只认两种**账号级持久事实**（要靠外部动作才能恢复，不是抖动）：
+     *  - `quota` —— 额度/积分用完，充值才能恢复（traework 积分归零时报它）
+     *  - `session_dead` —— 凭证失效，重新登录才能恢复
+     *
+     * 其余一律不看：`transport`/`unknown`/`unavailable` 是插件某一次采样的瞬时
+     * 观察，拿它排除等于「一次抖动就踢号」，而且没有冷却计时器兜底；`rate_limit`
+     * 的指数退避由核心的冷却单元管，比状态采样准。
+     *
+     * 这是「插件只报现在怎么了、核心决定怎么办」的分工落地：插件报出它观察到
+     * 的事实，核心决定此刻不选它。恢复同样自动——充值/重登后插件报回 `ok`，
+     * 该号立刻回到候选（没有额外状态要清）。
+     */
+    private servableByReport;
     /**
      * 为「某个模型」选一个健康账号 —— **会话亲和选号，无策略旋钮**。
      *
@@ -81,11 +97,17 @@ export declare class AccountPool {
      *     "策略"，是无会话身份时的替身。
      *  4. 块统计不驱动轮转（亲和已保证驻留），只保留 `BLOCK_MAX` 次不达标 →
      *     降权该号（缓存无效，可恢复）。
+     *  5. 插件报的 `quota`/`session_dead`（额度用完 / 凭证失效）→ **直接不选它**：
+     *     这类失败要靠充值/重登才能恢复，选它必是白撞一次（还有的供应商失败在
+     *     流已提交之后，这次请求根本救不回来）。见 `servableByReport`。
      *
      * 天花板：号数 < 并发会话数时必然有会话共用号 → 互踩，无法用选号手法消除
      * （缓存空间是账号侧物理限制）。见 docs/pool-sticky-block.md §10。
      *
-     * @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）
+     * @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）。
+     *   `state` 会被读：`quota`/`session_dead` 的号不进候选（见 `servableByReport`）。
+     *   `credits` **不读** —— 不同供应商的 0 含义不同（openrouter/nvidia 的 0 是
+     *   「没有积分这个概念」），是否已用完由插件解读成 `state` 后报上来。
      * @param poolOrder 用户在面板拖出来的顺序（核心管）
      * @param modelId 当前要路由的模型（决定查哪个 (model, uid) 冷却单元）
      * @param messages 请求体的 messages（算亲和指纹的内容兜底）

package/lib/types/router/index.d.ts

@@ -36,10 +36,26 @@ export declare class Router {
     private log;
     /** 每条降级腿的首字节预算（ms）。只给测试一个入口，生产恒为 FIRST_BYTE_BUDGET_MS。 */
     private firstByteBudgetMs;
+    /**
+     * 组合增删改**成功提交后**的通知出口。
+     *
+     * 为什么必须有：模型选择器（`ui-model-selection`）的目录是**客户端缓存**的，
+     * 只在宿主转发过来的事件上失效重载（`llm/adapters-updated` /
+     * `settings/document-updated` / 凭据事件 / 重连）。而组合只是本插件
+     * `combos.json` 里的一份状态：改完名字若不发通知，选择器会一直拿着旧快照 ——
+     * 用户能看到的症状是「面板里明明有这个名字，模型选择器里却找不到、切不过去」，
+     * 且新建的组合永远不出现（2026-10-14 实测）。
+     *
+     * 通知与落盘分开（{@link saveCombos} 先 {@link commitCombos} 落盘、再发通知）：
+     * 落盘失败、或 `stateFile` 为空（单测/独立运行时）时内存已经改了，客户端的
+     * 状态同样过期，所以这两条路径都必须照发。
+     */
+    private onCombosChanged;
     /** 用量统计（概览看板）。 */
     usage: UsageStore;
     constructor(stateFile?: string, store?: SupplierConfigStore, log?: (msg: string) => void, opts?: {
         firstByteBudgetMs?: number;
+        onCombosChanged?: () => void;
     });
     /**
      * 请求追踪：每次 chat 记一行，回答「这个组合到底用的哪个模型和账号」。
@@ -48,7 +64,16 @@ export declare class Router {
      */
     private logChat;
     private loadCombos;
+    /**
+     * 提交组合变更：落盘 + 通知拓扑观察者。
+     *
+     * `onCombosChanged` 的失败必须被吞掉：它是**通知**不是事务参与者，
+     * 监听方（宿主事件总线）出问题不能把一次已经生效的增删改报成失败 ——
+     * 那会让用户重试一个其实已经成功的操作（同 `schedule/changed` 的口径）。
+     */
     private saveCombos;
+    /** 组合落盘（通知由 {@link saveCombos} 单独发，落盘失败不阻断它）。 */
+    private commitCombos;
     add(supplier: Supplier): void;
     /**
      * **参与路由的供应商** —— 装载清单里开关为开的那一份，按 priority 排好。

package/lib/types/router/types.d.ts

@@ -3,13 +3,21 @@
  * 每个供应商提供 OpenAI 兼容的 chat/models，并暴露面板状态。
  * 仿 9router：供应商 = 一种"免费/付费"通道；dsh-router 在其上做路由。
  */
-import type { ChatOnceResult, SupplierAccountNow } from '../suppliers/contract.ts';
+import type { AccountState, ChatOnceResult, SupplierAccountNow } from '../suppliers/contract.ts';
 import type { AccountPool } from './account-pool.ts';
 /** 面板展示的账号状态（脱敏）。 */
 export interface SupplierAccount {
     uid: string;
     nickname?: string;
     credits: number;
+    /**
+     * 插件解读上游信号后的语义状态（`quota` = 额度/积分用完，`session_dead` = 凭证失效）。
+     *
+     * `decorate()` 一直原样带出插件报的状态，核心选号也读它（`quota`/`session_dead`
+     * 的号不进候选）——面板类型里缺了这一格就会自相矛盾：号明明已被排除在路由之外，
+     * 界面上却只看得到「0 积分」，看不出它为什么不参与。
+     */
+    state?: AccountState;
     cooling: boolean;
     until?: string;
     reason?: string;

package/lib/types/shared.d.ts

@@ -19,6 +19,12 @@ export interface RouterAccount {
     uid: string;
     nickname?: string;
     credits: number;
+    /**
+     * 插件解读上游信号后的语义状态（`quota` = 额度/积分用完，`session_dead` = 凭证失效）。
+     * 核心选号会跳过这些号，所以面板必须显示出来——否则界面写着「健康」，而路由
+     * 永远不选它，用户无从知道为什么。
+     */
+    state?: string;
     cooling: boolean;
     until?: string;
     reason?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-router-core",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "DSH plugin: a simplified 9router (AI routing gateway). Adds a 路由系统 (Routing System) sidebar entry beside 记忆系统; the panel shows suppliers, account pool, combos, and endpoint/API keys.",
   "type": "module",
   "repository": {

package/src/client/SupplierDetail.tsx

@@ -12,6 +12,7 @@ import {
   type RouterSupplierModel,
   type RouterSupplierModelsResponse,
 } from '../shared.ts'
+import { statusBadge } from './account-badge.ts'
 import { Modal } from './Modal.tsx'
 
 /* ---------------- SVG 图标 ---------------- */
@@ -61,11 +62,6 @@ function untilLabel(account: RouterAccount): string {
   return `剩余 ${hours} 小时`
 }
 
-function statusBadge(account: RouterAccount): { text: string; cls: string } {
-  if (account.cooling) return { text: '冷却中', cls: 'dshr-badge-warn' }
-  return { text: '健康', cls: 'dshr-badge-ok' }
-}
-
 export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRefresh }: SupplierDetailProps): JSX.Element {
   const hasCap = (name: string): boolean => supplier.capabilities?.includes(name) ?? false
   // 连接池（账号池）由「添加链接」能力控制显示——没有添加链接 = 无账号概念，不显示连接池