基本

兼容性

各 Turboism 发行版支持的 Cubism Editor 版本、第一方插件兼容范围、按小版本线的能力覆盖，以及基于证据的宿主边界。

Turboism 对 Cubism Editor 的版本支持同时取决于你安装的 Turboism 发行版本以及所使用的具体插件或 SDK 能力。Windows x64 是受支持的 Cubism 宿主平台。未列出的 Editor 版本不被声称为兼容，不可用的 adapter 或能力会安全地失败关闭，而不是回退到未经验证的代码路径。

各 Turboism 版本的支持范围

每个 Turboism 发行版都内嵌其经过审核的 Cubism Editor 版本集合，并在发布元数据中声明：

  • 当前 Stable 0.67.4 与所有 0.67.x 稳定版（0.67.0、0.67.1、0.67.2）一样，支持 Windows x64 上 从 5.0.00 到 5.3.04 的全部 20 个已审核 Cubism Editor 版本（涵盖 5.0.00–5.0.06、5.1.00–5.1.03、5.2.00–5.2.03 和 5.3.00–5.3.04）。
  • 上一个稳定版 0.44.0 仅支持精确版本 5.2.03、5.3.02 和 5.3.03，此处仅作历史记录列出。
Turboism 版本发布渠道支持的 Cubism Editor 版本宿主平台
0.67.4Stable（稳定版）5.0.00–5.3.04 (全部 20 个已审核版本)Windows x64
0.44.0Stable（稳定版）5.2.03, 5.3.02, 5.3.03 (3 个精确审核版本)Windows x64

由 turboism/Turboism 仓库提交 5e0f8b02c 的已审核兼容性数据生成（共 20 个已审核 Cubism Editor 版本：5.0.00–5.3.04）。

Beta 与 Nightly 构建会在各自的发布元数据中声明其版本集合；下载页面按渠道显示。

同一小版本线内的补丁连续性

在同一个 Cubism Editor 小版本线（5.0.x、5.1.x、5.2.x 或 5.3.x）内，较新的补丁版本始终是较旧补丁版本的超集：在 5.x.y 上准入的能力与 Editor 命令，在所有满足 y' > y 的 5.x.y' 上同样保持准入。在同一小版本线内升级到更新的补丁版本绝不会丢失功能。

跨小版本线之间的差异（例如 5.0.06 与 5.1.00、5.1.03 与 5.2.00、或 5.2.03 与 5.3.00 之间）反映的是 Cubism Editor 新增或调整底层功能所形成的真实宿主边界，而非回退。

第一方插件兼容性

下表中的每一行均由 Turboism 源码仓库在 0.67.4 发布提交时已审核的兼容性矩阵生成。该矩阵也涵盖未包含在发行捆绑包中的仓库内插件，例如仅用于开发的 demo 插件；随包插件集合请参阅第一方插件。支持版本列出插件声明能力可解析的已审核 Cubism Editor 构件；版本差异列出仅在部分已审核版本上可用的功能。

当 Cubism 以 FREE 许可运行时，保存受 FREE 参数数量等限制；使用 PRO 许可（含 PRO 试用）则无此限制。Turboism 插件的版本支持与许可层级无关——许可约束的是编辑器允许保存的内容，而非运行时准入的 API。

插件支持版本版本差异实机验证
acp全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.03, 5.3.02–5.3.03
atlas-bitmask-nesting全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.2.00 及以上
  • 多边形图集布局 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
—
atlas-dalsoo-polygon全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.2.00 及以上
  • 多边形图集布局 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.2.03, 5.3.02–5.3.03
atlas-folder-layout全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.1.00 及以上
  • 顶部菜单集成 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
—
atlas-maxrects-bssf全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.03
boundingbox-warp-mirror全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.03, 5.3.02–5.3.03
clipmask-viewer全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.1.00 及以上
  • 顶部菜单集成 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.0.00, 5.0.06–5.1.00, 5.1.03–5.2.00, 5.2.03–5.3.00, 5.3.02–5.3.04
  • 确认边界 5.2.01–5.2.02, 5.3.01
command-palette5.1.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 顶部菜单集成 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
—
cubism-tab-filter全部审核版本（5.0.00–5.3.04）——
demo全部审核版本（5.0.00–5.3.04）——
external-psd-edit全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.2.00 及以上
  • 导出 PSD 原图 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 替换 PSD 原图 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.3.02
frame-animation-import全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.3.00 及以上
  • 顶部菜单集成 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
