feat(S2-P9+S4-P12): FAQ页240条聚合+发布流程release.mjs

P9: #/faq 路由+renderFaq(details批量懒加载每批10个)+顶栏/侧边栏双入口
    +guide-h3样式+9条i18n英文;浏览器实测240条/搜索宽度11条/0 JS错误。
    规划偏差:契约已在P4-D移出data.js,FAQ走details懒加载。
P12: tools/release.mjs(检查+bump双模式,只做本地准备不自动push/tag)
    +CONTRIBUTING发布5步+版本号规则;检查模式实测版本一致通过。
回归零影响:report.json 79/79、data.json未动。
This commit is contained in:
aurora-admin
2026-09-14 03:28:46 +08:00
parent 32292c01f8
commit f73ed394f4
8 changed files with 284 additions and 3 deletions
+9
View File
@@ -4,6 +4,15 @@
## [Unreleased]
### S2-P9 · FAQ 页(details 懒加载版)
- 新增 `#/faq` 页:自动聚合 79 组件契约的 unknowns(139)+ doNotInvent(101),共 240 条;按组件分组 + 关键词搜索过滤 + 命中统计;顶栏/侧边栏双入口;9 条 i18n 英文。
- 浏览器实测:groups 80/items 240,搜索“宽度”命中 11 条/11 组,清空恢复 240,0 JS 错误。
- 规划偏差:契约已在 P4 阶段 D 移出 `data.js`,FAQ 改走 `details/*.json` 批量懒加载(每批 10 个)而非直接消费 `data.js`。
### S4-P12 · 版本发布流程
- 新增 `tools/release.mjs`:检查模式(package.json vs CHANGELOG 版本一致性 + Unreleased 提醒)与 `--bump major|minor|patch --date` 提升模式;只做本地准备,tag/push 由人执行。
- `CONTRIBUTING.md` 新增发布流程 5 步 + 版本号规则(major/minor/patch 判定)。
### S2-P6 · 跨端一致性自动验证(方案 B:静态结构比对)
- 新增 `tools/verify-cross-platform.mjs`(零依赖零联网):79 组件 × 4 端(H5/React/Vue2/Vue3)class 集合 + 结构骨架双 diff,演示包装类/变量名/模板残留降噪,high/medium/low 分级;产出 `tests/cross-platform-report.json`(79 条全量 + samples 3)。
- 实测:完全一致 2,有差异 77(high 44/medium 22/low 11)。high 主因:React 端 `is-disabled/is-active` 缺失、H5 演示页缺框架端结构类、Tag/Select/Input 变体类缺失——已追加为 ROADMAP 的 S2-P6-F1~F4,不在本任务内修。