用途:这是一个通用浏览器自动化技能,基于 Playwright 编写并执行自定义脚本,适用于浏览器测试、E2E 测试、截图、表单测试和响应式设计检查。
主要能力:自动检测本地运行中的开发服务器;按需编写 Playwright 脚本;默认使用可见浏览器(headless: false)便于调试;实时显示结果;截图自动保存到 .web-tests/screenshots/;提供 helpers 工具,如 detectDevServers、safeClick、safeType、takeScreenshot、handleCookieBanner、extractTableData。
使用方式:首次需在技能目录执行 cd $SKILL_DIR && npm run setup 安装 Playwright 与 Chromium。测试本地站点时先检测服务器:cd $SKILL_DIR && node -e "require('./lib/helpers').detectDevServers().then(servers => console.log(JSON.stringify(servers)))"。脚本写入用户工作目录的 .web-tests/scripts/test-.js,URL 用顶部常量参数化。执行命令:CWD=$(pwd) cd $SKILL_DIR && node run.js .web-tests/scripts/test-.js。简单任务可用内联执行。
适用场景:登录流程、表单填写与提交、多视口响应式检查、断链检查、页面截图等。
限制:需先安装 Playwright 与 Chromium;执行时须设置 CWD 环境变量,否则截图可能不保存到 .web-tests/;默认非 headless,仅在用户明确要求时才用 headless;元素未找到时需自行添加等待;具体收费与平台支持资料暂未提供。