SuperAPI AI 工具集

dev-browser

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:dev-browser 用于浏览器自动化,能在多次脚本执行之间保持页面状态,适合导航网站、填写表单、截图、提取网页数据、测试 Web 应用等任务。建议编写小型、聚焦的脚本逐步推进;当某段流程被验证且存在重复工作时,可写成脚本一次执行。

主要能力:维护跨脚本的页面状态;按名称获取或创建页面;提供 Playwright 页面对象;支持 waiting、截图、ARIA 快照(getAISnapshot 返回 YAML 格式可访问性树,selectSnapshotRef 用 ref 选取元素交互);抓取大数据集时可拦截并重放网络请求。

使用方式:有两种模式。独立模式(默认)启动全新 Chromium:./skills/dev-browser/server.sh &,可按需加 --headless,等待 Ready 后再运行脚本。扩展模式连接用户现有 Chrome,先运行 cd skills/dev-browser && npm i && npm run start-extension &,等待 console 输出 Extension connected;未连接时提示用户启动并激活扩展,下载见 https://github.com/SawyerHood/dev-browser/releases。脚本须在 skills/dev-browser/ 目录运行,@/ 别名依赖该目录配置,可用 heredoc 内联执行,如 cd skills/dev-browser && npx tsx <<'EOF' ... EOF。

关键限制:page.evaluate() 在浏览器上下文运行,只能写纯 JavaScript,不能含 TypeScript 语法(如类型注解)。每个脚本尽量只做一件事;页面名要具描述性;用 await client.disconnect() 退出,页面会保留在服务器上。页面失败后状态仍持久,可截图并读取 url、title、body 文本调试。抓取大数据请参考 references/scraping.md,采用请求捕获与分页 API 重放而非滚动 DOM。