Browser Harness 赋予 LLM 浏览器自由度

将 LLM 通过一个轻量、可编辑的 CDP harness，直接连接到你的真实浏览器。适用于需要完全自由操作的浏览器任务。

只需一条连接 Chrome 的 websocket，中间没有任何抽象层。Agent 会在执行过程中补写缺失的功能。harness 每运行一次，都会自我改进。

你可以在 Browser Use Cloud 中试用 browser-harness，也可以将安装 prompt 粘贴到你的 coding agent 中。

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

你再也不需要亲自操作浏览器了。

将以下内容粘贴到 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.

Agent 会打开 chrome://inspect/#remote-debugging。勾选复选框，让 Agent 能够连接到你的浏览器：

当每次连接时弹出确认窗口，请点击 Allow（Chrome 144+）：

示例任务请参阅 agent-workspace/domain-skills/。

免费的 Browser Use Cloud 浏览器

支持隐身、sub-agents 或 headless 部署。Browser Use Cloud 免费套餐提供：3 个并发浏览器、代理、验证码处理等功能。无需绑定银行卡。

在 cloud.browser-use.com/new-api-key 获取一个 key。

或者，让 Agent 根据 docs.browser-use.com/llms.txt 自行注册（其中包含完整的安装流程和挑战上下文）。

架构（4 个核心文件，共约 1,000 行）

install.md——首次安装与浏览器初始化

SKILL.md——日常使用说明

src/browser_harness/——受保护的核心 package

${XDG_CONFIG_HOME:-~/.config}/browser-harness/agent-workspace/agent_helpers.py——由 Agent 编辑的 helper 代码

${XDG_CONFIG_HOME:-~/.config}/browser-harness/agent-workspace/domain-skills/——由 Agent 编辑、可复用的站点专属 skills

普通的 browser-harness helper 调用会连接到正在运行的 Chrome/Chromium CDP endpoint。如果需要隔离的自动化环境，可以自行使用 --remote-debugging-port 启动 Chrome，并传入 BU_CDP_URL；也可以使用 Browser Use cloud browser。

从代码 checkout 运行时，可以使用 ./browser-harness 执行当前 working tree，无需激活 virtualenv，也不依赖全局安装的命令：

./browser-harness <<'PY'
print(page_info())
PY

面向 Agent 的常规文档应继续使用 browser-harness；./browser-harness launcher 仅用于本地 repo 测试。

欢迎提交 PR 和改进。最好的参与方式是：针对你经常使用的网站或任务，在 agent-workspace/domain-skills/ 下贡献新的 domain skill，例如 LinkedIn 外联、在 Amazon 下单、提交费用报销等。每个 skill 都会教会 Agent 相关的 selector、操作流程和 edge case，避免它每次都重新摸索。

Skills 由 harness 编写，而不是由你编写。你只需让 Agent 执行任务——当它摸索出某个不明显的操作方式时，就会自行记录为 skill（参阅 SKILL.md）。请不要手动编写 skill 文件；由 Agent 生成的内容，才能反映浏览器中真正有效的操作方式。

将生成的 domain-skills/<site>/ 文件夹复制到本 repo 的 agent-workspace/domain-skills/ 示例目录中，然后提交 PR——内容小而专注就很好。

同样欢迎 bug 修复、文档调整和 helper 改进。

浏览现有 skills（github/、linkedin/、amazon/……），了解它们的组织形式。

如果不确定该从哪里开始，可以创建一个 issue，我们会帮你找到一个有价值的切入点。

设置 BH_DOMAIN_SKILLS=1，即可启用 Agent workspace 中的 domain skills。本 repo 的 agent-workspace/domain-skills/ 目录包含可通过 PR 贡献的示例。

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