切换主题
Version Compatibility 与 Release Status
YoyoBoot Unified Release Train
Admin Runtime、Admin Core、Admin Schema、Admin Kit 与 Admin CLI 必须保持同版本，不建立独立的 0.x 产品版本线。正式 registry 发布时，它们与后端 NuGet 一起加入 YoyoBoot Unified Release Train，并从根 common.props 获得版本 X.Y.Z：
| Release member | Artifact version | 关系 |
|---|---|---|
| 后端 NuGet artifacts | X.Y.Z | 平台后端合同 |
@yoyoboot/yoyo-admin-runtime | X.Y.Z | 共享前端运行时、服务与路由合同 |
@yoyoboot/web-lint-config | X.Y.Z | 共享 lint config 与 CLI 合同 |
@yoyoboot/yoyo-admin-core | X.Y.Z | Admin runtime 基础合同 |
@yoyoboot/yoyo-admin-schema | X.Y.Z | Admin Schema 合同 |
@yoyoboot/yoyo-admin-kit | X.Y.Z | 精确依赖同版本 Core 与 Schema |
@yoyoboot/cli | X.Y.Z | public developer tool；workspace eligibility 不变 |
消费者不应自行混装不同 YoyoBoot 产品版本。任何 release member 若要脱离统一版本独立演进，必须先建立新的架构决策、跨版本兼容矩阵和可执行 migration evidence。
当前状态
当前 channel 是 prepare-only：本地工具可以派生 staged manifests、生成 tarball，并在干净 Vue/TypeScript consumer 中验证 install、typecheck、Vite build、runtime import、canonical styles/theme 与 deep-import fail-closed。
统一状态只使用以下语义：
| 状态 | 含义 |
|---|---|
prepare-only | 只证明源码可生成并消费候选 artifact；没有冻结版本或 registry publication 结论。 |
release-cut-ready | 人工冻结版本后，clean main exact SHA、fresh preflight、不可变 bundle 与全部 no-write gates 通过；仍未发布。 |
partially-published | 至少一个 required public artifact 已写入或 read-back 通过，但 NuGet + 六个 npm 尚未全部验证。必须复用同一 bundle safe resume，不能换包或盲目跳过。 |
published | public NuGet 与六个 public npm artifact 均从 registry read-back 并与 prepared bundle identity 一致。 |
受版本控制的 npm source manifest 统一使用 private: true 与 0.0.0-private；它们是防误发 sentinel，不是 registry 版本记录。正式/preview artifact version 只在 staging 中从 canonical version 派生。
这不表示：
- package 已进入 npm registry；
- VitePress 已部署到公网；
- source
package.json中的0.0.0-private是可从 registry 安装的发布记录。
真实 tag 创建、NuGet/npm publish 与公开文档部署需要独立授权。只读 registry 查询不等于发布；完成 public read-back 后，本文才可以把对应版本从 prepare-only 或 release-cut-ready 更新为 published。
判读 release evidence
| Evidence | 能证明 | 不能证明 |
|---|---|---|
单包 package:verify | 单包 API、boundary 与 tarball 可消费 | unified package set 版本组合正确 |
| combined external consumer | 同一候选 release train 可在仓库外构建运行 | registry 已发布 |
docs:build | 官方 Markdown 可被 Portal 构建 | 公网站点已上线 |
| Developer Docs OCI image build | canonical VitePress output 已形成 SHA 可追溯的可部署镜像 | OCI registry 已完成 push/read-back，或公网站点已部署 |
| Docs image registry read-back | registry 中存在与 manifest digest 一致的 Docs artifact | 域名、TLS、CDN、环境 rollout 或公网内容 smoke 已完成 |
安装入口见 External Installation，breaking contract 的处理见升级与迁移。