把任意 AI 聊天网页
变成 OpenAI 标准接口

项目概览

本项目的核心思路：不再依赖官方 API，而是自动化你本地的浏览器——让脚本在你已登录的 AI 网站上输入问题、等待回复、提取结果，再按 OpenAI 的数据格式返回给任何客户端。

典型用途：统一本地接入方式；按站点或标签页组织不同工作流；在长文本场景下通过文件粘贴承载上下文；在调试时观察页面侧与请求侧的执行流程。

系统架构

请求从客户端进入后，会依次穿过路由层、调度层与驱动层，再由解析层把网页里的回复翻译回标准格式。理解这条链路，后面的配置章节会好读很多。

来自作者：使用预期

这七条是作者的维护说明，动手前先扫一遍，遇到问题时能省不少排查时间。

快速开始

先区分受控浏览器和普通浏览器

双击运行 start.bat 后，脚本会自动启动一个受控浏览器。打开 Windows 任务栏，你应该能看到它已经运行；接下来的登录和站点配置都要在这个浏览器里完成。

首次启动检查清单

第一次运行时按“进程 → 端口 → 浏览器 → 站点 → API”的顺序确认，任何一步失败都先停在当前层排查，不要直接反复点击发送。

1. 启动脚本没有立即退出。start.bat 窗口应保持打开；若窗口闪退，在项目目录打开 PowerShell 执行 python start.py，保留完整错误信息。
2. 端口可访问。在普通浏览器打开 http://127.0.0.1:8199/health。返回 JSON 且 HTTP 状态为 200 表示服务和浏览器均已就绪；若为 503，服务还在但受控浏览器未连接。
3. 远程调试端口已监听。打开 http://127.0.0.1:9222/json/version；能看到 Browser 与 webSocketDebuggerUrl 才表示自动化连接正常。不要把该端口暴露到公网。
4. 标签页池有可用页面。控制面板 → 标签页池中至少有一个目标站点，状态为“空闲”；新标签页加载完成后等待 2–3 秒再刷新列表。
5. 先做最小请求。使用 /v1/models 检查路由，再发送一句短文本；确认成功后再启用流式、多模态或函数调用。

选择一个已适配的站点

受控浏览器的基础引导会列出若干已经适配的站点。列表中存在的网站代表已经完成适配，你可以任选一个使用；本教程以 Gemini 为例。点击下方卡片复制网址，再粘贴到受控浏览器的地址栏中打开。

以 Gemini 为例完成首次配置

1. 访问 Gemini。在受控浏览器中打开 https://gemini.google.com/，等待页面完整加载。
2. 登录个人账号。完成登录并进入真正可以发送消息的对话页面。
3. 整理页面状态。将页面语言设置为中文，并确保左侧聊天侧边栏处于展开状态；这是脚本稳定识别和操作页面的必要条件。
4. 确认标签页已被接管。打开「控制面板 → 标签页池」，此时应当能看到刚才打开的 Gemini 页面已经处于标签页池的控制之中。

连接你的客户端

标签页进入控制后，选择合适的路由地址，填入任意支持 OpenAI 兼容接口的前端即可使用，例如 Chatbox、SillyTavern、Cherry Studio 等。

连接 API

本项目提供兼容 OpenAI 格式 的接口，绝大多数支持"自定义 OpenAI 端点"的客户端都能直接使用。

选择路由并填写连接信息

模型名称 (Model)：建议填写便于客户端保存配置的占位名（如 web-api、gemini-web）。实际响应来源由当前打开的站点与预设决定。

单次请求指定预设的三种方式

聊天接口支持直接指定 preset_name，只对当前这一次请求生效，不改变站点默认预设。

# 方式 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"}

查询参数与调度

完整调用示例

# 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 "..."

API 端点速查

下面是日常集成会用到的公开端点。除 /health 外，服务端点是否要求认证取决于「系统设置」中的开关；启用后统一使用 Authorization: Bearer <AUTH_TOKEN>，Anthropic 客户端也可使用 x-api-key。

