用途:通过 Puppeteer CLI 脚本实现浏览器自动化、调试与性能分析,脚本均输出 JSON,浏览器状态可跨脚本持久复用。
主要能力:提供 navigate.js(导航)、screenshot.js(截图,超 5MB 自动用 Sharp 压缩)、click.js、fill.js、evaluate.js、snapshot.js(提取交互元素)、aria-snapshot.js(输出 YAML 无障碍树与 ref)、select-ref.js(按 ref 交互)、console.js(控制台日志)、network.js(HTTP 请求)、performance.js(Core Web Vitals)等脚本。
使用方式:技能可位于项目级或用户级,优先级项目级 > 用户级。先进入 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 --directory ./dist 启动本地服务器。
适用场景:未知页面结构时先用 ARIA 快照发现元素再按 ref 交互;表单自动化、网页抓取、性能测试、无障碍审计、控制台与网络错误排查、截图验证渲染。
限制:需 Node 环境与依赖安装;Linux/WSL 需系统库;截图可能因滚动触发动画缺失图片,需先滚动并等待;元素找不到时用 snapshot.js 查选择器或改用 XPath;脚本挂起可设 --timeout 或 --wait-until load;会话失效可删除 .browser-session.json 重试。