webaiapi 0.0.0-stage → 0.1.0

package/dist/routes/meta.js

@@ -0,0 +1,184 @@
+import { getAvailableModelsList, settings } from '../config.js';
+import { getHistoryDb } from '../controllers/history-db.js';
+import { getRequestPool, getScheduler } from '../controllers/request-pool.js';
+import { getModelRouter } from '../controllers/router.js';
+import { logger } from '../log/logger.js';
+import { makeModelInfo } from '../types/openai.js';
+/**
+ * 注册元信息路由。
+ *
+ * ⚠️ 路由前缀由调用方在 Fastify 注册时给出（`settings.apiPrefix`，
+ * 默认 `/v1`），所以这里的路径都不带 `/v1`。
+ */
+export function registerMetaRoutes(app) {
+    /**
+     * 可用模型列表（OpenAI 兼容）。
+     *
+     * 由两部分组成：
+     * 1. 配置里的对外展示模型（`AVAILABLE_MODELS`，默认 `mix`）；
+     * 2. **已捕获凭证的平台名**作为独立模型（动态：用户捕获了哪个平台，
+     *    就能直接调用该平台名）。
+     *
+     * 调用平台名模型时只调度对应平台，不跨平台（与 `mix` 不同）。
+     */
+    app.get('/models', async () => {
+        const modelRouter = getModelRouter();
+        const modelList = [];
+        const seenIds = new Set();
+        for (const modelId of getAvailableModelsList()) {
+            // 支持 `model:platform` 格式
+            let model;
+            let platform;
+            if (modelId.includes(':')) {
+                const idx = modelId.indexOf(':');
+                model = modelId.slice(0, idx);
+                platform = modelId.slice(idx + 1);
+            }
+            else {
+                model = modelId;
+                platform = 'unknown';
+            }
+            if (seenIds.has(model))
+                continue;
+            seenIds.add(model);
+            modelList.push(makeModelInfo(model, platform));
+        }
+        // 追加已登录平台名作为独立模型
+        for (const platform of modelRouter.getAvailablePlatformModels()) {
+            if (seenIds.has(platform))
+                continue;
+            seenIds.add(platform);
+            modelList.push(makeModelInfo(platform, platform));
+        }
+        // 追加 Provider 登记过的模型别名（glm-4 / glm-3 → chatglm）。
+        // ⚠️ 不加这段的话，`/v1/models` 与实际可用性**对不上**：
+        //    `model=glm-4` 能用（isModelAvailable 以登记表为准），列表里却没有它 ——
+        //    OpenAI 兼容客户端会先拉列表再让用户挑，挑不到就等于没有这个功能。
+        for (const model of modelRouter.getAllModels()) {
+            if (seenIds.has(model))
+                continue;
+            seenIds.add(model);
+            modelList.push(makeModelInfo(model, modelRouter.platformOfModel(model) ?? 'unknown'));
+        }
+        return { object: 'list', data: modelList };
+    });
+    /**
+     * 健康检查。
+     *
+     * ⚠️ 这里会**逐个**调用 `checkLoginStatus()`（chatglm 的是整页 DOM 探测）。
+     * 它内部有 120s 的「已登录」缓存，所以正常轮询不会每次都做整页导航。
+     */
+    app.get('/health', async () => {
+        const modelRouter = getModelRouter();
+        const providerStatus = {};
+        for (const [name, provider] of modelRouter.getAllProviders()) {
+            try {
+                const isLoggedIn = await provider.checkLoginStatus();
+                providerStatus[name] = { status: isLoggedIn ? 'connected' : 'disconnected' };
+            }
+            catch (error) {
+                providerStatus[name] = { status: 'error', message: String(error) };
+            }
+        }
+        return {
+            status: 'ok',
+            version: settings.appVersion,
+            providers: providerStatus,
+        };
+    });
+    /**
+     * 系统状态。
+     *
+     * 「账号与辅助通道」这一段是把**多账号到底有没有生效**变成可验证的事实。
+     * 实测踩坑：登录了两个账号但其实是同一个（浏览器里还是旧账号登录态），
+     * 只看「账号数」看不出来，得看身份与角色。
+     */
+    app.get('/status', async () => {
+        const requestPool = getRequestPool();
+        const scheduler = getScheduler();
+        const modelRouter = getModelRouter();
+        let accountsSummary = {};
+        let auxChannel = { enabled: false };
+        try {
+            accountsSummary = modelRouter.getAccountsSummary();
+            const aux = modelRouter.getAuxCandidates();
+            const first = aux[0];
+            if (first) {
+                const [auxName, auxProvider] = first;
+                const auxAccountId = auxProvider.getAccountId();
+                auxChannel = {
+                    enabled: true,
+                    platform: auxName,
+                    account_id: auxAccountId,
+                    identity: accountsSummary[auxName]?.find((a) => a.account_id === auxAccountId)?.identity ?? '',
+                };
+            }
+        }
+        catch (error) {
+            auxChannel = { enabled: false, error: String(error) };
+        }
+        return {
+            request_pool: requestPool.getStatus(),
+            scheduler: scheduler.getLoadStatus(),
+            accounts: accountsSummary,
+            aux_channel: auxChannel,
+        };
+    });
+}
+/**
+ * 启动时的日志重置与历史库自检。
+ *
+ * ⚠️ 与原实现的差异：Python 是**覆盖写** `logs/api_requests.log` 并写入一行
+ * `# API 请求日志 - <时间> 启动`；TS 侧由 `resetApiLog()` 清空（保持「原样记录、
+ * 不加工」的契约 —— 头部注释会干扰对日志的 `grep`）。
+ *
+ * 历史库清理是**异步**的，日志里会带上统计数字。
+ */
+export async function runStartupTasks() {
+    logger.info(`启动 ${settings.appName} v${settings.appVersion}`);
+    logger.info(`调试模式: ${String(settings.debug)}`);
+    logger.info(`API 地址: http://${settings.apiHost}:${settings.apiPort}${settings.apiPrefix}`);
+    try {
+        const historyDb = getHistoryDb();
+        const deleted = await historyDb.cleanupOld();
+        const stats = await historyDb.stats();
+        logger.info(`历史数据库: ${stats.total_messages} 条消息, ` +
+            `${stats.conversations} 个会话, TTL=${stats.ttl_days}天` +
+            (deleted > 0 ? `（启动清理 ${deleted} 条过期）` : '') +
+            (historyDb.available ? '' : '（⚠️ 已降级为无历史模式）'));
+    }
+    catch (error) {
+        logger.error(`启动清理历史消息失败: ${String(error)}`);
+    }
+}
+/**
+ * 后台定期清理历史消息（每 1 小时一次）。
+ *
+ * 返回一个可取消的句柄（关服时调用 `stop()`）。
+ */
+export function startPeriodicHistoryCleanup(intervalMs = 3600_000) {
+    let stopped = false;
+    const timer = setInterval(() => {
+        if (stopped)
+            return;
+        void (async () => {
+            try {
+                const deleted = await getHistoryDb().cleanupOld();
+                if (deleted > 0)
+                    logger.info(`定期清理历史消息: 清理 ${deleted} 条过期消息`);
+            }
+            catch (error) {
+                logger.error(`定期清理历史消息失败: ${String(error)}`);
+            }
+        })();
+    }, intervalMs);
+    // 不要因为这个定时器而阻塞进程退出
+    timer.unref?.();
+    return {
+        stop: () => {
+            stopped = true;
+            clearInterval(timer);
+        },
+    };
+}
+//# sourceMappingURL=meta.js.map

