webaiapi 0.0.0-stage → 0.1.0

package/dist/routes/failover.js

@@ -0,0 +1,221 @@
+/**
+ * 跨平台故障切换 —— `legacy-python/src/api/routes.py` 第 1038~1265 行的移植。
+ *
+ * 包含：
+ * - {@link buildReparseInput}：构造「两轮策略」的输入（合并 SSE 回答 + 思考 + DOM）；
+ * - {@link streamWithFailover}：带故障切换的流式生成器。
+ *
+ * ## ⚠️ 本文件最重要的一条约束：生成器**必须被关闭**
+ * Python 用 `async with aclosing(provider.chat_stream(...))` 包住 `async for`，
+ * 理由写在原注释里：「确保提前退出时也关闭 provider 生成器，否则 provider 内部的
+ * 串行锁（`self._lock`）不会释放，**后续请求会永久阻塞**」。
+ *
+ * TypeScript 的 `for await...of` **在语法层面**就保证这件事：无论循环是正常结束、
+ * `break`、还是循环体抛异常，迭代器的 `return()` 都会被调用 ——
+ * 而 `async *chatStream()` 里的 `finally`（释放锁）一定执行。
+ * 所以这里不需要 `aclosing` 的等价物，**但绝不能把 `for await` 换成手动
+ * `while (true) { iterator.next() }`**，那样就丢掉了这层语言级保障。
+ */
+import { getLastRawSse } from '../providers/chatglm-sse.js';
+import { logger as baseLogger } from '../log/logger.js';
+import { logAiPlatformRequest } from '../log/api-logger.js';
+import { errorMessage, PlatformUnavailableError } from '../utils/errors.js';
+import { extractPlatformName, formatHistoryContext, platformOf, truncatePromptForBrowser, } from './helpers.js';
+const logger = baseLogger;
+/** 支持网页会话复用（增量发送）的平台。 */
+const SESSION_REUSE_PLATFORMS = new Set(['chatglm']);
+/**
+ * 构造「两轮对话」策略的输入文本。
+ *
+ * 与展示给客户端的文本**目的不同**：
+ * - 展示：只能用 SSE 的最终回答（`type=text`），不能把思考过程泄漏出去；
+ * - 恢复工具调用：**信号越多越好**。
+ *
+ * 实测失败案例：模型把完整工具意图写在**思考**里（`type=think` 有 3339 字符，
+ * 例如「我需要：1. 用 list_dir 查看项目结构 并读取关键文件：core/backtest_engine.py…」），
+ * 而最终回答只有 77 个字符（没有 `<tool_call>`）。
+ * 此时若只把 77 字符的回答交给转换器，必然恢复不出任何工具调用。
+ *
+ * 因此这里把 SSE 回答、SSE 思考、DOM 拼接文本合并去重后一起交给转换器。
+ */
+export function buildReparseInput(parseSource, fullResponse) {
+    // 思考内容来自 provider 写下的「主轮全局」。
+    // ⚠️ 辅助通道不写这些全局（见 chatglm.ts 的说明），所以这里拿到的永远
+    //    是**主轮**的思考，不会被并行的压缩请求污染。
+    let think = '';
+    try {
+        think = getLastRawSse().think ?? '';
+    }
+    catch {
+        // 忽略：拿不到思考就用剩下的两个信号
+    }
+    let ordered = [];
+    for (const piece of [parseSource, think, fullResponse]) {
+        const p = (piece ?? '').trim();
+        if (!p)
+            continue;
+        // 已包含该片段，跳过
+        if (ordered.some((q) => p === q || q.includes(p)))
+            continue;
+        // 新片段包含旧片段 → 用更完整的替换
+        ordered = ordered.filter((q) => !p.includes(q));
+        ordered.push(p);
+    }
+    return ordered.join('\n\n');
+}
+/**
+ * 带跨平台故障切换的流式响应生成器。
+ *
+ * 策略：
+ * - `mix` 模型：按优先级依次尝试各平台，当前平台失败后切换到下一个候选平台。
+ *   跨平台切换时从 `history_db` 注入最近 N 条历史作为上下文。
+ * - 平台名模型（如 `chatglm`）：直接调用对应平台的 Browser Provider。
+ *
+ * @throws {PlatformUnavailableError} 所有候选平台都失败
+ */
+export async function* streamWithFailover(modelRouter, model, chatRequest, historyDb, requestId = 'unknown') {
+    const originalMessage = chatRequest.message;
+    const convId = chatRequest.conversation_id ?? null;
+    /* ===== 辅助任务（压缩 / 两轮转换 / 自驱动续跑）走「独立辅助通道」=====
+     * 独立通道 = 同平台的**另一个账号** + 独立 context 页面 + 独立锁，
+     * 因此可以与主对话真并行，也不会占用主账号的并发额度。
+     * 拿不到独立通道时列表为空 → 完全保持原行为（回落主候选，串行）。 */
+    const reqCtx = chatRequest.context ?? {};
+    const wantAux = Boolean(reqCtx['use_aux_page']);
+    const auxCandidates = wantAux ? modelRouter.getAuxCandidates() : [];
+    logger.info(`[_stream_with_failover] 入口, model=${model}` +
+        (auxCandidates.length > 0
+            ? `（辅助任务 → 独立通道 ${auxCandidates.map((c) => c[0]).join(',')}）`
+            : ''));
+    if (model === 'mix') {
+        logger.info('[_stream_with_failover] 进入 mix 分支');
+        const candidates = await modelRouter.getMixCandidates();
+        // 独立通道优先；它万一失败再回落到主候选（此时与主对话串行，
+        // 功能不退化，只是会慢一些）
+        const all = auxCandidates.length > 0 ? [...auxCandidates, ...candidates] : candidates;
+        if (all.length === 0) {
+            throw new PlatformUnavailableError('mix', '所有平台均不可用，请运行 `npx webaiapi login chatglm` 捕获凭证');
+        }
+        let lastError = null;
+        for (let idx = 0; idx < all.length; idx += 1) {
+            const candidate = all[idx];
+            if (!candidate)
+                continue;
+            const [platform, provider] = candidate;
+            /* ===== 会话复用：只补发增量 =====
+             * 仅对**第一个候选平台**且该平台支持网页会话复用（chatglm）时启用；
+             * 跨平台切换时绝不能用增量 —— 另一个平台的会话里没有历史。 */
+            const ctx = chatRequest.context ?? {};
+            const delta = typeof ctx['delta_message'] === 'string' ? ctx['delta_message'] : '';
+            if (delta && idx === 0 && SESSION_REUSE_PLATFORMS.has(platformOf(platform))) {
+                chatRequest.message = delta;
+                logger.info(`[session] 会话 ${convId} 复用 ${platform} 网页会话，` +
+                    `只发增量 ${delta.length} 字符（完整提示词 ${originalMessage.length} 字符）`);
+            }
+            else if (idx === 0) {
+                chatRequest.message = originalMessage;
+            }
+            /* 跨平台切换时注入历史上下文（首次尝试不注入，依赖平台自身 session）。
+             * ⚠️ 辅助任务（压缩/转换）的提示词是**自包含**的：往里塞历史上下文
+             *    只会污染它（例如把对话历史塞进「压缩这段历史」的提示里）。 */
+            if (idx > 0 && convId && !wantAux) {
+                const history = await historyDb.getRecentMessages(convId, 20);
+                if (history.length > 0) {
+                    const context = formatHistoryContext(history);
+                    chatRequest.message = truncatePromptForBrowser(`${context}\n\n[当前消息]\n${originalMessage}`);
+                    logger.info(`mix 跨平台切换到 ${platform}，注入 ${history.length} 条历史上下文`);
+                }
+                else {
+                    chatRequest.message = originalMessage;
+                    logger.info(`mix 跨平台切换到 ${platform}（无历史可注入）`);
+                }
+            }
+            // ⚠️ `started` 必须声明在 try **之外**：TS 的 `catch` 是独立作用域，
+            //    在 `try` 里用 `let` 声明的变量在 `catch` 中不可见
+            //    （Python 的 try/except 不引入新作用域，所以原实现写在 try 里也没问题）。
+            let started = false;
+            try {
+                // API 日志：记录发送给 AI 平台的完整内容（发送前记录）
+                logAiPlatformRequest({
+                    requestId,
+                    platform,
+                    messages: [{ role: 'user', content: chatRequest.message }],
+                });
+                let emptyError = null;
+                // ⚠️ `for await` 在 break/throw/return 时都会调用生成器的 return()
+                //    → provider 的 finally 释放串行锁。不要改成手动 next()。
+                for await (const chunk of provider.chatStream(chatRequest)) {
+                    // 纯错误（无任何内容）视为本次尝试失败，允许切换到下一个平台
+                    if (chunk.error && !(chunk.content ?? '').trim()) {
+                        emptyError = chunk.error;
+                        break;
+                    }
+                    started = true;
+                    yield [chunk, platform];
+                }
+                if (emptyError !== null) {
+                    throw new PlatformUnavailableError(platform, `返回空内容: ${emptyError}`);
+                }
+                return; // 成功完成
+            }
+            catch (error) {
+                if (started) {
+                    // 已开始 yield，不能切换（客户端已收到部分响应）
+                    throw error;
+                }
+                lastError = error;
+                logger.warn(`mix 跨平台切换：平台 ${platform} 失败 - ` +
+                    `${error instanceof Error ? error.name : 'Error'}: ${errorMessage(error)}`);
+                chatRequest.message = originalMessage; // 重置消息
+            }
+        }
+        // 所有平台都失败
+        throw new PlatformUnavailableError('mix', lastError ? errorMessage(lastError) : 'all platforms failed');
+    }
+    /* ===== 平台名模型：直接调用对应平台的 Browser Provider ===== */
+    logger.info(`[_stream_with_failover] 进入 else 分支 (platform model), model=${model}`);
+    let provider = await modelRouter.getProvider(model);
+    const platform = extractPlatformName(provider.platform);
+    logger.info(`[chatglm] _stream_with_failover: 获取到 provider=${provider.platform}, platform=${platform}`);
+    // 辅助任务优先走独立通道（另一个账号 + 独立页面 → 与主对话并行）
+    if (auxCandidates.length > 0) {
+        const auxCandidate = auxCandidates[0];
+        if (auxCandidate && platformOf(auxCandidate[0]) === platformOf(platform)) {
+            logger.info(`[_stream_with_failover] 辅助任务改用独立通道 ${auxCandidate[0]}` +
+                `（账号 ${auxCandidate[1].getAccountId()}）`);
+            provider = auxCandidate[1];
+        }
+    }
+    logger.info('[chatglm] _stream_with_failover: 开始调用 provider.chat_stream()');
+    // 会话复用：同一会话只补发增量（provider 若无法复用会自动改发完整提示词）
+    const ctx = chatRequest.context ?? {};
+    const delta = typeof ctx['delta_message'] === 'string' ? ctx['delta_message'] : '';
+    if (delta && SESSION_REUSE_PLATFORMS.has(platformOf(platform))) {
+        chatRequest.message = delta;
+        logger.info(`[session] 会话 ${convId} 复用 ${platform} 网页会话，` +
+            `只发增量 ${delta.length} 字符（完整提示词 ${originalMessage.length} 字符）`);
+    }
+    // API 日志：记录 AI 平台请求（平台名模型，发送前记录）
+    logAiPlatformRequest({
+        requestId,
+        platform,
+        messages: [{ role: 'user', content: chatRequest.message }],
+    });
+    let emptyError = null;
+    for await (const chunk of provider.chatStream(chatRequest)) {
+        // 纯错误（无内容）记录下来，循环结束后再抛出，
+        // 保证生成器被正常关闭（否则 provider 的串行锁不会释放）
+        if (chunk.error && !(chunk.content ?? '').trim()) {
+            emptyError = chunk.error;
+            break;
+        }
+        logger.debug(`[chatglm] _stream_with_failover: yield chunk, content_len=${chunk.content?.length ?? 0}`);
+        yield [chunk, platform];
+    }
+    if (emptyError !== null) {
+        // 让上层把真实原因返回给客户端，避免「空回复 + 无任何说明」
+        throw new PlatformUnavailableError(platform, `返回空内容: ${emptyError}`);
+    }
+}
+export { extractPlatformName };
+//# sourceMappingURL=failover.js.map