# 健康检查（无需令牌）
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\":\"你好\"}]}"

响应头诊断

路由类接口会返回诊断响应头，方便确认后端实际采用了哪种分配策略。

登录状态与上下文上限

• 推荐登录：登录你自己的账号，本地接口才能继承当前会话的站点能力与历史上下文。
• 免登录亦可：若网站在未登录状态下允许对话，无需登录也能直接通过 API 调用。

开发者协议兼容（实验性）

以上协议由于缺乏大规模工具用例覆盖，实际稳定性请按需测试。

控制台与请求监控

控制台默认运行在 http://127.0.0.1:8199/。请求队列、运行日志和站点配置都在这里查看与管理。

控制台界面结构示意

请求异常调试与排查步骤

请求出问题时，按下面的顺序排查：

1. 查看请求监控列表：点击失败记录，检查该请求是在哪个阶段失败的——是排队获取标签页时超时（acquire_timeout，默认 60s），还是网络监听等首包响应时超时（first_response_timeout，默认 300s）。
2. 联合日志追踪：在日志页面中，通过请求的唯一 RequestID 或短追踪哈希，把 [ROUTE]（路由）、[POOL]（标签分配）、[INPUT]（输入）、[STREAM]（输出捕获）与 [NetworkMonitor] 各阶段的日志串起来看，定位卡在哪一步。
3. 隔离问题标签页：如果某个标签页频繁卡死或变慢，到「标签页池」查看它的锁定状态，用取消按钮中断，或调用调试接口释放。

选择器配置 Selectors

每个站点的每个预设都需要定义一组 CSS 选择器，告诉程序去哪里输入、点哪里发送、从哪里读回复。配置完全在控制台的可视化表单中回填，不需要修改任何 JSON 文件。这是所有配置里最关键、也最容易因网站改版而失效的部分。

先认识 3 个核心字段（在选择器配置面板顶部输入）

各字段的常用填写示例：

填写顺序建议

1. 在受控浏览器中打开目标网站，右键输入框选择“检查元素”，把定位器填入 input_box。
2. 再找到发送按钮，把其定位器填入 send_btn。
3. 在对话框中发一条消息，等 AI 回复完毕后，找到包裹回复内容的最外层大 DIV，填入 result_container。
4. 每填一项就点一次该字段右侧的「测试」，确认能命中——切忌全部填完再一起排查。
5. 前三项稳定后，再考虑补充 new_chat_btn 或其他附件上传的选择器。

工作流与可视化交互调优

工作流定义了一轮 API 交互在受控浏览器中的执行动作顺序（如清除历史、输入提示词、点击发送以及等待流式完成）。最新的工作流支持在控制台进行完全可视化的拖拽与编辑，无需编写 JSON 代码。

可视化节点编辑器

在站点配置的【请求工作流】区域，所有动作按执行顺序排成一条节点链：

• 添加步骤：点击“新增步骤”在链末追加动作卡片；也可以套用内置模板，一键生成最短可用工作流。
• 调整顺序：按住卡片左侧拖动即可。
• 删除步骤：点击卡片右上角的“垃圾桶”图标。
• 标记必需 / 可选：每张卡片底部有一个“必需步骤”勾选框——默认勾选表示必需（找不到目标元素就报错）；取消勾选即变为可选，找不到元素时会自动跳过该步骤。

下拉里的动作以控制面板实际选项为准；本表覆盖当前可选的全部节点类型。

防风控与开头注入

在防爬严格的站点（如 GPT、Gemini、Arena）上，频繁发送模式相似的 Prompt 容易触发限频。可在控制面板开启两种扰动手段：

• 开头追加随机占位片段：发送时在 Prompt 前自动加一段无意义前缀（如 测试号，无实际意义: [随机混淆码]），“开头片段数”与“说明文本”都可自定义，让每条请求内容不完全一致。
• 提示词内随机字符插入：从自定义字符集（如 abc123※☆）中随机取一个字符，插入提示词的随机位置。

输入框稳定与自愈等待

部分网站点击新建对话后会重建输入框节点，导致粘贴时失焦或失败。可在站点配置的【高级功能】中调整：

