用途:在终端中通过 playwright-cli 驱动真实浏览器,实现一次性或可复现的自动化流程,如网页导航、表单填写、快照获取、截图、PDF 与追踪记录、多标签页操作。适用于目标为网站或网页应用(非 Electron)的场景。
主要能力:open 打开页面、snapshot 获取稳定元素引用、click/type/fill/press 交互、screenshot/pdf 等产物捕获、tracing-start/stop 追踪调试、tab-new/tab-list/tab-select 多标签管理。
使用方式:优先使用随技能提供的包装脚本,避免依赖全局安装。先设置路径:export PWCLI="<path-to-skill>/scripts/playwright_cli.sh"。快速开始:"$PWCLI" open https://playwright.dev --headed、"$PWCLI" snapshot、"$PWCLI" click e15、"$PWCLI" type "Playwright"、"$PWCLI" press Enter、"$PWCLI" screenshot。也可全局安装:npm install -g @playwright/cli@latest,然后 playwright-cli --help。
前置检查:包装脚本依赖 npx,先执行 command -v npx >/dev/null 2>&1;若不可用,请用户安装 Node.js/npm,可用命令 node --version、npm --version 验证,再执行 npm install -g @playwright/cli@latest、playwright-cli --help。
工作流:打开页面→快照→用最新快照中的引用交互→导航或 DOM 显著变化后重新快照。引用会过期,命令因缺失引用失败时应重新快照。需要可视化时加 --headed;捕获产物建议放在 output/playwright/ 下。
适用场景:短小可复现的终端工作流、无需维护长生命周期会话的网页自动化。若需在多次编辑间保持同一浏览器状态、任务高度迭代或调试 Electron,应改用 playwright-interactive。
限制与注意:始终在引用元素 id 前快照;优先显式命令而非 eval 或 run-code;没有新快照时用占位引用并说明原因,不要用 run-code 绕过引用。默认使用 CLI 命令与工作流,不编写 Playwright 测试规范,除非用户明确要求测试文件。账号凭据不得硬编码到仓库文件或临时脚本中。