package/dist/routes/failover.js.map

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

package/dist/routes/helpers.d.ts

@@ -0,0 +1,174 @@
+import { type ChatMessage } from '../types/message.js';
+/**
+ * 估算文本的 token 数。
+ *
+ * 启发式（与原实现一致）：中文约 0.5 token/字，英文约 0.25 token/词。
+ * 仅用于 OpenAI 兼容响应的 `usage` 字段，不参与任何决策。
+ */
+export declare function estimateTokens(text: string): number;
+/** 构建 OpenAI 兼容的 usage 对象。 */
+export declare function buildUsage(promptText: string, completionText: string): {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+};
+/** 构建 OpenAI 兼容的错误响应体。 */
+export declare function openaiErrorResponse(message: string, errorType?: string, code?: string | null): {
+    error: Record<string, unknown>;
+};
+/**
+ * 把历史消息格式化为上下文字符串（跨平台切换时注入，保持对话连续性）。
+ */
+export declare function formatHistoryContext(history: Array<Record<string, unknown>>): string;
+/**
+ * 从消息列表里提取用户**真正的问题**。
+ *
+ * ⚠️ 多轮工具调用场景下，`messages` 的最后一条往往是 tool 结果或
+ * `<system-reminder>`，**不能直接取 `messages[-1]`**。
+ *
+ * 优先级：
+ * 1. 最后一条含 `<user_query>...</user_query>` 的用户消息里的 query 内容；
+ * 2. 最后一条 role=user 且不以 `<system-reminder>` 开头的消息（完整内容）；
+ * 3. 兜底：最后一条 role=user 的消息。
+ */
+export declare function extractUserQuestion(messages: ReadonlyArray<ChatMessage | MessageDictLike>): string;
+/** 宽松的消息形状（调用方可能传 pydantic 对象或裸 dict）。 */
+export type MessageDictLike = Record<string, unknown>;
+/**
+ * 剔掉「平台自带工具」的议论句，保留模型真正想做的事。
+ *
+ * 粒度是**句子**而不是整行：同一行里既有议论又有实质（例如「浏览器工具不可用；用 bash 删除
+ * /a/b」）时，只丢议论那一句，绝不整行丢 —— 否则会连着真命令一起丢掉。
+ */
+export declare function stripPlatformToolNoise(text: string): string;
+/**
+ * 从消息列表**尾部**抽取「最近进展」，给转换轮当上下文。
+ *
+ * ⚠️ 2026-10-14：转换轮原来只有「模型自己的自言自语 + 一个取错的用户请求」，
+ * 完全不知道进行到哪了（上一轮写了哪个文件、跑过什么命令），自然转不出正确的下一步。
+ * `buildReparsePrompt` 的 `conversationHistory` 只被用来**抽文件路径**，从没展示给模型。
+ *
+ * @param messages 完整消息列表（越靠后越新）
+ * @returns 形如 `用户: …` / `AI 调用工具: write_file` / `工具结果: 已写入 …` 的多行文本
+ */
+export declare function formatRecentProgress(messages: ReadonlyArray<ChatMessage | MessageDictLike>, options?: {
+    maxEntries?: number;
+    maxCharsPerEntry?: number;
+    maxTotalChars?: number;
+}): string;
+/**
+ * 网页端输入框长度上限（实测）。
+ *
+ * ChatGLM 输入框填 8.2 万字符时：`textarea.value` 正常写入，但按 Enter
+ * **不会提交**（不报错、不产生新对话轮次），表现为「模型未返回任何内容」。
+ * 实测 7 万字符仍可发送；这里取 64K（留安全余量，同时尽量保留上下文）。
+ */
+export declare const BROWSER_PROMPT_MAX_LEN = 64000;
+/**
+ * 整个 HTTP 请求的时间预算（秒）。
+ *
+ * 必须 < 超时中间件的 300s，并留出把 `[DONE]` 写回客户端的时间。
+ *
+ * 为什么要设总预算：一次请求内部可能串起**多个完整对话往返** ——
+ * 首轮对话 + 两轮策略的 reparse。各轮在 provider 内部各自有 240s 硬超时，
+ * 不设总预算则合计必然超 300s：实测首轮 176s + reparse 114s，
+ * 被中间件在 300s 处掐断 → 客户端拿到 504，连首轮已经拿到的文本都没有。
+ */
+export declare const TOTAL_TIME_BUDGET = 270;
+/**
+ * 历史压缩的预算门槛（秒）。
+ *
+ * 「压缩历史」不是免费的：一份 8 万字符的提示词要压缩 2 次，每次都是一轮完整对话，
+ * 实测烧掉 117s，剩下的 150s 只够主对话跑一次 → 「两轮策略」因剩余时间不足被跳过，
+ * 模型只交一份计划书就结束回合 → 用户看到「读了半天、一个文件都没改、任务终止」。
+ *
+ * 对策：剩余预算低于本值就不压缩，改用快速中间截断，把时间留给真正干活的环节。
+ */
+export declare const COMPRESS_MIN_BUDGET = 170;
+/** 单块压缩的时间上限（秒），避免无限等待。 */
+export declare const COMPRESS_CHUNK_MAX_SECONDS = 60;
+/**
+ * 动作恢复轮（**唯一一层兜底**）的预算：至少要留多少剩余时间才值得启动，以及它自己的上限。
+ *
+ * 实测一轮完整对话要 20~120s：门槛设得太低会启动一个**注定跑不完**的恢复轮
+ * （2026-10-14 实测：首轮烧掉 210s 后只剩 60s，恢复轮一直转到 270s 总预算耗尽，
+ * 客户端既没拿到工具调用还多等了 60s）。
+ */
+export declare const CONTINUE_MIN_BUDGET = 80;
+export declare const CONTINUE_MAX_BUDGET = 100;
+/**
+ * 同一用户请求下允许的最大工具调用轮数。
+ *
+ * ⚠️ 旧值 8 太小：模型一次想读 4 个文件时我们**只下发第一个**，
+ * 8 轮就被截停，然后回一句「操作已完成。」—— 实测用户「帮我修复这几处」，
+ * 读了 8 个文件后就被截停，**一个文件都没改**。
+ */
+export declare const TOOL_ROUND_LIMIT = 24;
+/**
+ * 「只读」工具名（归一化后比对：去掉非字母并小写）。
+ *
+ * 这些调用不改任何状态，同一条回复里的多个调用可以**一起下发**，
+ * 由客户端并行执行 —— 省下大量轮次（读取 6 个文件从 6 轮降到 1 轮）。
+ */
+export declare const READ_ONLY_TOOLS: ReadonlySet<string>;
+/** 工具名是否属于「只读」类（可安全地在同一轮里批量下发）。 */
+export declare function isReadOnlyTool(name: string): boolean;
+/**
+ * 识别「只给计划、没有动手」的未完成回答。
+ *
+ * 实测：模型读了 7 轮文件后，最后的回答是一段**计划书** ——
+ * 「仍有三处关键文件内容未知…需先补读」—— 里面没有任何工具调用。
+ * 客户端收到纯文本即结束回合，用户看到「读了半天、一个文件都没改、任务终止」。
+ * 模型还自认为「工具轮数已达上限（8/8）」（这句是它自己脑补的），
+ * 于是主动放弃动手改成写计划。
+ *
+ * 现在它是「动作恢复轮」的触发信号之一（提示词见
+ * `tools/prompts.ts::buildActionRecoveryPrompt`，原 `CONTINUE_PROMPT` 已并入）。
+ */
+export declare const UNFINISHED_MARKERS: ReadonlyArray<string>;
+/** 回答是否是「只说计划、没有动手」的未完成态。 */
+export declare function looksUnfinishedAnswer(text: string): boolean;
+/** 项目根路径识别：`/home/<user>/<a>/<b>`（macOS 同理 `/Users/...`）。 */
+export declare const PROJECT_ROOT_RE: RegExp;
+/**
+ * 模型「自认读不到本地文件」的话术：出现这些短语说明它整轮没真正用我们的工具，
+ * 而是在跟网页端自带能力（联网搜索等）较劲，回答通常与本项目无关。
+ */
+export declare const SELF_ADMISSION_PHRASES: ReadonlyArray<string>;
+/**
+ * 检测「回答与本项目无关」的迹象，返回要追加到正文前的提示（无异常返回空串）。
+ *
+ * 两类信号（实测的跑偏方式）：
+ * 1. 回答里出现**其他项目根目录**（如 `/home/amble/project/ai-api`），
+ *    而当前工作目录是 `/home/amble/object/biga` —— 模型读/聊的是别的项目；
+ * 2. 回答自认「工具不可用 / 读不到本地文件」—— 说明它整轮在跟网页端自带的
+ *    联网搜索较劲，没真正读本项目代码。
+ *
+ * 这类回答看起来很自信但与本项目无关，直接把原文给用户是误导，
+ * 因此在正文前加一行明确提示（同时打 WARN 便于统计频率）。
+ */
+export declare function detectMismatchedAnswer(text: string, workspacePath: string): string;
+/**
+ * 截断注入给网页端的 prompt，防止超过输入框上限导致消息发不出去。
+ *
+ * 截断策略：保留头部（工具调用协议 + 工具列表，决定能否产出工具调用）
+ * 与尾部（最近的对话内容，含 `<user_query>`），仅丢弃中间部分。
+ */
+export declare function truncatePromptForBrowser(text: string, maxLen?: number): string;
+/** 把 `provider.platform` 归一成站点名（`chatglm-browser` → `chatglm`）。 */
+export declare function platformOf(platformName: string): string;
+/** 从 provider 的 platform 名里取平台名（目前是直通，保留钩子）。 */
+export declare function extractPlatformName(providerPlatform: string): string;
+/** 单条消息的指纹（用于逐条比对历史是否被改写）。 */
+export declare function msgFingerprint(msg: ChatMessage | MessageDictLike): string;
+/**
+ * 若这个会话的历史是上次的延续，返回「本次新增消息」的列表。
+ *
+ * @returns 新增消息；不可复用（无记录 / 历史被改写 / 无新增）时返回 `[]`。
+ */
+export declare function getSessionDelta(messages: ReadonlyArray<ChatMessage | MessageDictLike>, conversationId: string | null | undefined): Array<ChatMessage | MessageDictLike>;
+/** 记录「这批消息已经发进 platform 的网页会话」，供下次算增量。 */
+export declare function rememberSessionSend(conversationId: string | null | undefined, messages: ReadonlyArray<ChatMessage | MessageDictLike>, platform: string): void;
+/** 清空会话发送记录（测试用）。 */
+export declare function __clearSessionSendState(): void;
+//# sourceMappingURL=helpers.d.ts.map

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

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