• 输入框稳定等待：执行 FILL_INPUT 前，先确认输入框节点连续多次检测保持稳定。
• 自愈选项：可勾选“仅在刚点击 new_chat_btn 后启用”或“新建对话后等待 URL 切换”，配合“最长等待秒数”（如 1.5 秒）与“URL 匹配正则”，等页面就绪再填入。
• 发送内容确认与自愈：点击 send_btn 后二次确认输入框已清空或明显变短；发现没发出去，就自动重试当前工作流。

响应检测与自愈重试

系统需要判定 AI 什么时候开始输出、什么时候算说完，并从中捕获流式文本。有两种检测模式，支持自动回退。

网络监听超时自动回退

网络拦截模式更精准，但网页改版或解析器报错时可能捕获失败，让请求一直挂着。对应的保护机制：

• 首次响应超时自动回退：发送后开始计时（first_response_timeout，默认 300s，在流式配置的 network 项下）。超时仍没有流量命中 listen_pattern 规则，就自动回退到 DOM 模式（StreamMonitor）继续从页面抓取文本，请求不会因此挂起。

发送确认与重试

部分站点点击发送后偶发无响应，可在【发送确认与重试】中配置：

• 自动再点一次：点击 send_btn 后，若观察窗口内（如 1.8 秒）没有出现输入框清空、网络活动或生成状态，就再点一次发送。
• 重试频次：最大支持重试 2 次，两次重试间隔支持定制（如 0.6 秒）。
• 防中断保护：一旦判定 AI 已开始生成（或发送按钮变成了停止/中断状态），会立即停止重试，避免二次点击切断正在生成的回复。

DOM 模式结束判定公式

生成结束判定 = (连续稳定次数 ≥ 稳定判定次数) AND (静默时间 > 静默超时阈值)

DOM 检查时，内容没有再变化，稳定计数增加，静默时间累加。两个阈值同时达到时，判定本轮回复完成。全局硬超时（DOM 模式默认 600 秒，即浏览器常量里的「最大超时」；网络拦截模式则另有各自的首包与硬超时）是本轮监听的物理保底，无论如何都会在到点后强制收尾。

多预设管理系统

预设允许你为同一个站点创建多套独立的配置方案，并分配给不同标签页。每个预设包含独立的选择器、工作流、流式配置、多模态提取、文件粘贴等全套配置，互不影响。

预设操作

都在【站点配置】面板里完成：

1. 切换与新建：在页面顶部的“当前预设”下拉框选择要修改的预设，或点击【＋ 新建预设】输入新名字。新预设会复制当前预设的全部参数，之后各自独立调整。
2. 管理与设为默认：点击下拉框旁的“管理预设”可以改名或删除。点击【⭐ 设为默认】后，该预设作为 API 请求的保底配置。
3. 绑定到标签页：切换到【标签页】选项卡，每一行代表一个正在运行的标签页，在“预设”列的下拉菜单里选中预设名即可绑定。
4. 单次请求临时覆盖：不想改绑定时，在请求 URL 上加参数（如 /v1/chat/completions?preset_name=快速识图），只对这一次请求生效。

对话复用与新建会话控制

• 对话复用窗口（秒）：大于 0 时，同一标签页在窗口期内收到的后续请求会直接复用当前会话续聊；设为 0（默认）表示关闭复用，每次请求都可能触发工作流开头的"新建会话"逻辑。
• 强制新建对话：开启后即使配置了大窗口也忽略复用，每次都强制新开会话——特别适合测试无历史干扰的独立 Prompt 流程。

标签页池与会话隔离

标签页池（Tab Pool）负责把并行的 API 请求排队、分发到合适的标签页，实现单浏览器多会话并行。

核心生命周期与超时参数

独立 Cookie 标签页

对 arena.ai 这类需要隔离 Cookie 的站点（避免多标签页共用同一登录会话），【高级功能】中提供：