—
history-panel全部审核版本（5.0.00–5.3.04）——
mcp全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.1.00 及以上
  • 顶部菜单集成 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • MCP 编辑器命令执行 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • MCP 编辑器命令清单 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.2.00–5.3.01, 5.3.03–5.3.04
  • 确认边界 5.0.00, 5.0.02, 5.0.06–5.1.00, 5.1.03
mesh-edit-mirror-axis-enhance全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.2.00 及以上
  • 网格几何读取 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
—
model-import-3d全部审核版本（5.0.00–5.3.04）——
palette-label-style全部审核版本（5.0.00–5.3.04）——
parameter全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.00–5.2.03, 5.3.02–5.3.04
  • 确认边界 5.3.00–5.3.01
parameter-batch-transfer全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.0.00–5.0.01, 5.1.00, 5.2.00–5.3.04
  • 确认边界 5.0.02–5.0.06, 5.1.01–5.1.03
parameter-lock全部审核版本（5.0.00–5.3.04）——
perf-stats全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.0.00–5.0.06, 5.1.01–5.1.03, 5.2.03, 5.3.02–5.3.04
  • 确认边界 5.2.01–5.2.02, 5.3.01
physics-editor全部审核版本（5.0.00–5.3.04）——
project-inspector全部审核版本（5.0.00–5.3.04）——
protected-export5.1.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 受保护导出编排 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 导出设置贡献 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.1.00, 5.1.03–5.2.00, 5.2.03–5.3.00, 5.3.02–5.3.04
psd-clip-mask-import全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.0.00–5.2.00, 5.2.03–5.3.00, 5.3.02–5.3.04
  • 确认边界 5.2.01–5.2.02, 5.3.01
recent-preview全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.03, 5.3.02
scene-palette-enhancer全部审核版本（5.0.00–5.3.04）——
selection-brush全部审核版本（5.0.00–5.3.04）
  • 实机验证通过 5.2.03, 5.3.02–5.3.03
texture-atlas-stats全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.2.00 及以上
  • 图集编辑器面板 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 原生纹理图集编辑器会话访问 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
  • 原生纹理图集编辑器 UI 贡献 仅 5.2.00–5.3.04 (更早版本 Cubism 本身无此功能)
—
ui-theme全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.0.00–5.2.03, 5.3.02–5.3.03
  • 确认边界 5.3.00–5.3.01, 5.3.04
warp-deformer-alt-symmetry全部审核版本（5.0.00–5.3.04）—
  • 实机验证通过 5.2.03, 5.3.02–5.3.03
webdav-backup全部审核版本（5.0.00–5.3.04）
  • 完整功能需 5.1.00 及以上
  • 编辑器自动备份 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 自动备份工件 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 保存触发的自动备份 不适用于 5.0.00–5.0.06 (更早版本 Cubism 本身无此功能)
  • 实机验证通过 5.1.02, 5.2.00, 5.2.03–5.3.00, 5.3.02–5.3.04
  • 确认边界 5.1.00–5.1.01, 5.1.03, 5.2.01–5.2.02, 5.3.01

实机验证列：取自 validation/cubism-version-matrix/campaign-jobs.json 中每个任务×版本的最新 FINAL 结果并按 triage 分类。基础设施重试、探针漂移与不确定结果一律不列出；无探测版本留空——静态审核始终是所有版本的基线。

按小版本线的能力覆盖

Turboism 将宿主能力划分为 37 个能力组（共 143 项能力）。在全部 20 个已审核版本（5.0.00–5.3.04）中，143 项中的 129 项能力在每个已审核版本上均准入。覆盖率在 5.3.x 上为 100%，5.2.x 上为 97.9%，5.1.x 上最高为 95.1%，5.0.x 上为 90.2%。37 个能力组中的 27 个在所有已审核版本上均完整准入，其余 10 个能力组则因 Cubism Editor 在特定版本才引入相应底层子系统而存在版本下限。因此，版本受支持并不意味着每项功能在每个版本上都可用。

小版本线已审核版本范围构建数准入能力数能力组分布（共 37 组）
5.0.x5.0.00–5.0.067129 / 14327 组完整 · 4 组部分 · 6 组缺失
5.1.x5.1.00–5.1.034135–136 / 14331 组完整 · 4 组部分 · 2 组缺失
5.2.x5.2.00–5.2.034140 / 14335 组完整 · 2 组部分 · 0 组缺失
5.3.x5.3.00–5.3.045143 / 14337 组完整 · 0 组部分 · 0 组缺失

图例：✓ 组内全部能力均准入 · ◐ 部分准入 · ✗ 该小版本线无准入。准入 = 静态验证记录在该版本承认该能力，且所有收窄它的选择器契约与类 pin 表也承认该版本。

