dsh-router-core 0.4.3 → 0.4.5

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.3",
+  "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
   // 连接池（账号池）由「添加链接」能力控制显示——没有添加链接 = 无账号概念，不显示连接池

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/ext-prompt/content.ts

@@ -1,18 +1,25 @@
 /**
- * 提示词内容层 —— 准则 v5 的**逐字**副本，按原分隔拆成分类。
+ * 提示词内容层 —— 准则 v5 的副本，按原分隔拆成分类。
  *
  * ════════════════════════════════════════════════════════════════════
- * 为什么一字不改
+ * 为什么原则上不改措辞
  * ════════════════════════════════════════════════════════════════════
  * 这些字是**用户自己写的准则**，不是本插件的文案。任何"顺手润色"都是擅自
  * 改写用户的规则 —— 改出来的版本和用户心里的版本不一致，而用户看不见差异，
- * 于是准则开始按**另一份**文本执行。所以这里是逐字复制，**不做任何措辞优化**。
+ * 于是准则开始按**另一份**文本执行。所以改动只在**用户点名**时发生，不做
+ * 未被要求的措辞优化。
  *
  * 拆分只为「可开关」，不为了重排：顺序与原文出现顺序一致，`order` 也按此递增。
  *
  * ⚠️ **本文件是唯一事实源**。准则原本存放在 Mnemon 记忆系统的 `USER.md`；
  * 那份已经在插件验证生效后删除（否则新旧两份注入，每轮白烧一次 token 且
  * 永远有两份可能漂移的规则）。**改动准则 = 只改这里。**
+ *
+ * ⚠️ 2026-10-08 用户点名的两处改动（治「提示词导致思考过久」）：
+ *   ① 收口：加"只在任务完成时做"，并**删掉第 ④ 条**「前三问都空时处置一件存量」
+ *      —— 它没有终止条件，每次收口都必然能再找出一件存量，等于无限循环。
+ *   ② 固化：由"每次用户可见损失都必须固化"降级为"只对数据丢失/安全这类真损失
+ *      补检查"，并删掉「不固化的教训等于决定再犯一次」这句无界义务。
  */
 
 /** 一个可独立开关的提示词分类。 */
@@ -69,8 +76,8 @@ export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
     title: '全局收口',
     defaultOn: true,
     body:
-      '收口(与跑测试同级)：①反查过期：改动让哪些注释/文档/结论/代码引用点(凡以名字对齐的调用方、开关名、注册键)不符事实？当场改或删；' +
-      '②反查重复：新旧成两份就并成一处；③反查形状：该合的合、该归档的归位；④前三问都空时处置一件存量(删/并/归档)。' +
+      '收口(只在任务完成时做，与跑测试同级)：①反查过期：改动让哪些注释/文档/结论/代码引用点(凡以名字对齐的调用方、开关名、注册键)不符事实？当场改或删；' +
+      '②反查重复：新旧成两份就并成一处；③反查形状：该合的合、该归档的归位。' +
       '做完那块区域该比动手前更整或更少。',
   },
   {
@@ -78,8 +85,8 @@ export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
     title: '固化',
     defaultOn: true,
     body:
-      '固化：每次造成用户可见损失的失败，当天固化为可自动重放的检查——会变红(注入违规必须失败)、可重放(一条命令)、' +
-      '归属清晰(失败信息指向违规处)；面向他人的检查只警告不阻断。不固化的教训等于决定再犯一次。',
+      '固化：只对数据丢失/安全这类真损失补检查——会变红(注入违规必须失败)、可重放(一条命令)、' +
+      '归属清晰(失败信息指向违规处)；普通 bug 修好即止，不额外造闸门。',
   },
   {
     id: 'verdifiable',

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 {