企业官网建设流程全解析

Skill 升级审核失败会影响线上版本吗：用版本账本把发布、回滚和下架分清

官方当前规则说明：Skill 完成开发后可以提交上架；升级审核未通过时，线上仍保留上一次审核通过的版本；下架后用户无法再使用。也就是说，“正在审核的版本”和“用户当前使用的版本”不是同一个状态。

证据边界：本文把华为官方资料、可执行的应用侧模型和待补的 API 26 设备证据分开记录。当前本机 SDK 为 API 24，且没有连接 HarmonyOS 7 真机；文中的 TypeScript 断言用于验证状态与边界，不冒充 API 26 编译、云端联调或真机结果。接入时应以目标版本官方文档、控制台配置和真实错误码为准。

最容易出现的误判

开发者看到 v3 审核失败，就以为线上能力已经不可用，于是直接修改生产接口；实际上线上可能仍在运行 v2。反过来，如果主动下架，用户才会失去入口，不能把“审核失败”和“下架”混为一谈。

案例一：v3 新增一个写操作

v3 审核期间，服务端必须继续兼容 v2 请求。只有确认 v3 审核通过并完成灰度观察，才能停止 v2 契约。

案例二：线上 v2 出现严重问题

如果问题涉及安全或错误写入，不能只等 v3 审核。需要评估是否下架、关闭高风险接口或做服务端降级，并记录对用户可用性的影响。

版本账本至少记录四个字段

type SkillRelease = { draft: number; reviewing?: number; online?: number; enabled: boolean }; function visibleVersion(r: SkillRelease): number | null { return r.enabled && r.online !== undefined ? r.online : null; } const r = { draft: 3, reviewing: 3, online: 2, enabled: true }; if (visibleVersion(r) !== 2) throw new Error('把审核版本误当成线上版本');

三种动作不能混用

• 修改草稿：不会自动改变线上版本。
• 提交升级：进入审核，线上旧版本继续服务。
• 下架：用户无法继续使用，应有明确业务决策。

每次发布都保存版本号、审核记录、线上接口契约和回滚负责人。这样出现问题时，团队能先确认用户到底在调用哪一版。

官方资料

1. Skill 上下架流程介绍

2. Harmony Intelligence Agent 与 Skill 能力

3. 2026 年 8 月开发者月刊