能力组5.0.x (5.0.00–5.0.06)5.1.x (5.1.00–5.1.03)5.2.x (5.2.00–5.2.03)5.3.x (5.3.00–5.3.04)
动画与时间线◐ (4/6)◐ (4/6)✓ (6/6)✓ (6/6)
ArtMesh✓ (7/7)✓ (7/7)✓ (7/7)✓ (7/7)
自动摆动读取✗ (0/1)✓ (1/1)✓ (1/1)✓ (1/1)
自动备份✗ (0/2)✓ (2/2)✓ (2/2)✓ (2/2)
剪贴蒙版✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
Cubism Core✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
变形器编辑✓ (5/5)✓ (5/5)✓ (5/5)✓ (5/5)
编辑级别✓ (2/2)✓ (2/2)✓ (2/2)✓ (2/2)
编辑会话✓ (6/6)✓ (6/6)✓ (6/6)✓ (6/6)
编辑器 UI 表面◐ (9/10)✓ (10/10)✓ (10/10)✓ (10/10)
几何读取✗ (0/1)✗ (0/1)✓ (1/1)✓ (1/1)
编辑历史✓ (3/3)✓ (3/3)✓ (3/3)✓ (3/3)
集成桥接✗ (0/2)◐ → ✓ 5.1.02+ (1–2/2)✓ (2/2)✓ (2/2)
网格工具会话✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
网格工具栏贡献✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
其他模型表面◐ (22/23)◐ (22/23)◐ (22/23)✓ (23/23)
模型实例读取✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
建模自定义工具✗ (0/1)✗ (0/1)✓ (1/1)✓ (1/1)
对象层级✓ (4/4)✓ (4/4)✓ (4/4)✓ (4/4)
参数与绑定✓ (7/7)✓ (7/7)✓ (7/7)✓ (7/7)
参数键编辑✓ (5/5)✓ (5/5)✓ (5/5)✓ (5/5)
参数结构编辑✓ (9/9)✓ (9/9)✓ (9/9)✓ (9/9)
部件与检查器◐ (8/10)◐ (8/10)◐ (8/10)✓ (10/10)
部件对象编辑✓ (8/8)✓ (8/8)✓ (8/8)✓ (8/8)
性能统计✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
物理✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
插件 UI 表面✓ (3/3)✓ (3/3)✓ (3/3)✓ (3/3)
项目读取✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
受保护导出✗ (0/1)✓ (1/1)✓ (1/1)✓ (1/1)
PSD 原始图像✓ (3/3)✓ (3/3)✓ (3/3)✓ (3/3)
选区编辑✓ (3/3)✓ (3/3)✓ (3/3)✓ (3/3)
启动抑制✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
纹理与原始图像✓ (3/3)✓ (3/3)✓ (3/3)✓ (3/3)
纹理图集✓ (5/5)✓ (5/5)✓ (5/5)✓ (5/5)
撤销恢复✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
曲面变形器镜像✓ (1/1)✓ (1/1)✓ (1/1)✓ (1/1)
工作区✓ (2/2)✓ (2/2)✓ (2/2)✓ (2/2)
能力标识功能表面准入版本无已验证记录
cubism.autobackup.backup自动备份创建5.1.00–5.3.045.0.00–5.0.06
cubism.autobackup.settings自动备份设置5.1.00–5.3.045.0.00–5.0.06
cubism.editor-model.animation-eval动画求值参数烘焙5.2.00–5.3.045.0.00–5.1.03
cubism.editor-model.animation-timeline.write动画时间线曲线写入5.2.00–5.3.045.0.00–5.1.03
cubism.editor-model.auto-yure.read自动摇动读取5.1.00–5.3.045.0.00–5.0.06
cubism.editor-model.moc-export.read官方 MOC 5.3 导出设置5.3.00–5.3.045.0.00–5.2.03
cubism.editor-model.part-inspector.write部件检查器写入5.3.00–5.3.045.0.00–5.2.03
cubism.editor-model.part-opacity.write部件不透明度写入5.3.00–5.3.045.0.00–5.2.03
cubism.editor-ui.top-menu顶部菜单集成5.1.00–5.3.045.0.00–5.0.06
cubism.geometry.read网格几何读取5.2.00–5.3.045.0.00–5.1.03
cubism.integration.edit-api-bridge.dispatch编辑协议桥接派发5.1.02–5.3.045.0.00–5.1.01
cubism.integration.external-app-settings.edit-toggle外部应用编辑开关5.1.00–5.3.045.0.00–5.0.06
cubism.modeling-tool.selection-brush建模选区笔刷5.2.00–5.3.045.0.00–5.1.03
cubism.protected-export.orchestration受保护导出编排5.1.00–5.3.045.0.00–5.0.06