package/dist/routes/meta.js.map

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

package/dist/routes/sse.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OpenAI 兼容的 SSE 分片构造 —— 从 `legacy-python/src/api/routes.py` 的
+ * `chat_completions` 里抽出的公共部分。
+ *
+ * ⚠️ 两条必须遵守的格式约束：
+ * 1. **`tool_calls` 分片必须在 `data: [DONE]` 之前发出**。客户端（CodeBuddy/Trae）
+ *    是收到 `[DONE]` 就结束本轮解析的，之后发的一律丢弃。
+ * 2. **`finish_reason` 只能出现一次**，且在最后一个内容分片里；
+ *    带 `tool_calls` 时必须是 `"tool_calls"` 而不是 `"stop"`
+ *    （否则客户端会把这一轮当成"已答完"，不去执行工具）。
+ */
+import type { ToolCallPayload } from '../types/message.js';
+/** SSE 结束标记。 */
+export declare const DONE = "data: [DONE]\n\n";
+/** 分片里的 delta。 */
+export interface ChunkDelta {
+    role?: string;
+    content?: string;
+    tool_calls?: Array<Record<string, unknown>>;
+}
+/** 一个 `chat.completion.chunk`。 */
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: ChunkDelta;
+        finish_reason: string | null;
+    }>;
+}
+/**
+ * 把对象序列化成一条 SSE 消息。
+ *
+ * ⚠️ 用 `JSON.stringify` 而非任何「美化」输出：客户端按行解析。
+ * 中文**不需要**转义（JS 的 `JSON.stringify` 默认输出原字符，
+ * 等价于 Python 的 `ensure_ascii=False`）。
+ */
+export declare function sseData(payload: unknown): string;
+/** 当前 Unix 时间戳（秒）。 */
+export declare function nowSeconds(now?: number): number;
+/**
+ * 构造一个内容分片。
+ *
+ * ⚠️ 与 Python 的差异：Python 用 `int(asyncio.get_event_loop().time())` 填 `created`
+ * （那是**单调时钟**，值很小，属于历史遗留的笔误）。这里改用真正的 Unix 时间戳；
+ * `created` 字段客户端不解析，改成正确值只会有益无害。
+ */
+export declare function contentChunk(params: {
+    id: string;
+    model: string;
+    content: string;
+    role?: string;
+    finishReason?: string | null;
+    created?: number;
+}): string;
+/**
+ * 构造工具调用分片。
+ *
+ * OpenAI 的流式工具调用是分片的（`index` + `function.arguments` 增量），
+ * 但**客户端普遍接受一次性发完整 arguments**，而本项目一次性解析完再发
+ * （见 `chat_completions` 的「先缓冲完整回复，解析 tool_calls 后再发送」）。
+ * 因此这里一次性发出全部，`finish_reason` 为 `"tool_calls"`。
+ */
+export declare function toolCallsChunk(params: {
+    id: string;
+    model: string;
+    toolCalls: ReadonlyArray<ToolCallPayload>;
+    created?: number;
+}): string;
+/**
+ * 构造「首片」分片（只有 role，没有内容）。
+ *
+ * OpenAI 的流式响应第一片固定是 `{"role":"assistant"}`，客户端据此初始化消息。
+ */
+export declare function roleChunk(params: {
+    id: string;
+    model: string;
+    created?: number;
+}): string;
+//# sourceMappingURL=sse.d.ts.map

