版本发布

Version 是渠道上的一个版本号。Version Line 是该版本在某一 (os,arch)（及 hw）上的产物线。

何时使用

每个要发给客户端的构建都要有一条 Version，并在矩阵登记过的平台上准备好 Version Line。商店 feed 与原生 check 共用这些已发布且就绪的线。

配置入口

• 控制台：版本管理、产物管理、批量发版。点击路径：管理 · 版本。
• YAML：无单独「发版」文件。比较引擎在创建项目时选定，见 项目创建。

规则与错误码

生命周期：草稿 → 标记就绪 → 发布。还可 弃用、吊销；线可 撤下（yank） / 停用。低稳渠道可 渠道晋升。

发布拒绝：

• ARTIFACT_REQUIRED发布被拒绝：没有任何就绪的版本线
• AUTO_PUBLISH_PENDINGauto_publish_when 尚未全部就绪
• UPLOAD_INCOMPLETE上传未完成，不能发布或标记就绪

发布后比较引擎不可改（COMPARE_ENGINE_IMMUTABLE已发布后不能改比较引擎）。关键版本不能走灰度（GRAY_NOT_ALLOWED_ON_CRITICAL关键版本禁止灰度）。已发布产物不可覆盖（ARTIFACT_IMMUTABLE已发布产物不可覆盖（先 yank 版本线））。

CI 走 ci/releases（自动发版）；浏览器走产物管理 / TUS。direct_s3 恒 false。产物可复用。

客户端职责

只消费 已发布 且线 就绪（packs_ready_at 已打戳）的目标。草稿与未预热线对 check/feed 不可见（VERSION_NOT_VISIBLE版本对客户端不可见（草稿、未预热或灰度未命中））。

相关：灰度发布、增量更新、渠道。