• 独立 Cookie 标签页：开启后，该预设创建的标签页在独立的匿名会话容器中运行，各标签页的 Cookie、Local Storage 彼此隔离。
• 自动接管手动新标签页：人工新建或弹出的标签页会被脚本接管，关闭原页面并转为独立的受控窗口。

域名路由分组 (Route Groups)

用于多账号、多业务线的隔离。可以为不同请求定义专属的标签页路由组（在配置文件或标签面板管理）：

• 工作逻辑：为指定域名（如 chat.deepseek.com）绑定一组专用标签页，或按传入的 URL token 指定独立会话。不同路由组互不干扰，可实现多账号轮询分流。
• 分配策略 (allocation_mode)：支持 first_idle（最先空闲）、round_robin（同组轮询分摊）与 random（随机选择，防轨迹侦测）三种分发逻辑。
• 错误标签页保留 (preserve_error_tabs)：勾选后，标签页发生严重错误或被风控拦截时不会被关闭，控制台亮起报警，方便进入受控浏览器人工处理。

常用路由方式一览

多模态提取与媒体配置

【多模态提取】面板管理如何从网页中提取图片、音频、视频，并转换成客户端可直接使用的本地链接或 Markdown 图片标签。全部在面板里配置，不需要改 JSON。

1. 基础开关与提取范围

• 启用多模态提取（开关）：全局总开关。勾选后，系统才会在对话完成时去扫描网页里的图片/视频。
• 提取策略模式（下拉框）：
  • 提取所有 (all) — 网页上生成的全部图片或媒体文件一并打包返回。
  • 仅首个 (first) — 仅提取网页回答中出现的第一张图片，适合标准的单图输出场景。
• 媒体文件大小限制（数字输入框）：单位为 MB（默认 10）。超过此大小的媒体文件将被忽略，防止超大视频/无用底图占满服务器带宽。
• 下载二进制资源 (Download Blobs)：开启后，自动下载网页里的二进制 Blob 媒体并转换为持久本地链接，防止因浏览器页面关闭导致临时链接失效。

2. 子模态参数配置（图片 / 音频 / 视频卡片）

可分别为每种媒体开启提取，并配置对应的运行策略与等待时长：

3. 提取源定位（DOM 选择器配置）

【元素选择器】用来告诉脚本媒体在页面的哪个位置，避免误抓广告或头像：

• 媒体选择器 (Selector)：指示媒体标签。例如图片填 img，视频填 video, video source。
• 容器选择器 (Container Selector)：非常重要，用来圈定提取范围（如 .result-content）。系统只抓取该容器内的媒体，从而避开顶栏、侧边栏的无关图片。

4. 页面朗读音频捕获（TTS 语音录制）

除了抓取网页里已有的 audio 节点外，如果想录制 AI 的“在线朗读”发音，可以展开并配置【朗读捕获】表单：

• 启用朗读录制 (audio_capture_enabled)：勾选后，系统会在文本输出完成后，去寻找并自动点击网页中的“朗读”或“发声”按钮来捕获音频。
• 朗读按钮选择器 (audio_trigger_selector)：填入发音按钮的精确定位器。
• 按钮文本兜底 (audio_trigger_labels)：当选择器不稳定时，可通过文字（如 "朗读", "发音", "收听"）匹配按钮。
• 网络音频直抓 (url_patterns)：设置过滤关键词（如 tts、voice）后，播放时若有匹配的网络音频流，会优先直抓合成，失败时降级为页面内录音兜底。

文件与附件发送判定

当 Prompt 超过网站输入框的长度限制时，系统会自动把它写入临时文件，通过网页的附件上传通道发给 AI，以此承载超长上下文。

文件粘贴配置

在站点配置的【文件粘贴模式】板块配置：

附件发送判定

发送带附件的消息时（文件粘贴或图片粘贴），系统会观察预览就绪、发送按钮置灰、进入生成态等信号，确认附件真的发出去了：

高级附件规则

【高级附件规则】里还有几个开关：

