一、基本原则
·资产内容发生变化时创建新版本,已有版本内容不会被覆盖。
·审批用于确认版本是否可以发布;审批通过不等于自动替换当前稳定版本。
·latest 表示最新审批通过的版本,由系统自动维护。
·stable 表示当前稳定版本,也是未指定版本时默认解析的版本。
·自定义标签可用于标记测试、灰度或特定业务用途的版本。
二、审批方式
控制台默认选择自动审批,也可以在创建注册中心时选择人工审批;审批方式创建后不能修改。
| 审批方式 | 新版本行为 |
| 自动审批 | 版本内容校验成功后由系统自动批准。 |
| 人工审批 | 版本内容校验成功后进入待审批状态,需要管理员批准或驳回。 |
对于 Skill 压缩包,系统需要先完成上传和内容校验。校验完成前,即使使用自动审批,也不能作为可发布版本。
三、创建新版本
1. 进入注册中心,找到目标资产并单击 查看。
2. 在版本列表上方单击 新建版本。
3. 根据需要填写版本别名和变更说明。
4. 按资产类型填写新的协议元数据、来源地址、SKILL.md、压缩包或自定义内容。
5. 确认后创建版本。
6. 在版本列表中检查版本的修订号、来源类型、内容状态和审批状态。
·版本列表会同时展示审批状态以及 latest、stable 等标签:
·版本别名用于展示,系统仍会为每个版本生成独立版本 ID 和单调递增的修订号。即使删除某个历史版本,其修订号也不会被后续版本重复使用。
四、处理人工审批
人工审批模式下,新版本内容校验成功后会显示为待审批。
五、批准版本
1. 在资产详情页选择待审批版本。
2. 发起批准操作,并填写能够说明审批依据的意见。
3. 确认版本状态更新为已通过。
首个通过审批且内容校验成功的版本会自动获得 stable 和 latest 标签。后续版本通过审批后,只会自动获得或移动 latest,不会自动替换已有的 stable。
六、驳回或取消版本
·内容不符合发布要求时,可以驳回版本,并在意见中说明原因。
·不再继续处理的候选版本可以取消。
·已驳回或已取消的版本不能再次批准;修正内容后应创建新版本。
审批、驳回和取消都会记录到操作日志中。
七、理解版本标签
| 标签 | 维护方式 | 说明 |
| stable | 首次由系统绑定,之后由用户移动 | 当前稳定版本;绑定后不能解除。 |
| latest | 系统自动维护 | 指向修订号最大的已审批版本,不能手动修改。 |
| 自定义标签 | 用户维护 | 可以创建、移动、解绑或删除。 |
标签只能指向已审批且内容校验成功的版本。一个标签只能指向一个版本,一个版本可以同时拥有多个标签。
自定义标签名称会自动去除首尾空格并转换为小写。名称长度为 1–63 个字符,必须以字母开头,仅支持小写字母、数字、点、下划线和短横线;每项资产最多可以拥有 32 个自定义标签。
八、发布稳定版本
后续版本通过审批后,latest 会自动移动到该版本,但 stable 保持不变。完成验证后,可以将新版本发布为稳定版本:
1. 在资产详情页选择已经审批通过且内容校验成功的目标版本。
2. 打开该版本的更多操作,选择管理标签。
3. 将 stable 移动到当前版本。
4. 确认版本列表和版本详情中的 stable 标签已经更新。
在 管理标签 面板中,可以查看系统维护的 latest、移动 stable,或新增自定义标签:
注意:截图中的“内容就绪”是控制台当前用语,表示版本内容已经完成校验,可以参与审批和标签管理;不表示该版本已经发布或正在运行。
将 stable 移动到新版本只改变后续的默认版本解析,不会修改或删除历史版本。
九、使用自定义标签
自定义标签适合表达除稳定版和最新版以外的发布通道,例如测试环境、灰度验证或特定业务线。
在目标版本的管理标签面板中,可以:
·新建自定义标签并绑定当前版本。
·将已有自定义标签从其他版本移动到当前版本。
·解除自定义标签与版本的绑定,同时保留标签名称。
·删除不再使用的自定义标签。
不要将账号、手机号、项目密钥或其他敏感信息用作标签名称。
十、回退稳定版本
如果新稳定版本出现问题,可以将 stable 移回历史版本:
1. 在版本列表中选择历史上已审批且内容校验成功的版本。
2. 打开管理标签。
3. 将 stable 移动到该历史版本。
4. 确认目标版本带有 stable 标签,并记录回退原因。
回退通过移动标签完成,不会复制版本或生成新的修订号。资产运行环境中的实际部署是否需要回退,应由对应运行系统单独处理。
十一、删除版本
在版本的更多操作中,可以删除符合条件的历史版本。删除前请注意:
·stable 当前指向的版本不能删除。
·资产仅剩的最后一个已审批版本不能删除。
·删除 latest 指向但不是 stable 的版本后,latest 会自动回退到剩余版本中修订号最大的已审批版本。
·指向已删除版本的自定义标签会保留,但会解除版本绑定。
·删除版本不会复用其修订号,也不会清除相关操作日志。
·删除后,当前控制台不提供恢复入口。
十二、推荐发布流程
建议按以下顺序管理版本:
1. 创建新版本,并填写清晰的变更说明。
2. 等待内容校验成功;人工审批模式下完成审批。
3. 检查版本详情,确认资产定义、来源信息和内容状态符合预期。
4. 使用 latest 或自定义标签完成验证。
5. 将 stable 移动到新版本并记录发布原因。
6. 发布后持续观察;出现问题时将 stable 移回已验证的历史版本。
7. 仅在确认无保留价值且满足删除条件时清理历史版本。
十三、注意事项
·审批与发布是两个步骤:后续版本审批通过只会更新 latest,不会自动更新 stable。
·未指定版本时默认使用 stable;不会因为存在更新的 latest 而自动切换。
·latest 不能手动修改,stable 不能解绑。
·版本内容不可覆盖;修改内容必须创建新版本。
·变更说明和审批意见中不得包含访问凭据、内部地址或其他敏感信息。