webbrain-one/webbrain

项目介绍

WebBrain 是面向 Chrome、Firefox 和 Edge 的浏览器扩展，在标签页旁的侧边栏中提供 AI 智能体。它通过无障碍树读取当前页面，可回答问题，也能在获得许可后点击、输入、滚动、跳转、上传、下载和填写表单。适合希望就地查询页面内容，或把重复性浏览操作交给智能体、同时继续使用已登录浏览器会话的人。

模型可以替换。默认的 WebBrain Compass 1.0 无需 API Key；本地模型通过 OpenAI 兼容接口接入 llama.cpp、Ollama、vLLM、LM Studio、Jan 等服务器；Providers 页面还提供大量云服务商选项。

安装与首次使用

1. 从 Chrome 应用商店、Firefox 附加组件 或 Edge 加载项 安装。若从源码加载，先克隆仓库；Chrome 打开 chrome://extensions/，启用开发者模式，点击 Load unpacked，选择 src/chrome，执行 npm run build:chrome 后可改为加载 build/chrome。Firefox 通过 about:debugging#/runtime/this-firefox 加载 manifest，临时附加组件在浏览器重启后失效。
2. 点击 WebBrain 图标打开侧边栏，发送「Summarize this page」这类消息即可使用只读的 Ask 模式。
3. 要让智能体操作页面，用 /act 切换到 Act，或发送明确要求执行浏览操作的消息；有后果的操作会触发按站点权限提示。Dev 模式额外开放源码、样式、控制台和网络访问，供开发排查使用。
4. 使用本地模型时，先启动 OpenAI 兼容服务器（例如 ollama serve 监听 11434 端口）并选择对应提供商；也可以使用 WebBrain Companion 桌面应用，本地地址默认为 http://127.0.0.1:8327/v1。具体配置见 提供商与模型文档。

模式与工具

文档把 tier（compact、mid、full）和 mode（ask、act、dev）分开：tier 决定模型能看到多少工具，mode 决定用户允许它做什么。Compact 面向小型本地模型，Full 解锁悬停、拖放、frame 和 shadow DOM。Vision 模式让支持图像输入的模型依据截图和坐标操作；Act 和 Dev 可在执行工具前生成计划供用户批准。完整工具矩阵见 agent tools。

斜杠命令覆盖定时任务（/schedule）、页面监控（/watch）、保存工作流、记忆、截图、录制和上下文压缩。在面板输入 /help 可查看全部签名和参数，详细规则见 斜杠命令参考。

使用约束

Firefox 版本明确弱于 Chrome：由于没有 Chrome DevTools Protocol，Firefox 构建不支持穿透 shadow DOM、受信任鼠标事件、封闭 shadow root 遍历和 CDP 截图，部分单页应用导航处理也受限，一些 React 或 Vue 事件处理器可能不触发。本地模型需要足够的上下文窗口来容纳提示词、工具模式、页面内容和历史记录；16k 只是配置回退值，不是保证的最低值。

对于本地和自带提供商，Share queries for research 默认关闭。开启后，会针对该提供商分享有界的、不含页面内容的诊断时间线，以及经过清理的提示词和响应数据；关闭该开关会清除排队中的诊断记录。权限与数据边界见 安全模型 和 隐私与数据流。项目采用 GPL-3.0-or-later，因为分发的扩展打包了 GPL 授权的 Xapian/libzim WebAssembly 运行时。

相关组件

独立的 MCP 服务器（@webbrain/mcp-server）可让 Claude Code、Codex、Cursor、OpenClaw 等编程智能体把任务委托给用户已登录的浏览器会话。它只暴露任务级工具，而非底层浏览器原语，以保证权限检查留在智能体循环中。LM Studio 插件（webbrain/web-tools）同样提供委托能力，并提供不依赖浏览器的纯 HTTP 工具。扩展一次只保留一个桥接连接，因此 WebBrain Cloud、MCP 服务器和 LM Studio 插件需要在 Settings → Bridge 中切换。

HotRepo 点评

WebBrain 在 2026-11-03 的 JavaScript 日榜上记录到第 3 名，当天新增 26 Star，但没有已知的全语言日榜名次。这只是单次快照，只能说明它在当天的 JavaScript 榜上排名靠前，不能据此判断趋势。对读者更有参考价值的是较广的提供商矩阵，以及项目明确说明的 Chrome 与 Firefox 能力差距；这两点都不能当作采用率或可靠性的证据。