SuperAPI AI 工具集

app-validation

测试与质量

查看项目

更新于 10-16 00:31

技能介绍

用途:本技能用于在浏览器中验证该模板应用的运行情况,需与 playwright-cli 技能配合使用;playwright-cli 只覆盖工具本身,本技能补充模板专属内容。应用只能在 Fabric 门户嵌入流程中测试,禁止直接对 localhost 测试。

主要能力与规则:所有 playwright-cli 调用使用 initial_wait: 1;首次打开 Fabric 门户嵌入(*.fabric.microsoft.com/...?devUri=...)需用 initial_wait: 30 一次,之后恢复为 1。始终跳过认证:在 run-code 中通过 sessionStorage.setItem 或 localStorage.setItem 注入令牌,并用 page.route() 模拟 API 响应后再 page.reload();真实 AAD 重定向(如 login.microsoftonline.com)不要点击登录或填写凭据,改用 --persistent 配置文件。除非用户明确要求,否则不截图,验证使用 snapshot(YAML 无障碍树)。

必需检查:UI 元素正确渲染且可见;文本符合无障碍标准;无来自应用的 console 错误(忽略 Fabric 门户噪声)。视觉一致性检查包括:关键布局容器有非零 padding 和 gap;图表背景与父卡片背景一致;柱形与弧形描边颜色匹配卡片背景;轴标签与数据标签颜色一致;分组/多系列柱状图不显示自动注入的数据标签;图表渲染高度健康(低于约 100px 可疑,低于约 50px 可能被压扁);独立图表区块使用确定高度;同一工具栏/筛选行中输入、选择、按钮控件的 fontSize、fontFamily、color 一致。验证运行中应包含 page.evaluate 样式检查与图表高度检查。

Fabric 门户嵌入测试:被测 URL 应为 .fabric.microsoft.com 且含 devUri=,应用以三层嵌套 iframe 渲染。可用 npm run test:fabric 运行 scripts/open-fabric-portal.mjs,它从 VITE_FABRIC_ 环境变量组合嵌入 URL 并启动命名持久会话:playwright-cli -s=fabric open --persistent --config=.playwright-config.json "<embed-url>"。需要 --persistent 配置文件(真实 AAD 登录无法模拟)、.playwright-config.json 的 Chromium 标志(禁用 BlockInsecurePrivateNetworkRequests / LocalNetworkAccessChecks)、以及 Vite localNetworkAccessPlugin。可用 run-code 片段定位 localhost:5173 帧,若 blockedByLNA 为 true 说明 Chromium 标志未生效。console 错误仅统计来源 URL 以 http://localhost:5173 开头的。

Spec 文件:按需与源文件同目录放置,src/lib/ 纯工具函数和 src/queries/ 查询工厂函数始终添加;hooks 与含非平凡逻辑的组件按需添加。不要为覆盖率目标创建 spec;测试不得用 mock 或硬编码数据代替真实查询结果;每个 spec 聚焦一个单元。

限制:资料未提供具体收费、价格、平台支持范围等信息。