package/dist/routes/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/routes/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,gBAAgB;AAChB,eAAO,MAAM,IAAI,qBAAqB,CAAC;AAEvC,kBAAkB;AAClB,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7C;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,UAAU,CAAC;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,sBAAsB;AACtB,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAuBT;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF"}

package/dist/routes/sse.js

@@ -0,0 +1,77 @@
+/** SSE 结束标记。 */
+export const DONE = 'data: [DONE]\n\n';
+/**
+ * 把对象序列化成一条 SSE 消息。
+ *
+ * ⚠️ 用 `JSON.stringify` 而非任何「美化」输出：客户端按行解析。
+ * 中文**不需要**转义（JS 的 `JSON.stringify` 默认输出原字符，
+ * 等价于 Python 的 `ensure_ascii=False`）。
+ */
+export function sseData(payload) {
+    return `data: ${JSON.stringify(payload)}\n\n`;
+}
+/** 当前 Unix 时间戳（秒）。 */
+export function nowSeconds(now = Date.now()) {
+    return Math.floor(now / 1000);
+}
+/**
+ * 构造一个内容分片。
+ *
+ * ⚠️ 与 Python 的差异：Python 用 `int(asyncio.get_event_loop().time())` 填 `created`
+ * （那是**单调时钟**，值很小，属于历史遗留的笔误）。这里改用真正的 Unix 时间戳；
+ * `created` 字段客户端不解析，改成正确值只会有益无害。
+ */
+export function contentChunk(params) {
+    const { id, model, content, role, finishReason = null, created } = params;
+    const delta = {};
+    if (role !== undefined)
+        delta.role = role;
+    if (content)
+        delta.content = content;
+    return sseData({
+        id,
+        object: 'chat.completion.chunk',
+        created: created ?? nowSeconds(),
+        model,
+        choices: [{ index: 0, delta, finish_reason: finishReason }],
+    });
+}
+/**
+ * 构造工具调用分片。
+ *
+ * OpenAI 的流式工具调用是分片的（`index` + `function.arguments` 增量），
+ * 但**客户端普遍接受一次性发完整 arguments**，而本项目一次性解析完再发
+ * （见 `chat_completions` 的「先缓冲完整回复，解析 tool_calls 后再发送」）。
+ * 因此这里一次性发出全部，`finish_reason` 为 `"tool_calls"`。
+ */
+export function toolCallsChunk(params) {
+    const { id, model, toolCalls, created } = params;
+    const payload = toolCalls.map((tc, index) => ({
+        index,
+        id: tc.id,
+        type: 'function',
+        function: { name: tc.function.name, arguments: tc.function.arguments },
+    }));
+    return sseData({
+        id,
+        object: 'chat.completion.chunk',
+        created: created ?? nowSeconds(),
+        model,
+        choices: [
+            {
+                index: 0,
+                delta: { tool_calls: payload },
+                finish_reason: 'tool_calls',
+            },
+        ],
+    });
+}
+/**
+ * 构造「首片」分片（只有 role，没有内容）。
+ *
+ * OpenAI 的流式响应第一片固定是 `{"role":"assistant"}`，客户端据此初始化消息。
+ */
+export function roleChunk(params) {
+    return contentChunk({ ...params, content: '', role: 'assistant' });
+}
+//# sourceMappingURL=sse.js.map

