comfyui_smart_character_detailer

comfyui_smart_character_detailer
★ 1

图像解析角色自动识别动态提示词局部高质量修复
基于FaceDetailer，利用WD14 Tagger自动识别角色并为不同人物动态应用最优prompt，实现原画风格下的局部高质量细化。
💡 自动识别多角色并分别应用优化prompt以细化面部与装饰细节。
🍴 1 Forks💻 Python🔄 2026-02-13
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/8b0992d318c3
📄 README

SmartCharacterDetailer

SmartCharacterDetailer は、ComfyUI-Impact-Pack の FaceDetailer をベースに、WD14 Tagger による画像解析とキャラクター自動識別機能 を追加した拡張ノードです。

通常の FaceDetailer では、全ての検出対象に対して同じ positive プロンプト（または固定の処理）が適用されますが、このノードでは「誰が写っているか」を自動判別し、それぞれに最適なプロンプトを動的に適用することができます。

🚀 主な機能と FaceDetailer との違い

1. WD14 Tagger による自動解析

検出された顔（または物体）領域を自動的に WD14 Tagger に通し、その特徴（髪色、目の色、装飾品など）をタグとして抽出します。これにより、事前のプロンプト指定なしでも、元の絵柄や特徴を維持したままの高画質化（Detailing） が可能です。

2. キャラクター定義と自動マッチング (character_definitions)

抽出されたタグに基づいて、事前に登録したキャラクター定義とマッチングを行います。

  • FaceDetailer: 全ての顔に同じプロンプトを適用（もし positive に “1girl, blue_hair” と書けば、赤髪のキャラも青髪に修正されてしまうリスクがある）。
  • SmartCharacterDetailer: 画像から「赤髪」が検出されればＡちゃんのプロンプト、「青髪」が検出されればＢちゃんのプロンプト、といった描き分けが自動で行われます。

    • 設定例:

    red_hair, long_hair / character_A, best quality
blue_hair, short_hair / character_B, masterpiece

    3. 排他的マッチングとサイズ優先処理

    複数の顔が検出された場合、面積が大きい（＝手前にいる重要な）顔から順に処理を行います。

    また、一度あるキャラクター定義が使用されると、その定義は「使用済み」となり、同じ画像内の他の顔には適用されません。これにより、1枚の画像に同じキャラクターが重複して判定されるのを防ぎます。

    4. プロンプト入力不要 (Auto-Tagging Fallback)

    positive 入力が空の場合、またはキャラクター定義にマッチしなかった場合、WD14で解析したタグそのものをプロンプトとして使用します。

    これにより、複雑なプロンプトを入力端子に繋がなくても、単体で「見たままを綺麗にする」ノードとして機能します。

    📦 必須依存ノード (Dependencies)

    このノードを使用するには、以下のカスタムノードがインストールされている必要があります。

  • ComfyUI-Impact-Pack
  • ベースとなる検出・Detailer機能に必要です。
  • ComfyUI-WD14-Tagger
  • 画像のタグ解析に必要です。

    • ※ requirements.txt は不要です。上記2つのカスタムノードが動作する環境（PyTorch, PIL, numpy 等）であれば動作します。

    📥 インストール方法

    ComfyUI/custom_nodes/ ディレクトリ内に、このフォルダ（my_detailer）を配置してください。

    ComfyUI/
  custom_nodes/
    ComfyUI-Impact-Pack/
    ComfyUI-WD14-Tagger/
    my_detailer/
       my_detailer_node.py
       README.md