Browser Harness ♞
通过轻量 CDP 桥接将 LLM 直接连接到真实浏览器，在浏览器任务中实现完全自由，并具备自适应学习能力。
证据显示：项目通过CDP连接浏览器，需要用户手动开启远程调试并允许连接，这体现了用户确认机制。但权限最小化方面，代码未明确限制代理的权限范围，且依赖固定版本，存在供应链风险。数据流透明度不足，未说明数据如何被处理或传输。敏感数据处理未提及。外部影响方面，代理可执行任意浏览器操作，但未提供回滚机制。来源归属方面，发布者未验证，但代码库有明确的版权声明。扣分原因：缺乏权限最小化设计、数据流不透明、无回滚机制。
证据显示：项目结构清晰，核心文件命名一致，依赖版本固定，但未提供失败消息的详细说明。自洽性良好，但依赖可用性未验证。扣分原因：失败消息未详细说明，依赖可用性未验证。
证据显示：项目面向开发者，提供了多种使用场景（本地、云），能力边界通过文档说明，但触发精度不足，环境适配性良好。扣分原因：触发精度不足，环境适配性未充分验证。
证据显示：信息架构清晰，安装说明详细，命名稳定，提供了示例和FAQ，但已知限制未明确，版本变更日志缺失，维护责任未明确。扣分原因：已知限制未明确，版本变更日志缺失，维护责任未明确。
证据显示：输出可用性良好，边际价值高，但成本效益未充分说明。扣分原因：成本效益未充分说明。
证据显示：声明可追溯性不足，跨来源验证不足，事实与推断分离不足。扣分原因：声明可追溯性不足，跨来源验证不足，事实与推断分离不足。
- 发布者身份未验证，需谨慎对待。
- 依赖版本固定，需关注供应链安全。
- 代理可执行任意浏览器操作，需确保用户确认机制有效。
- 无回滚机制，操作失败可能无法恢复。
这个 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 有哪些优点和局限？
- 自适应设计：代理会在执行过程中编写缺失的辅助函数和领域技能，无需手动维护。
- 完全自由的浏览器控制：通过 CDP 直接连接真实浏览器，不受传统自动化框架限制。
- 轻量架构：约 1000 行代码，核心文件精简，降低维护和审查成本。
- 支持隔离自动化：支持通过 BU_CDP_URL 或 Browser Use Cloud 进行无头或隐身部署。
- 依赖特定环境：要求 Chrome/Chromium 启用远程调试，且设置依赖 Python 3.12 和 uv。
- 需要代理能力：主要面向 Claude Code 或 Codex 等高级编码代理，普通用户可能需手动操作。
- 安全风险：将不受控制的代理连接到真实浏览器可能带来风险，需用户信任代理行为。
- 文档有限：安装和连接步骤主要由设置提示驱动，缺少详细的手动安装指南，需参考 install.md。
如何安装或部署这个 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 与同类方案有什么区别？
与 Browser Use Cloud 的浏览器集成，但作为一个独立的开源 harness，可连接到本地或云端浏览器。