用途：通过命令行驱动浏览器完成自动化与自测，守护进程持有原始 CDP（Chrome DevTools Protocol）WebSocket 连接，直接使用 CDP 而非 Puppeteer/Playwright 框架。支持本地模式（Chrome 运行于 :9222）与远程沙箱模式（Cloudflare Browser Rendering）。
架构：docyrus browser <command> 调用 Node.js 工具脚本，脚本向守护进程（localhost:9333）发 HTTP 请求，守护进程再通过原始 CDP WebSocket 连接 Chrome/Cloudflare。守护进程在首次命令时自动启动，空闲 5 分钟后停止，所有命令共享同一浏览器连接。
主要能力：会话管理（start、start --profile、close）；导航（nav，支持 --new、--reload）；等待（wait --idle、--selector、--url、固定毫秒、--timeout）；页面快照（snapshot，返回带 @e1 等 ref 的交互元素，支持 --all、--selector）；元素交互（click/fill/select，支持 ref、CSS 选择器或 x,y 坐标，坐标点击在合成器层可穿透 iframe、Shadow DOM 与跨域框架）；JavaScript 求值（eval，支持表达式与多语句，awaitPromise: true）；截图（screenshot，支持 --full、--base64）；控制台消息（console，支持 --level、--listen）；网络检查（network，支持 --method、--status、--url、--listen）；Docyrus Devtools 诊断（devtools state/errors/issues/console，需页面加载 @docyrus/devtools）；内容提取（content <url> 输出可读 markdown）；Cookie（cookies，支持 --name、--domain）；页面信息（info）；标签页管理（tabs、tabs --switch）；CDP 脚本（run-script script.js，提供 cdp、evaluate、navigate、captureScreenshot、clickAt、typeText、pressKey、pageInfo、drainEvents、waitForCondition 等辅助）。
典型用法：docyrus browser start；docyrus browser nav <url>；docyrus browser wait --idle；docyrus browser snapshot；docyrus browser fill @e2 "user@example.com"；docyrus browser click @e3；随后用 wait --selector、screenshot、console --level error、network --method POST --status 2xx 验证结果。
适用场景：面向 AI 智能体的网页自测与自动化，如登录表单填写、交互验证、运行时错误与网络请求排查。
限制与注意事项：远程/沙箱模式截图需用 --base64；console 需尽早运行一次以安装拦截器；交互后应重新 snapshot 获取新 ref；iframe 或 Shadow DOM 内元素可用坐标点击；资料未提供安装方式、收费与平台支持等细节。