用途：通过 Vercel 的 agent-browser CLI 实现浏览器自动化，适用于导航网站、验证已部署 UI、测试 Web 应用、阅读在线文档、抓取数据等场景。默认无头运行，加 --headed 可显示浏览器窗口；元素选择基于无障碍快照生成的引用（如 @e1、@e2）。
安装检查：command -v agent-browser >/dev/null 2>&1 && echo "OK" || echo "MISSING: npm i -g agent-browser && agent-browser install"
核心流程：打开 URL → 快照获取引用 → 通过引用交互 → DOM 变化后重新快照。示例：agent-browser open https://example.com；agent-browser snapshot -i；agent-browser click @e1；agent-browser wait --load networkidle；agent-browser snapshot -i。
主要能力：导航（open、back、forward、reload、close）；快照（snapshot、-i 仅交互元素、--json、-c 紧凑、-d 限制深度、-s 限定选择器）；交互（click、dblclick、fill、type、press、hover、check、uncheck、select、scroll、scrollintoview）；获取信息（get text/value/html/attr/title/url/count）；状态检查（is visible/enabled/checked）；等待（wait 元素、毫秒、--text、--url、--load networkidle、--fn）；截图与 PDF（screenshot、--full、pdf）；语义定位（find role/text/label/placeholder/first/nth）；会话隔离（--session、session list）；JSON 输出（--json）。
认证与调试：可保存和加载登录状态（state save/load auth.json），支持通过 --headers 传入令牌；调试可用 --headed、console、errors、highlight。
限制与排错：出现“Browser not launched”可执行 pkill -f agent-browser && agent-browser open <url>；元素未找到时需在页面变化后重新快照。更多调试、认证、网络模拟、标签页、框架等内容见 debugging.md、auth.md、advanced.md。