切换主题
Upgrade 与 Migration Policy
当前是首个 public runtime baseline,尚无历史公开版本可迁移,因此本文不伪造旧版本兼容承诺。
未来每个 breaking public contract 必须同时提供:
- 受影响的 Core / Schema / Kit package-root API 或正式 CSS subpath;
- 旧写法到新写法的版本化 migration 说明;
- 同步 release train 的目标版本与支持范围;
- clean external consumer 或等价真实消费者证据;
- 无法自动迁移的行为差异和回滚路径。
内部文件、vendor DOM/class、未通过 exports 暴露的路径不构成兼容承诺。消费者发现 deep import 被拒绝时,应迁回 package-root contract,而不是增加 bundler alias 绕过边界。
在正式 registry release 出现前,升级只针对同一次 preparation 的候选 tarball 复验;不要把 source HEAD 或本地 npm pack 当成已发布升级渠道。