nanocode/skills/browser-automation/SKILL.md

name, description, triggers

name	description	triggers
browser-automation	Browser automation testing skill using Playwright + CDP. Provides L1 screenshot verification, L2 functional testing, and L3 E2E regression testing. Always uses Playwright's Chromium (not Snap) for stability. Supports semantic element定位 via Accessibility Tree / data-testid / text / CSS fallback.	测试一下 截图看看 验证一下 浏览器测试 E2E测试 自动化测试 打开.*搜索 截图.*页面 测试.*功能

Browser Automation Skill

基于 Playwright + CDP 的浏览器自动化测试能力。

核心原则

1. 永远用 Playwright 的 Chromium，不用 Snap 版（/snap/bin/chromium）— Snap 沙箱会阻塞 CDP 连接导致挂起
2. 元素定位优先级：AX Tree 语义 > data-testid > 文本 > CSS 选择器（兜底）
3. 不用图像识别定位（那是 PyAutoGUI 路线），用 DOM/AX Tree 语义定位
4. 遇到 visibility 为 0 但实际存在的元素，用 page.evaluate JS 直接操作 DOM 绕过

三级测试策略

级别	场景	工具	耗时
L1	"截图看看效果"	Playwright 截图	10-30s
L2	"验证某个功能"	Playwright 脚本 + 断言	1-2min
L3	"跑完整回归"	Playwright Test + spec 文件	3-5min

环境检查

# Playwright Chromium 位置（优先用较新版本）
~/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome
~/.cache/ms-playwright/chromium-1140/chrome-linux/chrome

# 启动参数必须包含：--no-sandbox

脚本位置

所有测试脚本放在：

/home/ubuntu/.nanobot/workspace/tests/

不污染 ~/nanocode 项目代码。

当前可用脚本

脚本	级别	用途
test_screenshot.py	L1	任意 URL 截图
test_navigate.py	L1	基础导航验证
test_baidu_search.py	L2	百度搜索（JS 绕过 visibility）
test_generic_search.py	L2	通用搜索测试框架

常见问题处理

问题：Playwright fill/click 报 "element not visible"

• 原因：某些网站（如百度）在 headless 模式下元素 CSS visibility 异常
• 解决：用 page.evaluate 直接 JS 操作 DOM

问题：页面加载后空白或验证弹窗

• 原因：反爬虫机制检测到自动化浏览器
• 解决：设置真实 UA、隐藏 navigator.webdriver、添加随机延迟

问题：超时

• 先检查目标 URL 是否可达：curl -sI URL
• 检查是否有弹窗/iframe 阻塞