ノード操作ガイド (Working with Nodes)

このページでは、キャンバス上でワークフローを構築する際の日常的な操作方法について解説します。ノードの追加、選択、移動、名前の変更、複製、ロック、削除、ノード間の配線接続、およびパラメータの編集方法を網羅しています。構築したワークフローの実行についてはワークフローの実行を、ノードのグループ化についてはノードのグループ化を参照してください。

ノードの追加

Add Node（ノード追加）メニューを開くには、主に 3 つの方法があります：

キャンバス上にカーソルを置いた状態で Tab キーを押す。
キャンバス上にカーソルを置いた状態で Shift+A を押す。（カーソルがキャンバス外にある状態で Shift+A を押すと、代わりにすべてのノードが選択されます。選択と移動を参照）。
キャンバスの空いている場所を右クリックし、Add Node を選択する。

メニューはカーソル位置に開き、ノードを選択するとその場所に新しいノードが配置されます。メニューはカテゴリ分けされた検索可能なリストになっており、ノード名、説明文、またはタグを入力して絞り込むか、カテゴリツリーを展開して探すことができます。お気に入り登録（ノードに星を付ける）がある場合は Favorites セクションが、直近で追加したノードがある場合は Recent セクションがカテゴリリストの上に表示されます。

また、左サイドバーの Nodes タブからノードの種類をキャンバス上へ直接ドラッグ＆ドロップすることでも追加できます。

選択と移動

ノードをクリックして選択します。Cmd/Ctrl+A を押すとフロー内のすべてのノードが選択され、Escape を押すと選択が解除されます。キャンバスの空いている場所からドラッグして矩形選択枠を描くことで、枠内のすべてのノードを一括選択できます。

Shift キーを押しながら（または Cmd/Ctrl を押しながら）別のノードをクリックすることで、複数選択に追加できます。複数のノードが選択されている状態でいずれかをドラッグすると、選択されたすべてのノードがまとめて移動します。また、選択範囲の上部にフローティングツールバーが表示され、選択中のすべてのノードに対して一括で適用できるアクション（Copy、Duplicate、Lock、Reset、Delete、Create Group など。Settings → Editor → Button Customization でカスタマイズ可能）が表示されます。

矢印キーを押すと、その方向に最も近いノードへ選択が移動します。マウスを使わずに接続されたノードのチェーンを素早く移動するのに便利です。F キーを押すと現在の選択ノード（何も選択されていない場合はグラフ全体）が画面中央にフィット表示されます。Shift+G を押すとグラフ全体が自動的に整列されます。

名前の変更 (Renaming)

各ノードの表示名は、ワークフロー内における一意の識別子（ID）を兼ねています。そのため、ノードの名前を変更すると、ワークフロー内のそのノードへのすべての参照も自動的に更新されます。

単一のノードの名前を変更するには、ノードを選択して R キーを押すか、ホバー時にノード名の隣に表示される小さな鉛筆アイコンをクリックするか、右クリックメニューから Rename を選択します。新しい名前を入力し、Enter を押す（または別の場所をクリックする）と確定され、Escape を押すとキャンセルされます。

複数のノードを一度に名前変更するには、それらを選択して R キーを押すか、いずれかを右クリックして Rename を選択します。これにより Rename nodes ダイアログが開き、単一のベース名（基本名）を指定して選択全体に適用できます。最初のノードには指定したベース名がそのまま割り当てられ、以降のノードには Base_1、Base_2 のように連番が付与されます。

複製、コピー、貼り付け

複製 (Duplicate) (Cmd/Ctrl+D、またはノードやマルチノードツールバーの Duplicate アクション): 選択したノードの独立したコピーを元のノードのすぐ隣に作成します（外部との接続線は外れた状態になります）。
コピー (Copy) (Cmd/Ctrl+C): 選択したノード（パラメータ値を含む）をシリアライズしてシステムクリップボードにコピーします。
貼り付け (Paste) (Cmd/Ctrl+V): 直前にコピーした内容から新しいノードを生成し、カーソル位置の近くに配置します。

