用途：agent-browser 是一个 CLI 浏览器自动化工具，用于 UI 检查、表单测试、截图和视觉差异对比等任务。
安装：需执行 npm install -g agent-browser && agent-browser install。截图、PDF 和差异文件默认保存到 .claude/local/screenshots/，首次使用前需 mkdir -p .claude/local/screenshots。
主要能力：支持导航（open、close）、可访问性快照（snapshot，返回带 @e1 等引用的元素）、截图与 PDF（screenshot、pdf）、交互（click、dblclick、fill、type、press、hover、check、uncheck、select、scroll、scrollintoview、drag、upload）、获取信息（get text/value/html/attr/title/url/count）、状态检查（is visible/enabled/checked）、等待（wait @e1、等待毫秒、文本、URL 模式、--load networkidle）、语义定位（find role/text/label/testid）、标签页管理、差异比较（diff snapshot/screenshot/url）、执行 JS（eval）、网络查看与路由、浏览器设置（viewport、device、media、offline）以及控制台与错误调试。
核心工作流：open 导航后用 snapshot 获取 @eN 引用，再基于引用交互。每次导航或 DOM 变化后 @eN 引用立即失效，必须重新 snapshot。点击触发导航后应使用 wait --load networkidle。结束时用 agent-browser close 关闭。
已知限制：scrollintoview 需要 CSS 选择器而非 @eN，可用 eval 代替；find text/role 仅支持 click 和 hover 子操作，填充等交互需用 snapshot + @ref；@eN 引用为单次快照内一次性使用。