用途:dev-browser 是浏览器自动化技能,在脚本执行之间保持页面状态,适合导航网站、填写表单、截图、提取网页数据、测试 Web 应用等任务。
主要能力:支持独立模式(默认,启动新的 Chromium 会话)与扩展模式(连接用户已有 Chrome,用于已登录的授权场景)。提供命名页面管理、ARIA 无障碍树快照(getAISnapshot)与元素引用交互(selectSnapshotRef)、截图、等待页面加载等能力。页面对象为标准 Playwright Page。
使用方式:独立模式运行 ./skills/dev-browser/server.sh &,可加 --headless,等待 Ready 后执行脚本。扩展模式先启动中继服务:cd skills/dev-browser && npm i && npm run start-extension &,等待扩展连接后,脚本用 client.page("name") 创建或连接页面。脚本从 skills/dev-browser/ 目录运行,可用 heredoc 内联执行,例如 npx tsx <<'EOF' ... EOF。
工作流:每个脚本只做一件事,运行后观察输出、评估状态、决定下一步,循环直至完成。页面名应具描述性。结束时用 await client.disconnect() 退出,页面在服务器上保持。
限制:page.evaluate() 在浏览器中运行,只能使用纯 JavaScript,不能写 TypeScript 语法。抓取大数据集建议拦截并重放网络请求,而非滚动 DOM。扩展模式若扩展未连接,需用户手动启动并激活,下载链接见 https://github.com/SawyerHood/dev-browser/releases。安装细节见 references/installation.md,含 Windows 支持。