ak-ui 质量检查清单

设计契约

• 能够明确识别所选的 accent、system 或 terminal 风格强度，且没有超出该强度。
• 优先复用现有 ak-ui 基础组件，再考虑创建相似的新组件。
• 重复的视觉决策使用公开 --ak-* Token。
• 保留用户品牌，或有意识地将品牌映射到语义角色。
• 样式按需启用，不重置应用中无关的元素。
• 没有复制或抓取游戏 Logo、截图、角色立绘、纹理、图标、音频或拆包素材。

层级与原创性

• 能立即识别主要操作或数值。
• 元信息支撑真实内容，没有添加装饰性噪声。
• 几何处理有明确目的，并非每条边都切角、倾斜或发光。
• 结果是独立的产品界面，而非某个具名界面的复刻。

行为与无障碍

• 保留语义／Headless 行为、ARIA、焦点约束、焦点返回和键盘控制。
• 键盘焦点可见，且不会被裁切。
• 选中、勾选、无效、警告、成功、禁用和加载状态不只依赖颜色表达。
• 浏览器缩放或内容密度较高时，文字和控件仍清晰可读。
• 动效尊重 prefers-reduced-motion。
• 适用的触控目标至少为 44 × 44 CSS 像素。

响应式与 Portal 行为

• 至少检查一个桌面视口和一个窄屏／移动视口。
• 检查水平溢出、标签裁切、操作重叠和缩放后不可读的布局。
• 为移动端重新组织沉浸式终端布局，而非直接缩小。
• 在实际 DOM 位置检查对话框、浮层、菜单、工具提示等 Portal 内容。

交互状态

验证与组件相关的状态：

• 默认、悬停、按压和键盘可见焦点。
• 打开和关闭。
• 选中、勾选、展开或当前项。
• 禁用和无效。
• 加载、空内容、长内容和错误状态。
• 浮层的 Escape 关闭、外部交互和焦点返回。

工程检查

• 运行项目相关的样式检查、类型检查、构建和测试。
• 检查浏览器控制台的警告与错误。
• 优先通过真实浏览器验证，不只依据源码推断。
• 无法使用视觉工具时，说明哪些检查仍需手动完成。
• 汇总所选接入路径、风格强度、品牌映射、验证结果和剩余限制。