Versioning

语言：简体中文 ｜ Versioning-EN

版本号规则

版本方案

自 v1.0.0 正式发布起，版本标识符采用 SemVer（语义化版本）： 1.0.0、1.1.0... 在此之前的工程阶段使用工作包阶段名称 （WP-14-docs_release、WP-13-build_system...）- 即内部按功能集划分的发布线。

此外，每次构建还携带：

• 构建号 = 构建时的提交计数（git rev-list --count HEAD）- 单调递增，发布于更新清单的 build 字段（横幅/uname 携带版本号）。
• 版本横幅 = Makefile 中固定的 OC_RELEASE_VERSION ?= 1.0.0 字面量（显式 OC_RELEASE_VERSION= 覆盖仍然优先，E2E 更新测试即依赖此机制）- 烘焙到内核横幅、uname、OTA 清单和 ISO 中。早期构建使用 git describe --tags 推导；v1.0.0 起固化为字面量，横幅不再依赖本地 git 状态。

各数字的含义

位置	示例	含义
uname -a	Open Cube OS 1.0.0 x86_64	运行中内核的版本
update.json	version: 1.0.0, build: 275	已发布的清单
发布标签	v1.0.0	资源所构建自的 git 标签
gh-pages	下载页面中的相同两个数字	网站镜像了发布版本

一次发布 = 一个标签 = 一个构建号 = 一个清单 = 一组覆盖本地 / 发布版本 / gh-pages / 私有镜像的 SHA256。

兼容性承诺

• Shell 命令永不删除；增加是常态（基线上移：176 -> 192 -> ... -> 233）。
• L1 编号接口永不重新编号；新组追加。
• OTA 包仅更新内核；/etc 卷内容向前携带。
• 自本版起遵循 SemVer：破坏性变更升 MAJOR，新增命令或 L1 组升 MINOR，修复升 PATCH。

选择下一个版本

按上文 SemVer 规则选取；build = 发布当天的提交计数 - 绝不手动挑选。