用途：通过编写原生 Python Playwright 脚本，与本地 Web 应用交互并测试，验证前端功能、调试 UI 行为、截图与捕获控制台日志。
主要能力：提供 scripts/with_server.py 辅助脚本管理服务器生命周期，支持同时启动多个服务器（如后端加前端）。附带示例文件，包括元素发现、静态 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 逻辑，服务器由辅助脚本管理。
决策流程：若为静态 HTML，直接读取文件识别选择器；失败则按动态应用处理。动态应用若服务器未运行，先用 with_server.py；若已运行，采用先侦察后操作：导航并等待 networkidle，截图或检查 DOM，从渲染状态识别选择器，再执行操作。
最佳实践：使用 sync_playwright() 编写同步脚本，始终以无头模式启动 chromium，完成后关闭浏览器；使用描述性选择器（text=、role=、CSS 或 ID）；添加适当等待。常见陷阱：动态应用在等待 networkidle 前不要检查 DOM。
限制：资料未提供安装步骤、依赖版本、收费或平台支持等细节。