ComfyUI-MiniMaxH3-CLIPCached: H3条件付け用ディスクキャッシュ
新しいComfyUIノードがMiniMax H3 Qwen3-VLの条件付けをディスクにキャッシュします。同じプロンプトでの再実行時は14.6 GBのエンコーダーをスキップし、条件付け時間が29.9秒から1.1秒に短縮されます。
キャッシュノードは標準のH3条件付けノードを置き換えます。拡散ステージは変更されません。
キャッシュするものと、キャッシュしないもの
これはサンプリング高速化ツールではありません。TeaCacheやFirstBlockCacheではなく、サンプリングステップにも関与しません。このノードはComfyUI標準のH3条件付けノードを置き換えるもので、キャッシュヒット時はQwen3-VLエンコーダーを実行する代わりに、以前に計算したテキスト/ビジョン条件付けをディスクから読み込みます。拡散ステージは変更なしで進行します。
| 変更内容 | 新しいキャッシュエントリが作成されるか |
|---|---|
| プロンプトテキスト | はい |
| エンコーダーのcheckpoint | はい |
| エンコーダーから見えるキーフレーム/参照ピクセル | はい(エンコーダーから見えるコンテンツが変わった場合) |
| シード、サンプラー、スケジューラー、ステップ数 | いいえ |
| 後段のLoRAまたは強度 | いいえ |
この分類は反復的なワークフローで重要です。同じプロンプトでサンプラー設定やLoRAウェイトだけを調整して再実行する場合、初回以降のすべての実行がキャッシュヒットになります。
測定結果
作者が実施した統制ベンチマーク(各モード5ケースの中央値、WSL2上のRTX 5080 16 GB、ネイティブとキャッシュミスでは意図的にエンコーダーをコールドリード):
| モード | 条件付け | ピークVRAM | ピークプロセスRAM |
|---|---|---|---|
| ネイティブ | 29.85秒 | 15.24 GiB | 29.25 GiB |
| キャッシュミス | 32.23秒 | 15.24 GiB | 28.25 GiB |
| キャッシュヒット | 1.12秒 | 2.67 GiB | 3.38 GiB |
キャッシュミスは意図的に高速パスにはなっていません。エンコーダーを実行して結果をディスクに書き込むため、約2秒の追加時間がかかります。ただし、エンコード後はエンコーダーを常駐させずにアンロードするため、その分のメモリを解放した状態でサンプリングが実行されます。作者のスクリーンショットでは、ネイティブモードはサンプリング中に11.7 GBのH3モデルと14.6 GBのエンコーダーの両方を常駐させますが、キャッシュヒット時はDiTのみが読み込まれた状態になり、プロセスRAMは40 GBから25.5 GBに低下します。
ノードとキャッシュ管理
このパックには、標準のH3 Image-to-Video(FL2VA)ノードとReference-to-Video(Ref2VA)ノードのキャッシュ対応版に加え、ベースパスとアップスケールターゲットの両方に向けた条件付けを準備するデュアル解像度バリアントと、共通のエンコーダー名セレクターが含まれます。
一意の条件付けリクエストごとにキャッシュエントリが作成され、削除されるまで保持されます。頻繁に反復作業を行うとエントリが蓄積されていきます。内蔵のキャッシュマネージャーパネルで、エントリの閲覧、タグ付け、整理が行えます。要件は、ネイティブH3ノードを備えたComfyUI 0.30.0以降です。
入手方法
このノードはComfyUI Managerとレジストリに minimaxh3-clipcached として登録されています。または リポジトリ を custom_nodes にクローンしてください。現在のバージョンには自動キャッシュ削除機能はなく、Ref2VAは固定の参照スロットを使用し、GGUFエンコーダーは未テストです。
コメント
GitHubでサインインしてディスカッションに参加しましょう。