admin-theme-consistency

name	admin-theme-consistency
description	MallBase Vben Admin 主题一致性规则；开发后台页面、组件样式或明暗色适配时使用。

Vben 规则：Admin 主题一致性（明暗色）

适用范围

frontend/admin/apps/web-antd 后台页面、表单、弹窗、上传与富文本相关 UI。

强制规则

1. 禁止写死浅色背景（如 #fff、#f5f5f5）作为页面主容器颜色。
2. 优先使用主题变量：hsl(var(--background))、hsl(var(--card))、hsl(var(--popover))、hsl(var(--border))、hsl(var(--foreground))。
3. 组件样式改动必须同时验证浅色和深色模式，不允许只修一种主题。
4. 富文本、上传预览、表单校验提示等“嵌入式区域”必须跟随主题，不允许出现白底刺眼块。
5. 若第三方组件默认样式不跟随主题，必须通过受控容器 class 或 CSS 变量桥接，不直接全局粗暴覆盖。

推荐做法

1. 页面容器使用统一语义 class（例如 theme-surface）承接主题变量，避免每页重复写样式。
2. 状态色（成功/警告/错误）优先走设计系统 token，不自行定义一套颜色。
3. 深色模式下，边框优先提升对比度而非提升纯亮度，避免发灰与发白。

自检清单

• 深色模式下无明显白底区域（页面、卡片、弹窗、上传区、编辑器）。
• 表单输入、错误提示、禁用态在浅色和深色都可读。
• 上传组件（图片/视频/文件）列表与预览区域跟随主题。
• 改动后至少手动检查 2 个典型页面（如商品编辑、设置表单）。