ai-dimension/docs/版本规则.md

版本号规则（宇之然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	待提审	星图点亮体系重构（详情页修复/读后检测/游客问答/维度精灵/深色模式/登录与筛选修复）