webaiapi 0.0.0-stage → 0.1.0

package/dist/controllers/request-pool.d.ts

@@ -0,0 +1,78 @@
+export type RequestStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/** 池中的一条请求记录。 */
+export interface PooledRequest {
+    request_id: string;
+    platform: string;
+    model: string;
+    message: string;
+    conversation_id: string | null;
+    status: RequestStatus;
+    created_at: number;
+    started_at: number | null;
+    completed_at: number | null;
+    result: string | null;
+    error: string | null;
+    /** 分配的账号 ID。 */
+    account_id: string | null;
+    /** 分配的浏览器实例 ID。 */
+    instance_id: string | null;
+}
+/** 池状态（`/v1/status` 用）。 */
+export interface RequestPoolStatus {
+    total_requests: number;
+    queue_size: number;
+    max_size: number;
+    status_counts: Record<RequestStatus, number>;
+}
+export declare class RequestPool {
+    private readonly maxSize;
+    private readonly requests;
+    private readonly pendingQueue;
+    private readonly lock;
+    constructor(maxSize?: number);
+    /** 添加请求到池中。 */
+    addRequest(params: {
+        requestId: string;
+        platform: string;
+        model: string;
+        message: string;
+        conversationId?: string | null;
+    }): Promise<PooledRequest>;
+    /** 标记请求为已完成。 */
+    markCompleted(requestId: string, result: string): Promise<void>;
+    /** 标记请求为失败。 */
+    markFailed(requestId: string, error: string): Promise<void>;
+    /** 当前队列长度。 */
+    getQueueSize(): number;
+    /** 池状态汇总。 */
+    getStatus(): RequestPoolStatus;
+}
+/**
+ * 智能调度器（负载视图）。
+ *
+ * ⚠️ 在 Python 版里这套负载计数**从来没有被写入过**（没人调用 increment/decrement），
+ * 所以 `getLoadStatus()` 一直返回两个空对象。这里保持同样的行为与字段形状，
+ * 免得 `/v1/status` 的消费方对不上。
+ */
+export declare class IntelligentScheduler {
+    private readonly instanceLoads;
+    private readonly accountLoads;
+    private readonly lock;
+    constructor();
+    /** 增加负载计数。 */
+    incrementLoad(instanceId: string, accountId: string): Promise<void>;
+    /** 减少负载计数（减到 0 就移除条目，与 Python 一致）。 */
+    decrementLoad(instanceId: string, accountId: string): Promise<void>;
+    /** 负载状态（供 `/v1/status` 展示）。 */
+    getLoadStatus(): {
+        instance_loads: Record<string, number>;
+        account_loads: Record<string, number>;
+    };
+}
+/** 获取请求池实例（单例）。 */
+export declare function getRequestPool(): RequestPool;
+/** 获取调度器实例（单例）。 */
+export declare function getScheduler(): IntelligentScheduler;
+/** 重置单例（测试用）。 */
+export declare function __setRequestPoolForTest(pool: RequestPool | null, sched: IntelligentScheduler | null): void;
+//# sourceMappingURL=request-pool.d.ts.map

package/dist/controllers/request-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-pool.d.ts","sourceRoot":"","sources":["../../src/controllers/request-pool.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E,iBAAiB;AACjB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CAC9C;AAkCD,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAE3D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IAEpC,YAA6B,OAAO,SAAM,EAGzC;IAED,eAAe;IACT,UAAU,CAAC,MAAM,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BzB;IAED,gBAAgB;IACV,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE;IAED,eAAe;IACT,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;IAED,cAAc;IACd,YAAY,IAAI,MAAM,CAErB;IAED,aAAa;IACb,SAAS,IAAI,iBAAiB,CAkB7B;CACF;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IAEpC,cAEC;IAED,cAAc;IACR,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;IAED,sCAAsC;IAChC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE;IAED,+BAA+B;IAC/B,aAAa,IAAI;QACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAKA;CACF;AAKD,mBAAmB;AACnB,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,mBAAmB;AACnB,wBAAgB,YAAY,IAAI,oBAAoB,CAGnD;AAED,iBAAiB;AACjB,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,KAAK,EAAE,oBAAoB,GAAG,IAAI,GACjC,IAAI,CAGN"}

