Repository navigation
Versioning
yijiu2025 edited this page Oct 25, 2026
·
1 revision
skinsuite 遵循 Semantic Versioning,但 0.x 阶段有一条反直觉的规则要先知道。
-
^0.11.0与~0.11.0都等价于>=0.11.0 <0.12.0(caret 在 0.x 不跨 minor)——每发一个 minor 都要手工跟版; - 0.x 的 minor 允许重命名与结构调整:公开出口全部是显式具名导出,改名/删除即 semver-minor。升级前必读 CHANGELOG 的对应版本段;
- 因此接入时显式写版本号(
npm install skinsuite@~0.11.0),不要裸装latest。
版本源是 git tag(vX.Y.Z,annotated),package.json 的 version 单向跟随。按推送包含的提交类型判定:
| 提交类型 | 版本递增 |
|---|---|
破坏性变更(!: 或 footer BREAKING CHANGE:) |
major |
含 feat
|
minor |
仅 fix / perf
|
patch |
仅 docs / test / chore / ci / refactor
|
不发版 |
发版前 8 项检查(工作区/闸门/公开面 diff/CHANGELOG/release-notes/版本一致/敏感词/文档站)
→ chore(release) 提交 → 推 main
→ 打 annotated tag v<x.y.z> → 推 tag
→ CI(release-npm.yml,Trusted Publishing/OIDC)发布 npm + 自动建 GitHub Release
→ 轮询 npm registry 版本生效
→ 宿主 lock 同步(publish-and-sync --skip-publish)+ 根仓 lock 同步
- GitHub Release 正文取自 CHANGELOG 对应版本段,缺失会响亮失败(不发空 Release);
- 发布认证走 OIDC,仓库不持有 npm token;
- 旧包名
mauth-theme-core(0.1.0 / 0.1.1)已标记 deprecated,不再更新。