用途:通过 MCP 驱动真实浏览器,验证 UI 改动是否按预期生效。它自动检测可用的浏览器 MCP(优先 chrome-devtools,回退 playwright);若两者都不可用则停止并提示用户安装。开始时会说明所用 MCP。
工作流程: 1)准备:与用户确认开发服务器 URL(检测到 Next.js/Vite 项目时默认 http://localhost:3000,否则询问);若开发服务器未运行,请用户自行启动,不自动启动;通过检测到的 MCP 打开页面。 2)采集基线:截取改动前截图并记录控制台初始状态;若用户指定元素或组件,可通过 DOM 快照做元素范围截图。 3)执行交互:询问用户要验证哪些交互,并通过 MCP 执行点击、填写、悬停、按键、调整页面尺寸等操作,等待动画或网络请求稳定。 4)采集改动后状态:截取后截图,通过 list_console_messages 和 list_network_requests 采集控制台消息与网络错误;如可用,用 lighthouse_audit 做无障碍审计。 5)报告:按结构输出 MCP、URL、已执行交互、前后截图、控制台错误与警告数、网络失败与慢请求数、无障碍分数与严重问题,并给出 PASS/FAIL 结论。
规则:验证期间只读,绝不修改文件;结束时始终关闭浏览器页面以释放资源;即使 PASS 也要采集控制台消息。
错误处理:无可用 MCP 时停止并给出安装提示;开发服务器不可达时请用户确认 URL 并启动服务;导航超时(超过 30 秒)时报告并停止;流程中出现 MCP 工具错误时报告失败步骤,尝试清理并停止。
选择:chrome-devtools 支持 DevTools 专有能力(如 lighthouse 审计、网络限速、性能分析、内存快照);playwright 适合跨浏览器测试或已有 Playwright 环境的场景。