agent-browser (浏览器自动化)
Vercel Labs 出品的 AI agent 浏览器自动化 CLI：Rust 原生二进制经 CDP 直连 Chrome，用「无障碍树快照 + @eN 元素引用」让 agent 以约 200-400 token 完成浏览、填表、点击、截图、登录与 QA，同一命令面同时支持 CLI 与 MCP，并覆盖 Electron 桌面应用与云浏览器。
仓库：vercel-labs/agent-browser
热度证据：40,532 star,Vercel 官方出品,浏览器自动化新标准；字节笔记本Top11 第03条：Vercel Labs 2026年初推出，快照+元素引用机制，token消耗比Playwright MCP低90%以上，本地已克隆
五维评分
热度5/5
质量5/5
创新4/5
易用5/5
文档5/5
优秀点拆解
- 快照+ref 压缩协议：把 DOM 压成带 @eN 引用的可交互摘要树，上下文从 3000-5000 token 降到 200-400（snapshot-refs.md 原文量化对比），交互走确定性引用且失败时报告遮挡元素，token 效率与可靠性双赢
- 反文档漂移的发现桩设计：skills/agent-browser/SKILL.md 仅 51 行自述为 discovery stub，真内容由 agent-browser skills get core 从当前安装版本下发，文档永远与二进制匹配
- 会话/登录态工程化：--session 隔离 + worktree 稳定 ID + --restore 自动持久化 + 恢复前三重校验 + idle 自动回收，多 agent 并行不互相 hijack，崩溃不泄漏进程
- CLI 与 MCP 同源双通道：MCP server 委托 CLI parser 保证完全 parity（AGENTS.md 硬规范 + 测试证明），工具按 core/network/state/debug 等 profile 分层控制上下文体积
- 安全内置为一等公民：--allowed-domains 同步禁用 WebRTC 防 DNS 绕过、workers 加防护、auth vault 凭据不进 shell history、状态可加密、非 TTY 自动拒绝确认，配套 trust-boundaries.md 明确定义信任边界
可复用的设计模式
- 发现桩 + 按版本下发内容：SKILL.md 只放触发描述与重定向，真内容由工具按安装版本输出，解决技能文档过期问题
- 摘要 + 引用句柄两步协议：先把外部系统压成带稳定句柄的结构化摘要给 agent 选择，再用句柄动作、随状态变化强制刷新
- 长生命周期资源状态机：稳定 ID → 自动保存/恢复 → 恢复前条件校验（不满足不覆盖好状态）→ 空闲自动回收
- 文档同步制度化：新增功能必须同步 help/README/skill-data/docs 站点/源码注释五处，CLI/MCP parity 用测试证明
适用场景
AI agent 网页自动化：登录、填表、点击、截图、数据提取QA 与探索性测试（dogfood）：bug 排查、回归验证、应用质量审查Electron 桌面应用自动化：VS Code、Slack、Figma、Notion 等经 CDP 连接多会话并行：多用户流测试、并行抓取、多 agent 隔离工作需要登录态的持久化抓取：auth vault / Chrome profile 复用 / --restore 会话恢复
边界与注意：refs 随页面变化立即失效，必须 re-snapshot 否则报 Ref not found；依赖 Chrome（首装需下载），headed 模式在无桌面 Linux 需 Xvfb；跨域 iframe 无 opt-in 时被快照跳过；canvas/纯图形页需配合 --annotate 多模态截图；--remote-debugging-port 与明文 state 文件存在本地安全暴露面。
完整拆解分析文档
本页为摘要版，完整精读分析（核心机制、逐条优秀点拆解、写作过程）见本地 Markdown 文档：
analysis/community-agent-browser.md