Browser Harness ♞
通过轻量 CDP 桥接将 LLM 直接连接到真实浏览器，在浏览器任务中实现完全自由，并具备自适应学习能力。
- Star 数
- ★ 18k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 46/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 开发者在真实 Chrome 中自动化上传文件、填写表单等复杂网页操作，并让代理自动编写缺失的辅助代码。
- 不适合
- 不愿让自主 agent 操作个人浏览器与登录账号的用户
- 需要详细人工文档、不依赖编码 agent 的使用者
这个 Agent 能做什么，适合哪些场景？
Browser Harness 是一个自愈式工具，通过 Chrome DevTools Protocol (CDP) 让 LLM 直接与你的真实浏览器交互。其核心架构精简（约 1000 行代码，4 个核心文件），包含安装文档、使用技能 (SKILL.md)、受保护的核心包，以及代理可编辑的辅助代码和领域技能工作区。连接方式为一个 websocket 到 Chrome 的 CDP 端点。代理在执行过程中会自行编写缺失的辅助函数和技能，实现自我改进。支持通过环境变量 BU_CDP_URL 或 Browser Use Cloud 浏览器进行隔离自动化。该工具面向需要浏览器完全自由度的场景，如文件上传、站点特定操作等。
该存储库提供 browser-harness 命令行工具，代理可调用它来附加到运行中的 Chrome/Chromium CDP 端点并执行浏览器操作。端到端流程：用户将设置提示粘贴到 Claude Code 或 Codex 中，代理安装/升级 harness，注册技能，连接到浏览器，并执行任务。在任务执行过程中，代理若发现缺少辅助函数或技能，会在 agent-workspace/ 中编写并保存这些代码（例如 agent_helpers.py 和 domain-skills/ 下的站点特定技能）。核心组件包括 install.md、SKILL.md、src/browser_harness/ 以及代理工作区。支持本地录制开关（默认关闭，保留偏好）。代理可通过 chrome://inspect/#remote-debugging 进行连接。
- 开发者在真实 Chrome 中自动化上传文件、填写表单等复杂网页操作，并让代理自动编写缺失的辅助代码。
- 运营人员通过代理自主完成 LinkedIn 外联、在 Amazon 下单或提交费用等重复性站点特定任务，代理会生成领域技能。
- 测试人员利用基于 CDP 的隔离自动化（通过 BU_CDP_URL 或 Browser Use Cloud）进行无头部署或隐身自动化。
- 使用 Claude Code 或 Codex 的用户，通过粘贴设置提示即可快速配置并开始使用，无需手动操作。
- 需要支持子代理或隐身功能的用户，可结合 Browser Use Cloud 的免费层使用（3 个并发浏览器、代理、验证码解决）。
如何安装或部署这个 Agent？
将设置提示粘贴到 Claude Code 或 Codex 中："Install or upgrade browser-harness to the latest stable version with uv using Python 3.12, register the skill from browser-harness skill, and connect it to my browser. Ask whether I want local browser recordings enabled; default to no and preserve my existing preference on upgrades. Follow https://github.com/browser-use/browser-harness/blob/main/install.md if setup or connection fails." 代理将打开 chrome://inspect/#remote-debugging，勾选允许远程调试的复选框，并点击允许弹出的附加权限。若手动安装，则需要 Python 3.12 和 uv。
如何使用这个 Agent？
安装后，代理通过调用 browser-harness 命令与浏览器交互。例如，可在交互式会话中运行类似 browser-harness 的 Python 代码，例如 print(page_info())。对于开发者测试，可使用 ./browser-harness 启动器从本地工作目录运行。可通过设置 BU_CDP_URL 指向自定义 CDP 端点，或使用 Browser Use Cloud 浏览器进行隔离自动化。启用领域技能可设置 BH_DOMAIN_SKILLS=1。
这个 Agent 有哪些优点和局限？
- 自适应设计：代理会在执行过程中编写缺失的辅助函数和领域技能，无需手动维护。
- 完全自由的浏览器控制：通过 CDP 直接连接真实浏览器，不受传统自动化框架限制。
- 轻量架构：约 1000 行代码，核心文件精简，降低维护和审查成本。
- 支持隔离自动化：支持通过 BU_CDP_URL 或 Browser Use Cloud 进行无头或隐身部署。
- 依赖特定环境：要求 Chrome/Chromium 启用远程调试，且设置依赖 Python 3.12 和 uv。
- 需要代理能力：主要面向 Claude Code 或 Codex 等高级编码代理，普通用户可能需手动操作。
- 安全风险：将不受控制的代理连接到真实浏览器可能带来风险，需用户信任代理行为。
- 文档有限：安装和连接步骤主要由设置提示驱动，缺少详细的手动安装指南，需参考 install.md。
这个 Agent 与同类方案有什么区别？
与 Browser Use Cloud 的浏览器集成，但作为一个独立的开源 harness，可连接到本地或云端浏览器。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Browser Harness ♞ 当前 | 46 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 18k | 1 天前 | Python | Codex · Claude Code |
| browser-control | 72 · 存在缺口 | 命令行工具免费 | ★ 3.2k | 1 个月前 | Rust | — |
| bdg 浏览器调试 CLI | 68 · 存在缺口 | 命令行工具免费 | ★ 177 | 今天 | TypeScript | Codex · Claude Code |
| Chrome CDP 技能 | 48 · 缺口较多 | Agent 插件 / 技能免费 | ★ 3.3k | 3 个月前 | JavaScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：项目通过CDP连接浏览器，需要用户手动开启远程调试并允许连接，这体现了用户确认机制。但权限最小化方面，代码未明确限制代理的权限范围，且依赖固定版本，存在供应链风险。数据流透明度不足，未说明数据如何被处理或传输。敏感数据处理未提及。外部影响方面，代理可执行任意浏览器操作，但未提供回滚机制。来源归属方面，发布者未验证，但代码库有明确的版权声明。扣分原因：缺乏权限最小化设计、数据流不透明、无回滚机制。
证据显示：项目结构清晰，核心文件命名一致，依赖版本固定，但未提供失败消息的详细说明。自洽性良好，但依赖可用性未验证。扣分原因：失败消息未详细说明，依赖可用性未验证。
证据显示：项目面向开发者，提供了多种使用场景（本地、云），能力边界通过文档说明，但触发精度不足，环境适配性良好。扣分原因：触发精度不足，环境适配性未充分验证。
证据显示：信息架构清晰，安装说明详细，命名稳定，提供了示例和FAQ，但已知限制未明确，版本变更日志缺失，维护责任未明确。扣分原因：已知限制未明确，版本变更日志缺失，维护责任未明确。
证据显示：输出可用性良好，边际价值高，但成本效益未充分说明。扣分原因：成本效益未充分说明。
证据显示：声明可追溯性不足，跨来源验证不足，事实与推断分离不足。扣分原因：声明可追溯性不足，跨来源验证不足，事实与推断分离不足。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者身份未验证，需谨慎对待。
- 依赖版本固定，需关注供应链安全。
- 代理可执行任意浏览器操作，需确保用户确认机制有效。
- 无回滚机制，操作失败可能无法恢复。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
What changed - Pin the MCP extra to mcp 2.1.1. - Pin release build tooling to build 1.6.0 and setuptools 84.0.0. - Preserve the Chrome permission and macOS accessibility reliability improvements from 0.1.12. Verification - 251 unit tests passed with the MCP extra. - pip-audit found no known vulnerabilities in the resolved environment. - Wheel and source distribution built successfully.在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * fix: discover Brave Origin profiles on macOS by @MagMueller in https://github.com/browser-use/browser-harness/pull/728 * Keep one Chrome approval pending per daemon by @MagMueller in https://github.com/browser-use/browser-harness/pull/737 * Bump browser-harness to 0.1.12 by @MagMueller in https://github.com/browser-use/browser-harness/pull/740 Full Changelog: https://github.com/browser-use/browser-harness/compare/v0.1.11...v0.1.12在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * fix: clean up unused browser recovery launch by @MagMueller in https://github.com/browser-use/browser-harness/pull/657 * docs: retry hidden-tab scrolling after activation by @MagMueller in https://github.com/browser-use/browser-harness/pull/658 * docs: prevent duplicate tabs across harness calls by @gregpr07 in https://github.com/browser-use/browser-harness/pull/665 * Add MCP server wrapper over browser-harness helpers by @cckyros in https://github.com/browser-use/browser-harness/pull/601 …在 GitHub 查看 ↗