ComfyUIのサブグラフでノードを整理しよう

※2026/07/24 追記
　ComfyUIのv0.28.0-33-gfeca51a8 (2026-07-23)による変更を追記しました。

前回↓までで、Detalerを組み込み込んだ（画像１）事で、ノードが増えて煩雑になりました。
https://membership.chichi-pui.com/posts/images/a23135f8-68c4-42e0-93b5-8ca579eba927/

合わせて、seedとsampler・schedulerを外出しにしたため、接続する線が増えてしまいました。

そこで今回は、サブグラフ機能を使ってノードと接続線を整理します。
※サブグラフ機能とは、複数のノードを纏めてしてしまう機能です。
　纏める事で元のフローが簡潔になり、見やすく整理もできます。
　また、纏めたノードはコピーペーストが可能で、別のフローに流用し易くなります。

１．先にseedとsampler・schedulerの線を簡単に整理します。
　　RerouteノードでKSampler、FaceDetailer、Detalerへの接続を芋づる式に繋げておきます（画像２）。

２．纏めるノードを選択して、任意のノードを右クリックします。
　　表示されたコンテキストメニューから「サブグラフに変換」をクリックします。
　　もしくはノード選択後、選択メニュー（ノードを選択した際に上に表示されるメニュー）から、「選択範囲をサブグラフに変換（四隅から矢印が内に向かっている）」アイコンをクリックします。（画像３）。

３．選択した複数のノードが一つのノードに纏まります（画像4）。
　　※ここのままでも使えなくは無いですが、見栄えが悪いですし接続線が整理できませんので、サブグラフの内容を編集します。

４．サブグラフ化されたノードをダブルクリックするか、タイトル右にある編集（四角に斜めの矢印の付いた）アイコンをクリックすると、サブグラフの編集モードになります（画像５）
　　※元のフローに戻る時は、キャンパス左上の「グラフ」の左側にある「戻る（曲がった矢印）」アイコンをクリックするか、「Esc」キーを押して下さい（画僧６）。

５．入力・出力の端子（スロット）を編集します（画像７～１１）。
　　入力・出力のスロットの順番は合わせる様にして下さい（並び順はお好みで）。
　　スロットを右クリックするとメニューが出ます（画像７）。
　　・Disconnect Links・接続を外す
　　・Rename Slot：スロットの名前変更（ダブルクリックでも可）（画像９）
　　・Remove Slot：スロットを削除
　　　※各スロットは、接続していた線のデータ形式が保存されています。
　　　　元のデータ形式と異なるデータ線は接続できませんので、一度削除してから繋ぎ直して下さい。
　　スロットの編集が終わると、画像１２の様になります。
　　※入力スロットから出力スロットへ直接繋ぐ事は出来ません、何らかのノード（Rerouteなど）を経由して下さい。

６．次に設定項目（良く変更する可能性のある項目）を選んで、表に表示させる設定をします（画像１３）。
　　※Detailerなら、モデル、steps、cfg、denoiseなど
　　設定項目を右クリックして表示されるコンテキストメニューから「ウィジットを昇格」をクリックします。

　　全て設定し終わったら、編集モードを抜けてフローに戻ります。
　　端子名と設定項目が表示されたノードが出来上がります（画像１４）。

　　※2026/07/24 追記
　　　「ウィジットを昇格」を行った入力項目は全て入力スロットに強制的に接続されるようになりました。

７．他にサブグラフ化したノードを全て同様に行います（画像１５）。
　　必要な接続も全て行って下さい。

８．このままでも使えますが、画像生成中のプレビューが表示されないので、表示されるようにします。
　　そのためには一度生成を行い、ノード上にプレビューが表示されている状態にします（画像１６）。
　　※サブグラフ機能が搭載された当初は、何もしなくても表示されていましたが、アップデートで表示されなくなりました💦
　　※2026/07/24 追記
　　　プレビューの表示自体出来なく成りました💦
　　　もしかしたら、入力スロットに繋ぐ口が無いからかも知れません。
　　　今は、画像出力からプレビューを繋ぐかKサンプラーを外出しにするしかありません。

９．サブグラフの編集状態にします。
　　ノードのプレビューを右クリックして表示されるコンテキストメニューから「ウィジットを昇格」をクリックします（画像１７）。

１０．全てのサブグラフで設定が終われば、サブグラフ化と線の整理は完了です（画像１８）。
　　　ノードの位置やサイズを調整して使いやすくしましょう。

入力・出力の端子の順番を合わせた事で接続線が綺麗に揃っています。
サブグラフのノードは普通のノード同様、コピーペーストで増やす事が出来ます。
増やしたDetailerは検出モデルを変更する事で、違う部位のDetailerになります。
接続線も揃った状態なので、簡単に増設可能です（画像１９）。

サブグラフは便利な機能ですので、色々触って研究してみてください。

--------------------------------------------------------------------------------------------------------
おまけ１
設定項目の表示順番を変更したい場合。
※ウィジット項目は昇格を行った順に表示されますが、後から順番を変更する事もできます。

・サブグラフのノードを右クリックして表示されるコンテキストメニューから「サブグラフウィジットを編集」をクリックします（画像２０）。
・キャンパスの左側にウィジットの一覧が表示されます（画像２１）。
・順番を変更したい項目の左端の（点が６個並んだ）アイコンをドラッグして上下に移動できます。
　目的の位置でマウスのボタンを離して下さい。
　※この画面を開くと、サブグラフのノードのサイズが小さくなりますｗ

--------------------------------------------------------------------------------------------------------
おまけ２
右クリックしても「ウィジットの昇格」が表示されない項目欄を表示したい場合。
２通りあります。

１．入力欄をサブグラフの入力端子と繋ぎます。
　　※入力端子と接続した入力欄は表示されるようになります。
　　　なお、前のノードからの入力は必要だが表示させたくない場合は、Rerouteノード経由で接続します。
　　　上の作業でseed、sampler、schedulerの入力欄が表示されないのはこの為。

２．「サブグラフウィジットを編集」画面から、目的の項目左端の「表示（目に斜め線が入った）」アイコンをクリックして表示状態にします。
　　入力端子が無い又は、入力させたくない場合などに使います。
　　※表示されていない項目は「非表示／ネストされたパラメータ」にあります。
　　　表示状態にした項目は「ノード上で表示」に移動されます。

--------------------------------------------------------------------------------------------------------
おまけ３
設定項目の表示名を変更したい場合。

複数のノードを使うと設定項目名が同じ場合が出てきます。
両方表示させる場合、同じ名前では区別が付きません。
その場合は、設定項目を右クリックして表示されるコンテキストメニューから「ウィジット名を変更」で変更可能です（画像１２）。

※2026/07/24 追記
　入力スロットに表示されている表示名が使用される様になりました。
　「ウィジット名を変更」で変更した後に「ウィジットを昇格」を行うと入力スロットに表示はされますが、サブグラフ上に即時反映はされません（一度開き直せば表示される）。
　スロットの名称を変更した場合は即時反映されます。
　スロットの名称を変更した後で「ウィジット名を変更」で変更しても反映されません。
　スロット名が優先されます。