@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/WebCommon.js

@@ -0,0 +1,286 @@
+import { URL } from 'url';
+import { t } from '../../i18n.js';
+import { effectiveBlockPrivateNetwork } from '../../core/HardeningPolicy.js';
+import { getScopedProxyFetch } from '../../core/ProxyConfig.js';
+const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
+const PRIVATE_IP_RANGES = [
+    /^127\./, // loopback
+    /^10\./, // RFC 1918
+    /^172\.(1[6-9]|2\d|3[01])\./, // RFC 1918
+    /^192\.168\./, // RFC 1918
+    /^169\.254\./, // link-local / cloud metadata
+    /^0\./, // current network
+    /^::1$/, // IPv6 loopback
+    /^fe80:/i, // IPv6 link-local
+    /^fc00:/i, // IPv6 unique local
+    /^fd[0-9a-f]{2}:/i, // IPv6 unique local
+];
+export function isPrivateIP(ip) {
+    return PRIVATE_IP_RANGES.some(pattern => pattern.test(ip));
+}
+export async function checkUrlNotPrivate(url) {
+    // 加固模式（§3.7）：读 effectiveBlockPrivateNetwork()（与独立开关 block_private_network
+    // 取 OR），加固开启时默认启用 SSRF/私网防护。关闭时（默认且独立开关未开）保持现状放行。
+    if (!effectiveBlockPrivateNetwork()) {
+        return [true];
+    }
+    try {
+        const parsed = new URL(url);
+        const hostname = parsed.hostname;
+        if (isPrivateIP(hostname)) {
+            return [false, `私有网络地址被阻止: ${hostname}`];
+        }
+        const { lookup } = await import('dns/promises');
+        try {
+            const { address } = await lookup(hostname);
+            if (isPrivateIP(address)) {
+                return [false, `域名解析到私有地址被阻止: ${hostname} → ${address}`];
+            }
+        }
+        catch {
+            // DNS 解析失败不阻止（可能是网络问题）
+        }
+        return [true];
+    }
+    catch { /* expected: fallback to default */
+        return [true];
+    }
+}
+export function isWebUrlSafe(url) {
+    if (!url) {
+        return [false, 'URL 为空'];
+    }
+    try {
+        const parsed = new URL(url);
+        const protocol = parsed.protocol.toLowerCase().replace(':', '');
+        if (!['http', 'https'].includes(protocol)) {
+            return [false, `不支持的协议：${protocol}`];
+        }
+        return [true];
+    }
+    catch (error) {
+        return [false, `URL 解析错误：${error instanceof Error ? error.message : String(error)}`];
+    }
+}
+async function fetchWithSignal(url, options, signal) {
+    const scopedFetch = getScopedProxyFetch('tools') || fetch;
+    return await scopedFetch(url, {
+        ...options,
+        signal,
+    });
+}
+export async function fetchWithTimeout(url, options, timeoutSeconds) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutSeconds * 1000);
+    try {
+        return await fetchWithSignal(url, options, controller.signal);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+export async function fetchWithSafeRedirects(url, options, timeoutSeconds, _allowPrivateHosts = false, maxRedirects = 5) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutSeconds * 1000);
+    try {
+        let currentUrl = url;
+        let redirectCount = 0;
+        while (true) {
+            const [safe, reason] = isWebUrlSafe(currentUrl);
+            if (!safe) {
+                throw new Error(t('error.redirect_unsafe', reason));
+            }
+            const response = await fetchWithSignal(currentUrl, { ...options, redirect: 'manual' }, controller.signal);
+            const location = response.headers.get('location');
+            const isRedirect = REDIRECT_STATUSES.has(response.status) && !!location;
+            if (!isRedirect) {
+                return response;
+            }
+            if (redirectCount >= maxRedirects) {
+                throw new Error(t('error.redirect_limit', maxRedirects));
+            }
+            currentUrl = new URL(location, currentUrl).toString();
+            redirectCount += 1;
+        }
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+function decodeHtmlEntities(text) {
+    return text
+        .replace(/ /g, ' ')
+        .replace(/&/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#x27;/gi, "'")
+        .replace(/&#x2F;/gi, '/')
+        .replace(/&#(\d+);/g, (_match, dec) => {
+        const code = Number.parseInt(dec, 10);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : _match;
+    })
+        .replace(/&#x([0-9a-f]+);/gi, (_match, hex) => {
+        const code = Number.parseInt(hex, 16);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : _match;
+    });
+}
+function normalizeExtractedText(text) {
+    return decodeHtmlEntities(text)
+        .replace(/\r/g, '')
+        .replace(/\u00a0/g, ' ')
+        .replace(/[ \t]{2,}/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+export function stripHtml(html) {
+    return normalizeExtractedText(html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/(p|div|section|article|li|h1|h2|h3|h4|h5|h6)>/gi, '\n')
+        .replace(/<[^>]+>/g, ' '));
+}
+export function extractTitle(html) {
+    const match = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    return match ? stripHtml(match[1]) : '';
+}
+function extractTagContents(html, tagName, limit) {
+    const regex = new RegExp(`<${tagName}\\b[^>]*>([\\s\\S]*?)<\\/${tagName}>`, 'gi');
+    const results = [];
+    let match;
+    while ((match = regex.exec(html)) !== null && results.length < limit) {
+        const text = stripHtml(match[1]);
+        if (text) {
+            results.push(text);
+        }
+    }
+    return results;
+}
+function extractAttributeValues(html, attribute, limit) {
+    const regex = new RegExp(`\\b${attribute}=(["'])([\\s\\S]*?)\\1`, 'gi');
+    const results = [];
+    let match;
+    while ((match = regex.exec(html)) !== null && results.length < limit) {
+        const value = normalizeExtractedText(match[2]);
+        if (value) {
+            results.push(value);
+        }
+    }
+    return results;
+}
+export function extractMetaTags(html) {
+    const tags = html.match(/<meta\b[^>]*>/gi) || [];
+    const wantedKeys = new Set([
+        'description',
+        'keywords',
+        'og:title',
+        'og:description',
+        'twitter:title',
+        'twitter:description',
+    ]);
+    const meta = {};
+    for (const tag of tags) {
+        const keyMatch = tag.match(/\b(?:name|property)=["']([^"']+)["']/i);
+        const contentMatch = tag.match(/\bcontent=(["'])([\s\S]*?)\1/i);
+        const key = keyMatch?.[1]?.trim().toLowerCase();
+        const value = contentMatch ? normalizeExtractedText(contentMatch[2]) : '';
+        if (!key || !value || !wantedKeys.has(key) || meta[key]) {
+            continue;
+        }
+        meta[key] = value;
+    }
+    return meta;
+}
+export function extractHeadings(html, limit = 8) {
+    const headings = [
+        ...extractTagContents(html, 'h1', limit),
+        ...extractTagContents(html, 'h2', limit),
+        ...extractTagContents(html, 'h3', limit),
+    ];
+    return Array.from(new Set(headings)).slice(0, limit);
+}
+function extractBodyHtml(html) {
+    const match = html.match(/<body\b[^>]*>([\s\S]*?)<\/body>/i);
+    return match?.[1] || html;
+}
+export function extractMeaningfulText(html) {
+    const bodyText = stripHtml(extractBodyHtml(html));
+    if (bodyText) {
+        return bodyText;
+    }
+    const meta = extractMetaTags(html);
+    const fallbacks = [
+        extractTitle(html),
+        ...Object.values(meta),
+        ...extractTagContents(html, 'noscript', 8),
+        ...extractAttributeValues(html, 'placeholder', 8),
+        ...extractAttributeValues(html, 'aria-label', 8),
+        ...extractAttributeValues(html, 'alt', 8),
+        ...extractAttributeValues(html, 'title', 8),
+        ...extractAttributeValues(html, 'value', 8),
+    ].filter(Boolean);
+    const unique = Array.from(new Set(fallbacks));
+    if (unique.length > 0) {
+        return unique.join('\n');
+    }
+    return html.trim()
+        ? '(页面已返回 HTML，但未提取到可见正文，可能为动态渲染、脚本渲染或反爬页面)'
+        : '';
+}
+function collectErrorChain(error) {
+    const chain = [];
+    let current = error;
+    while (current instanceof Error) {
+        chain.push(current);
+        current = current.cause;
+    }
+    return chain;
+}
+export function formatNetworkError(error, timeoutSeconds) {
+    const chain = collectErrorChain(error);
+    const messages = chain.map((item) => item.message || '').join(' | ');
+    const codes = new Set(chain.map((item) => item.code).filter(Boolean));
+    const host = chain.map((item) => item.hostname).find(Boolean);
+    // 精确匹配超时错误，避免误判包含 "timeout" 单词但不是超时的错误
+    const isTimeoutError = chain.some((item) => item.name === 'AbortError' || item.name === 'TimeoutError') ||
+        /\b(request\s+timed\s+out|timed\s+out|timeout\s+error|connection\s+timeout|socket\s+timeout|fetch\s+timeout)\b/i.test(messages);
+    if (isTimeoutError) {
+        return `请求超时${timeoutSeconds ? ` (${timeoutSeconds}秒)` : ''}`;
+    }
+    if (codes.has('EAI_AGAIN') || codes.has('ENOTFOUND')) {
+        return `DNS 解析失败${host ? ` (${host})` : ''} - ${messages || 'fetch failed'}`;
+    }
+    if (codes.has('ECONNREFUSED')) {
+        return `连接被拒绝${host ? ` (${host})` : ''} - ${messages || 'fetch failed'}`;
+    }
+    if (codes.has('ECONNRESET')) {
+        return `连接被重置${host ? ` (${host})` : ''} - ${messages || 'fetch failed'}`;
+    }
+    if (codes.has('ETIMEDOUT') || messages.includes('UND_ERR_CONNECT_TIMEOUT')) {
+        return `连接超时${host ? ` (${host})` : ''} - ${messages || 'fetch failed'}`;
+    }
+    if (/certificate|tls|ssl/i.test(messages)) {
+        return `TLS/SSL 连接失败 - ${messages || 'fetch failed'}`;
+    }
+    // 构建详细错误信息
+    const errorDetails = chain
+        .map((item, index) => {
+        const parts = [
+            index === 0 ? '原始错误' : `原因 ${index}`,
+            item.name ? `名称: ${item.name}` : null,
+            item.message ? `消息: ${item.message}` : null,
+            item.code ? `代码: ${item.code}` : null,
+            item.hostname ? `主机: ${item.hostname}` : null,
+        ].filter(Boolean);
+        return parts.join(' | ');
+    })
+        .join('\n');
+    if (messages) {
+        return `${messages}\n详细错误:\n${errorDetails}`;
+    }
+    const fallbackMsg = error instanceof Error ? error.message : String(error);
+    return `${fallbackMsg}\n详细错误:\n${errorDetails}`;
+}
+//# sourceMappingURL=WebCommon.js.map

package/dist/tools/implementations/WebCommon.js.map

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

package/dist/tools/implementations/WebFetch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Web Fetch tool — 快路径优先（fetch + html→markdown），仅在 SPA / 内容稀疏 / full_page=true
+ * 时切换到 playwright 深度页面分析。
+ *
+ * audit-2026-05-15：之前所有调用都走 chromium navigate，单次 100-1000ms 起步且会被
+ * 共享 page 串行化。引入快路径后：
+ * - 普通文章/文档/搜索结果：fetch HTTP → stripHtml → markdown，热路径降到几十毫秒
+ * - SPA / JS 渲染依赖：自动检测 noscript 比例与正文长度，命中后再走 playwright
+ * - full_page=true 时直接走 playwright（保留表单/表格结构提取）
+ */
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class WebFetchTool extends Tool {
+    readonly name = "web_fetch";
+    readonly description: string;
+    readonly parameters: z.ZodObject<{
+        url: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        max_chars: z.ZodOptional<z.ZodNumber>;
+        text_offset: z.ZodOptional<z.ZodNumber>;
+        text_limit: z.ZodOptional<z.ZodNumber>;
+        full_page: z.ZodOptional<z.ZodBoolean>;
+        force_browser: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly exposedParameters: z.ZodObject<{
+        url: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        full_page: z.ZodOptional<z.ZodBoolean>;
+        force_browser: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    execute(args: unknown, _context?: ToolContext): Promise<ToolResult>;
+}
+export default WebFetchTool;
+//# sourceMappingURL=WebFetch.d.ts.map

package/dist/tools/implementations/WebFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebFetch.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/WebFetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAqJrE,qBAAa,YAAa,SAAQ,IAAI;IACpC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,SAEmE;IACvF,QAAQ,CAAC,UAAU;;;;;;;;;;sBAAkB;IACrC,QAAQ,CAAC,iBAAiB;;;;;;;sBAAiF;IAErG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkK1E;AAED,eAAe,YAAY,CAAC"}

package/dist/tools/implementations/WebFetch.js

@@ -0,0 +1,294 @@
+/**
+ * Web Fetch tool — 快路径优先（fetch + html→markdown），仅在 SPA / 内容稀疏 / full_page=true
+ * 时切换到 playwright 深度页面分析。
+ *
+ * audit-2026-05-15：之前所有调用都走 chromium navigate，单次 100-1000ms 起步且会被
+ * 共享 page 串行化。引入快路径后：
+ * - 普通文章/文档/搜索结果：fetch HTTP → stripHtml → markdown，热路径降到几十毫秒
+ * - SPA / JS 渲染依赖：自动检测 noscript 比例与正文长度，命中后再走 playwright
+ * - full_page=true 时直接走 playwright（保留表单/表格结构提取）
+ */
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { browserManager } from './BrowserManager.js';
+import { fetchWithSafeRedirects, extractTitle, extractMeaningfulText, extractMetaTags, extractHeadings, formatNetworkError, } from './WebCommon.js';
+import { buildStealthUserAgent } from '../../core/BrowserStealth.js';
+import { sleep } from '../../utils/sleep.js';
+import { coreLogger } from '../../core/Log.js';
+const WebFetchSchema = z.object({
+    url: z.string().url().describe('要抓取的网页 URL'),
+    prompt: z.string().optional().describe('可选：说明你想关注的信息。注意：本工具不做关键词删段，会返回页面正文并在页首记录该目标，供 LLM 基于完整上下文提取'),
+    offset: z.number().int().min(0).optional().describe('正文起始偏移，默认 0。使用 offset/limit 续读'),
+    limit: z.number().int().min(200).max(50000).optional().describe('正文返回字符数，默认 15000。结果截断时使用 continuation_tool_call 继续'),
+    max_chars: z.number().int().optional().describe('内部总字符安全上限，默认等于 limit + 元信息长度'),
+    text_offset: z.number().int().optional().describe('内部正文起始偏移；模型侧使用 offset'),
+    text_limit: z.number().int().optional().describe('内部正文长度限制；模型侧使用 limit'),
+    full_page: z.boolean().optional().describe('是否提取完整页面结构（含表单、按钮等），默认 false。设置后强制走 playwright 渲染'),
+    force_browser: z.boolean().optional().describe('强制使用浏览器渲染（绕过 fetch 快路径）；默认 false 时按内容自动选择'),
+});
+const FETCH_TIMEOUT_SECONDS = 25;
+/** 临时限流(429/503)退避重试次数;base 指数退避 + 小 jitter 对抗搜索引擎频控。 */
+const RATE_LIMIT_MAX_ATTEMPTS = 3;
+/**
+ * 快路径 fetch 包装:仅对 429/503(临时限流)做退避重试;其它状态码(含 403 持久拒绝)
+ * 原样返回,交由上层 fall through 到浏览器渲染。
+ */
+async function fetchHtmlWithRateLimitRetry(url, headers, timeoutSeconds) {
+    let response;
+    for (let attempt = 0; attempt < RATE_LIMIT_MAX_ATTEMPTS; attempt += 1) {
+        response = await fetchWithSafeRedirects(url, { method: 'GET', headers }, timeoutSeconds);
+        if (response.status !== 429 && response.status !== 503)
+            return response;
+        if (attempt < RATE_LIMIT_MAX_ATTEMPTS - 1) {
+            const base = 500 * 2 ** attempt; // 500ms, 1000ms
+            const jitter = Math.floor(Math.random() * 300);
+            await sleep(base + jitter);
+        }
+    }
+    return response;
+}
+/**
+ * 判断 fetch 拿到的 HTML 是否需要切换到浏览器渲染。
+ * 命中任意条件即视为 "JS 渲染重的页面"：
+ * - 有效正文长度 < 200 字符
+ * - <noscript> 标签数 ≥ 2（典型 React/Vue/Angular 引导页特征）
+ * - 头部含 __NEXT_DATA__ / __NUXT__ / window.__INITIAL_STATE__ 等 SPA 标志且正文短
+ */
+function shouldFallbackToBrowser(html, text) {
+    if (text.length < 200)
+        return true;
+    const noscriptCount = (html.match(/<noscript\b/gi) || []).length;
+    if (noscriptCount >= 2 && text.length < 800)
+        return true;
+    const spaMarkers = [
+        /__NEXT_DATA__/,
+        /window\.__NUXT__/,
+        /window\.__INITIAL_STATE__/,
+        /id=["']app["'][^>]*>\s*<\/div>/i,
+        /id=["']root["'][^>]*>\s*<\/div>/i,
+    ];
+    if (spaMarkers.some((rx) => rx.test(html)) && text.length < 800)
+        return true;
+    return false;
+}
+function buildFetchResult(args) {
+    const title = args.title ?? (args.html ? extractTitle(args.html) : 'Untitled');
+    const meta = args.html ? extractMetaTags(args.html) : {};
+    const headings = args.html ? extractHeadings(args.html, 8) : [];
+    const body = args.text;
+    const sliced = body.slice(args.offset, args.offset + args.limit);
+    const nextOffset = args.offset + sliced.length;
+    const truncated = nextOffset < body.length;
+    const sections = [
+        `${title || 'Untitled'}${args.rendered ? '（浏览器渲染）' : ''}`,
+        `URL: ${args.finalUrl || args.url}`,
+    ];
+    if (meta.description)
+        sections.push(`Description: ${meta.description}`);
+    if (args.prompt?.trim())
+        sections.push(`Extraction goal: ${args.prompt.trim()}`);
+    sections.push('');
+    if (headings.length > 0) {
+        sections.push('## 标题');
+        for (const h of headings)
+            sections.push(`- ${h}`);
+        sections.push('');
+    }
+    sections.push('## 正文');
+    sections.push(sliced || '(空页面)');
+    if (truncated) {
+        sections.push(`\n[内容已截断，总长度: ${body.length} 字符。next_offset=${nextOffset}，请使用 continuation_tool_call 继续]`);
+    }
+    let text = sections.join('\n');
+    const outputTruncated = text.length > args.maxChars;
+    if (outputTruncated)
+        text = `${text.slice(0, args.maxChars)}\n... (本页输出超过 max_chars 已截断；如需继续请使用 continuation_tool_call 或增大 limit)`;
+    return {
+        url: args.finalUrl || args.url,
+        title: title || 'Untitled',
+        text,
+        content: sliced,
+        offset: args.offset,
+        limit: args.limit,
+        total_chars: body.length,
+        truncated: truncated || outputTruncated,
+        ...(truncated ? {
+            next_offset: nextOffset,
+            continuation_tool_call: {
+                tool: 'web_fetch',
+                args: {
+                    url: args.url,
+                    ...(args.prompt ? { prompt: args.prompt } : {}),
+                    offset: nextOffset,
+                    limit: args.limit,
+                    ...(args.fullPage ? { full_page: true } : {}),
+                    ...(args.rendered && !args.fullPage ? { force_browser: true } : {}),
+                },
+            },
+        } : {}),
+        source: args.rendered ? 'browser' : 'fetch',
+    };
+}
+export class WebFetchTool extends Tool {
+    name = 'web_fetch';
+    description = '抓取网页内容并返回结构化文本。默认走 fetch + HTML→markdown 快路径（热路径 < 100ms）；' +
+        '检测到 SPA / 内容稀疏时自动切换到浏览器渲染；full_page=true 或 force_browser=true 强制浏览器渲染（含表单/表格等深度结构）';
+    parameters = WebFetchSchema;
+    exposedParameters = WebFetchSchema.omit({ max_chars: true, text_offset: true, text_limit: true });
+    async execute(args, _context) {
+        const params = args;
+        const offset = Math.max(0, params.offset ?? params.text_offset ?? 0);
+        const limit = Math.max(200, Math.min(params.limit ?? params.text_limit ?? 15000, 50_000));
+        const maxChars = Math.max(200, Math.min(params.max_chars || limit + 5000, 200_000));
+        const forceBrowser = params.force_browser === true || params.full_page === true;
+        // 快路径：fetch + stripHtml
+        if (!forceBrowser) {
+            try {
+                const response = await fetchHtmlWithRateLimitRetry(params.url, {
+                    'user-agent': buildStealthUserAgent(),
+                    accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                    'accept-language': 'zh-CN,zh;q=0.9,en;q=0.8',
+                }, FETCH_TIMEOUT_SECONDS);
+                if (response.status >= 200 && response.status < 400) {
+                    const contentType = (response.headers.get('content-type') || '').toLowerCase();
+                    // 仅对 HTML / XHTML / XML 走快路径；二进制内容直接交给浏览器渲染（PDF 等）
+                    if (contentType.includes('html') || contentType.includes('xml') || contentType === '') {
+                        const html = await response.text();
+                        const text = extractMeaningfulText(html);
+                        if (!shouldFallbackToBrowser(html, text)) {
+                            return {
+                                success: true,
+                                data: buildFetchResult({
+                                    url: params.url,
+                                    finalUrl: response.url || params.url,
+                                    html,
+                                    text,
+                                    prompt: params.prompt,
+                                    maxChars,
+                                    offset,
+                                    limit,
+                                }),
+                            };
+                        }
+                        // 命中切换条件：继续走浏览器路径
+                    }
+                }
+                // 非 2xx/3xx 或非 HTML：fall through 到浏览器（可能是 cloudflare 拦 fetch 但放浏览器）
+            }
+            catch (err) {
+                // fetch 失败也尝试浏览器路径，并保留错误供浏览器路径失败时拼上下文
+                const msg = formatNetworkError(err, FETCH_TIMEOUT_SECONDS);
+                // 写日志而非中断
+                if (process.env.LINGXIAO_DEBUG_WEB_FETCH) {
+                    coreLogger.debug(`[web_fetch] fast-path fetch failed for ${params.url}: ${msg}`);
+                }
+            }
+        }
+        // 慢路径：playwright 深度渲染
+        try {
+            if (params.full_page) {
+                const deepElements = await browserManager.extractDeepPageElements(params.url);
+                if (!deepElements) {
+                    return { success: false, data: null, error: `页面分析失败: ${params.url}` };
+                }
+                const fullText = deepElements.textContent || '';
+                const slicedText = fullText.slice(offset, offset + limit);
+                const hasMore = (offset + limit) < fullText.length;
+                const sections = [
+                    `🌐 页面深度分析 - ${deepElements.title}`,
+                    `URL: ${deepElements.url}`,
+                    '',
+                ];
+                if (deepElements.headings.length > 0) {
+                    sections.push('## 标题结构');
+                    for (const h of deepElements.headings.slice(0, 20)) {
+                        sections.push(`${'  '.repeat(h.level - 1)}# ${h.text}`);
+                    }
+                    sections.push('');
+                }
+                if (deepElements.tables.length > 0) {
+                    sections.push(`## 表格 (${deepElements.tables.length} 个)`);
+                    for (let i = 0; i < Math.min(deepElements.tables.length, 5); i++) {
+                        const table = deepElements.tables[i];
+                        sections.push(`表 ${i + 1}: ${table.headers.join(' | ')}`);
+                        for (const row of table.rows.slice(0, 5)) {
+                            sections.push(`  ${row.join(' | ')}`);
+                        }
+                    }
+                    sections.push('');
+                }
+                if (deepElements.forms.length > 0) {
+                    sections.push(`## 表单 (${deepElements.forms.length} 个)`);
+                    for (const form of deepElements.forms) {
+                        sections.push(`表单: ${form.name || '(未命名)'} → ${form.action} [${form.method}]`);
+                        for (const input of form.inputs.slice(0, 5)) {
+                            sections.push(`  输入: ${input.name} (${input.type})`);
+                        }
+                    }
+                    sections.push('');
+                }
+                if (deepElements.buttons.length > 0) {
+                    sections.push(`## 按钮 (${deepElements.buttons.length} 个): ${deepElements.buttons.slice(0, 10).map((b) => b.text).join(', ')}`);
+                    sections.push('');
+                }
+                if (deepElements.links.length > 0) {
+                    sections.push(`## 链接 (${deepElements.links.length} 个)`);
+                    for (const link of deepElements.links.slice(0, 15)) {
+                        sections.push(`- [${link.text}](${link.href})`);
+                    }
+                    sections.push('');
+                }
+                sections.push('## 页面文本内容');
+                sections.push(slicedText || '(无文本内容)');
+                if (hasMore) {
+                    sections.push(`\n[内容已截断，总长度: ${fullText.length} 字符。next_offset=${offset + limit}，请使用 continuation_tool_call 继续]`);
+                }
+                const text = sections.join('\n').slice(0, maxChars);
+                return {
+                    success: true,
+                    data: {
+                        url: deepElements.url,
+                        title: deepElements.title,
+                        text,
+                        content: slicedText,
+                        offset,
+                        limit,
+                        total_chars: fullText.length,
+                        truncated: hasMore || sections.join('\n').length > maxChars,
+                        ...(hasMore ? {
+                            next_offset: offset + limit,
+                            continuation_tool_call: { tool: 'web_fetch', args: { url: params.url, ...(params.prompt ? { prompt: params.prompt } : {}), offset: offset + limit, limit, full_page: true } },
+                        } : {}),
+                        source: 'browser_full_page',
+                    },
+                };
+            }
+            // SPA 渲染路径：仍走 extractDeepPageElements 拿渲染后正文，但只取 textContent
+            const deepElements = await browserManager.extractDeepPageElements(params.url);
+            if (!deepElements) {
+                return { success: false, data: null, error: `网页抓取失败: ${params.url}` };
+            }
+            const content = deepElements.textContent || '';
+            return {
+                success: true,
+                data: buildFetchResult({
+                    url: params.url,
+                    finalUrl: deepElements.url,
+                    title: deepElements.title,
+                    text: content,
+                    prompt: params.prompt,
+                    maxChars,
+                    offset,
+                    limit,
+                    rendered: true,
+                }),
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { success: false, data: null, error: `网页抓取失败: ${msg}` };
+        }
+    }
+}
+export default WebFetchTool;
+//# sourceMappingURL=WebFetch.js.map