核心用法
Agent Browser 是一款专为 AI Agent 设计的 Headless 浏览器自动化工具，采用 Rust 核心 + Node.js 回退架构，提供完整的 CLI 工作流：
1. 页面导航：open/back/forward/reload 控制浏览流程
2. 元素快照：snapshot -i 生成带 @ref 引用的可交互元素图谱，替代传统 CSS/XPath 选择器
3. 结构化交互：基于 @ref 执行 click/fill/type/select 等操作，避免 LLM 生成脆弱选择器
4. 状态管理：支持 state save/load 持久化登录态，以及 --session 多浏览器并行
5. 高级能力：网络拦截路由、视频录制、CDP 调试、语义定位器（find role/text）
显著优点
- AI 原生设计：
@ref抽象层解决 LLM 与 DOM 的语义鸿沟，大幅降低幻觉错误 - 双引擎可靠性：Rust 核心保证性能，Node.js 回退确保兼容性
- 完整会话隔离：多
--session并行、Cookie/Storage 独立管理 - 观测友好：截图、PDF、视频录制、网络请求追踪、性能 Trace 一站式支持
- DevTools 集成：原生 CDP 连接能力，便于深度调试
潜在局限
- 平台限制：Linux ARM64 需手动指定二进制路径，跨平台体验不一致
- 状态脆弱性：
@ref随页面导航失效，必须重新 snapshot，长流程稳定性依赖开发者正确实现 - 学习成本：CLI 语义丰富（30+ 命令），非自动化测试背景用户需适应期
- 依赖链：需预装 Node.js/npm，容器化场景需额外处理 Chromium 依赖
适合人群
- 构建 Web 操作 Agent 的开发者（如自动化客服、数据采集机器人）
- 需要持久化登录态的 E2E 测试场景
- 追求 "LLM 友好" 交互抽象而非传统 Playwright/Puppeteer 代码的 AI 应用团队
常规风险
- 页面状态漂移：未及时重新 snapshot 导致引用失效，引发操作失败或误触
- 反爬对抗：Headless 检测、速率限制、CAPTCHA 未内置绕过方案
- 持久化安全：
state save的 JSON 包含 Cookie/Storage 敏感数据，需加密存储 - 网络拦截误配：
route --abort可能阻断关键资源加载导致页面异常