ComfyUI の修復記録を再現可能な形で残し、秘密情報を公開しない

他人の事例ではなく、自分の修復を記録する

これは、こちらが提案する証拠記録の形式です。ランチャーの顧客のトレース、テレメトリの件数、成功したという記録を再現するものではありません。

pip inspect（pip 22.2 から利用可能）は環境レポートを作成し、pip check は宣言された依存関係の互換性を確認します。インポート名と配布パッケージ名のメタデータによる対応付けには、編集可能インストールなど一部のケースで限界があります。どちらのコマンドも、GPU やワークフローの成功を証明するものではありません。1（英語）2（英語）3（英語）

ComfyUI インスタンスを実際に実行している Python を使います。以下の python はプレースホルダーであり、システムの Python が正しいとは限りません。pip inspect を使う前に、その pip のバージョンを確認してください。このコマンドを利用できない場合は、この記録のためだけにパッケージを変更せず、バージョンを記録します。

python -m pip --version
python -m pip inspect > environment-before.json
python -m pip check

共有する前に、pip のレポート全体をローカルで確認してください。パスやインストール元の情報が機密情報に当たる場合があります。読み取り専用の環境インスペクターをダウンロードし、同じ Python で python inspect_environment.py を実行すると、メタデータを絞った要約を作成できます。このスクリプト自体はパッケージをインストールせず、プロンプト、ログ、トークンも読み取りません。ただし、通常の Python 起動フックは適用されます。配布パッケージ名やバージョン自体が機密情報に当たる場合もあり、--include-paths を使うと非公開の Python 実行ファイルのパスが明示的に追加されます。共有する前に、どちらの出力も確認してください。

管理する変更は一つにする

最小限のワークフローと入力を用意し、バージョンを記録して、変更を一つだけ説明します。同じインスタンスを再起動し、同じタスクを再試行してください。ComfyUI のカスタムノードのトラブルシューティングには、切り分け方法が示されています。4（英語） ノードを無効にしても、それ以前に変更した依存関係が元に戻った証拠にはなりません。

こちらが提案する記録項目は、元のエラー、環境、変更内容、変更の理由、新しいログ、元のタスクの結果、ロールバックするかどうかです。実施していない確認は、未実施と記録します。インストールの成功、インポートの成功、生成の成功はそれぞれ別の結果です。未解決の条件は後で確認できるよう残し、別のサイトの検証済みバッジをそのまま引き継がないでください。

関連する確認

• ComfyUI のコマンドを実行する場所：PowerShell、CMD、仮想環境
• オプションのバックエンドに関する警告：ワークフローを妨げる条件を見極める

出典、スクリプトの動作、言語間の対応状況を 2026-09-25 に再確認しました。メタデータスクリプトはローカルのユニットテストに合格しました。ComfyUI の修復、GPU、ワークフローを再現したとは主張していません。上流の記述とこちらの推奨事項は区別しています。