• 发送前必须看到附件已挂上页面：上传预览渲染出来后才允许点发送，避免文件没挂上就把消息发出去。
• 没有观察到上传启动前，不允许判定 ready：防止网络卡顿造成脚本还未来得及触发上传就直接判为就绪发送。
• 发送未确认时允许自动重试：在点击发送后若检测到输入框残留，自动执行再次点击或再次按键。
• 发送按钮变 stop 时禁止重试 与 页面进入生成态时禁止重试：两个防打断选项，一旦判定 AI 已经开始生成响应，无论输入框有无残留，均自动封禁重试，避免将已产出的回复打断。
• 安全上传限制：临时文件异常、后缀敏感（如 .exe、.bat）或体积超出站点限制时，自动报错拦截。

函数调用 Tool Calling

本反代兼容 OpenAI 标准的 tools 格式：把函数定义转译成结构化的 XML 调用块（<adapter_calls> / <call> / <arg>）注入网页端，再把 AI 的输出解析回标准格式。

环境变量参数（设置 → 环境配置 → 函数调用）

两个可调参数：

• 最大返回结果字符限制 (TOOL_CALLING_MAX_TOOL_RESULT_CHARS)：默认 300,000 字符，防止工具返回过大内容撑爆网页端的上下文窗口。
• 零宽字符噪声注入 (TOOL_CALLING_PROMPT_PADDING_ENABLED 与 TOOL_CALLING_PROMPT_PADDING_OBFUSCATE)：注入工具提示词时随机混入零宽字符（\u200b、\u200c、\u200d），降低被站点自动过滤识别的概率。

两种内部修复策略

低熵模式（低干扰操作）

低熵模式把点击、移动、滚动和输入节奏做得更接近人工操作，用于改善某些站点上的界面兼容性和执行稳定性——不再是"瞬移 + 立即点击"的激进轨迹。

• 建议开启：页面对瞬时点击、直接粘贴或坐标跳变敏感的站点；普通模式下容易丢焦点、误判未发送、元素定位不稳定时。
• 可以不开：普通模式已经长期稳定的站点。

DrissionPage 补丁（必看）

为了减少额外连接带来的兼容性问题，项目会给 DrissionPage 打一个小补丁，让网络监听尽量复用浏览器主连接，而不是额外新建连接。

• 自动执行：运行 start.bat 后自动安装依赖并执行补丁。
• 手动执行：python patch_drissionpage.py
• 恢复原文件：python patch_drissionpage.py --restore

自动化命令与异常恢复

自动化命令引擎按“触发条件 (Trigger) + 动作链 (Action Chain)”模式运行。配置位置：控制面板 → 命令。

内置动作

新增站点配置流程

接入一个未适配的 AI 聊天网站，有两条路线：AI 自动分析生成，或纯手动配置。

路线 A：辅助 AI 自动分析 推荐

让辅助 AI 分析目标网页的 HTML，自动生成一套可用的初始选择器：

1. 在受控浏览器里，新开标签页打开你想接入的 AI 聊天主页，并确保已经登录完成、停在对话输入页面。
2. 对该站点发起第一次真实 API 请求（例如请求路由为：/url/example-ai.com/v1/chat/completions）。
3. 后端发现这是个未配置的新域名，会自动捕获页面 DOM，调用设置中配置好的辅助 AI 接口分析。
4. 分析通过后，自动为该域名生成初始主预设，写入识别到的选择器与最短工作流。

路线 B：手动在控制面板配置调试

没有配置辅助 AI 密钥，或页面 JS 混淆严重时，直接手动配置：

1. 点击控制台左侧侧边栏下方的【新增站点】按钮，在弹出的窗口里输入目标站点的域名（如 chat.example.com）。
2. 在左侧列表点击新域名，系统会初始化一个“空白主预设”。
3. 去目标站点右键检查元素，将核心三项（input_box、send_btn、result_container）填入选择器表单中。
4. 在【工作流】节点链中拼出最短可用步骤（见下）。
5. 依次点击核心字段右侧的“测试”，调试无误后保存。

最短可用工作流

能驱动绝大多数聊天网站的最简节点顺序如下，点【＋ 增加步骤】依次拼入：

