注册中心通过不可变版本、审批状态和版本标签管理资产演进。本文介绍如何通过腾讯云控制台创建新版本、处理人工审批、发布稳定版本、使用自定义标签、回退版本及删除不再需要的版本。
基本原则
资产内容发生变化时创建新版本，已有版本内容不会被覆盖。
审批用于确认版本是否可以发布；审批通过不等于自动替换当前稳定版本。
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 不能解绑。版本内容不可覆盖；修改内容必须创建新版本。
变更说明和审批意见中不得包含访问凭据、内部地址或其他敏感信息。
