AI活用

ComfyUIのIS_CHANGEDを実装する|外部ファイル変更とキャッシュの判定

ComfyUIのIS_CHANGEDは変更の有無をboolで返す関数ではありません。外部ファイルの内容を比較する例から、再実行・キャッシュ・V3のfingerprint_inputsを整理します。

この記事の目次
  1. Trueを返し続けても毎回実行にはならない
  2. ファイルの内容を小分けに読んで比較値を作る
  3. 変更検知と実行で別の内容を読まないようにする
  4. 乱数は入力へ出し、毎回無効化は最後に考える
  5. V3ではfingerprint_inputsへ対応させる

外部のテキストファイルを書き換えたのに、自作ノードの結果が変わらない。そんなときは、ファイルの内容がComfyUIの変更判定に含まれているかを確認します。V1のIS_CHANGEDは「変更したか」を真偽値で返す関数ではなく、前回と比較する値を返す仕組みです。

Trueを返し続けても毎回実行にはならない

同じ入力に同じ結果を返すノードは、結果を再利用できると無駄な処理を減らせます。ただし、入力がファイル名だけの場合、そのファイルの中身を別のアプリで変えても、入力欄の文字列は変わりません。

IS_CHANGEDが返した値は前回の値と比較されます。毎回Trueを返すと値が同じなので、「再実行が必要」という意味にはなりません。ファイルを読み込むノードなら、内容のハッシュなど、実際の結果に影響するものを比較値にします。

スポンサーリンク

ファイルの内容を小分けに読んで比較値を作る

次は、既存のV1ノードへ追加するメソッドの例です。実行メソッドも同じtext_fileを読む前提です。これはローカルの信頼できる入力を扱う例で、外部利用者から任意のパスを受け取るAPIの実装ではありません。

import hashlib

# 既存のV1ノードクラスの中へ置くメソッド
@classmethod
def IS_CHANGED(cls, text_file):
    digest = hashlib.sha256()
    with open(text_file, "rb") as stream:
        for chunk in iter(lambda: stream.read(1024 * 1024), b""):
            digest.update(chunk)
    return digest.hexdigest()

全文を一度にメモリへ置かず、分割してハッシュへ渡しています。ただし、この方法もファイル全体を読む時間は必要です。大きなモデルファイルを毎回検査する仕組みとして無条件に流用せず、何を再読込する必要があるかから選びます。

ファイルがない場合に、空文字などを返して正常な入力と同じ扱いにしないことも大切です。読み取り失敗は実行時のエラーとして分かるようにし、保存先の間違いをキャッシュ不具合と混同させない設計にします。

変更検知と実行で別の内容を読まないようにする

比較値を作ってから本処理がファイルを開くまでに、中身が書き換わる可能性があります。更新の多い運用では「ハッシュを取ったから必ず同じ内容を使った」とは言えません。採用した入力のコピーや版を保存し、その固定した入力を読む設計が役立ちます。

試す変更 確認したい結果
同じ内容で二度実行 比較値が同じになる
同じ名前で内容だけ変更 比較値が変わる
内容を元へ戻す 元の比較値へ戻る
ファイルを移動 読み取り失敗を検出できる

この表は自作ノードの試験項目です。ComfyUI全体のキャッシュ保存期間や、必ず何回実行されるかを保証するものではありません。実行回数は検証用ログでも確認します。

乱数は入力へ出し、毎回無効化は最後に考える

内部で乱数を使うなら、Seedを入力として持たせると比較しやすくなります。コードの中だけで乱数を更新すると、結果を変えたいのに再利用される、同じ条件で再現できない、といった問題が起きます。

公式には毎回異なる判定にする方法もありますが、常時キャッシュを無効にすると下流まで計算が広がり得ます。まず「外部ファイル」「乱数」「時刻」のどれが結果を変えるのかを特定します。利用者向けの再現条件はSeed固定と再現性を参照してください。

V3ではfingerprint_inputsへ対応させる

V3で対応する名前はfingerprint_inputsです。名前が変わっても、入力の指紋に相当する値を比較する考え方は共通です。移行時に「真偽値を返す実装」までそのまま持ち込まないよう、同内容と内容変更の二つを先に試します。

2026年11月9日に公式のノードプロパティ仕様を確認しました。最初の修正は、疑わしいノード一つに比較値と実行の記録を付けることです。下流が重い生成ノードなら、小さなテキスト処理へ一時的につなぎ替えると、待ち時間を増やさず判定を調べられます。

スポンサーリンク