用途:通过 Puppeteer CLI 脚本实现浏览器自动化、调试与性能分析,所有脚本输出 JSON,浏览器会话可跨脚本持久复用。
主要能力:提供 navigate.js(导航)、screenshot.js(截图,超 5MB 自动用 Sharp 压缩)、click.js、fill.js、evaluate.js(页面内执行 JS)、snapshot.js(提取交互元素 JSON)、aria-snapshot.js(输出带 ref 的 YAML 无障碍树)、select-ref.js(按 ref 交互)、console.js(控制台日志)、network.js(HTTP 请求)、performance.js(Core Web Vitals)。
使用方式:技能可位于项目级或用户级,优先级项目级 > 用户级。先检测 SKILL_DIR,进入 scripts 目录执行 npm install 安装 puppeteer、sharp、debug、yargs;Linux/WSL 需先运行 ./install-deps.sh。示例:node navigate.js --url https://example.com;node aria-snapshot.js --url https://example.com;node select-ref.js --ref e5 --action click。默认脚本断开但保持浏览器运行,用 --close true 关闭并清除会话。本地 HTML 文件不要用 file://,应通过 npx serve ./dist -p 3000 或 python -m http.server 3000 启动本地服务器。
适用场景:未知页面结构探索、表单自动化、网页抓取、截图验证、控制台与网络错误排查、无障碍结构分析、性能测试。
限制:需 Node 环境与依赖安装;Linux/WSL 需系统库;截图可能因滚动触发动画缺失图片,需先滚动并等待;元素找不到时用 snapshot.js 查选择器;会话失效可删除 .browser-session.json 重试。具体收费、平台支持等资料暂未提供。