コピー＆ペーストは、開いている 2 つのワークフロータブ間でノードを移動する際にも使用できます。一方のタブでコピーし、タブを切り替えてもう一方のタブで貼り付けます。

ノードのロック (Locking)

ノードをロックすると、誤った変更から保護できます。ロックされたノードは、再びロックを解除するまで、実行、削除、パラメータの編集、およびパラメータの追加が一切行えなくなります。

ノードのロック状態は、L キー（複数選択でも動作します）、ノードヘッダーの鍵アイコン、または右クリックメニューの Lock/Unlock で切り替えることができます。なお、Note（メモ）ノードはロックできません（ロックオプションは適用されません）。

削除 (Deleting)

1 つ以上のノードを選択して Delete キー（キーボードによっては Backspace）を押すか、右クリックメニューまたはツールバーの Delete Node を使用します。ノードを削除すると、そのノードに接続されていた線もすべて削除されます。ただし、接続の途中に挿入されたドットノード（中継ノード）を削除した場合は、両端のノード同士が直接再接続されるため、接続線全体が壊れることはありません。

グループを削除した場合は、外側のグループラッパーのみが削除され、内部の子ノードはグループ解除された状態でキャンバス上に残ります。詳細はノードのグループ化を参照してください。

ワークフロー実行中の削除動作

実行の完了を待たずにノードを削除することも可能です。この場合の挙動は、実行中のプロセスがそのノードをまだ必要としているかどうかによって異なります：

実行プロセスがそのノードを必要としていない場合 — そのノードの処理がすでに完了しているか、あるいは実行経路に含まれていない場合、実行は中断されることなくそのまま継続します。実行チェーンに配線されていない、キャンバスの脇に置かれた無関係なノードなどがこれに該当します。
実行プロセスがそのノードをまだ必要としている場合 — 実行は安全のためにキャンセルされます。エンジンは、削除されたノードを待っていた下流ノードを報告するため、実行が停止した理由を確認できます。処理のクリーンアップが完了すると、実行ボタンが再び有効になります。

下流にあるノードがまだ処理を開始していなくても、「依然として必要」とみなされます。実行プロセスがそこに到達した際に、必要な入力が存在しない状態になってしまうためです。中間のノードを介して間接的にデータを供給しているノードについても同様です。

この仕様は意図的な設計です。依存しているノードが存在しないまま実行を継続させてしまうと、本来の入力値ではなくデフォルト値が代入されて処理が進んでしまい、ワークフローが見かけ上成功しながら誤った結果を静かに出力してしまう事態を防ぐためです。

パラメータの接続

入力または出力として機能するすべてのパラメータには、その行の左端（入力）または右端（出力）に小さな接続ハンドル（ポート）が備わっています。一方のハンドルから他方のハンドルへドラッグすることで接続線を作成できます。ハンドルの外側の空いているキャンバスへドラッグすると、そのハンドルにあらかじめ配線された状態で Add Node メニューが開き、チェーン内の次のノードを素早く追加できます。

エディタは、データ型に互換性があるパラメータ同士でのみ接続を完了できるように制御しています。ドラッグ中、キャンバス上の互換性のないポートは薄暗く（ディム）表示されるため、どこに接続できるかが視覚的にわかります。多くのパラメータは複数の型を受け入れることができます（例えば、URL 文字列も受け入れる画像入力など）。具体的にどの型を受け入れるかは、各ノードのパラメータ定義によってあらかじめ組み込まれています。

接続を削除するには、接続線をクリックして選択し Delete キーを押すか、接続線にホバーして表示される接続ボタンをクリックします（Settings → Editor → Node Settings で Show Connection Buttons on Hover が有効になっている場合）。

ドットノードとリルートノード (Dot and Reroute Nodes)

