用途：Actionbook 用于自动化多步骤网站任务，如发送消息、预订、网页抓取、外部网站 E2E 测试，以及构建浏览器 AI 智能体。当需要与新页面交互、控制已有 Chrome 或编写网页测试时可激活。
主要能力：提供两种浏览器控制模式。CDP 模式（默认）通过 Chrome DevTools Protocol 启动独立浏览器实例，适合无头自动化、CI/CD 和隔离会话；扩展模式加 --extension（或 ACTIONBOOK_EXTENSION=1）控制用户已打开、带登录态与 Cookie 的 Chrome。浏览器命令在两种模式下一致，涵盖导航（open/goto/back/forward/reload/pages/switch/close/restart/connect）、交互（click/fill/type/select/hover/focus/press）、信息获取（text/html/snapshot/viewport/status）、等待（wait/wait-nav）、截图与 PDF、JS 执行与坐标检查、Cookie 管理。全局标志含 --json、--headless、--verbose、-P、--cdp、--extension。
使用方式：先用 actionbook search "<任务描述>" 查找 Action Manual，再用 actionbook get "<area_id>" 获取页面结构与预验证选择器；随后用浏览器命令执行，如 open、fill、select、click、wait-nav、text、close。手动格式含 area_id、页面 URL、页面结构与带 CSS/XPath/role 选择器及置信度的 UI 元素。扩展模式需一次性安装：actionbook extension install、在 chrome://extensions 加载解压目录、actionbook extension serve；自动化前用 extension status 和 extension ping 检查连接。
限制：Action Manual 数据在索引时生成，可能随网站演变而过期，选择器可能失效或匹配错误元素，此时应改用 snapshot、screenshot、inspect 或 eval 回退。扩展模式必须遵守 pre-flight→connect→execute→cleanup 生命周期，清理时须先执行 browser close 释放调试连接，再运行 extension stop；CLI 无法在连接前检测 Chrome 是否真正加载扩展。控制用户真实浏览器时应避免破坏性操作，部分 Cookie/存储修改可能需扩展弹窗手动批准。若搜索无结果或操作失败，应改用其他工具。