Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

83.1 KB
Raw Blame
<!doctype html>
<html lang="zh" dir="ltr" data-theme="dark">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>常见问题解答 — WebBrain</title>
  <meta name="description" content="快速了解设置、模型、账单、安全性以及 WebBrain 在浏览器中的工作方式。">
  <link rel="canonical" href="https://webbrain.one/docs/zh/faq/">
  <link rel="alternate" hreflang="en" href="https://webbrain.one/docs/faq/">
  <link rel="alternate" hreflang="es" href="https://webbrain.one/docs/es/faq/">
  <link rel="alternate" hreflang="fr" href="https://webbrain.one/docs/fr/faq/">
  <link rel="alternate" hreflang="tr" href="https://webbrain.one/docs/tr/faq/">
  <link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/faq/">
  <link rel="alternate" hreflang="ru" href="https://webbrain.one/docs/ru/faq/">
  <link rel="alternate" hreflang="uk" href="https://webbrain.one/docs/uk/faq/">
  <link rel="alternate" hreflang="ar" href="https://webbrain.one/docs/ar/faq/">
  <link rel="alternate" hreflang="ja" href="https://webbrain.one/docs/ja/faq/">
  <link rel="alternate" hreflang="ko" href="https://webbrain.one/docs/ko/faq/">
  <link rel="alternate" hreflang="id" href="https://webbrain.one/docs/id/faq/">
  <link rel="alternate" hreflang="th" href="https://webbrain.one/docs/th/faq/">
  <link rel="alternate" hreflang="ms" href="https://webbrain.one/docs/ms/faq/">
  <link rel="alternate" hreflang="tl" href="https://webbrain.one/docs/tl/faq/">
  <link rel="alternate" hreflang="he" href="https://webbrain.one/docs/he/faq/">
  <link rel="alternate" hreflang="hi" href="https://webbrain.one/docs/hi/faq/">
  <link rel="alternate" hreflang="pt" href="https://webbrain.one/docs/pt/faq/">
  <link rel="alternate" hreflang="vi" href="https://webbrain.one/docs/vi/faq/">
  <link rel="alternate" hreflang="bn" href="https://webbrain.one/docs/bn/faq/">
  <link rel="alternate" hreflang="fa" href="https://webbrain.one/docs/fa/faq/">
  <link rel="alternate" hreflang="nl" href="https://webbrain.one/docs/nl/faq/">
  <link rel="alternate" hreflang="de" href="https://webbrain.one/docs/de/faq/">
  <link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/faq/">
  <meta property="og:type" content="website">
  <meta property="og:title" content="常见问题解答 — WebBrain">
  <meta property="og:description" content="快速了解设置、模型、账单、安全性以及 WebBrain 在浏览器中的工作方式。">
  <meta property="og:url" content="https://webbrain.one/docs/zh/faq/">
  <meta property="og:image" content="https://webbrain.one/og-image.png">
  <meta name="twitter:card" content="summary_large_image">
  <link rel="icon" href="/favicon.png">
  <script>try{document.documentElement.dataset.theme=localStorage.getItem('webbrain-theme')||'dark'}catch(_){}</script>
  <link rel="stylesheet" href="/docs/assets/docs.css?v=20261028">
  <!-- Site footer styles: start -->
  <style>
    .wb-footer {
      --wb-footer-text: var(--text, var(--ink, #2c1810));
      --wb-footer-dim: var(--text-dim, var(--muted, #6b5b47));
      --wb-footer-line: var(--border, var(--line, rgba(89, 55, 25, 0.15)));
      margin: 0;
      padding: 0;
      border-top: 1px solid var(--wb-footer-line);
      background: var(--wb-footer-bg, none);
      color: var(--wb-footer-dim);
      font-size: 13px;
      line-height: 1.5;
      text-align: start;
    }
    .wb-footer-inner {
      width: var(--wb-footer-width, min(calc(100% - 48px), 1100px));
      margin: 0 auto;
      padding: 26px 0 30px;
      display: flex;
      flex-direction: column;
      gap: 18px;
    }
    /* Page links start on the brand's left edge; the social icons sit at
       the far end of the same row. */
    .wb-footer-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 14px 32px; }
    .wb-footer-brand { display: flex; flex-direction: column; gap: 5px; }
    .wb-footer-tagline { margin: 0; color: var(--wb-footer-text); font-size: 15px; font-weight: 700; line-height: 1.4; }
    .wb-footer-copy { margin: 0; }
    .wb-footer-copy a { color: var(--wb-footer-text); font-weight: 650; text-decoration: none; }
    .wb-footer-links { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
    .wb-footer-social { display: flex; align-items: center; gap: 8px; }
    .wb-footer-links a { color: var(--wb-footer-dim); font-weight: 600; text-decoration: none; }
    .wb-footer a:hover { color: var(--wb-footer-text); text-decoration: none; }
    .wb-footer a:focus-visible { outline: 2px solid currentColor; outline-offset: 3px; border-radius: 4px; }
    .wb-footer-icon { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; margin: -4px 0; border-radius: 6px; }
    .wb-footer-icon:hover { background: color-mix(in srgb, currentColor 12%, transparent); }
    .wb-footer-icon svg { display: block; width: 15px; height: 15px; }
    /* Only shown without JavaScript, when the language picker can't run. */
    .wb-footer-languages { display: none; flex-wrap: wrap; gap: 6px 12px; width: 100%; direction: ltr; }
    .wb-footer-languages span { color: var(--wb-footer-text); font-weight: 700; }
    @media (max-width: 860px) {
      .wb-footer-inner { width: var(--wb-footer-width, calc(100% - 32px)); }
    }
  </style>
  <!-- Site footer styles: end -->
  <!-- Plausible analytics: start -->
  <!-- Privacy-friendly analytics by Plausible -->
  <script async src="https://157.230.3.9.sslip.io/js/pa-omp0F7DsOXM4sGKR50l7S.js"></script>
  <script>
    window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
    plausible.init()
  </script>
  <!-- Plausible analytics: end -->
  <script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "inLanguage": "zh-CN",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "WebBrain 是 Claude 浏览器插件的免费替代品吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "是的。WebBrain 提供类似的 AI 浏览器代理能力 —— 阅读页面、提取数据、点击按钮、填写表单并自动化多步骤工作流。与需要 Claude Pro 订阅且仅支持 Anthropic 模型的专有 Claude 插件不同,WebBrain 完全免费、开源(GPL-3.0-or-later 许可),并支持多个 LLM 提供商,包括完全在你的机器上运行的本地模型。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain Compass 订阅多少钱?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "WebBrain Compass 目前为每个设备配置文件每月 5 美元,暂时比 Claude Pro 便宜得多。当前用量在公平使用政策下不限量:正常个人使用没问题,但不允许滥用、自动化刷量、转售或异常高流量使用。 订阅绑定到扩展为该浏览器 + 操作系统 GUID 生成的设备标识符,而不是用户账户。如果你重置扩展存储、删除浏览器配置文件、重新安装浏览器、更换浏览器/操作系统或丢失设备而导致该标识符丢失,我们无法找回或转移,也不会因此退款。"
      }
    },
    {
      "@type": "Question",
      "name": "如何管理或取消我的订阅?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "请前往 api.webbrain.one/account 管理账单,并使用您的电子邮件登录。"
      }
    },
    {
      "@type": "Question",
      "name": "我已经为 WebBrain Compass 付过费了,但扩展仍要求我再次付款。我需要付两次吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "不需要——请勿重复付款。你的 Compass 订阅绑定到扩展生成的浏览器/设备标识符,如果该标识符发生变化(新浏览器或设备、重装浏览器、删除浏览器配置文件或重置扩展存储),扩展将无法识别现有订阅,从而要求付款。 请通过自助门户 api.webbrain.one/portal 将现有订阅重新关联到当前浏览器,并按其中的说明恢复访问。 如需收据及其他账单变更,请使用电子邮件登录 api.webbrain.one/account 管理账单。"
      }
    },
    {
      "@type": "Question",
      "name": "加密的 Cloud Sync 如何工作?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Cloud Sync 是面向有效 WebBrain Compass 订阅用户的可选功能。它会同步你的 WebBrain 记忆、个人资料自动填充文本,以及受支持的提供商配置(包括 API 密钥)。它不会同步聊天记录、浏览器历史、页面截图,或旧版 OAuth 访问令牌与刷新令牌。 浏览器会在上传前使用你选择的密码对同步保险库进行加密。WebBrain Compass 只存储加密后的保险库;无法读取你的记忆、个人资料文本、提供商设置或 API 密钥,也无法帮你找回同步密码。 邮箱字段用于 WebBrain Compass 的 magic-link 账单/订阅身份验证,不是账户密码。如果界面在 Cloud Sync 中提示更改密码,指的是同步加密密码,而不是 WebBrain 账户密码。 如果你忘记了同步密码,旧的加密云端保险库将无法解密。你可以重置云端保险库,并从仍保留本地数据的设备重新上传一份新的加密副本。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 与 OpenClaw、Browser-Use 以及其他 AI 代理框架有何不同?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "它们属于不同类别的工具。WebBrain 是浏览器扩展 —— 你在 Chrome 或 Firefox 中安装它,并在侧边栏中与它对话,无需编码。OpenClaw 和 Browser-Use 等框架是面向开发者的 SDK,用 Python 构建自动化浏览器流水线,通常使用无头浏览器和 CDP。换句话说:WebBrain 用于日常浏览时的 AI 助手;代理框架用于构建抓取机器人和测试自动化。你可以同时使用 —— 二者互补。"
      }
    },
    {
      "@type": "Question",
      "name": "我可以编辑 WebBrain 工作流吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "可以。使用 WebBrain 工作流编辑器,可在浏览器中查看、编辑、验证和导出工作流 JSON 文件。"
      }
    },
    {
      "@type": "Question",
      "name": "我能完全离线使用 WebBrain 吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "可以。WebBrain 的默认提供商是 llama.cpp,它在你的电脑上运行本地 AI 模型。无需 API 密钥,AI 无需互联网,数据不会离开你的机器。下载一个 GGUF 模型,启动 llama-server,你就拥有了一个完全私有的 AI 浏览器代理。你也可以通过 OpenAI 兼容端点使用 Ollama。"
      }
    },
    {
      "@type": "Question",
      "name": "什么是应急箱,离线 RAG 是如何工作的?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "应急箱是约 570 份公有领域实地参考文档(医疗、生存、教育、通信)的精选合集,WebBrain 可以下载并在本地建立索引。安装后,无需互联网连接即可离线提出事实性问题,并获得基于这些文档的答案。 WebBrain 在底层使用 SQLite FTS5 对应急箱和已安装的维基百科存档进行快速关键词搜索,另有可选的语义搜索层,使用本地下载的多语言 E5 模型(约 140 MB)。两种方法的结果会被合并去重,每个答案都会引用确切的原文段落。引用在本地阅读器中打开,显示前会验证文档完整性——绝不会跳转到实时网页。 还可以通过末日模式安装维基百科存档,以获得更广泛的离线知识库。来源和语言筛选器可控制搜索哪些合集。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 支持哪些 AI 模型?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "WebBrain 支持四类提供商:llama.cpp(任意本地 GGUF 模型)、OpenAI(GPT-4o、GPT-4 等)、Claude(通过原生 API 使用 Claude Opus、Sonnet、Haiku)以及 OpenRouter(访问多家提供商的 100 多种模型)。任何 OpenAI 兼容的 API 端点都能工作,因此你也可以使用 Together AI、Groq、Mistral 等服务,或任何提供 OpenAI 兼容接口的本地服务器。"
      }
    },
    {
      "@type": "Question",
      "name": "最推荐的模型是什么?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "截至 2026 年 4 月 21 日,最推荐的是 Qwen 3.6 35B。原因:在我们的视觉基准测试中(vision-model-shootout),它在截图理解方面超过了 Gemma 4,同时对本地推理仍然可行。 在消费级 GPU 上,RTX 5090 是理想选择;RTX 4090 通常可借助 Intel/Qwen3.6-35B-A3B-int4-AutoRound 的 INT4 AutoRound 量化运行。 追求最高速度时,推荐使用 vLLM 提供服务。示例命令: python -u -m vllm.entrypoints.openai.api_server --model Intel/Qwen3.6-35B-A3B-int4-AutoRound --served-model-name qwen3.6-35b --quantization auto --dtype bfloat16 --max-model-len 65536 --max-num-batched-tokens 32768 --max-num-seqs 4 --host 0.0.0.0 --port 8000 --gpu-memory-utilization 0.92 --enable-prefix-caching --enable-chunked-prefill --limit-mm-per-prompt '{\"image\": 4, \"video\": 1}' --mm-processor-cache-type shm --reasoning-parser qwen3 --enable-auto-tool-choice --tool-call-parser qwen3_coder --trust-remote-code --allowed-origins '[\"*\"]' --speculative-config '{\"method\": \"dflash\", \"model\": \"z-lab/Qwen3.6-35B-A3B-DFlash\", \"num_speculative_tokens\": 15}' --attention-backend flash_attn DFlash 推测解码是可选项。"
      }
    },
    {
      "@type": "Question",
      "name": "为什么 WebGPU 仅在末日模式中可用?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "因为我们认为浏览器内的 WebGPU 文本推理目前对大多数用户来说还不够好,不希望您忍受糟糕的体验。如果您想在本地使用相同的 LFM2.5 2.6B 模型,请在自己的机器上通过 llama.cpp 或 Ollama 运行推理,并让 WebBrain 连接到该本地端点,而不是依赖 WebGPU。 WebGPU 视觉回退仍然可用,因为它的模型小得多,而且这个回退功能只会偶尔使用。"
      }
    },
    {
      "@type": "Question",
      "name": "连接到我网络上的本地 LLM 服务器(vLLM、Ollama、llama.cpp)时出现「Failed to fetch」",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "如果你的 LLM 服务器在本地网络中的另一台机器上(例如 http://192.168.1.x:8000),除非服务器发送 CORS 头,否则 Chrome 会拦截该请求。解决方案因服务器而异: vLLM:启动时添加 --allowed-origins '[\"*\"]'(值必须是 JSON 列表)。 Ollama:启动前设置环境变量 OLLAMA_ORIGINS=*。 llama.cpp:默认启用 CORS,无需更改。 如果你的服务器运行在 localhost(与浏览器同一台机器),通常不需要 CORS。该问题仅影响本地网络上跨机器的连接。请确保 WebBrain 设置中的基础 URL 以 /v1 结尾(例如 http://192.168.1.47:8000/v1)。 例外:从浏览器扩展使用 Ollama 时仍可能需要 OLLAMA_ORIGINS;请参见下方的 Ollama FAQ。"
      }
    },
    {
      "@type": "Question",
      "name": "为什么 localhost 上的 Ollama 会对 WebBrain 扩展返回 403?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "较新的 Ollama 版本即使运行在同一台机器上,也可能拒绝来自浏览器扩展来源的请求。扩展会发送类似 chrome-extension://... 或 moz-extension://... 的 Origin,如果未允许这些来源,Ollama 可能返回 403。 先退出任何已经占用 11434 端口的 Ollama 桌面应用,然后用以下命令之一启动 Ollama: OLLAMA_ORIGINS=\"*\" ollama serve OLLAMA_ORIGINS=\"chrome-extension://*,moz-extension://*\" ollama serve 将 WebBrain 的 Ollama Base URL 保持为 http://localhost:11434/v1。终端中的 curl 检查即使没有这个设置也可能正常工作,因为它们不会发送浏览器扩展来源。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 在 Firefox 上能用吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "能。WebBrain 同时提供 Chrome 版(使用 sidePanel API 的 Manifest V3)和 Firefox 版(使用 sidebar_action 的 Manifest V2)。两个版本功能一致。Firefox 版本可以作为临时附加组件用于开发,也可以发布到 addons.mozilla.org 进行永久安装。"
      }
    },
    {
      "@type": "Question",
      "name": "我可以像 Chrome 那样把 Firefox 的侧边栏从左边移到右边吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "可以 —— Firefox 的侧边栏默认显示在左侧,但你可以把它切换到右侧。在侧边栏标题栏上右键点击,选择「将侧边栏移到右侧」(也可以从菜单栏走「查看 → 侧边栏 → 将侧边栏移到右侧」)。重启后位置保持不变。Chrome 的 sidePanel 默认在右侧,且无法由用户从面板本身移动。"
      }
    },
    {
      "@type": "Question",
      "name": "在 Vivaldi 的 Web Panel 中使用 WebBrain 有哪些限制?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "有。Vivaldi Web Panel 会屏蔽 confirm()、alert() 和 prompt() 等原生 JavaScript 对话框。WebBrain 的询问、执行和开发模式切换已不再依赖这些对话框,但少数次要操作仍然依赖。 录制: 暂时不要在 Vivaldi 中使用 /record。如果录制失败,Vivaldi 可能会隐藏错误提示,因而不会显示任何说明。 设置、历史记录、跟踪记录和 Ollama 交接: 这些页面也包含原生对话框,但 WebBrain 通常会在普通标签页中打开它们,因此可以正常工作。如果你手动把其中某个页面放进 Web Panel,请先在普通标签页中打开它,再使用依赖对话框的操作。"
      }
    },
    {
      "@type": "Question",
      "name": "使用 WebBrain 安全吗?它能修改网页吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "WebBrain 有三种模式。询问模式(默认)只读,无法修改页面内容。执行模式可进行点击、输入和导航等浏览器操作,开发模式则增加页面调试工具。会产生后果的操作默认需要批准;如果关闭该权限门控,WebBrain 会显示明显的警告横幅。你可以随时通过「停止」按钮停止代理。扩展源代码在 GitHub 上完全开放供审计。"
      }
    },
    {
      "@type": "Question",
      "name": "「WebBrain started debugging this browser」横幅是什么?WebBrain 为什么使用 CDP?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "为了可靠地在页面上执行操作,WebBrain 通过标准的 chrome.debugger 扩展 API 使用 Chrome DevTools Protocol(CDP)——这也是触发 Chrome「WebBrain started debugging this browser」横幅的原因。CDP 让代理能够以现代网站真正接受的可信输入事件进行点击和输入;从 content script 派发的合成事件会被许多网站、Web Components 以及由框架控制的输入字段拒绝。WebBrain 也借此为视觉回退捕获像素级精确的截图,并访问 content script 看不到的跨域 iframe 和 shadow DOM。 只读的询问模式不需要 CDP——页面和无障碍树的读取都通过普通的 content script 完成。需要它的是执行模式的可靠性和跨域操作;而在 Manifest V3 扩展中,没有任何无需调试器的 API 能提供可信输入。WebBrain 仅在某个操作需要时才按标签页附加调试器,而且整个扩展都是开源的,你可以审计会话究竟做了什么。CDP 很强大,因此我们把它的影响范围当作需要约束的东西(按需附加、读取不经过它),进一步收紧它已列入我们的安全路线图。"
      }
    },
    {
      "@type": "Question",
      "name": "它问我的问题太多了。可以关闭吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "这些批准提示是为了保护你的安全。即使在你信任的网站上,恶意行为者也可能伪造 LLM 指令或注入内容,试图让代理代表你执行你不会同意的操作。因此,WebBrain 在执行有后果的操作之前始终需要你的批准。如果你仍然不想经过这些提示,可以在侧边面板输入 /dangerously-skip-permissions,或者关闭它们:打开侧边插件,点击标题栏中的齿轮图标,进入 settings.html 的 Permissions 标签页,然后关闭 Ask before consequential actions 选项。"
      }
    },
    {
      "@type": "Question",
      "name": "如何用 WebBrain 进行网页抓取和数据提取?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "打开任意网页,打开 WebBrain 侧边栏,用自然语言提问:「提取本页面所有产品名称和价格」、「获取本页面所有邮箱地址」或「用要点总结这篇文章」。AI 代理会读取页面内容、理解结构并返回提取的数据。对于更复杂的抓取,切换到执行模式,代理可以在页面间导航、点击分页按钮,并在多个页面上聚合数据。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 是直接调用 API,还是始终通过界面点击?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "默认情况下,WebBrain 对任何会创建、修改、删除、发送、提交、发布或购买的操作,始终通过可见界面进行。它会导航到页面、填写表单、点击按钮 —— 完全像你一样操作。它拒绝在后台通过 fetch() 直接调用 REST/GraphQL 端点进行变更。这是刻意设计:API 操作是不可见的(你看不到发送了什么),通常需要你可能未配置的单独认证令牌,而且相比于一次可见的误点击,影响范围大得多。UI-first 意味着一切都在屏幕上、在你平时的浏览器会话中、并且可中断。 对于读取数据 —— 获取 README、查找议题、跨站比价、检查状态页 —— WebBrain 会自由地通过 fetch_url 和 research_url 工具发送后台 HTTP 请求。读取不等于操作;它不会改变远程服务上的任何东西,因此不存在同样的安全顾虑。 如果你希望在某个具体任务上允许 API 变更,请在消息开头输入 /allow-api(可以后跟一段简短的任务描述)。这个按会话生效的覆盖会让 WebBrain 在界面确实失败或不可用时回退到 API 端点,但只要界面可用仍优先使用界面。覆盖启用期间,输入区上方会显示一枚置顶徽章,重置会话后该标志会清除。"
      }
    },
    {
      "@type": "Question",
      "name": "我能在 LM Studio 里也用吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "可以。WebBrain 的只读网络工具 —— fetch_url 和 research_url —— 也作为独立的 LM Studio 插件发布在 webbrain/web-tools。用 lms clone webbrain/web-tools 安装,然后在任意 LM Studio 聊天里开启 —— 任何支持工具调用的模型都能调用这两个工具,你不需要安装浏览器扩展。纯 Node,无 headless 浏览器。源码:lmstudio-plugin/。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 在我的标签页上工作时,我可以上下滚动吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "大多数时候可以——尤其是在 Ask 模式下处理“总结此页面”之类的只读请求时。WebBrain 工作期间,你可以继续滚动。 什么时候不适合滚动? 自动截图反映的是标签页当前的视口。WebBrain 在 Act 或 Dev 模式下主动检查可见内容或与其交互时,滚动可能会移走目标或改变模型看到的内容。请先让该步骤完成再滚动;除此之外,你可以继续使用页面。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 工作时,我可以切换标签页吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "可以。从 27.0.0 起,除非确实需要前台访问,否则 WebBrain 在基于 Chromium 的浏览器和 Firefox 中都不会抢占焦点。任务会继续绑定到启动时的标签页,因此你可以放心地在另一个标签页中工作。 如果某个极少见的步骤需要将原标签页置于前台,WebBrain 可能会短暂聚焦该标签页。WebBrain 正在其中执行操作时,请避免在同一标签页点击或输入。"
      }
    },
    {
      "@type": "Question",
      "name": "个人资料自动填写如何工作?它安全吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "个人资料自动填写是 设置 → 记忆 中的可选功能。你输入一段简短的自述 —— 姓名、工作邮箱、公司以及用于低风险注册的一次性密码 —— 然后将其打开。启用后,WebBrain 会将这段文本附加到代理的系统提示中,这样它就能无需每次询问即可填写注册表单。 该文本以明文保存在浏览器的本地存储中。它不会被传送到 WebBrain 项目,但会在每一轮作为系统提示的一部分发送给你配置的 LLM 提供商。默认关闭。 不要在此放置重要账户的密码(Google、Apple、iCloud、银行、公司 SSO、主邮箱)。这些账户应启用 2FA,而且本就不该交给代理。预期用途是你在订阅通讯和免费试用注册时反复使用的一次性密码。"
      }
    },
    {
      "@type": "Question",
      "name": "截图打码设置能保证我的隐私数据永远不会到达云端视觉模型吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "不能——它只是降低了暴露风险,并不是保证。启用后(设置 → 高级 → 截图打码,默认关闭),WebBrain 会在每张截图发送给视觉模型之前,对表单字段以及看起来像邮箱地址或电话号码的文本进行打码。检测完全在你的设备上通过 DOM 启发式方法运行;不会额外传输任何内容。 这是尽力而为且失败开放(fail-open)的处理。如果检测器无法在某个页面上运行——例如刚导航完成之后、在 PDF 查看器中,或在受限的浏览器页面上——截图仍会以未打码的原样发送,而不会中止你的任务。DOM 启发式方法看不到的内容(canvas 上绘制的文字、图片中的个人信息、不常见的组件)同样可能被遗漏。而且该设置只覆盖截图:发送给模型的页面文本不会被它打码。 若需要完全的视觉隐私,请使用本地模型。使用 llama.cpp 或 Ollama 等离线提供方时,截图和页面文本永远不会离开你的设备,因此从一开始就没有需要打码的内容——这是唯一能保证隐私的配置。参见上文的\"我能完全离线使用 WebBrain 吗?\"。 没有能运行支持视觉的本地模型的设备?一个不错的折中方案是:用一个体积小的本地模型负责规划和工具调用(轻量到普通 CPU/GPU 也能胜任),再搭配一个云端提供方负责视觉子调用,同时开启截图打码。这样你的对话和页面文本仍留在本地,而每一张发往云端视觉的截图都已先对表单字段和检测到的邮箱/电话进行了打码——在不需要完整本地视觉模型硬件的情况下减少了云端暴露。请在提供商 → 视觉中配置这种拆分(参见上文的\"WebBrain 如何控制云端 LLM 的账单?\")。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 如何处理 Cookie 横幅和付费墙?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Cookie 横幅:WebBrain 能识别常见框架(OneTrust、Cookiebot、Didomi、Quantcast、Google Funding Choices、TrustArc)的同意横幅,并在对页面进行推理之前将其关闭。当「全部拒绝」/「拒绝非必要」/「仅必要」清晰可见时优先选择这些选项;否则会退而点击「全部接受」,而不是陷入「管理偏好」的迷宫。 付费墙:WebBrain 会如实报告付费墙,并告诉你它实际看到了什么(标题、副标题、开头几段)。它不会尝试绕过付费墙 —— 不使用 archive.today、12ft.io、不清除 Cookie、不禁用 JS、不使用阅读模式小技巧。如果你想要完整文章,请使用订阅登录,或请 WebBrain 搜索同一报道的免费报道。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 支持 dry-run(演练)模式吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "截至 7.0.0 版本, 还不支持。dry-run 模式已在路线图中, 后续会提供。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 会把整个 DOM 发送给 AI 模型吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "不会。默认情况下,WebBrain 不会发送原始 HTML 或完整的 DOM 转储。它首先使用页面 URL 和标题、匹配的网站指引,并在启用视觉功能时选择性地提供当前视口截图。 当任务需要页面内容时,WebBrain 会按需读取精简的语义化无障碍树或提取后的文本。读取结果会在适当情况下按可见性过滤,并设置字符上限和分页。只有 Dev 模式可以访问原始页面源代码。"
      }
    },
    {
      "@type": "Question",
      "name": "为什么 WebBrain 33.0.0 及更高版本采用 GPL 许可?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "WebBrain 33.0.0 及更高版本在 GPL-3.0-or-later 下分发,因为浏览器扩展打包集成了 GPL 许可的 Xapian/libzim WebAssembly 运行时,用于维基百科 ZIM 全文搜索。 扩展包内含适用的 GPL 声明,随每个版本一并发布所集成运行时的完整对应源码。33.0.0 之前的版本仍为 MIT 许可,独立发布的子项目和第三方组件保留其声明的许可。详情请见许可决策记录。"
      }
    },
    {
      "@type": "Question",
      "name": "WebBrain 如何控制云端 LLM 的账单?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "三个独立的层: 节省 token 的截图。在任何图像离开你的机器之前,WebBrain 会先缩放它(短边封顶,保持宽高比),然后迭代 JPEG 压缩直到适配每轮的图像 token 预算。一张 2000×1200 的截图,在 GPT-4o 上原本大约要花 1500 个输入 token,可被压缩到约 300–500 个 token,对页面阅读任务来说没有实际损失。实现位于 _fitImageDimensions,并有覆盖预算计算的单元测试。 智能上下文裁剪。对话历史、工具输出和内联 DOM 转储都会按每轮加以限制,当活跃模型的上下文窗口接近占满时,会从最早的内容开始裁剪。你不会看到一次运行因为一次 read_page 返回了一篇长篇大论,就从 1 万 token 悄悄膨胀到 10 万。 专用视觉模型。将便宜的文本模型(如 GPT-4o-mini)用于规划和工具调用,再配一个专门的视觉模型(如 GPT-4o)只用于截图,这样你不必在每一轮都支付多模态模型的价格。可在 提供商 → 视觉 中配置。 结果:与云端提供商的长会话保持可预测。如需完全控制,请使用本地 llama.cpp —— 每 token 成本为零。"
      }
    },
    {
      "@type": "Question",
      "name": "我可以为 WebBrain 做贡献吗?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "当然可以!WebBrain 采用 GPL-3.0-or-later 许可,欢迎贡献。请查看 GitHub 仓库 了解议题、功能请求和贡献指南。"
      }
    }
  ]
}
  </script>
  <style>
    [hidden] { display: none !important; }
    .visually-hidden {
      position: absolute !important;
      width: 1px;
      height: 1px;
      padding: 0;
      margin: -1px;
      overflow: hidden;
      clip: rect(0, 0, 0, 0);
      white-space: nowrap;
      border: 0;
    }
    .faq-shell { grid-template-columns: 238px minmax(0, 820px); justify-content: center; }
    .faq-language {
      position: relative;
      display: inline-flex;
      align-items: center;
      min-width: 142px;
    }
    .faq-language select {
      width: 100%;
      height: 36px;
      appearance: none;
      padding: 0 34px 0 13px;
      border: 1px solid var(--line);
      border-radius: 999px;
      background: var(--panel);
      color: var(--muted);
      font: inherit;
      font-size: 12px;
      font-weight: 700;
      cursor: pointer;
    }
    [dir="rtl"] .faq-language select { padding: 0 13px 0 34px; }
    .faq-language::after {
      content: "⌄";
      position: absolute;
      inset-inline-end: 13px;
      color: var(--faint);
      pointer-events: none;
    }
    .sidebar-link-note {
      float: inline-end;
      color: var(--faint);
      font-family: "SFMono-Regular", Consolas, monospace;
      font-size: 10px;
    }
    .faq-hero { padding-bottom: 30px; }
    .faq-search {
      position: relative;
      display: block;
      max-width: 640px;
      margin-top: 26px;
    }
    .faq-search svg {
      position: absolute;
      inset-inline-start: 18px;
      top: 17px;
      width: 19px;
      height: 19px;
      color: var(--signal);
      pointer-events: none;
    }
    .faq-search input {
      width: 100%;
      height: 54px;
      padding: 0 46px;
      border: 1px solid var(--line-strong);
      border-radius: 14px;
      background: linear-gradient(145deg, var(--panel), var(--panel-2));
      box-shadow: 0 14px 44px rgba(0, 0, 0, 0.16);
      color: var(--ink);
      font: inherit;
      font-size: 15px;
      outline: none;
    }
    .faq-search input:focus {
      border-color: color-mix(in srgb, var(--signal) 65%, var(--line));
      box-shadow: 0 0 0 3px var(--signal-soft), 0 18px 54px rgba(0, 0, 0, 0.2);
    }
    .faq-search input::placeholder { color: var(--faint); }
    .faq-search kbd {
      position: absolute;
      inset-inline-end: 14px;
      top: 15px;
      color: var(--faint);
      pointer-events: none;
    }
    .faq-empty {
      margin: 34px 0;
      padding: 18px 20px;
      border: 1px dashed var(--line-strong);
      border-radius: var(--radius-sm);
      color: var(--muted);
      text-align: center;
    }
    .faq-topic { padding: 38px 0 2px; scroll-margin-top: calc(var(--header-h) + 22px); }
    .faq-topic + .faq-topic { border-top: 1px solid var(--line); }
    .faq-topic-header {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 18px;
      margin-bottom: 14px;
    }
    .faq-topic-header h2 { margin: 0; font-size: 25px; }
    .faq-topic-header > span {
      min-width: 30px;
      padding: 3px 9px;
      border: 1px solid var(--line);
      border-radius: 999px;
      color: var(--faint);
      font-family: "SFMono-Regular", Consolas, monospace;
      font-size: 11px;
      text-align: center;
    }
    .faq-question {
      border-top: 1px solid var(--line);
      scroll-margin-top: calc(var(--header-h) + 22px);
    }
    .faq-question:last-child { border-bottom: 1px solid var(--line); }
    .faq-question summary {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 22px;
      min-height: 66px;
      padding: 15px 4px;
      color: var(--ink);
      font-weight: 720;
      line-height: 1.4;
      list-style: none;
      cursor: pointer;
    }
    .faq-question summary::-webkit-details-marker { display: none; }
    .faq-question summary:hover { color: var(--brand-2); }
    .faq-question-mark {
      position: relative;
      width: 22px;
      height: 22px;
      flex: 0 0 22px;
      border: 1px solid var(--line-strong);
      border-radius: 50%;
      color: var(--signal);
    }
    .faq-question-mark::before,
    .faq-question-mark::after {
      content: "";
      position: absolute;
      left: 5px;
      right: 5px;
      top: 10px;
      height: 1px;
      background: currentColor;
    }
    .faq-question-mark::after { transform: rotate(90deg); transition: transform 0.18s ease; }
    .faq-question[open] .faq-question-mark { border-color: var(--signal); background: var(--signal-soft); }
    .faq-question[open] .faq-question-mark::after { transform: rotate(0); }
    .faq-answer {
      padding: 0 44px 20px 4px;
      color: var(--muted);
      font-size: 15px;
    }
    [dir="rtl"] .faq-answer { padding: 0 4px 20px 44px; }
    .faq-answer p { margin: 0 0 14px; color: var(--muted); }
    .faq-answer p:last-child { margin-bottom: 0; }
    .faq-answer strong { color: var(--ink); }
    .faq-answer ul, .faq-answer ol { padding-inline-start: 22px; }
    .faq-answer a { overflow-wrap: anywhere; }
    @media (max-width: 1080px) {
      .faq-shell { grid-template-columns: 220px minmax(0, 1fr); }
    }
    @media (max-width: 780px) {
      .faq-shell { display: block; }
      .faq-language { min-width: 118px; }
      .faq-language select { max-width: 118px; }
    }
    @media (max-width: 560px) {
      .faq-language { min-width: 104px; }
      .faq-language select { max-width: 104px; }
      .faq-search kbd { display: none; }
      .faq-search input { padding-inline-end: 18px; }
      .faq-topic-header h2 { font-size: 22px; }
      .faq-question summary { min-height: 62px; font-size: 15px; }
    }
  </style>