package/dist/routes/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/routes/sse.ts"],"names":[],"mappings":"AAaA,gBAAgB;AAChB,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAsBvC;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,UAAU,CAAC,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAO5B;IACC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC1E,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1C,IAAI,OAAO;QAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAErC,OAAO,OAAO,CAAC;QACb,EAAE;QACF,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE;QAChC,KAAK;QACL,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAK9B;IACC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5C,KAAK;QACL,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;KACvE,CAAC,CAAC,CAAC;IAEJ,OAAO,OAAO,CAAC;QACb,EAAE;QACF,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE;QAChC,KAAK;QACL,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE,UAAU,EAAE,OAAoD,EAAE;gBAC3E,aAAa,EAAE,YAAY;aAC5B;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAuD;IAC/E,OAAO,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/server/app.d.ts

@@ -0,0 +1,24 @@
+import { type FastifyInstance } from 'fastify';
+/**
+ * 初始化 API Key 管理器。
+ *
+ * 与 Python `main()` 的语义一致：**没有配置任何密钥时视为禁用认证**
+ * （即使 `API_KEY_REQUIRED=true` 也不拦 —— 否则等于把自己锁在门外）。
+ */
+export declare function initApiKeys(): void;
+/**
+ * 创建 Fastify 应用（不监听端口）。
+ *
+ * 中间件顺序与原实现一致：CORS → 超时 → 限流 → 认证 → 路由。
+ */
+export declare function createApp(): Promise<FastifyInstance>;
+/**
+ * 启动服务并阻塞直到进程收到退出信号。
+ *
+ * @returns 进程退出码：`0` 正常 / `1` 启动失败（如端口被占用）。
+ *   ⚠️ 返回退出码而不是在函数里设 `process.exitCode` —— CLI 侧的
+ *   `process.exitCode = await runCli()` 会覆盖它（实测踩过：报错信息是对的，
+ *   退出码却是 0，脚本会误判成功）。
+ */
+export declare function startServer(): Promise<number>;
+//# sourceMappingURL=app.d.ts.map

package/dist/server/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAqBA,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAmBxD;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAgBlC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAiH1D;AA6CD;;;;;;;GAOG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CA8FnD"}