dsh-router-core 0.3.1 → 0.3.3

package/lib/types/llm/adapter.d.ts

@@ -15,7 +15,13 @@ export interface RouterAdapterSource {
     }>>;
 }
 /** openai SSE payload → DSH StreamChunk 流。导出以便单测锁死 usage 契约。 */
-export declare function translateSse(payloads: Iterable<string>): AsyncGenerator<StreamChunk>;
+/**
+ * 把上游 SSE 的 `data:` 载荷流翻译成 DSH 的 StreamChunk 事件流。
+ *
+ * 吃 `AsyncIterable`（真流式：边收边吐）或 `Iterable`（测试用数组）。
+ * 用 `for await` 是因为它天然兼容两者 —— 不必为流式再写一份。
+ */
+export declare function translateSse(payloads: AsyncIterable<string> | Iterable<string>): AsyncGenerator<StreamChunk>;
 /**
  * DSH adapter：provider `router`。模型目录 = 组合；stream 转发到本插件
  * /v1/chat/completions（组合路由在 /v1 内完成）。

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

@@ -1,37 +1,72 @@
 /**
- * 账号池 —— dsh-router 核心策略：选号、冷却、禁用、错误累计、遍历回退。
+ * 账号池 —— dsh-router 核心策略：选号、冷却、禁用、遍历回退。
  *
- * 供应商插件只管「对单个账号调通上游」，账号层面的策略全在这里：
- *   - 按 poolOrder 排序（未配置的按插件报告顺序追加）
- *   - 按 poolStrategy 选号：fallback = 取第一个健康；round-robin = 轮转健康号
- *   - 失败按插件报的 AccountState 处置（冷却/禁用/错误累计），攒够阈值自动冷却
+ * 供应商插件只管「对单个账号调通上游」，账号层面的策略全在这里。
  *
- * 天花板：冷却/禁用/错误计数都是**内存态**，重启归零（与旧插件行为一致，
- * 插件的持久化只存凭证与积分，不存健康）。要跨重启保留得落盘，届时加一个
- * stateFile 即可，接口不用变。
+ * ## 冷却颗粒度 = (供应商, 模型, 连接) 三元组
+ *
+ * 冷却**不按连接整体记**，而是按「哪家供应商 × 哪个模型 × 哪个连接」单独记。
+ * 理由：一个连接可以服务多个模型。若某连接调模型 A 时被限流/瞬时抖动而把
+ * **整个连接**冷掉，那它调模型 B 也被殃及——一个付费连接会因一个模型的瞬时
+ * 失败而对其它模型也不可用，这是错的。
+ *
+ *   - 冷却/限流退避/瞬时 → 键 = (supplierId, modelId, uid)，只冷「这个号 × 这个模型」
+ *   - 禁用(session_dead)     → 键 = uid（登录态问题，该号所有模型都不可用）
+ *   - 手动冷却(面板)         → 键 = uid（管理员整连接暂停）
+ *
+ * 为什么键里要带 supplierId：不同供应商**会有同名的模型 id**（如 traework 与
+ * codebuddy 都有 `deepseek-v4-flash`），它们是不同的实体，单靠 (modelId, uid)
+ * 会把跨供应商的同名模型串到一起。尽管本池实例当前是单供应商（loader 每供应商
+ * 一个 AccountPool），键仍显式带 supplierId，语义自明且将来若池合并也安全。
+ *
+ * 天花板：冷却/禁用都是**内存态**，重启归零（与旧插件行为一致）。要跨重启保留
+ * 得落盘，届时加 stateFile 即可，接口不用变。
  */
 import type { AccountState, SupplierAccountNow } from '../suppliers/contract.ts';
 export declare class AccountPool {
-    private entries;
+    /** 本池所属供应商（loader 每供应商一个实例；键里带上，跨供应商同名模型不串）。 */
+    private supplierId;
+    /** (supplier, model, uid) → 冷却/退避。 */
+    private cooldowns;
+    /** uid → 连接级禁用 / 手动暂停。 */
+    private byUid;
     private rrCursor;
+    constructor(supplierId?: string);
+    private key;
     private entry;
-    /** 是否可服务：未禁用且不在冷却中。 */
+    /** 某连接整体状态（禁用/手动暂停）。 */
+    private uidState;
+    /** 该连接是否被禁用 / 手动整连接暂停中（跨模型生效）。 */
+    private uidBlocked;
+    /**
+     * 给定要试的模型，该连接是否可服务：
+     *  - 未被连接级禁用/手动暂停（跨模型）；
+     *  - 且此 (supplier, model, uid) 冷却单元不在冷却中。
+     */
     private healthy;
     /**
-     * 按策略选一个健康账号。
+     * 按策略为「某个模型」选一个健康账号。
      * @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）
      * @param poolOrder 用户在面板拖出来的顺序（核心管）
+     * @param strategy fallback 取第一个健康 / round-robin 轮转健康号
+     * @param modelId 当前要路由的模型（决定查哪个 (model, uid) 冷却单元）
      * @returns 选中的 uid；无健康账号返回 undefined
      */
-    pick(accounts: SupplierAccountNow[], poolOrder: string[], strategy: string): string | undefined;
-    /** 记录一次失败：按状态处置（冷却/禁用/错误累计）。 */
-    noteFailure(uid: string, state: AccountState, message: string): void;
-    /** 记录一次成功：清零连续错误。 */
-    noteSuccess(uid: string): void;
-    /** 手动冷却（面板/管理用途）。 */
+    pick(accounts: SupplierAccountNow[], poolOrder: string[], strategy: string, modelId: string): string | undefined;
+    /** 记录一次失败：按状态处置（冷却/禁用/退避），落在「(模型, 连接)」这个冷却单元上。 */
+    noteFailure(uid: string, modelId: string, state: AccountState, message: string): void;
+    /** 记录一次成功：清零「该模型」的限流退避等级（好号不背历史惩罚）。不解除禁用。 */
+    noteSuccess(uid: string, modelId: string): void;
+    /** 手动暂停整连接（面板/管理用途，跨模型）。ms<=0 表示解除。 */
     cooldown(uid: string, ms: number, reason: string): void;
-    /** 把核心的冷却/禁用/错误累计叠加到插件报告的「现在状态」上，产出面板态。 */
-    decorate(accounts: SupplierAccountNow[]): Array<SupplierAccountNow & {
+    /** 把核心的冷却/禁用叠加到插件报的「现在状态」上，产出面板态。
+     *
+     * 冷却现在是 (模型, 连接) 粒度的，而面板状态没有「当前模型」上下文，
+     * 这里默认**聚合**：只要该连接在任一模型上有活跃冷却，就显示 cooling=true
+     * （reason 带上具体模型），并在 `until` 给最长者。真实路由用 `pick` 的
+     * 模型级判定，不受此展示聚合影响。传 modelId 可只按该模型判定。
+     */
+    decorate(accounts: SupplierAccountNow[], modelId?: string): Array<SupplierAccountNow & {
         cooling: boolean;
         disabled: boolean;
         err_count: number;

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

@@ -117,6 +117,11 @@ export declare class Router {
      *  不再挨个问供应商「这是不是你的模型」——精准调用，也避免同名模型串台。
      *  兼容旧的裸 `modelId`（没有逗号）：降级为遍历，行为同以前。
      */
+    /**
+     * @param outTrace 可选出参：把这次调用的追踪信息带回去（组合据此判断
+     *   要不要「喘口气」再降级）。裸 id 遍历路径不填（多供应商混在一起，
+     *   失败状态没有单一归属）。
+     */
     private chatWithModel;
     /** 按别名找供应商（对外模型全名 = alias/model）。别名唯一，故最多命中一个。 */
     supplierByAlias(alias: string): Supplier | undefined;

package/lib/types/router/usage-store.d.ts

@@ -41,11 +41,28 @@ export declare class UsageStore {
         ts?: number;
     }, usage: Usage): void;
     private bump;
-    /** 窗口内的明细（today/24h 路径）。 */
-    private inWindow;
+    /**
+     * 从 `first` 起的 24 个小时格：每格带整点时间戳、所属自然日、那天的数据。
+     *
+     * `today` 传今天 00:00，`24h` 传「当前整点往前 23 格」。
+     * 跨天一律靠 `localDateKey(start)` 现算，不用「减 N 小时」去猜天数：
+     * 本地时区（尤其 DST）下小时偏移和自然日不是一回事，算错就漏一整天。
+     */
+    private hourSlots;
+    /** 今天的小时格起点（自然日零点）。 */
+    private static dayStartOf;
+    /** 24h 滚动窗口的小时格起点（当前整点往前 23 格）。 */
+    private static rollingStartOf;
+    /**
+     * 一整天的小时桶是否齐（各格之和 >= 天桶计数）。
+     *
+     * 不齐 = 这天是升级前落的盘（没有小时粒度）→ 24h 窗口踩到它就只能整桶计入。
+     * 宁可多算窗口外那截，也不能报一个比「今日」还小的数。
+     */
+    private static hoursComplete;
     /** 汇总 + Top 榜。 */
     stats(period: Period, now?: number): StatsResult;
-    /** 柱状图数据：today/24h = 24 个小时桶（走明细环），7d/30d = 天桶。 */
+    /** 柱状图数据：today/24h = 24 个小时桶，7d/30d = 天桶。 */
     chart(period: Period, now?: number): ChartBucket[];
     /** 最近请求明细。 */
     recentList(limit?: number): UsageRecord[];

package/lib/types/shared.d.ts

@@ -53,6 +53,8 @@ export interface RouterCheckinResponse {
     succeeded: number;
     /** 今日已签到的链接数（幂等成功）。 */
     already: number;
+    /** 失败/未开放的链接数。 */
+    failed: number;
     results?: Array<{
         uid: string;
         ok: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-router-core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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/RouterView.tsx

@@ -103,13 +103,21 @@ export function RouterView({ onBack }: RouterViewProps): JSX.Element {
               <section key={supplier.id} className="dshr-supplierCard" onClick={() => setDetailSupplier(supplier)}>
                 <div className="dshr-supplierRow">
                   {supplier.icon !== undefined && (
-                    <img className="dshr-supplierIcon" src={supplier.icon} alt="" />
+                    <img
+                      className="dshr-supplierIcon"
+                      src={supplier.icon}
+                      alt=""
+                      // 加载失败就藏起来（别留碎图）。图标不是关键信息，
+                      // 旁边有供应商名字。历史上的坑：icon 曾是
+                      // http://localhost:20128/... 这种外链，9router 没跑就全是坏图。
+                      onError={(e) => { e.currentTarget.style.display = 'none' }}
+                    />
                   )}
                   <div className="dshr-supplierName">{supplier.name}</div>
                 </div>
                 <div className="dshr-supplierMeta">
                   {supplierAccounts.length > 0 && (
-                    <span className="dshr-muted">{supplierAccounts.length}/{healthy} 健康</span>
+                    <span className="dshr-muted">{healthy}/{supplierAccounts.length} 健康</span>
                   )}
                   <span className="dshr-chevron">›</span>
                 </div>

package/src/client/SupplierDetail.tsx

@@ -184,20 +184,20 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
     setCheckingIn(true)
     try {
       const response = await fetch(`${ROUTER_API_BASE}/suppliers/${supplier.id}/checkin`, { method: 'POST', cache: 'no-store' })
-      const data = await response.json() as { ok: boolean; total: number; succeeded: number; already?: number; error?: string; results?: Array<{ uid: string; ok: boolean; status?: string; message?: string }> }
+      const data = await response.json() as { ok: boolean; total: number; succeeded: number; already?: number; failed?: number; error?: string; results?: Array<{ uid: string; ok: boolean; status?: string; message?: string }> }
+      // 核心口径（2026-09-02 修正）：有任一链接失败 → ok:false + HTTP 400。
+      // 别再用「签到完成」打头——部分失败会被 UI 吞成成功。
       if (data.ok && data.total > 0) {
-        // 真实语义：succeeded = 真正 claim 成功；already = 今日已签；其余 = 失败/未开放
-        const failed = (data.results ?? []).filter(r => r.status !== 'ok' && r.status !== 'already')
         let msg = `签到完成：${data.succeeded}/${data.total} 成功`
         const already = data.already ?? 0
         if (already > 0) msg += ` · ${already} 今日已签`
-        if (failed.length > 0) {
-          const first = failed[0]
-          msg += ` · ${first?.message ?? '有失败'}`
-        }
         showToast(msg)
       } else {
-        showToast(data.error ?? (data.total === 0 ? '没有可签到的链接' : '签到失败'))
+        const firstFail = (data.results ?? []).find(r => r.status !== 'ok' && r.status !== 'already')
+        const reason = firstFail ? `${firstFail.message ?? '有链接签到失败'}` : ''
+        const already = data.already ?? 0
+        const head = data.total > 0 ? `签到未完成：${data.succeeded}/${data.total} 成功` : '没有可签到的链接'
+        showToast(data.error ?? [head, already > 0 ? `${already} 今日已签` : '', reason].filter(Boolean).join(' · '))
       }
       onRefresh()
     } catch (err) {
@@ -560,7 +560,15 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
         <div className="dshr-providerTitleRow">
           <div className="dshr-providerIcon">
             {supplier.icon !== undefined
-              ? <img className="dshr-providerImg" src={supplier.icon} alt="" />
+              ? (
+                <img
+                  className="dshr-providerImg"
+                  src={supplier.icon}
+                  alt=""
+                  // 同上：失败就藏，露出备用图标位置（不显示碎图）
+                  onError={(e) => { e.currentTarget.style.display = 'none' }}
+                />
+              )
               : <Icon d={I.link} size={22} />}
           </div>
           <div className="dshr-providerMeta">