仓库：browser-use/browser-harness 维护方：browser-use 项目声明 MIT，Python 工具；以当前仓库为准，不沿用早期“四文件、约千行”的规模描述。
「这是什么」一句话定性
让 Agent 接上真实 Chrome，并把任务中写出的 helper 和站点经验留在工作区，下一次可以复用。它不只是一个固定浏览器动作列表，但“会修改 helper”不等于每运行一次都变得更聪明。
值得学的，是把连接浏览器的核心与可演进的任务代码分开；不是把所有文件都交给 AI 随时重写。
「它怎么转」逻辑全景图
触发层：填表、跨系统操作、授权页面采集、探索性测试
核心层：本地通信 → daemon → Chrome / 可选云浏览器
扩展层：可编辑工作区、helper、领域任务经验
验收层：动作后的页面状态、业务断言、代码 diff 与回归
README已经明确区分受保护的 src/browser_harness/ 与可修改工作区。旧文列出的文件大小、固定四文件架构与随意手写 IPC 请求，不应当作现在的接口契约。
实际_ipc.py采用按行 JSON 通信，POSIX 使用 Unix socket 并设置文件权限，Windows 使用 loopback 与 token。协议字段应读实际客户端/服务端实现，不能把 {method, params, session_id} 或图中另一组字段拼成“官方示例”。
BU_NAME 用于命名空间和实例管理，不自动提供独立账号、Cookie profile 或隐私隔离。
「怎么升级」三段位路线图
入门段（能用）
按安装文档的包安装路径：
uv tool install --python 3.12 --upgrade --force browser-harness
browser-harness skill
browser-harness --doctor
uv tool install -e . 是源码开发路径，必须先有正确 checkout，不是随便在哪个目录都能运行的安装命令。pyproject 当前声明 Python >=3.11，安装指南指定 3.12，两者口径不同。
按指南在 Chrome 的 chrome://inspect/#remote-debugging 设置连接；首次或逐次连接可能需要人工确认。不要把某个 Chrome 版本号、默认 profile 的历史行为写成所有系统都一致的前提。
进阶段（用好）
审查 helper 的 diff，保留任务失败样本，给动作结果加断言。录制路径见 browser-harness recordings；截图和动作轨迹可能包含敏感页面，不等于默认会生成视频，也不应未经同意保存或分享。
领域经验可以从实际任务中积累，但文档里的设计偏好不是“人工不能写或审查”的禁令。
高手段（用活）
需要云浏览器时，再按指南配置云端认证和远端实例。云端环境与本机分开，不等于“本地完全干净”或数据无需治理。多实例调度也应区分 namespace、浏览器 profile 和账号三种边界。
普通用户与高手的差距：不在于敢不敢让 AI 改代码，而在于能否限定修改范围、复核差异，并知道什么结果算完成。
「能用在哪」场景迁移建议
场景 1：日常自动化（最直接）
ERP、CRM 或表单搬运适合先做低风险试点。使用单独测试账号/profile，在提交、付款、发信、删除等动作前安排人工确认；真实登录态意味着 Agent 可能获得真实业务能力。
场景 2：动态数据采集
可以处理获准访问的 SPA 或登录页面，但真实浏览器既不保证不被识别，也不会赋予抓取、越过验证码或再利用内容的权利。登录过期和风控触发应显式停止，不能把它们都当作需要自动“修好”的故障。
场景 3：Web E2E 测试
适合探索流程、辅助生成 helper，不是 Playwright/Cypress 的无条件替代品。回归测试更需要固定环境、独立断言和可重复输入，避免 AI 为了让用例通过而改变验收标准。
部署参考
本地 Chrome 路径不必使用 Browser Use Cloud key，但 Agent 若接远端模型，页面文本、截图或工具结果仍可能外发。云浏览器另有服务、认证和费用条件。
不要公开调试端口；限制进程与账号权限，审查第三方页面的提示注入内容。socket 权限、loopback token 和 PID 检查是局部措施，不是完整安全审计结论。
一句话总结
它的灵魂：给 Agent 一个能积累任务代码的工作区，同时让浏览器连接、改动范围和验收标准保持可控、可检查。
资料核对：2026-10-13，读取官方 README、安装文档、IPC 源码与 pyproject；未安装连接浏览器，未验证自愈、反爬或任务成功率。