用途：面向本地 Web 应用，通过编写 Python Playwright 脚本进行交互与测试，可验证前端功能、调试 UI 行为、抓取浏览器截图以及查看浏览器日志。
主要能力与结构：提供助手脚本 scripts/with_server.py 管理服务器生命周期（支持多服务器，例如后端与前端同时启动）。使用前应先以 --help 查看用法，脚本设计为黑盒调用，不建议通读源码以免占用上下文。
使用方式：先判断应用类型。静态 HTML 可直接读取文件识别选择器并编写 Playwright 脚本；动态 Web 应用若服务器未运行，先用 python scripts/with_server.py --help 查看用法，再以其简化脚本。单服务器示例：python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py；多服务器可在命令中重复 --server 与 --port。自动化脚本只写 Playwright 逻辑，服务器由助手管理。同步脚本使用 sync_playwright()，建议以 chromium 无头模式启动，页面 goto 后调用 page.wait_for_load_state('networkidle') 等待 JS 执行，结束后关闭浏览器。动态应用采用“先侦察后操作”：导航并等待 networkidle、截图或检查 DOM、从渲染结果识别选择器、再执行操作。
参考文件：examples/ 下有 element_discovery.py（查找按钮、链接、输入框）、static_html_automation.py（本地 HTML 使用 file:// URL）、console_logging.py（捕获控制台日志）。
限制与注意事项：动态应用必须等待 networkidle 后再检查 DOM；选择器建议使用 text=、role=、CSS 或 ID，并合理使用 wait_for_selector() 或 wait_for_timeout()。资料未提供安装步骤、收费、价格或平台支持等信息。