用途:面向本地 Web 应用的前端功能验证与 UI 调试,通过编写原生 Python Playwright 脚本完成自动化测试、截图和 HTML 渲染。
主要能力:附带 scripts/with_server.py 管理服务器生命周期,支持同时启动多个服务器(如后端加前端);提供示例脚本,包括元素发现、静态 HTML 自动化和控制台日志捕获。
使用方式:先运行脚本的 --help 查看用法,再作为黑盒直接调用,不要先读源码。启动单个服务器:python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py;多服务器用多个 --server 参数。自动化脚本只写 Playwright 逻辑,服务器由助手管理。动态应用需先 page.wait_for_load_state('networkidle') 再检查 DOM,然后依据渲染结果确定选择器并执行操作。渲染 HTML 为 PNG 可用 uv run --with playwright,浏览器安装命令为 uv run --with playwright python3 -m playwright install chromium。
适用场景:本地静态或动态 Web 应用的功能测试、UI 行为调试、截图与元素定位。
限制:动态应用在 networkidle 前检查 DOM 是常见错误;截图清晰需 device_scale_factor 设为 4 或 5;full_page 会包含 body 边距。资料未提供收费、平台支持范围等更多信息。