SuperAPI AI 工具集

verifying-in-browser

测试与质量

查看项目

更新于 10-16 02:08

技能介绍

用途

该技能的核心用途是:在做出代码改动后,主动在浏览器中验证应用是否真的能正常工作,而不是仅凭代码看起来正确就下结论。它强调“启动它并检查”,即通过实际运行来确认结果。

主要能力

该技能覆盖以下验证环节:

  • 启动开发服务器:先通过列出终端检查是否已有服务器在运行;若没有,则运行 npm run dev,并设置 block_until_ms: 0 让其在后台运行,然后轮询直到看到带有 localhost URL 的“ready”消息。
  • 在侧边浏览器中打开应用:使用 browser_navigate 工具,参数为 { "url": "http://localhost:3000", "position": "side", "take_screenshot_afterwards": true },将应用打开在代码旁边。
  • 快速健康检查:执行三项检查——控制台错误(使用 browser_console_messages,标记任何错误,弃用警告可记录但不算阻塞项)、网络失败(使用 browser_network_requests,标记任何 4xx/5xx 响应、失败的 fetch 或 CORS 错误)、视觉检查(查看截图,确认页面是否渲染、布局是否正确、是否存在空白屏幕或永不结束的加载转圈)。
  • 导航到改动页面:如果改动位于特定路由,则导航到该路由并重复上述检查。
  • 测试交互:如果改动了表单、按钮或交互元素,先使用 browser_snapshot 获取元素引用,再对改动元素执行点击、填写或悬停,然后再次截图验证结果。
  • 报告结论:向用户说明“已在浏览器中验证——页面渲染正确,无控制台错误,所有网络请求健康”,或“发现问题:[问题列表]”。

使用方式

该技能以步骤化流程使用:先启动或确认开发服务器,再在侧边浏览器打开应用,然后依次进行控制台、网络和视觉检查,必要时导航到改动路由并测试交互,最后给出验证结论。

适用场景

  • 修改任何 React 组件、CSS 或布局代码之后
  • 修改 API 路由或数据获取之后
  • 更新环境变量或配置之后
  • 安装或移除依赖之后
  • 提交之前,作为最终的健康检查

限制与注意事项

  • 使用 position: "side" 可以同时看到代码和浏览器。
  • 如果开发服务器已经在运行,跳过第一步,直接进行导航。
  • 对于 SSR 应用,需要同时检查初始服务端渲染的 HTML 和客户端水合后的状态。
  • 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。