版本发布与安装包管理

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

适用范围

版本面向授权单品。Halo 插件和主题的安装还依赖正确应用类型及兼容范围；套餐父产品不配置版本和安装包，使用成员版本。

操作步骤

1. 在控制台版本数据中新增版本，选择所属授权单品。
2. 填写版本号、兼容范围、变更说明、文档地址和下载地址。
3. 使用上传安装包能力时，配置存储策略、附件分组和包大小上限。
4. 保存未发布版本，确认匿名或目标授权用户可访问下载地址。
5. 审核兼容范围和变更说明后上线；需要撤下时执行版本下线。
6. 在用户中心和实际应用商店检查版本展示及下载行为。

状态

产品上架和版本上线是独立操作。版本在线也不意味着付费下载地址应对所有访客公开，需遵循产品购买后可见字段与授权规则。

安装包来源

可维护可访问的下载地址，或通过 CI 上传至站点附件后关联版本。私有仓库的 Release 下载链接通常无法匿名获取，应优先使用站点附件地址。携带附件引用推送时，服务端以附件解析结果确定下载地址。

通知与清理

版本通知使用 product-new-version-notification 模板，具体由管理入口的通知动作触发；MCP publish_version 明确不会发送通知。未引用的安装包由独立清理任务处理，MCP 删除版本本身保留附件。

验收与常见问题

核对最新在线版本、版本号、兼容范围和真实文件下载结果。出现下载失败时检查存储策略、访问地址前缀和文件访问权限；CI 成功创建记录后仍需管理员上线。

相关文档

• CI 自动推送版本与安装包
• 定时任务、通知与安装包清理