ui-validator

name	ui-validator
description	任何可见 UI 改动、交互变更、样式修复、响应式适配、暗色模式适配和浏览器侧回归验证都应使用。它负责在真实页面中验证实际渲染效果，而不是只看代码。用户提到 UI validate、screenshot、browser check、responsive、dark mode、视觉回归时都应触发。
metadata	{"internal":true}

UI Validator

铁律：没有真实渲染证据，就不能宣布 UI 改动完成。

工作流

• Step 1: 开发环境自检 ⚠️ REQUIRED
  • 1.1 先确认目标服务是否已启动，避免重复拉起开发服务器。
  • 1.2 明确要访问的页面、组件演示路径或交互入口。
• Step 2: 执行浏览器验证 ⚠️ REQUIRED
  • 2.1 至少检查默认主题和暗色模式。
  • 2.2 必要时检查移动端与桌面端视口。
  • 2.3 对关键交互执行点击、悬停、输入或状态切换。
• Step 3: 留证据
  • 3.1 优先使用截图、可访问性快照或计算样式值作为证据。
  • 3.2 记录问题发生条件，而不是只说“样式不对”。
• Step 4: 回归结论
  • 4.1 明确哪些场景通过、哪些仍有问题。
  • 4.2 如果发现回归，反馈到前端实现阶段处理。

重点检查

• light / dark 模式。
• desktop / mobile 布局。
• 关键交互状态。
• 对比度、间距、圆角、层级、溢出和禁用态。

反模式

• 不开页面，只读代码就宣布 UI 正常。
• 只看一张截图，不验证交互状态。
• 不说明问题发生条件和视口尺寸。

交付前检查

• 已在真实页面验证关键场景。
• 已留截图、快照或样式值证据。
• 已覆盖至少两种主题或关键视口。
• 结论中明确了通过项与残余问题。