aurora-admin
ba3f3c53f9
被问到「这么多组件能保证不出错吗」——诚实回答是不能。改为四轮机器审计 + 实测，把「我检查过了」替换成可复现的数字，并修掉查出的一切真问题。 审计 1 · 契约保真度（358 条 usageHints 回规格原文核对） - 逐字命中 336 条（93.9%）；剩余 22 条经人工比对为同义改写（数值确在规格 别处），非发明 - 发现真实不一致：rate.json 选中星色仍写 #FAAD14，规格已在 v1.3.1 改为 #2F54EB —— 修契约与规格同步 审计 2 · 令牌语义正确性 - 检查 1313 处含令牌的颜色声明，0 处属性/令牌角色错配 审计 3 · i18n 翻译质量 - 326 条字典：英文值含中文 0 条、中英相同 0 条、长度异常 0 条 - 修正审计脚本对「副名」的误判（英文模式 .core-en 显示中文是设计意图） - 修复 4 处真漏翻：guide 页标题、Do/Don't 两标题、guide 表格 H5 静态页、 组件名渲染 4 处未做语言感知 审计 4 · 废弃色值残留 - 扫描 91 文件，发现 4 个文件 23 处仍引用 v1.3.1 前旧色值 - 最严重：css.json（For Agents 页宣称的结构化令牌源，机器读取方会拿到 过时颜色）已同步 10 处；README.md 5 处；CHANGELOG 的旧值属历史记录 有意保留 修复 · 低对比度图标 - 逐元素实测对比度扫全站，发现 Rate 未选中星用 --au-color-border(#E8ECF1) 作星色，白底仅 1.19:1 —— 边框色是装饰性色值，作图标不合格 - 新增 --au-color-icon-inactive #8F8F8F（白底 3.23:1，满足 WCAG 1.4.11） 令牌 74 → 75 - 同批扫出另 5 处经核实为禁用态（WCAG 1.4.3 豁免）或深色遮罩白字 （检测器把半透明底当白底），非缺陷 修复 · 回归偶发（第三次根治） - 现象：多次连跑偶发 99.9%，但单页打开总通过 - 根因：收集器 8 秒超时兜底直接记 fail:1；并发 4 个 iframe 抢主线程时 慢页面会撞超时 - 修法：阈值 8s→12s、超时后重试一次、超时与断言失败分开统计（timedOut 字段不计入通过率分母） - 验证：八次连跑全部 100% / 0 失败 / 79 页全通过 / 0 超时
Aurora Admin Design System
理性、高效、克制的 B 端中后台设计系统：79 个组件 × 5 端实现（H5 / React / Vue 2 / Vue 3 / CSS），品牌主色 #2F54EB，全部色值取自 au-* CSS 变量令牌，零运行时依赖。
在线入口
- 组件文档站：
site/index.html（GitHub Pages 部署后为仓库首页自动跳转） - For Agents / llms.txt：
site/llms.txt·site/data.json
目录结构
├─ index.html # Pages 入口（重定向到 site/）
├─ sitemap.xml # 站点地图（构建生成，部署后回填正式域名）
├─ site/ # 文档站（纯静态，无构建依赖）
│ ├─ index.html / app.js / style.css / data.js / data.json
│ ├─ components/<slug>.html # 每组件静态薄壳（SEO 可爬入口，构建生成）
│ ├─ scenario/user-management.html # 场景示范页（用户管理列表页）
│ └─ llms.txt
├─ frameworks/ # 79 组件 × 5 端实现源码（只读引用）
├─ tests/ # 79 个组件测试页 + 回归报告 report.json
├─ tools/run-regression.mjs # Playwright 回归 runner（CI 用）
└─ .design_library/aurora-admin/
├─ components/index.json # 组件 ↔ 规格 ↔ 实现权威映射
├─ components/<slug>.json # 设计契约（21 个：6 核心 + 15 输入类第一批）
├─ colors_and_type.css # 设计令牌（au-* + legacy 双命名）
└─ components.css # 聚合组件样式
快速使用
<link rel="stylesheet" href=".design_library/aurora-admin/colors_and_type.css">
<link rel="stylesheet" href=".design_library/aurora-admin/components.css">
按端取用组件源码：frameworks/<Prefix>.{html,css,jsx,vue2.vue,vue3.vue}。
本地开发
node site/dev-server.js # http://127.0.0.1:3311/site/
powershell -File build-site.ps1 # 重建 data.js / 薄壳 / sitemap（重建后浏览器 Ctrl+F5）
powershell -File run-tests.ps1 # 重新生成 79 个测试页
node tools/run-regression.mjs # headless 回归（需 npm i playwright）
部署（GitHub Pages）
- GitHub 新建仓库（Public）。
git remote add origin git@github.com:<account>/aurora-admin.git && git push -u origin main。- 仓库 Settings → Pages → Source 选 GitHub Actions；推送后
.github/workflows/deploy-pages.yml自动部署整仓。 - 回填正式域名：
build-site.ps1中$SiteUrlBase改为https://<account>.github.io/aurora-admin/，重跑构建后推送。
设计契约与 Agent 消费
- 组件契约（变体维度 / 使用要点 / 不发明 / 未明示）：
.design_library/aurora-admin/components/*.json - 文档站
#/agents页汇总全部机器可读资源与使用规则 - 生成 UI 时：色值只取令牌，变体不超出契约
dims，unknowns项先澄清再生成
版本
见 CHANGELOG.md。当前 v1.2.0。