用途：通过 agent-browser CLI 驱动浏览器，完成网页导航、已部署 UI 验证、Web 应用测试、在线文档阅读和数据抓取等任务。默认无头运行，加 --headed 可显示窗口；元素选择基于无障碍快照生成的引用（@e1、@e2）。
主要能力：导航（open/back/forward/reload/close）；快照（snapshot，-i 仅交互元素，-C 含光标交互元素，--json 输出 JSON）；交互（click、dblclick、fill、type、press、hover、check、select、scroll、drag、upload）；信息获取（get text/value/html/attr/title/url/count/box/styles）；状态检查（is visible/enabled/checked）；等待（元素、毫秒、文本、URL、networkidle、JS 条件）；截图与 PDF；diff 对比快照、截图或两个 URL；语义定位（find role/text/label/placeholder/testid 等）；eval 执行 JS；会话与状态持久化；连接已有 Chrome；本地文件；iOS 模拟器；录制与性能分析。
使用方式：先检查版本，command -v agent-browser >/dev/null 2>&1 && agent-browser --version || echo "MISSING: npm i -g agent-browser && agent-browser install"。核心流程为 open、snapshot 获取引用、通过引用交互、DOM 变化后重新 snapshot。命令可用 && 串联，浏览器通过后台守护进程在命令间保持。复杂 JS 建议用 eval --stdin 或 -b 避免 shell 转义问题。
适用场景：表单提交、带保存状态的认证、令牌认证、UI 验证、页面状态对比、移动端 Safari 测试等。
限制：引用在页面变化后失效，需重新快照；默认 Playwright 超时 60 秒，慢页面需显式等待；iOS 模拟器需 macOS、Xcode 与 Appium；使用后应 close 会话避免进程泄漏；守护进程卡住时可用 pkill -f agent-browser 处理。更多细节见 commands.md、auth.md、debugging.md 等参考文件。