Browser Harness ♞

通过轻量级、可编辑的 CDP Harness 将 LLM 直接连接到你的真实浏览器。适用于你需要完全自由度的浏览器任务。

仅需一个连接 Chrome 的 WebSocket，中间无任何拦截。Agent 会在执行过程中自行编写缺失的代码，Harness 会在每次运行后自我优化。

  ● agent: wants to upload a file
  │
  ● agent-workspace/agent_helpers.py → helper missing
  │
  ● agent writes it                         agent_helpers.py
  │                                                       + custom helper
  ✓ file uploaded

你再也不需要手动操作浏览器了。

设置 Prompt

将其粘贴到 Claude Code 或 Codex 中：

Set up https://github.com/browser-use/browser-harness for me.

Read `install.md` and follow the steps to install browser-harness and connect it to my browser.

Agent 将会打开 chrome://inspect/#remote-debugging。请勾选复选框，以便 Agent 连接到你的浏览器：

（此处应有截图）

当出现附加弹窗（Chrome 144+）时，点击“允许（Allow）”：

（此处应有截图）

查看 agent-workspace/domain-skills/ 获取任务示例。

免费 Browser Use 云浏览器

支持 Stealth 模式、子 Agent 或无头（headless）部署。 Browser Use Cloud 免费套餐：包含 3 个并发浏览器、代理、验证码识别等功能。无需信用卡。

• 在 cloud.browser-use.com/new-api-key 获取密钥。
• 或者让 Agent 通过 docs.browser-use.com/llms.txt 自行注册（包含设置流程和挑战上下文）。

架构（4 个核心文件共约 1k 行代码）

• install.md — 初次安装和浏览器引导
• SKILL.md — 日常使用指南
• src/browser_harness/ — 受保护的核心包
• agent-workspace/agent_helpers.py — Agent 可自行编辑的辅助代码
• agent-workspace/domain-skills/ — Agent 可编辑的可重用站点特定技能

贡献指南

欢迎提交 PR 和改进建议。最好的贡献方式是：为 agent-workspace/domain-skills/ 贡献一个新的领域技能（domain skill），用于你经常使用的网站或任务（如 LinkedIn 推广、在 Amazon 下单、报销填单等）。每一项技能都能教会 Agent 那些它本来需要反复探索才能掌握的选择器、流程和边界情况。

• 技能是由 Harness 编写的，而不是你。 只需让 Agent 运行你的任务 —— 当它弄清楚某些非显而易见的操作时，它会自动归档该技能（参见 SKILL.md）。请勿手动编写技能文件；Agent 生成的文件更能反映浏览器中实际可行的操作。
• 提交一个包含生成的 agent-workspace/domain-skills// 文件夹的 PR —— 小巧且专注的贡献非常受欢迎。
• 同样欢迎 Bug 修复、文档优化和辅助代码改进。
• 浏览现有技能（github/、linkedin/、amazon/ 等）以了解其结构。

如果你不确定从哪里开始，请提交一个 Issue，我们会为你指明方向。

领域技能 (Domain skills)

设置 BH_DOMAIN_SKILLS=1 以启用 agent-workspace/domain-skills/ —— 这是由社区贡献的针对特定网站的剧本（playbooks），goto_url 会根据域名显示相关操作。请通过 PR 进行贡献。

---

Agent Harness 的苦涩教训 · 真正能够学习的 Web Agent