用途：使用原生 Python Playwright 脚本测试本地 Web 应用，验证前端功能、调试 UI 行为、截图与捕获控制台日志。
主要能力：提供辅助脚本 scripts/with_server.py 管理服务器生命周期，支持同时启动多个服务器（如后端加前端）。脚本设计为黑盒直接调用，运行前先用 --help 查看用法，不要先读源码，以免占用上下文窗口。
使用方式：先判断任务类型。若为静态 HTML，可直接读取文件确定选择器；若失败或不完整则按动态应用处理。动态应用若服务器未运行，先执行 python scripts/with_server.py --help，再用辅助脚本配合简化的 Playwright 脚本。单服务器示例：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 逻辑，服务器由辅助脚本管理。
动态应用推荐先侦察后操作：导航并等待 networkidle，截图或检查 DOM，从渲染状态识别选择器，再用发现的选择器执行操作。常见陷阱是未等待 networkidle 就检查 DOM。
最佳实践：使用 sync_playwright() 编写同步脚本；始终以无头模式启动 chromium；完成后关闭浏览器；使用描述性选择器如 text=、role=、CSS 选择器或 ID；添加适当等待如 page.wait_for_selector() 或 page.wait_for_timeout()。参考文件 examples/ 包含元素发现、静态 HTML 自动化、控制台日志捕获等示例。
限制：资料未提供具体收费、平台支持范围或效果保证等信息。