dsh-router-core 0.4.4 → 0.4.6

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 就会对每个账号
 都报一次,于是一个都选不出来(表现为「组合越用越没号可用」)。所以「这个模型
@@ -119,7 +138,7 @@ js 只要知道这一条:**报 `rate_limit`/`transport`/`unknown` 只影响「
 type ChatOnceResult =
   | { ok: true; stream: ReadableStream<Uint8Array> }   // 流式
   | { ok: true; status: number; body: string }         // 非流式
-  | { ok: false; state: AccountState; message: string } // 失败
+  | { ok: false; state: AccountState; message: string; resetAt?: number } // 失败
 ```
 
 要点:
@@ -132,7 +151,7 @@ type ChatOnceResult =
 
 | state | 核心处置 |
 |---|---|
-| `rate_limit` | **指数退避**:首次 2s,每次翻倍,上限 5 分钟;成功后等级清零 |
+| `rate_limit` | **指数退避**:首次 2s,每次翻倍,上限 5 分钟;成功后等级清零。失败项带 `resetAt`(上游声明的重置时刻,epoch ms)时**冷到该点**——频率配额的重置是小时级的,退避上限只会到点回来再撞 |
 | `quota` | 冷却 10 分钟 |
 | `session_dead` | **连接级冷却 30 分钟**(该号所有模型都停用,到期自愈;没有永久禁用——403 分不清凭证死活与风控误伤) |
 | `unavailable` / `transport` / `unknown` | 瞬时短冷却 30s(**每次都冷**,不攒次数) |

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

@@ -10,6 +10,19 @@ import { homedir } from "node:os";
 //#region src/shared.ts
 /** Same-origin API base the client panel fetches (host half serves it). */
 const ROUTER_API_BASE = "/router/api";
+/**
+* 外部 OpenAI 兼容客户端的归因标签（`/v1` 没有宿主内部头 `x-dsh-router-session`
+* 时的兜底）——否则 usage 记录里全是匿名流量，出事反查不出是谁在打
+* （2026-10-15 实测：296 条匿名记录对不上任何会话）。
+*
+* 取值优先级：`user`（OpenAI 标准终端用户字段）→ `prompt_cache_key`
+* （Zed 等客户端的缓存键，常带线程粒度）→ `User-Agent`（保底到客户端粒度）。
+* 值截断到 64 字符；三者皆无返回 undefined（保持匿名）。
+*/
+function clientIdentityOf(body, userAgent) {
+	const tag = (kind, v) => typeof v === "string" && v !== "" ? `ext/${kind}:${v.slice(0, 64)}` : void 0;
+	return tag("user", body.user) ?? tag("cache", body.prompt_cache_key) ?? (userAgent !== void 0 && userAgent !== "" ? `ext/ua:${userAgent.slice(0, 64)}` : void 0);
+}
 //#endregion
 //#region src/router/prefix-affinity.ts
 /**
@@ -116,7 +129,9 @@ const MINUTE = 6e4;
 *
 * 冷却策略对齐 9router 的 accountFallback / errorConfig：
 *  - `rate_limit` 用**指数退避**（9router 的 `backoff: true`）：偶发限流只
-*    短冷，持续限流越退越久，比固定 1 分钟两头不讨好要准。
+*    短冷，持续限流越退越久，比固定 1 分钟两头不讨好要准。上游自己声明了
+*    **重置时刻**（resetAt，如 6004「将在 … 重置」）时冷到该点——频率配额是
+*    小时级的，退避上限（5min）只会到点回来再撞。
 *  - 未知/瞬时错误用**瞬时短冷却**（9router 默认分支 TRANSIENT_COOLDOWN_MS）：
 *    每次失败都冻结，坏号不会留在池里被下一个请求再选中。
 *
@@ -275,6 +290,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 +322,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 +342,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 +359,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));
@@ -445,8 +488,13 @@ var AccountPool = class {
 	blockKey(modelId) {
 		return `${this.supplierId}${SEP}${modelId}`;
 	}
-	/** 记录一次失败：按状态处置（冷却/退避），落在「(模型, 连接)」这个冷却单元上。 */
-	noteFailure(uid, modelId, state, message) {
+	/**
+	* 记录一次失败：按状态处置（冷却/退避），落在「(模型, 连接)」这个冷却单元上。
+	* `resetAt` = 上游声明的重置时刻（epoch ms）：限流退避优先冷到该点——
+	* 频率配额是小时级的，5min 上限的指数退避只会到点回来再撞 6004，
+	* 把号轮流打冷（2026-10-15 的 11 号全灭事故）。
+	*/
+	noteFailure(uid, modelId, state, message, resetAt) {
 		const rule = RULES[state];
 		if (rule.cooldown === 0) return;
 		if (state === "session_dead") {
@@ -460,7 +508,9 @@ var AccountPool = class {
 		e.reason = message;
 		if (rule.cooldown === "backoff") {
 			e.backoffLevel = Math.min(e.backoffLevel + 1, BACKOFF_MAX_LEVEL);
-			e.until = Math.max(e.until, Date.now() + backoffMs(e.backoffLevel));
+			const backoffUntil = Date.now() + backoffMs(e.backoffLevel);
+			const until = resetAt !== void 0 && resetAt > Date.now() ? resetAt : backoffUntil;
+			e.until = Math.max(e.until, until);
 			return;
 		}
 		if (rule.cooldown === "transient") {
@@ -1984,6 +2034,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 +2056,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 +2091,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 +2594,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)} 不存在（可能已被删除）`;
 				}
@@ -2536,7 +2618,7 @@ var Router = class {
 					}
 					return false;
 				}
-				pool.noteFailure(uid, req.model, r.state, r.message);
+				pool.noteFailure(uid, req.model, r.state, r.message, r.resetAt);
 				pool.dropBlock(req.model);
 				if (trace !== void 0) {
 					trace.attempts += 1;
@@ -2976,16 +3058,18 @@ async function* translateSse(payloads) {
 					usage
 				};
 			}
+			const hasCompleteToolCall = complete.some((block) => block.kind === "tool-call");
 			const reason = pendingFinish ?? { kind: "stop" };
+			const resolved = reason.kind === "stop" && hasCompleteToolCall ? { kind: "tool-calls" } : reason;
 			yield {
 				type: "finish",
-				reason: reason.kind === "stop" && order.length === 0 ? {
+				reason: resolved.kind === "stop" && order.length === 0 ? {
 					kind: "error",
 					failure: {
 						message: "model returned a completed response with no content",
 						code: EMPTY_RESPONSE_CODE
 					}
-				} : reason
+				} : resolved
 			};
 			return;
 		}
@@ -4895,7 +4979,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) => {
@@ -5046,7 +5132,7 @@ function apply(rawContext) {
 		}
 		const lv = typeof peek.reasoning_effort === "string" && peek.reasoning_effort !== "" ? peek.reasoning_effort : "auto";
 		const sessionRaw = req.headers["x-dsh-router-session"];
-		const session = typeof sessionRaw === "string" && sessionRaw !== "" ? sessionRaw : void 0;
+		const session = (typeof sessionRaw === "string" && sessionRaw !== "" ? sessionRaw : void 0) ?? clientIdentityOf(peek, req.headers["user-agent"]);
 		await router.chatCompletions({
 			rawBody: body,
 			stream: !!peek.stream,