ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

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

Skill 升级审核失败会影响线上版本吗:用版本账本把发布、回滚和下架分清 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 月开发者月刊
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进