用途：测试本地 Web 应用，验证前端功能、调试 UI 行为、捕获截图，通过编写原生 Python Playwright 脚本完成自动化。
主要能力：内置 scripts/with_server.py 管理服务器生命周期，支持同时启动多个服务器；提供 examples 参考，如 element_discovery.py 发现页面按钮、链接和输入框，static_html_automation.py 通过 file:// 处理本地 HTML，console_logging.py 捕获控制台日志。
使用方式：脚本按黑盒方式调用，运行前先执行 --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 自动管理，示例中始终以 headless 模式启动 chromium，并在动态应用上先 page.wait_for_load_state('networkidle') 再检查 DOM。
决策路径：静态 HTML 可直接读取文件识别选择器；动态应用若服务器未运行则先用 with_server.py；已运行则先侦察再操作（导航并等待 networkidle、截图或检查 DOM、识别选择器、执行动作）。
建议：使用 sync_playwright()，完成后关闭浏览器，使用 text=、role=、CSS 或 ID 等描述性选择器，并添加适当等待。
限制：具体支持范围以资料为准，未提供收费、平台限制等信息。