前言¶
在构建需要浏览器操作的工作流时，通常需要启动无头浏览器或配置远程调试端口。这往往意味着要重新登录、丢失已安装的扩展，或者反复弹出“允许远程调试”的确认框。BrowserRig 提供了一个本地驱动方案，它不依赖无头浏览器，而是通过 Chrome 扩展与你的现有已登录 Chromium 浏览器建立连接。
这是什么¶
BrowserRig 是一个开源的本地浏览器驱动插件，由 Castor6 维护。它允许智能体（Agent）复用你现有的 Chrome 窗口、Cookies、登录会话和扩展，而无需浏览器范围的远程调试批准。它是一个独立的开源产品，不包含 LLM，也不负责规划决策，仅作为代码层面的执行层。
核心功能¶
- 复用现有会话：复用 Chrome 窗口、Cookies、会话和扩展。
- 无阻塞连接：通过本地中继和扩展连接已登录的 Chrome，不触发浏览器范围的远程调试确认。
- 会话接管：
session adopt --active命令可在一次操作中查找、附加并接管活动标签页。 - 后台工作：
execute命令在同一个浏览器配置文件中创建后台标签页，保持前台工作流不被打断。 - 技能优先驱动：提供 CLI 和 Skill-first 的驱动模式，适配 DeepSeek Harness 等运行时。
安装与启用¶
将插件添加到 DeepSeek Harness 的指定 Profile 中。
dsh plugin --profile web add browserrig
执行安装后，查看生成的配置以确认插件加载成功：
dsh --profile web --dump-config
典型用法¶
安装完成后，通过 CLI 执行 Playwright 脚本。以下命令会导航到示例页面并返回标题与 URL：
browserrig execute 'await page.goto("https://example.com"); return { title: await page.title(), url: page.url() }'
检查插件连接状态和健康检查：
browserrig status
browserrig doctor
适用场景与注意¶
- 适用场景：需要保留登录状态、使用浏览器扩展或需要高频切换浏览器窗口的开发与测试工作流。
- 前置要求：需要安装 Node.js 22.22.0 或更新版本。
- 权限说明：插件以当前 DSH 进程的权限运行。Chrome 可能会在标签页附加时显示标准非阻塞调试信息栏，这是正常现象。
- 核心差异：BrowserRig 不连接 Chrome 的浏览器范围远程调试端点，而是通过扩展 API 传输 CDP 命令。它不包含 LLM 或做出规划决策，仅负责执行代码。
结尾¶
BrowserRig 解决了智能体开发中复用真实浏览器环境的痛点。通过 session adopt --active 和后台标签页机制，它保持了工作流的连贯性。更多细节可参考项目源码。
