1618 lines
135 KiB
HTML
1618 lines
135 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN" data-theme="dark">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>Universal Web-to-API · 使用手册</title>
|
||
<link rel="icon" href="../images/logo.svg" type="image/svg+xml">
|
||
<script src="lucide.min.js"></script>
|
||
|
||
|
||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=Noto+Sans+SC:wght@400;500;700;900&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
||
<link rel="stylesheet" href="style.css">
|
||
</head>
|
||
<body>
|
||
<div id="progress"></div>
|
||
<div class="overlay" id="overlay"></div>
|
||
|
||
<div class="app">
|
||
<!-- ============ 侧边栏 ============ -->
|
||
<aside class="sidebar" id="sidebar">
|
||
<div class="sb-brand">
|
||
<div class="sb-logo"><i data-lucide="globe" style="width:20px;height:20px"></i></div>
|
||
<div>
|
||
<div class="sb-name">Universal Web-to-API</div>
|
||
<div class="sb-sub">docs · v2.9.8</div>
|
||
</div>
|
||
</div>
|
||
<div class="sb-search">
|
||
<i data-lucide="search" style="width:15px;height:15px"></i>
|
||
<input id="searchInput" type="text" placeholder="搜索文档…" autocomplete="off">
|
||
<kbd>/</kbd>
|
||
<div class="sb-results" id="searchResults"></div>
|
||
</div>
|
||
<nav id="nav"><!-- JS 生成 --></nav>
|
||
</aside>
|
||
|
||
<div class="shell">
|
||
<!-- ============ 顶栏 ============ -->
|
||
<header class="topbar">
|
||
<button class="tb-btn" id="menuBtn" aria-label="打开导航"><i data-lucide="menu" style="width:16px;height:16px"></i></button>
|
||
<div class="tb-crumb"><span>使用手册</span><i data-lucide="chevron-right" style="width:13px;height:13px"></i><b id="crumbNow">项目概览</b></div>
|
||
<div class="tb-right">
|
||
<span class="tb-ver">v2.9.8</span>
|
||
<button class="tb-btn" id="themeBtn" aria-label="切换主题"><i data-lucide="sun" style="width:15px;height:15px" id="themeIcon"></i></button>
|
||
<a class="tb-btn" href="https://github.com/lumingya/universal-web-api" target="_blank" rel="noopener"><i data-lucide="github" style="width:15px;height:15px"></i><span class="hide-sm">GitHub</span></a>
|
||
</div>
|
||
</header>
|
||
|
||
<div class="body-wrap">
|
||
<main class="content" id="content">
|
||
<!-- ============ HERO ============ -->
|
||
<div class="hero">
|
||
<div class="hero-in">
|
||
<div class="hero-eyebrow">
|
||
<span class="bdg"><i data-lucide="sparkles" style="width:11px;height:11px"></i> v2.9.8</span>
|
||
<span class="bdg g">OpenAI 兼容</span>
|
||
<span class="bdg g">本地部署 · 免费开源</span>
|
||
</div>
|
||
<h1>把任意 AI 聊天网页<br>变成 <span class="grad">OpenAI 标准接口</span></h1>
|
||
<p class="lead">Universal Web-to-API 驱动你浏览器中已经登录的 ChatGPT、Gemini、DeepSeek 等对话网页,将其包装为兼容 OpenAI 格式的本地 API,供 SillyTavern、各类客户端与自动化工作流直接调用。</p>
|
||
<div class="hero-cta">
|
||
<a class="btn btn-pri" href="#quickstart"><i data-lucide="rocket" style="width:16px;height:16px"></i>快速开始</a>
|
||
<a class="btn btn-gh" href="http://127.0.0.1:8199/" target="_blank" rel="noopener"><i data-lucide="layout-dashboard" style="width:16px;height:16px"></i>打开控制面板</a>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- ============ 01 项目概览 ============ -->
|
||
<section class="doc-section" id="overview">
|
||
<div class="sec-kicker"><span class="sec-num">01</span><span class="sec-tag">导览</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="compass" style="width:20px;height:20px"></i></span>项目概览<a class="h-anchor" href="#overview"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p class="lead">本项目的核心思路:不再依赖官方 API,而是<strong>自动化你本地的浏览器</strong>——让脚本在你已登录的 AI 网站上输入问题、等待回复、提取结果,再按 OpenAI 的数据格式返回给任何客户端。</p>
|
||
<div class="chips">
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>OpenAI / Anthropic 双协议兼容</span>
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>多站点 · 多标签页并发</span>
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>流式输出</span>
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>图片 / 音频 / 视频回传</span>
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>自动化恢复命令</span>
|
||
<span class="chip"><i data-lucide="check" style="width:12px;height:12px"></i>函数调用转译</span>
|
||
</div>
|
||
<p><strong>典型用途:</strong>统一本地接入方式;按站点或标签页组织不同工作流;在长文本场景下通过文件粘贴承载上下文;在调试时观察页面侧与请求侧的执行流程。</p>
|
||
|
||
<h3>系统架构</h3>
|
||
<p>请求从客户端进入后,会依次穿过路由层、调度层与驱动层,再由解析层把网页里的回复翻译回标准格式。理解这条链路,后面的配置章节会好读很多。</p>
|
||
<div class="arch">
|
||
<div class="a-tier">
|
||
<div class="a-node" style="--c:#94a3b8">
|
||
<span class="a-lay">USER</span>
|
||
<div class="a-tt"><i data-lucide="user" style="width:17px;height:17px"></i>客户端 / 调用方</div>
|
||
<div class="a-ds">SillyTavern / Chatbox / 代码集成 / 自动化脚本</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-arrow"><span class="a-cap">OpenAI / Anthropic / Codex 请求</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
<div class="a-tier">
|
||
<div class="a-node" style="--c:#f43f5e">
|
||
<span class="a-lay">L1</span>
|
||
<div class="a-tt"><i data-lucide="network" style="width:17px;height:17px"></i>接口与路由层</div>
|
||
<span class="a-path">app/api</span>
|
||
<div class="a-ds">解析外部请求,提供标准兼容路由与流式流控</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-split">
|
||
<div class="a-arrow"><span class="a-cap">会话分发 / 并发调度</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
<div class="a-arrow"><span class="a-cap">解析函数调用</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
</div>
|
||
<div class="a-row">
|
||
<div class="a-node" style="--c:#06b6d4">
|
||
<span class="a-lay">L2</span>
|
||
<div class="a-tt"><i data-lucide="layers" style="width:17px;height:17px"></i>标签页池与生命周期</div>
|
||
<span class="a-path">app/core/tab_pool</span>
|
||
<div class="a-ds">标签页保活、检测、重连,维护跨请求的会话重用</div>
|
||
</div>
|
||
<div class="a-node" style="--c:#f59e0b">
|
||
<span class="a-lay">L5</span>
|
||
<div class="a-tt"><i data-lucide="puzzle" style="width:17px;height:17px"></i>函数调用兼容层</div>
|
||
<span class="a-path">app/services/tool_calling</span>
|
||
<div class="a-ds">将 tool_calls 转译为提示词,网页端分步执行后合并返回</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-arrow"><span class="a-cap">网页驱动与交互操控</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
<div class="a-tier">
|
||
<div class="a-node" style="--c:#3b82f6">
|
||
<span class="a-lay">L3</span>
|
||
<div class="a-tt"><i data-lucide="cpu" style="width:17px;height:17px"></i>网页自动化执行引擎</div>
|
||
<span class="a-path">app/core/workflow</span>
|
||
<div class="a-ds">基于 DrissionPage 操控,内置指纹逃逸与低熵仿真操作</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-split">
|
||
<div class="a-arrow"><span class="a-cap">注入与响应拦截</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
<div class="a-arrow"><span class="a-cap">拦截指令钩子</span><span class="ln"></span><i data-lucide="chevron-down" class="tri" style="width:15px;height:15px"></i></div>
|
||
</div>
|
||
<div class="a-row">
|
||
<div class="a-node" style="--c:#10b981">
|
||
<span class="a-lay">L4</span>
|
||
<div class="a-tt"><i data-lucide="eye" style="width:17px;height:17px"></i>流式监控与响应解析</div>
|
||
<span class="a-path">app/core/parsers</span>
|
||
<div class="a-ds">监听网络事件与 DOM 变化,增量解析并实时流式推送</div>
|
||
</div>
|
||
<div class="a-node" style="--c:#8b5cf6">
|
||
<span class="a-lay">L6</span>
|
||
<div class="a-tt"><i data-lucide="terminal" style="width:17px;height:17px"></i>指令引擎与拦截钩子</div>
|
||
<span class="a-path">app/services/command_engine</span>
|
||
<div class="a-ds">内置指令拦截(附件验证、截屏),防注入与校验</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-base">
|
||
<div class="a-base-t"><i data-lucide="shield" style="width:14px;height:14px"></i>底层核心支撑模块</div>
|
||
<div class="a-row">
|
||
<div class="a-node" style="--c:#ec4899">
|
||
<span class="a-lay">L7</span>
|
||
<div class="a-tt"><i data-lucide="database" style="width:17px;height:17px"></i>配置与预设中心</div>
|
||
<span class="a-path">app/services/config</span>
|
||
<div class="a-ds">维护 sites.json 站点规则、环境状态检测,支持热重载</div>
|
||
</div>
|
||
<div class="a-node" style="--c:#6b7280">
|
||
<span class="a-lay">L8</span>
|
||
<div class="a-tt"><i data-lucide="wrench" style="width:17px;height:17px"></i>平台工具箱</div>
|
||
<span class="a-path">app/utils · app/models</span>
|
||
<div class="a-ds">日志存储与脱敏、多模态解析支持、全局数据模型</div>
|
||
</div>
|
||
</div>
|
||
<div class="a-rel">
|
||
<span>执行引擎 → 依赖 → 配置中心</span>
|
||
<span>指令引擎 → 读写 → 配置中心</span>
|
||
<span>流式监控 → 工具包 → 平台工具箱</span>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 02 使用预期 ============ -->
|
||
<section class="doc-section" id="notes">
|
||
<div class="sec-kicker"><span class="sec-num">02</span><span class="sec-tag">导览 · 必读</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="megaphone" style="width:20px;height:20px"></i></span>来自作者:使用预期<a class="h-anchor" href="#notes"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>这七条是作者的维护说明,动手前先扫一遍,遇到问题时能省不少排查时间。</p>
|
||
|
||
<div class="co co-danger">
|
||
<i data-lucide="alert-octagon" style="width:18px;height:18px"></i>
|
||
<div class="co-bd">
|
||
<span class="co-t">1 · 站点突然不能用了?优先检查选择器</span>
|
||
<p>网站改版后最易失效的是<strong>选择器</strong>(告诉脚本输入框、发送按钮、结果容器在哪的 CSS 规则)。大多数故障检查选择器即可,而非解析器。标准修法:</p>
|
||
<ol>
|
||
<li>在受控浏览器里对目标元素右键 →「检查」。</li>
|
||
<li>把元素树截图或复制出来发给 AI,让它写出新的选择器。</li>
|
||
<li>回控制台粘贴替换,重新测试。</li>
|
||
</ol>
|
||
<p>如果不是选择器问题,才轮到提取器 / 解析器——那需要拦截网络请求、分析响应结构,难度高得多。</p>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="grid2">
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="heart-handshake" style="width:17px;height:17px"></i></div>
|
||
<h5>2 · 各站点的维护覆盖范围</h5>
|
||
<p><strong>Gemini、DeepSeek</strong> 是作者日常使用最多、维护最及时的站点。其它站点不保证第一时间跟进,遇到问题更推荐加 QQ 群反馈,通常比 Issue 更快。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="puzzle" style="width:17px;height:17px"></i></div>
|
||
<h5>3 · Function Calling 尚不稳定</h5>
|
||
<p>它比较依赖模型本身的理解能力,可能存在一定问题。详见「函数调用」章节的预期管理。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="bot" style="width:17px;height:17px"></i></div>
|
||
<h5>4 · 遇到问题,优先让 AI 帮你分析</h5>
|
||
<p>选择器失效、配置写错、工作流顺序不对——把现象、日志截图、元素树交给 AI,通常比等人工回复快得多。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="bug" style="width:17px;height:17px"></i></div>
|
||
<h5>5 · 反馈 Bug 的正确姿势</h5>
|
||
<p>说清<strong>做了什么、期望什么、实际看到什么</strong>,附上 DEBUG 级别日志。表述不清时,先让 AI 帮你整理一版再发。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="share-2" style="width:17px;height:17px"></i></div>
|
||
<h5>6 · 修好了欢迎分享回来</h5>
|
||
<p>不管是更新的选择器还是补好的配置文件,分享给作者或群友都能让整个社区少走弯路。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="target" style="width:17px;height:17px"></i></div>
|
||
<h5>7 · 项目的核心场景</h5>
|
||
<p>本项目围绕<strong>酒馆 / RP(角色扮演)</strong>场景设计打磨。其它场景能用,但维护上偏向"能用就用,不保证持续深耕"。</p>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 03 快速开始 ============ -->
|
||
<section class="doc-section" id="quickstart" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">03</span><span class="sec-tag">上手指南</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="rocket" style="width:20px;height:20px"></i></span>快速开始<a class="h-anchor" href="#quickstart"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<div class="quickstart-welcome">
|
||
<div class="quickstart-welcome-icon"><i data-lucide="hand" style="width:22px;height:22px"></i></div>
|
||
<div>
|
||
<strong>欢迎使用 Universal Web-to-API</strong>
|
||
<p>本项目仅用于体验不同模型的效果,请合理控制使用频率,不要给目标网站带来额外负担。</p>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="quickstart-links" aria-label="开始方式">
|
||
<a href="#overview">
|
||
<span class="quickstart-link-icon"><i data-lucide="book-open" style="width:17px;height:17px"></i></span>
|
||
<span><strong>先了解项目基本原理</strong><small>花几分钟了解请求如何流转,以及某些操作为什么必不可少。</small></span>
|
||
<i data-lucide="arrow-right" style="width:17px;height:17px"></i>
|
||
</a>
|
||
<a href="#quickstart-browser">
|
||
<span class="quickstart-link-icon"><i data-lucide="zap" style="width:17px;height:17px"></i></span>
|
||
<span><strong>我已经了解,直接开始</strong><small>从识别受控浏览器开始,完成第一次连接。</small></span>
|
||
<i data-lucide="arrow-down" style="width:17px;height:17px"></i>
|
||
</a>
|
||
</div>
|
||
|
||
<h3 id="quickstart-browser">先区分受控浏览器和普通浏览器</h3>
|
||
<p>双击运行 <code>start.bat</code> 后,脚本会自动启动一个<strong>受控浏览器</strong>。打开 Windows 任务栏,你应该能看到它已经运行;接下来的登录和站点配置都要在这个浏览器里完成。</p>
|
||
<div class="browser-compare">
|
||
<div class="browser-kind is-controlled">
|
||
<span class="browser-kind-icon"><i data-lucide="scan-eye" style="width:18px;height:18px"></i></span>
|
||
<div><strong>受控浏览器</strong><p>由脚本启动并执行网页操作。请在这里打开 AI 站点、登录账号;API 请求执行期间,你可以正常操作或切换标签页查看内容。</p></div>
|
||
</div>
|
||
<div class="browser-kind">
|
||
<span class="browser-kind-icon"><i data-lucide="monitor" style="width:18px;height:18px"></i></span>
|
||
<div><strong>普通浏览器</strong><p>你日常使用、正在查看本教程的浏览器,不受脚本控制,也不能代替受控浏览器执行任务。</p></div>
|
||
</div>
|
||
</div>
|
||
|
||
<h3 id="quickstart-checklist">首次启动检查清单</h3>
|
||
<p>第一次运行时按“进程 → 端口 → 浏览器 → 站点 → API”的顺序确认,任何一步失败都先停在当前层排查,不要直接反复点击发送。</p>
|
||
<ol class="steps">
|
||
<li><strong>启动脚本没有立即退出。</strong><code>start.bat</code> 窗口应保持打开;若窗口闪退,在项目目录打开 PowerShell 执行 <code>python start.py</code>,保留完整错误信息。</li>
|
||
<li><strong>端口可访问。</strong>在普通浏览器打开 <code>http://127.0.0.1:8199/health</code>。返回 JSON 且 HTTP 状态为 <code>200</code> 表示服务和浏览器均已就绪;若为 <code>503</code>,服务还在但受控浏览器未连接。</li>
|
||
<li><strong>远程调试端口已监听。</strong>打开 <code>http://127.0.0.1:9222/json/version</code>;能看到 <code>Browser</code> 与 <code>webSocketDebuggerUrl</code> 才表示自动化连接正常。不要把该端口暴露到公网。</li>
|
||
<li><strong>标签页池有可用页面。</strong>控制面板 → 标签页池中至少有一个目标站点,状态为“空闲”;新标签页加载完成后等待 2–3 秒再刷新列表。</li>
|
||
<li><strong>先做最小请求。</strong>使用 <code>/v1/models</code> 检查路由,再发送一句短文本;确认成功后再启用流式、多模态或函数调用。</li>
|
||
</ol>
|
||
<div class="co co-warn">
|
||
<i data-lucide="stethoscope" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">端口检查失败时的快速判断</span><p><code>8199</code> 无响应通常是服务未启动或端口被占用;<code>/health</code> 返回 <code>503</code> 通常是 Chrome 尚未连上;<code>9222/json/version</code> 无响应则是浏览器启动参数、路径或端口冲突。先看启动窗口中的第一条 <code>[ERROR]</code>,再到「控制台 → 日志」按 <code>RequestID</code> 追踪。</p></div>
|
||
</div>
|
||
|
||
<h3>选择一个已适配的站点</h3>
|
||
<p>受控浏览器的基础引导会列出若干已经适配的站点。列表中存在的网站代表已经完成适配,你可以任选一个使用;本教程以 <strong>Gemini</strong> 为例。点击下方卡片复制网址,再粘贴到<strong>受控浏览器</strong>的地址栏中打开。</p>
|
||
<div class="site-grid" id="siteGrid"></div>
|
||
<div class="co co-info">
|
||
<i data-lucide="puzzle" style="width:18px;height:18px"></i>
|
||
<div class="co-bd">
|
||
<span class="co-t">想适配新的站点?不需要等待项目更新</span>
|
||
<p>你可以自行添加新站点,步骤并不复杂。请查看<a href="#addsite">「新增站点 · AI 识别」</a>,其中介绍了自动识别与手动配置两种方法。</p>
|
||
</div>
|
||
</div>
|
||
|
||
<h3 id="quickstart-gemini">以 Gemini 为例完成首次配置</h3>
|
||
<ol class="steps">
|
||
<li><strong>访问 Gemini。</strong>在受控浏览器中打开 <code>https://gemini.google.com/</code>,等待页面完整加载。</li>
|
||
<li><strong>登录个人账号。</strong>完成登录并进入真正可以发送消息的对话页面。</li>
|
||
<li><strong>整理页面状态。</strong>将页面语言设置为中文,并确保左侧聊天侧边栏处于展开状态;这是脚本稳定识别和操作页面的必要条件。</li>
|
||
<li><strong>确认标签页已被接管。</strong>打开「控制面板 → 标签页池」,此时应当能看到刚才打开的 Gemini 页面已经处于标签页池的控制之中。</li>
|
||
</ol>
|
||
|
||
<div class="hero-cta quickstart-actions">
|
||
<a class="btn btn-pri" href="http://127.0.0.1:8199/" target="_blank" rel="noopener"><i data-lucide="layout-dashboard" style="width:15px;height:15px"></i>打开控制面板</a>
|
||
<a class="btn btn-gh" href="#tabpool"><i data-lucide="layers" style="width:15px;height:15px"></i>了解标签页池</a>
|
||
</div>
|
||
|
||
<h3>连接你的客户端</h3>
|
||
<p>标签页进入控制后,选择合适的路由地址,填入任意支持 <strong>OpenAI 兼容接口</strong>的前端即可使用,例如 Chatbox、SillyTavern、Cherry Studio 等。</p>
|
||
<div class="quickstart-reference-links">
|
||
<a href="#routing-methods"><i data-lucide="route" style="width:16px;height:16px"></i><span>了解不同路由方式的区别</span><i data-lucide="arrow-right" style="width:15px;height:15px"></i></a>
|
||
<a href="#api-key-config"><i data-lucide="key-round" style="width:16px;height:16px"></i><span>配置 API 密钥</span><i data-lucide="arrow-right" style="width:15px;height:15px"></i></a>
|
||
</div>
|
||
|
||
<div class="co co-tip">
|
||
<i data-lucide="folder-sync" style="width:18px;height:18px"></i>
|
||
<div class="co-bd">
|
||
<span class="co-t">不想重新收藏网页或逐个登录?</span>
|
||
<p>你可以关闭浏览器后,复制一份自己现有的 Chrome 用户配置到项目专用的浏览器配置目录中,以复用书签、历史记录和登录状态。请不要直接使用正在运行的系统默认配置目录,也不要分享包含 Cookie 的配置副本。完整操作步骤与目录示例见<a href="#browser-profile-reuse">「浏览器登录态复用」</a>。</p>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 04 连接 API ============ -->
|
||
<section class="doc-section" id="connect" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">04</span><span class="sec-tag">上手指南</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="plug" style="width:20px;height:20px"></i></span>连接 API<a class="h-anchor" href="#connect"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>本项目提供兼容 <strong>OpenAI 格式</strong> 的接口,绝大多数支持"自定义 OpenAI 端点"的客户端都能直接使用。</p>
|
||
|
||
<h3 id="routing-methods">选择路由并填写连接信息</h3>
|
||
<div class="grid2">
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="server" style="width:17px;height:17px"></i></div>
|
||
<h5>服务提供商 Provider</h5>
|
||
<p>选择 <code>OpenAI</code> / <code>OpenAI 兼容</code> / <code>自定义</code>。不同客户端叫法不同,选那个能填写自定义地址的即可。</p>
|
||
</div>
|
||
<div class="q-card" id="api-key-config">
|
||
<div class="qc-ic"><i data-lucide="key-round" style="width:17px;height:17px"></i></div>
|
||
<h5>API 密钥</h5>
|
||
<p>未启用认证(<code>AUTH_ENABLED=false</code>)时填占位值如 <code>sk-local</code> 即可。启用后必须与 <code>.env</code> 的 <code>AUTH_TOKEN</code> 一致;控制面板密钥 <code>DASHBOARD_AUTH_TOKEN</code> 是另一套,不要提供给 API 使用者。</p>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>Base URL 形态</th><th>地址</th><th>适用场景</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>默认 · 自动分配</td><td><code>http://127.0.0.1:8199/v1</code></td><td>不关心具体站点或标签页时使用</td></tr>
|
||
<tr><td>指定站点域名</td><td><code>http://127.0.0.1:8199/url/gemini.google.com/v1</code></td><td>自动匹配该站点的标签页</td></tr>
|
||
<tr><td>指定标签页</td><td><code>http://127.0.0.1:8199/tab/1/v1</code></td><td>编号见「标签页池」,适合绑定过预设的标签页</td></tr>
|
||
<tr><td>指定完整 URL</td><td><code>http://127.0.0.1:8199/tab-url/{token}/v1</code></td><td>token 从「标签页池」复制,严格匹配当前 URL</td></tr>
|
||
<tr><td>站点 + 预设路径</td><td><code>http://127.0.0.1:8199/url/gemini.google.com/pro/v1</code></td><td>同一站点拆多种用途时最推荐,直接作为 Base URL</td></tr>
|
||
<tr><td>完整路径补全</td><td>在末尾补上 <code>/chat/completions</code></td><td>部分客户端要求填写完整接口路径</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<p><strong>模型名称 (Model)</strong>:建议填写便于客户端保存配置的占位名(如 <code>web-api</code>、<code>gemini-web</code>)。实际响应来源由当前打开的站点与预设决定。</p>
|
||
|
||
<div class="co co-tip">
|
||
<i data-lucide="check-circle-2" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">测试步骤</span><p>把地址、密钥、模型名填好后,<strong>直接发一句正常对话</strong>进行测试。不建议点客户端里的"测试 API"按钮——酒馆(SillyTavern)的测试按钮发送的请求过短,部分站点不会正常响应。</p></div>
|
||
</div>
|
||
|
||
<h3>单次请求指定预设的三种方式</h3>
|
||
<p>聊天接口支持直接指定 <code>preset_name</code>,只对<strong>当前这一次请求</strong>生效,不改变站点默认预设。</p>
|
||
<div class="cb" data-lang="bash"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">bash</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code># 方式 A:直接写进路径(最推荐,适合作为 Base URL)
|
||
curl "http://127.0.0.1:8199/url/gemini.google.com/pro/v1/chat/completions" ^
|
||
-H "Content-Type: application/json" ^
|
||
-d "{\"model\":\"any\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"
|
||
|
||
# 方式 B:放到 URL 查询参数
|
||
curl "http://127.0.0.1:8199/url/gemini.google.com/v1/chat/completions?preset_name=pro" -d "..."
|
||
|
||
# 方式 C:放到请求体
|
||
{"model":"any","messages":[...],"stream":false,"preset_name":"pro"}</code></pre></div>
|
||
<div class="co co-info">
|
||
<i data-lucide="info" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">优先级规则</span><p>三处都传了预设时,按 <strong>路径里的预设 > URL 查询参数 > 请求体</strong> 的顺序生效。</p></div>
|
||
</div>
|
||
|
||
<h3>查询参数与调度</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>参数</th><th>示例</th><th>作用</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>selector</code></td><td><code>?selector=round_robin</code></td><td><code>first_idle</code> 优先空闲(默认)/ <code>round_robin</code> 轮询 / <code>random</code> 随机</td></tr>
|
||
<tr><td><code>tab_index</code></td><td><code>?tab_index=2</code></td><td>在域名路由下进一步锁定某个固定标签页</td></tr>
|
||
<tr><td><code>preset_name</code></td><td><code>?preset_name=pro</code></td><td>本次请求临时覆盖预设</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>完整调用示例</h3>
|
||
<div class="cb" data-lang="bash"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">bash</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code># 1. 模型列表(连通性检查)
|
||
curl http://127.0.0.1:8199/v1/models
|
||
|
||
# 2. 默认聊天(自动分配标签页)
|
||
curl http://127.0.0.1:8199/v1/chat/completions ^
|
||
-H "Content-Type: application/json" ^
|
||
-d "{\"model\":\"any\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}],\"stream\":false}"
|
||
|
||
# 3. 按域名路由 + 轮询调度
|
||
curl "http://127.0.0.1:8199/url/gemini.google.com/v1/chat/completions?selector=round_robin" -d "..."
|
||
|
||
# 4. 按域名路由 + 固定标签页
|
||
curl "http://127.0.0.1:8199/url/gemini.google.com/v1/chat/completions?tab_index=2" -d "..."
|
||
|
||
# 5. 域名 + 预设路径
|
||
curl http://127.0.0.1:8199/url/gemini.google.com/pro/v1/chat/completions -d "..."
|
||
|
||
# 6. 精确 URL 路由(token 从标签页池复制)
|
||
curl http://127.0.0.1:8199/tab-url/abc123def456/v1/chat/completions -d "..."
|
||
|
||
# 7. 精确 URL 路由 + 预设路径
|
||
curl http://127.0.0.1:8199/tab-url/abc123def456/pro/v1/chat/completions -d "..."</code></pre></div>
|
||
|
||
<h3 id="api-reference">API 端点速查</h3>
|
||
<p>下面是日常集成会用到的公开端点。除 <code>/health</code> 外,服务端点是否要求认证取决于「系统设置」中的开关;启用后统一使用 <code>Authorization: Bearer <AUTH_TOKEN></code>,Anthropic 客户端也可使用 <code>x-api-key</code>。</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>方法</th><th>路径</th><th>用途 / 关键字段</th><th>认证</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>GET</code></td><td><code>/health</code></td><td>服务与受控浏览器健康检查;浏览器未连接时返回 <code>503</code></td><td>免认证</td></tr>
|
||
<tr><td><code>GET</code></td><td><code>/v1/models</code></td><td>列出当前可路由模型与站点;适合作为连通性探针</td><td>服务认证</td></tr>
|
||
<tr><td><code>POST</code></td><td><code>/v1/chat/completions</code></td><td>OpenAI Chat Completions;支持 <code>messages</code>、<code>stream</code>、<code>tools</code></td><td>服务认证</td></tr>
|
||
<tr><td><code>POST</code></td><td><code>/v1/responses</code></td><td>OpenAI Responses / Codex 兼容;支持 <code>input</code>、<code>instructions</code>、<code>previous_response_id</code></td><td>服务认证</td></tr>
|
||
<tr><td><code>POST</code></td><td><code>/v1/messages</code></td><td>Anthropic Messages / Claude Code 兼容;支持 <code>system</code>、<code>messages</code>、<code>max_tokens</code></td><td>服务认证</td></tr>
|
||
<tr><td><code>POST</code></td><td><code>/v1/messages/count_tokens</code></td><td>返回 Anthropic 客户端所需的最小 token 估算结果</td><td>服务认证</td></tr>
|
||
<tr><td><code>GET</code></td><td><code>/v1/provider/capabilities</code></td><td>机器可读能力清单、协议开关、模型列表与就绪度</td><td>服务认证</td></tr>
|
||
<tr><td><code>GET</code></td><td><code>/v1/provider/status</code></td><td>运行时快照:浏览器、标签页池、请求计数;不返回 Cookie 或令牌</td><td>服务认证</td></tr>
|
||
<tr><td><code>GET</code></td><td><code>/docs</code></td><td>FastAPI 交互式 OpenAPI 文档;仅在调试模式开启时提供</td><td>按部署配置</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
<div class="cb" data-lang="bash"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">bash</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code># 健康检查(无需令牌)
|
||
curl -i http://127.0.0.1:8199/health
|
||
|
||
# 开启认证后查询能力清单
|
||
curl http://127.0.0.1:8199/v1/provider/capabilities ^
|
||
-H "Authorization: Bearer YOUR_AUTH_TOKEN"
|
||
|
||
# Anthropic 客户端也可使用 x-api-key
|
||
curl http://127.0.0.1:8199/v1/messages/count_tokens ^
|
||
-H "x-api-key: YOUR_AUTH_TOKEN" -H "Content-Type: application/json" ^
|
||
-d "{\"model\":\"web-api\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"</code></pre></div>
|
||
|
||
<h3>响应头诊断</h3>
|
||
<p>路由类接口会返回诊断响应头,方便确认后端实际采用了哪种分配策略。</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>响应头</th><th>含义</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>X-Tab-Selection-Mode</code></td><td>实际选择模式:<code>first_idle</code> / <code>round_robin</code> / <code>random</code> / <code>tab_index</code> / <code>exact_url</code></td></tr>
|
||
<tr><td><code>X-Requested-Route-Domain</code></td><td>域名路由请求的目标域名;动态路由尚未选定标签页时也会返回</td></tr>
|
||
<tr><td><code>X-Resolved-Tab-Index</code></td><td>已明确解析到固定标签页时返回的编号</td></tr>
|
||
<tr><td><code>X-Resolved-Route-Domain</code></td><td>已解析标签页当前所属域名</td></tr>
|
||
<tr><td><code>X-Resolved-Exact-Url</code></td><td>精确 URL 路由最终命中的完整 URL</td></tr>
|
||
<tr><td><code>X-Resolved-Preset-Name</code></td><td>路径或参数最终命中的预设名称</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
<div class="co co-info">
|
||
<i data-lucide="info" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">动态域名路由说明</span><p>调用 <code>/url/{domain}/...</code> 且未传 <code>tab_index</code> 时,真正的标签页在工作流开始执行时才确定,因此这类响应只会带 <code>X-Requested-Route-Domain</code> 与 <code>X-Tab-Selection-Mode</code>,不会提前伪装成已解析到某个标签页。</p></div>
|
||
</div>
|
||
|
||
<h3>登录状态与上下文上限</h3>
|
||
<ul>
|
||
<li><strong>推荐登录:</strong>登录你自己的账号,本地接口才能继承当前会话的站点能力与历史上下文。</li>
|
||
<li><strong>免登录亦可:</strong>若网站在未登录状态下允许对话,无需登录也能直接通过 API 调用。</li>
|
||
</ul>
|
||
<div class="co co-warn">
|
||
<i data-lucide="alert-triangle" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">上下文长度限制</span><p>受网站输入框单次可容纳字符上限约束,上下文不能太长,否则请求直接失败。长文本场景请开启「文件粘贴」。已测试单次最大发送长度:<strong>ChatGPT 约 200k 字符</strong>;<strong>Gemini 无会员约 30k,Pro 会员目前无明确上限</strong>;<strong>Arena AI 约 120k</strong>。</p></div>
|
||
</div>
|
||
|
||
<h3>开发者协议兼容(实验性)</h3>
|
||
<div class="grid2">
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="terminal" style="width:17px;height:17px"></i></div>
|
||
<h5>Claude Code 连通性支持</h5>
|
||
<p>内置 Anthropic 风格协议的初步支持:兼容 <code>/v1/messages</code>、<code>/v1/messages/count_tokens</code>、<code>/v1/models</code>;除 <code>Authorization</code> 外亦解析 <code>x-api-key</code>,响应补充 <code>request-id</code> 诊断头。自 2026-05-28 起已完全适配。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="braces" style="width:17px;height:17px"></i></div>
|
||
<h5>Codex / Responses API(VSCode)</h5>
|
||
<p>暴露实验性 <code>/v1/responses</code> 端点,自动转换并复用 <code>/v1/chat/completions</code> 调度逻辑(支持 <code>input</code>、<code>instructions</code>、<code>tools</code> 载荷);流式模式生成 Codex 规范 SSE 事件,解决工具输出中断问题。</p>
|
||
</div>
|
||
</div>
|
||
<p style="color:var(--tx3);font-size:13.5px">以上协议由于缺乏大规模工具用例覆盖,实际稳定性请按需测试。</p>
|
||
</section>
|
||
|
||
<!-- ============ 05 控制台与监控 ============ -->
|
||
<section class="doc-section" id="dashboard" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">05</span><span class="sec-tag">上手指南</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="layout-dashboard" style="width:20px;height:20px"></i></span>控制台与请求监控<a class="h-anchor" href="#dashboard"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>控制台默认运行在 <a href="http://127.0.0.1:8199/" target="_blank" rel="noopener">http://127.0.0.1:8199/</a>。请求队列、运行日志和站点配置都在这里查看与管理。</p>
|
||
|
||
<div class="mock">
|
||
<div class="mock-bar"><i></i><i></i><i></i><span class="mock-url">127.0.0.1:8199</span></div>
|
||
<div class="mock-body">
|
||
<div class="mock-side"><div class="mi on"></div><div class="mi"></div><div class="mi"></div><div class="mi"></div><div class="mi"></div><div class="mi"></div><div class="mi"></div></div>
|
||
<div class="mock-main">
|
||
<div class="mock-row">
|
||
<div class="mock-kpi"><b>5 站点</b><span>Active Sites</span></div>
|
||
<div class="mock-kpi"><b>4 / 8</b><span>Tabs Idle</span></div>
|
||
<div class="mock-kpi"><b>99.4%</b><span>Success Rate</span></div>
|
||
</div>
|
||
<div class="mock-log">
|
||
<span class="l-acc">[ROUTE]</span> POST /url/gemini.google.com/v1/chat/completions<br>
|
||
<span class="l-acc">[POOL]</span> tab#3 acquired · routing groups match<br>
|
||
<span class="l-ok">[STREAM]</span> response finished · 6.8s (DOM Fallback)<br>
|
||
<span class="l-acc">[NetworkMonitor]</span> First response timeout 300s reached, falling back to StreamMonitor
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<p class="mock-cap">控制台界面结构示意</p>
|
||
|
||
<div class="grid3">
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="panel-left" style="width:17px;height:17px"></i></div>
|
||
<h5>中控侧边栏</h5>
|
||
<p>显示全局健康度与受控浏览器的连接状态(默认端口 9222),并可切换到首页、站点配置、标签页池、请求监控、命令、日志与设置。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="activity" style="width:17px;height:17px"></i></div>
|
||
<h5>请求监控 (Request Monitor)</h5>
|
||
<p>显示受控浏览器与后端的内存占用、累计请求量,以及<strong>历史请求明细与执行链追踪</strong>;点击单条记录可查看详情。</p>
|
||
</div>
|
||
<div class="q-card">
|
||
<div class="qc-ic"><i data-lucide="sliders-horizontal" style="width:17px;height:17px"></i></div>
|
||
<h5>动态管理</h5>
|
||
<p>为不同站点、不同标签页指派预设,配置工作流与拦截规则,或临时覆盖系统参数。</p>
|
||
</div>
|
||
</div>
|
||
|
||
<h3>请求异常调试与排查步骤</h3>
|
||
<p>请求出问题时,按下面的顺序排查:</p>
|
||
<ol class="steps">
|
||
<li><strong>查看请求监控列表</strong>:点击失败记录,检查该请求是在哪个阶段失败的——是排队获取标签页时超时(<code>acquire_timeout</code>,默认 60s),还是网络监听等首包响应时超时(<code>first_response_timeout</code>,默认 300s)。</li>
|
||
<li><strong>联合日志追踪</strong>:在日志页面中,通过请求的唯一 <code>RequestID</code> 或短追踪哈希,把 <code>[ROUTE]</code>(路由)、<code>[POOL]</code>(标签分配)、<code>[INPUT]</code>(输入)、<code>[STREAM]</code>(输出捕获)与 <code>[NetworkMonitor]</code> 各阶段的日志串起来看,定位卡在哪一步。</li>
|
||
<li><strong>隔离问题标签页</strong>:如果某个标签页频繁卡死或变慢,到「标签页池」查看它的锁定状态,用取消按钮中断,或调用调试接口释放。</li>
|
||
</ol>
|
||
|
||
<div class="co co-info">
|
||
<i data-lucide="braces" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">系统自愈与调试 API 接口</span>
|
||
<ul>
|
||
<li><code>GET /api/system/request-history?limit=200</code> — 读取近期请求审计记录(含报错日志摘要)</li>
|
||
<li><code>GET /api/system/request-history/{request_id}</code> — 读取单条请求详情(前端详情弹窗同款)</li>
|
||
<li><code>POST /api/debug/cancel-current</code> — 取消当前正在处理的阻塞请求,支持指定 <code>tab_id</code></li>
|
||
<li><code>POST /api/debug/force-release</code> — 强制清空所有请求锁和标签页锁,重置池状态(最后手段)</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 06 选择器配置 ============ -->
|
||
<section class="doc-section" id="selectors" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">06</span><span class="sec-tag">核心配置</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="crosshair" style="width:20px;height:20px"></i></span>选择器配置 Selectors<a class="h-anchor" href="#selectors"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>每个站点的每个预设都需要定义一组 CSS 选择器,告诉程序<strong>去哪里输入、点哪里发送、从哪里读回复</strong>。配置完全在控制台的可视化表单中回填,不需要修改任何 JSON 文件。这是所有配置里最关键、也最容易因网站改版而失效的部分。</p>
|
||
|
||
<h3>先认识 3 个核心字段(在选择器配置面板顶部输入)</h3>
|
||
<div class="grid3">
|
||
<div class="q-card"><div class="qc-ic"><i data-lucide="text-cursor-input" style="width:17px;height:17px"></i></div><h5>输入框选择器 (input_box)</h5><p>指定聊天输入框(如 <code>textarea</code>)在页面中的位置。<span class="bdg g">必填</span></p></div>
|
||
<div class="q-card"><div class="qc-ic"><i data-lucide="send" style="width:17px;height:17px"></i></div><h5>发送按钮选择器 (send_btn)</h5><p>网页上用于发送的按钮。<span class="bdg g">必填</span></p></div>
|
||
<div class="q-card"><div class="qc-ic"><i data-lucide="message-square-text" style="width:17px;height:17px"></i></div><h5>AI 回复容器 (result_container)</h5><p>AI 回复文本渲染所在的外层大容器。<span class="bdg g">必填 · 最易出错</span></p></div>
|
||
</div>
|
||
<p>各字段的常用填写示例:</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>界面配置输入框</th><th>常用填入示例(CSS选择器)</th><th>定位技巧说明</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><strong>输入框选择器 (input_box)</strong></td><td><code>textarea[id='prompt']</code> 或 <code>textarea</code></td><td>优先寻找含有 <code>id</code> 或专属 class 的 textarea 标签。</td></tr>
|
||
<tr><td><strong>发送按钮选择器 (send_btn)</strong></td><td><code>button.send-btn</code> 或 <code>button[aria-label="发送消息"]</code></td><td>选择含有发送小飞机图标或带有 Send 文本的 button 元素。</td></tr>
|
||
<tr><td><strong>AI 回复容器 (result_container)</strong></td><td><code>.markdown-body</code> 或 <code>div.message-content</code></td><td>务必选择<strong>包裹整条 AI 回复文本的外层容器</strong>。如果选小了,会漏抓格式或发生字符截断。</td></tr>
|
||
<tr><td><strong>新建对话按钮 (new_chat_btn)</strong></td><td><code>button.new-chat</code> 或 <code>a[href="/"]</code></td><td>页面左上角或侧栏的新建对话按钮,按需补充。</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<div class="co co-info">
|
||
<i data-lucide="lightbulb" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">怎么找得更稳</span>
|
||
<ul>
|
||
<li>在网页中右键点击目标元素(例如输入框) → 检查,查看其 HTML 属性。</li>
|
||
<li>优先使用 <code>id</code>、<code>data-testid</code>、<code>aria-label</code> 这类具有明确语义的属性定位;如果 Class 名字是一长串无规则的随机字母数字(动态混淆 Class),先别用它,否则网站一刷新或改版就会失效。</li>
|
||
<li>每一项输入完成后,点击右侧的<strong>【测试】</strong>按钮,确认能命中。</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
|
||
<h3>填写顺序建议</h3>
|
||
<ol class="steps">
|
||
<li>在受控浏览器中打开目标网站,右键输入框选择“检查元素”,把定位器填入 <code>input_box</code>。</li>
|
||
<li>再找到发送按钮,把其定位器填入 <code>send_btn</code>。</li>
|
||
<li>在对话框中发一条消息,等 AI 回复完毕后,找到<strong>包裹回复内容的最外层大 DIV</strong>,填入 <code>result_container</code>。</li>
|
||
<li>每填一项就点一次该字段右侧的「测试」,确认能命中——切忌全部填完再一起排查。</li>
|
||
<li>前三项稳定后,再考虑补充 <code>new_chat_btn</code> 或其他附件上传的选择器。</li>
|
||
</ol>
|
||
|
||
<div class="co co-tip">
|
||
<i data-lucide="flask-conical" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">选择器测试工作台</span><p>控制台里的测试按钮已升级为「选择器测试工作台」:点击后不仅能得出是否命中,还会以树形图返回<strong>命中 DOM 详情、系统推荐候选选择器、潜在定位风险</strong>,并支持点击推荐的候选一键回填到配置框中。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 07 工作流配置 ============ -->
|
||
<section class="doc-section" id="workflow" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">07</span><span class="sec-tag">核心配置</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="workflow" style="width:20px;height:20px"></i></span>工作流与可视化交互调优<a class="h-anchor" href="#workflow"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>工作流定义了一轮 API 交互在受控浏览器中的执行动作顺序(如清除历史、输入提示词、点击发送以及等待流式完成)。最新的工作流支持在控制台进行<strong>完全可视化的拖拽与编辑</strong>,无需编写 JSON 代码。</p>
|
||
|
||
<h3>可视化节点编辑器</h3>
|
||
<p>在站点配置的【请求工作流】区域,所有动作按执行顺序排成一条节点链:</p>
|
||
<ul>
|
||
<li><strong>添加步骤</strong>:点击“新增步骤”在链末追加动作卡片;也可以套用内置模板,一键生成最短可用工作流。</li>
|
||
<li><strong>调整顺序</strong>:按住卡片左侧拖动即可。</li>
|
||
<li><strong>删除步骤</strong>:点击卡片右上角的“垃圾桶”图标。</li>
|
||
<li><strong>标记必需 / 可选</strong>:每张卡片底部有一个“必需步骤”勾选框——默认勾选表示必需(找不到目标元素就报错);<strong>取消勾选即变为可选</strong>,找不到元素时会自动跳过该步骤。</li>
|
||
</ul>
|
||
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>界面动作节点</th><th>表单可配置属性</th><th>策略含义说明与调优推荐</th></tr></thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>CLICK</strong><br><small>点击元素</small></td>
|
||
<td>目标选择器 (Target)<br>验证点击结果 (Verify)<br>失败后自动重试</td>
|
||
<td>点击指定按钮(如 <code>new_chat_btn</code>)。勾选“验证点击”后会在点击后二次校验,没生效就自动重试,新建会话时很有用。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>FILL_INPUT</strong><br><small>填充输入</small></td>
|
||
<td>目标输入框选择器 (Target)<br>启用稳定等待</td>
|
||
<td>把提示词粘贴或键入目标输入框。建议勾选“输入框稳定等待”,避免页面没加载完导致粘贴粘连或失焦。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>WAIT</strong><br><small>延时等待</small></td>
|
||
<td>等待秒数 (Value)</td>
|
||
<td>暂停指定秒数(如 <code>0.5</code>),用于等待过渡动画或异步请求。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>KEY_PRESS</strong><br><small>按键</small></td>
|
||
<td>按键键值 (Target)<br>内置常用组合下拉</td>
|
||
<td>模拟键盘按键。发送按钮不可靠或不存在时,可以追加一个 <code>Enter</code> 动作触发发送;支持 <code>Ctrl+Enter</code>、<code>Shift+Enter</code> 等组合键。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>SELECT_MODEL</strong><br><small>选择请求模型</small></td>
|
||
<td>模型选择器 (Target)</td>
|
||
<td>在支持切换模型的站点上,按请求携带的模型名去页面上点选对应模型项,实现"同站点按模型分流"。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>PAGE_FETCH</strong><br><small>页面直发</small></td>
|
||
<td>发送方式(页面直发配置)</td>
|
||
<td>使用当前预设的"页面直发"配置直接提交已构造好的 Prompt(绕过逐步点选)。若直发失败且回退模式设为工作流,会继续执行后面的填入 / 按键 / 等待步骤兜底。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>COORD_CLICK</strong><br><small>坐标点击</small></td>
|
||
<td>X / Y(viewport 坐标)<br>随机半径</td>
|
||
<td>按 viewport CSS 坐标(非屏幕坐标)点击某个位置,可设随机半径抖动。适用于没有稳定选择器、只能靠位置点击的按钮。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>COORD_SCROLL</strong><br><small>模拟滑动</small></td>
|
||
<td>起点 / 终点坐标</td>
|
||
<td>在指定起终点之间模拟滚动。普通模式直接派发滚轮事件,低熵模式会按站点 stealth 配置走人类化轨迹。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>JS_EXEC</strong><br><small>执行 JavaScript</small></td>
|
||
<td>JavaScript 代码</td>
|
||
<td>在当前页面上下文执行一段自定义 JS,用于处理特殊弹窗、预处理页面状态等常规节点覆盖不到的场景。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>READONLY_HINT</strong><br><small>只读提示</small></td>
|
||
<td>标题 / 正文 / 语气</td>
|
||
<td>纯说明卡片,执行时<strong>不会</strong>点击、输入或等待页面,仅用于在工作流里给自己或他人留下备注。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>STREAM_WAIT</strong><br><small>等待输出捕获</small></td>
|
||
<td>结果容器选择器 (Target)</td>
|
||
<td>等待 AI 的流式响应输出结束,并捕获内容。<strong>常规 UI 工作流必须以它作为最终收尾步骤</strong>(改用 <code>PAGE_FETCH</code> 页面直发的链路除外)。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
<p style="color:var(--tx3);font-size:13.5px">下拉里的动作以控制面板实际选项为准;本表覆盖当前可选的全部节点类型。</p>
|
||
|
||
<h3>防风控与开头注入</h3>
|
||
<p>在防爬严格的站点(如 GPT、Gemini、Arena)上,频繁发送模式相似的 Prompt 容易触发限频。可在控制面板开启两种扰动手段:</p>
|
||
<ul>
|
||
<li><strong>开头追加随机占位片段</strong>:发送时在 Prompt 前自动加一段无意义前缀(如 <code>测试号,无实际意义: [随机混淆码]</code>),“开头片段数”与“说明文本”都可自定义,让每条请求内容不完全一致。</li>
|
||
<li><strong>提示词内随机字符插入</strong>:从自定义字符集(如 <code>abc123※☆</code>)中随机取一个字符,插入提示词的随机位置。</li>
|
||
</ul>
|
||
|
||
<h3>输入框稳定与自愈等待</h3>
|
||
<p>部分网站点击新建对话后会重建输入框节点,导致粘贴时失焦或失败。可在站点配置的【高级功能】中调整:</p>
|
||
<ul>
|
||
<li><strong>输入框稳定等待</strong>:执行 <code>FILL_INPUT</code> 前,先确认输入框节点连续多次检测保持稳定。</li>
|
||
<li><strong>自愈选项</strong>:可勾选“仅在刚点击 <code>new_chat_btn</code> 后启用”或“新建对话后等待 URL 切换”,配合“最长等待秒数”(如 <code>1.5</code> 秒)与“URL 匹配正则”,等页面就绪再填入。</li>
|
||
<li><strong>发送内容确认与自愈</strong>:点击 <code>send_btn</code> 后二次确认输入框已清空或明显变短;发现没发出去,就自动重试当前工作流。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<!-- ============ 08 响应检测 ============ -->
|
||
<section class="doc-section" id="response" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">08</span><span class="sec-tag">核心配置</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="radio-tower" style="width:20px;height:20px"></i></span>响应检测与自愈重试<a class="h-anchor" href="#response"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>系统需要判定 AI <strong>什么时候开始输出、什么时候算说完</strong>,并从中捕获流式文本。有两种检测模式,支持自动回退。</p>
|
||
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>检测模式</th><th>流式输出</th><th>工作方式</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>DOM 模式 <span class="bdg g">通用推荐</span></td><td>✅</td><td>监听网页 DOM 节点的字符变化,不需要了解站点接口,兼容性极高。</td></tr>
|
||
<tr><td>网络拦截模式</td><td>✅(需适配)</td><td>直接挂载 CDP 网络监听事件,阻断并获取 XHR/Fetch 数据包,还原代码和公式更精确。<strong>若首次响应超时,会自动向 DOM 模式回退。</strong></td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>网络监听超时自动回退</h3>
|
||
<p>网络拦截模式更精准,但网页改版或解析器报错时可能捕获失败,让请求一直挂着。对应的保护机制:</p>
|
||
<ul>
|
||
<li><strong>首次响应超时自动回退</strong>:发送后开始计时(<code>first_response_timeout</code>,默认 300s,在流式配置的 <code>network</code> 项下)。超时仍没有流量命中 <code>listen_pattern</code> 规则,就<strong>自动回退到 DOM 模式</strong>(<code>StreamMonitor</code>)继续从页面抓取文本,请求不会因此挂起。</li>
|
||
</ul>
|
||
|
||
<h3>发送确认与重试</h3>
|
||
<p>部分站点点击发送后偶发无响应,可在【发送确认与重试】中配置:</p>
|
||
<ul>
|
||
<li><strong>自动再点一次</strong>:点击 <code>send_btn</code> 后,若观察窗口内(如 <code>1.8</code> 秒)没有出现输入框清空、网络活动或生成状态,就再点一次发送。</li>
|
||
<li><strong>重试频次</strong>:最大支持重试 2 次,两次重试间隔支持定制(如 <code>0.6</code> 秒)。</li>
|
||
<li><strong>防中断保护</strong>:一旦判定 AI 已开始生成(或发送按钮变成了停止/中断状态),会<strong>立即停止重试</strong>,避免二次点击切断正在生成的回复。</li>
|
||
</ul>
|
||
|
||
<h3>DOM 模式结束判定公式</h3>
|
||
<div class="cb" data-lang="text"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">稳定判定条件</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code>生成结束判定 = (连续稳定次数 ≥ 稳定判定次数) AND (静默时间 > 静默超时阈值)</code></pre></div>
|
||
<p>DOM 检查时,内容没有再变化,稳定计数增加,静默时间累加。两个阈值同时达到时,判定本轮回复完成。全局硬超时(DOM 模式默认 <strong>600 秒</strong>,即浏览器常量里的「最大超时」;网络拦截模式则另有各自的首包与硬超时)是本轮监听的物理保底,无论如何都会在到点后强制收尾。</p>
|
||
</section>
|
||
|
||
<!-- ============ 09 预设系统 ============ -->
|
||
<section class="doc-section" id="presets" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">09</span><span class="sec-tag">核心配置</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="sliders-horizontal" style="width:20px;height:20px"></i></span>多预设管理系统<a class="h-anchor" href="#presets"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>预设允许你为<strong>同一个站点创建多套独立的配置方案</strong>,并分配给不同标签页。每个预设包含独立的选择器、工作流、流式配置、多模态提取、文件粘贴等全套配置,互不影响。</p>
|
||
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>标签页编号</th><th>绑定的预设名称</th><th>实际配置差异与工作场景</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>标签页 #1</td><td><strong>主预设 (默认)</strong></td><td>常规工作流(新建会话)、开启大文本文件粘贴。适用于大段长文本翻译。</td></tr>
|
||
<tr><td>标签页 #2</td><td><strong>快速识图</strong></td><td>简化工作流(不重置会话)、开启多模态图片提取、设置较短的响应超时。适用于识图。</td></tr>
|
||
<tr><td>标签页 #3</td><td><strong>网络拦截调试</strong></td><td>开启网络拦截模式、绑定专用解析器。适用于代码块与公式的精确截获。</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>预设操作</h3>
|
||
<p>都在【站点配置】面板里完成:</p>
|
||
<ol class="steps">
|
||
<li><strong>切换与新建</strong>:在页面顶部的“当前预设”下拉框选择要修改的预设,或点击<strong>【+ 新建预设】</strong>输入新名字。新预设会复制当前预设的全部参数,之后各自独立调整。</li>
|
||
<li><strong>管理与设为默认</strong>:点击下拉框旁的“管理预设”可以改名或删除。点击<strong>【⭐ 设为默认】</strong>后,该预设作为 API 请求的保底配置。</li>
|
||
<li><strong>绑定到标签页</strong>:切换到【标签页】选项卡,每一行代表一个正在运行的标签页,在“预设”列的下拉菜单里选中预设名即可绑定。</li>
|
||
<li><strong>单次请求临时覆盖</strong>:不想改绑定时,在请求 URL 上加参数(如 <code>/v1/chat/completions?preset_name=快速识图</code>),只对这一次请求生效。</li>
|
||
</ol>
|
||
|
||
<div class="co co-info">
|
||
<i data-lucide="info" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">自动持久化</span><p>面板上的新建、修改、删除都会自动保存到 <code>config/sites.json</code>,<strong>不需要手动编辑 JSON</strong>。</p></div>
|
||
</div>
|
||
|
||
<h3>对话复用与新建会话控制</h3>
|
||
<ul>
|
||
<li><strong>对话复用窗口(秒):</strong>大于 <code>0</code> 时,同一标签页在窗口期内收到的后续请求会直接复用当前会话续聊;设为 <code>0</code>(默认)表示关闭复用,每次请求都可能触发工作流开头的"新建会话"逻辑。</li>
|
||
<li><strong>强制新建对话:</strong>开启后即使配置了大窗口也忽略复用,<strong>每次都强制新开会话</strong>——特别适合测试无历史干扰的独立 Prompt 流程。</li>
|
||
</ul>
|
||
|
||
<div class="co co-warn">
|
||
<i data-lucide="alert-triangle" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">删除不可撤销</span><p>删除预设无法恢复,且每个站点至少需要保留一个预设——只剩一个时删除按钮会被禁用。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 10 标签页池 ============ -->
|
||
<section class="doc-section" id="tabpool" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">10</span><span class="sec-tag">核心配置</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="layers" style="width:20px;height:20px"></i></span>标签页池与会话隔离<a class="h-anchor" href="#tabpool"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>标签页池(Tab Pool)负责把并行的 API 请求排队、分发到合适的标签页,实现单浏览器多会话并行。</p>
|
||
|
||
<h3>核心生命周期与超时参数</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>配置参数</th><th>默认值</th><th>说明</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>max_tabs</code></td><td><code>5</code></td><td>允许开启的最大标签页数量上限。超出限制后,新请求必须排队等待。</td></tr>
|
||
<tr><td><code>min_tabs</code></td><td><code>1</code></td><td>保留在内存中的最小标签页数量,防止频繁开启/关闭页面。</td></tr>
|
||
<tr><td><code>idle_timeout</code></td><td><code>300</code> 秒</td><td>标签页空闲超时阈值。超过该时间没有任何 API 请求时,标签页会自动关闭释放内存。</td></tr>
|
||
<tr><td><code>acquire_timeout</code></td><td><code>60</code> 秒</td><td>API 请求排队获取空闲标签页的最长等待时间。超时则返回 429 或 504 错误。</td></tr>
|
||
<tr><td><code>stuck_timeout</code></td><td><code>180</code> 秒</td><td>页面交互卡死超时时间。由于 DOM 监听死锁或站点假死超过该时间,强制回收标签页。</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>独立 Cookie 标签页</h3>
|
||
<p>对 <code>arena.ai</code> 这类需要隔离 Cookie 的站点(避免多标签页共用同一登录会话),【高级功能】中提供:</p>
|
||
<ul>
|
||
<li><strong>独立 Cookie 标签页</strong>:开启后,该预设创建的标签页在独立的匿名会话容器中运行,各标签页的 Cookie、Local Storage 彼此隔离。</li>
|
||
<li><strong>自动接管手动新标签页</strong>:人工新建或弹出的标签页会被脚本接管,关闭原页面并转为独立的受控窗口。</li>
|
||
</ul>
|
||
|
||
<h3>域名路由分组 (Route Groups)</h3>
|
||
<p>用于多账号、多业务线的隔离。可以为不同请求定义专属的标签页路由组(在配置文件或标签面板管理):</p>
|
||
<ul>
|
||
<li><strong>工作逻辑</strong>:为指定域名(如 <code>chat.deepseek.com</code>)绑定一组专用标签页,或按传入的 URL token 指定独立会话。不同路由组互不干扰,可实现<strong>多账号轮询分流</strong>。</li>
|
||
<li><strong>分配策略 (allocation_mode)</strong>:支持 <code>first_idle</code>(最先空闲)、<code>round_robin</code>(同组轮询分摊)与 <code>random</code>(随机选择,防轨迹侦测)三种分发逻辑。</li>
|
||
<li><strong>错误标签页保留 (preserve_error_tabs)</strong>:勾选后,标签页发生严重错误或被风控拦截时<strong>不会被关闭</strong>,控制台亮起报警,方便进入受控浏览器人工处理。</li>
|
||
</ul>
|
||
|
||
<h3>常用路由方式一览</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>方式</th><th>接口 URL 格式</th><th>工作说明</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>自动分发</td><td><code>/v1/chat/completions</code></td><td>系统根据全局分配模式挑空闲页面。</td></tr>
|
||
<tr><td>域名指定</td><td><code>/url/gemini.google.com/v1/chat/completions</code></td><td>只分发到 gemini.google.com 的可用标签页。</td></tr>
|
||
<tr><td>标签指定</td><td><code>/tab/3/v1/chat/completions</code></td><td>只通过编号 #3 的标签页发送请求。</td></tr>
|
||
<tr><td>URL 短哈希</td><td><code>/tab-url/{token}/v1/chat/completions</code></td><td>路由到该 token 对应会话 URL 的标签页,严格匹配。</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
</section>
|
||
|
||
<!-- ============ 11 多模态提取 ============ -->
|
||
<section class="doc-section" id="multimodal" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">11</span><span class="sec-tag">高级能力</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="image" style="width:20px;height:20px"></i></span>多模态提取与媒体配置<a class="h-anchor" href="#multimodal"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>【多模态提取】面板管理如何从网页中提取<strong>图片、音频、视频</strong>,并转换成客户端可直接使用的本地链接或 Markdown 图片标签。全部在面板里配置,不需要改 JSON。</p>
|
||
|
||
<h3>1. 基础开关与提取范围</h3>
|
||
<ul>
|
||
<li><strong>启用多模态提取(开关)</strong>:全局总开关。勾选后,系统才会在对话完成时去扫描网页里的图片/视频。</li>
|
||
<li><strong>提取策略模式(下拉框)</strong>:
|
||
<ul>
|
||
<li><code>提取所有 (all)</code> — 网页上生成的全部图片或媒体文件一并打包返回。</li>
|
||
<li><code>仅首个 (first)</code> — 仅提取网页回答中出现的第一张图片,适合标准的单图输出场景。</li>
|
||
</ul>
|
||
</li>
|
||
<li><strong>媒体文件大小限制(数字输入框)</strong>:单位为 MB(默认 <code>10</code>)。超过此大小的媒体文件将被忽略,防止超大视频/无用底图占满服务器带宽。</li>
|
||
<li><strong>下载二进制资源 (Download Blobs)</strong>:开启后,自动下载网页里的二进制 Blob 媒体并转换为持久本地链接,防止因浏览器页面关闭导致临时链接失效。</li>
|
||
</ul>
|
||
|
||
<h3>2. 子模态参数配置(图片 / 音频 / 视频卡片)</h3>
|
||
<p>可分别为每种媒体开启提取,并配置对应的<strong>运行策略</strong>与<strong>等待时长</strong>:</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>界面配置项</th><th>可用运行策略(下拉菜单)</th><th>策略含义说明与推荐场景</th></tr></thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>启用状态 (Enabled)</strong><br><small>勾选框</small></td>
|
||
<td>无</td>
|
||
<td>控制是否启用当前类别(图片/音频/视频)的提取。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>运行策略 (Run Policy)</strong><br><small>下拉框</small></td>
|
||
<td>
|
||
① 仅普通扫描<br><code>(generic_only)</code><br>
|
||
② 按信号等待 <span class="bdg g">推荐</span><br><code>(on_signal)</code><br>
|
||
③ 有朗读按钮才探测<br><code>(probe_if_trigger_found)</code><br>
|
||
④ 始终等待<br><code>(always_probe)</code>
|
||
</td>
|
||
<td>
|
||
<ul>
|
||
<li><code>generic_only</code>:只快速扫一眼现有 DOM,不触发任何长等待或录音(如 Gemini 直连返回)。</li>
|
||
<li><code>on_signal</code>:当检测到正在生成的占位提示或正在上传的文件信号时才进行长等待,效率最高。</li>
|
||
<li><code>probe_if_trigger_found</code>:【音频专用】先侦测页面是否有可点的朗读/听书按钮,有才进入捕获流程。</li>
|
||
<li><code>always_probe</code>:强制每次对话完都硬等媒体加载,仅在确定每轮必出媒体时开启。</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>快速探测时间 (秒)</strong><br><small>数字框 (默认 1.0)</small></td>
|
||
<td>无</td>
|
||
<td>发送完消息后,先用很短的时间(如 1 秒)扫描有没有媒体生成信号;没有就直接结束,避免白等。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>最终等待时间 (秒)</strong><br><small>数字框</small></td>
|
||
<td>无</td>
|
||
<td>确认有生成信号后,给媒体加载与下载预留的最长时间(图片可填 45,视频可填 90)。超时仍没加载完则报错返回。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>3. 提取源定位(DOM 选择器配置)</h3>
|
||
<p>【元素选择器】用来告诉脚本媒体在页面的哪个位置,避免误抓广告或头像:</p>
|
||
<ul>
|
||
<li><strong>媒体选择器 (Selector)</strong>:指示媒体标签。例如图片填 <code>img</code>,视频填 <code>video, video source</code>。</li>
|
||
<li><strong>容器选择器 (Container Selector)</strong>:<strong>非常重要</strong>,用来圈定提取范围(如 <code>.result-content</code>)。系统<strong>只抓取该容器内的媒体</strong>,从而避开顶栏、侧边栏的无关图片。</li>
|
||
</ul>
|
||
|
||
<h3>4. 页面朗读音频捕获(TTS 语音录制)</h3>
|
||
<p>除了抓取网页里已有的 <code>audio</code> 节点外,如果想录制 AI 的“在线朗读”发音,可以展开并配置【朗读捕获】表单:</p>
|
||
<ul>
|
||
<li><strong>启用朗读录制 (audio_capture_enabled)</strong>:勾选后,系统会在文本输出完成后,去寻找并自动点击网页中的“朗读”或“发声”按钮来捕获音频。</li>
|
||
<li><strong>朗读按钮选择器 (audio_trigger_selector)</strong>:填入发音按钮的精确定位器。</li>
|
||
<li><strong>按钮文本兜底 (audio_trigger_labels)</strong>:当选择器不稳定时,可通过文字(如 <code>"朗读", "发音", "收听"</code>)匹配按钮。</li>
|
||
<li><strong>网络音频直抓 (url_patterns)</strong>:设置过滤关键词(如 <code>tts</code>、<code>voice</code>)后,播放时若有匹配的网络音频流,会优先直抓合成,失败时降级为页面内录音兜底。</li>
|
||
</ul>
|
||
|
||
<div class="co co-tip">
|
||
<i data-lucide="check-circle-2" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">返回格式</span><p>图片以 Markdown 标签 <code></code> 返回;音频、视频以链接 <code>[audio_0](/download_images/xxx.mp3)</code> 返回,SillyTavern 等客户端可以直接显示和播放。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 12 文件粘贴 ============ -->
|
||
<section class="doc-section" id="filepaste" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">12</span><span class="sec-tag">高级能力</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="paperclip" style="width:20px;height:20px"></i></span>文件与附件发送判定<a class="h-anchor" href="#filepaste"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>当 Prompt 超过网站输入框的长度限制时,系统会自动把它写入临时文件,通过网页的附件上传通道发给 AI,以此承载超长上下文。</p>
|
||
|
||
<h3>文件粘贴配置</h3>
|
||
<p>在站点配置的【文件粘贴模式】板块配置:</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>界面配置表单项</th><th>建议值/示例</th><th>作用说明与推荐场景</th></tr></thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>启用状态开关</strong></td>
|
||
<td>开启 / 关闭</td>
|
||
<td>控制是否启用大文本自动转化为文件上传的拦截机制。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>阈值 (字符数)</strong></td>
|
||
<td><code>40000</code></td>
|
||
<td>当输入的消息字符数超过该值时,自动拦截普通文本发送,转化为附件上传通道。建议设为目标网站输入框物理字数上限的 70% 左右。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>临时文件类型</strong><br><small>下拉菜单</small></td>
|
||
<td>
|
||
① <code>TXT</code><br>
|
||
② <code>PDF</code><br>
|
||
③ <code>ERROR</code>
|
||
</td>
|
||
<td>
|
||
<ul>
|
||
<li><code>TXT</code>:生成临时 <code>.txt</code> 纯文本文件并上传。最常用、速度快。</li>
|
||
<li><code>PDF</code>:生成临时 <code>.pdf</code> 文档并上传。在某些对 PDF 拥有深度阅读优化或只支持文档上传的 AI 平台上(如 Claude、Gemini 等),选择 PDF 格式常能获得更好的段落级格式保持。</li>
|
||
<li><code>ERROR</code>:不做转换上传,<strong>直接向 API 调用方抛出错误响应</strong>。适合需要对长提示词强制限额的场景。</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>引导文本</strong></td>
|
||
<td><code>上传的文件内容即为上下文,请据此回复</code></td>
|
||
<td>文件上传成功后,系统在聊天输入框里自动灌入并发送的指令文本,用来引导 AI 优先去阅读和分析刚刚上传的附件。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>上传信号超时 (秒)</strong></td>
|
||
<td><code>2.5</code> 秒</td>
|
||
<td>触发附件上传动作后,等待网页端成功弹出“上传中”或“挂载就绪”预览芯片的最长侦测等待时间。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>上传后稳定等待 (秒)</strong></td>
|
||
<td><code>0</code> 秒</td>
|
||
<td>识别到附件就绪后,额外静止等待多少秒再点击发送(针对网络卡顿或需要文件二次解析的网站)。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>上传完成后重新定位输入框</strong></td>
|
||
<td>勾选</td>
|
||
<td>部分网站(如 Claude)在上传完文件后,原输入框会强制失焦。勾选后系统会在发送前自动重新定位并聚焦输入框,防止发送失败。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>上传后专用输入框 selector</strong></td>
|
||
<td><code>.composer textarea</code></td>
|
||
<td>配合重新定位功能,指定上传完毕后重新聚焦哪一个输入框元素定位器(选填)。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>附件发送判定</h3>
|
||
<p>发送带附件的消息时(文件粘贴或图片粘贴),系统会观察预览就绪、发送按钮置灰、进入生成态等信号,确认附件真的发出去了:</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>界面配置项</th><th>设置推荐</th><th>作用说明</th></tr></thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>敏感度 (Sensitivity)</strong></td>
|
||
<td><code>高</code> / <code>中</code> / <code>低</code></td>
|
||
<td>敏感度越高,对附件预览挂载/消失的检测越严格,判断上传状态也越早。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>最大重试次数</strong></td>
|
||
<td><code>2</code> 次</td>
|
||
<td>检测到发送失败或附件未挂上时的最大自动重发次数。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>重试间隔</strong></td>
|
||
<td><code>0.6</code> 秒</td>
|
||
<td>发生重试发送动作时的两次点击间隔时间。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>最小冷却窗</strong></td>
|
||
<td><code>1.5</code> 秒</td>
|
||
<td>点击发送按钮到允许下一次发送的物理保护时间窗口,防止过度高频点击将页面判定卡死。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>重试前短探测</strong></td>
|
||
<td><code>0.12</code> 秒</td>
|
||
<td>重试点击前,先做一次快速 DOM 探测的等待时间。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>自动重试动作</strong></td>
|
||
<td><code>点击发送按钮</code> / <code>按键发送</code></td>
|
||
<td>重发时的驱动模式:支持点击网页 Send 按钮或模拟发送按键。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>重试按键 (retry_key)</strong></td>
|
||
<td><code>Enter</code> / 自定义组合</td>
|
||
<td>按键重试时的物理按键组合(支持 Enter、Ctrl+Enter 或 Shift+Enter)。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3>高级附件规则</h3>
|
||
<p>【高级附件规则】里还有几个开关:</p>
|
||
<ul>
|
||
<li><strong>发送前必须看到附件已挂上页面</strong>:上传预览渲染出来后才允许点发送,避免文件没挂上就把消息发出去。</li>
|
||
<li><strong>没有观察到上传启动前,不允许判定 ready</strong>:防止网络卡顿造成脚本还未来得及触发上传就直接判为就绪发送。</li>
|
||
<li><strong>发送未确认时允许自动重试</strong>:在点击发送后若检测到输入框残留,自动执行再次点击或再次按键。</li>
|
||
<li><strong>发送按钮变 stop 时禁止重试</strong> 与 <strong>页面进入生成态时禁止重试</strong>:两个防打断选项,一旦判定 AI 已经开始生成响应,无论输入框有无残留,均自动封禁重试,避免将已产出的回复打断。</li>
|
||
<li><strong>安全上传限制</strong>:临时文件异常、后缀敏感(如 <code>.exe</code>、<code>.bat</code>)或体积超出站点限制时,自动报错拦截。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<!-- ============ 13 函数调用 ============ -->
|
||
<section class="doc-section" id="toolcalling" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">13</span><span class="sec-tag">高级能力</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="puzzle" style="width:20px;height:20px"></i></span>函数调用 Tool Calling<a class="h-anchor" href="#toolcalling"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>本反代兼容 <strong>OpenAI 标准的 <code>tools</code> 格式</strong>:把函数定义转译成结构化的 XML 调用块(<code><adapter_calls></code> / <code><call></code> / <code><arg></code>)注入网页端,再把 AI 的输出解析回标准格式。</p>
|
||
|
||
<div class="co co-warn">
|
||
<i data-lucide="alert-octagon" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">底层工作逻辑</span><p>这不是官方 API 原生的函数调用。后端会将工具 schema 翻译成高可读性的 Prompt 注入会话首尾,在捕获到 XML 片段后,解析参数并回调本地执行。若返回格式错误,后端会自动发起<strong>单步聚焦修复</strong>或<strong>完整上下文修复</strong>重试。</p></div>
|
||
</div>
|
||
|
||
<h3>环境变量参数(设置 → 环境配置 → 函数调用)</h3>
|
||
<p>两个可调参数:</p>
|
||
<ul>
|
||
<li><strong>最大返回结果字符限制 (<code>TOOL_CALLING_MAX_TOOL_RESULT_CHARS</code>)</strong>:默认 <code>300,000</code> 字符,防止工具返回过大内容撑爆网页端的上下文窗口。</li>
|
||
<li><strong>零宽字符噪声注入 (<code>TOOL_CALLING_PROMPT_PADDING_ENABLED</code> 与 <code>TOOL_CALLING_PROMPT_PADDING_OBFUSCATE</code>)</strong>:注入工具提示词时随机混入零宽字符(<code>\u200b</code>、<code>\u200c</code>、<code>\u200d</code>),降低被站点自动过滤识别的概率。</li>
|
||
</ul>
|
||
|
||
<h3>两种内部修复策略</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>自愈策略</th><th>适合场景</th><th>工作特征</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>聚焦修复 <span class="bdg g">默认推荐</span></td><td>大多数常规 Tool Calling</td><td>仅发送“本次哪个字段或类型错了”及最小相关上下文,模型改动更精准。</td></tr>
|
||
<tr><td>完整上下文</td><td>复杂多重参数,模型多次报错依然修不对</td><td>将原对话与全量报错轨迹一并发回,信息更全,但可能分散小模型的注意力。</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
</section>
|
||
|
||
<!-- ============ 14 低熵模式 ============ -->
|
||
<section class="doc-section" id="stealth" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">14</span><span class="sec-tag">高级能力</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="ghost" style="width:20px;height:20px"></i></span>低熵模式(低干扰操作)<a class="h-anchor" href="#stealth"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>低熵模式把点击、移动、滚动和输入节奏做得更接近人工操作,用于改善某些站点上的界面兼容性和执行稳定性——不再是"瞬移 + 立即点击"的激进轨迹。</p>
|
||
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>操作</th><th>普通模式</th><th>低熵模式</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>点击</td><td>直接 CDP 命令</td><td>模拟按压 → 微移 → 释放</td></tr>
|
||
<tr><td>移动</td><td>瞬间跳转</td><td>人类化曲线移动</td></tr>
|
||
<tr><td>空闲</td><td>无动作</td><td>随机微漂移(模拟手抖)</td></tr>
|
||
<tr><td>滚动</td><td>直接调用</td><td>滚轮事件驱动</td></tr>
|
||
<tr><td>操作间隔</td><td>最小延迟</td><td>随机 0.1–0.3 秒</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<ul>
|
||
<li><strong>建议开启:</strong>页面对瞬时点击、直接粘贴或坐标跳变敏感的站点;普通模式下容易丢焦点、误判未发送、元素定位不稳定时。</li>
|
||
<li><strong>可以不开:</strong>普通模式已经长期稳定的站点。</li>
|
||
</ul>
|
||
<div class="co co-info">
|
||
<i data-lucide="map-pin" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">配置方式</span><p>控制面板 → 选择站点 → 页面顶部勾选「低熵模式」。该设置<strong>按预设独立保存</strong>。</p></div>
|
||
</div>
|
||
|
||
<h3>DrissionPage 补丁(必看)</h3>
|
||
<p>为了减少额外连接带来的兼容性问题,项目会给 DrissionPage 打一个小补丁,让网络监听尽量复用浏览器主连接,而不是额外新建连接。</p>
|
||
<ul>
|
||
<li><strong>自动执行:</strong>运行 <code>start.bat</code> 后自动安装依赖并执行补丁。</li>
|
||
<li><strong>手动执行:</strong><code>python patch_drissionpage.py</code></li>
|
||
<li><strong>恢复原文件:</strong><code>python patch_drissionpage.py --restore</code></li>
|
||
</ul>
|
||
<div class="co co-warn">
|
||
<i data-lucide="alert-triangle" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">重要</span><p>每次升级 DrissionPage 后都需要重新执行补丁。补丁支持重复执行,不用担心重复打坏。</p></div>
|
||
</div>
|
||
<div class="co co-danger">
|
||
<i data-lucide="shield-alert" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">Arena.ai 特别说明</span><p>即便开启低熵模式并关闭网络监听,半小时内连续对话约 10 条仍容易触发 Cloudflare 验证。该站点本身不适合长时间连续测试,低熵模式也不能保证稳定通过——更稳妥的做法仍然是降低频率。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 15 自动化命令 ============ -->
|
||
<section class="doc-section" id="commands" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">15</span><span class="sec-tag">自动化与系统</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="zap" style="width:20px;height:20px"></i></span>自动化命令与异常恢复<a class="h-anchor" href="#commands"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>自动化命令引擎按<strong>“触发条件 (Trigger) + 动作链 (Action Chain)”</strong>模式运行。配置位置:控制面板 → 命令。</p>
|
||
|
||
<div class="grid2">
|
||
<div class="q-card"><div class="qc-ic"><i data-lucide="mouse-pointer-click" style="width:17px;height:17px"></i></div><h5>简单触发动作链</h5><p>直接选择触发条件,并可视化配置动作步骤,如:检测到 429 报错时,自动清空 Cookie 刷新并重置。</p></div>
|
||
<div class="q-card"><div class="qc-ic"><i data-lucide="code-2" style="width:17px;height:17px"></i></div><h5>高级脚本模式</h5><p>直接编写 JavaScript 或 Python 后端脚本,适合复杂的动态判定、状态探测与外部系统联动。</p></div>
|
||
</div>
|
||
|
||
<h3>内置动作</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>动作名称</th><th>功能描述</th><th>核心参数</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>clear_cookies</code></td><td>清空受控浏览器当前标签页的缓存与 Cookie</td><td>无</td></tr>
|
||
<tr><td><code>refresh_page</code></td><td>刷新当前标签页</td><td>无</td></tr>
|
||
<tr><td><code>new_chat</code></td><td>重置/新建对话</td><td>绑定预设对应的 <code>new_chat_btn</code></td></tr>
|
||
<tr><td><code>run_js</code> / <code>run_js_file</code></td><td>在页面沙箱中执行 JS 代码段或读取本地 JS 文件运行</td><td>JS 字符串/文件路径</td></tr>
|
||
<tr><td><code>wait</code></td><td>显式延迟等待(防操作粘连)</td><td>秒数(如 <code>1.5</code>)</td></tr>
|
||
<tr><td><code>execute_preset</code></td><td>为该标签页切换并绑定新的站点预设</td><td>预设 ID</td></tr>
|
||
<tr><td><code>execute_workflow</code></td><td>手动触发当前预设的某个工作流</td><td>工作流 ID</td></tr>
|
||
<tr><td><code>navigate</code></td><td>导航控制跳转至新的 URL</td><td>目标 URL</td></tr>
|
||
<tr><td><code>switch_proxy</code></td><td>切换 Clash 代理组节点,更换出口 IP 以应对限频。</td><td>Clash API 端口与新节点名称</td></tr>
|
||
<tr><td><code>send_webhook</code></td><td>向外部服务器发送 Webhook 通知告警(如企业微信/钉钉/TG/Server酱)</td><td>URL、Payload、Header</td></tr>
|
||
<tr><td><code>send_napcat</code></td><td>联动 NapCat 机器人发送 QQ 消息提醒。</td><td>NapCat 接口地址与目标 QQ/群号</td></tr>
|
||
<tr><td><code>click_captcha_challenge</code></td><td>检测到 Cloudflare Turnstile 等人机验证时,自动寻找并点击验证按钮。</td><td>验证码选择器</td></tr>
|
||
<tr><td><code>click_element</code> / <code>click_coordinates</code></td><td>按选择器点击页面元素,或按 viewport 坐标点击指定位置。</td><td>元素选择器 / X、Y 坐标</td></tr>
|
||
<tr><td><code>write_element</code> / <code>read_element</code></td><td>在受控页面直接读取或写入指定 DOM 元素 / 本地存储。</td><td>元素选择器、写入数据/变量名</td></tr>
|
||
<tr><td><code>http_request</code></td><td>直接在当前受控网页的 Fetch 域中发起自定义网络请求。</td><td>URL、Method、Payload</td></tr>
|
||
<tr><td><code>append_file</code></td><td>将命令输出结果或报错数据追加写入到本地文件归档。</td><td>本地文件绝对/相对路径</td></tr>
|
||
<tr><td><code>execute_command_group</code></td><td>调用并执行另一组已定义的命令组,便于复用与串联多条自愈链。</td><td>目标命令组名称 / ID</td></tr>
|
||
<tr><td><code>abort_task</code> / <code>release_tab_lock</code></td><td>强制中断当前 API 任务,或强制释放标签页锁</td><td>中断理由</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<div class="co co-tip">
|
||
<i data-lucide="lightbulb" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">典型组合:封禁自动恢复</span><p>创建 <code>network_request_error</code> 触发器(过滤 <code>429</code> 或 <code>403</code>),动作链依次配置 <code>clear_cookies</code> → <code>switch_proxy</code>(换出口 IP)→ <code>refresh_page</code> → <code>new_chat</code>。被限频后几秒内即可自动恢复重试。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 16 新增站点 · AI 识别 ============ -->
|
||
<section class="doc-section" id="addsite" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">16</span><span class="sec-tag">上手指南</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="plus-circle" style="width:20px;height:20px"></i></span>新增站点配置流程<a class="h-anchor" href="#addsite"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>接入一个未适配的 AI 聊天网站,有两条路线:<strong>AI 自动分析生成</strong>,或<strong>纯手动配置</strong>。</p>
|
||
|
||
<h3>路线 A:辅助 AI 自动分析 <span class="bdg g">推荐</span></h3>
|
||
<p>让辅助 AI 分析目标网页的 HTML,自动生成一套可用的初始选择器:</p>
|
||
<ol class="steps">
|
||
<li>在受控浏览器里,新开标签页打开你想接入的 AI 聊天主页,并确保已经登录完成、停在对话输入页面。</li>
|
||
<li>对该站点发起<strong>第一次真实 API 请求</strong>(例如请求路由为:<code>/url/example-ai.com/v1/chat/completions</code>)。</li>
|
||
<li>后端发现这是个未配置的新域名,会自动捕获页面 DOM,调用设置中配置好的辅助 AI 接口分析。</li>
|
||
<li>分析通过后,自动为该域名生成初始主预设,写入识别到的选择器与最短工作流。</li>
|
||
</ol>
|
||
<div class="co co-warn">
|
||
<i data-lucide="key-round" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">重要细节</span><p>自动分析只有在<strong>对未知域名发起第一次真实 API 请求时</strong>才会触发。仅仅在控制面板上点击“新增站点”或者是只在浏览器里打开网页但不发 API 请求,辅助 AI 是不会启动扫描的。</p></div>
|
||
</div>
|
||
<div class="co co-tip">
|
||
<i data-lucide="check-circle-2" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">如何确认识别成功</span>
|
||
<ul>
|
||
<li>在【日志】页面中,会亮起 <code>[AI分析]</code> 日志字样,最终显示“分析完成,配置已自动写入 sites.json”。</li>
|
||
<li>刷新控制台,左侧站点导航列表中会多出这个新增的域名。</li>
|
||
<li>进入该站点的配置面板检查各选择器字段。<strong>务必人工核对 <code>result_container</code>(AI 回复容器)</strong>——页面嵌套过深时,这是辅助 AI 最容易认偏的字段。</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
|
||
<h3>路线 B:手动在控制面板配置调试</h3>
|
||
<p>没有配置辅助 AI 密钥,或页面 JS 混淆严重时,直接手动配置:</p>
|
||
<ol class="steps">
|
||
<li>点击控制台左侧侧边栏下方的<strong>【新增站点】</strong>按钮,在弹出的窗口里输入目标站点的域名(如 <code>chat.example.com</code>)。</li>
|
||
<li>在左侧列表点击新域名,系统会初始化一个“空白主预设”。</li>
|
||
<li>去目标站点右键检查元素,将核心三项(<code>input_box</code>、<code>send_btn</code>、<code>result_container</code>)填入选择器表单中。</li>
|
||
<li>在【工作流】节点链中拼出<strong>最短可用步骤</strong>(见下)。</li>
|
||
<li>依次点击核心字段右侧的“测试”,调试无误后保存。</li>
|
||
</ol>
|
||
|
||
<h3>最短可用工作流</h3>
|
||
<p>能驱动绝大多数聊天网站的最简节点顺序如下,点【+ 增加步骤】依次拼入:</p>
|
||
<ol class="steps">
|
||
<li><code>CLICK</code> 节点:目标填入 <code>new_chat_btn</code>,<strong>取消勾选“必需步骤”</strong>(即标记为可选),以防首次打开本就处于新对话时点击失败。</li>
|
||
<li><code>WAIT</code> 节点:时值设为 <code>0.5</code> 秒,给页面重置预留少许过渡时间。</li>
|
||
<li><code>FILL_INPUT</code> 节点:目标填入 <code>input_box</code>。这是将用户提示词灌入输入框的必需步骤。</li>
|
||
<li><code>CLICK</code> 节点:目标填入 <code>send_btn</code>,用于点击发送按钮。</li>
|
||
<li><code>KEY_PRESS</code> 节点:目标填入 <code>Enter</code>,<strong>取消勾选“必需步骤”</strong>(标记为可选),可在部分回车也能发送的网站上作为备用指令。</li>
|
||
<li><code>STREAM_WAIT</code> 节点:目标填入 <code>result_container</code>。用于捕获流式输出。<strong>必须以此步骤作为整条工作流的最终结尾。</strong></li>
|
||
</ol>
|
||
|
||
<p><strong>调试顺序:</strong>按<code>输入框</code> → <code>发送按钮</code> → <code>回复容器</code>的顺序逐项测试选择器,三项都通过后再跑工作流;基本对话跑通后,最后再调文件粘贴阈值与多模态参数。</p>
|
||
</section>
|
||
|
||
<!-- ============ 17 系统设置与配置 ============ -->
|
||
<section class="doc-section" id="settings" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">17</span><span class="sec-tag">自动化与系统</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="settings-2" style="width:20px;height:20px"></i></span>系统设置与配置管理<a class="h-anchor" href="#settings"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
<p>环境配置在控制面板 → 设置 → 环境配置中修改,主要放端口、认证、代理、辅助 AI 等<strong>全局设置</strong>——改完通常需要<strong>重启服务</strong>才能生效。</p>
|
||
|
||
<h3 id="security-boundary">安全边界与部署建议</h3>
|
||
<p>本项目默认面向<strong>单机、本地回环</strong>场景。它会代替你操作已登录的网页,并在日志、请求历史和浏览器配置中接触敏感内容;请把 API、控制面板和调试端口视为同一台机器上的高权限本地服务。</p>
|
||
<div class="co co-danger">
|
||
<i data-lucide="shield-alert" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">不要直接暴露到局域网或公网</span>
|
||
<ul>
|
||
<li><code>APP_HOST=127.0.0.1</code> 是默认且推荐值;改成 <code>0.0.0.0</code> 后,任何能访问该端口的设备都可能调用你的登录态网页。</li>
|
||
<li>对外提供服务时必须同时开启 <code>AUTH_ENABLED=true</code> 与高强度随机 <code>AUTH_TOKEN</code>;控制面板使用独立的 <code>DASHBOARD_AUTH_TOKEN</code>,不要混用或分享。</li>
|
||
<li>仅靠 CORS 不能保护 API。CORS 只约束浏览器跨域读取,脚本、命令行和同网段客户端仍可直接发请求;安全控制应依赖监听地址、防火墙和令牌。</li>
|
||
<li>远程调试端口 <code>BROWSER_PORT=9222</code> 不具备应用层认证。务必仅监听本机,不要做端口转发,也不要把 <code>chrome_profile/</code>、Cookie 或日志目录提交到仓库。</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<div class="cb" data-lang="bash"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">.env(本机推荐)</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code># 仅本机监听;不要改成 0.0.0.0 再依赖 CORS 兜底
|
||
APP_HOST=127.0.0.1
|
||
APP_PORT=8199
|
||
BROWSER_PORT=9222
|
||
|
||
# 即使只在本机,也建议给脚本客户端设置令牌
|
||
AUTH_ENABLED=true
|
||
AUTH_TOKEN=请替换为至少32位的随机字符串
|
||
|
||
# 控制面板使用独立令牌;留空时才会沿用 AUTH_TOKEN
|
||
DASHBOARD_AUTH_ENABLED=true
|
||
DASHBOARD_AUTH_TOKEN=请替换为另一枚随机字符串
|
||
|
||
# 不需要跨域时关闭;需要时填写明确来源,不要长期使用 *
|
||
CORS_ENABLED=false
|
||
CORS_ORIGINS=http://127.0.0.1:8199</code></pre></div>
|
||
<div class="co co-warn">
|
||
<i data-lucide="file-warning" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">日志与备份也属于敏感数据</span><p>请求历史可能包含提示词、模型输出、站点域名和错误摘要。共享日志前先删除 Authorization、Cookie、完整 URL、图片 Data URI 与个人信息;导出配置或提交 Issue 前同样检查 <code>config/</code>、<code>logs/</code>、<code>chrome_profile/</code>。</p></div>
|
||
</div>
|
||
|
||
<h3>环境配置速查</h3>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>分组</th><th>配置项</th><th>当前值</th><th>说明</th></tr></thead>
|
||
<tbody>
|
||
<tr><td rowspan="4">服务</td><td>监听地址</td><td><code>127.0.0.1</code></td><td><code>0.0.0.0</code> 允许外部访问,127.0.0.1 仅本地</td></tr>
|
||
<tr><td>监听端口</td><td><code>8199</code></td><td>HTTP 服务端口</td></tr>
|
||
<tr><td>调试模式</td><td><code>false</code></td><td><code>APP_DEBUG=true</code> 才开启 <code>/docs</code>、<code>/redoc</code> 与详细错误信息;生产环境建议保持关闭</td></tr>
|
||
<tr><td>日志级别</td><td><code>INFO</code></td><td>DEBUG / INFO / WARNING / ERROR</td></tr>
|
||
<tr><td rowspan="2">认证</td><td>启用认证</td><td>关闭</td><td>是否要求 API 调用提供 Bearer Token</td></tr>
|
||
<tr><td>Bearer Token</td><td>空</td><td>启用认证时必须设置;用法 <code>curl -H "Authorization: Bearer YOUR_TOKEN" …</code></td></tr>
|
||
<tr><td rowspan="2">CORS</td><td>启用 CORS</td><td>开启</td><td>是否允许跨域请求</td></tr>
|
||
<tr><td>允许的跨域源</td><td><code>*</code></td><td>多个用逗号分隔,* 表示全部允许</td></tr>
|
||
<tr><td rowspan="3">代理</td><td>启用代理</td><td>关闭</td><td>开启后浏览器经代理服务器访问网络</td></tr>
|
||
<tr><td>代理地址</td><td><code>socks5://127.0.0.1:1080</code></td><td>支持 socks5:// 或 http://</td></tr>
|
||
<tr><td>绕过代理</td><td><code>localhost,127.0.0.1</code></td><td>不走代理的地址,逗号分隔</td></tr>
|
||
<tr><td rowspan="4">AI 分析</td><td>API Key</td><td>空</td><td>辅助 AI 的 API 密钥</td></tr>
|
||
<tr><td>API 地址</td><td><code>http://127.0.0.1:8199/url/gemini.google.com/v1</code></td><td>API 基础 URL(默认回指反代自身的 Gemini 路由,可改为任意 OpenAI 兼容端点)</td></tr>
|
||
<tr><td>模型名称</td><td><code>gemini-3.0-pro</code></td><td>使用的模型</td></tr>
|
||
<tr><td>HTML 最大字符数</td><td><code>120000</code></td><td>超过会截断以节省 Token</td></tr>
|
||
<tr><td>浏览器</td><td>Chrome 调试端口</td><td><code>9222</code></td><td>浏览器远程调试端口</td></tr>
|
||
<tr><td>文件</td><td>站点配置文件路径</td><td><code>sites.json</code></td><td>站点配置存放位置</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
|
||
<h3 id="browser-profile-reuse">浏览器登录态复用(高级)</h3>
|
||
<p>希望脚本启动后直接继承你平时浏览器里的登录状态、Cookie 和扩展?请使用<strong>独立复制出来的用户数据目录</strong>,不要直接把脚本指向日常正在使用的系统默认目录。</p>
|
||
<div class="co co-danger">
|
||
<i data-lucide="alert-octagon" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">两个必须知道的坑</span>
|
||
<ol>
|
||
<li><strong>Chrome 136+ 安全调整:</strong>默认 Chrome 数据目录不再接受 <code>--remote-debugging-port</code>。把 <code>BROWSER_PROFILE_DIR</code> 直接写成系统默认 <code>User Data</code>,浏览器会被打开但调试端口起不来,脚本无法接管。见 <a href="https://developer.chrome.com/blog/remote-debugging-port" target="_blank" rel="noopener">Chrome 官方说明</a>。</li>
|
||
<li><strong>会话数据风险:</strong>浏览器用户目录可能包含登录态、Cookie、本地缓存和扩展数据。只建议复制<strong>你自己的本机目录副本</strong>用于本机调试;不要打包分享、提交仓库或发给别人。</li>
|
||
</ol>
|
||
</div>
|
||
</div>
|
||
<ol class="steps">
|
||
<li><strong>确认原配置位置。</strong>在日常 Chrome 地址栏打开 <code>chrome://version</code>,记下「个人资料路径」;它通常类似 <code>...\Google\Chrome\User Data\Default</code>。</li>
|
||
<li><strong>完全退出浏览器和脚本。</strong>关闭所有 Chrome 窗口,并确认任务栏中没有仍在运行的 Chrome;复制使用中的配置容易得到不完整文件。</li>
|
||
<li><strong>复制必要内容。</strong>从原始 <code>...\Google\Chrome\User Data</code> 根目录复制 <code>Local State</code>,再复制刚才确认的配置子目录(如 <code>Default</code>、<code>Profile 1</code>)。</li>
|
||
<li><strong>放入项目专用目录。</strong>把上一步的内容粘贴到项目根目录的 <code>chrome_profile/</code> 中。完成后应能看到 <code>chrome_profile\Local State</code> 和 <code>chrome_profile\Default</code>(或对应的 <code>Profile N</code>)。</li>
|
||
<li><strong>选择对应配置并重启。</strong>在 <code>.env</code> 中保持 <code>BROWSER_PROFILE_DIR</code> 为空,并把 <code>BROWSER_PROFILE_NAME</code> 写成复制过来的子目录名称;然后重新运行 <code>start.bat</code>。</li>
|
||
</ol>
|
||
<div class="cb" data-lang="bash"><div class="cb-top"><span class="cb-dots"><i></i><i></i><i></i></span><span class="cb-lang">.env</span><button class="cb-copy"><i data-lucide="copy" style="width:12px;height:12px"></i><span>复制</span></button></div><pre><code>BROWSER_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe
|
||
# 留空时使用项目根目录的 chrome_profile/
|
||
BROWSER_PROFILE_DIR=
|
||
# 必须与复制进 chrome_profile/ 的子目录名一致
|
||
BROWSER_PROFILE_NAME=Default</code></pre></div>
|
||
<div class="co co-info">
|
||
<i data-lucide="folder-cog" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">也可以把副本放在项目外</span><p>如果不想占用项目目录,可新建 <code>C:\Users\你的用户名\AppData\Local\UniversalWebApiProfile</code>,放入相同的 <code>Local State</code> 与配置子目录,再将 <code>BROWSER_PROFILE_DIR</code> 指向这个根目录。不要把它写到 <code>...\Default</code> 这一层。</p></div>
|
||
</div>
|
||
<div class="co co-warn">
|
||
<i data-lucide="alert-triangle" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">容易写错的地方</span><p><code>BROWSER_PROFILE_DIR</code> <strong>不要</strong>写成 <code>...\User Data\Default</code>——它应该指向 <code>User Data</code> 这一层的"根目录";具体用哪个子配置文件夹,写在 <code>BROWSER_PROFILE_NAME</code>(常见值 <code>Default</code>、<code>Profile 1</code>、<code>Profile 2</code>)。</p></div>
|
||
</div>
|
||
<div class="co co-tip">
|
||
<i data-lucide="lightbulb" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">不在乎沿用登录态?</span><p>最省心:留空 <code>BROWSER_PROFILE_DIR</code>,让项目继续使用根目录的 <code>chrome_profile/</code>。隔离最彻底,也最不容易和日常 Chrome 互相影响——对大多数用户这是默认推荐方案。</p></div>
|
||
</div>
|
||
|
||
<h3>浏览器常量(即时生效,无需重启)</h3>
|
||
<p>控制面板 → 设置 → 浏览器常量。这里更适合放"运行时调优"参数:响应检测、操作延迟、标签页池回收等。下表按仓库当前 <code>config/browser_config.json</code> 列示,若你在面板中改过值,应以面板显示的实际值为准;首次启动时缺少配置文件则会回退到代码内置默认值。</p>
|
||
<div class="tw"><table class="tbl">
|
||
<thead><tr><th>分组</th><th>配置项</th><th>默认值</th><th>说明</th></tr></thead>
|
||
<tbody>
|
||
<tr><td rowspan="2">连接</td><td>调试端口</td><td><code>9222</code></td><td>Chrome DevTools 远程调试端口</td></tr>
|
||
<tr><td>连接超时</td><td><code>10</code> 秒</td><td>浏览器连接超时时间</td></tr>
|
||
<tr><td rowspan="4">操作延迟</td><td>低熵延迟下限 / 上限</td><td><code>0.03</code> / <code>0.1</code> 秒</td><td>低熵操作的随机延迟范围</td></tr>
|
||
<tr><td>动作延迟下限 / 上限</td><td><code>0.06</code> / <code>0.14</code> 秒</td><td>点击 / 输入等动作的随机延迟,防止被识别为机器人</td></tr>
|
||
<tr><td>默认 / 备用等待</td><td><code>3</code> / <code>1</code> 秒</td><td>查找元素的超时与首次失败重试超时</td></tr>
|
||
<tr><td>缓存有效期</td><td><code>5</code> 秒</td><td>元素位置缓存时间</td></tr>
|
||
<tr><td rowspan="4">响应检测 🔑</td><td>检查间隔(下 / 默认 / 上)</td><td><code>0.3 / 0.5 / 1.0</code> 秒</td><td>轮询检测频率范围;默认间隔会在上下限之间动态调整</td></tr>
|
||
<tr><td><strong>静默超时阈值</strong></td><td><code>5.0</code> 秒</td><td>🔑 内容不再变化多久后判定完成(备用阈值 <code>6.0</code> 秒)</td></tr>
|
||
<tr><td><strong>稳定判定次数</strong></td><td><code>6</code> 次</td><td>🔑 连续多少次检查不变判定完成</td></tr>
|
||
<tr><td>最大超时</td><td><code>600</code> 秒</td><td>单次请求绝对超时上限</td></tr>
|
||
<tr><td rowspan="3">高级</td><td>首段响应初始等待</td><td><code>180</code> 秒</td><td>发送后等待页面开始出现回复的最长时间</td></tr>
|
||
<tr><td>内容收缩阈值</td><td><code>3</code> 字符</td><td>允许正文回缩的最大字符数,超过才视为异常回退——思考模型折叠思维链时可见文本会短暂缩短,此参数用作容差防误判</td></tr>
|
||
<tr><td>元素丢失上限</td><td><code>10</code> 次</td><td>响应节点连续丢失达到上限后退出本轮监听;这是代码内置保护,不在面板中单独调节</td></tr>
|
||
<tr><td rowspan="2">输入验证</td><td>消息最大长度</td><td><code>1000000</code> 字符</td><td>单条消息本地最大字符数;目标站点或模型可能有更小的真实上限</td></tr>
|
||
<tr><td>消息最大数量</td><td><code>1000</code> 条</td><td>单次请求本地最大消息数;目标站点或模型可能有更小的上下文上限</td></tr>
|
||
<tr><td rowspan="5">标签页池</td><td>最大 / 最小保留标签页数</td><td><code>12</code> / <code>1</code></td><td>池容量上限与维持下限</td></tr>
|
||
<tr><td>空闲超时</td><td><code>300</code> 秒</td><td>空闲多久后允许回收或重置</td></tr>
|
||
<tr><td>占用等待超时</td><td><code>60</code> 秒</td><td>获取标签页会话的最大等待</td></tr>
|
||
<tr><td><strong>卡死强制释放超时</strong></td><td><code>600</code> 秒</td><td>🔑 日志出现 <code>stuck for ... force release</code> 时调的就是它</td></tr>
|
||
<tr><td>上传历史对话图片</td><td>关闭</td><td>历史消息里的图片是否一起上传;当前配置关闭时只上传本次用户消息里的图片</td></tr>
|
||
<tr><td rowspan="2">日志显示</td><td>INFO / DEBUG 日志可爱化</td><td>开启 / 开启</td><td>把常见日志润色成更易扫读的中文文案;仅阅读体验开关,不改真实执行,前端保留原始日志对照</td></tr>
|
||
<tr><td>Dashboard</td><td>开启 · <code>static/index.html</code></td><td>是否开启 Web 控制面板及入口文件位置</td></tr>
|
||
</tbody>
|
||
</table></div>
|
||
<div class="co co-info">
|
||
<i data-lucide="key-round" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">最关键的两个参数</span><p><strong>静默超时阈值</strong>决定"内容停多久算结束";<strong>稳定判定次数</strong>决定"要连续多少次都没变化才算结束"。真正的结束条件:<code>(稳定次数 ≥ 稳定判定次数) AND (静默时间 > 静默超时阈值)</code>。</p></div>
|
||
</div>
|
||
|
||
<h3>配置管理与更新白名单</h3>
|
||
<ul>
|
||
<li><strong>保存:</strong>控制面板修改后点「保存」立即写入配置文件;大部分配置热重载即刻生效(环境配置除外)。</li>
|
||
<li><strong>导入 / 导出:</strong>支持导出全量配置或单个站点配置为 JSON,也可导入。预设随站点配置一并导出。</li>
|
||
<li><strong>备份:</strong>建议定期备份 <code>config/</code> 目录。</li>
|
||
</ul>
|
||
<p><strong>更新白名单</strong>(控制面板 → 设置 → 更新白名单,保存后写入 <code>config/update_settings.json</code>,<strong>下次自动更新时生效</strong>)控制的是"更新时是否保留不变",不是运行时开关:</p>
|
||
<ul>
|
||
<li>勾选 <code>config/</code>、<code>app/</code>、<code>static/</code> 这类目录项时保留整个目录。</li>
|
||
<li><code>config/sites.json</code> 与 <code>config/commands.json</code> 未勾选时默认按更新器规则<strong>合并</strong>(保留本地站点、命令与状态,补入新版内容);勾选则整份保持本地版本不动。</li>
|
||
<li><code>config/update_settings.json</code> 会被自动保留,无需手动勾选。</li>
|
||
</ul>
|
||
<div class="co co-info">
|
||
<i data-lucide="lock" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">当前默认保留项</span><p><code>config/sites.local.json</code>(站点默认预设覆盖)、<code>config/commands.local.json</code>(命令启用状态与分组覆盖)、<code>chrome_profile/</code>(登录态,仅本机自用)、<code>venv/</code>、<code>logs/</code>、<code>image/</code>、<code>updater.py</code>、<code>.git/</code>、<code>__pycache__/</code>、<code>*.pyc</code>、<code>backup_*/</code>。只保留登录态和个人配置时保持默认勾选即可;要保留自己改过的代码时再勾对应目录。</p></div>
|
||
</div>
|
||
<div class="co co-danger">
|
||
<i data-lucide="alert-octagon" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">警告:可视化编辑器没有撤销功能</span><p>一旦保存无法快捷复原,请务必谨慎修改;重要改动前先导出备份。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ============ 18 常见问题 ============ -->
|
||
<section class="doc-section" id="faq" data-reveal>
|
||
<div class="sec-kicker"><span class="sec-num">18</span><span class="sec-tag">自动化与系统 · 附录</span></div>
|
||
<h2><span class="h-ic"><i data-lucide="circle-help" style="width:20px;height:20px"></i></span>常见问题<a class="h-anchor" href="#faq"><i data-lucide="link" style="width:16px;height:16px"></i></a></h2>
|
||
|
||
<details class="acc" open>
|
||
<summary><i data-lucide="plug-zap" class="ac-ic" style="width:16px;height:16px"></i>酒馆显示「连接失败」怎么办?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd"><p>酒馆的「测试 API」按钮发送的请求通常太短,部分站点(尤其 AI Studio)不会正常响应而误报失败。<strong>不要点测试按钮,直接发送一句真实对话来测试。</strong></p></div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="key-round" class="ac-ic" style="width:16px;height:16px"></i>返回 401 / 403,认证令牌应该怎么填?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ol>
|
||
<li>确认 <code>AUTH_ENABLED=true</code> 时,<code>AUTH_TOKEN</code> 已设置为非空随机字符串;修改环境变量后必须重启服务。</li>
|
||
<li>OpenAI 兼容客户端发送 <code>Authorization: Bearer YOUR_TOKEN</code> 或 <code>X-API-Key: YOUR_TOKEN</code>;Anthropic 客户端也可发送 <code>x-api-key: YOUR_TOKEN</code>。</li>
|
||
<li><code>DASHBOARD_AUTH_TOKEN</code> 只用于控制面板和管理接口,不要把它填进客户端 API 配置;两套令牌建议完全不同。</li>
|
||
<li><code>/health</code> 用于基础连通性检查,免认证;它返回 200 不代表带令牌的业务请求一定通过,仍要检查请求头和令牌对应的开关。</li>
|
||
</ol>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="stethoscope" class="ac-ic" style="width:16px;height:16px"></i>请求频繁失败,怎么排查?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ol>
|
||
<li><strong>脚本运行时操作了受控浏览器:</strong>工作流执行中不要点击、切换或操作受控浏览器,最多只能看着。</li>
|
||
<li><strong>缩小窗口或折叠页面元素:</strong>可以最小化,但不要缩小窗口边框或折叠脚本要操作的区域。</li>
|
||
<li><strong>保留了无关标签页:</strong>只留目标 AI 网站;出现异常重启脚本即可。</li>
|
||
<li><strong>网站状态异常:</strong>看受控浏览器是否触发人机验证、被内容风控拦截,或单次输入太长被拒。</li>
|
||
<li><strong>网络波动 / 代理切换 IP:</strong>表现为后台显示发送成功但浏览器没真正发出。可等约 5 分钟或直接重启脚本。</li>
|
||
<li><strong>站点配置过期:</strong>前面都排除后,可能是站点改版导致选择器失效——提 Issue、加群反馈,或手动更新选择器。</li>
|
||
</ol>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="layers" class="ac-ic" style="width:16px;height:16px"></i>同时打开多个标签页,脚本怎么处理?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ul>
|
||
<li><strong>默认路由</strong> <code>/v1/chat/completions</code>:自动挑空闲标签页。</li>
|
||
<li><strong>指定站点</strong> <code>/url/gemini.google.com/v1/chat/completions</code>:只发到对应站点。</li>
|
||
<li><strong>指定标签页</strong> <code>/tab/1/v1/chat/completions</code>:精确使用编号 1。</li>
|
||
<li>可以给不同标签页配不同预设(一个聊天、一个识图);多个请求到来时空闲标签页依次分配,全忙时排队。</li>
|
||
</ul>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="search-x" class="ac-ic" style="width:16px;height:16px"></i>标签页池里看不到新打开的标签页?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ul>
|
||
<li>确认页面已<strong>加载完成</strong>;<code>chrome://newtab</code> 这类空白页不会被识别。</li>
|
||
<li>等 2–3 秒后点击控制台的「立即刷新」。</li>
|
||
<li>还是不出现,直接重启脚本。</li>
|
||
</ul>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="sliders-horizontal" class="ac-ic" style="width:16px;height:16px"></i>控制面板里的参数需要手动调整吗?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd"><p>大多数时候<strong>不需要</strong>。默认值已覆盖最常见场景,遇到具体问题时再针对性调整即可。</p></div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="bug" class="ac-ic" style="width:16px;height:16px"></i>目前有哪些已知问题?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ul>
|
||
<li>VSCode 的 <strong>Codex</strong> 插件及 <strong>Claude Code</strong> 均已完全适配(自 2026-05-28 起),连接方法见「连接 API」。</li>
|
||
<li>DrissionPage 每次升级后都需要重新执行对应补丁。</li>
|
||
<li>"独立 Cookie 标签页"仍是高级实验功能——强行追求"同一受控窗口内的独立 Cookie" 在浏览器原生菜单等场景可能不稳,当前建议优先使用共享 Cookie 方案。</li>
|
||
</ul>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="shuffle" class="ac-ic" style="width:16px;height:16px"></i>代理切换命令不生效怎么办?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ol>
|
||
<li>确认 <strong>Clash 正在运行</strong>且启用了 External Controller。</li>
|
||
<li>确认 API 地址正确(默认 <code>http://127.0.0.1:9090</code>,有些客户端用别的端口)。</li>
|
||
<li>确认<strong>代理组名称</strong>拼写:访问 <code>http://127.0.0.1:9090/proxies</code> 查看实际名称。</li>
|
||
<li>Clash 配了 <code>secret</code> 的话,命令配置里也要一起填。</li>
|
||
<li>在控制台「日志」搜索 <code>[CMD]</code> 开头的条目,看具体报错或切换结果。</li>
|
||
</ol>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="chrome" class="ac-ic" style="width:16px;height:16px"></i>复用自己的 Chrome 登录态,为什么配了不生效?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ul>
|
||
<li><strong>直接指向了系统默认 <code>User Data</code>:</strong>Chrome 136+ 上远程调试端口会起不来——先复制一份独立目录,再让脚本使用副本。</li>
|
||
<li><strong><code>BROWSER_PROFILE_DIR</code> 层级写错:</strong>应指向 <code>User Data</code> 这一层,而不是 <code>...\User Data\Default</code>;子配置文件夹写在 <code>BROWSER_PROFILE_NAME</code>。</li>
|
||
<li><strong>改完没重启:</strong>浏览器启动相关配置只有重新运行 <code>start.bat</code> 才生效。</li>
|
||
</ul>
|
||
<p>具体步骤回看「系统设置 → 浏览器登录态复用」。</p>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="alert-triangle" class="ac-ic" style="width:16px;height:16px"></i>浏览器能正常输入和点击发送,但提取出来的回复始终为空?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<p>这通常是因为<strong>受控浏览器的 Chrome 内核版本过低</strong>导致的。以 ChatGPT 网页版为例,旧版 Chrome 内核会触发服务端的安全风控策略,使其在返回完会话初始元数据后瞬间发送 DONE 信号切断数据流(网络流仅 900+ 字节且完全不包含 AI 文本数据)。</p>
|
||
<p><strong>解决方法:</strong>请升级运行脚本环境中的 Google Chrome 浏览器到当前稳定版,并以启动日志或 DrissionPage 要求的最低版本为准;更新后完全重启受控浏览器,再重新测试即可。</p>
|
||
</div>
|
||
</details>
|
||
<details class="acc">
|
||
<summary><i data-lucide="mail" class="ac-ic" style="width:16px;height:16px"></i>反馈渠道在哪里?<i data-lucide="chevron-right" class="chev" style="width:15px;height:15px"></i></summary>
|
||
<div class="acc-bd">
|
||
<ul>
|
||
<li><strong>GitHub Issues</strong>:提交 Bug 或功能建议。</li>
|
||
<li><strong>QQ 群 1073037753</strong>:日常交流与快速反馈。</li>
|
||
</ul>
|
||
</div>
|
||
</details>
|
||
|
||
<div class="co co-tip" style="margin-top:26px">
|
||
<i data-lucide="heart" style="width:18px;height:18px"></i>
|
||
<div class="co-bd"><span class="co-t">结语</span><p>如果你修好了某个站点的配置,欢迎把改动分享给作者或群友;你的每一次反馈,都在让这个工具变得更好用。</p></div>
|
||
</div>
|
||
</section>
|
||
|
||
</main>
|
||
<nav class="toc" id="toc"><div class="toc-t"><i data-lucide="list" style="width:13px;height:13px"></i>本页内容</div><div id="tocList"></div></nav>
|
||
</div>
|
||
|
||
<footer class="foot">
|
||
<span>Universal Web-to-API · 社区教程(重构版) · v2.9.8</span>
|
||
<span>反馈:GitHub Issues · QQ 群 1073037753</span>
|
||
</footer>
|
||
</div>
|
||
</div>
|
||
|
||
<button id="toTop" aria-label="回到顶部"><i data-lucide="arrow-up" style="width:18px;height:18px"></i></button>
|
||
<div class="toast" id="toast"><i data-lucide="check-circle-2" style="width:15px;height:15px"></i><span id="toastText">已复制</span></div>
|
||
|
||
<script>
|
||
/* ================= 主题 ================= */
|
||
const root=document.documentElement;
|
||
function applyTheme(t){root.setAttribute('data-theme',t);try{localStorage.setItem('uw2a-theme',t)}catch(e){}}
|
||
try{const saved=localStorage.getItem('uw2a-theme');if(saved)applyTheme(saved);}catch(e){}
|
||
document.getElementById('themeBtn').addEventListener('click',()=>{
|
||
applyTheme(root.getAttribute('data-theme')==='dark'?'light':'dark');
|
||
document.getElementById('themeIcon').setAttribute('data-lucide',root.getAttribute('data-theme')==='dark'?'sun':'moon');
|
||
refreshIcons();
|
||
});
|
||
/* ================= 导航数据 ================= */
|
||
const NAV=[
|
||
{group:'导览',items:[['overview','01','项目概览'],['notes','02','来自作者:使用预期']]},
|
||
{group:'上手指南',items:[['quickstart','03','快速开始'],['connect','04','连接 API'],['dashboard','05','控制台与监控']]},
|
||
{group:'核心配置',items:[['selectors','06','选择器配置'],['workflow','07','工作流配置'],['response','08','响应检测'],['presets','09','预设系统'],['tabpool','10','标签页池']]},
|
||
{group:'高级能力',items:[['multimodal','11','多模态提取'],['filepaste','12','文件粘贴'],['toolcalling','13','函数调用'],['stealth','14','低熵模式']]},
|
||
{group:'自动化与系统',items:[['commands','15','自动化命令'],['addsite','16','新增站点 · AI 识别'],['settings','17','系统设置与配置'],['faq','18','常见问题']]}
|
||
];
|
||
const navEl=document.getElementById('nav');
|
||
navEl.innerHTML=NAV.map(g=>`<div class="nav-group"><div class="nav-gt">${g.group}</div>${g.items.map(i=>`<a class="nav-link" href="#${i[0]}" data-sec="${i[0]}"><span class="n-num">${i[1]}</span>${i[2]}</a>`).join('')}</div>`).join('');
|
||
/* ================= 代码着色 ================= */
|
||
function hlCode(el){
|
||
try{
|
||
const src=el.textContent;
|
||
const esc=src.replace(/&/g,'&').replace(/</g,'<').replace(/>/g,'>');
|
||
const out=esc.replace(/("(?:[^"\\\n]|\\.)*"(?=\s*:))|("(?:[^"\\\n]|\\.)*"|'(?:[^'\\\n]|\\.)*')|(\/\/[^\n]*|(?<=^|[\s(])#[^\n]*)|(\b\d+(?:\.\d+)?\b)|(\b(?:true|false|null|curl|GET|POST|Bearer|exportRequests|viewRequests|searchRequests)\b)/gm,
|
||
(m,key,str,cmt,num,kw)=>{
|
||
if(key)return '<span class="tk-k">'+m+'</span>';
|
||
if(str)return '<span class="tk-s">'+m+'</span>';
|
||
if(cmt)return '<span class="tk-c">'+m+'</span>';
|
||
if(num)return '<span class="tk-n">'+m+'</span>';
|
||
if(kw)return '<span class="tk-b">'+m+'</span>';
|
||
return m;
|
||
});
|
||
el.innerHTML=out;
|
||
}catch(e){}
|
||
}
|
||
/* ================= 复制 & Toast ================= */
|
||
const toastEl=document.getElementById('toast'),toastText=document.getElementById('toastText');
|
||
let toastTimer=null;
|
||
function toast(msg){toastText.textContent=msg;toastEl.classList.add('show');clearTimeout(toastTimer);toastTimer=setTimeout(()=>toastEl.classList.remove('show'),1800);}
|
||
function copyText(t,msg){
|
||
const done=()=>toast(msg||'已复制到剪贴板');
|
||
if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(t).then(done).catch(()=>fallback());}else fallback();
|
||
function fallback(){const ta=document.createElement('textarea');ta.value=t;document.body.appendChild(ta);ta.select();try{document.execCommand('copy')}catch(e){}document.body.removeChild(ta);done();}
|
||
}
|
||
function initCodeBlocks(){
|
||
document.querySelectorAll('.cb').forEach(cb=>{
|
||
if(cb.dataset.init)return;cb.dataset.init='1';
|
||
const code=cb.querySelector('pre code')||cb.querySelector('pre');
|
||
if(code)hlCode(code);
|
||
const btn=cb.querySelector('.cb-copy');
|
||
if(btn)btn.addEventListener('click',()=>{
|
||
copyText((cb.querySelector('pre')||{}).innerText||'','代码已复制');
|
||
btn.classList.add('ok');const sp=btn.querySelector('span');if(sp)sp.textContent='已复制';
|
||
setTimeout(()=>{btn.classList.remove('ok');if(sp)sp.textContent='复制';},1600);
|
||
});
|
||
});
|
||
}
|
||
/* ================= 侧栏 & 搜索 ================= */
|
||
const sidebar=document.getElementById('sidebar'),overlay=document.getElementById('overlay');
|
||
function closeDrawer(){sidebar.classList.remove('open');overlay.classList.remove('on');}
|
||
document.getElementById('menuBtn').addEventListener('click',()=>{sidebar.classList.add('open');overlay.classList.add('on');});
|
||
overlay.addEventListener('click',closeDrawer);
|
||
// S14:拼进 innerHTML 的文本一律转义(搜索框输入是用户可控的,DOM 文本也可能含 < & 等字符)
|
||
const escHtml=v=>String(v==null?'':v).replace(/[&<>"']/g,c=>({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c]));
|
||
const searchInput=document.getElementById('searchInput'),searchResults=document.getElementById('searchResults');
|
||
function buildIndex(){
|
||
return Array.from(document.querySelectorAll('.doc-section')).map(sec=>{
|
||
const h2=sec.querySelector('h2');
|
||
const title=h2?h2.textContent.replace(/\s+/g,' ').trim():sec.id;
|
||
const num=sec.querySelector('.sec-num');
|
||
const grp=sec.querySelector('.sec-tag');
|
||
const subs=Array.from(sec.querySelectorAll('h3')).map(h=>h.textContent.trim()).join(' ');
|
||
const text=sec.textContent.replace(/\s+/g,' ').slice(0,900);
|
||
return {id:sec.id,title,num:num?num.textContent:'',grp:grp?grp.textContent:'' ,hay:(title+' '+subs+' '+text).toLowerCase(),subs};
|
||
});
|
||
}
|
||
let INDEX=[];
|
||
searchInput.addEventListener('input',()=>{
|
||
const q=searchInput.value.trim().toLowerCase();
|
||
if(!q){searchResults.classList.remove('on');searchResults.innerHTML='';return;}
|
||
const hits=INDEX.filter(s=>s.hay.includes(q)).slice(0,8);
|
||
searchResults.innerHTML=hits.length?hits.map(s=>`<a class="sb-r" href="#${escHtml(s.id)}"><span class="grp">${escHtml(s.grp)}</span><b>${escHtml(s.num)} · ${escHtml(s.title)}</b><small>${escHtml(s.subs.slice(0,60))}</small></a>`).join(''):`<div class="sb-none">没有匹配「${escHtml(searchInput.value.trim())}」的章节</div>`;
|
||
searchResults.classList.add('on');
|
||
searchResults.querySelectorAll('a').forEach(a=>a.addEventListener('click',()=>{searchResults.classList.remove('on');searchInput.value='';closeDrawer();}));
|
||
});
|
||
document.addEventListener('keydown',e=>{
|
||
if(e.key==='/'&&document.activeElement!==searchInput&&document.activeElement.tagName!=='INPUT'&&document.activeElement.tagName!=='TEXTAREA'){e.preventDefault();searchInput.focus();}
|
||
if(e.key==='Escape'){searchResults.classList.remove('on');closeDrawer();}
|
||
});
|
||
/* ================= 滚动监听 / TOC / 进度 ================= */
|
||
const crumbNow=document.getElementById('crumbNow'),tocList=document.getElementById('tocList');
|
||
let secObs=null,h3Obs=null,curSec=null;
|
||
function buildTOC(sec){
|
||
const h3s=Array.from(sec.querySelectorAll('h3'));
|
||
h3s.forEach((h,i)=>{if(!h.id)h.id=sec.id+'-s'+i;});
|
||
tocList.innerHTML=h3s.map(h=>`<a href="#${escHtml(h.id)}" data-h3="${escHtml(h.id)}">${escHtml(h.textContent)}</a>`).join('')||`<a style="color:var(--tx3);pointer-events:none">本节无小节</a>`;
|
||
tocList.querySelectorAll('a[data-h3]').forEach(a=>a.addEventListener('click',closeDrawer));
|
||
if(h3Obs)h3Obs.disconnect();
|
||
h3Obs=new IntersectionObserver(es=>{
|
||
es.forEach(en=>{if(en.isIntersecting){tocList.querySelectorAll('a').forEach(a=>a.classList.toggle('on','#'+en.target.id===a.getAttribute('href')));}});
|
||
},{rootMargin:'-15% 0px -70% 0px'});
|
||
h3s.forEach(h=>h3Obs.observe(h));
|
||
}
|
||
function initScrollSpy(){
|
||
if(secObs)secObs.disconnect();
|
||
const links=document.querySelectorAll('.nav-link');
|
||
secObs=new IntersectionObserver(es=>{
|
||
es.forEach(en=>{
|
||
if(en.isIntersecting){
|
||
const id=en.target.id;curSec=id;
|
||
links.forEach(l=>l.classList.toggle('active',l.dataset.sec===id));
|
||
const navItem=NAV.flatMap(g=>g.items).find(i=>i[0]===id);
|
||
if(navItem)crumbNow.textContent=navItem[2];
|
||
buildTOC(en.target);
|
||
}
|
||
});
|
||
},{rootMargin:'-12% 0px -72% 0px'});
|
||
document.querySelectorAll('.doc-section').forEach(s=>secObs.observe(s));
|
||
}
|
||
/* ================= 进度条 & 返回顶部 ================= */
|
||
const progress=document.getElementById('progress'),toTop=document.getElementById('toTop');
|
||
window.addEventListener('scroll',()=>{
|
||
const h=document.documentElement;const max=h.scrollHeight-h.clientHeight;
|
||
progress.style.width=(max>0?(h.scrollTop/max)*100:0)+'%';
|
||
toTop.classList.toggle('show',h.scrollTop>600);
|
||
},{passive:true});
|
||
toTop.addEventListener('click',()=>window.scrollTo({top:0,behavior:'smooth'}));
|
||
/* ================= 站点卡片 ================= */
|
||
const SITES=[['ChatGPT','chatgpt.com'],['Gemini','gemini.google.com'],['DeepSeek','chat.deepseek.com'],['Claude','claude.ai'],['Kimi','www.kimi.com'],['通义千问','chat.qwen.ai'],['Grok','grok.com'],['豆包','www.doubao.com'],['AI Studio','aistudio.google.com'],['Arena','arena.ai']];
|
||
function initSites(){
|
||
const grid=document.getElementById('siteGrid');if(!grid)return;
|
||
grid.innerHTML=SITES.map(s=>`<div class="site-card" data-url="https://${s[1]}/"><span class="sc-c"><i data-lucide="copy" style="width:13px;height:13px"></i></span><div class="sc-n"><span class="sc-dot"></span>${s[0]}</div><div class="sc-d">${s[1]}</div></div>`).join('');
|
||
grid.querySelectorAll('.site-card').forEach(c=>c.addEventListener('click',()=>copyText(c.dataset.url,'网址已复制 — 请粘贴到受控浏览器打开')));
|
||
}
|
||
/* ================= 图标 & 初始化 ================= */
|
||
const ICON_ALIAS={'alert-triangle':'triangle-alert','alert-octagon':'octagon-alert','check-circle-2':'circle-check-big','plus-circle':'circle-plus','code-2':'code-xml','help-circle':'circle-help','x-circle':'circle-x','minus-circle':'circle-minus','edit-3':'pen-line','external-link':'arrow-up-right','github':'code-xml','chrome':'globe'};
|
||
function refreshIcons(){
|
||
try{
|
||
document.querySelectorAll('i[data-lucide]').forEach(el=>{
|
||
if(el.querySelector('svg'))return;
|
||
const n=el.getAttribute('data-lucide');
|
||
if(ICON_ALIAS[n])el.setAttribute('data-lucide',ICON_ALIAS[n]);
|
||
});
|
||
lucide.createIcons();
|
||
}catch(e){}
|
||
}
|
||
function initReveal(){
|
||
const io=new IntersectionObserver(es=>{es.forEach(en=>{if(en.isIntersecting){en.target.classList.add('rv');io.unobserve(en.target);}})},{threshold:.06});
|
||
document.querySelectorAll('[data-reveal]').forEach(el=>io.observe(el));
|
||
}
|
||
function boot(){
|
||
INDEX=buildIndex();
|
||
initCodeBlocks();initSites();initScrollSpy();initReveal();refreshIcons();
|
||
document.querySelectorAll('a[href^="#"]').forEach(a=>a.addEventListener('click',closeDrawer));
|
||
}
|
||
if(document.readyState==='loading')document.addEventListener('DOMContentLoaded',boot);else boot();
|
||
</script>
|
||
</body>
|
||
</html>
|