先看懂：EasyBR、扩展、Bridge、Skill
一句话理解：EasyBR 管理多开环境，Easy WebBridge 连接指定环境，业务 Skill 负责具体工作。
- EasyBR：创建和管理独立浏览器环境，每个环境有自己的 Cookie、Local Storage、代理和浏览器参数。
- Easy WebBridge 扩展：安装在目标 Chromium 浏览器中，负责把浏览器连接到本机 Bridge。
- 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/
- 本文支持网址：https://www.ebrower.com/helperdoc/easy-webbridge.html
- GitHub 仓库：https://github.com/xxjrq/easy-webbridge
- 扩展源码：https://github.com/xxjrq/easy-webbridge/tree/main/extension
扩展目录里的 manifest.json 已经填好本文网址（homepage_url 就是扩展详情页里的帮助链接）。你从 GitHub 下载仓库、按上面的步骤加载 extension/ 文件夹后，打开扩展详情，点击“网站”或“支持”，就能回到这篇教程。GitHub README 里也放了这个链接，找不到扩展设置时直接从 README 进入即可。
Easy WebBridge 能做什么
连接成功后，AI Agent 可以在用户指定的浏览器环境中：
- 打开、查找、切换和关闭标签页，并按任务标签分组，减少重复页面。
- 读取真实页面文本、语义结构和当前状态。
- 点击、填写、滚动、执行受控脚本，以及截取页面或元素截图。
- 上传本地文件、下载文件、读取 Cookie、导出 PDF。
- 观察网络请求、检查响应和使用受控 CDP 命令。
- 在内容后台、CMS、CRM、App Store Connect、Google Play Console 等已登录页面中辅助检查、填写和上传。
它不是绕过平台规则的工具。验证码、二次登录、最终发布、付款、发送和删除等动作仍由用户掌握。
安装 Easy WebBridge 扩展
配合 EasyBR 使用的扩展名称是 Easy WebBridge，源码在仓库的 extension/ 目录。推荐加载源码目录，步骤如下：
- 打开 GitHub 仓库，下载代码或克隆仓库。
- 在目标 EasyBR 环境中打开
chrome://extensions。 - 打开“开发者模式”，点击“加载未打包的扩展程序”。
- 选择仓库中的
extension/文件夹。 - 每个需要让 Agent 操作的 EasyBR 多开环境，都加载一次扩展。
扩展图标、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 中打开目标环境，先确认环境名称和账号。
- 在这个环境加载 Easy WebBridge 扩展，并确认已连接。
- 用
node cli/easy-webbridge.mjs list获取对应browserId。 - 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 服务协作。
是否需要开机启动
不需要。任务开始前运行一次 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 指纹浏览器开发。
