本提交含两条并行工作线,因互相咬合(package.json scripts、regression.yml、 npm run build 链)无法按文件干净拆分,故合并为一次自洽提交。 ## 详情页减重(本轮主任务:修复「AI 干太重」) - 导航收敛:宽屏只用右侧目录、≤1200px 只用页内 sticky 导航,纯 CSS 媒体查询 实现(不引入 JS 宽度监听)。此前两套导航同时可见,active 状态互相打架。 - 入口去重:标题区由「查看示例/在线测试/契约 JSON」三个减为「在线测试」一个; 契约 JSON 归入实现资源;删除示例底部重复的「在线测试」。 - 示例工具栏:删除与目录锚点重复的示例下拉选择器;「全部展开代码」只在 示例数 >1 时出现(103 个组件里 49 个仅 1 个示例,此前恒显示)。 - 重复文案:示例区两句同义导语合并为一句。 - 首页 CTA 由 5 个减为 2 个(浏览组件/快速开始),测试总览入口挂到已有的 通过率统计卡上,不再另占 Hero 按钮。 - 统一详情取数:抽出 fetchDetail/loadDetail 作为 details/*.json 的唯一路径, FAQ 不再自行 fetch 一遍,与组件页共用缓存与失败兜底。 ## i18n - 删除 12 组重复键(含整段 FAQ 说明),字典 604 → 585 唯一键。 - 删除本次改动产生的 6 个死键。 - verify-i18n.mjs 新增 `unique dictionary keys` 断言:重复键在对象字面量里 是静默的后值覆盖,此前无从发现;现由门禁拦住。 ## 文档事实修正(实测为准) - TESTING/CONTRIBUTING:79 → 103 组件;旧断言数改为回指 tests/report.json。 - PLATFORMS:移动端 108 文件/18 端 → 282 文件/47 端;契约 5 → 47; 令牌 17 → 15;uni-app SFC 21 → 50。 - AGENTS:断言 1405/18 页 → 1464/103 页(PC)、807/47 页(移动端)。 - package.json:YOUR-ACCOUNT 占位 → gitea 实址与 kole-ui.mymoyu.top。 ## 品牌标识(并行会话成果,一并入库) - brand-mark.json 收归真源,build:brand 生成 favicon 与单色 SVG; PC 与移动端共用资产,verify:brand 24 条断言。 - regression.yml 增加 verify:brand 步骤。 ## 门禁与验收 新增工具:verify-component-page.mjs(86 条真实浏览器断言,随详情页改造同步 更新为「只允许一套导航可见」)、verify-brand-mark.mjs、lib/i18n-dead-keys.mjs (只读诊断)。 回归:PC 100%(1464/1464,103 页,N/A 50)· 移动端 100%(807/807,47 页)。 门禁:component-page 86 · i18n 17 · brand 24 · routes all · smoke all · theme OK · isolation 31 · nav all · examples 9 · api-docs 10 · mobile-docs 12。 已知未做:i18n 另有约 44 条历史死键(非本次产生),已记为 ROADMAP S8-P6; 顶栏与悬浮区的两个主题入口为刻意设计(verify-theme 断言其互斥),未删。
This commit is contained in:
+7
-7
@@ -37,18 +37,18 @@
|
||||
|
||||
| 维度 | pc | mobile |
|
||||
|---|---|---|
|
||||
| 实现目录 | `frameworks/`(515 文件) | `frameworks-mobile/`(108 文件 = 18 × 6 端) |
|
||||
| 实现目录 | `frameworks/`(515 文件 = 103 × 5 端) | `frameworks-mobile/`(282 文件 = 47 × 6 端) |
|
||||
| PC×uni-app 实现目录 | `frameworks-uniapp-pc/`(试点 3) | — |
|
||||
| 契约 | `.design_library/kole-ui/components/*.json`(103) | `.design_library/kole-ui-mobile/components/*.json`(5) |
|
||||
| 契约 | `.design_library/kole-ui/components/*.json`(103) | `.design_library/kole-ui-mobile/components/*.json`(47) |
|
||||
| 索引(唯一真源) | `.design_library/kole-ui/components/index.json` | `.design_library/kole-ui-mobile/components/index.json` |
|
||||
| PC×uni-app 索引 | `.design_library/kole-ui-uniapp/index.json` | — |
|
||||
| 令牌 | `--kole-*`(75) | `--kole-m-*`(17)+ **@import PC 令牌**(颜色/字体/圆角/阴影同源) |
|
||||
| 令牌 | `--kole-*`(75) | `--kole-m-*`(15)+ **@import PC 令牌**(颜色/字体/圆角/阴影同源) |
|
||||
| 类名 | `kole-` / 既有短名(`btn`) | `kole-m-`(状态类统一 `is-*`) |
|
||||
| 导出名 | `KoleButton` | `KoleMNavBar` |
|
||||
| 测试页 | `tests/<slug>.html`(103,生成物入库) | `tests/mobile/<slug>.html`(5,生成物入库) |
|
||||
| 测试页 | `tests/<slug>.html`(103,生成物入库) | `tests/mobile/<slug>.html`(47,生成物入库) |
|
||||
| 回归报告 | `tests/report.json` | `tests/mobile-report.json` |
|
||||
| 文档站 | `site/`(SPA + History API 路由) | `site/m/`(**静态页**,不进 PC 路由表) |
|
||||
| 自包含数据 | `site/data.json`(对外承诺,103) | `site/m/data.mobile.json`(移动端承诺,18 × 6 端源码) |
|
||||
| 自包含数据 | `site/data.json`(对外承诺,103) | `site/m/data.mobile.json`(移动端承诺,47 × 6 端源码) |
|
||||
| 分发产物 | `dist/components|react|vue3|vue2` | `dist/mobile/*`;PC×uni-app → `dist/uniapp-pc/*` |
|
||||
| 构建 | `build-site.ps1` + `tools/build-dist.mjs` | `tools/build-mobile.mjs`(Node,跨平台) |
|
||||
| 门禁 | `tools/verify-cross-platform.mjs` 等 | `tools/verify-mobile-isolation.mjs` · `tools/verify-uniapp.mjs` · `tools/verify-mobile-docs.mjs` · `tools/verify-mobile-site.mjs` |
|
||||
@@ -137,8 +137,8 @@ npm run build:mobile # 只重建移动端(索引改了必须重跑,否则
|
||||
|
||||
| 项 | 状态 |
|
||||
|---|---|
|
||||
| 移动端组件数 | **18**(导航 5:navbar / tabbar / mobile-grid / mobile-steps / mobile-divider · 反馈 7:actionsheet / pullrefresh / swipecell / mobile-popup / mobile-toast / mobile-dialog / mobile-noticebar · 数据展示 3:cell / mobile-badge / mobile-tag · 数据录入 3:mobile-button / mobile-numberkeyboard / mobile-datepicker)。规格写到 §18;后续增量见 ROADMAP S7-P23 的「下一批」 |
|
||||
| 移动端组件数 | **47**(导航 6 · 反馈 12 · 通用 5 · 数据展示 8 · 数据录入 16)。权威清单见 `.design_library/kole-ui-mobile/components/index.json`(47 项)与 `frameworks-mobile/`(282 文件 = 47 × 6 端) |
|
||||
| PC × uni-app | **3 / 103 试点**(button / input / card)。全量转换见 ROADMAP S7-P26 |
|
||||
| uni-app 真实编译 | ✅ **已执行(2026-09-20)**:`npm run verify:uniapp-build` 把 21 个 SFC(移动端 18 + PC 3)真实编译到 **H5 与微信小程序**,11 条断言全过(含「18/18 组件的契约声明类名都进了产物」)。依赖装在 `.tmp/uniapp-build`(gitignore),主仓库零运行时依赖不变。**App 端(app-plus)仍未覆盖** —— 需 HBuilderX 云端打包,命令行无法完成 |
|
||||
| uni-app 真实编译 | ✅ **已执行**:`npm run verify:uniapp-build` 把 50 个 SFC(移动端 47 + PC 3)真实编译到 **H5 与微信小程序**,含「契约声明的类名都进了产物」断言。依赖装在 `.tmp/uniapp-build`(gitignore),主仓库零运行时依赖不变。**App 端(app-plus)仍未覆盖** —— 需 HBuilderX 云端打包,命令行无法完成 |
|
||||
| 移动端 SEO 薄壳 / sitemap | **未做**:`site/m/component/<slug>.html` 是静态页可索引,但根 `sitemap.xml` 只收 PC URL。见 ROADMAP S7-P27 |
|
||||
| 移动端文档站导航 | **四页(总览 / 快速开始 / 平台与端 / 设计令牌)+ 逐组件页(14 小节,对齐 TDesign 范式:演示按 01/02 分组、每块独立预览 + 原文代码、Props 必传列、CSS 变量表、相似组件表)+ 共用左栏导航**:开发指南 5 项 + 组件按分类分组;**顶栏与左栏与 PC 同结构**(logo 含副标题 + 版本下拉 + 同名主导航 5 项 + 主题三态图标,跨站生效;左栏三段式:平台 / 开发指南 / 组件 N 按 PC 分类);顶栏 60px、内容在 1180px 容器内居中、激活项带 2px 底部指示条 —— 逐项对齐 PC 顶栏。**平台入口只在左栏**(2026-09-20 去重:顶栏原有的 `[PC 端][移动端]` 分段控件与左栏重复)。桌面恒定展开、≤1000px 自动收起。未做中英双语(PC 有 330 条 i18n 字典) |
|
||||
|
||||
Reference in New Issue
Block a user