更新策略
安全更新 Turboism 及插件,了解后台自动更新,并在各发布渠道之间做出选择。
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 构建是开发构建:使用前请备份项目。
- 自 0.67.0 稳定版起,每个发行版只提供两种产品下载:
TurboismInstaller-<version>.exe和turboism-<version>.zip,并附带配对的.sha256校验和。两者都包含全部随包第一方插件以及完整的离线 GraalJS 引擎。开发者构件(turboism-sdk-<version>.jar和turboism-event-processor-<version>.jar)也会一同发布。 - 当前稳定版为 0.67.4。0.67.0 Beta 版本(0.67.0-beta.3 至 0.67.0-beta.7)曾临时采用四种下载的 Full/Thin 布局,该布局现已退役。0.44.0 及更早版本采用旧版构件(
TurboismInstaller-<version>.exe、Java 安装器TurboismInstaller-<version>.jar以及turboism-<version>-full.zip/turboism-<version>-lite.zip)。Java 安装器已不再发布。
机器可读的信息源
每个渠道发布一份 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 目录,或替换你解压出的便携归档中的文件。
- 安装器没有模式或插件选择页。它会安装或更新全部随包第一方插件,退役已废弃的官方插件 JAR,并保持现有
disabledPlugins条目为停用状态。通过已退役的 0.67.0 Beta Thin 安装器安装的环境也会以同样方式获得随包插件。 - 更新后验证启动、插件发现、宿主 capability 状态和日志。
重新运行安装器会更新同一个 home,不会盲目覆盖无关配置。不要把覆盖或重写 Cubism 安装文件作为更新机制。
插件更新与后台自动更新
第一方插件自动更新
自 0.67.0 起,第一方插件可在后台自动更新:
- 运行时会对照官方在线目录检查第一方插件更新。
- 下载的更新在暂存前经过严格的数字签名与文件完整性校验。
- 标记为热更新(hot-reload)的插件会在当前会话中即刻生效,无需重启 Cubism。
- 其他插件更新会在下一次重启 Cubism 时应用。
- 用户可在框架设置中随时关闭官方插件自动更新(自动更新官方插件,
settings.plugins.automatic-updates)。 - 只有当更新声明的 Turboism API 范围包含当前运行的框架时才会安装该更新。部分官方插件要求 API
0.67.2或0.67.4(参见第一方插件);请更新框架以获取这些插件。 - 你也可以随时通过 Turboism → 插件市场… 或访问 turboism.dev/plugins 手动浏览和更新插件。
本地与第三方插件
通过 Turboism → 管理插件… → 从 JAR 安装… 安装具有相同 plugin ID 的新版插件 JAR 会提交替换意图,并在 Cubism 重启后生效。
- 在重要时备份当前插件 JAR 以及插件的持久化
config/<pluginId>/和data/<pluginId>/内容。 - 通过插件管理安装新版 JAR。
- 重启 Cubism。
- 验证显示的版本、生命周期状态、配置迁移和日志。
应用失败时,会从私有备份恢复之前的插件文件。
兼容性预期
- Turboism 发布单一的公共 SDK 层级。源代码仓库中已审查的二进制 API 基线是兼容性门禁。
- API 存在并不保证每个 Cubism 版本都有 Provider。
- 不受支持或未经验证的版本上的宿主敏感操作可能仍然不可用。
- 插件 API 范围从插件所需的最低 Turboism 框架版本开始,并在
1.0.0之前结束(例如[0.67.0,1.0.0));声明[0.1.0,0.2.0)的旧版插件会被拒绝。 - 插件作者应使用已声明的 Turboism API 范围,并测试不可用行为。
- 插件管理会显示每个插件的 API 范围及其声明的精确 Cubism Editor 版本(自 0.67.2 起)。
- 当前稳定版 0.67.4 支持 5.0.00 至 5.3.04 的全部 20 个已审核 Cubism Editor 版本(请参阅兼容性),Windows x64 是受支持的宿主平台。
更新检查
Turboism 会针对已部署的发布 API(api.turboism.dev/v1/releases/stable.json)检查稳定版更新。比较使用安装包内嵌的权威构建号,因此更低的构建号永远不会被当作更新提供,构建号相同但版本不同的情况会被视为身份冲突而不是更新。
可用更新以绘图区上的原生 Cubism 提示呈现。点击提示会打开固定的官方下载页;不会自动下载或执行安装程序。你也可以通过顶部菜单中的 Turboism → 检查更新 随时进行手动检查。
更新检查不阻塞界面,最多每 24 小时运行一次,并始终提供手动检查。自动检查在设置中有独立的持久开关,且不受 Cubism 自身更新抑制设置的影响。
当前不可用
- 框架安装程序的自动静默下载与后台执行(框架更新需手动运行安装器或解压 ZIP);
- 未经验证的第三方签名权威机构;
- 保留不可变的 JAR 历史版本回滚 UI;
- 对 Cubism 官方启动文件的全局系统级修改。