用途:该技能基于 Playwright 实现浏览器自动化,用于网站测试、页面截图、填写与提交表单、抓取网页内容以及各类浏览器操作自动化。脚本采用 Python 配合 uv,自包含运行,无需全局安装。
主要能力:截图(可整页、无头、自定义输出路径);导航并提取标题、URL、链接(JSON)、文本内容;填写并提交表单;执行 JavaScript 表达式;支持语义定位器 API、追踪调试等。
环境要求:Python 3.10+、uv 包管理器、Playwright 浏览器二进制(一次性安装)。
首次设置:需用户手动运行,不要由 AI 直接执行: uv run --with playwright playwright install chromium 或安装全部浏览器: uv run --with playwright playwright install 验证: uv run /path/to/plugins/playwright/scripts/check_setup.py
常见用法示例: 截图:uv run scripts/screenshot.py https://example.com 整页无头:uv run scripts/screenshot.py https://example.com --full-page --headless 提取链接:uv run scripts/navigate.py https://example.com --links 填表提交:uv run scripts/fill_form.py https://example.com/login --field "email=test@example.com" --field "password=secret123" --submit 执行 JS:uv run scripts/evaluate.py https://example.com "document.title"
自定义脚本可用 uv 内联依赖声明,依赖 playwright==1.56.0。推荐使用语义定位器如 page.get_by_role、get_by_label、get_by_text、get_by_test_id,避免脆弱的 CSS 选择器。
环境变量:HEADLESS(默认 0)、SLOW_MO(默认 0)、VIEWPORT(默认 1280x720)、TRACE(默认 0)。
调试与限制:可用 tracing 生成 trace.zip 并查看;超时或元素不可交互时需调整等待策略与滚动;容器/CI 中可加 --disable-dev-shm-usage --no-sandbox。价格、平台限制等资料暂未提供。