chore: 版本规范落地——本次发布定版 v1.2.0(基线为线上 v1.1.5),上传脚本版本号以 manifest 为唯一事实来源,新增 docs/版本规则.md

This commit is contained in:
2026-09-13 10:34:16 +08:00
parent 4f48b324c5
commit 47d3ea8bfa
5 changed files with 78 additions and 7 deletions
+28
View File
@@ -0,0 +1,28 @@
# 版本号规则(宇之然AI维度 小程序/H5)
> 格式:`主版本.次版本.修订号`(如 `1.2.0`),线上已发布版本为递增基线,**不跳号**。
## 递增规则
| 位 | 何时 +1 | 例子 |
|---|---|---|
| **主版本** X | 产品形态重构、世界观/信息架构大改、含不兼容数据迁移 | 点亮体系之后若做"维度2.0"社区重构 → `2.0.0` |
| **次版本** Y | 新功能模块、新页面、成组的体验升级 | 星图点亮体系(v1.1.5 → `1.2.0`);后续新增周挑战 → `1.3.0` |
| **修订号** Z | bug 修复、文案/样式微调、配置变更、性能优化 | 登录修复+筛选按钮 → `1.2.1` |
**判断口诀**:改 bug 不加功能 → 只动尾号;加功能不改架构 → 动次版本;连架构带数据一起变 → 动主版本。
## 执行约束(防漂移)
1. **唯一事实来源**:`client/src/manifest.json` 的 `versionName`。发版前先改它。
2. 页面内展示的版本号(如"我的"页)与 `CHANGELOG.md` 条目同步更新为同一版本。
3. 上传脚本 `scripts/upload-wx.js` **自动读取 manifest 版本号**;`--version` 显式传参必须与 manifest 完全一致,否则拒绝上传。
4. 一次提审对应一个版本号;提审被拒后修改重传**仍用同一版本号**(微信平台以最后一次上传为准),通过并发布后才递增。
5. 版本号只从"线上已发布版"递增,与中间上传但未发布的版本无关。
## 历史版本对照
| 版本 | 状态 | 内容 |
|---|---|---|
| 1.1.5 | 已发布(线上) | 分享优化+下拉刷新+触感反馈+SEO 路由 |
| 1.2.0 | 待提审 | 星图点亮体系重构(详情页修复/读后检测/游客问答/维度精灵/深色模式/登录与筛选修复) |