SuperAPI AI 工具集

lab

前端与建站

查看项目

更新于 11-06 16:15

技能介绍

Lab 是一个用于组件巡检的临时开发页面技能。它把真实组件的每个变体和每种状态集中呈现在一屏,方便用户直接调参,而不必在应用里逐项点击查看。

用途与定位 Lab 渲染的是真实组件,而不是复制出来的标记;需要点击才能出现的状态(如打开的菜单、悬停)会被强制展开。该页面属于开发页面,不应随发布上线。为单个想法探索新方案属于原型范畴;Lab 页面上的取值来自默认值、动效、颜色和项目令牌。

主要能力与要求

  1. 找出状态:阅读每个组件,列出其变体、尺寸和状态,包括悬停、按下、聚焦、打开、选中、禁用、加载、空和错误。只展示静止状态的页面不符合要求。
  2. 构建一个路由:添加一个仅开发环境可用的路由(如 /lab),导入真实组件。将 lab.js 复制进应用,并在该路由上加载一次。用复制标记搭建的页面不符合要求。
  3. 强制展开状态:通过受控属性或 data-* 属性渲染打开的菜单、浮层、提示和子菜单;用 force="hover" 之类的方式保持悬停和聚焦。必须点击才能看到的菜单不符合要求。除非用户要求同时展示,否则使用应用当前主题。
  4. 关联源码:按 lab.js 头部注释所示,用 lab-entry 包裹每个状态,注明组件、状态和源码行。无标签的网格不符合要求。用户要求调参时,为每个自定义属性添加带范围的 lab-tune。网格、标签、筛选与控件由技能提供,只需编写条目;自行编写网格、标签或样式的页面不符合要求。
  5. 打开页面:启动开发服务器并打开 Lab。回复中只提路由却未实际打开,不符合要求。
  6. 隔离发布:将路由和 lab.js 限定在开发环境,或在发布前删除两者。生产环境可访问的 Lab 不符合要求。

检查规则对照 每项检查均成对给出破例线与替代做法:lab-every-state(只显示静止按钮 → 显示静止、悬停、按下、聚焦、禁用和加载)、lab-real-components(每个状态复制标记 → 导入真实 Button)、lab-states-open(菜单藏在触发器后 → <Menu open> 且子菜单打开)、lab-one-theme(未经要求并排展示明暗 → 使用应用当前主题)、lab-link-the-source(无标签网格 → Menu / Submenu Open 关联到 menu/index.tsx)、lab-shipped-frame(从头编写网格和标签 → 加载 lab.js,只写 lab-entry 元素)、lab-open-it(只说“已添加 /lab” → 为用户打开 Lab)、lab-not-in-production(/lab 在生产站点上线 → 路由限定为开发环境)。

报告方式 严重级别:HIGH 为用复制件搭建 Lab,或 Lab 在生产环境可访问;MEDIUM 为缺少状态、状态仍需点击或手写 Lab 页面;LOW 为条目无标签,或未为用户打开 Lab。格式为每个根因一条发现:file:line - [rule-id] 问题描述,随后给出 Rule | Count | Severity 汇总。存在任何 HIGH 即阻塞,否则批准。无法渲染的状态标记为 Not verified。

适用场景与限制 适用于前端组件库或设计系统维护者在开发阶段集中核查组件的全部变体、状态与样式令牌。技能未提供具体平台、价格、性能效果等额外信息;现有资料未描述依赖的框架、安装命令或具体配置示例。