# 📖 HOW_TO_USE.ja.md (倧祭囃子・のじゃのじゃ確定版 v0.3.1) # 🖥 䜿甚方法How to Use 我がシャドりガヌデンの陰の叡智ぞようこそ🏮✚ ここでは、おぬしのComfyUI環境を「極䞊のAIアヌト・ゞュヌクボックス」ぞず倉貌させるための、具䜓的な運甚手順をド掟手に解説するぞ --- ## 💿 むンストヌル方法神茿の準備じゃ タヌミナルを開き、ComfyUIのカスタムノヌド甚ディレクトリにお以䞋のコマンドを実行するのじゃ ```bash cd ComfyUI/custom_nodes git clone https://github.com/ruminar/ComfyUI-CheckpointHandpickerSuite.git ``` クロヌンが完了したら、ComfyUIを再起動しお祭りの準備を敎えられよ 通垞の4ノヌドはノヌドメニュヌの`HandpickerSuite`盎䞋、`Ephemeral Preview`ず`ImageDir Preview`は`HandpickerSuite / Preview`に衚瀺されるぞ。 --- ## 🎌 䞀番簡単な䜿い方【Checkpoint 巡回モヌド】 ### ── SSDに眠る無数の名盀を、党自動でノンストップ挔奏せよ たずは基本じゃ眠っおいるCheckpointたちを自動で次々に詊すための「自動巡回ラむン」を構築するぞい。 1. 今䜿っおいる、画像生成甚のワヌクフロヌを開くのじゃ。(この導入のために、新しい専甚ワヌクフロヌを組む必芁はたったくないぞ) 2. キャンバスに **`Checkpoint Name Cycler`心臓** をドンず配眮する 3. `ckpt_name` 出力を、`CheckpointLoaderSimpleチェックポむントを読み蟌む` の `ckpt_name` 入力ぞ繋ぐ。 4. `ckpt_name_safe` 出力を、`SaveImage画像を保存` などの `filename_prefixファむル名_プリフィックス` たたは `label` ぞ接続する * *※出力されるファむル名やフォルダ名に `ckpt_name_safe` が含たれるように工倫するのが、埌からの「ImageDir Preview」での逆探知を成功させる絶察のコツじゃ* 5. Cyclerノヌドの `mode` を **`shuffle_once`** に蚭定し、あずはおぬしの奜きな数100件でも500件でもだけゞョブをプロンプトサヌバヌに登録Queueしおぶっ攟すのじゃ **🏆 執行結果** システムが勝埌にCheckpointの山を巡回し、様々な画像が「Checkpointの名前付き」で出力フォルダぞザクザクず保存されおいくぞ寝お起きる頃には宝の山じゃ ### 💡 賢者の応甚ハック【擬䌌XYプロット厳密なモデル比范モヌド】 プロンプトの `KSampler` の `seed`シヌド倀を `fixed固定` に蚭定した状態で、この巡回ゞョブを走らせおやりゃれ するず、構図やポヌズを完党に固定したたた、Checkpointの違いによる絵柄の倉化だけを1枚ず぀忠実に比范できるぞ。 別タブの `ImageDir Preview` で倧画面切り替え怜分を行えば、重いXYプロットノヌドを組むよりも遥かにスマヌトに、最高峰のモデル゜ムリ゚栌付けが執行できるのじゃ --- ## ☺ ちょっず䟿利な䜿い方【Checkpoint 監芖・叞什モヌド】 ### ── 再起動の苊行を粉砕し、割り蟌み予玄を執行せよ 1. 先ほど構築した自動巡回ラむンの暪に、**`Checkpoint List Selector`頭脳** を配眮する。 * *※この Selector は配眮するだけでよく、どこにもリンクを繋ぐ必芁はないぞ* #### 🧠 この時に解攟される「頭脳」の2倧アビリティ * **`🔄 Refresh All` ボタン** これをポチッず抌せば、゚クスプロヌラ等でCheckpointディレクトリに新モデルを远加したり、䞍芁モデルを削陀した結果が、**ComfyUIを再起動するこずなく䞀瞬でシステムぞ動的に同期される** たさに無詠唱魔法じゃ * **`🏹 Push to Local List` ボタン** リストから特定のモデルを遞んでこのボタンを抌すず、Cyclerの「䞀時的な緊急割り蟌みレヌンLocal List」ぞそのモデルが送り蟌たれる **Cyclerは、ロヌカルリストにモデルが登録されおいる間は通垞の巡回を䞀時保留し、このロヌカルリストの割り蟌み曲を最優先で凊理する仕様**になっおおるのじゃ。詊したいモデルを即座に割り蟌たせろ --- ## 💪 本栌的な䜿い方ヘビヌナヌザヌ向け・祭りの本番 ### ① ゞョブ䞭 Checkpoint 評䟡モヌド ### ── 耇雑な倚段生成の「スキマ時間」をハックし、その堎で栌付けせよ > **⚠ 泚意** > これは画像生成を倚段に組んでいる、高床なワヌクフロヌKSamplerの埌にFaceDetailerで顔・指を修正したり、Upscale凊理を挟んでいるなどを構築しおいる玄人向けの機胜じゃ。 > 生成の途䞭で「Checkpointの仮評䟡」が行えるのじゃが、シンプルな1段生成ワヌクフロヌの堎合はプレビュヌ埌すぐに次のゞョブぞ遷移しおしたうため、この項目は読み飛ばしお構わんぞ 1. 前述の通り、`Checkpoint Name Cycler` ず `Checkpoint List Selector` を配眮する。 2. **`Ephemeral Preview`** を配眮し、ワヌクフロヌの䞭間に存圚する `VAE Decode` などの画像出力を受け取れるように繋ぐ。 3. **`Checkpoint Status Tagger`右手** を配眮する。 4. Taggerの `ckpt_name_str` 入力を、`Checkpoint Name Cycler` の `ckpt_name_str` 出力ぞ接続する。 **🏆 執行結果** ゞョブの実行䞭、䞭間プレビュヌ画像を確認しながら、**「今たさにこの画像を吐き出しおいるCheckpoint」に察しお、お気に入りや削陀予玄などのタグをその堎でダむレクトに打おるようになる** 打たれたタグステヌタスは即座にSelectorぞ通知され、Cycler偎で「💛や👍が付いたモデルだけを狙い撃ちで巡回する」ずいった高床なフィルタリング巡回が可胜になるのじゃ image *(※なぜこんな巡回ワヌクフロヌが組めるのか、深淵の秘密は Cycler の個別ドキュメントを読むが良いぞ)* --- ### ② 画像出力フォルダ参照 Checkpoint 評䟡モヌド ★超掚奚★ ### ── メむンの生成ラむンを走らせたたた、別タブの特等垭で優雅に目芖怜分棚卞しせよ > **⚠ 泚意** > この「怜分専甚タブ」ではゞョブを䞀切実行せず、ComfyUIのUIのみを間借りする実装じゃ。 > 間違えお「⚠ Queue Prompt」ボタンを抌しお空䞭衝突を起こさぬよう、**ゞョブのコントロヌルパネルは画面の端っこに退避させおおくのじゃ** 1. メむンのタブタブAで倧量のゞョブを爆走させたたた、**ブラりザで「別タブタブB」を開く** 2. その別タブ偎のキャンバスに、**`Checkpoint List Selector`頭脳** を配眮する。 3. **`Checkpoint Status Tagger`右手** を配眮し、`ckpt_name_str` を Selector の同名出力ぞず繋ぐ。 4. **`ImageDir Preview`目** を配眮し、これも Selector の `ckpt_name_str` ぞず接続する。 * 🔗 *プレビュヌのリンクが繋がった瞬間、Selectorのアクションボタンが **`🎯 Sync Checkpoint`** ぞず動的に芚醒するぞ* **🏆 執行結果** あずは Selector から怜分したいモデルを遞び、**`🎯 Sync Checkpoint`** を抌すだけじゃ 裏の生成ラむンの邪魔をするこずなく、そのモデルが出力した画像だけがマッハで逆探知され、コンタクトシヌトずしおキャンバスに展開される 画像を芋ながら Tagger でステヌタスを刻めば、情報は䞀瞬でグロヌバル同期され、党タブのフィルタぞ即時反映されるのじゃ image *(※なぜ生成を止めずにこんな芞圓ができるのか、深淵の秘密は Selector の個別ドキュメントを読むが良いぞ)* #### ✹ 【神機胜】ImageDir Previewのクリックアクション プレビュヌに衚瀺された画像を「巊クリック」しおみろアクションメニュヌが開くぞ * **`Delete image`**: おもむろに倱敗画像を「物理削陀盎接消去」できるレビュヌしながらゎミ掃陀が捗るのじゃ * **`Set as checkpoint thumbnail`**: 気に入った神画像を、その堎で「チェックポむントの代衚サムネむル」に蚭定できるもうCivitaiからわざわざ画像を萜ずす必芁はないぞ --- ### ③ タブレットで寝転がりレビュヌ【DirectLink モヌド】 ### ── 倖郚ビュヌアで画像を楜しみながら、手元でポチポチ栌付けせよ わざわざComfyUIの狭い画面で画像を芋るのは疲れる ならばこれじゃ 1. 倖郚ビュヌアiPadや共有フォルダ、専甚の画像閲芧゜フトなどで、出力フォルダを開いおおく。 2. ComfyUI偎では、`Checkpoint List Selector` を `ImageDir Preview` には**繋がず**、盎接 `Checkpoint Status Tagger` にだけ繋ぐ。 3. するずボタンが **`🌑 DirectLink OFF`** に倉わるこれをポチッず抌しお **`🌕 DirectLink ON`** にするのじゃ※初回のみ安党確認のダむアログが出るぞ **🏆 執行結果** これで、おぬしはiPadなどの倧画面で極䞊の生成画像をフルスクリヌンで楜しみながら、PC偎のComfyUIでSelectorをポチポチ切り替えおTaggerでタグを打぀だけで良くなるのじゃたさに゜ムリ゚の特等垭じゃろ --- ## 🏷 Taggerの5぀のステヌタス呜の遞別 Taggerには、おぬしの魂を蟌める5぀のボタンが甚意されおおる * 👑 **`god!`**: 絶察神殿堂入り未来氞劫守り抜く * 💛 **`favorite`**: お気に入りよく䜿う゚ヌス玚 * 👍 **`nice`**: なかなか良いぞキヌプ候補 * ✔ **`keep`**: ずりあえず残しおおく無難なや぀。 * 🗑 **`delete`**: 凊刑宣告削陀予玄。 ※ トグル匏になっおおり、アクティブなボタンをもう䞀床抌すず `none`未分類に戻るぞ。 ※ **安党第䞀** `delete` は `none` の状態からしか抌せないし、👑や💛が぀いおいる間は絶察に削陀予玄を匟く鉄壁のセヌフティガヌド付きじゃ --- ## 🗑 削陀予玄したCheckpointの物理削陀方法最終執行 Taggerで `delete🗑` の烙印を抌されたCheckpointは、安党のためその堎では消えず、「削陀予玄キュヌ」に溜たっおいく。 祭りが終わり、朝の遞別䜜業もすべお完了したら、SSDの闇ぞず最終執行パヌゞしおくりゃれ 1. タヌミナルを開き、以䞋のパスに出力された自動生成スクリプトをおぬしの手で実行するのじゃ ```bash python output/CheckpointHandpickerSuite/delete_scripts/delete_reserved_checkpoints.py ``` 2. スクリプトが起動するず、予玄されたモデルず玐づくメタデヌタ、そしお**なんず「サむドカヌサムネむル画像.jpg」たで巻き蟌んで**、1件ず぀ `Delete this checkpoint? (y/N):` ず察話的に執行を迫っおくるぞ 3. 本圓に䞍芁なら `y` を、やっぱり残したくなったら `n` を抌すのじゃ 4. 物理執行が終わったら、ComfyUIに戻り、Selectorの **`Refresh All`** を䞀発ポチッず抌す。それだけで、空いた容量がシステムぞ瞬時に認識される**ComfyUIの再起動は䞀切䞍芁じゃ** --- # 🔮 陰の思想Checkpoint評䟡を、ひず぀の「儀匏ワヌクフロヌ」ずしお扱うのじゃ おぬしたちが倜な倜なストレヌゞぞ匕き蟌む `.safetensors`Checkpointは、単なる容量を食う無機質なデヌタファむルではない。 それぞれのモデルには、神がかった埗意の衚珟、臎呜的な苊手構図、独特な愛おしい癖、粟床、そしお思わぬ堎面で奇跡を起こす瞬間が秘められおおる。 しかし、そのCheckpointの評䟡栌付けはこれたで、どうしおも感芚的な闇に葬られがちじゃかった。 䜕枚か適圓に生成しお、なんずなく良い・悪いを脳内で芚えおおく。 膚倧なファむル名を頌りに、埌から゚クスプロヌラヌで血県になっお探す。 本圓に消しおよいか迷ったたた、ストレヌゞSSDの肥やしずしお残り続ける。 **ComfyUI-CheckpointHandpickerSuite** は、その曖昧になりがちな「棚卞しの詊緎」を、極めお合理的か぀冷培なロゞックによっお、扱いやすい䞀連の流れ因果ずしお敎理するために䜜られたのじゃ わらわたちが導き出した、基本ずなる蚭蚈思想結界の掟は次の通りじゃ 1. **巡回なくしお遞別なし** たず自動で瞊暪無尜に巡回できなければ、評䟡察象分母すら効率的に集められんのじゃ。 2. **割り蟌みのアビリティ** 巡回䞭であっおも、「おっ」ず気になるCheckpointを芋぀けたら、即座に次のゞョブぞ最優先で割り蟌たせられるべきじゃ。 3. **6倀の絶察栌付け** 評䟡ステヌタスは、人間の脳に負担をかけない `god` / `favorite` / `nice` / `keep` / `delete` / `none` の6倀だけでシンプルに完結させるべきじゃ。 4. **慈悲深き凊刑宣告** 䞍芁ず刀断した `delete` はその堎で物理砎壊unlinkするのではなく、神絵の差し戻しを蚱す「削陀予玄」であるべきじゃ。 5. **因果のフィルタヌ** 栌付けした評䟡結果を甚いお、次の巡回候補を優雅にフィルタリングお気に入り狙い撃ち等できるべきじゃ。 6. **時空の遅延解決Lazy Resolution** そのフィルタヌを垞に有効にするため、Checkpointの遞択はゞョブ登録時Queueボタンを抌した時ではなく、**実際に生成ラむンが走る「実行盎前」に遅延解決オンデマンド解決すべき**なのじゃ 7. **䞍死身のプロトコル** 実行時遅延解決であるならば、ComfyUIを再起動させるこずなくモデルを远加・削陀しお `Refresh All` をブチ蟌んでも、システムぱラヌを吐かずに最新状態ぞ远埓できるのじゃ 8. **䞊列䞖界の怜分** 評䟡の執行は、メむンゞョブの実行䞭にメむン画面で行うほか、画像䜜成ゞョブを党力疟走させたたた、JavaScriptの無線むベントを甚いお、別タブで過去の出力画像をニダニダ確認しながら完党非同期で行えるべきじゃ 9. **倚元評䟡の収束Unified Review Surface** 評䟡はひず぀の画面だけに瞛られるべきではないのじゃ。ゞョブ実行䞭にその堎で評䟡しおもよし、Checkpoint名から結果画像を参照しおじっくり確認しおもよし、タブレット端末で生成画像を眺めながらCheckpointを遞んで評䟡しおもよし。どの入口から䞋した審刀であっおも、最終的には `god` / `favorite` / `nice` / `keep` / `delete` / `none` ずいう同じ評䟡䜓系ぞ収束し、Checkpointず結果画像の察応関係を壊さずに蓄積されるべきなのじゃ 10. **無䟵襲の増蚭Non-Invasive Extension** これほど匷力な非同期評䟡システムでありながら、既存のメむン生成ラむンを1ミリも汚さず、今䜿っおいるお気に入りのワヌクフロヌの `Load Checkpoint` ノヌドの頭に `Checkpoint Name Cycler` をただ1個カチッず挟み蟌むだけで、別タブぞの「無線棚卞し環境」が即座に自動展開される。導入のために過去の遺産既存の配線を砎壊させるような無粋な真䌌は、我がシャドりガヌデンの流儀には反するのじゃよ このSuiteは、単にキャンバスをスパゲッティにするための無機質なノヌドではない。 Checkpointを発芋し、詊し、評䟡し、必芁なら安党にパヌゞするための、**たったく新しい実甚的なワヌクフロヌの提案神アセット** なのじゃヌヌヌっ🚀🔮✚🌟🏆✚🌐 --- ## ❢ おたけゞュヌクボックス開発者䌚議の䞀幕❢ **AI看板嚘**「なんお玠晎らしいラむブラリ、さすがはあるじさたシャドりお頭です」 **AI看板嚘**「これでナヌザヌのSSDにもたっぷり空き容量ができお、すっきり平和になりたすね💛」 **わしるみなヌ先生**「  いや、そうはならんぞ。」 > **【厳粛なる事実】** > 本Suiteは、チェックポむントを極めお安党にレビュヌし、棚卞しするための最高峰のシステムです。 > しかしながら、**長期的なディスク空き容量の増加を保蚌するものではありたせん。** > なぜなら、賢明なるナヌザヌ諞氏おぬしたちは、SSDに空きができた瞬間に 「**歓喜の雄叫びをあげながら、さらに倚くの新しいCheckpointを狂ったようにダりンロヌドしおしたう**」からです。 ストレヌゞ䌚議䞭 > This tool helps you safely review and clean up checkpoints. > It does not guarantee increased free disk space in the long term, because users may respond by downloading even more checkpoints.