先看懂：EasyBR、扩展、Bridge、Skill
一句话理解：EasyBR 管理多开环境，Easy WebBridge 连接指定环境，业务 Skill 负责具体工作。
- EasyBR：创建和管理独立浏览器环境，每个环境有自己的 Cookie、Local Storage、代理和浏览器参数。
- Easy WebBridge 扩展：运行在目标 Chromium 浏览器中，负责把浏览器连接到本机 Bridge。EasyBR 1.7.8 及以后已内置，启动环境时自动加载；其他浏览器需手动安装。
- Easy WebBridge Bridge：运行在本机
127.0.0.1:17777的服务，接收 Agent 命令并转发给指定浏览器。 - 业务 Skill：例如抖音搜索、App Store Connect、Google Play Console 等独立仓库，通过 Bridge 调用浏览器。
原有的 EasyBR 产品介绍仍在《EasyBR 浏览器介绍》；本文只讲 Easy WebBridge 这套连接和使用方法。
官方入口
- EasyBR 官网：https://www.ebrower.com/
- EasyBR 下载页（Windows 与 Apple 芯片 Mac）：https://www.ebrower.com/down.html
- GitHub 下载镜像：EasyBR 1.7.8 Release
- 本文支持网址：https://www.ebrower.com/helperdoc/easy-webbridge.html
- GitHub 仓库：https://github.com/xxjrq/easy-webbridge
- 扩展源码：https://github.com/xxjrq/easy-webbridge/tree/main/extension
你从 GitHub 下载仓库、按上面的步骤加载 extension/ 文件夹后，打开扩展详情，点击“网站”或“支持”，就能回到这篇教程。GitHub README 里也放了这个入口，找不到扩展设置时直接从 README 进入即可。
Easy WebBridge 能做什么
连接成功后，AI Agent 可以在用户指定的浏览器环境中：
- 打开、查找、切换和关闭标签页，并按任务标签分组，减少重复页面。
- 读取真实页面文本、语义结构和当前状态。
- 点击、填写、滚动、执行受控脚本，以及截取页面或元素截图。
- 上传本地文件、下载文件、读取 Cookie、导出 PDF。
- 观察网络请求、检查响应和使用受控 CDP 命令。
- 在内容后台、CMS、CRM、App Store Connect、Google Play Console 等已登录页面中辅助检查、填写和上传。
它不是绕过平台规则的工具。验证码、二次登录、最终发布、付款、发送和删除等动作仍由用户掌握。
推荐方式：直接使用 EasyBR
在 macOS（Apple 芯片）或 Windows 上，从 EasyBR 下载页选择对应安装包并打开浏览器。EasyBR 已内置 Easy WebBridge 服务和浏览器扩展；打开 EasyBR、启动目标浏览器环境后，AI Agent 就可以按 browserId 连接，无需单独安装 Easy WebBridge、Node.js 或 Bridge 服务。下载页无法访问时，可从上方 GitHub Release 页面获取对应系统的 EasyBR 1.7.8 包。
版本边界：哪个版本开始内置
| EasyBR 版本 | Easy WebBridge 状态 |
|---|---|
| 1.7.8 及以后 | 内置扩展与 Bridge。启动任意浏览器环境时自动加载扩展，Bridge 随 EasyBR 运行在本机 127.0.0.1:17777，打开浏览器即可被 AI Agent 调用。 |
| 1.7.8 以前（旧版） | 未内置。需要升级 EasyBR，或按下方”源码方式”手动加载扩展并启动 Bridge。 |
| 普通 Chrome / Edge / QQ 浏览器 | 与 EasyBR 无关，仍需按下方”源码方式”手动加载扩展并启动 Bridge。 |
内置后你不需要做任何安装或配置：扩展由 EasyBR 自动注入到每个环境，环境是否可被连接，以 list 命令能否列出它的 browserId 为准。
把这个 Skill 交给 Codex、Claude 或 WorkBuddy 后，可让它先列出浏览器环境名称与 browserId，再选择一个已登录环境处理任务。其他操作系统请使用下方源码方式。
源码方式：安装 Easy WebBridge 扩展
以下步骤适用于其他操作系统、普通 Chrome/Edge/QQ 浏览器，或 EasyBR 1.7.8 以前的旧版本用户。EasyBR 1.7.8 及以后用户无需重复安装，扩展已内置。
配合 EasyBR 使用的扩展名称是 Easy WebBridge，源码在仓库的 extension/ 目录。推荐加载源码目录，步骤如下：
- 打开 GitHub 仓库，下载代码或克隆仓库。
- 在目标浏览器环境中打开
chrome://extensions。 - 打开“开发者模式”，点击“加载未打包的扩展程序”。
- 选择仓库中的
extension/文件夹。 - 每个需要让 Agent 操作的浏览器环境，都加载一次扩展（EasyBR 1.7.8 及以后由客户端自动注入，跳过此步）。
扩展图标、Manifest V3 配置和设置页面都在这个目录中。加载后可以在扩展详情里看到“网站/支持”入口，入口地址为本文。
源码方式：启动 Bridge 并确认 browserId
扩展只连接浏览器，Agent 命令由本机 Bridge 接收。首次使用：
git clone https://github.com/xxjrq/easy-webbridge.git
cd easy-webbridge
npm install
node cli/easy-webbridge.mjs start
node cli/easy-webbridge.mjs status
node cli/easy-webbridge.mjs listlist 会列出在线浏览器的名称和 browserId。后续命令必须指定你确认过的 browserId，不要根据窗口位置猜账号。
给 Agent 的第一条指令可以这样写：
使用 Easy WebBridge 列出已连接浏览器，只告诉我名称、browserId 和在线状态；不要打开、修改或提交页面。确认目标后再布置任务：
使用 browserId=<我确认的环境> 打开指定后台，检查草稿状态并总结缺少的资料；不要发布、发送、付款或删除。完整参数见 HTTP API 与命令参考 和中文完整使用教程。
EasyBR 多开环境的正确用法
- 在 EasyBR 中打开目标环境，先确认环境名称和账号。
- EasyBR 1.7.8 及以后扩展自动加载，无需手动安装；旧版本需先按”源码方式”在该环境加载扩展并确认已连接。
- 用
node cli/easy-webbridge.mjs list获取对应browserId（EasyBR 内置 Bridge 时同样可用该命令，或让 Agent 直接查询）。 - Agent 先做只读检查，再执行明确授权的填写、上传或整理。
- 同一项任务优先复用同一个标签组和当前标签页，避免打开一堆重复窗口。
- 切换账号或环境后，重新列出并确认
browserId。
这种方式适合自媒体后台、视频和封面上传准备、多个店铺后台、广告平台资料整理和开发者后台检查。它的重点是继续使用你选定的真实环境，不是替用户绕过平台规则。
业务 Skill 如何接入
Easy WebBridge 安装一次即可，业务 Skill 各自独立安装和升级：
| Skill | 主要用途 |
|---|---|
| douyin-live-hot-free | 搜索抖音精选内容并整理报告 |
| easy-app-store | 辅助检查 iOS App Store Connect 资料、截图和上传流程 |
| easy-google-play | 辅助检查 Android Google Play Console 版本和上传流程 |
这些仓库互相独立，不依赖作者电脑上的绝对路径，只通过本机 Easy WebBridge 服务协作。
是否需要开机启动
EasyBR 用户：不需要任何启动操作。Bridge 随 EasyBR 客户端自动运行，打开 EasyBR 并在某个环境里加载页面后，该环境的 browserId 就会出现在连接列表中。
源码方式用户：不需要开机启动。任务开始前运行一次 node cli/easy-webbridge.mjs start 即可，重复运行不会启动多个 Bridge。
如果希望电脑登录后 Bridge 一直在线，可自行配置系统登录项：macOS 使用“系统设置 → 通用 → 登录项”，Windows 使用“任务计划程序 → 登录时运行”。扩展本身不能绕过操作系统权限启动 Node.js。
常见问题
会不会重新打开一个浏览器？
不会主动创建干净的自动化窗口。它连接的是已经打开并登录的浏览器环境。
会不会打开很多界面？
默认按任务使用标签组并复用组内页面。只有在并行处理不同 EasyBR 环境时，才需要分别指定多个 browserId。
Codex、Claude、WorkBuddy、OpenCode 都能用吗？
可以。它们只要能读取标准 SKILL.md、运行 Node.js 命令或访问本机 HTTP API，就能接入 Easy WebBridge。
连接不上时先查什么？
确认目标 EasyBR 环境已打开、扩展加载在正确环境，再运行 status 和 list。服务正常但列表为空时，通常是扩展没有加载到目标环境，或需要重新确认 browserId。
Firefox 和 Safari 支持吗？
当前不支持。Easy WebBridge 依赖 Chromium 的 Manifest V3 扩展和 CDP 能力。
相关文档
先试 EasyBR，再决定是否扩团队或做更深的定制项目
标准版适合先验证多账号环境、代理和数据迁移；如果你需要更深的业务能力，我们也支持浏览器外包、Chromium 定制、贴牌浏览器与 Android 指纹浏览器开发。
