Skip to content

Versioning

yijiu2025 edited this page Oct 25, 2026 · 1 revision

版本政策(Versioning)

skinsuite 遵循 Semantic Versioning,但 0.x 阶段有一条反直觉的规则要先知道。

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,不再更新。

skinsuite Wiki

外部

Clone this wiki locally