更新策略
通过重新运行安装器更新 Turboism，并在 stable、beta 和 nightly 发布渠道之间选择。
Turboism 在三个渠道发布产品版本，并在机器可读的发布信息源后镜像每个安装包。Turboism 会自动检查稳定版更新，但安装更新仍是明确的手动步骤：不会自动下载或执行任何安装程序。
发布渠道
| 渠道 | 版本形态 | 用途 |
|---|---|---|
stable | X.Y.Z | 日常使用。已审查的发行说明和翻译。 |
beta | X.Y.Z-beta.N、X.Y.Z-rc.N 或 X.Y.Z-alpha.N | 在变更稳定之前提前试用。 |
nightly | X.Y.Z-0.nightly.BUILD | 每日开发构建，仅在源代码发生变化时产出。 |
- 渠道可以合法地报告
status: not_published；这表示渠道为空，而不是错误。 - nightly 构建是开发构建：使用前请备份项目。
- 每个渠道都产出相同的四种安装包格式以及相同的每包 SHA-256 伴随文件。
机器可读的信息源
每个渠道发布一份 JSON 文档：
https://api.turboism.dev/v1/releases/stable.json
https://api.turboism.dev/v1/releases/beta.json
https://api.turboism.dev/v1/releases/nightly.json文档包含渠道、所选发行版（version、tag、buildNumber、sourceRevision、publishedAt）、本地化发行说明，以及每个资产的一行记录，含名称、大小、SHA-256、校验和文件和可用来源（official 镜像与 github）。支持条件请求。服务错误、空响应或请求失败都不得被视为“已是最新”。
产品网站使用相同的数据支撑 turboism.dev/download。
更新框架
- 备份
config.json以及任何重要的持久化插件config/和data/内容。 - 下载适用于你的平台和渠道的更新安装包，并验证其 SHA-256 校验和。
- 运行新版安装器并指向同一个 Turboism home 目录，或替换你解压出的便携归档中的文件。
- 在更新过程中重新运行插件选择（Full、Thin 或 Lite）。
- 更新后验证启动、插件发现、宿主 capability 状态和日志。
重新运行安装器会更新同一个 home 和选择，不会盲目覆盖无关配置。不要把覆盖或重写 Cubism 安装文件作为更新机制。
替换或更新插件
安装具有相同 plugin ID 的新版插件 JAR 会分阶段提交替换意图，并在 Cubism 重启后生效。
- 在重要时备份当前插件 JAR 以及插件的持久化
config/<pluginId>/和data/<pluginId>/内容。 - 通过插件管理安装新版 JAR。
- 重启 Cubism。
- 验证显示的版本、生命周期状态、配置迁移和日志。
应用失败时，会从私有 backup 恢复之前的插件文件。此工作流不会保留历史 generation，也不提供完整的用户面向修复、回滚或清理 UI。
兼容性预期
- Turboism 发布单一的公共 SDK 层级。源代码仓库中已审查的二进制 API 基线是兼容性门禁。
- API 存在并不保证每个 Cubism 版本都有 Provider。
- 不受支持或未经验证的版本上的宿主敏感操作可能仍然不可用。
- 插件作者应使用已声明的 Turboism API 范围，并测试不可用行为。
- 受支持的 Cubism Editor 版本为 5.2.03、5.3.02 和 5.3.03，Windows x64 是受支持的宿主平台。
更新检查
Turboism 会针对已部署的发布 API（api.turboism.dev/v1/releases/stable.json）检查稳定版更新。比较使用安装包内嵌的权威构建号，因此更低的构建号永远不会被当作更新提供，构建号相同但版本不同的情况会被视为身份冲突而不是更新。早于构建号机制的安装仍然只按版本比较，并且永远不会被赋予臆造的编号。
可用更新以绘图区上的原生 Cubism 提示呈现。点击提示会打开固定的官方下载页；不会打开或安装来自发布源的任何 URL，也不会自动下载或执行安装程序。
更新检查不阻塞界面，最多每 24 小时运行一次，并始终提供手动检查。自动检查在「启动」设置页有独立的持久开关，且不受 Cubism 自身更新抑制设置的影响。
当前不可用
- 框架或插件更新的自动下载与安装；
- 生产可用的 marketplace；
- 发布者签名和撤销；
- 保留不可变的 JAR generation；
- 完整的用户面向修复、回滚或恢复 UI；
- 对 Cubism launcher 的全局修改。
内置的 Official Directory 客户端和 UI 已存在，但生产激活尚未就绪：生产密钥列表为空，实时签名 catalog 就绪性尚未建立。