ドットノード (Dot Node / Reroute Node) は、既存の接続線の途中に挿入できる、ロジックを持たない中継ノードです。他のノードを迂回するように配線を曲げたり、混雑したキャンバスを整理したりするために使用します。接続線にホバーまたは選択した状態で I キーを押すと、その位置にドットノードが挿入されます。元の接続は 2 つに分割され、新しいドットノードを経由して配線されます（通過するデータには一切影響しません）。

ドットノードを削除すると、隣接する両端のノード同士が自動的に直接再接続されるため、ドットノードを削除してもフローが途切れることはありません。

ノート（メモノード）

Note（メモ） は、キャンバス上に自由に配置できる、コードを実行しないテキストブロックです。グラフの特定のセクションが何のためのものか、TODO メモ、上流の依存関係に関する注意点などを、自分自身や共同作業者のために残しておくことができます。キャンバス上にカーソルを置いた状態で N キーを押すと、カーソル位置にメモが作成されます。

ノートはロックできず、ワークフローの実行やマルチノードツールバーの Run/Reset アクションの対象外となります。

Properties（プロパティ）パネル

ノードを選択すると、ノード本体上にインライン表示されているパラメータ行とともに、右サイドバーの Properties パネルにそのノードのパラメータが表示されます。同じ値が専用の常時表示エリアに表示されるため、パラメータ数が多いノードを扱う場合や、ノード自体を折りたたんでいる場合に作業しやすくなります。右サイドバーは Cmd/Ctrl+B、右クリックメニューの Property Panel、またはノードヘッダーのボタンから開くことができます。

Properties パネルで値を編集しても、ノード上のインライン行で同じ値を編集しても、更新される内部データは全く同じです。

カスタムパラメータの追加

一部のノードでは、標準で用意されているパラメータに加えて、独自のカスタムパラメータを追加することができます。ノードがこれをサポートしている場合、パラメータリストの最下部（ノード本体および Properties パネル内）に Add parameter 行が表示されるか、右クリックメニューに Add parameter が表示されます。

これを開くと Add New Parameter ダイアログが表示され、以下を設定できます：

項目	設定内容
Name	パラメータの内部変数名。ノード内で一意である必要があります。
Display Name	UI 上で表示されるラベル名（内部名と異なる表記にしたい場合）。
Type	`Any`、`str`、`bool`、`int`、`float`、`dict`、`json`、またはメディア型である `image`、`audio`、`video` のいずれか。
Tooltip	ホバー時に表示されるヘルプテキスト。
Input / Output	パラメータを入力用、出力用、またはその両方として接続可能にするかどうかの設定。
Default Value	値を設定または接続する前にパラメータが保持する初期値。

選択した型に応じて、テキスト用の複数行/Markdown 切り替え、数値用の最小値/最大値/刻み幅を持つスライダー、ドロップダウン用の固定選択肢（任意のアイコン、サブタイトル、検索ボックス付き）などの追加オプションが表示されます。

既存のカスタムパラメータの設定変更

カスタムパラメータを作成した後は、そのパラメータ（または Properties パネル内の対応する行）を右クリックして Configure parameter を選択することで、現在の設定が入力された同じダイアログを再度開いて設定を変更できます。このオプションは自身で追加したカスタムパラメータにのみ表示され、ノードに最初から組み込まれている標準パラメータはこの方法では編集できません。

接続済みパラメータの非表示化

Hide Connected Parameters（Shift+H、または Settings → Editor → Node Settings）をオンにすると、すでに入力接続が接続されているパラメータ行が折りたたまれます。これは混雑したワークフローを整理整頓するための機能です。値がすでにキャンバス上の別のノードから供給されている場合、編集フィールドを表示したままにしてキャンバスの領域を占有する必要は通常ありません。オフに戻すと、すべての行が即座に再表示されます。

特定のパラメータを常に表示しておく方法

Node Settings のメインスイッチの隣にある Ignore Hide Connected (Display Nodes) および Ignore Hide Connected (Save Nodes) を有効にすると、名前に「display」または「save」を含むパラメータが非表示の対象から除外されます。入力が接続されている状態でも、出力パスやプレビューを常に確認したいノードに役立ちます。