browser-harness

网页上的重复操作，交给 AI 照着做就行

自愈式浏览器工具框架：能够自我修复、稳定运行，让 LLM 通过浏览器自动完成任意任务，为智能体提供可靠的网页操作能力。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 18024

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队browser-use

所属国家

官网地址https://browser-harness.com

GitHubhttps://github.com/browser-use/browser-harness

定价模式free

价格说明MIT开源项目，全部功能免费，可自行部署使用，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai-agent,browser-agent,browser-automation,browser-use,browser-use-box,browser-use-cloud,cdp,cloud-browser,llm,persistent-browser,playwright,telegram-agent,vps-agent,web-automation

GitHub 星标★ 18024

30天Star增速

HF 下载量

上线时间2026-04-17 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 3.12（README 中明确要求用 uv 配合 Python 3.12 安装）
uv 包管理工具（README 用它安装或升级 browser-harness）
一个编码智能体：Claude Code 或 Codex
本地 Chrome 浏览器（需允许远程调试连接）

安装与启动步骤

1准备环境

README 要求用 uv 以 Python 3.12 安装，请先自行准备好 uv 与 Python 3.12 环境；README 未给出具体安装命令，按 uv 官方方式准备即可。

2粘贴安装提示词

把 README 给出的 setup prompt 原样粘贴到 Claude Code 或 Codex，由智能体完成安装、注册 skill 并连接浏览器。

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.

3允许远程调试

智能体会自动打开 chrome://inspect/#remote-debugging，首次设置时必须勾选该复选框，agent 才能连上你的浏览器。
4选择本地录制

过程中智能体会询问是否开启本地浏览器录制，README 默认选否，并在后续升级时保留你已有的偏好。
5云端替代方案

不想用本地浏览器时，可直接在 Browser Use Cloud 中试用 browser-harness，无需自己连接浏览器。

关键配置

配置项	必填	说明	示例
`Python 版本`	是	browser-harness 安装所需的 Python 运行版本	`3.12`
`local browser recordings`	否	是否开启本地浏览器录制，默认关闭且升级时保留原偏好	`no`

如何确认成功

智能体成功连上你的浏览器并能代为执行网页任务，即表示安装与连接成功。

常见问题

Q：安装或连接失败怎么办？

A：按 setup prompt 的最后一句，参照仓库 install.md 文档排查：https://github.com/browser-use/browser-harness/blob/main/install.md

Q：智能体连不上我的浏览器？

A：确认已打开 chrome://inspect/#remote-debugging 并勾选其中的复选框，首次设置必须手动勾选一次。

Q：支持哪些编码智能体？

A：README 给出的 setup prompt 是给 Claude Code 或 Codex 使用的，粘贴到这两者之一即可。

Q：需要自己写浏览器操作代码吗？

A：不需要，agent 会在缺少 helper 时自己写入 agent_helpers.py，harness 随任务自愈改进。

Q：可以不用本地浏览器吗？

A：可以，README 提供 Browser Use Cloud 的在线试用方式，也可通过 cdp websocket 连接云浏览器。

注意事项

本教程只依据 README 节选整理，README 未给出可直接执行的安装命令，具体命令请以仓库 install.md 为准。
setup prompt 需粘贴到编码智能体内执行，不要当作 shell 命令直接运行。
首次连接必须手动勾选 chrome://inspect/#remote-debugging 中的复选框。
本地浏览器录制默认关闭，升级时请保留用户已有偏好设置。

核心亮点

基于CDP协议实现浏览器深度控制，支持持久化会话，让LLM在长任务中保持上下文连续，显著提升复杂任务完成率
自修复机制自动处理页面元素变化和导航异常，减少人工干预，适合动态网页环境
提供云浏览器集成，可扩展至大规模并行任务，且与browser-use生态兼容，上手成本低

不足之处

文档/社区待观察：自修复逻辑在极端复杂页面下的鲁棒性缺乏公开基准验证
依赖CDP协议，对非Chromium内核浏览器支持有限，可能限制部分使用场景

适用场景

自动化Web测试与回归验证，利用LLM理解业务逻辑并执行端到端操作
数据采集与信息抽取，处理需登录、分页或动态渲染的网站
智能体驱动的RPA流程，如表单填写、报表生成等重复性办公任务

替代项目

browser-use、Playwright MCP、Skyvern

项目介绍

browser-harness 是自动化工作流领域的开源项目，由 browser-use 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（18,024）位列前 3%，在自动化工作流分类的 509 个项目里位列前 7%。

近 41 天，它的 GitHub 星标从 16,666 增加到 18,024，净增 1,358。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。MIT开源项目，全部功能免费，可自行部署使用，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：自动化Web测试与回归验证，利用LLM理解业务逻辑并执行端到端操作。同类可对比的替代方案包括 browser-use、Playwright MCP、Skyvern。

上一篇：nocobase

下一篇：WorkBuddy-Guide