用途：agent-browser 是面向 AI 智能体的浏览器自动化 CLI，用于与网站交互，如导航页面、填写表单、点击按钮、截图与状态对比。
主要能力：核心流程为导航（agent-browser open <url>）、快照（agent-browser snapshot -i 获取 @e1、@e2 等元素引用）、交互（click、fill、select、check、press、scroll）、再快照。命令可用 && 串联，浏览器由后台守护进程保持状态。支持截图（含 --full、--annotate）、导出 PDF、diff snapshot/screenshot/url 对比、wait 等待（元素、networkidle、URL 模式、毫秒）、获取文本/URL/标题、JSON 输出、语义定位 find、JS 求值 eval（复杂表达式建议 --stdin 或 -b 避免 shell 转义问题）。
用法：表单提交先 open、snapshot -i，再用 @ref 填写并点击，最后 wait --load networkidle 并重新快照。认证可 state save/load；会话可用 --session-name 自动保存恢复；并行场景用 --session 隔离；可 --auto-connect 或 --cdp 连接现有 Chrome；--headed 调试、highlight、record、profiler。配置文件 agent-browser.json 可设 headed、proxy、profile 等。
限制：页面变化后 @ref 会失效，必须重新快照；需在结束时 close 避免进程泄漏；iOS 模拟器需 macOS 与 Xcode、Appium 及 xcuitest 驱动；真实设备需预先配置并用 --device <UDID>；本地文件需 --allow-file-access；默认 Playwright 超时为 60 秒，慢页面应显式等待。其他细节（费用、平台支持等）暂未提供。