comfyui-nodes-dev

ComfyUI V3 カスタムノード（サーバーサイド）

ComfyUI のベースライン：v0.12.0（Comfy API v0_0_2）。このスキルを改訂する際は、この行を更新してください。

対象範囲

• サーバーサイドの V3 ノード（Python）に焦点を当てます。
• クライアント・サーバー拡張パターンとフロントエンド専用の拡張は対象外です。

クイックワークフロー

1. API アダプターを選択します：安定性を重視する場合は comfy_api.v0_0_2、最新機能を使う場合は comfy_api.latest を選択します。
2. （任意）comfy node scaffold を使ってノードパックのスキャフォールドを作成します。
3. io.ComfyNode.define_schema() と execute() を使って V3 ノードを実装します。
4. execute() から io.NodeOutput（またはタプル／辞書）を返します。
5. ComfyExtension.get_node_list() と comfy_entrypoint() を使ってノードを登録します。
6. ComfyUI を再起動し、UI／API で動作を検証します。

すること／しないこと

• define_schema() と execute() のクラスメソッドを使用します。
• execute() から io.NodeOutput（またはタプル／辞書）を返します。
• UI プレビューには ui.Preview* ヘルパーを使用します。
• ノードに変更可能なインスタンス状態を保存しないでください。
• クライアント・サーバー拡張パターンは使用しないでください（このスキルの対象外です）。

リファレンスマップ

必要に応じて、以下のリファレンスを参照してください（段階的に開示されます）。

• references/v3-core.md：API バージョン、ComfyExtension、進捗報告。
• references/io-types.md：IO 型、ウィジェット入力、カスタム型。
• references/schema-nodeoutput.md：スキーマフィールド、フラグ、非表示入力、NodeOutput パターン。
• references/ui-helpers.md：UI 出力用のプレビューおよび保存ヘルパー。
• references/scaffold.md：スキャフォールドのワークフローと V3 のデフォルト設定。
• references/lazy-evaluation.md：遅延入力、check_lazy_status、実行のブロック。
• references/validation-and-caching.md：validate_inputs と fingerprint_inputs のパターン。
• references/folder-paths-and-files.md：folder_paths ヘルパーと保存／読み込みパターン。
• references/image-mask-performance.md：テンソル形状、リサイズ、バッチ処理、デバイスに関するヒント。
• 公式ドキュメント：Comfy-Org/docs custom-nodes

テンプレート

• assets/v3_extension_template.py：最小構成の V3 ノード、拡張機能、エントリーポイント。