</head>
<body>
  <a class="skip-link" href="#main">跳到主要内容</a>
  <header class="site-header">
    <div class="header-inner">
      <a class="brand" href="https://webbrain.one/zh/"><img src="/logo-github.png" alt=""><span>WebBrain</span><span class="brand-docs">常见问题</span></a>
      <nav class="top-nav" aria-label="文档">
        <a href="/docs/zh/">文档</a>
        <a href="/blog/">博客</a>
        <a href="https://github.com/webbrain-one/webbrain">GitHub</a>
      </nav>
      <div class="header-tools">
        <label class="faq-language">
          <span class="visually-hidden">选择语言</span>
          <select data-faq-language aria-label="选择语言"><option value="en">English</option><option value="es">Español</option><option value="fr">Français</option><option value="tr">Türkçe</option><option value="zh" selected>中文</option><option value="ru">Русский</option><option value="uk">Українська</option><option value="ar">العربية</option><option value="ja">日本語</option><option value="ko">한국어</option><option value="id">Bahasa Indonesia</option><option value="th">ไทย</option><option value="ms">Bahasa Melayu</option><option value="tl">Filipino</option><option value="he">עברית</option><option value="hi">हिन्दी</option><option value="pt">Português</option><option value="vi">Tiếng Việt</option><option value="bn">বাংলা</option><option value="fa">فارسی</option><option value="nl">Nederlands</option><option value="de">Deutsch</option></select>
        </label>
        <button class="icon-button" type="button" data-theme-toggle aria-label="切换浅色 / 深色主题">☀</button>
        <button class="sidebar-toggle" type="button" data-sidebar-toggle aria-expanded="false" aria-label="主题">☰</button>
      </div>
    </div>
  </header>

  <div class="docs-shell faq-shell">
    <aside class="docs-sidebar" aria-label="主题">
      <div class="sidebar-group">
        <div class="sidebar-label">主题</div>
        <nav><a href="#topic-about">了解 WebBrain</a><a href="#topic-cloud">云服务与账单</a><a href="#topic-models">模型与本地设置</a><a href="#topic-browsers">浏览器与日常使用</a><a href="#topic-safety">安全与隐私</a></nav>
      </div>
      <div class="sidebar-group">
        <div class="sidebar-label">文档</div>
        <nav>
          <a href="/docs/zh/">文档 <span class="sidebar-link-note">中文</span></a>
          <a href="https://discord.gg/cgC325ssfw">Discord 上的 WebBrain</a>
        </nav>
      </div>
    </aside>

    <main class="doc-main" id="main">
      <div class="breadcrumb"><a href="/docs/zh/">文档</a> / 常见问题</div>
      <section class="doc-hero faq-hero">
        <div class="eyebrow">常见问题</div>
        <h1>常见问题解答</h1>
        <p class="lede">快速了解设置、模型、账单、安全性以及 WebBrain 在浏览器中的工作方式。</p>
        <label class="faq-search">
          <span class="visually-hidden">搜索问题和答案…</span>
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"></circle><path d="m16.5 16.5 4 4"></path></svg>
          <input type="search" data-faq-search placeholder="搜索问题和答案…" autocomplete="off" spellcheck="false">
          <kbd aria-hidden="true">/</kbd>
        </label>
      </section>

      <p class="faq-empty" data-faq-empty role="status" aria-live="polite" hidden>没有符合该搜索的答案。</p>
    <section class="faq-topic" id="topic-about" data-faq-topic>
      <header class="faq-topic-header">
        <h2>了解 WebBrain</h2>
        <span aria-label="7">7</span>
      </header>
      <details class="faq-question" id="alt-claude" data-faq-item>
        <summary><span>WebBrain 是 Claude 浏览器插件的免费替代品吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>是的。WebBrain 提供类似的 AI 浏览器代理能力 —— 阅读页面、提取数据、点击按钮、填写表单并自动化多步骤工作流。与需要 Claude Pro 订阅且仅支持 Anthropic 模型的专有 Claude 插件不同,WebBrain 完全免费、开源(GPL-3.0-or-later 许可),并支持多个 LLM 提供商,包括完全在你的机器上运行的本地模型。</p></div>
      </details>
      <details class="faq-question" id="vs-frameworks" data-faq-item>
        <summary><span>WebBrain 与 OpenClaw、Browser-Use 以及其他 AI 代理框架有何不同?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>它们属于不同类别的工具。WebBrain 是浏览器扩展 —— 你在 Chrome 或 Firefox 中安装它,并在侧边栏中与它对话,无需编码。OpenClaw 和 Browser-Use 等框架是面向开发者的 SDK,用 Python 构建自动化浏览器流水线,通常使用无头浏览器和 CDP。换句话说:WebBrain 用于日常浏览时的 AI 助手;代理框架用于构建抓取机器人和测试自动化。你可以同时使用 —— 二者互补。</p></div>
      </details>
      <details class="faq-question" id="workflow-editor" data-faq-item>
        <summary><span>我可以编辑 WebBrain 工作流吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>可以。使用 <a href="https://www.webbrain.one/workflow-editor">WebBrain 工作流编辑器</a>,可在浏览器中查看、编辑、验证和导出工作流 JSON 文件。</p></div>
      </details>
      <details class="faq-question" id="firefox" data-faq-item>
        <summary><span>WebBrain 在 Firefox 上能用吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>能。WebBrain 同时提供 Chrome 版(使用 sidePanel API 的 Manifest V3)和 Firefox 版(使用 sidebar_action 的 Manifest V2)。两个版本功能一致。Firefox 版本可以作为临时附加组件用于开发,也可以发布到 addons.mozilla.org 进行永久安装。</p></div>
      </details>
      <details class="faq-question" id="scraping" data-faq-item>
        <summary><span>如何用 WebBrain 进行网页抓取和数据提取?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>打开任意网页,打开 WebBrain 侧边栏,用自然语言提问:「提取本页面所有产品名称和价格」、「获取本页面所有邮箱地址」或「用要点总结这篇文章」。AI 代理会读取页面内容、理解结构并返回提取的数据。对于更复杂的抓取,切换到执行模式,代理可以在页面间导航、点击分页按钮,并在多个页面上聚合数据。</p></div>
      </details>
      <details class="faq-question" id="multilingual" data-faq-item>
        <summary><span>WebBrain 支持 dry-run(演练)模式吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>截至 <strong>7.0.0</strong> 版本, 还不支持。dry-run 模式已在路线图中, 后续会提供。</p></div>
      </details>
      <details class="faq-question" id="contribute" data-faq-item>
        <summary><span>我可以为 WebBrain 做贡献吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>当然可以!WebBrain 采用 GPL-3.0-or-later 许可,欢迎贡献。请查看 <a href="https://github.com/webbrain-one/webbrain" target="_blank">GitHub 仓库</a> 了解议题、功能请求和贡献指南。</p></div>
      </details>
    </section>
    <section class="faq-topic" id="topic-cloud" data-faq-topic>
      <header class="faq-topic-header">
        <h2>云服务与账单</h2>
        <span aria-label="5">5</span>
      </header>
      <details class="faq-question" id="cloud-subscription" data-faq-item>
        <summary><span>WebBrain Compass 订阅多少钱?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>WebBrain Compass 目前为<strong>每个设备配置文件每月 5 美元</strong>,暂时比 Claude Pro 便宜得多。当前用量在公平使用政策下不限量:正常个人使用没问题,但不允许滥用、自动化刷量、转售或异常高流量使用。</p><p>订阅绑定到扩展为该浏览器 + 操作系统 GUID 生成的设备标识符,而不是用户账户。如果你重置扩展存储、删除浏览器配置文件、重新安装浏览器、更换浏览器/操作系统或丢失设备而导致该标识符丢失,我们无法找回或转移,也不会因此退款。</p></div>
      </details>
      <details class="faq-question" id="manage-subscription" data-faq-item>
        <summary><span>如何管理或取消我的订阅?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>请前往 <a href="https://api.webbrain.one/account" target="_blank" rel="noopener">api.webbrain.one/account</a> 管理账单,并使用您的电子邮件登录。</p></div>
      </details>
      <details class="faq-question" id="subscription-unrecognized" data-faq-item>
        <summary><span>我已经为 WebBrain Compass 付过费了,但扩展仍要求我再次付款。我需要付两次吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>不需要——请勿重复付款。你的 Compass 订阅绑定到扩展生成的浏览器/设备标识符,如果该标识符发生变化(新浏览器或设备、重装浏览器、删除浏览器配置文件或重置扩展存储),扩展将无法识别现有订阅,从而要求付款。</p><p>请通过自助门户 <a href="https://api.webbrain.one/portal" target="_blank" rel="noopener">api.webbrain.one/portal</a> 将现有订阅重新关联到当前浏览器,并按其中的说明恢复访问。</p><p>如需收据及其他账单变更,请使用电子邮件登录 <a href="https://api.webbrain.one/account" target="_blank" rel="noopener">api.webbrain.one/account</a> 管理账单。</p></div>
      </details>
      <details class="faq-question" id="cloud-sync" data-faq-item>
        <summary><span>加密的 Cloud Sync 如何工作?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>Cloud Sync 是面向有效 WebBrain Compass 订阅用户的可选功能。它会同步你的 WebBrain 记忆、个人资料自动填充文本,以及受支持的提供商配置(包括 API 密钥)。它<strong>不会</strong>同步聊天记录、浏览器历史、页面截图,或旧版 OAuth 访问令牌与刷新令牌。</p><p>浏览器会在上传前使用你选择的密码对同步保险库进行加密。WebBrain Compass 只存储加密后的保险库;无法读取你的记忆、个人资料文本、提供商设置或 API 密钥,也无法帮你找回同步密码。</p><p>邮箱字段用于 WebBrain Compass 的 magic-link 账单/订阅身份验证,不是账户密码。如果界面在 Cloud Sync 中提示更改密码,指的是<strong>同步加密密码</strong>,而不是 WebBrain 账户密码。</p><p>如果你忘记了同步密码,旧的加密云端保险库将无法解密。你可以重置云端保险库,并从仍保留本地数据的设备重新上传一份新的加密副本。</p></div>
      </details>
      <details class="faq-question" id="token-conscious" data-faq-item>
        <summary><span>WebBrain 如何控制云端 LLM 的账单?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>三个独立的层:</p><p><strong>节省 token 的截图。</strong>在任何图像离开你的机器之前,WebBrain 会先缩放它(短边封顶,保持宽高比),然后迭代 JPEG 压缩直到适配每轮的图像 token 预算。一张 2000×1200 的截图,在 GPT-4o 上原本大约要花 1500 个输入 token,可被压缩到约 300–500 个 token,对页面阅读任务来说没有实际损失。实现位于 <code>_fitImageDimensions</code>,并有覆盖预算计算的单元测试。</p><p><strong>智能上下文裁剪。</strong>对话历史、工具输出和内联 DOM 转储都会按每轮加以限制,当活跃模型的上下文窗口接近占满时,会从最早的内容开始裁剪。你不会看到一次运行因为一次 <code>read_page</code> 返回了一篇长篇大论,就从 1 万 token 悄悄膨胀到 10 万。</p><p><strong>专用视觉模型。</strong>将便宜的文本模型(如 GPT-4o-mini)用于规划和工具调用,再配一个专门的视觉模型(如 GPT-4o)只用于截图,这样你不必在每一轮都支付多模态模型的价格。可在 <strong>提供商 → 视觉</strong> 中配置。</p><p>结果:与云端提供商的长会话保持可预测。如需完全控制,请使用本地 llama.cpp —— 每 token 成本为零。</p></div>
      </details>
    </section>
    <section class="faq-topic" id="topic-models" data-faq-topic>
      <header class="faq-topic-header">
        <h2>模型与本地设置</h2>
        <span aria-label="8">8</span>
      </header>
      <details class="faq-question" id="offline" data-faq-item>
        <summary><span>我能完全离线使用 WebBrain 吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>可以。WebBrain 的默认提供商是 llama.cpp,它在你的电脑上运行本地 AI 模型。无需 API 密钥,AI 无需互联网,数据不会离开你的机器。下载一个 GGUF 模型,启动 llama-server,你就拥有了一个完全私有的 AI 浏览器代理。你也可以通过 OpenAI 兼容端点使用 Ollama。</p></div>
      </details>
      <details class="faq-question" id="emergency-box" data-faq-item>
        <summary><span>什么是应急箱,离线 RAG 是如何工作的?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>应急箱是约 570 份公有领域实地参考文档(医疗、生存、教育、通信)的精选合集,WebBrain 可以下载并在本地建立索引。安装后,无需互联网连接即可离线提出事实性问题,并获得基于这些文档的答案。</p><p>WebBrain 在底层使用 SQLite FTS5 对应急箱和已安装的维基百科存档进行快速关键词搜索,另有可选的语义搜索层,使用本地下载的多语言 E5 模型(约 140 MB)。两种方法的结果会被合并去重,每个答案都会引用确切的原文段落。引用在本地阅读器中打开,显示前会验证文档完整性——绝不会跳转到实时网页。</p><p>还可以通过末日模式安装维基百科存档,以获得更广泛的离线知识库。来源和语言筛选器可控制搜索哪些合集。</p></div>
      </details>
      <details class="faq-question" id="models-supported" data-faq-item>
        <summary><span>WebBrain 支持哪些 AI 模型?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>WebBrain 支持四类提供商:llama.cpp(任意本地 GGUF 模型)、OpenAI(GPT-4o、GPT-4 等)、Claude(通过原生 API 使用 Claude Opus、Sonnet、Haiku)以及 OpenRouter(访问多家提供商的 100 多种模型)。任何 OpenAI 兼容的 API 端点都能工作,因此你也可以使用 Together AI、Groq、Mistral 等服务,或任何提供 OpenAI 兼容接口的本地服务器。</p></div>
      </details>
      <details class="faq-question" id="recommended-model" data-faq-item>
        <summary><span>最推荐的模型是什么?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>截至 <strong>2026 年 4 月 21 日</strong>,最推荐的是 <a href="https://huggingface.co/Qwen/Qwen3.6-35B-A3B" target="_blank">Qwen 3.6 35B</a>。原因:在我们的视觉基准测试中(<a href="https://www.webbrain.one/blog/vision-model-shootout" target="_blank">vision-model-shootout</a>),它在截图理解方面超过了 Gemma 4,同时对本地推理仍然可行。</p><p>在消费级 GPU 上,RTX 5090 是理想选择;RTX 4090 通常可借助 <a href="https://huggingface.co/Intel/Qwen3.6-35B-A3B-int4-AutoRound" target="_blank">Intel/Qwen3.6-35B-A3B-int4-AutoRound</a> 的 INT4 AutoRound 量化运行。</p><p>追求最高速度时,推荐使用 <strong>vLLM</strong> 提供服务。示例命令:</p><p><code>python -u -m vllm.entrypoints.openai.api_server --model Intel/Qwen3.6-35B-A3B-int4-AutoRound --served-model-name qwen3.6-35b --quantization auto --dtype bfloat16 --max-model-len 65536 --max-num-batched-tokens 32768 --max-num-seqs 4 --host 0.0.0.0 --port 8000 --gpu-memory-utilization 0.92 --enable-prefix-caching --enable-chunked-prefill --limit-mm-per-prompt '{"image": 4, "video": 1}' --mm-processor-cache-type shm --reasoning-parser qwen3 --enable-auto-tool-choice --tool-call-parser qwen3_coder --trust-remote-code --allowed-origins '["*"]' --speculative-config '{"method": "dflash", "model": "z-lab/Qwen3.6-35B-A3B-DFlash", "num_speculative_tokens": 15}' --attention-backend flash_attn</code></p><p><em>DFlash 推测解码是可选项。</em></p></div>
      </details>
      <details class="faq-question" id="webgpu-apocalypse" data-faq-item>
        <summary><span>为什么 WebGPU 仅在末日模式中可用?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>因为我们认为浏览器内的 WebGPU 文本推理目前对大多数用户来说还不够好,不希望您忍受糟糕的体验。如果您想在本地使用相同的 LFM2.5 2.6B 模型,请在自己的机器上通过 <strong>llama.cpp</strong> 或 <strong>Ollama</strong> 运行推理,并让 WebBrain 连接到该本地端点,而不是依赖 WebGPU。</p><p>WebGPU 视觉回退仍然可用,因为它的模型小得多,而且这个回退功能只会偶尔使用。</p></div>
      </details>
      <details class="faq-question" id="cors" data-faq-item>
        <summary><span>连接到我网络上的本地 LLM 服务器(vLLM、Ollama、llama.cpp)时出现「Failed to fetch」</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>如果你的 LLM 服务器在本地网络中的另一台机器上(例如 <code>http://192.168.1.x:8000</code>),除非服务器发送 <strong>CORS 头</strong>,否则 Chrome 会拦截该请求。解决方案因服务器而异:</p><p><strong>vLLM:</strong>启动时添加 <code>--allowed-origins '["*"]'</code>(值必须是 JSON 列表)。<br><strong>Ollama:</strong>启动前设置环境变量 <code>OLLAMA_ORIGINS=*</code>。<br><strong>llama.cpp:</strong>默认启用 CORS,无需更改。</p><p>如果你的服务器运行在 <code>localhost</code>(与浏览器同一台机器),通常不需要 CORS。该问题仅影响本地网络上跨机器的连接。请确保 WebBrain 设置中的基础 URL 以 <code>/v1</code> 结尾(例如 <code>http://192.168.1.47:8000/v1</code>)。 例外:从浏览器扩展使用 Ollama 时仍可能需要 <code>OLLAMA_ORIGINS</code>;请参见下方的 Ollama FAQ。</p></div>
      </details>
      <details class="faq-question" id="ollama-origins" data-faq-item>
        <summary><span>为什么 localhost 上的 Ollama 会对 WebBrain 扩展返回 403?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>较新的 Ollama 版本即使运行在同一台机器上,也可能拒绝来自浏览器扩展来源的请求。扩展会发送类似 <code>chrome-extension://...</code> 或 <code>moz-extension://...</code> 的 <code>Origin</code>,如果未允许这些来源,Ollama 可能返回 403。</p><p>先退出任何已经占用 <code>11434</code> 端口的 Ollama 桌面应用,然后用以下命令之一启动 Ollama:</p><p><code>OLLAMA_ORIGINS="*" ollama serve</code><br><code>OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*" ollama serve</code></p><p>将 WebBrain 的 Ollama Base URL 保持为 <code>http://localhost:11434/v1</code>。终端中的 <code>curl</code> 检查即使没有这个设置也可能正常工作,因为它们不会发送浏览器扩展来源。</p></div>
      </details>
      <details class="faq-question" id="lm-studio" data-faq-item>
        <summary><span>我能在 LM Studio 里也用吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>可以。WebBrain 的只读网络工具 —— <code>fetch_url</code> 和 <code>research_url</code> —— 也作为独立的 <a href="https://lmstudio.ai" target="_blank">LM Studio</a> 插件发布在 <a href="https://lmstudio.ai/webbrain/web-tools" target="_blank">webbrain/web-tools</a>。用 <code>lms clone webbrain/web-tools</code> 安装,然后在任意 LM Studio 聊天里开启 —— 任何支持工具调用的模型都能调用这两个工具,你不需要安装浏览器扩展。纯 Node,无 headless 浏览器。源码:<a href="https://github.com/webbrain-one/webbrain/tree/main/lmstudio-plugin" target="_blank">lmstudio-plugin/</a>。</p></div>
      </details>
    </section>
    <section class="faq-topic" id="topic-browsers" data-faq-topic>
      <header class="faq-topic-header">
        <h2>浏览器与日常使用</h2>
        <span aria-label="5">5</span>
      </header>
      <details class="faq-question" id="firefox-sidebar-move" data-faq-item>
        <summary><span>我可以像 Chrome 那样把 Firefox 的侧边栏从左边移到右边吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>可以 —— Firefox 的侧边栏默认显示在左侧,但你可以把它切换到右侧。在侧边栏标题栏上右键点击,选择<strong>「将侧边栏移到右侧」</strong>(也可以从菜单栏走<strong>「查看 → 侧边栏 → 将侧边栏移到右侧」</strong>)。重启后位置保持不变。Chrome 的 sidePanel 默认在右侧,且无法由用户从面板本身移动。</p></div>
      </details>
      <details class="faq-question" id="vivaldi-dialogs" data-faq-item>
        <summary><span>在 Vivaldi 的 Web Panel 中使用 WebBrain 有哪些限制?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>有。Vivaldi Web Panel 会屏蔽 <code>confirm()</code>、<code>alert()</code> 和 <code>prompt()</code> 等原生 JavaScript 对话框。WebBrain 的询问、执行和开发模式切换已不再依赖这些对话框,但少数次要操作仍然依赖。</p><p><strong>录制:</strong> 暂时不要在 Vivaldi 中使用 <code>/record</code>。如果录制失败,Vivaldi 可能会隐藏错误提示,因而不会显示任何说明。</p><p><strong>设置、历史记录、跟踪记录和 Ollama 交接:</strong> 这些页面也包含原生对话框,但 WebBrain 通常会在普通标签页中打开它们,因此可以正常工作。如果你手动把其中某个页面放进 Web Panel,请先在普通标签页中打开它,再使用依赖对话框的操作。</p></div>
      </details>
      <details class="faq-question" id="scroll-during-run" data-faq-item>
        <summary><span>WebBrain 在我的标签页上工作时,我可以上下滚动吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>大多数时候可以——尤其是在 <strong>Ask 模式</strong>下处理“总结此页面”之类的只读请求时。WebBrain 工作期间,你可以继续滚动。</p><p><strong>什么时候不适合滚动?</strong> 自动截图反映的是标签页当前的视口。WebBrain 在 <strong>Act 或 Dev 模式</strong>下主动检查可见内容或与其交互时,滚动可能会移走目标或改变模型看到的内容。请先让该步骤完成再滚动;除此之外,你可以继续使用页面。</p></div>
      </details>
      <details class="faq-question" id="tab-switch-during-run" data-faq-item>
        <summary><span>WebBrain 工作时,我可以切换标签页吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>可以。从 <strong>27.0.0</strong> 起,除非确实需要前台访问,否则 WebBrain 在基于 Chromium 的浏览器和 Firefox 中都不会抢占焦点。任务会继续绑定到启动时的标签页,因此你可以放心地在另一个标签页中工作。</p><p>如果某个极少见的步骤需要将原标签页置于前台,WebBrain 可能会短暂聚焦该标签页。WebBrain 正在其中执行操作时,请避免在同一标签页点击或输入。</p></div>
      </details>
      <details class="faq-question" id="cookies-paywalls" data-faq-item>
        <summary><span>WebBrain 如何处理 Cookie 横幅和付费墙?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p><strong>Cookie 横幅:</strong>WebBrain 能识别常见框架(OneTrust、Cookiebot、Didomi、Quantcast、Google Funding Choices、TrustArc)的同意横幅,并在对页面进行推理之前将其关闭。当「全部拒绝」/「拒绝非必要」/「仅必要」清晰可见时优先选择这些选项;否则会退而点击「全部接受」,而不是陷入「管理偏好」的迷宫。</p><p><strong>付费墙:</strong>WebBrain 会如实报告付费墙,并告诉你它实际看到了什么(标题、副标题、开头几段)。它<strong>不会</strong>尝试绕过付费墙 —— 不使用 archive.today、12ft.io、不清除 Cookie、不禁用 JS、不使用阅读模式小技巧。如果你想要完整文章,请使用订阅登录,或请 WebBrain 搜索同一报道的免费报道。</p></div>
      </details>
    </section>
    <section class="faq-topic" id="topic-safety" data-faq-topic>
      <header class="faq-topic-header">
        <h2>安全与隐私</h2>
        <span aria-label="8">8</span>
      </header>
      <details class="faq-question" id="safe" data-faq-item>
        <summary><span>使用 WebBrain 安全吗?它能修改网页吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>WebBrain 有三种模式。询问模式(默认)只读,无法修改页面内容。执行模式可进行点击、输入和导航等浏览器操作,开发模式则增加页面调试工具。会产生后果的操作默认需要批准;如果关闭该权限门控,WebBrain 会显示明显的警告横幅。你可以随时通过「停止」按钮停止代理。扩展源代码在 GitHub 上完全开放供审计。</p></div>
      </details>
      <details class="faq-question" id="cdp" data-faq-item>
        <summary><span>「WebBrain started debugging this browser」横幅是什么?WebBrain 为什么使用 CDP?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>为了可靠地在页面上执行操作,WebBrain 通过标准的 <code>chrome.debugger</code> 扩展 API 使用 Chrome DevTools Protocol(CDP)——这也是触发 Chrome「WebBrain started debugging this browser」横幅的原因。CDP 让代理能够以现代网站真正接受的<strong>可信输入事件</strong>进行点击和输入;从 content script 派发的合成事件会被许多网站、Web Components 以及由框架控制的输入字段拒绝。WebBrain 也借此为视觉回退捕获像素级精确的截图,并访问 content script 看不到的<strong>跨域 iframe 和 shadow DOM</strong>。</p><p>只读的<strong>询问模式不需要 CDP</strong>——页面和无障碍树的读取都通过普通的 content script 完成。需要它的是<strong>执行模式</strong>的可靠性和跨域操作;而在 Manifest V3 扩展中,没有任何无需调试器的 API 能提供可信输入。WebBrain <strong>仅在某个操作需要时</strong>才按标签页附加调试器,而且整个扩展都是开源的,你可以审计会话究竟做了什么。CDP 很强大,因此我们把它的影响范围当作需要约束的东西(按需附加、读取不经过它),进一步收紧它已列入我们的安全路线图。</p></div>
      </details>
      <details class="faq-question" id="disable-approval-questions" data-faq-item>
        <summary><span>它问我的问题太多了。可以关闭吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>这些批准提示是为了保护你的安全。即使在你信任的网站上,恶意行为者也可能伪造 LLM 指令或注入内容,试图让代理代表你执行你不会同意的操作。因此,WebBrain 在执行有后果的操作之前始终需要你的批准。如果你仍然不想经过这些提示,可以在侧边面板输入 <code>/dangerously-skip-permissions</code>,或者关闭它们:打开侧边插件,点击标题栏中的齿轮图标,进入 <code>settings.html</code> 的 <strong>Permissions</strong> 标签页,然后关闭 <strong>Ask before consequential actions</strong> 选项。</p></div>
      </details>
      <details class="faq-question" id="api-mutations" data-faq-item>
        <summary><span>WebBrain 是直接调用 API,还是始终通过界面点击?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>默认情况下,WebBrain 对任何会创建、修改、删除、发送、提交、发布或购买的操作,<strong>始终通过可见界面进行</strong>。它会导航到页面、填写表单、点击按钮 —— 完全像你一样操作。它拒绝在后台通过 <code>fetch()</code> 直接调用 REST/GraphQL 端点进行变更。这是刻意设计:API 操作是不可见的(你看不到发送了什么),通常需要你可能未配置的单独认证令牌,而且相比于一次可见的误点击,影响范围大得多。UI-first 意味着一切都在屏幕上、在你平时的浏览器会话中、并且可中断。</p><p>对于<strong>读取</strong>数据 —— 获取 README、查找议题、跨站比价、检查状态页 —— WebBrain 会自由地通过 <code>fetch_url</code> 和 <code>research_url</code> 工具发送后台 HTTP 请求。读取不等于操作;它不会改变远程服务上的任何东西,因此不存在同样的安全顾虑。</p><p>如果你希望在某个具体任务上允许 API 变更,请在消息开头输入 <code>/allow-api</code>(可以后跟一段简短的任务描述)。这个按会话生效的覆盖会让 WebBrain 在界面确实失败或不可用时回退到 API 端点,但只要界面可用仍优先使用界面。覆盖启用期间,输入区上方会显示一枚置顶徽章,重置会话后该标志会清除。</p></div>
      </details>
      <details class="faq-question" id="profile" data-faq-item>
        <summary><span>个人资料自动填写如何工作?它安全吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>个人资料自动填写是 <strong>设置 → 记忆</strong> 中的可选功能。你输入一段简短的自述 —— 姓名、工作邮箱、公司以及用于低风险注册的<em>一次性</em>密码 —— 然后将其打开。启用后,WebBrain 会将这段文本附加到代理的系统提示中,这样它就能无需每次询问即可填写注册表单。</p><p>该文本以<strong>明文</strong>保存在浏览器的本地存储中。它<strong>不会</strong>被传送到 WebBrain 项目,但<strong>会</strong>在每一轮作为系统提示的一部分发送给你配置的 LLM 提供商。默认关闭。</p><p><strong>不要在此放置重要账户的密码</strong>(Google、Apple、iCloud、银行、公司 SSO、主邮箱)。这些账户应启用 2FA,而且本就不该交给代理。预期用途是你在订阅通讯和免费试用注册时反复使用的一次性密码。</p></div>
      </details>
      <details class="faq-question" id="screenshot-redaction" data-faq-item>
        <summary><span>截图打码设置能保证我的隐私数据永远不会到达云端视觉模型吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>不能——它只是降低了暴露风险,并不是保证。启用后(<strong>设置 → 高级 → 截图打码</strong>,默认关闭),WebBrain 会在每张截图发送给视觉模型<em>之前</em>,对表单字段以及看起来像邮箱地址或电话号码的文本进行打码。检测完全在你的设备上通过 DOM 启发式方法运行;不会额外传输任何内容。</p><p><strong>这是尽力而为且失败开放(fail-open)的处理。</strong>如果检测器无法在某个页面上运行——例如刚导航完成之后、在 PDF 查看器中,或在受限的浏览器页面上——截图仍会以<em>未打码</em>的原样发送,而不会中止你的任务。DOM 启发式方法看不到的内容(canvas 上绘制的文字、图片中的个人信息、不常见的组件)同样可能被遗漏。而且该设置只覆盖截图:发送给模型的页面<em>文本</em>不会被它打码。</p><p><strong>若需要完全的视觉隐私,请使用本地模型。</strong>使用 llama.cpp 或 Ollama 等离线提供方时,截图和页面文本永远不会离开你的设备,因此从一开始就没有需要打码的内容——这是唯一能保证隐私的配置。参见上文的"我能完全离线使用 WebBrain 吗?"。</p><p><strong>没有能运行支持视觉的本地模型的设备?</strong>一个不错的折中方案是:用一个体积小的本地模型负责规划和工具调用(轻量到普通 CPU/GPU 也能胜任),再搭配一个云端提供方负责视觉子调用,同时开启截图打码。这样你的对话和页面文本仍留在本地,而每一张发往云端视觉的截图都已先对表单字段和检测到的邮箱/电话进行了打码——在不需要完整本地视觉模型硬件的情况下减少了云端暴露。请在<strong>提供商 → 视觉</strong>中配置这种拆分(参见上文的"WebBrain 如何控制云端 LLM 的账单?")。</p></div>
      </details>
      <details class="faq-question" id="page-context" data-faq-item>
        <summary><span>WebBrain 会把整个 DOM 发送给 AI 模型吗?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>不会。默认情况下,WebBrain 不会发送原始 HTML 或完整的 DOM 转储。它首先使用页面 URL 和标题、匹配的网站指引,并在启用视觉功能时选择性地提供当前视口截图。</p><p>当任务需要页面内容时,WebBrain 会按需读取精简的语义化无障碍树或提取后的文本。读取结果会在适当情况下按可见性过滤,并设置字符上限和分页。只有 Dev 模式可以访问原始页面源代码。</p></div>
      </details>
      <details class="faq-question" id="offline-licensing" data-faq-item>
        <summary><span>为什么 WebBrain 33.0.0 及更高版本采用 GPL 许可?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
        <div class="faq-answer"><p>WebBrain 33.0.0 及更高版本在 GPL-3.0-or-later 下分发,因为浏览器扩展打包集成了 GPL 许可的 Xapian/libzim WebAssembly 运行时,用于维基百科 ZIM 全文搜索。</p><p>扩展包内含适用的 GPL 声明,随每个版本一并发布所集成运行时的完整对应源码。33.0.0 之前的版本仍为 MIT 许可,独立发布的子项目和第三方组件保留其声明的许可。详情请见<a href="https://github.com/webbrain-one/webbrain/blob/main/docs/offline-rag-licensing.md" target="_blank">许可决策记录</a>。</p></div>
      </details>
    </section>
    </main>
  </div>

<!-- Site footer: start -->
<footer class="wb-footer">
  <div class="wb-footer-inner">
    <div class="wb-footer-brand">
      <p class="wb-footer-tagline">我们的使命:让网络更智能。</p>
      <p class="wb-footer-copy">© 2026 WebBrain。由 <a href="https://emresokullu.com" target="_blank">Emre Sokullu</a> 与<a href="https://github.com/webbrain-one/webbrain/graphs/contributors" target="_blank">贡献者</a>共同构建。</p>
    </div>
    <div class="wb-footer-row">
      <div class="wb-footer-links">
        <a href="/zh/">浏览器扩展</a>
        <a href="/companion/zh/">桌面 Companion</a>
        <a href="/research/">研究</a>
        <a href="/docs/zh/">文档</a>
        <a href="/docs/zh/faq/">常见问题</a>
        <a href="/blog/">博客</a>
        <a href="/privacy">隐私政策</a>
        <a href="https://github.com/webbrain-one/webbrain/issues" target="_blank" rel="noopener">报告 Bug</a>
        <a href="https://github.com/webbrain-one/webbrain/blob/main/LICENSE" target="_blank" rel="noopener">GPL-3.0 许可</a>
        <a href="https://pressreleases.online/org/webbrain.one" target="_blank" rel="noopener">媒体</a>
        <a href="https://api.webbrain.one/account" target="_blank" rel="noopener">Compass 订阅</a>
      </div>
      <div class="wb-footer-social">
        <a href="https://mastoturk.org/@webbrain" target="_blank" rel="me noopener" aria-label="Mastodon 上的 WebBrain" title="Mastodon 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M21.327 8.566c0-5.035-3.298-6.511-3.298-6.511C16.366 1.292 13.508.971 12.04.947h-.036c-1.468.024-4.326.345-5.989 1.108 0 0-3.298 1.476-3.298 6.511 0 1.153-.022 2.535.014 4.001.12 4.935.907 9.799 5.478 11.007 2.106.557 3.916.674 5.374.594 2.645-.147 4.128-.943 4.128-.943l-.087-1.918s-1.888.595-4.012.523c-2.104-.072-4.326-.227-4.668-2.809a5.289 5.289 0 0 1-.047-.724s2.066.505 4.686.625c1.603.073 3.107-.094 4.632-.276 2.925-.349 5.474-2.149 5.794-3.793.503-2.591.462-6.287.462-6.287ZM8.545 15.023H6.09V8.996c0-2.534 1.627-3.829 3.424-3.829 1.963 0 2.909 1.268 3.35 2.257.44-.989 1.386-2.257 3.349-2.257 1.797 0 3.424 1.295 3.424 3.829v6.027h-2.454V9.174c0-1.233-.519-1.859-1.557-1.859-1.148 0-1.724.742-1.724 2.207v3.203h-2.454V9.522c0-1.465-.576-2.207-1.724-2.207-1.038 0-1.557.626-1.557 1.859v5.849Z"/></svg></a>
        <a href="https://bsky.app/profile/webbrain-one.bsky.social" target="_blank" rel="me noopener" aria-label="Bluesky 上的 WebBrain" title="Bluesky 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12 10.8c-1.1-2.1-4-6-6.8-8C2.6.9 1.6 1.3.9 1.6.1 1.9 0 3.1 0 3.8c0 .7.4 5.7.6 6.5.8 2.7 3.7 3.7 5.6 3.4-3.5.6-6.5 2-2.5 6.5 4.3 4.5 5.9-1 6.3-2.8.1-.5.2-.8.3-.8.1 0 .2.3.3.8.4 1.8 2 7.3 6.3 2.8 4-4.5 1-5.9-2.5-6.5 1.9.3 4.8-.7 5.6-3.4.2-.8.6-5.8.6-6.5 0-.7-.1-1.9-.9-2.2-.7-.3-1.7-.6-4.3 1.2-2.8 2-5.7 5.9-6.8 8Z"/></svg></a>
        <a href="https://discord.gg/cgC325ssfw" target="_blank" rel="noopener" aria-label="Discord 上的 WebBrain" title="Discord 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 16 16" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M13.545 2.907a13.227 13.227 0 0 0-3.257-1.011c.05.069.098.137.142.207a12.471 12.471 0 0 0-3.616 0c.044-.07.093-.138.143-.207A13.207 13.207 0 0 0 3.7 2.907 13.136 13.136 0 0 0 .931 13.362a13.667 13.667 0 0 0 4.022 2.018c.33-.442.623-.907.87-1.396a8.95 8.95 0 0 1-1.37-.652c.114-.083.225-.171.33-.269a9.6 9.6 0 0 0 8.243 0c.108.09.218.18.33.269a8.923 8.923 0 0 1-1.37.652c.248.489.54.954.87 1.396a13.667 13.667 0 0 0 4.022-2.018 13.136 13.136 0 0 0-2.769-10.455zM5.106 11.275c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608zm5.788 0c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608z"/></svg></a>
        <a href="https://huggingface.co/webbrain-one" target="_blank" rel="me noopener" aria-label="Hugging Face 上的 WebBrain" title="Hugging Face 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624"/></svg></a>
      </div>
    </div>
  </div>
</footer>
<!-- Site footer: end -->

  <script>
    (function () {
      const root = document.documentElement;
      const themeButton = document.querySelector('[data-theme-toggle]');
      const sidebarButton = document.querySelector('[data-sidebar-toggle]');
      const languageSelect = document.querySelector('[data-faq-language]');
      const languageRoutes = Object.freeze({"en":"/docs/faq/","es":"/docs/es/faq/","fr":"/docs/fr/faq/","tr":"/docs/tr/faq/","zh":"/docs/zh/faq/","ru":"/docs/ru/faq/","uk":"/docs/uk/faq/","ar":"/docs/ar/faq/","ja":"/docs/ja/faq/","ko":"/docs/ko/faq/","id":"/docs/id/faq/","th":"/docs/th/faq/","ms":"/docs/ms/faq/","tl":"/docs/tl/faq/","he":"/docs/he/faq/","hi":"/docs/hi/faq/","pt":"/docs/pt/faq/","vi":"/docs/vi/faq/","bn":"/docs/bn/faq/","fa":"/docs/fa/faq/","nl":"/docs/nl/faq/","de":"/docs/de/faq/"});
      const searchInput = document.querySelector('[data-faq-search]');
      const emptyState = document.querySelector('[data-faq-empty]');
      const topics = Array.from(document.querySelectorAll('[data-faq-topic]'));

      function setTheme(theme, persist) {
        root.dataset.theme = theme;
        themeButton.textContent = theme === 'dark' ? '☀' : '☾';
        if (persist) try { localStorage.setItem('webbrain-theme', theme); } catch (_) {}
      }
      setTheme(root.dataset.theme === 'light' ? 'light' : 'dark', false);
      themeButton.addEventListener('click', function () {
        setTheme(root.dataset.theme === 'light' ? 'dark' : 'light', true);
      });

      languageSelect.addEventListener('change', function () {
        const route = languageRoutes[languageSelect.value];
        if (route) window.location.assign(route);
      });

      sidebarButton.addEventListener('click', function () {
        const open = document.body.classList.toggle('sidebar-open');
        sidebarButton.setAttribute('aria-expanded', String(open));
      });
      document.querySelectorAll('.docs-sidebar a').forEach(function (link) {
        link.addEventListener('click', function () {
          document.body.classList.remove('sidebar-open');
          sidebarButton.setAttribute('aria-expanded', 'false');
        });
      });

      function normalize(value) {
        return String(value || '').normalize('NFKD').replace(/[\u0300-\u036f]/g, '').toLocaleLowerCase().replace(/\s+/g, ' ').trim();
      }
      function filterFaq() {
        const query = normalize(searchInput.value);
        let totalVisible = 0;
        topics.forEach(function (topic) {
          let topicVisible = 0;
          topic.querySelectorAll('[data-faq-item]').forEach(function (item) {
            const match = !query || normalize(item.textContent).includes(query);
            item.hidden = !match;
            if (match) topicVisible += 1;
          });
          topic.hidden = topicVisible === 0;
          const count = topic.querySelector('.faq-topic-header > span');
          count.textContent = String(topicVisible);
          totalVisible += topicVisible;
        });
        emptyState.hidden = !query || totalVisible > 0;
      }
      searchInput.addEventListener('input', filterFaq);
      searchInput.addEventListener('keydown', function (event) {
        if (event.key === 'Escape' && searchInput.value) {
          searchInput.value = '';
          filterFaq();
        }
      });
      document.addEventListener('keydown', function (event) {
        const target = event.target;
        const typing = target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target?.isContentEditable;
        if (event.key === '/' && !typing && !event.metaKey && !event.ctrlKey && !event.altKey) {
          event.preventDefault();
          searchInput.focus();
        }
      });

      function openHashTarget() {
        if (!window.location.hash) return;
        const target = document.getElementById(decodeURIComponent(window.location.hash.slice(1)));
        if (target && target.matches('details')) target.open = true;
      }
      window.addEventListener('hashchange', openHashTarget);
      openHashTarget();
    })();
  </script>
</body>
</html>