SuperAPI AI 工具集

ui-mock-fidelity

通用与其它

查看项目

更新于 10-15 16:44

技能介绍

用途:这是一套 UI mock 忠实性核对机制,目标是让已批准的 mock 与 UI 实装在视觉上完全一致,而非「近似」。触发场景包括新建 UI 面、re-skin、视觉重构。仅对已有或应有批准 mock 的工作生效;已实装的一行文案修改、padding/margin 微调、bug 修复等不在范围内。

主要能力与规则:

  1. 固定单一权威 mock:UI 派发必须 pin 已批准 mock,用文件名或 hash 等唯一标识,禁用「方案A」这类易冲突的模糊标签。
  2. 数值规格抽取:从 mock 抽取坐标、尺寸、比例、色值 hex、字体(种类/weight/size/字距)、留白等数值表并直接移植,禁止「凭感觉靠近」。若 mock 本身是 HTML/CSS,则 1:1 移植真实源码值。
  3. 完成报告必须附 render 与 mock 对照的 overlay / pixel-diff。web(React)用 Playwright 截图一致即可;native/plugin 需数值一致 + pixel-diff + 明示容差 + 不可复现点 flag,且 flag 只能用于引擎层面(如次像素抗锯齿、hinting),字体未内嵌、尺寸坐标概算等可修复项不能 flag。
  4. 双重 gate:同侪附 diff,conductor 实际比对 mock 后才放行,仅接受「无法分辨」,「接近」一律驳回。
  5. mock 卫生:固定 mock 应使用可随包分发的资产,避免 Helvetica Neue 等不可内嵌的系统或专有字体。

限制与校准:例外须明确列出、只增不改;该机制主要针对 native/plugin UI,web UI(React)适用性较弱。忠实性 gate 不等同于审美 gate,两者是不同层级。