aurora-admin
6fec4ba6f8
回归通过率此前不可信：run-tests.ps1 抽取演示页 body 时剥离全部 <script>， 而 79 个 H5 演示页的 DOM 全由内联脚本渲染，且测试页从未引用 frameworks/<组件>.css —— 断言跑在空 DOM + 无组件样式上，v1.2.0 的 75.1% 属结构性误报。 Fixed — 验收链路 - 测试页改为 iframe 加载真实演示页（_template.html），_runtime.js 跨帧在真实 渲染结果上断言：帧内 getComputedStyle/styleSheets/outerHTML，用例自动标注 + 帧内描边，结果 postMessage 上报 - 标注改为容器下钻（.row/.demo-block → 首个含 ≥2 有效子元素的容器，最多 6 层） - 新增 N/A 语义：静态组件键盘/ARIA 记 skip 而非失败；对比度与 token 检查限定 在被测组件区，页头文档文字不计 - 通过率分母改为 pass/(pass+fail)，tools/run-regression.mjs 与收集器同口径 Added — 设计系统 - 基座 :focus-visible 统一焦点环（colors_and_type.css）。--au-color-focus-ring 此前只定义未消费，79 个组件样式仅 20 个自带 focus 规则 —— 一次性消除 66 页失败 - tests/_collect.html：零依赖浏览器批量回归收集器（并发 iframe + 汇总） - tests/_index_template.html：测试总览页模板外置，读数来自 data.json Added — 契约第二批（展示类 15 个） - tree/collapse/calendar/carousel/imagepreview/qrcode/countdown/watermark/ cardlist/treetable/timelinelist/steplist/chartpanel/dashboardcard/employeecard - 逐份从规格原文（组件2/4/7/9.txt）提炼，含 dims/variants/anatomy/structure/ usageHints/doNotInvent/unknowns；契约化 21 → 36/79 Changed - run-tests.ps1 重写：删除失效的快照抽取（占位符替换早已不匹配模板），改生成 iframe 版测试页；输出 WriteAllText 无 BOM；保持 ASCII-only，中文移入 UTF-8 模板 - 回归基线：960 断言 / 794 通过 / 85.1% / 11 页全通过 / N/A 27 - CHANGELOG/TESTING/改造清单同步；测试总览页与首页通过率联动 验证：浏览器全量 79 页收集器跑通两次，基线一致；详情页契约章节 （含 doNotInvent/unknowns）、chip、首页「通过率 85.1%」、changelog v1.3.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。