Browser Harness

Browser Harness 是一个极其轻量级（核心代码仅约千行）的自愈型浏览器自动化框架。

它不搞长篇大论的封装。它的核心逻辑是一座极薄的桥梁：通过一条持久的 WebSocket 连接，让大模型直接通过 Chrome 开发工具协议（CDP, Chrome DevTools Protocol）去驱动浏览器。

最绝的是它的“自愈（Self-healing）”机制。在传统的框架里，如果一个特定的操作没有写进代码库，AI 就无能为力。但在 Browser Harness 中，如果大模型在执行任务时发现某个特定的辅助函数（helper）缺失或报错，大模型可以直接自己动手写代码、动态修改 agent_helpers.py 脚本来自创工具。工具不够，AI 自己现造，任务完成，工具链随之升级！

Browser Harness 网站截图

Browser Harness核心特色

1. 极致轻量 + 完全自由 核心代码只有约600行Python，基于Chrome DevTools Protocol（CDP）直接连接真实浏览器。一条WebSocket，几乎无中间层。LLM想干什么就干什么，不被框架束缚。
2. Self-Healing 自愈能力 这是最大亮点！当Agent遇到无法处理的操作（如新页面元素、文件上传、验证码流程）时，它可以实时编辑helper代码，自动添加新函数。无需人工干预，真正“自我进化”。
3. 真实浏览器控制 直接操控你本地Chrome（支持远程调试），所见即所得。支持文件上传、复杂交互、弹出窗处理等几乎所有浏览器原生能力。
4. Agent友好设计 专门为Claude Code、Cursor等AI编码Agent设计。你只需给AI一句提示：“帮我安装Browser Harness并连接浏览器”，它就能自己完成设置。
5. 可编辑 + 领域技能积累 支持domain-skills机制，Agent能自动生成并保存特定网站（如LinkedIn、Amazon）的操作技能，重复任务越用越聪明。
6. 开源免费 + 云浏览器支持 MIT协议，完全开源。本地运行隐私安全，也支持Browser Use Cloud（免费阶梯提供隐形浏览器、代理等）。

如何快速部署？（超详细步骤）

推荐方式：让AI自己帮你安装（最简单）

1. 打开Claude Code / Cursor / 任意支持Agent的AI编码工具。
2. 粘贴以下提示：

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.

3. AI会引导你：
   • 打开 chrome://inspect/#remote-debugging
   • 勾选对应目标并允许连接
   • 安装Python依赖等

手动部署方式（推荐开发者）：

1. 克隆仓库：
   text

   git clone https://github.com/browser-use/browser-harness.git
   cd browser-harness

2. 安装依赖（推荐Python 3.11+）：
   text

   pip install -e .

3. 配置环境： 复制 .env.example 为 .env，根据需要填写相关配置。
4. 启动Browser Harness（参考 install.md 和 SKILL.md）。
5. 连接浏览器：
   • 启动Chrome时带上远程调试端口：chrome.exe –remote-debugging-port=9222
   • 或使用已有Chrome实例

部署完成后，你就可以让LLM直接执行浏览器任务了，例如：

• “帮我在Amazon下单这个商品”
• “去LinkedIn给我发10条个性化私信”
• “把这个网页的数据抓下来整理成Excel”

适用人群

• AI Agent开发者
• 自动化工作流爱好者
• 需要批量处理网页操作的用户
• 想让Claude真正“动手”完成复杂任务的玩家

Browser Harness 的哲学是：“把抽象层降到最低，让Agent拥有最大自由度”。它不是另一个笨重的自动化框架，而是一座轻薄高效的“桥梁”，让大模型真正拥有上网做事的能力。