webaiapi 0.0.0-stage → 0.1.0

package/dist/log/debug-logger.js

@@ -0,0 +1,285 @@
+/**
+ * 调试日志 —— `legacy-python/src/utils/debug_logger.py` 的移植。
+ *
+ * 仅当 `DEBUG_LOGS=true` 时写入，输出到 `~/.ai-api/logs/debug_YYYYMMDD.log`。
+ *
+ * 与 `api-logger.ts` 的分工（**不要混**）：
+ * - `api-logger` 写**项目内** `logs/api_requests.log`，**原样、不截断**，每次启动重置；
+ * - `debug-logger` 写**用户目录** `~/.ai-api/logs/`，**带截断**（500/300/200 字符），
+ *   按天分文件、跨重启累积。前者是「事实记录」，后者是「排查辅助」。
+ *
+ * 与原实现的差异：
+ * - Python 的 `@lru_cache(maxsize=1)` 在 TS 里没有直接对应物；这里改用
+ *   **惰性 + 可重置的模块级缓存**（`resetDebugLoggerCache()` 供测试用），
+ *   语义等价（首次调用时定值，且 config 变更后测试可重置）。
+ * - 时间戳 `%H:%M:%S.%f`[:-3] → `HH:mm:ss.SSS`。
+ */
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { settings } from '../config.js';
+/* ------------------------------------------------------------------ */
+/* 缓存                                                                */
+/* ------------------------------------------------------------------ */
+let cachedLogDir = null;
+let cachedEnabled = null;
+/** 重置缓存（测试用；对应 Python 的 `lru_cache` 失效）。 */
+export function resetDebugLoggerCache() {
+    cachedLogDir = null;
+    cachedEnabled = null;
+}
+/** 日志目录：`~/.ai-api/logs`。 */
+function debugLogDir() {
+    if (cachedLogDir === null) {
+        cachedLogDir = join(homedir(), '.ai-api', 'logs');
+    }
+    return cachedLogDir;
+}
+/** 是否启用调试日志。 */
+function isEnabled() {
+    if (cachedEnabled === null) {
+        try {
+            cachedEnabled = Boolean(settings.debugLogs);
+        }
+        catch {
+            cachedEnabled = (process.env['DEBUG_LOGS'] ?? 'false').toLowerCase() === 'true';
+        }
+    }
+    return cachedEnabled;
+}
+/** `debug_YYYYMMDD.log` 的绝对路径。 */
+export function debugLogPath(date = new Date()) {
+    const p = (n) => String(n).padStart(2, '0');
+    const stamp = `${date.getFullYear()}${p(date.getMonth() + 1)}${p(date.getDate())}`;
+    return join(debugLogDir(), `debug_${stamp}.log`);
+}
+/** `HH:mm:ss.SSS`（Python 的 `%H:%M:%S.%f` 取前 3 位）。 */
+function timeOnly(date = new Date()) {
+    const p = (n, width = 2) => String(n).padStart(width, '0');
+    return (`${p(date.getHours())}:${p(date.getMinutes())}:${p(date.getSeconds())}.` +
+        `${p(date.getMilliseconds(), 3)}`);
+}
+/** 截断过长文本（与原实现一致：追加 `... (共 N 字符)`）。 */
+function truncate(text, maxLen = 500) {
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen)}... (共 ${text.length} 字符)`;
+}
+/** 追加写（失败静默）。 */
+function append(lines) {
+    try {
+        mkdirSync(debugLogDir(), { recursive: true });
+        appendFileSync(debugLogPath(), `${lines.join('\n')}\n`, 'utf8');
+    }
+    catch {
+        // 调试日志失败绝不能影响主流程
+    }
+}
+/** 格式化消息列表（每条截断到 `maxEach`）。 */
+function formatMessages(messages, maxEach = 300) {
+    const parts = [];
+    messages.forEach((msg, i) => {
+        const role = typeof msg['role'] === 'string' ? msg['role'] : '?';
+        const rawContent = msg['content'];
+        const content = Array.isArray(rawContent)
+            ? JSON.stringify(rawContent).slice(0, maxEach)
+            : truncate(String(rawContent ?? ''), maxEach);
+        let tcInfo = '';
+        const toolCalls = msg['tool_calls'];
+        if (Array.isArray(toolCalls) && toolCalls.length > 0) {
+            const names = toolCalls.map((tc) => {
+                const fn = tc?.['function'];
+                return typeof fn?.['name'] === 'string' ? fn['name'] : '?';
+            });
+            tcInfo = ` [tool_calls: ${names.join(', ')}]`;
+        }
+        // ⚠️ 注意原实现的行为：`tool_call_id` 存在时会**覆盖**掉 `tool_calls` 信息
+        //    （是同名变量被重新赋值，看起来像 bug，但保持一致以免日志对照时困惑）
+        const toolCallId = msg['tool_call_id'];
+        if (typeof toolCallId === 'string' && toolCallId) {
+            tcInfo = ` [tool_call_id: ${toolCallId}]`;
+        }
+        parts.push(`  [${i}] ${role}${tcInfo}: ${content}`);
+    });
+    return parts.join('\n');
+}
+/** 格式化工具调用（`arguments` 尽量解析成对象再序列化，失败则原样截断）。 */
+function formatToolCalls(toolCalls, maxArgs = 200) {
+    const parts = [];
+    for (const tc of toolCalls) {
+        const fn = (tc['function'] ?? {});
+        const name = typeof fn['name'] === 'string' ? fn['name'] : '?';
+        let argsStr;
+        const rawArgs = fn['arguments'];
+        if (typeof rawArgs === 'string') {
+            try {
+                argsStr = JSON.stringify(JSON.parse(rawArgs));
+            }
+            catch {
+                argsStr = rawArgs;
+            }
+        }
+        else {
+            try {
+                argsStr = JSON.stringify(rawArgs ?? {});
+            }
+            catch {
+                argsStr = String(rawArgs);
+            }
+        }
+        parts.push(`  - ${name}: ${truncate(argsStr, maxArgs)}`);
+    }
+    return parts.join('\n');
+}
+/* ------------------------------------------------------------------ */
+/* 公开接口                                                            */
+/* ------------------------------------------------------------------ */
+/** 记录客户端请求。 */
+export function logClientRequest(params) {
+    if (!isEnabled())
+        return;
+    const { requestId, model, messages, stream = true, tools, extra } = params;
+    const lines = [
+        `[${timeOnly()}] [>>> 客户端请求] [${requestId}]`,
+        `  模型: ${model} | 流式: ${stream}`,
+        `  消息数: ${messages.length}`,
+    ];
+    if (tools && tools.length > 0) {
+        const names = tools.map((t) => {
+            const fn = t['function'];
+            return typeof fn?.['name'] === 'string' ? fn['name'] : '?';
+        });
+        lines.push(`  工具数: ${tools.length} | 工具: ${names.slice(0, 10).join(', ')}` +
+            (names.length > 10 ? '...' : ''));
+    }
+    lines.push('  消息内容:');
+    lines.push(formatMessages(messages));
+    if (extra) {
+        const keys = Object.keys(extra).filter((k) => !['model', 'messages', 'stream', 'tools'].includes(k));
+        if (keys.length > 0) {
+            const picked = {};
+            for (const k of keys)
+                picked[k] = extra[k];
+            lines.push(`  额外参数: ${safeJson(picked)}`);
+        }
+    }
+    lines.push('');
+    append(lines);
+}
+/** 记录返回给客户端的响应。 */
+export function logClientResponse(params) {
+    if (!isEnabled())
+        return;
+    const { requestId, model, finishReason, content, toolCalls, duration = 0 } = params;
+    const lines = [
+        `[${timeOnly()}] [<<< 客户端响应] [${requestId}]`,
+        `  模型: ${model} | 完成原因: ${finishReason} | 耗时: ${duration.toFixed(1)}s`,
+    ];
+    if (content)
+        lines.push(`  文本内容: ${truncate(content, 500)}`);
+    if (toolCalls && toolCalls.length > 0) {
+        lines.push(`  工具调用数: ${toolCalls.length}`);
+        lines.push('  工具调用:');
+        lines.push(formatToolCalls(toolCalls));
+    }
+    lines.push('');
+    append(lines);
+}
+/** 记录发送给网页 AI 的内容。 */
+export function logAiRequest(params) {
+    if (!isEnabled())
+        return;
+    const { requestId, platform, messages, workspacePath } = params;
+    const lines = [
+        `[${timeOnly()}] [>>> 发送给AI] [${requestId}] 平台=${platform}`,
+        `  工作目录: ${workspacePath || '(未设置)'}`,
+        `  消息数: ${messages.length}`,
+        '  消息内容:',
+    ];
+    for (const msg of messages) {
+        const role = typeof msg['role'] === 'string' ? msg['role'] : '?';
+        const content = msg['content'];
+        const text = String(content ?? '');
+        if (role === 'system') {
+            lines.push(`  [system] (${text.length} 字符): ${truncate(text, 800)}`);
+        }
+        else if (role === 'user') {
+            lines.push(`  [user]: ${truncate(text, 300)}`);
+        }
+        else if (role === 'assistant') {
+            const tc = msg['tool_calls'];
+            if (Array.isArray(tc) && tc.length > 0) {
+                const names = tc.map((t) => {
+                    const fn = t?.['function'];
+                    return typeof fn?.['name'] === 'string' ? fn['name'] : '?';
+                });
+                lines.push(`  [assistant] tool_calls: ${names.join(', ')}`);
+                lines.push(`    文本: ${truncate(text, 200)}`);
+            }
+            else {
+                lines.push(`  [assistant]: ${truncate(text, 300)}`);
+            }
+        }
+        else if (role === 'tool') {
+            lines.push(`  [tool]: ${truncate(text, 300)}`);
+        }
+    }
+    lines.push('');
+    append(lines);
+}
+/** 记录网页 AI 的原始回复。 */
+export function logAiResponse(params) {
+    if (!isEnabled())
+        return;
+    const { requestId, platform, rawText, parsedToolCalls, parsedText, duration = 0 } = params;
+    const lines = [
+        `[${timeOnly()}] [<<< AI原始回复] [${requestId}] 平台=${platform} | 耗时: ${duration.toFixed(1)}s`,
+        `  原始文本长度: ${rawText.length}`,
+        `  原始文本: ${truncate(rawText, 1000)}`,
+    ];
+    if (parsedText)
+        lines.push(`  解析文本: ${truncate(parsedText, 500)}`);
+    if (parsedToolCalls && parsedToolCalls.length > 0) {
+        lines.push(`  解析工具调用数: ${parsedToolCalls.length}`);
+        lines.push('  解析工具调用:');
+        lines.push(formatToolCalls(parsedToolCalls, 300));
+    }
+    lines.push('');
+    append(lines);
+}
+/** 记录错误。 */
+export function logError(requestId, error, context = '') {
+    if (!isEnabled())
+        return;
+    const lines = [
+        `[${timeOnly()}] [!!! 错误] [${requestId}]`,
+        `  错误: ${error}`,
+    ];
+    if (context)
+        lines.push(`  上下文: ${truncate(context, 500)}`);
+    lines.push('');
+    append(lines);
+}
+/** 记录工具调用结果。 */
+export function logToolCallResult(params) {
+    if (!isEnabled())
+        return;
+    const { requestId, toolName, toolArgs, result, duration = 0 } = params;
+    append([
+        `[${timeOnly()}] [工具执行结果] [${requestId}]`,
+        `  工具: ${toolName} | 耗时: ${duration.toFixed(1)}s`,
+        `  参数: ${truncate(safeJson(toolArgs), 300)}`,
+        `  结果: ${truncate(result, 500)}`,
+        '',
+    ]);
+}
+/** `JSON.stringify` 的容错版本（对应 Python `default=str`）。 */
+function safeJson(value) {
+    try {
+        return JSON.stringify(value, (_key, val) => typeof val === 'bigint' ? val.toString() : val);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=debug-logger.js.map

package/dist/log/debug-logger.js.map

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

package/dist/log/logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 日志 —— 替代 Python 版的 loguru。
+ *
+ * 与原实现的差异：
+ * - Python 用 loguru（`logger.info` / `logger.warning`），TS 用 pino。
+ * - 测试环境自动静音：pino 在 import 时就绑定 level，若不静音，单测输出会被
+ *   大量 `[tool_calls] ...` 噪音淹没。
+ * - `logs/api_requests.log` 那种「原样记录、不做任何加工」的日志**不走 pino**，
+ *   由 `src/log/api-logger.ts` 直接追加写文件（见 docs/hard-constraints.md「日志」）。
+ */
+import pino from 'pino';
+/** 解析日志级别，非法值回退 info。 */
+export declare function resolveLogLevel(raw: string | undefined): pino.LevelWithSilent;
+export declare const logger: pino.Logger<never, boolean>;
+export type Logger = typeof logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/log/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/log/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,eAAe,CAgB7E;AAED,eAAO,MAAM,MAAM,6BAGjB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/log/logger.js

@@ -0,0 +1,35 @@
+/**
+ * 日志 —— 替代 Python 版的 loguru。
+ *
+ * 与原实现的差异：
+ * - Python 用 loguru（`logger.info` / `logger.warning`），TS 用 pino。
+ * - 测试环境自动静音：pino 在 import 时就绑定 level，若不静音，单测输出会被
+ *   大量 `[tool_calls] ...` 噪音淹没。
+ * - `logs/api_requests.log` 那种「原样记录、不做任何加工」的日志**不走 pino**，
+ *   由 `src/log/api-logger.ts` 直接追加写文件（见 docs/hard-constraints.md「日志」）。
+ */
+import pino from 'pino';
+const isTest = Boolean(process.env['VITEST']) || process.env['NODE_ENV'] === 'test';
+/** 解析日志级别，非法值回退 info。 */
+export function resolveLogLevel(raw) {
+    if (!raw)
+        return isTest ? 'silent' : 'info';
+    const normalized = raw.trim().toLowerCase();
+    const allowed = [
+        'silent',
+        'fatal',
+        'error',
+        'warn',
+        'info',
+        'debug',
+        'trace',
+    ];
+    return allowed.includes(normalized)
+        ? normalized
+        : 'info';
+}
+export const logger = pino({
+    level: isTest ? 'silent' : resolveLogLevel(process.env['LOG_LEVEL']),
+    base: undefined, // 去掉 pid/hostname，日志更接近 loguru 的可读输出
+});
+//# sourceMappingURL=logger.js.map

package/dist/log/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/log/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC;AAEpF,yBAAyB;AACzB,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,OAAO,GAA2B;QACtC,QAAQ;QACR,OAAO;QACP,OAAO;QACP,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC;IACF,OAAQ,OAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC/C,CAAC,CAAE,UAAmC;QACtC,CAAC,CAAC,MAAM,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpE,IAAI,EAAE,SAAS,EAAE,qCAAqC;CACvD,CAAC,CAAC"}

package/dist/postinstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":""}

package/dist/postinstall.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * 安装后钩子：尽力把 Playwright 的 **Firefox** 二进制装好。
+ *
+ * ## 为什么需要我们自己写这个
+ * 实测（playwright 1.64.0）：`playwright` 与 `playwright-core` 的 `package.json`
+ * **都没有 `scripts` 字段**，也就是**没有任何安装期脚本** —— `npm i playwright`
+ * 只装 JS 包，**不会下载浏览器**（浏览器缓存目录里 `firefox-1555` 的时间戳可以证明：
+ * 它出现在我们手动执行 `npx playwright install firefox` 的那一刻，而不是 install 时）。
+ *
+ * 而 Playwright 官方对**库作者**的建议是「让用户自己装浏览器」，因为一个库不该
+ * 偷偷下几百 MB。但本包是个**给最终用户用的 CLI**：用户 `npm i -g webaiapi`
+ * 之后期望的是「马上能用」，而不是先撞一次「Executable doesn't exist」再回来翻文档。
+ *
+ * ## 三条设计原则
+ * 1. **只装 firefox**（本项目硬约束：禁止 Chrome/Chromium）。默认的 `install`
+ *    会把 chromium / webkit 一起拖下来（~400MB 浪费）。
+ * 2. **失败绝不阻断安装**：一律 `exit 0` 并打印可复制的修复命令。
+ *    安装脚本因为网络问题让整个 `npm i` 失败，是最不可接受的失败方式。
+ * 3. **尊重标准开关**：`PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD`（Playwright 自己的约定）
+ *    与 `WEBAIAPI_SKIP_BROWSER_INSTALL`（本包的逃生口，CI 里常用）。
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+/** 打印一行提示（安装期没有 pino，直接用 console）。 */
+function say(message) {
+    console.log(`[webaiapi] ${message}`);
+}
+/** 是否被显式要求跳过。 */
+function shouldSkip() {
+    if (process.env['WEBAIAPI_SKIP_BROWSER_INSTALL'])
+        return 'WEBAIAPI_SKIP_BROWSER_INSTALL 已设置';
+    if (process.env['PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD']) {
+        return 'PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD 已设置';
+    }
+    return null;
+}
+async function main() {
+    const skipReason = shouldSkip();
+    if (skipReason) {
+        say(`跳过浏览器安装（${skipReason}）。需要时手动运行: npx playwright install firefox`);
+        return;
+    }
+    let firefox;
+    try {
+        ({ firefox } = await import('playwright'));
+    }
+    catch (error) {
+        say(`无法加载 playwright（${String(error)}），跳过浏览器安装`);
+        return;
+    }
+    // 已经装好 → 什么都不做（大多数重复安装/本地 `npm i` 走这条快路径）
+    try {
+        const exe = firefox.executablePath();
+        if (existsSync(exe))
+            return;
+    }
+    catch {
+        // 拿不到路径就继续尝试安装
+    }
+    say('首次安装：正在下载 Playwright Firefox（约 80MB，只需一次）...');
+    try {
+        // ⚠️ 不能用 `npx playwright`：全局安装时 node_modules/.bin 不在 PATH 上。
+        //    直接解析包内 CLI 的绝对路径最稳（`./package.json` 在 exports 白名单里）。
+        const require = createRequire(import.meta.url);
+        const pkgJson = require.resolve('playwright/package.json');
+        const cli = join(dirname(pkgJson), 'cli.js');
+        execFileSync(process.execPath, [cli, 'install', 'firefox'], {
+            stdio: 'inherit',
+            env: process.env,
+        });
+        say('Firefox 安装完成。运行 `webaiapi doctor` 可自检。');
+    }
+    catch (error) {
+        // 绝不因为下载失败而让 `npm i` 失败 —— 提示用户手动补装即可
+        say(`自动下载 Firefox 失败：${String(error)}`);
+        say('安装本身已成功。需要对话时请手动运行: npx playwright install firefox');
+    }
+}
+void main()
+    .catch((error) => {
+    say(`postinstall 异常（已忽略）：${String(error)}`);
+})
+    .finally(() => {
+    // 显式 0：安装脚本的任何失败都不该让 npm install 失败
+    process.exit(0);
+});
+//# sourceMappingURL=postinstall.js.map

package/dist/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,sCAAsC;AACtC,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,iBAAiB;AACjB,SAAS,UAAU;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;QAAE,OAAO,mCAAmC,CAAC;IAC7F,IAAI,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,EAAE,CAAC;QACpD,OAAO,sCAAsC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;IAChC,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,WAAW,UAAU,2CAA2C,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,IAAI,OAA4C,CAAC;IACjD,IAAI,CAAC;QACH,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,6DAA6D;QAC7D,0DAA0D;QAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE7C,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YAC1D,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE;KACR,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,GAAG,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC,CAAC;KACD,OAAO,CAAC,GAAG,EAAE;IACZ,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/providers/base.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Provider 基类 —— `legacy-python/src/providers/base.py` 的 TypeScript 移植。
+ *
+ * 与原实现的差异：
+ * - Python 用 `@dataclass`；TS 用 `interface`（结构类型，无需运行时构造）。
+ * - `BaseProvider` 是 `abstract class`（Python 用 `ABC` + `@abstractmethod`）；
+ *   TS 的抽象方法在**编译期**就能拦住漏实现，比 Python 的运行时 `TypeError` 更早。
+ * - `chat_stream` 返回 `AsyncGenerator`（Python 的 `AsyncIterator`），
+ *   这样调用方可以用 `for await`，并且 `chatStream()` 内部的 `finally` 一定执行
+ *   —— 这是「锁必须释放」那条硬约束的语言级保障。
+ */
+/** 聊天请求。 */
+export interface ChatRequest {
+    /** 要发给网页端模型的文本（会话复用时可能只含增量）。 */
+    message: string;
+    model?: string;
+    conversation_id?: string;
+    stream?: boolean;
+    temperature?: number;
+    max_tokens?: number;
+    /**
+     * 附加上下文。路由层用到的键：
+     * - `session_key`     —— 逻辑会话 ID（判断能否复用网页会话）
+     * - `delta_message`   —— 只含新增消息（可增量发送）
+     * - `full_message`    —— 完整提示词（换号/会话不一致时必须发它）
+     * - `use_aux_page`    —— 要求本次对话走辅助页面（两轮策略的 reparse）
+     */
+    context?: Record<string, unknown>;
+    /**
+     * 整个 HTTP 请求的**绝对截止时间戳**（毫秒，`Date.now()` 口径）。
+     *
+     * 用于把「首轮对话 + 两轮策略 reparse」等多段往返的总耗时收敛在超时中间件
+     * （300s）以内，避免客户端拿到 504 而完全看不到内容。
+     */
+    deadlineTs?: number;
+}
+/** 聊天响应（一个分片或一次错误）。 */
+export interface ChatResponse {
+    content?: string;
+    model?: string;
+    conversation_id?: string;
+    usage?: Record<string, number>;
+    metadata?: Record<string, unknown>;
+    error?: string;
+}
+/** Provider 抽象基类。 */
+export declare abstract class BaseProvider {
+    /** 平台标识（如 `chatglm-browser`）。 */
+    readonly platform: string;
+    /** 本 Provider 对外暴露的模型名清单。 */
+    models: string[];
+    constructor(platform: string);
+    /** 非流式聊天。 */
+    abstract chat(request: ChatRequest): Promise<ChatResponse>;
+    /** 流式聊天（必须串行化，见各实现的 `finally`）。 */
+    abstract chatStream(request: ChatRequest): AsyncGenerator<ChatResponse>;
+    /** 创建新会话，返回会话 ID。 */
+    abstract createConversation(): Promise<string>;
+    /** 删除会话。 */
+    abstract deleteConversation(conversationId: string): Promise<void>;
+    /** 检查登录状态。 */
+    abstract checkLoginStatus(): Promise<boolean>;
+    /** 获取支持的模型列表。 */
+    getModels(): string[];
+    /**
+     * 本 Provider **当前**使用的账号 ID。
+     *
+     * 为什么要暴露：`ModelRouter` 必须知道「主通道现在占着哪个账号」，
+     * 才能给辅助通道挑一个**不同的**账号（同账号并行会立刻触发
+     * 「请等待其他对话生成完毕」）。Python 版是直接读 `provider._account_id`
+     * 私有字段；TS 用显式方法，避免到处访问私有成员。
+     *
+     * ⚠️ 主通道被限流**换号后**返回值会变，调用方不能缓存它。
+     */
+    getAccountId(): string;
+    /** 辅助通道标识（非空表示这是独立通道实例，不是主通道）。 */
+    getChannelKey(): string | undefined;
+    /** 标记「刚被使用过」（更新空闲计时）。*/
+    markUsed(): Promise<void>;
+    /** 是否支持指定模型。 */
+    supportsModel(model: string): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uBAAuB;AACvB,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAqB;AACrB,8BAAsB,YAAY;IAChC,iCAAiC;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC,6BAA6B;IACtB,MAAM,EAAE,MAAM,EAAE,CAAM;IAE7B,YAAY,QAAQ,EAAE,MAAM,EAE3B;IAED,aAAa;IACb,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3D,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAExE,qBAAqB;IACrB,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,YAAY;IACZ,QAAQ,CAAC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,cAAc;IACd,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C,iBAAiB;IACjB,SAAS,IAAI,MAAM,EAAE,CAEpB;IAED;;;;;;;;;OASG;IACH,YAAY,IAAI,MAAM,CAErB;IAED,kCAAkC;IAClC,aAAa,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,wBAAwB;IAClB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,gBAAgB;IAChB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpC;CACF"}

package/dist/providers/base.js

@@ -0,0 +1,51 @@
+/**
+ * Provider 基类 —— `legacy-python/src/providers/base.py` 的 TypeScript 移植。
+ *
+ * 与原实现的差异：
+ * - Python 用 `@dataclass`；TS 用 `interface`（结构类型，无需运行时构造）。
+ * - `BaseProvider` 是 `abstract class`（Python 用 `ABC` + `@abstractmethod`）；
+ *   TS 的抽象方法在**编译期**就能拦住漏实现，比 Python 的运行时 `TypeError` 更早。
+ * - `chat_stream` 返回 `AsyncGenerator`（Python 的 `AsyncIterator`），
+ *   这样调用方可以用 `for await`，并且 `chatStream()` 内部的 `finally` 一定执行
+ *   —— 这是「锁必须释放」那条硬约束的语言级保障。
+ */
+/** Provider 抽象基类。 */
+export class BaseProvider {
+    /** 平台标识（如 `chatglm-browser`）。 */
+    platform;
+    /** 本 Provider 对外暴露的模型名清单。 */
+    models = [];
+    constructor(platform) {
+        this.platform = platform;
+    }
+    /** 获取支持的模型列表。 */
+    getModels() {
+        return this.models;
+    }
+    /**
+     * 本 Provider **当前**使用的账号 ID。
+     *
+     * 为什么要暴露：`ModelRouter` 必须知道「主通道现在占着哪个账号」，
+     * 才能给辅助通道挑一个**不同的**账号（同账号并行会立刻触发
+     * 「请等待其他对话生成完毕」）。Python 版是直接读 `provider._account_id`
+     * 私有字段；TS 用显式方法，避免到处访问私有成员。
+     *
+     * ⚠️ 主通道被限流**换号后**返回值会变，调用方不能缓存它。
+     */
+    getAccountId() {
+        return 'default';
+    }
+    /** 辅助通道标识（非空表示这是独立通道实例，不是主通道）。 */
+    getChannelKey() {
+        return undefined;
+    }
+    /** 标记「刚被使用过」（更新空闲计时）。*/
+    async markUsed() {
+        // 默认空实现：只有需要空闲超时的 Provider 才关心
+    }
+    /** 是否支持指定模型。 */
+    supportsModel(model) {
+        return this.models.includes(model);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsCH,qBAAqB;AACrB,MAAM,OAAgB,YAAY;IAChC,iCAAiC;IACjB,QAAQ,CAAS;IAEjC,6BAA6B;IACtB,MAAM,GAAa,EAAE,CAAC;IAE7B,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAiBD,iBAAiB;IACjB,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;OASG;IACH,YAAY;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kCAAkC;IAClC,aAAa;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,QAAQ;QACZ,+BAA+B;IACjC,CAAC;IAED,gBAAgB;IAChB,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}