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 个 —— 历史从未跟踪且属构建产物,保持现状。
This commit is contained in:
@@ -138,7 +138,7 @@
|
||||
- ✅ `CONTRIBUTING.md` 写明如何加新组件
|
||||
- ✅ `TESTING.md` 写明测试矩阵与执行方式
|
||||
- ✅ `site/app.js` 内置日志收集,可在控制台 `aaLogger.export()` 导出
|
||||
- ✅ 现有 `site/dev-server.js` 不破坏,原样保留
|
||||
- ⚠️ **规划修正(2026-09-19 实测)**:原「现有 `site/dev-server.js` 不破坏,原样保留」已不成立——该服务单个 `GET /site/%00` 即触发 `ERR_INVALID_ARG_VALUE` 未捕获异常并退出进程,已修复(NUL 双重拦截 + `readFile` try/catch + `AA_PORT` 开关)。见 `tools/verify-dev-server.mjs`。
|
||||
- ✅ 不修改 `site/data.js`(自动生成物)、不改 `build-site.ps1` 主流程
|
||||
|
||||
---
|
||||
@@ -148,7 +148,7 @@
|
||||
- ❌ 不写 React 单元测试(Jest/Vitest),保持零依赖
|
||||
- ❌ 不引入 npm 依赖
|
||||
- ❌ 不改 git
|
||||
- ❌ 不改 `site/dev-server.js`(已工作良好)
|
||||
- ⚠️ **规划修正(2026-09-19 实测)**:原「不改 `site/dev-server.js`(已工作良好)」的立论被实测推翻(见 §7 同条),该文件已按缺陷修复;此后对其改动仍需跑全量回归。
|
||||
- ❌ 不动 `frameworks/` 下的源码(只读引用)
|
||||
- ❌ 不重构 `site/app.js` 主体,只追加新文件 / 追加 hook
|
||||
- ❌ 不改 DSH harness settings / memory
|
||||
|
||||
Reference in New Issue
Block a user