ComfyUI_frontendのノード編集面を検証する

ComfyUI公式フロントエンドの位置

リポジトリの説明によると、ComfyUI_frontend は ComfyUI の公式フロントエンド実装です。プロジェクトは TypeScript で書かれ、Comfy-Org 組織によって保守されています。独立した製品ではなく、ComfyUI に同梱されるインターフェースであり、ノードグラフ、サイドバー、設定とのユーザー操作を定義します。README は内部アーキテクチャについてそれ以上説明していないため、ビルドシステムやレンダリングエンジンの詳細はこのソースからは得られません。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、ComfyUI公式フロントエンドの位置に対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

リリース凍結とnightlyの流れ

プロジェクトは各マイナーバージョンに対して 3 段階のリリースプロセスを採用しています。2 週間の開発期間の後、2 週間の機能凍結期間があり、その間はバグ修正のみがリリースブランチに取り込まれます。リリースは凍結期間の終了時に公開されます。ナイトリービルドは毎日公開され、ユーザーは ComfyUI 起動スクリプトにコマンドライン引数 `--front-end-version Comfy-Org/ComfyUI_frontend@latest` を追加することで使用できます。後続のマイナーバージョンは重複して開発されます。あるマイナーが凍結されている間に次のマイナーの開発が始まるため、各機能はマージから安定版リリースまでおよそ 4 週間かかります。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、リリース凍結とnightlyの流れに対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

検索、キュー、サイドバーの操作

README には、特定のバージョンで追加された主要機能がリストされています。v1.5 ではネイティブ翻訳（i18n）が導入され、サードパーティの翻訳拡張が不要になり、Comfy > Locale > Language で英語、簡体字中国語、ロシア語、日本語、韓国語、アラビア語を選択できます。v1.4 では新しいマスクエディタが追加されました。v1.3.22 では Ctrl + `（バッククォート）で切り替える統合サーバーターミナルが追加されました。v1.3.7 ではキーバインドのカスタマイズが追加されました。v1.2.4 ではドラッグ＆ドロップとフィルタリングを備えたノードライブラリのサイドバータブが追加されました。v1.2.0 ではキュー/履歴のサイドバータブが追加されました。v1.1.0 ではファジー検索とノードプレビューを備えたノード検索ボックスが追加されました。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、検索、キュー、サイドバーの操作に対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

Litegraphキャンバスの編集機能

Litegraph ベースのキャンバスを対象とした多数の品質改善があります。ネストされたグループ（v1.3.32）、グループ選択（v1.3.24）、リンクの可視性の切り替え（v1.3.6）、ウィジェットにリンクをドロップすると自動的に入力に変換（v1.3.4）、キャンバスが読み取り専用になるパンモード（v1.3.4）、Shift ドラッグで新しいリンクを作成（v1.3.1）、オプションの入力スロットをドーナツとして表示（v1.2.62）、グループタイトルをダブルクリックして編集（v1.2.44）、Ctrl + G で選択ノードをグループ化（v1.2.39）、ノードタイトルをダブルクリックして編集（v1.2.38）、Shift で複数リンクをドラッグ（v1.2.7）、正しいスロットに自動接続（v1.2.2）、ウィジェット値のテキストオーバーフローを非表示（v1.1.8）などです。README には各項目のビデオまたは画像が含まれていますが、正確な動作は簡潔にしか説明されていません。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、Litegraphキャンバスの編集機能に対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

拡張機能向けダイアログAPI

README には、最近のバージョンで追加された複数の拡張 API が記載されています。v1.6.13 では、window.prompt、window.confirm、window.alert の代替が導入されました。これらのブラウザ API は ComfyUI デスクトップの Electron 環境では利用できないため、拡張機能は app.extensionManager.dialog.prompt、.confirm、app.extensionManager.toast.addAlert を使用する必要があります。v1.3.34 では、拡張機能がアバウトパネルにバッジを登録できます。v1.3.22 では、ボトムパネルタブの登録と、従来の app.ui.settings を app.extensionManager.setting に置き換える新しい設定 API が追加されました。v1.3.7 では、コマンドとキーバインドを登録する方法が追加されましたが、コアのキーバインドは上書きできず、一部はブラウザによって予約されています。v1.3.1 ではカスタムトップバーメニュー項目、v1.2.27 ではトーストメッセージ、v1.2.4 ではカスタムサイドバータブ、v1.10.9 ではキャンバス上でアイテムが選択されたときにコマンドを表示する選択ツールボックス API が追加されました。README は各 API のコードスニペットを提供し、サポートされるトーストオプションとアイコンリストについては PrimeVue ドキュメントを参照しています。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、拡張機能向けダイアログAPIに対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

i18nと開発用ドキュメント

リポジトリは貢献を歓迎しており、CONTRIBUTING.md ファイルを参照しています。そこには貢献方法（コード、ドキュメント、テスト、コミュニティサポート）、開発環境とワークフロー、コードスタイルガイドライン、テスト要件、プルリクエストの提出、リリースブランチへの修正のバックポートが含まれています。i18n 作業については、README は src/locales/README.md を参照しています。コンポーネント開発とビジュアルテストについては、.storybook/README.md を参照しています。README 自体には開発環境の説明がないため、ローカルでプロジェクトをビルドする予定の人は、リンクされたドキュメントを確認する必要があります。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、i18nと開発用ドキュメントに対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

GPL-3.0と導入前の確認

トラブルシューティングについては、README は公式 ComfyUI ドキュメントへのリンクを提供しており、一般的な問題、カスタムノードの問題、デスクトップインストールを扱っています。プロジェクトは GPL-3.0 ライセンスで提供されています。GPL-3.0 ライセンスは、コピーの配布、ソースコードの受領、ソフトウェアの変更の自由をユーザーに与えますが、このフリーソフトウェアには保証がないことも明記しています。ライセンス本文は、サポートの約束、セキュリティ態勢、本番環境での利用可否については言及しておらず、これらはリポジトリのメタデータや README でも扱われていません。

Comfy-Org/ComfyUI_frontendについてREADMEが明記する範囲をこの章で確認する。導入前には、GPL-3.0と導入前の確認に対応するコマンド、ファイル、設定名、対応対象を本文と一次資料で照合し、記載のない性能や互換性を推定しない。

編集部の結論

ComfyUI_frontend は ComfyUI ユーザーが直接操作するインターフェースであり、リリースノートにはインターフェースの改善と拡張 API の着実な流れが示されています。README はリリースサイクルの全体像を示していますが、詳細な開発者ガイドやトラブルシューティングについては、リンクされたドキュメントが次のステップです。 採用候補にする場合は、Comfy-Org/ComfyUI_frontend固有のREADMEにある対象環境、入力形式、設定ファイル、実行手順を固定し、記載された出力または画面上の結果を確認してから範囲を決める。資料にない性能、互換性、サポートは前提にしない。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes