本地 Web 应用 Playwright 测试

解决的问题

本地 Web 应用自动化测试常被三件事拖住：服务启动参数分散、前后端需要同时起、页面 DOM 动态变化导致选择器写错。这个技能把重点收敛到本地 Playwright 脚本，并通过 scripts/with_server.py 作为黑盒管理单服务器或多服务器生命周期，避免手工复制服务启动逻辑。

工作方式和边界

核心流程是“先侦察，后操作”：先渲染页面并检查 DOM，从结果里识别 text=、role=、CSS 或 ID 选择器，再执行点击、输入、断言等动作。动态应用里，检查 DOM 前可等待 page.wait_for_load_state('networkidle')。脚本通常使用 sync_playwright() 编写，完成后关闭浏览器，并用 page.wait_for_selector() 等显式等待降低竞态。

注意：不要直接阅读大脚本源码来“猜用法”，先运行 --help 查看参数；只有确实需要定制时再进入源码。该技能适合本地单页面、静态 HTML、前后端联调等可被 Playwright 覆盖的场景，不替代后端单元测试、性能压测或安全测试。