package/dist/controllers/request-pool.js

@@ -0,0 +1,222 @@
+/**
+ * 请求池 —— `legacy-python/src/controllers/request_pool.py` 的移植。
+ *
+ * 用途：给**非流式**请求做一次「入池 → 完成/失败」的记账，
+ * 并把汇总状态暴露在 `/v1/status` 上（`total_requests` / `queue_size` /
+ * `status_counts`）。
+ *
+ * ## 有意不移植的部分（Python 里定义但从未被调用）
+ * - `RequestPool.get_next_request()` / `get_pending_request()` / `mark_processing()` /
+ *   `get_request()`：全仓库零调用。请求的「排队-取出」流程从来没跑过 ——
+ *   实际调度是 `_streamWithFailover()` 直接串行调用 Provider，池只做了记账。
+ * - `IntelligentScheduler.select_best_instance()`：零调用，而且它依赖的
+ *   `instance_loads` / `account_loads` 也**从来没有被增加过**
+ *   （`increment_load` / `decrement_load` 零调用），返回的永远是空字典。
+ *   这里保留 `getLoadStatus()`（`/v1/status` 需要这个字段形状）与
+ *   increment/decrement（成本极低、语义完整），只删掉那个永远选不出东西的选择器。
+ *
+ * ## 与原实现的差异
+ * - `asyncio.Queue(maxsize=N)` → {@link BoundedQueue}：`asyncio.Queue` 在满时
+ *   `await put()` 会**阻塞**；这里保留同样语义（满时等待），因为
+ *   `addRequest` 是 `await` 调用的。想改成「不阻塞直接丢弃」请先确认调用方。
+ * - `logging.success(...)` → `logger.info(...)`（pino 没有 success 级别）。
+ */
+import { logger } from '../log/logger.js';
+import { Mutex } from '../utils/mutex.js';
+/** 有界队列：满时 `put()` 等待（等价于 `asyncio.Queue(maxsize)`）。 */
+class BoundedQueue {
+    capacity;
+    items = [];
+    waiters = [];
+    constructor(capacity) {
+        this.capacity = capacity;
+    }
+    /** 入队（满时等待直到有空位）。 */
+    async put(item) {
+        while (this.items.length >= this.capacity) {
+            await new Promise((resolve) => this.waiters.push(resolve));
+        }
+        this.items.push(item);
+    }
+    /** 出队（空时返回 null，非阻塞）。 */
+    getNowait() {
+        const item = this.items.shift() ?? null;
+        if (item !== null && this.waiters.length > 0) {
+            // 让出一个空位，唤醒最早等待的写入者
+            const wake = this.waiters.shift();
+            wake?.();
+        }
+        return item;
+    }
+    get size() {
+        return this.items.length;
+    }
+}
+export class RequestPool {
+    maxSize;
+    requests = new Map();
+    pendingQueue;
+    lock = new Mutex();
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+        this.pendingQueue = new BoundedQueue(maxSize);
+        logger.info(`请求池初始化: max_size=${maxSize}`);
+    }
+    /** 添加请求到池中。 */
+    async addRequest(params) {
+        const release = await this.lock.acquire();
+        try {
+            const request = {
+                request_id: params.requestId,
+                platform: params.platform,
+                model: params.model,
+                message: params.message,
+                conversation_id: params.conversationId ?? null,
+                status: 'pending',
+                created_at: Date.now() / 1000,
+                started_at: null,
+                completed_at: null,
+                result: null,
+                error: null,
+                account_id: null,
+                instance_id: null,
+            };
+            this.requests.set(params.requestId, request);
+            await this.pendingQueue.put(request);
+            logger.info(`请求已加入池中: ${params.requestId}`);
+            return request;
+        }
+        finally {
+            release();
+        }
+    }
+    /** 标记请求为已完成。 */
+    async markCompleted(requestId, result) {
+        const release = await this.lock.acquire();
+        try {
+            const request = this.requests.get(requestId);
+            if (!request)
+                return;
+            request.status = 'completed';
+            request.completed_at = Date.now() / 1000;
+            request.result = result;
+            if (typeof request.started_at === 'number' && request.started_at > 0) {
+                const duration = request.completed_at - request.started_at;
+                logger.info(`请求完成: ${requestId}, 耗时: ${duration.toFixed(2)}s`);
+            }
+        }
+        finally {
+            release();
+        }
+    }
+    /** 标记请求为失败。 */
+    async markFailed(requestId, error) {
+        const release = await this.lock.acquire();
+        try {
+            const request = this.requests.get(requestId);
+            if (!request)
+                return;
+            request.status = 'failed';
+            request.completed_at = Date.now() / 1000;
+            request.error = error;
+            logger.error(`请求失败: ${requestId}, 错误: ${error}`);
+        }
+        finally {
+            release();
+        }
+    }
+    /** 当前队列长度。 */
+    getQueueSize() {
+        return this.pendingQueue.size;
+    }
+    /** 池状态汇总。 */
+    getStatus() {
+        const statusCounts = {
+            pending: 0,
+            processing: 0,
+            completed: 0,
+            failed: 0,
+        };
+        for (const request of this.requests.values()) {
+            statusCounts[request.status] += 1;
+        }
+        return {
+            total_requests: this.requests.size,
+            queue_size: this.getQueueSize(),
+            max_size: this.maxSize,
+            status_counts: statusCounts,
+        };
+    }
+}
+/**
+ * 智能调度器（负载视图）。
+ *
+ * ⚠️ 在 Python 版里这套负载计数**从来没有被写入过**（没人调用 increment/decrement），
+ * 所以 `getLoadStatus()` 一直返回两个空对象。这里保持同样的行为与字段形状，
+ * 免得 `/v1/status` 的消费方对不上。
+ */
+export class IntelligentScheduler {
+    instanceLoads = new Map();
+    accountLoads = new Map();
+    lock = new Mutex();
+    constructor() {
+        logger.info('智能调度器初始化');
+    }
+    /** 增加负载计数。 */
+    async incrementLoad(instanceId, accountId) {
+        const release = await this.lock.acquire();
+        try {
+            this.instanceLoads.set(instanceId, (this.instanceLoads.get(instanceId) ?? 0) + 1);
+            this.accountLoads.set(accountId, (this.accountLoads.get(accountId) ?? 0) + 1);
+            logger.debug(`增加负载: instance=${instanceId}, account=${accountId}`);
+        }
+        finally {
+            release();
+        }
+    }
+    /** 减少负载计数（减到 0 就移除条目，与 Python 一致）。 */
+    async decrementLoad(instanceId, accountId) {
+        const release = await this.lock.acquire();
+        try {
+            const inst = (this.instanceLoads.get(instanceId) ?? 0) - 1;
+            if (inst <= 0)
+                this.instanceLoads.delete(instanceId);
+            else
+                this.instanceLoads.set(instanceId, inst);
+            const acc = (this.accountLoads.get(accountId) ?? 0) - 1;
+            if (acc <= 0)
+                this.accountLoads.delete(accountId);
+            else
+                this.accountLoads.set(accountId, acc);
+            logger.debug(`减少负载: instance=${instanceId}, account=${accountId}`);
+        }
+        finally {
+            release();
+        }
+    }
+    /** 负载状态（供 `/v1/status` 展示）。 */
+    getLoadStatus() {
+        return {
+            instance_loads: Object.fromEntries(this.instanceLoads),
+            account_loads: Object.fromEntries(this.accountLoads),
+        };
+    }
+}
+let requestPool = null;
+let scheduler = null;
+/** 获取请求池实例（单例）。 */
+export function getRequestPool() {
+    requestPool ??= new RequestPool();
+    return requestPool;
+}
+/** 获取调度器实例（单例）。 */
+export function getScheduler() {
+    scheduler ??= new IntelligentScheduler();
+    return scheduler;
+}
+/** 重置单例（测试用）。 */
+export function __setRequestPoolForTest(pool, sched) {
+    requestPool = pool;
+    scheduler = sched;
+}
+//# sourceMappingURL=request-pool.js.map