基于证据的版本边界

Turboism 绝不猜测某项功能在特定 Cubism Editor 构建上是否可用。运行时准入结合了三层证据：

  1. 哈希固定的静态验证记录（VERIFIED_STATIC） — 每个已准入版本都绑定了针对精确 Live2D_Cubism.jar 与 Live2DCubismCore.jar 构件摘要的字节码选择器审核记录。
  2. 选择器契约与类 pin 门禁 — 当特定 adapter 或类 pin 表仅针对部分版本接线时，运行时契约会将能力收窄到对应版本集合。
  3. 已确认宿主边界（version-boundaries.json） — 当某个 Cubism Editor 版本缺少某项功能时，Turboism 会同时核对官方 Live2D Cubism 更新历史与已审核 JAR 字节码，确认后才将其标记为宿主边界；未经确认的缺口绝不会被误标为编辑器缺少该功能。

5.0.00–5.3.04 范围内的关键证据边界包括：

  • 5.0.x（5.0.00–5.0.06）无自动备份与受保护导出 — CModelingDocument::getDocumentUID()（cubism.autobackup.backup、cubism.autobackup.settings 与 EditorAutoBackupService 依赖的文档 UID 身份链）在所有 5.0.x JAR 中均不存在（5.0.x 仅暴露 getFileContentInstanceGuid()）。受保护导出（cubism.protected-export.orchestration 与 ExportSettingsContributionService）在 5.0.x 上同样不可用，因为分阶段导出驱动回调与动态同步设置源是在 5.1.00 引入的。顶部菜单外部应用集成（cubism.editor-ui.top-menu）、EditorCommandService 与自动摇动读取（cubism.editor-model.auto-yure.read）同样始于 5.1.00。
  • 编辑协议（CubismFacade#edit()、cubism.integration.edit-api-bridge.dispatch）要求 5.1.02 或更高版本 — 5.0.x 中完全不存在 com/live2d/cubism/doc/webSocket 包；而在 5.1.00 与 5.1.01 中，会话查找方法为私有且外部应用认证管理器使用单参数调用签名，尚不具备 5.1.02+ 的公共编辑桥接契约。
  • 动画时间线写入与普通视图建模选区笔刷要求 5.2.00 或更高版本 — 时间线曲线类型写入（cubism.editor-model.animation-timeline.write）与求值参数烘焙（cubism.editor-model.animation-eval）依赖 5.2.00 引入的动画轨道与曲线 API；普通视图建模选区笔刷（cubism.modeling-tool.selection-brush、ModelingBrush、ModelingToolRegistry）依赖 5.2.00 引入的建模工具视图上下文监听器 API（5.3.00 进一步新增了笔刷扩张/收缩与圆/方/线笔刷形状）。Core 变形器/胶水几何读取（cubism.geometry.read）、多边形感知纹理图集布局（TextureAtlasPolygonLayoutService）以及原生 PSD 原图导出/替换（ModelTextures#exportRawImagePsd()、replaceRawImagePsd()）也要求 5.2.00 或更高版本。
  • 部件不透明度/检查器写入、Alpha 合成与官方 MOC 5.3 导出要求 5.3.00 或更高版本 — 部件形态不透明度访问器（cubism.editor-model.part-opacity.write）、扩展部件检查器蒙版与混合模式写入（cubism.editor-model.part-inspector.write）、AlphaComposition 以及 cubism.editor-model.moc-export.read 仅存在于 5.3.00–5.3.04。

运行时能力查询

插件绝不应直接按 Cubism Editor 版本号字符串分支，而应查询能力就绪状态：

  • CubismFacade 的每个访问器都会返回带 isAvailable() 方法的哨兵对象，用于报告当前宿主是否准入该能力；
  • EditorCommand#supports(String) 与 supportedVersions() 在运行时暴露逐命令的支持版本集合；
  • 带有 @CubismEditor 注解的 SDK 表面在宿主未准入时，会以 CubismEditorApiUnavailableException 失败关闭。

关于 Turboism 如何隔离特定版本的宿主访问，请参阅 SDK API 指南与映射层。

安装

在不会修改 Cubism 安装的情况下，从已发布的发行安装包安装 Turboism。

安装器与便携 ZIP

在 Windows 安装器与便携 ZIP 之间做出选择，了解安装器选项及历史安装包变迁。

本页目录

各 Turboism 版本的支持范围同一小版本线内的补丁连续性第一方插件兼容性按小版本线的能力覆盖基于证据的版本边界运行时能力查询