version-management

适用于任何软件构件的通用版本管理，独立于任何版本控制系统（VCS）。根据变更集按照语义化版本规范（主版本号/次版本号/修订号、预发布版本、构建元数据）决定下一个版本号，保持唯一的版本来源，维护符合 Keep-a-Changelog 规范的变更日志（CHANGELOG），并标记发布版本——当使用 Git 时通过 VCS 标签标记，否则使用 RELEASES 清单文件。根据公共契约（包括隐式接口）判断破坏性变更与兼容性变更，应用“先弃用后移除”策略，处理不可变发布版本（支持撤回/弃用，永不重新发布），审计跨文件的版本一致性，并协调多构件的发布。适用于以下场景：选择或升级版本号、编写变更日志或发布说明、标记发布版本、规划弃用策略，或检查项目中版本号的一致性——包括无版本控制的项目。不适用于：Git 分支/提交/PR 流程（应使用 git-workflow）、依赖锁定或漏洞扫描（应使用 dependency-scan）。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本