基本

快速开始

安装已发布的 Turboism 安装包，进行配置，并验证首次运行。

本快速开始从安装中所述的已发布安装包开始。你需要该安装包，以及已安装且合法授权的 Cubism Editor。

1. 安全准备

  • Windows x64 是受支持的 Cubism 宿主平台。受支持的 Editor 版本为 5.2.03、5.3.02 和 5.3.03。
  • .jar 安装器需要 Java 17+ 运行时。
  • 备份要打开的项目，或使用一次性副本。
  • 将 Turboism home 与 Cubism 安装分开。
  • 不要编辑 Cubism JAR、DLL、BAT 文件或许可状态。

2. 下载与验证

  1. 打开 turboism.dev/download 并选择渠道：Stable、Beta 或 Nightly。

  2. 下载一个安装包及其配对的 .sha256 文件。

  3. 验证文件哈希，例如在 PowerShell 中：

    Get-FileHash ".\TurboismInstaller-<version>.exe" -Algorithm SHA256

安装器未签名，因此校验和是你可以自行完成的完整性检查。

3. 安装

Windows .exe 安装器

  1. 运行 TurboismInstaller-<version>.exe。
  2. 选择安装器语言（英文、简体中文、日文或韩文）。
  3. 阅读许可协议，并确认全部四项必需确认。
  4. 选择 Full 或 Lite，然后选择安装目录（默认为 %LOCALAPPDATA%\Turboism）。在 Full 模式下可以取消勾选单个插件。
  5. 决定是否下载可选的托管 GraalVM 组件。
  6. 当安装器打开 configure_turboism.ps1 时，选择要使用的 Cubism 安装并保存。取消配置器会留下一个有效的仅框架安装。
  7. 通过所选 Cubism 根目录的托管 launcher 启动 Cubism（launch-cubism-turboism.bat）。

跨平台 .jar 安装器

  1. 运行安装器：

    java -jar TurboismInstaller-<version>.jar

    传入 -language eng|chn|jpn|kor 可预先选择安装器语言。

  2. 完成各项声明，并选择 Full、Thin 或 Lite，然后选择目标目录。

  3. 在 Windows 上，运行已安装的 configure_turboism.ps1，选择 Cubism 安装，并通过托管 launcher 启动。在 macOS 上，此安装器仅覆盖安装和卸载：macOS Cubism 宿主支持尚未验证，且未安装 macOS launcher。

便携式 ZIP

  1. 将整个归档解压到独立文件夹中。
  2. 从该文件夹运行 configure_turboism.ps1，并选择 Cubism 安装。
  3. 通过生成的快捷方式或 launch-cubism-turboism.bat 启动 Cubism。

安装器语言只影响安装器。Turboism 在运行时使用的语言来自运行时 locale 设置，插件界面语言跟随 Cubism Editor 的 File → Environment Settings → General → Language。

4. 验证首次运行

检查以下各项：

  • Cubism 正常启动；
  • Turboism runtime 报告启动成功；
  • runtime 使用预期的 Turboism home；
  • 已安装的插件出现在插件管理器和 runtime diagnostics 中；
  • 不可用的宿主 capability 会 fail closed，而不是导致 Cubism 崩溃；
  • 关闭 Cubism 后，插件 scope 和框架所有的 executor 都会释放。

5. 添加插件

Full 选项已安装已审查的第一方插件捆绑包。如需添加本地插件 JAR：

  1. 打开 Turboism，选择 插件管理（Plugin Management）。
  2. 选择 从 JAR 安装…（Install from JAR…）。
  3. 选择本地 .jar 文件。
  4. 确认将 JAR 标记为本地/未验证来源的对话框。
  5. 当操作显示为 pending 时重启 Cubism。

确认后插件 JAR 会被暂存，并在重启后生效。插件变更不会热切换当前已加载的插件实例。插件 JAR 与 Turboism 安装器 JAR 是分开的。

手动安装（备选）

作为高级备用路径——例如在本地测试构建出的 JAR——你可以直接放置插件 JAR：

  1. 完全关闭 Cubism 和 Turboism。
  2. 将受信任的插件 JAR 直接复制到 <turboism.home>/plugins/ 根下。
  3. 保持每个 plugin ID 最多一个 JAR。
  4. 使用同一个 Turboism home 重启。
  5. 验证插件状态和 runtime 日志。

手动安装会绕过托管保护。完整流程请参见插件管理。

6. 查找日志

使用已安装的 Turboism home 的 logs/ 目录。报告启动、JAR、依赖、权限或 Provider 故障时，请保留日志。

后续步骤

安装器模式

比较 Full、Thin 和 Lite 安装选项以及可选的托管 GraalVM 组件。

插件管理

安全地安装、替换、启用、禁用和卸载本地 Turboism 插件 JAR。

本页目录

1. 安全准备2. 下载与验证3. 安装Windows .exe 安装器跨平台 .jar 安装器便携式 ZIP4. 验证首次运行5. 添加插件手动安装（备选）6. 查找日志后续步骤