核心用法
Playwright-skill 是一个基于 Playwright 的浏览器自动化工具，提供完整的网页测试和自动化能力。核心工作流程包括：
1. 自动检测开发服务器 - 自动扫描本地运行的开发服务器（如 localhost:3000/3001），无需硬编码 URL
2. 编写临时测试脚本 - 将自动化代码写入 /tmp/playwright-test-*.js，避免污染用户项目
3. 可见浏览器执行 - 默认使用 headless: false 模式，便于实时观察和调试
4. 通用执行器运行 - 通过 run.js 包装器执行，确保模块正确解析
主要功能模块
| 功能 | 用途 |
|------|------|
| 页面测试 | 加载页面、验证标题、检查元素 |
| 截图对比 | 全页截图、多视口响应式截图 |
| 表单自动化 | 自动填充、提交验证、错误处理 |
| 登录流程测试 | 认证流程、重定向验证 |
| 链接检查 | 批量检测外链可用性 |
| 自定义 HTTP 头 | 通过环境变量注入请求头 |
显著优点
- 零项目侵入：测试代码写入
/tmp，用完即走，不修改用户代码库 - 智能服务器发现：自动检测本地开发服务器，消除 URL 配置负担
- 实时可视化：可见浏览器模式让调试直观，配合
slowMo可观察每一步操作 - 灵活扩展：支持自定义 Playwright 代码，不限于预设脚本
- 环境隔离：通过
PW_HEADER_NAME/VALUE等环境变量安全传递配置
潜在局限
- Node.js 依赖：需要 Node.js 环境和 Playwright 浏览器下载（首次 setup 约需数分钟）
- GUI 依赖：可见模式需要图形界面，无头服务器环境需显式指定
headless: true - 临时文件策略：虽写入
/tmp，但大量测试可能短暂占用磁盘空间 - 无内置断言库：仅提供 Playwright 原生 API，需自行组织测试断言
适合人群
- 前端开发者：快速验证页面渲染、响应式布局
- QA 工程师：自动化回归测试、登录流程验证
- 设计师：跨设备截图对比、UI 验收
- DevOps：CI/CD 中的预部署检查（需配合 headless 模式）
常规风险
- 浏览器资源消耗：Chromium 实例占用内存（约 100-300MB），长时间运行需注意
- 超时风险：慢加载页面需合理设置
waitUntil和timeout - 选择器脆弱性：依赖 DOM 选择器，页面结构变更会导致测试失败
- 并行执行限制：未内置并发控制，同时运行多个浏览器实例可能资源紧张