nodes/Tsubasa109-ComfyUI-TemplateReference
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
Tsubasa109-ComfyUI-Template…/README_ja.md
T
ツバサ天九 a857f97961 Update README_ja.md
2026-05-31 17:10:20 +09:00

8.8 KiB
Raw Permalink Blame History

ComfyUI Template Reference

ComfyUI Template Reference は、ComfyUI 内で再利用可能なテキスト、画像、プロンプトテンプレートのライブラリを作成するためのカスタムノードを 2 つ追加します。

お知らせ

  • 2026年5月31日 -アップデート。プロンプトテンプレートにLoRA適用機能を追加した"Prompt Template LoRA"ノードを追加しました。

機能

テンプレート参照機能

  • 編集可能なテキスト参照ブロックを作成できます。
  • 画像をアップロードし、画像参照ブロックとしてプレビューできます。
  • 各ブロックをリストとして JSON ファイルに保存・読み込みできます。
  • Output ドロップダウンから特定のブロックを選択し、選択したテキストまたは画像をほかの ComfyUI ノードへ出力できます。
  • ブロックをドラッグして並べ替えできます。
  • ノード UI 上で、ブロックの折りたたみ、展開、リサイズ、コピー、削除ができます。
  • ユーザーが作成した JSON データは、ComfyUI の user ディレクトリに保存されます。

プロンプトテンプレート機能

  • プロンプトテンプレートを作成し、各ブロックごとにプロンプトのタイトルとプロンプトテキストを設定できます。
  • 各ブロックのプロンプトテンプレートには画像をアップロードし、画像参照としてプレビューできます。
  • 各ブロックをリストとして JSON ファイルに保存・読み込みできます。
  • Output ドロップダウンから特定のブロックのプロンプトテンプレートを選択し、選択したプロンプトをほかの ComfyUI ノードへ出力できます。
  • ブロックをドラッグして並べ替えできます。
  • ノード UI 上で、ブロックの折りたたみ、展開、リサイズ、コピー、削除ができます。
  • ユーザーが作成した JSON データは、ComfyUI の user ディレクトリに保存されます。

プロンプトテンプレートLoRA適用機能

  • プロンプトテンプレート機能に追加してLoRAテンプレートにLoRA適用を追加できます。
  • ユーザーが作成した JSON データは、ComfyUI の user ディレクトリに保存されます。
  • プロンプトテンプレート機能で保存したJSONデータも読み込んで反映します。

ノード

Template Reference

Template Reference Node

このノードは、テキストと画像の参照をまとめて管理するために使用します。

出力:

  • select_text: 選択されたテキストブロックのテキスト。
  • select_image: 選択された画像ブロックの画像。
  • template_json: ノード状態全体をシリアライズしたもの。

主な操作:

  • Open / Save: Template Reference の JSON ライブラリを読み込み、または保存します。
  • Output: 出力へ送信するブロックを選択します。
  • List Off / List On:各ブロックをオフ/オンにする
  • Hide All / Show all:各ブロックを隠す/見せる
  • Add Textbox: テキスト参照ブロックを追加します。
  • Add LoadImage: 画像参照ブロックを追加します。
  • Hide / Show:対象ブロックを隠す/見せる。
  • Copy:テキストボックスの内容をクリップボードにコピーする
  • Fit:ブロックのテキスト/画像のサイズに合わせて最適化する
  • Delete:ブロックを削除する
  • Upload:参照画像をアップロードする

Prompt Template

Prompt Template Node

このノードは、再利用可能なプロンプトテンプレートをまとめて管理するために使用します。

出力:

  • selected_prompt: 選択されたプロンプトブロックのテキスト。
  • prompt: 同じ選択済みプロンプトテキストです。利便性のための出力です。
  • template_json: ノード状態全体をシリアライズしたもの。

