# Aurora Admin Design System

> Aurora Admin 是一套 B 端后台管理设计系统：79 个组件 × 5 端实现（H5 / React / Vue 2 / Vue 3 / CSS），品牌主色 #2F54EB，桌面端优先（最小宽度 1280px），所有色值取自 au-* CSS 变量令牌，零运行时依赖。

## 机器可读数据（Agent 优先消费这些，无需解析 HTML）

- [site/data.json](data.json)：全量数据单文件——meta（版本/品牌/计数）+ 六大分类 + 全部设计令牌 + 79 个组件（规格摘要、5 端文件路径、API 提炼、核心契约）。
- [.design_library/aurora-admin/components/index.json](../.design_library/aurora-admin/components/index.json)：组件 ↔ 规格批次 ↔ 实现文件的权威映射（schemaVersion 3）。
- [.design_library/aurora-admin/css.json](../.design_library/aurora-admin/css.json)：设计令牌结构化 JSON（颜色/字体/间距/圆角/阴影/控件高度）。
- [.design_library/aurora-admin/components.css](../.design_library/aurora-admin/components.css)：全部组件样式单文件聚合。
- [.design_library/aurora-admin/colors_and_type.css](../.design_library/aurora-admin/colors_and_type.css)：CSS 变量令牌源文件。

## 核心组件契约（button / input / select / table / card / modal）

- [button](../.design_library/aurora-admin/components/button.json)
- [input](../.design_library/aurora-admin/components/input.json)
- [select](../.design_library/aurora-admin/components/select.json)
- [table](../.design_library/aurora-admin/components/table.json)
- [card](../.design_library/aurora-admin/components/card.json)
- [modal](../.design_library/aurora-admin/components/modal.json)

## 文档站页面

- [首页](./#/): 产品概览、核心能力、快速入口
- [组件总览](./#/overview): 79 个组件的分类总览与实时预览
- [快速开始](./#/guide): 令牌引入、按端取用组件、目录与命名约定
- [设计规范](./#/design): 色彩 / 字体 / 间距 / 圆角 / 阴影 / 控件高度
- [For Agents](./#/agents): Agent 消费资源清单、data.json 数据形状、使用规则
- [更新日志](./#/changelog): SemVer 版本记录（与 CHANGELOG.md 同源）

## Agent 使用规则（生成 UI 前必读）

1. 不发明：组件变体不得超出契约 dims 声明的维度与取值；扩展组件以 specLines 规格原文为准。
2. 不硬编码颜色：所有色值取自 tokens 中的 au-* 变量；语义色（成功/警告/错误/信息）独立于品牌蓝。
3. 尊重未明示：契约 unknowns 列出的项规格未定义，生成前向用户澄清而非假设。
4. 文案规范：按钮用动词短语（新建/编辑/删除/提交），错误反馈给出具体字段与修正方向，不使用 emoji。
5. 测试基准：tests/<slug>.html 的断言结果标注 data-assert / data-status，可机读回归。
