Turboism

開発状況

現在の Turboism コードベースが実装しているもの、Preview として残っているもの、まだ製品上の約束ではないもの。

Turboism は、Live2D Cubism Editor 向けの Java 17 ランタイム拡張ツールおよびプラグインフレームワークです。開発は、廃止された M1–M16 移行シーケンスではなく、利用可能なフレームワークと製品機能を中心に進められています。

このページは現在の開発ブランチをソースに基づいて切り取ったスナップショットです。リリース告知ではありません。

現在のアーキテクチャ

Plugin -> SDK -> Runtime policy -> versioned Adapter/Provider -> Cubism/Editor

プラグインが依存するのは Turboism SDK だけです。ホストへのアクセス、ライフサイクル、安全性、スレッド、トランザクション、診断、互換性、バージョンルーティングは Runtime が担います。

実装済みのフレームワーク基盤

  • Java Agent bootstrap、Runtime、SDK、first-party plugin、test-framework、integration-test モジュール。
  • ローカルプラグイン JAR の検出、マニフェストと API 範囲の検証、依存関係の解決、プラグインごとの ClassLoader、ライフサイクル実行、逆順シャットダウン、scope/ClassLoader のクリーンアップ。
  • 順序付き複数エントリポイントと JAR 全体の起動ロールバックを備えたプラグインマニフェスト v2。
  • ロギング、パス、ローカライズ、タスク、設定、ストレージ、ユーザーファイル、イベント、アクション、UI 貢献、Cubism アクセス、診断のための PluginContext サービス。
  • ローカル JAR の install、replacement、enable、disable、uninstall を行う Preview マネージド管理。変更は journal にステージングされ、Cubism の再起動後に適用されます。core plugin は保護されます。
  • startup preflight は適用前にステージング済み payload の identity（SHA-256、size、descriptor hash）を再検証し、private backup/restore が失敗した置換適用を保護します。

インストーラーと配布

実装済みのインストーラーは 2 つあり、同じステージング済み payload と Lite/Full モデルを共有しています。

  • Windows ネイティブの NSIS インストーラー（TurboismInstaller-<version>.exe）。Windows ではこちらを優先します。
  • Java 17 の IzPack インストーラー（TurboismInstaller-<version>.jar）。Windows/macOS のインストールセマンティクス向けに実装されています。

Windows EXE は、ユーザー単位のインストール、Lite/Full と first-party plugin の選択、スタートメニュー項目、アンインストールをカバーします。インストーラー JAR は Windows と macOS で同じ Lite/Full 選択を提供し、プラットフォームのアンインストールサポートを生成します。どちらも Cubism のインストールファイルを変更しません。これらの実装は、release または preview チャネル向けにインストーラーパッケージを生成しますが、署名・ノータリゼーション済みの公開チャネルはまだ存在しません。

Cubism と Editor API の進捗

  • 統合された Preview オブジェクトグラフが Canvas、Parameters、Parameter Groups、Parts、Drawables、Deformers、Glue、パラメータバインディングをカバーします。
  • Cubism 5.2 と 5.3.02 の Core-backed read は、不変のコピー済みデータ、バージョン正規化、generation に束縛された stale-reference 拒否、digest-pinned resolver evidence を使用します。
  • Cubism 5.3.02 のパラメータ編集経路は、Parameter.setValue を Editor 操作、権限チェック、Undo、dirty-state 処理、refresh、stale-target 拒否に接続します。
  • Part display-name の書き込みには 5.2.03 と 5.3.02 で実ホストの証拠があります。
  • Part opacity の編集書き込みには 5.3.02 で証拠があります。観測された evaluation setter がネイティブ Part Undo に参加しなかったため、5.2.03 では意図的に利用できません。
  • Parameter lifecycle hook は、順序付き同期 before 書き換え、変更時のみの on、正常完了時の after、再帰拒否、上限付き観測処理、アンロード時のクリーンアップをサポートします。
  • first-party Parameter CSV workflow は現在、統合された CubismModel と Parameter API を使用します。

共有プラグインサービスと UI

SDK には次の契約が含まれます。

  • アクションとメニュー。
  • main と palette toolbar。
  • 型付き context menu。
  • toolkit-neutral embedded panel。
  • overlay、status notification、dialog、file selection。
  • 型付きプラグイン設定と migration。
  • プラグイン所有のデータ、状態、cache storage。
  • 上限付きタスクとキャンセル。
  • 非同期ホスト読み取り。
  • ローカライズと診断。
  • appearance、scene-table、選択された Editor feature family。

対応する Provider または検証済みホスト capability が利用できない場合、ホストと UI の各 family は fail closed します。Fake または static test だけでは、実ホスト対応の準備が自動的に確立されることはありません。

Official Directory の状況

組み込みの署名済み Official Directory client と UI は実装されていますが、本番アクティベーションは未準備です。本番 key list は空で、ライブ署名済み catalog の準備は確立されていません。ライブマーケットプレイスではありません。

進行中またはバージョン制限付き

  • 多くの unified-object write method は、特定のバージョン Provider に依存しています。インターフェースにメソッドがあることは、サポート対象のすべての Cubism バージョンで実行できることを意味しません。
  • Cubism 5.2 Editor-authoring の完全な matrix は、いくつかの operation family でまだ不完全です。
  • Project、selection、model-tree、その他の semantic Editor API は引き続き進化しています。
  • Drawable、Deformer、Glue、mesh、PSD、texture-atlas の write と workflow には、利用者主導の実装と正確な検証が必要です。
  • Host UI attachment、高頻度 hook、実ホスト対応は、正確なバージョンゲートを伴う高リスク境界として残っています。
  • SDK HTML Javadoc は生成でき、このサイトで公開されていますが、多くの public declaration にはより詳しい説明コメントがまだ必要です。

現在約束されていないもの

Turboism は現在、次のものを約束していません。

  • 署名・ノータリゼーション済みのインストーラーパッケージの公開リリースチャネル。
  • 検証済みの macOS Cubism ホスト起動。
  • 自動オンライン更新または本番利用可能なマーケットプレイス。
  • publisher signing または revocation。
  • 完全なユーザー向け immutable-generation install、repair、rollback、recovery、purge UI。
  • Cubism launcher のグローバルな変更。
  • すべての Cubism バージョンに対する一様な対応準備。
  • Preview、fake、static、または単一バージョンの証拠だけに基づく本番対応。

近い将来の順序

  1. unified object と reference model を完成させる。
  2. Core reads と version-routed Providers を完成させる。
  3. 検証済み consumer から Undo を伴う Editor-owned writes を拡張する。
  4. operation lifecycle semantics を標準化する。
  5. project、selection、model-tree API を完成させる。
  6. SDK-only plugin によって first-party workflow を復元する。
  7. 明示的 API、refresh、polling、callback で不十分な場合に限り hook を追加する。
  8. third-party SDK、packaging、release evidence を強化する。

ソースレベルの背景については、Turboism repository と、その ARCHITECTURE.md および ROADMAP.md ファイルを参照してください。

トラブルシューティングとフィードバック

Preview の起動、プラグイン JAR、ライフサイクル、権限、Provider の失敗を診断する。

このページ

現在のアーキテクチャ実装済みのフレームワーク基盤インストーラーと配布Cubism と Editor API の進捗共有プラグインサービスと UIOfficial Directory の状況進行中またはバージョン制限付き現在約束されていないもの近い将来の順序