用途:这是一个通用浏览器自动化技能,为任意浏览器自动化需求编写并执行自定义 Playwright 代码,可测试页面、填写表单、截图、检查链接与响应式布局等。
主要能力:自动检测本地开发服务器(detectDevServers);按需编写脚本到 /tmp/playwright-test-*.js;默认使用可见浏览器(headless: false);支持多视口响应式测试、登录流程、表单提交、断链检查、截图与错误处理;提供 lib/helpers.js 辅助函数(safeClick、safeType、takeScreenshot、handleCookieBanner、extractTableData 等);支持通过 PW_HEADER_NAME/PW_HEADER_VALUE 或 PW_EXTRA_HEADERS 注入自定义 HTTP 头。
使用方式:首次运行 cd $SKILL_DIR && npm run setup 安装 Playwright 与 Chromium。执行流程为先检测服务器:cd $SKILL_DIR && node -e "require('./lib/helpers').detectDevServers().then(servers => console.log(JSON.stringify(servers)))",再写脚本到 /tmp,最后执行 cd $SKILL_DIR && node run.js /tmp/playwright-test-*.js。简单任务可用内联执行。脚本中 URL 应参数化为 TARGET_URL 常量。
适用场景:本地或外部站点的页面测试、表单与登录流程验证、响应式设计检查、截图、断链检查等。
限制:需先安装 Playwright 与 Chromium;脚本须经 run.js 包装执行以避免模块解析问题;默认非无头模式,需可用显示环境;高级 API 细节见 API_REFERENCE.md。具体收费与平台支持暂未提供。