dsh-router-core 0.4.4 → 0.4.5

package/src/client/account-badge.test.ts

@@ -0,0 +1,37 @@
+/**
+ * 账号徽章闸门 —— 面板不许和路由说反话。
+ *
+ * 核心 `pick()` 会跳过插件报 `quota`/`session_dead` 的号。面板若把它们显示成
+ * 「健康」，用户看到的就是「一切正常但请求永远不走这个号」——没有线索可查。
+ * 这类不一致不会抛异常，只会让人误判，所以要有闸门。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { statusBadge } from './account-badge.ts'
+import type { RouterAccount } from '../shared.ts'
+
+const acc = (over: Partial<RouterAccount> = {}): RouterAccount => ({
+  uid: 'u1', credits: 100, cooling: false, ...over,
+})
+
+test('额度用完的号显示「额度用完」，不是「健康」', () => {
+  const b = statusBadge(acc({ credits: 0, state: 'quota' }))
+  assert.equal(b.text, '额度用完')
+  assert.notEqual(b.cls, 'dshr-badge-ok', '不能用健康色')
+})
+
+test('凭证失效显示「凭证失效」', () => {
+  assert.equal(statusBadge(acc({ state: 'session_dead' })).text, '凭证失效')
+})
+
+test('冷却优先于状态：冷却带 until/reason，用户更需要先看到', () => {
+  const b = statusBadge(acc({ state: 'quota', cooling: true, reason: 'quota: exceeded' }))
+  assert.equal(b.text, '冷却中')
+})
+
+test('正常号仍显示「健康」（不误伤 openrouter/nvidia 那种 credits: 0 的号）', () => {
+  // 这两家没有积分概念，报的是 credits: 0 + state: 'ok' —— 不能因为 0 就报警。
+  assert.equal(statusBadge(acc({ credits: 0, state: 'ok' })).text, '健康')
+  assert.equal(statusBadge(acc({ credits: 0 })).text, '健康', 'state 缺省（老插件）也不报警')
+  assert.equal(statusBadge(acc({ credits: 500, state: 'ok' })).text, '健康')
+})

package/src/client/account-badge.ts

@@ -0,0 +1,24 @@
+/**
+ * 账号行的状态徽章判据 —— 面板必须和路由说同一句话。
+ *
+ * 核心选号会跳过插件报 `quota`（额度/积分用完）和 `session_dead`（凭证失效）的号
+ * （见 `account-pool.servableByReport`）。如果面板把这些号显示成「健康」，用户
+ * 就会看到「界面说没问题、可是请求永远不走它」——查不出原因，只能去删链接重登，
+ * 而真正的解法是充值。
+ *
+ * 判据顺序（先冷却后状态）的理由：冷却带 `until` 和 `reason`，比静态状态更具体，
+ * 用户更需要先看到「什么时候会好」。
+ */
+import type { RouterAccount } from '../shared.ts'
+
+export interface AccountBadge {
+  text: string
+  cls: string
+}
+
+export function statusBadge(account: RouterAccount): AccountBadge {
+  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' }
+}

package/src/index.ts