package/dist/controllers/request-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-pool.js","sourceRoot":"","sources":["../../src/controllers/request-pool.ts"],"names":[],"mappings":"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"}

package/dist/controllers/router.d.ts

@@ -0,0 +1,172 @@
+import { type BaseProvider } from '../providers/base.js';
+/**
+ * 平台名作为独立模型暴露给用户：调用 `model=<平台名>` 时只调度该平台的 Provider，
+ * 不跨平台（与 `mix` 不同）。
+ *
+ * ⚠️ **本列表由 `browser/platforms.ts` 派生**（`providerImplemented: true` 的平台），
+ * 不再手写 —— 手写一份必然会和注册表写岔，而写岔的表现是
+ * 「菜单里有这个平台、但 `model=xxx` 报找不到模型」这类难查的问题。
+ *
+ * 目前只有 chatglm。DeepSeek/Kimi/Qianwen/Doubao/Zhipu 五个 Provider 已于
+ * 2026-10-12 删除（它们的 `_ensure_browser()` 调用从不存在的
+ * `browser_utils.ensure_browser_page()` → 一调用就 AttributeError，跨平台
+ * failover 实际上一直是失效的）。将来要加平台：实现 Provider →
+ * 在 `platforms.ts` 里把 `providerImplemented` 翻成 `true` →
+ * 在 {@link PROVIDER_FACTORIES} 加一行。有单测核对三者一致。
+ */
+export declare const PLATFORM_MODEL_NAMES: readonly string[];
+/**
+ * **真的**实现了工厂的平台。
+ *
+ * 存在的唯一理由：让「注册表的 `providerImplemented`」与「工厂表」能被**自动核对**
+ * （`PLATFORM_MODEL_NAMES` 是从 `providerImplemented` 派生的，拿它比对是自说自话）。
+ * 两者写岔的表现很难查：菜单里能看到这个平台、`model=xxx` 却报找不到模型。
+ *
+ * ⚠️ 不要在业务逻辑里用它挑平台 —— 那是 {@link PLATFORM_MODEL_NAMES} 的职责。
+ */
+export declare const PROVIDER_IMPLEMENTED_PLATFORMS: readonly string[];
+/** `mix` 候选三元组：`[providerName, provider, accountCount]`。 */
+export type MixCandidate = [name: string, provider: BaseProvider, accountCount: number];
+/** 账号总览条目（`/v1/status` 用）。 */
+export interface AccountSummaryItem {
+    account_id: string;
+    identity: string;
+    cookies: number;
+    roles: string[];
+    cooldown_seconds: number;
+    busy: boolean;
+}
+export declare class ModelRouter {
+    /** Provider 注册表（键 = 平台名）。 */
+    readonly providers: Map<string, BaseProvider>;
+    /** 模型名 → Provider 名。 */
+    readonly modelToProvider: Map<string, string>;
+    /**
+     * 辅助通道 Provider（**平台 → 实例**）。
+     *
+     * 辅助任务（后台预压缩等）用的「另一个账号 + 独立 context 的专用页面」。
+     * 有了它辅助任务才能与主对话**同时**跑。为空时辅助任务回落到主通道（串行，原行为）。
+     */
+    readonly auxProviders: Map<string, BaseProvider>;
+    private auxLastScan;
+    /**
+     * 目前只有 ChatGLM 的 Provider 实现了「通道页面」（`channelKey`）。
+     * 其他平台为什么没启用，见 {@link getAuxCandidates} 的说明。
+     */
+    private static readonly AUX_CHANNEL_PLATFORMS;
+    /** 运行中惰性重扫辅助通道的最小间隔（秒）：登录完第二个账号后**免重启**。 */
+    private static readonly AUX_RESCAN_INTERVAL;
+    constructor(options?: {
+        verbose?: boolean;
+    });
+    /**
+     * 启动时**随机**挑一个账号做主通道（另一个留给辅助通道）。
+     *
+     * 为什么要随机：主通道是用户对话的主力。如果永远固定用 `default`，
+     * 那个账号会先被限流/耗尽额度，而另一个账号一直闲着。随机分配把负载摊到两个账号上。
+     *
+     * 可用 `CHATGLM_MAIN_ACCOUNT=<id>` 钉死（运维需要时避免每次重启换主力账号）。
+     */
+    static pickRandomMainAccount(platform: string): string;
+    /** 注册所有 Browser Provider。 */
+    private registerProviders;
+    /** 注册 Provider，并把它声明的所有模型登记进 `modelToProvider`。 */
+    registerProvider(name: string, provider: BaseProvider): void;
+    /** 取凭证的账号身份标识（用于判断「是不是同一个账号」）。 */
+    private static identityOf;
+    /** Cookie 指纹（把两个凭证文件其实是同一登录会话的情况识别出来）。 */
+    private static cookieFingerprintOf;
+    /** 主通道**当前**用的账号（provider 被限流换号后这里会跟着变）。 */
+    private currentMainAccount;
+    /** 该账号是否归主通道使用（避免辅助通道和主通道撞同一个账号）。 */
+    private isAccountOwnedByMain;
+    /**
+     * 为辅助通道挑选「与主通道**不同账号**」的凭证。
+     *
+     * 策略：**优先同平台的第二个账号**；没有则暂不启用
+     * （其他平台的独立通道尚未实现，原因见 {@link getAuxCandidates}）。
+     *
+     * @param verbose 没有通道时是否打日志。启动时 true；运行中惰性重扫时 false，
+     *   避免每分钟刷一条「未启用」。
+     */
+    private setupAuxChannels;
+    /**
+     * 辅助任务（压缩 / 两轮转换等）可用的通道列表。
+     *
+     * 顺序与理由：
+     * 1. **同平台的第二个账号**（独立通道）—— 不同账号、不同页面、不同锁，
+     *    可以与主对话真正并行，且不占用主账号的并发额度。
+     * 2. 其他平台 —— **当前不存在**：原先那批 Provider 都用**全局共享页面**
+     *    （`playwright_manager._page`），与主通道并行会互相劫持页面（这是架构问题，
+     *    不是额度问题），且实现差异很大（例如会把消息截断到 8000 字符，
+     *    而压缩动辄几万字符 → 必然被截断损坏）。它们已于 2026-10-12 整体删除。
+     *    将来新增平台要启用辅助通道：先实现 `channelKey` 独立 context 页面，
+     *    再把平台名加进 {@link AUX_CHANNEL_PLATFORMS}。
+     * 3. 调用方拿不到候选时**回落到主候选**（同账号同页面 → 与主对话串行），
+     *    保证功能不退化。
+     *
+     * @returns 三元组列表；空列表表示没有独立通道可用，调用方应回落主候选。
+     */
+    getAuxCandidates(): MixCandidate[];
+    /**
+     * 账号总览：每个平台的账号、身份、以及它被用作 main / aux 还是闲置。
+     *
+     * 用途：把「多账号到底有没有生效」变成可验证的事实（`/v1/status`）。
+     * 实测踩坑：登录了两个账号但其实是同一个（浏览器里还是旧账号的登录态），
+     * 只看「账号数」看不出来，看身份才能。
+     */
+    getAccountsSummary(): Record<string, AccountSummaryItem[]>;
+    /**
+     * 根据模型名取 Provider。
+     *
+     * 策略：
+     * - `mix`：跨平台调度，按优先级依次尝试各平台；
+     * - 平台名（如 `chatglm`）：直接返回该平台的 Provider；
+     * - 具体模型名（如 `glm-4`）：映射到对应平台的 Provider。
+     *
+     * @throws {ModelNotFoundError} 模型不可用 / 凭证失效
+     */
+    getProvider(model: string): Promise<BaseProvider>;
+    /** 自动选择最优 Provider（`mix`：按优先级取第一个候选）。 */
+    getBestProvider(): Promise<BaseProvider>;
+    /**
+     * `mix` 模式的候选 Provider 列表。
+     *
+     * ## ⚠️ 排序与兜底（2026-09-29 修正，不可回退）
+     * 1. **平台优先顺序固定按 {@link PLATFORM_MODEL_NAMES}**（chatglm 第一）。
+     *    登录检查的结果**只用来告警，不决定谁先谁后，更不能把平台整体剔除**。
+     *    原因：chatglm 的 `checkLoginStatus()` 是**整页 DOM 探测**，刚重启 / 页面未就绪
+     *    时会误判「未登录」。若按「已验证优先」排序，一次探测抖动就会把 chatglm
+     *    排到后面甚至完全丢失 —— 2026-09-29 22:46 实测：`model=mix` 直接打到了
+     *    （当时还注册着、但从来不可用的）deepseek/kimi，报
+     *    `browser_utils has no attribute ensure_browser_page`，chatglm 压根没被尝试。
+     *    （那批坏 Provider 已于 2026-10-12 删除，但这条规则仍要遵守：将来新增平台时
+     *    同样的抖动还会发生。）
+     * 2. **有账号的平台全部保留**（未通过登录检查的排在同优先级之后），
+     *    避免一次误判导致「所有平台均不可用」。
+     */
+    getMixCandidates(): Promise<MixCandidate[]>;
+    /** 所有已注册的模型名（来自各 Provider 的 `getModels()`）。 */
+    getAllModels(): string[];
+    /** 模型别名对应的平台名（未登记返回 `undefined`）。 */
+    platformOfModel(model: string): string | undefined;
+    /**
+     * 检查模型是否可用。
+     *
+     * ## ⚠️ 这里曾与 {@link registerProvider} 自相矛盾（实测踩过）
+     * 启动日志明明打了「注册模型: glm-4 -> chatglm」，请求 `model=glm-4` 却报
+     * 「模型 'glm-4' 不存在或不可用」—— 因为旧实现只看 `mix` / 平台名 /
+     * `AVAILABLE_MODELS`，而 `AVAILABLE_MODELS` 的**默认值是 `'mix'`**，
+     * 别名根本不在清单里。修复后以**登记表为准**：启动时真的注册了的模型就能路由。
+     */
+    isModelAvailable(modelId: string): boolean;
+    /** 已登录（有凭证）的平台名列表，作为可调用的独立模型。 */
+    getAvailablePlatformModels(): string[];
+    /** 所有 Provider（键 = 平台名）。 */
+    getAllProviders(): Map<string, BaseProvider>;
+}
+/** 获取全局模型路由器实例（单例）。 */
+export declare function getModelRouter(): ModelRouter;
+/** 重置单例（测试用）。 */
+export declare function __setModelRouterForTest(router: ModelRouter | null): void;
+//# sourceMappingURL=router.d.ts.map

