用途：使用原生 Python Playwright 脚本测试本地 Web 应用，验证前端功能、调试 UI 行为并截图。
主要能力：提供辅助脚本 scripts/with_server.py 管理服务器生命周期，支持同时启动多个服务器（如后端加前端）。脚本应作为黑盒直接调用，先运行 --help 查看用法，不要先读源码，以免占用上下文。
使用方式：先判断任务类型。静态 HTML 可直接读取文件识别选择器；动态应用若服务器未运行，先执行 python scripts/with_server.py --help，再用辅助脚本加简化 Playwright 脚本。单服务器示例：python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py。多服务器示例：python scripts/with_server.py --server "cd backend && python server.py" --port 3000 --server "cd frontend && npm run dev" --port 5173 -- python your_automation.py。自动化脚本只写 Playwright 逻辑，服务器由辅助脚本管理。
动态应用采用先侦察后操作：导航并等待 networkidle，截图或检查 DOM，从渲染状态识别选择器，再执行操作。示例代码使用 sync_playwright()，以 headless 模式启动 chromium，page.goto 后调用 page.wait_for_load_state('networkidle')。
最佳实践：使用同步 API，结束时关闭浏览器，使用 text=、role=、CSS 或 ID 等描述性选择器，添加 page.wait_for_selector() 或 page.wait_for_timeout() 等待。常见陷阱：动态应用在等待 networkidle 前不要检查 DOM。参考文件 examples/ 含 element_discovery.py、static_html_automation.py、console_logging.py 等示例。
限制：资料未提供安装步骤、依赖版本、收费或平台支持等细节。