@@ -162,6 +162,11 @@ export function apply(rawContext: unknown): void {
     get: (key: string) => unknown
     on: (name: string, listener: (...args: unknown[]) => void) => unknown
     provide: (name: string, value: unknown) => unknown
+    /**
+     * 广播宿主事件。组合增删改后必须用它发 `llm/adapters-updated`，
+     * 否则模型选择器一直拿着旧快照（见 `Router` 的 `onCombosChanged` 注释）。
+     */
+    emit: (name: string, ...args: unknown[]) => unknown
     webServer: WebServer
     llm?: Llm
     logger: { info: (message: string) => void; warn: (message: string) => void }
@@ -193,7 +198,13 @@ export function apply(rawContext: unknown): void {
   }
   const store = new SupplierConfigStore(stateFile)
   const credentials = new CredentialStore(join(dataDir, 'auths'))
-  const router = new Router(stateFile, store, log)
+  // 组合增删改后广播 `llm/adapters-updated`：模型选择器的目录是客户端缓存的，
+  // 只在这个（宿主已转发给客户端的）事件上失效重载。不发它就出现「面板里有、
+  // 选择器里找不到/切不过去」（2026-10-14 实测）。
+  // 该事件在宿主侧是纯通知（payload-free），监听方都是幂等的重读，重复发安全。
+  const router = new Router(stateFile, store, log, {
+    onCombosChanged: () => { ctx.emit('llm/adapters-updated') },
+  })
 
   const keys = new KeysStore(stateFile)
 

package/src/router/account-pool.test.ts

@@ -517,6 +517,80 @@ test('状态表：各 AccountState 的处置符合预期', () => {
   assert.equal(p.pick(list, [], 'm1'), undefined, '四个号都不可服务')
 })
 
+// ---- 插件报的额度/凭证状态直接进选号 ----
+// 分工：插件报「现在怎么了」，核心决定「怎么办」。积分用完（quota）/凭证失效
+// （session_dead）要靠充值/重登才能恢复，选它必是白撞一次——而且 traework 的
+// 积分耗尽失败发生在流已提交之后（HTTP 200 + 流内 4008），这次请求救不回来。
+// 所以必须在**选号阶段**就排除，不能等失败后记账。
+
+test('报 quota 的号不进选号（额度用完，选它必白撞）', () => {
+  const p = pool()
+  const list: SupplierAccountNow[] = [
+    { uid: 'broke', credits: 0, state: 'quota' },
+    { uid: 'rich', credits: 100, state: 'ok' },
+  ]
+  assert.equal(p.pick(list, ['broke', 'rich'], 'm1'), 'rich', '池顺序在前也没用，用不了的号跳过')
+})
+
+test('报 session_dead 的号不进选号（凭证失效，要重登）', () => {
+  const p = pool()
+  const list: SupplierAccountNow[] = [
+    { uid: 'dead', credits: 100, state: 'session_dead' },
+    { uid: 'alive', credits: 1, state: 'ok' },
+  ]
+  assert.equal(p.pick(list, ['dead', 'alive'], 'm1'), 'alive')
+})
+
+test('全池都报 quota → 无号可选，且说明原因不是「都在冷却」', () => {
+  const p = pool()
+  const list: SupplierAccountNow[] = [
+    { uid: 'a', credits: 0, state: 'quota' },
+    { uid: 'b', credits: 0, state: 'quota' },
+  ]
+  assert.equal(p.pick(list, [], 'm1'), undefined)
+  assert.match(p.lastWhy, /额度|凭证/, '原因要能区分「没额度」和「冷却中」')
+})
+
+test('报 quota 的号恢复成 ok 后立刻回到候选（充值即自愈，无需重启）', () => {
+  const p = pool()
+  assert.equal(p.pick([{ uid: 'u', credits: 0, state: 'quota' }], [], 'm1'), undefined)
+  assert.equal(p.pick([{ uid: 'u', credits: 50, state: 'ok' }], [], 'm1'), 'u')
+})
+
+test('积分 0 但状态是 ok 的号照常可选（0 不等于「没额度」）', () => {
+  const p = pool()
+  // openrouter/nvidia 报的就是 credits: 0 + state: 'ok'（没有积分这个概念）。
+  // 核心不能自己拿 credits===0 当「用完了」，否则这些供应商会被整池排除。
+  const list: SupplierAccountNow[] = [{ uid: 'api-key', credits: 0, state: 'ok' }]
+  assert.equal(p.pick(list, [], 'm1'), 'api-key')
+})
+
+test('瞬时状态（transport/unknown/unavailable）不排除号：那是采样抖动，不是账号事实', () => {
+  const p = pool()
+  for (const state of ['transport', 'unknown', 'unavailable'] as const) {
+    const list: SupplierAccountNow[] = [{ uid: 'u', credits: 5, state }]
+    assert.equal(p.pick(list, [], 'm1'), 'u', `${state} 不该让号退出候选`)
+  }
+})
+
+test('会话绑定撞上报 quota 的号 → 换号，且 lastWhy 指出是额度问题', () => {
+  const p = pool()
+  const msgs = [{ role: 'user', content: 'hello' }]
+  const okList: SupplierAccountNow[] = [
+    { uid: 'bound', credits: 10, state: 'ok' },
+    { uid: 'other', credits: 10, state: 'ok' },
+  ]
+  assert.equal(p.pick(okList, [], 'm1', msgs), 'bound', '先绑到 bound')
+  // 该号积分耗尽后：同一会话必须换到别的号，不能继续钉在死号上
+  const brokeList: SupplierAccountNow[] = [
+    { uid: 'bound', credits: 0, state: 'quota' },
+    { uid: 'other', credits: 10, state: 'ok' },
+  ]
+  assert.equal(p.pick(brokeList, [], 'm1', msgs), 'other')
+  assert.match(p.lastWhy, /bound/, '要说清为什么没用原绑定')
+  assert.match(p.lastWhy, /额度|凭证/, '原因要指向额度/凭证，不是「冷却」')
+})
+
 /**
  * 处置对齐 9router：未知/瞬时错误**每次**短冷却（不再攒够 3 次）。
  */

package/src/router/account-pool.ts

@@ -252,6 +252,25 @@ export class AccountPool {
     return c.until <= now
   }
 
+  /**
+   * 插件报的「现在状态」是否意味着这个号此刻不该被选中。
+   *
+   * 只认两种**账号级持久事实**（要靠外部动作才能恢复，不是抖动）：
+   *  - `quota` —— 额度/积分用完，充值才能恢复（traework 积分归零时报它）
+   *  - `session_dead` —— 凭证失效，重新登录才能恢复
+   *
+   * 其余一律不看：`transport`/`unknown`/`unavailable` 是插件某一次采样的瞬时
+   * 观察，拿它排除等于「一次抖动就踢号」，而且没有冷却计时器兜底；`rate_limit`
+   * 的指数退避由核心的冷却单元管，比状态采样准。
+   *
+   * 这是「插件只报现在怎么了、核心决定怎么办」的分工落地：插件报出它观察到
+   * 的事实，核心决定此刻不选它。恢复同样自动——充值/重登后插件报回 `ok`，
+   * 该号立刻回到候选（没有额外状态要清）。
+   */
+  private servableByReport(a: SupplierAccountNow | undefined): boolean {
+    return a?.state !== 'quota' && a?.state !== 'session_dead'
+  }
+
   /**
    * 为「某个模型」选一个健康账号 —— **会话亲和选号，无策略旋钮**。
    *
@@ -267,11 +286,17 @@ export 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（算亲和指纹的内容兜底）
@@ -286,9 +311,11 @@ export class AccountPool {
       ...poolOrder.filter((uid) => byUid.has(uid)),
       ...accounts.map((a) => a.uid).filter((uid) => !poolOrder.includes(uid)),
     ]
-    const healthy = ordered.filter((uid) => this.healthy(uid, modelId, now))
+    const healthy = ordered.filter(
+      (uid) => this.healthy(uid, modelId, now) && this.servableByReport(byUid.get(uid)),
+    )
     if (healthy.length === 0) {
-      this.lastWhy = '全池无健康号（都在冷却）'
+      this.lastWhy = '全池无健康号（都在冷却，或插件报的额度/凭证已不可用）'
       return undefined
     }
     // 缓存无效降权：该号缓存质量样本长期不达标 → 跳过它（可到期恢复）
@@ -309,8 +336,13 @@ export class AccountPool {
       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 {

package/src/router/combo-change.test.ts

@@ -0,0 +1,125 @@
+/**
+ * 组合变更必须通知拓扑观察者 —— `onCombosChanged` 的出口判据。
+ *
+ * ⚠️ 为什么需要它（2026-10-14 实测的「面板里有，模型选择器里找不到」）：
+ *   模型选择器（`ui-model-selection`）的模型目录是**客户端缓存**的：每个浏览器
+ *   连接只 `load()` 一次，之后只在宿主转发的事件上失效重载
+ *   （`llm/adapters-updated` / `settings/document-updated` / 凭据事件 / 重连）。
+ *   而组合只是本插件 `combos.json` 里的一份状态：
+ *     - `createCombo` 建了新组合 → 选择器永远看不到它
+ *     - `updateCombo` 改了名字 → 选择器还拿旧名字，用户切不过去
+ *     - `removeCombo` 删了组合 → 选择器里还留着，选中必然失败
+ *   实测现场：`combos.json` 里是 `buddy-models-flash`（22:19 改的名），
+ *   而选择器里显示的是**早已删除的** `NVIDIA-models` —— 整张表都过期了。
+ *
+ * 判据形态：直接守「提交成功后有没有发出通知」，而不是守客户端有没有刷新 ——
+ * 客户端刷新要靠宿主转发，单测里没有宿主。通知是这里唯一能守住的那一环。
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync, readFileSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { Router } from './index.ts'
+
+/** 造一个空 stateFile 的临时目录（组合落在同目录的 combos.json）。 */
+function fixture(): { dir: string; stateFile: string } {
+  const dir = mkdtempSync(join(tmpdir(), 'dsh-router-combo-'))
+  return { dir, stateFile: join(dir, 'state.json') }
+}
+
+test('★ createCombo 成功后通知一次（否则新组合在选择器里永不出现）', () => {
+  const { stateFile } = fixture()
+  let notified = 0
+  const router = new Router(stateFile, undefined, undefined, { onCombosChanged: () => { notified += 1 } })
+  assert.equal(router.createCombo('c1', ['supA,a-model']).ok, true)
+  assert.equal(notified, 1, '新建组合后没有通知 ⇒ 模型选择器看不到它')
+})
+
+test('★ updateCombo 成功后通知（否则选择器还拿旧名字，切不过去）', () => {
+  const { stateFile } = fixture()
+  let notified = 0
+  const router = new Router(stateFile, undefined, undefined, { onCombosChanged: () => { notified += 1 } })
+  router.createCombo('old-name', ['supA,a-model'])
+  notified = 0
+  assert.equal(router.updateCombo('old-name', 'new-name', ['supA,a-model']).ok, true)
+  assert.equal(notified, 1, '改名后没有通知 ⇒ 选择器里还留着旧名字')
+})
+
+test('★ removeCombo 成功后通知（否则选择器里留着已删的组合，选中必失败）', () => {
+  const { stateFile } = fixture()
+  let notified = 0
+  const router = new Router(stateFile, undefined, undefined, { onCombosChanged: () => { notified += 1 } })
+  router.createCombo('gone', ['supA,a-model'])
+  notified = 0
+  assert.equal(router.removeCombo('gone').ok, true)
+  assert.equal(notified, 1, '删除后没有通知 ⇒ 选择器里还留着它')
+})
+
+test('被拒绝的变更不通知（校验失败时组合根本没变）', () => {
+  const { stateFile } = fixture()
+  let notified = 0
+  const router = new Router(stateFile, undefined, undefined, { onCombosChanged: () => { notified += 1 } })
+  router.createCombo('keep', ['supA,a-model'])
+  notified = 0
+  // 空模型列表 / 非法名字 / 不存在的 id：三条都得原地不动
+  assert.equal(router.createCombo('bad-chars!', ['supA,a-model']).ok, false)
+  assert.equal(router.createCombo('no-models', []).ok, false)
+  assert.equal(router.updateCombo('missing-id', 'x', ['supA,a-model']).ok, false)
+  assert.equal(router.removeCombo('missing-id').ok, false)
+  assert.equal(notified, 0, '失败的变更不该通知（会让客户端做一次无意义的全量重拉）')
+})
+
+test('通知出口抛错不能把已提交的变更报成失败', async () => {
+  const { stateFile } = fixture()
+  const router = new Router(stateFile, undefined, undefined, {
+    // 监听方（宿主事件总线）出问题：这是通知不是事务参与者
+    onCombosChanged: () => { throw new Error('listener exploded') },
+  })
+  const result = router.createCombo('survivor', ['supA,a-model'])
+  assert.equal(result.ok, true, '通知失败不该让 createCombo 变红 —— 组合其实已经提交')
+  assert.equal((await router.combos()).some((c) => c.name === 'survivor'), true, '内存里的组合必须还在')
+})
+
+test('没装出口时不抛（单测/独立运行时）', () => {
+  const { stateFile } = fixture()
+  const router = new Router(stateFile)
+  assert.doesNotThrow(() => { router.createCombo('c1', ['supA,a-model']) })
+})
+
+test('通知发生在落盘之后 —— 监听方重读时能读到新组合', () => {
+  const { stateFile } = fixture()
+  let seen: string[] = []
+  const router = new Router(stateFile, undefined, undefined, {
+    onCombosChanged: () => {
+      // 监听方（宿主）会重新读一遍组合去刷客户端，此刻必须已经能读到新的
+      const onDisk = JSON.parse(readFileSync(join(stateFile, '..', 'combos.json'), 'utf8')) as {
+        combos: Array<{ name: string }>
+      }
+      seen = onDisk.combos.map((c) => c.name)
+    },
+  })
+  router.createCombo('persisted', ['supA,a-model'])
+  assert.deepEqual(seen, ['persisted'], '通知时组合还没落盘 ⇒ 监听方重读会拿到旧状态')
+})
+
+test('重复写同一个组合名不触发第二次落盘语义变化（幂等读取安全）', () => {
+  const { stateFile } = fixture()
+  let notified = 0
+  const router = new Router(stateFile, undefined, undefined, { onCombosChanged: () => { notified += 1 } })
+  router.createCombo('c1', ['supA,a-model'])
+  // 同 id 的 update 到等价内容仍然是合法提交（不是 no-op 语义），必须通知
+  assert.equal(router.updateCombo('c1', 'c1', ['supA,a-model']).ok, true)
+  assert.equal(notified, 2)
+})
+
+test('★ 注入：拿掉通知 ⇒ 上面几条会红（反向自检）', () => {
+  const { stateFile } = fixture()
+  // 等价于修复前的实现：没有 onCombosChanged
+  const router = new Router(stateFile)
+  router.createCombo('c1', ['supA,a-model'])
+  const combosFile = join(stateFile, '..', 'combos.json')
+  // 落盘仍然发生（这条路径没被改坏），但没有任何通知出口可发
+  const onDisk = JSON.parse(readFileSync(combosFile, 'utf8')) as { combos: unknown[] }
+  assert.equal(onDisk.combos.length, 1, '落盘行为必须保持')
+})

package/src/router/index.ts

@@ -657,6 +657,21 @@ export class Router {
   private log: (msg: string) => void
   /** 每条降级腿的首字节预算（ms）。只给测试一个入口，生产恒为 FIRST_BYTE_BUDGET_MS。 */
   private firstByteBudgetMs: number
+  /**
+   * 组合增删改**成功提交后**的通知出口。
+   *
+   * 为什么必须有：模型选择器（`ui-model-selection`）的目录是**客户端缓存**的，
+   * 只在宿主转发过来的事件上失效重载（`llm/adapters-updated` /
+   * `settings/document-updated` / 凭据事件 / 重连）。而组合只是本插件
+   * `combos.json` 里的一份状态：改完名字若不发通知，选择器会一直拿着旧快照 ——
+   * 用户能看到的症状是「面板里明明有这个名字，模型选择器里却找不到、切不过去」，
+   * 且新建的组合永远不出现（2026-10-14 实测）。
+   *
+   * 通知与落盘分开（{@link saveCombos} 先 {@link commitCombos} 落盘、再发通知）：
+   * 落盘失败、或 `stateFile` 为空（单测/独立运行时）时内存已经改了，客户端的
+   * 状态同样过期，所以这两条路径都必须照发。
+   */
+  private onCombosChanged: (() => void) | undefined
   /** 用量统计（概览看板）。 */
   usage: UsageStore
 
@@ -664,12 +679,13 @@ export class Router {
     stateFile = '',
     store?: SupplierConfigStore,
     log?: (msg: string) => void,
-    opts?: { firstByteBudgetMs?: number },
+    opts?: { firstByteBudgetMs?: number; onCombosChanged?: () => void },
   ) {
     this.combosFp = stateFile ? join(dirname(stateFile), 'combos.json') : ''
     this.store = store ?? new SupplierConfigStore(stateFile)
     this.log = log ?? ((): void => {})
     this.firstByteBudgetMs = opts?.firstByteBudgetMs ?? FIRST_BYTE_BUDGET_MS
+    this.onCombosChanged = opts?.onCombosChanged
     this.usage = new UsageStore(stateFile)
     this.loadCombos()
   }
@@ -728,7 +744,24 @@ export class Router {
     }
   }
 
+  /**
+   * 提交组合变更：落盘 + 通知拓扑观察者。
+   *
+   * `onCombosChanged` 的失败必须被吞掉：它是**通知**不是事务参与者，
+   * 监听方（宿主事件总线）出问题不能把一次已经生效的增删改报成失败 ——
+   * 那会让用户重试一个其实已经成功的操作（同 `schedule/changed` 的口径）。
+   */
   private saveCombos(): void {
+    this.commitCombos()
+    try {
+      this.onCombosChanged?.()
+    } catch (err) {
+      this.log(`combo change notification failed: ${(err as Error).message}`)
+    }
+  }
+
+  /** 组合落盘（通知由 {@link saveCombos} 单独发，落盘失败不阻断它）。 */
+  private commitCombos(): void {
     if (this.combosFp === '') return
     try {
       const dir = dirname(this.combosFp)
@@ -1276,12 +1309,19 @@ export class Router {
     for (;;) {
       // 指定连接：只试它。选不中就直接失败并说明原因（连接已不存在/不在池里），
       // **不回退到别的号** —— 否则「测这个连接」测出来的是另一个号的结果，
-      // 诊断就变成了假话。
+      // 诊断就变成了假话。注意「选不中」要区分「不在池里」和「这一轮试过了」：
+      // 后者是失败重试的收尾，必须保留上游给的真实错误（见下方 uid === undefined）。
       const uid = onlyUid !== undefined
         ? (s.accounts().some((a) => a.uid === onlyUid) && !tried.has(onlyUid) ? onlyUid : undefined)
         : pool.pick(s.accounts().filter((a) => !tried.has(a.uid)), cfg.poolOrder, req.model, messages, req.session)
       if (uid === undefined) {
-        if (onlyUid !== undefined && trace !== undefined) {
+        // 指定连接却选不出来，有两种完全不同的原因，混为一谈就是假诊断：
+        //   - 这个 uid 根本不在账号池里 → 真「连接不存在（可能已被删除）」
+        //   - uid 在池里，只是这一轮被 `tried` 挡掉 → 它**刚才已经试过并失败**了，
+        //     trace 里正躺着上游给的真实原因（如 quota / 4008「额度已用完」）。
+        //     此处若照旧覆盖，会把「积分用完」说成「连接不存在」——2026-10-14
+        //     实测：0 积分号测出「连接不存在（可能已被删除）」，而它明明在面板上。
+        if (onlyUid !== undefined && !tried.has(onlyUid) && trace !== undefined) {
           // 不给 AccountState 加「连接不存在」这个值：那是给**账号的失败**分类用的
           // （决定要不要冷却），而链接不存在不是任何账号的错，混进去会让所有分类逻辑
           // 都要认识它。具体原因放 lastError 就够。