技能包与版本包分发流程

技能包与版本包分发流程 由 Archify 生成的工作流图。 01 / 管理端 02 / 云控服务端 03 / 桌面客户端 EX / 例外与守护 登记上架 获取与确认 传输与落地 上传 zip / 安装包 · UPLOAD_MAX_MB 限额 · 管理端 › 登记上架 上传 zip / 安装包 UPLOAD_MAX_MB 限额 登记上架 · sha256 入库 · 绑定 ReleaseID · 云控服务端 › 登记上架 登记上架 sha256 入库 · 绑定 ReleaseID TLS 分片下发 · base64 · 128KB/片 · seq/total · 云控服务端 › 传输与落地 TLS 分片下发 base64 · 128KB/片 · seq/total 拉取列表 / 收到更新 · skill.list / config.sync · 桌面客户端 › 获取与确认 拉取列表 / 收到更新 skill.list / config.sync 安装确认 / 更新弹窗 · 版本高于当前才提示 · 桌面客户端 › 获取与确认 安装确认 / 更新弹窗 版本高于当前才提示 收齐重组 · sha256 与元信息比对 · 桌面客户端 › 传输与落地 收齐重组 sha256 与元信息比对 解压 · 原子落盘 · category 目录 · 写 updates · 桌面客户端 › 传输与落地 解压 · 原子落盘 category 目录 · 写 updates 不匹配即忽略 · 平台 / 架构不符 · 例外与守护 › 获取与确认 不匹配即忽略 平台 / 架构不符 校验失败回滚 · sha256 不符 · 缺 SKILL.md · 例外与守护 › 传输与落地 校验失败回滚 sha256 不符 · 缺 SKILL.md 重启拉起安装 · Windows 静默 / macOS 系统打开 · 例外与守护 › 传输与落地 重启拉起安装 Windows 静默 / macOS 系统打开 分片流 · 共用 cmd id cmd skill.install / release.download 平台 / 架构不符 列表 / 配置携带 版本更新路径 校验不通过 登记入库 sha256 通过 图例 用户界面 Agent 逻辑 策略 工具操作 外部系统

分片传输

  • • TLS 长连接 base64 分片，每片 128KB 原始字节，seq/total 标注进度
  • • 全部分片共用命令 id，重试只补发未确认分片
  • • 设备端不暴露公网下载地址，HTTP 下载仅限管理端

校验防线

  • • 元信息 sha256 与重组结果强比对，不符即拒装
  • • 解压防 zip-slip 路径穿越，技能包必须含 SKILL.md 否则回滚
  • • 版本号不高于当前不提示，同 release 单会话只弹一次

落地策略

  • • 技能按 category 六类目录落盘，global 对全部编辑器可用
  • • 同目录原子替换 + .cloud-skill.json 登记，装完即用无需重启
  • • 版本包写入 userData/updates，确认后拉起安装并退出应用