用途：agent-browser 用于在全新或隔离的浏览器会话中驱动网页交互，适合状态可丢弃、流程需在 CI 或自动化中可复现的任务。当任务依赖用户当前 Chrome 状态、已保存登录、Cookie、扩展或已打开标签页时，应改用 playwriter。
主要能力：导航（open、close）；快照与引用（snapshot -i、snapshot -i -C、snapshot -s "#selector"）；交互（click、fill、type、select、check、press）；验证（diff snapshot、diff screenshot --baseline、diff url）；捕获（screenshot、screenshot --annotate、pdf）；等待（wait --load networkidle、wait <selector|@ref|ms>）。
使用方式：采用 ref 优先循环，即 open 后按需 wait --load networkidle，再 snapshot -i，用 @e1、@e2 等引用交互，页面或 DOM 变化后重新 snapshot -i 或 diff snapshot。示例：agent-browser open https://example.com/form && agent-browser wait --load networkidle && agent-browser snapshot -i。每个有意义的动作后用 diff snapshot 或 diff screenshot --baseline 提供明确证据。可用 --session <name> 隔离并行任务或安全复用认证。若怀疑版本漂移，可先执行 agent-browser skills list 和 agent-browser skills get agent-browser --full 刷新说明。多步 JS 可用 eval --stdin 或 base64 输入避免 shell 转义问题。
适用场景：公共表单的隔离驱动、预发与生产页面结构或截图对比、可复现的网页检查，以及并行浏览器任务等。
限制与安全：导航或显著 DOM 更新后引用会失效，需重新 snapshot；命令缺失时执行 agent-browser install；元素点击错误需重新 snapshot -i；动态 SPA 内容缺失可用 --load networkidle 或定向等待；会话冲突需使用唯一 --session 名并关闭。敏感或易受提示注入影响的流程可设置域允许列表、内容边界与动作策略，例如 AGENT_BROWSER_CONTENT_BOUNDARIES=1、AGENT_BROWSER_MAX_OUTPUT=50000、AGENT_BROWSER_ALLOWED_DOMAINS 与 AGENT_BROWSER_ACTION_POLICY。具体资源见 https://github.com/vercel-labs/agent-browser、https://agent-browser.dev。