用途:Dev Browser 用于浏览器自动化,支持导航网站、填写表单、截图、提取网页数据和测试 Web 应用。其特点是页面状态在多次脚本执行之间保持,便于把复杂任务拆成小步骤逐步完成。
主要能力:启动一个持久 Chromium 浏览器,通过 REST API(默认 http://localhost:9222)管理命名页面;页面由服务器持有,客户端断开后仍存活,cookie、localStorage、DOM 状态均保留。提供 getAISnapshot() 获取 ARIA 可访问性树,用语义角色和稳定 ref 发现元素,再用 selectSnapshotRef() 取得 Playwright ElementHandle 进行交互。支持截图、等待页面加载、检查 URL 与标题等。
使用方式:先运行 ./skills/dev-browser/server.sh & 启动服务器,首次运行会自动安装依赖并下载 Chromium,需等待 Ready 消息。脚本必须用 bun x tsx 执行(不能用 bun run),并导入 @/client.js。典型流程:connect 连接服务器,client.page("main") 获取或创建命名页面,执行 Playwright 操作,最后 client.disconnect() 退出。一次性任务可用 heredoc 内联执行,需复用或复杂脚本才写入 tmp/。
适用场景:本地或可读源码的站点可直接读代码写选择器;未知页面布局用 ARIA 快照发现元素;需要视觉反馈时截图;适合增量式、多步骤的网页操作与测试。
限制:page.evaluate() 等浏览器上下文内只能用纯 JavaScript,不能用 TypeScript;tsx 不做类型检查,类型错误不会阻止执行;首次启动较慢;服务器脚本支持 --headless 标志。其他收费、平台与效果信息暂未提供。