用途：测试本地 Web 应用，通过编写原生 Python Playwright 脚本验证前端功能、调试 UI 行为与截图。
主要能力：附带 scripts/with_server.py 管理服务器生命周期，支持多个服务器（如后端+前端）；提供示例，包括元素发现、静态 HTML 自动化、控制台日志捕获。
使用方式：脚本作为黑盒直接调用，运行前先用 --help 查看用法，不要先读源码。单服务示例：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 逻辑，服务由 helper 管理：使用 sync_playwright()，以无头模式启动 chromium，page.goto('http://localhost:5173')，再 page.wait_for_load_state('networkidle')。
决策路径：静态 HTML 可直接读取文件识别选择器；动态应用若服务未运行，先用 with_server.py；服务已运行则先侦察再操作：导航并等待 networkidle、截图或检查 DOM、从渲染状态识别选择器、再执行操作。
最佳实践：使用描述性选择器（text=、role=、CSS 或 ID），添加适当等待 page.wait_for_selector() 或 page.wait_for_timeout()，完成后关闭浏览器。
限制：未提供安装命令、版本、平台、收费等信息。