用途：通过 agent-browser CLI 在用户真实运行的 Chrome 会话中自动化浏览器任务，如导航页面、填写表单、点击按钮、截图、提取数据，以及回放 Chrome DevTools Recorder 录制的操作（JSON、Puppeteer JS、@puppeteer/replay JS 格式）。
主要能力与用法：核心原则是复用用户现有 Chrome，不新建独立会话或配置文件。命令统一以 agent-browser --auto-connect <command> 连接已开启远程调试的 Chrome。操作前先列出现有标签页：agent-browser --auto-connect tab list，若目标页已打开则用 tab <index> 切换，避免丢失登录态；否则用 open <url> 打开。用 snapshot -i 获取带引用（@e1、@e2…）的交互元素，再执行 click @eN、fill @eN "text" 等。标准输入用 fill，contenteditable 富文本编辑器需先聚焦再用 keyboard inserttext。支持 press、scroll、wait、screenshot、eval、get text body、get url、set viewport、find text "..." click 等命令。页面变化后引用会失效，需重新 snapshot。
适用场景：社交媒体看板、广告管理后台、CMS 等需登录的营销平台操作，数据抓取，录制回放，以及跨平台发布流程（应一个平台一个子代理顺序执行，避免标签页冲突）。
限制与注意事项：snapshot -i 仅作用于主框架，无法穿透 iframe，LinkedIn、Gmail 等站点需用 eval、键盘输入、get text body 或截图变通；fill 仅适用于 input/textarea；find text 严格模式在多元素匹配时会失败；eval 仅限同源 iframe；Chrome 144+ 可能出现仅 WebSocket 端点情况，可用 npx -y agent-browser@latest connect "ws://127.0.0.1:9222/devtools/browser" 尝试。遇到登录、验证码、破坏性操作或不熟悉的页面结构时应暂停并向用户确认；连续两次尝试失败也应暂停。具体安装与 Chrome 调试设置见 references/agent-browser-setup.md。