用途：与本地 Web 应用交互并测试。核心方式是编写原生 Python Playwright 脚本，验证前端功能、调试 UI 行为并捕获页面信息。
主要能力：提供辅助脚本 scripts/with_server.py 管理服务器生命周期，支持同时启动多个服务器；支持截图、获取页面内容、定位按钮等元素，并捕获控制台日志；examples/ 内含元素发现、静态 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 逻辑，使用 sync_playwright()，始终以无头模式启动 chromium，并在 page.goto 后调用 page.wait_for_load_state('networkidle')，结束时关闭浏览器。
推荐采用“先侦察后操作”：等待 networkidle 后截图或检查 DOM，从渲染状态识别选择器，再执行操作。静态 HTML 可直接读取文件确定选择器。常用选择器包括 text=、role=、CSS 与 ID，并配合 page.wait_for_selector() 或 page.wait_for_timeout() 等待。
限制：仅面向本地 Web 应用，依赖 Playwright；动态页面切勿在等待 networkidle 前检查 DOM。官方未提供收费、平台与效果信息。