aurora-admin

25 Commits 2 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
aurora-admin	f1fbfc2ddb	feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库 Regression / regression (push) Canceled after 0s Details ## 品牌标识（本次会话）起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」，那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」，移动端站已是「K」；移动端文档站则完全没有 favicon）。 - 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边；描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」 - 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）；顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)） - 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg） - 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留） - 移动端 7 个模板补 favicon（此前计数 0）验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/ theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致；两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。 ## 并行会话成果（本次一并入库） - 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具 + IconPreview 预览页 + ICON-SPEC.md 冻结规格 - 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁 - PC 组件：103 个大后台组件 / 组件11 批次 - uni-app：PC 端试点 + 移动端端实现 + 真实编译验证 ## 工程 - .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库） - CHANGELOG 补品牌标识条目 - ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）	2026-09-21 10:05:48 +08:00
aurora-admin	16f365a045	feat: P4 阶段A+B — data.js 瘦身 116KB（预计算 + css 分离）执行 ROADMAP 的 S1-P4，按规划的三阶段走，本次完成 A 与 B。阶段 A · 预计算 scenarios（验证「构建期预计算 + 运行时回退」链路） - tools/precompute.mjs：与 app.js 的 extractScenarios 逻辑完全一致，构建期算出结果写进 data.components[].scenarios - app.js 加快速路径：优先读 c.scenarios，缺失时回退运行时解析 - 浏览器实测：预计算值与运行时提取值完全一致（逐字节比对） - 实测收益有限：仅 4 个组件有 ≥2 场景（场景卡片本就少见），但链路验证通过，为阶段 C 的 API 预计算铺路阶段 B · css 源码分离（零风险，css 不参与任何解析） - css 从 data.js 移到 site/sources/<slug>/css.txt（79 个文件） - data.js 里改为 sourcesRef.css 引用，data.json 保持完整（For Agents 承诺） - data.js: 1058 KB → 942 KB（−116 KB） - app.js 新增 srcOf(c, kind) / hasSrc(c, kind)： · srcOf 同步返回已有源码，缺失时触发后台 fetch 并缓存 · __aaSrcReady 回调在加载完成后填充代码区 - 修正回调时机 bug：原实现捕获构建时的 current（初始 tab），导致用户后续切换的 tab 收不到通知。改为回调内实时比对当前 tab 关于 P4 的实测修正（已登记 ROADMAP 规划修正记录） - 规划估计「拆 sources → ~110KB」。实测 css 仅占 119KB/888KB，且 html/vue2/vue3/jsx 共 765KB 被渲染期同步消费（extractComponentAPI 读 vue3/vue2/jsx，extractScenarios 读 html） - 故需分阶段：A+B 先减 116KB，阶段 C 需先预计算 API 表才能分离其余 4 端新增构建链（两步，不可省第二步） - npm run build:site = build-site.ps1 + precompute.mjs - build-site.ps1 会把 data.js 重写回全量，precompute 才做瘦身 - 已写入 AGENTS.md 的铁律章节（含「只跑第一步会怎样」的后果说明）验证 - 回归 100%：1003/1003，79 页全通过，N/A 35 - 浏览器实测：展开代码区 → CSS tab → 2121 字符正常显示， Network 出现 sources/button/css.txt 请求 - 预计算 vs 运行时场景提取结果逐字节一致	2026-09-11 23:23:08 +08:00

Author

SHA1

Message

Date

aurora-admin

f1fbfc2ddb

feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库

Regression / regression (push) Canceled after 0s

Details

## 品牌标识（本次会话）

起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」，
那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」，
移动端站已是「K」；移动端文档站则完全没有 favicon）。

- 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边；
  描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」
- 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）；
  顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)）
- 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg）
- 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留）
- 移动端 7 个模板补 favicon（此前计数 0）

验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/
theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致；
两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。

## 并行会话成果（本次一并入库）

- 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具
  + IconPreview 预览页 + ICON-SPEC.md 冻结规格
- 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁
- PC 组件：103 个大后台组件 / 组件11 批次
- uni-app：PC 端试点 + 移动端端实现 + 真实编译验证

## 工程

- .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库）
- CHANGELOG 补品牌标识条目
- ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）

2026-09-21 10:05:48 +08:00

aurora-admin

16f365a045

feat: P4 阶段A+B — data.js 瘦身 116KB（预计算 + css 分离）

执行 ROADMAP 的 S1-P4，按规划的三阶段走，本次完成 A 与 B。

阶段 A · 预计算 scenarios（验证「构建期预计算 + 运行时回退」链路）
- tools/precompute.mjs：与 app.js 的 extractScenarios 逻辑完全一致，
  构建期算出结果写进 data.components[].scenarios
- app.js 加快速路径：优先读 c.scenarios，缺失时回退运行时解析
- 浏览器实测：预计算值与运行时提取值**完全一致**（逐字节比对）
- 实测收益有限：仅 4 个组件有 ≥2 场景（场景卡片本就少见），
  但链路验证通过，为阶段 C 的 API 预计算铺路

阶段 B · css 源码分离（零风险，css 不参与任何解析）
- css 从 data.js 移到 site/sources/<slug>/css.txt（79 个文件）
- data.js 里改为 sourcesRef.css 引用，data.json 保持完整（For Agents 承诺）
- data.js: 1058 KB → 942 KB（−116 KB）
- app.js 新增 srcOf(c, kind) / hasSrc(c, kind)：
  · srcOf 同步返回已有源码，缺失时触发后台 fetch 并缓存
  · __aaSrcReady 回调在加载完成后填充代码区
- 修正回调时机 bug：原实现捕获构建时的 current（初始 tab），
  导致用户后续切换的 tab 收不到通知。改为回调内实时比对当前 tab

关于 P4 的实测修正（已登记 ROADMAP 规划修正记录）
- 规划估计「拆 sources → ~110KB」。实测 css 仅占 119KB/888KB，
  且 html/vue2/vue3/jsx 共 765KB 被**渲染期同步消费**
  （extractComponentAPI 读 vue3/vue2/jsx，extractScenarios 读 html）
- 故需分阶段：A+B 先减 116KB，阶段 C 需先预计算 API 表才能分离其余 4 端

新增构建链（两步，不可省第二步）
- npm run build:site = build-site.ps1 + precompute.mjs
- build-site.ps1 会把 data.js 重写回全量，precompute 才做瘦身
- 已写入 AGENTS.md 的铁律章节（含「只跑第一步会怎样」的后果说明）

验证
- 回归 100%：1003/1003，79 页全通过，N/A 35
- 浏览器实测：展开代码区 → CSS tab → 2121 字符正常显示，
  Network 出现 sources/button/css.txt 请求
- 预计算 vs 运行时场景提取结果逐字节一致

2026-09-11 23:23:08 +08:00