4 Commits

Include renames

Author	SHA1	Message	Date
aurora-admin	f1fbfc2ddb	feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库 ... ## 品牌标识（本次会话） 起因：品牌此前没有任何图形标识 —— 唯一 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	eb25feedaf	feat(S6-P21): 组件族参数化(13族/44成员/导航族15文件同源/79→48概念组件) ... 【本次核心 · S6-P21】 - 族层数据：families.json + 44 份契约注入 family/familyRole/familyParams； data.json / data.js / site/details 同步。13 族 / 44 成员 / 35 独立 → 概念组件 79→48。 - 79 个 slug 全保留、集合逐一不变（铁律 5 对外承诺未破）；frameworks 仍 395 文件、薄壳仍 79。 - 归族判据为契约中可核对字段（semanticTypeCandidates 重叠 / anatomy 为同一骨架子集 / 变体维度同构 / doNotInvent 显式从属声明），每族 mergeBasis 写明依据，不按名字猜。 - 实现层合并（导航族端到端切片）：tools/gen-family-impl.mjs 从 5 端模板生成 TopMenu / SideMenu / MixedNavigation 共 15 文件，参数 direction=top|side|mixed； 三份 CSS md5 完全相同 = 一份样式表服务三个组件。 - 新增 tools/gen-families.mjs、tools/gen-family-impl.mjs、tools/verify-families.mjs、 tools/lib/family-model.mjs、tools/lib/family-impl/nav-menu/*.tpl。 【同时清掉此前已完成但未提交的批次】 生成物（data.json / data.js / site/sources / site/components 薄壳 / sitemap.xml / tests 报告） 跨阶段交织，无法拆成互相自洽的多个提交，故按既有批量风格合并提交： - Package：三端可 import（S5-P18）+ 发布到私有 npm 源 - Docs site：导航语言改下拉（S5-P19）、详情页代码块默认展开、中英切换完整性 - Security：生产部署链审计修复（2026-09-19）+ 线上部署 - Theme modes 日间/夜间/自动；S1-P4 data.js 瘦身；S2-P5 暗色；S2-P6 跨端一致性； S2-P7 行为断言；S2-P9 FAQ；S3-P8 RTL；S3-P9 契约缺口解释层；S4-P12 发布流程 - 补入 tools/pack-deploy.mjs、run-site-smoke.mjs、verify-*.mjs，.dockerignore、 安全审计修复与待决策项.md 【验收】 - node tools/verify-families.mjs → OK: 族层端到端一致（13 族 / 44 成员 / 79 组件不变 / 395 文件不变） - node tools/verify-cross-platform.mjs → 79/79 identical（HEAD 基线 high 44） - node tools/run-regression.mjs → 100%（79/79 页，1017/1017 断言，N/A 34），连跑 8 次一致，0 超时 - 逐页实测：topmenu / sidemenu / mixednavigation 各 13/13，帧内 direction 参数正确，0 JS 错误 - 零运行时依赖 OK；build-site.ps1 ASCII-only OK 【未纳入】site/components/<slug>/ 平台薄壳 316 个 —— 历史从未跟踪且属构建产物，保持现状。	2026-09-20 03:32:31 +08:00
aurora-admin	c65a69c34e	feat(P4): precompute移植+app.js sources双向回填+回归1003/1003+验收体积/文件/data.json	2026-09-12 14:18:41 +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