主な操作:

  • Open / Save: Prompt Template の JSON ライブラリを読み込み、または保存します。
  • none: 空のプロンプトを出力します。
  • Output: テキスト出力へ送信するテンプレートを選択します。
  • List Off / List On:各ブロックをオフ/オンにする
  • Hide All / Show all:各ブロックを隠す/見せる
  • Add Template: プロンプトテンプレートブロックを追加します。
  • Hide / Show:対象ブロックを隠す/見せる。
  • Image: 各プロンプトブロックの任意の参照画像エリアを表示または非表示にします。
  • Copy:プロンプトのテキストボックスの内容をクリップボードにコピーする
  • Fit:ブロックのテキスト/参照画像のサイズに合わせて最適化する
  • Delete:ブロックを削除する
  • Upload:参照画像をアップロードする

Prompt Template LoRA

Prompt Template Node

このノードは上記の「Prompt Template」に加えてLoRAの適用をします

入力:

  • model: モデルの入力
  • clip: clipの入力

出力:

  • selected_prompt: 選択されたプロンプトブロックのテキスト。
  • prompt: 同じ選択済みプロンプトテキストです。利便性のための出力です。
  • lora_model: LoRA適用したモデルの入力
  • loraclip: LoRA適用したclipの入力
  • template_json: ノード状態全体をシリアライズしたもの。

主な操作:

  • Open / Save: Prompt Template LoRAまたはPrompt Template の JSON ライブラリを読み込み、または保存します(ファイル名の末尾に"lora"と付きます)。
  • none: 空のプロンプトを出力します。
  • Output: テキスト出力へ送信するテンプレートを選択します。
  • List Off / List On:各ブロックをオフ/オンにする
  • Hide All / Show all:各ブロックを隠す/見せる
  • Add Template: プロンプトテンプレートブロックを追加します。
  • Hide / Show:対象ブロックを隠す/見せる。
  • LoRA:LoRA画面を開く
  • Image: 各プロンプトブロックの任意の参照画像エリアを表示または非表示にします。
  • Copy:プロンプトのテキストボックスの内容をクリップボードにコピーする
  • Fit:ブロックのテキスト/参照画像のサイズに合わせて最適化する
  • Delete:ブロックを削除する
  • Upload:参照画像をアップロードする
  • LoRA画面:ComfyUIのloraフォルダから適用するLoRAモデルを選択
  • STRENGTH:LoRAの影響力の数値を調整できる。

インストール

このリポジトリを ComfyUI の custom_nodes ディレクトリにクローンします。

cd ComfyUI/custom_nodes
git clone https://github.com/Tsubasa109/ComfyUI-TemplateReference.git

インストール後、ComfyUI を再起動してください。

保存場所

この拡張機能は、ComfyUI の user ディレクトリ配下にローカル保存用フォルダを自動作成します。

ComfyUI/user/template_reference/prompt_templates/
ComfyUI/user/template_reference/prompt_templates/images/
ComfyUI/user/template_reference/reference_templates/
ComfyUI/user/template_reference/reference_templates/image/
ComfyUI/user/template_reference/prompt_templates_lora/
ComfyUI/user/template_reference/prompt_templates_lora/image/

これらのフォルダには、ユーザーが作成した JSON ライブラリと、コピーされた参照画像が保存されます。

注意事項

  • 参照画像は JSON ファイル内に埋め込まれません。JSON には画像のメタデータが保存され、拡張機能がアップロード画像を保存フォルダへコピーします。
  • 保存済み画像が見つからない場合でも、ノードはワークフローを継続し、小さなプレースホルダー画像を返しながら警告をログに記録します。
  • 実行時に使用される保存フォルダは Git の管理対象外であり、リポジトリにコミットしないでください。

ファイル形式

  • すべての JSON テンプレートファイルは UTF-8、BOM なしで保存されます。
  • 日本語を含む非 ASCII 文字は、エスケープシーケンスではなく、そのまま JSON に保存されます。
  • 保存済み JSON ファイルを外部エディタで開く場合は、エディタの文字コードが UTF-8 に設定されていることを確認してください。

必要要件

  • ComfyUI

ライセンス

Apache License 2.0 (see LICENSE)

Reference in New Issue View Git Blame Copy Permalink