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
+27 -2
View File
@@ -884,6 +884,19 @@ data OK
**失败判据**:条目数少于 139/101,或页面空白。
**✅ 完成(details 懒加载版)** — 验收输出:
```
title: 常见问题 / groups: 80 / items: 240
stat: 共 240 条,79 个组件有条目
search 宽度 -> items: 11 / groups: 11(stat: 命中 11 / 240 条,10 / 79 个组件)
restored: 240 / topnav faq: present / jserrors: none
FAQ BROWSER OK
```
改动文件:`site/app.js`(renderFaq + `#/faq` 路由 + 侧边栏入口)、`site/index.html`(顶栏入口)、`site/style.css`(guide-h3)、`site/i18n.js`(9 条英文)。
规划偏差:契约已在 P4 阶段 D 移出 `data.js`(`site/data.js` 含 unknowns 0 条),故 FAQ 改走 `details/*.json` 批量懒加载(每批 10 个)而非规划写的“直接消费 data.js”。`data.json` 的 139/101 计数仍作为数据源完整性断言。
---
### S4-P10 · Figma 资源 | 预算 ~2 天 | 优先级 P2
@@ -965,6 +978,18 @@ figma export OK
1. `tools/release.mjs`:从 CHANGELOG 提取版本 → 更新 `package.json` → 打 tag → 提示推送。
2. 文档化到 `CONTRIBUTING.md`。
**✅ 完成** — 验收输出:
```
package.json: 1.4.1 / CHANGELOG 最新: [1.4.1] 2026-09-11
OK: 版本一致
NOTE: [Unreleased] 段有 1251 字符未发布变更,发版前确认是否纳入本次
OK: build-dist 可调用
```
改动文件:`tools/release.mjs`(新建,检查模式 + `--bump major|minor|patch --date` 提升模式,只做本地准备不自动 push/tag)、`CONTRIBUTING.md`(发布流程 5 步 + 版本号规则)。
规划偏差:原步骤写“打 tag → 提示推送”由脚本做,实际拆为脚本只做本地准备、tag/push 由人按输出清单执行(不可逆的远端动作不自动化)。
---
## 四 · 显式不做(及理由)
@@ -1038,10 +1063,10 @@ figma export OK
| P6 | 跨端一致性验证 | S2 | **P0** | 1 d | P3 | ✅ **已完成**(静态结构比对 79/79,high 44/medium 22/low 11,F1-F4 已追加) |
| P7 | 行为断言 | S2 | P1 | 1.5 d | — | 🟢 可开工(优先级低于 P2-P4) |
| P8 | RTL | S3 | P1 | 2 d | P5 | ⚪ 待 P5 |
| P9 | FAQ 页 | S3 | P2 | 1 d | — | 🟢 可开工(优先级低) |
| P9 | FAQ 页 | S3 | P2 | 1 d | — | ✅ **已完成**(240 条/79 组件/搜索过滤/浏览器实测,details 懒加载版) |
| P10 | Figma 资源 | S4 | P2 | 2 d | P2 | ⚪ 待 P2 |
| P11 | 模板页库 | S4 | P2 | 2 d | — | 🟢 可开工(优先级低) |
| P12 | 版本发布流程 | S4 | P3 | 1 d | P2 | ⚪ 待 P2 |
| P12 | 版本发布流程 | S4 | P3 | 1 d | P2 | ✅ **已完成**(release.mjs 检查/bump + CONTRIBUTING 文档化,只做本地准备不自动 push/tag) |
### 推荐执行顺序