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
+8
View File
@@ -98,6 +98,14 @@
- 不在框架实现里 hard-code API key
- 不引入未审核的 npm 包(保持零依赖)
## 版本发布流程(S4-P12 · SemVer)
1. 在 `CHANGELOG.md` 的 `[Unreleased]` 下写清本次变更条目(有内容才允许提升版本)。
2. 检查是否可发布:`node tools/release.mjs`(校验 package.json 与 CHANGELOG 最新版本一致)。
3. 提升版本:`node tools/release.mjs --bump <major|minor|patch> --date YYYY-MM-DD`(自动改 CHANGELOG 与 package.json,复核后提交)。
4. 人工执行:`git tag v<x.y.z>` → `git push origin main v<x.y.z>` → `npm run build && npm publish`(公开发布需先做 Q1 决策)。
5. 版本号规则:破坏 `data.json` 全量承诺或删接口 → major;加组件/加页面 → minor;修 bug/改文案 → patch。
## 行为准则
- 中文优先;技术名词保留英文(如 avatar / tooltip)