package/dist/controllers/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/controllers/router.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAA4B,CAAC;AAe/E;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAAoC,CAAC;AAEjG,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAExF,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,WAAW;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,4BAAmC;IAErD,wBAAwB;IACxB,QAAQ,CAAC,eAAe,sBAA6B;IAErD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,4BAAmC;IAExD,OAAO,CAAC,WAAW,CAAK;IAIxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAE/E,4CAA4C;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;IAEjD,YAAY,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,EAG9C;IAMD;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBrD;IAED,6BAA6B;IAC7B,OAAO,CAAC,iBAAiB;IAOzB,mDAAmD;IACnD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAM3D;IAMD,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAC,UAAU;IAKzB,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC,4CAA4C;IAC5C,OAAO,CAAC,kBAAkB;IAI1B,qCAAqC;IACrC,OAAO,CAAC,oBAAoB;IAK5B;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAoFxB;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,IAAI,YAAY,EAAE,CAmDjC;IAED;;;;;;OAMG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAmCzD;IAMD;;;;;;;;;OASG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoDtD;IAED,yCAAyC;IACnC,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAW7C;IAED;;;;;;;;;;;;;;;OAeG;IACG,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CA+DhD;IAED,+CAA+C;IAC/C,YAAY,IAAI,MAAM,EAAE,CAEvB;IAED,qCAAqC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjD;IAED;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBzC;IAED,iCAAiC;IACjC,0BAA0B,IAAI,MAAM,EAAE,CAUrC;IAED,4BAA4B;IAC5B,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE3C;CACF;AAID,uBAAuB;AACvB,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,iBAAiB;AACjB,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAExE"}