| 1234567891011121314151617181920212223242526272829303132333435 |
- ---
- description: 发版必升号；凡产生 Git 提交的变动须在同一次提交中递增版本号
- alwaysApply: true
- ---
- # 版本号：发版与每次提交
- ## 发版必升号
- 凡视为**发版**（打 tag、上预发/生产、对外交付构建物），发布所依据的提交中**必须**已更新版本号，且与变更说明一致；禁止「已部署仍沿用旧号」。
- ## 每次 Git 提交：有变动则同提交内升号
- 凡执行 `git commit` 且本次提交**包含对工作区已跟踪文件的任何实质修改**（新增、删除、内容变更），**必须在同一提交中**完成版本递增，**不得**只改业务代码而不改版本号。
- ### 递增范围（本仓库约定：有提交则双端同升 patch）
- 凡满足上一节的提交，**须在同一次提交中同时**：
- 1. **前端**：递增 `Web/package.json` 的 `version`（SemVer：**只升 patch** 末位，如 `2.4.33` → `2.4.34`；minor/major 仅在明确里程碑发版时由负责人决定）。构建时 `__NEXT_VERSION__` 来自该字段，无需另改 `vite.config.ts`。
- 2. **后端**：递增 `server/Admin.NET.Web.Entry/Admin.NET.Web.Entry.csproj` 中的 `<Version>`、`<AssemblyVersion>`、`<FileVersion>`（**三处保持同号**，patch +1，如 `1.0.0` → `1.0.1`）。
- 即：**不论本次 diff 只动前端、只动后端或只动文档/规则**，只要产生实质提交，**前后端版本号均递增**，与「每次提交有变动就升号」一致。
- ### 锁文件
- 若项目使用 `package-lock.json` / `pnpm-lock.yaml` 且会因版本或依赖变更而更新，版本提交中应包含与 `package.json` 一致的锁文件变更。
- ### 提交说明
- 建议在 commit message 中带一句版本，例如：`chore: bump version 2.4.34` 或与功能说明合并。
- ## AI / 协作者执行时注意
- 在准备帮用户**提交或收尾 PR** 时：若本轮改动了仓库文件，应**主动提醒或代为**完成上述版本号递增，避免遗漏。
|