1. CLICK 节点：目标填入 new_chat_btn，取消勾选“必需步骤”（即标记为可选），以防首次打开本就处于新对话时点击失败。
2. WAIT 节点：时值设为 0.5 秒，给页面重置预留少许过渡时间。
3. FILL_INPUT 节点：目标填入 input_box。这是将用户提示词灌入输入框的必需步骤。
4. CLICK 节点：目标填入 send_btn，用于点击发送按钮。
5. KEY_PRESS 节点：目标填入 Enter，取消勾选“必需步骤”（标记为可选），可在部分回车也能发送的网站上作为备用指令。
6. STREAM_WAIT 节点：目标填入 result_container。用于捕获流式输出。必须以此步骤作为整条工作流的最终结尾。

调试顺序：按输入框 → 发送按钮 → 回复容器的顺序逐项测试选择器，三项都通过后再跑工作流；基本对话跑通后，最后再调文件粘贴阈值与多模态参数。

系统设置与配置管理

环境配置在控制面板 → 设置 → 环境配置中修改，主要放端口、认证、代理、辅助 AI 等全局设置——改完通常需要重启服务才能生效。

安全边界与部署建议

本项目默认面向单机、本地回环场景。它会代替你操作已登录的网页，并在日志、请求历史和浏览器配置中接触敏感内容；请把 API、控制面板和调试端口视为同一台机器上的高权限本地服务。

# 仅本机监听；不要改成 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

环境配置速查

浏览器登录态复用（高级）

希望脚本启动后直接继承你平时浏览器里的登录状态、Cookie 和扩展？请使用独立复制出来的用户数据目录，不要直接把脚本指向日常正在使用的系统默认目录。

1. 确认原配置位置。在日常 Chrome 地址栏打开 chrome://version，记下「个人资料路径」；它通常类似 ...\Google\Chrome\User Data\Default。
2. 完全退出浏览器和脚本。关闭所有 Chrome 窗口，并确认任务栏中没有仍在运行的 Chrome；复制使用中的配置容易得到不完整文件。
3. 复制必要内容。从原始 ...\Google\Chrome\User Data 根目录复制 Local State，再复制刚才确认的配置子目录（如 Default、Profile 1）。
4. 放入项目专用目录。把上一步的内容粘贴到项目根目录的 chrome_profile/ 中。完成后应能看到 chrome_profile\Local State 和 chrome_profile\Default（或对应的 Profile N）。
5. 选择对应配置并重启。在 .env 中保持 BROWSER_PROFILE_DIR 为空，并把 BROWSER_PROFILE_NAME 写成复制过来的子目录名称；然后重新运行 start.bat。

BROWSER_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe
# 留空时使用项目根目录的 chrome_profile/
BROWSER_PROFILE_DIR=
# 必须与复制进 chrome_profile/ 的子目录名一致
BROWSER_PROFILE_NAME=Default

浏览器常量（即时生效，无需重启）

控制面板 → 设置 → 浏览器常量。这里更适合放"运行时调优"参数：响应检测、操作延迟、标签页池回收等。下表按仓库当前 config/browser_config.json 列示，若你在面板中改过值，应以面板显示的实际值为准；首次启动时缺少配置文件则会回退到代码内置默认值。

配置管理与更新白名单

• 保存：控制面板修改后点「保存」立即写入配置文件；大部分配置热重载即刻生效（环境配置除外）。
• 导入 / 导出：支持导出全量配置或单个站点配置为 JSON，也可导入。预设随站点配置一并导出。
• 备份：建议定期备份 config/ 目录。

更新白名单（控制面板 → 设置 → 更新白名单，保存后写入 config/update_settings.json，下次自动更新时生效）控制的是"更新时是否保留不变"，不是运行时开关：

• 勾选 config/、app/、static/ 这类目录项时保留整个目录。
• config/sites.json 与 config/commands.json 未勾选时默认按更新器规则合并（保留本地站点、命令与状态，补入新版内容）；勾选则整份保持本地版本不动。
• config/update_settings.json 会被自动保留，无需手动勾选。

常见问题