用途：用于与本地 Web 应用交互并测试，验证前端功能、调试 UI 行为、捕获截图。
主要能力：编写原生 Python Playwright 脚本；提供辅助脚本 scripts/with_server.py 管理服务器生命周期，支持同时启动多个服务器。
使用方式：先以 --help 运行脚本查看用法，再直接作为黑盒调用，不要读取源码。需要服务器时运行 python scripts/with_server.py --help，再按单服务器或多服务器方式调用，例如 python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py。自动化脚本只需写 Playwright 逻辑，服务器由辅助脚本管理。
选择路径：静态 HTML 可直接读取文件识别选择器；动态应用若服务器未运行则先启动，若已运行则先侦察再操作：导航并等待 networkidle、截图或检查 DOM、识别选择器、执行操作。
最佳实践：使用 sync_playwright()；结束时关闭浏览器；使用可读选择器；添加适当等待。常见错误：动态应用在 networkidle 前检查 DOM。示例文件包括 element_discovery.py、static_html_automation.py、console_logging.py。