Merge branch 'main' into develop

RELEASE_NOTES.md

@@ -1,3 +1,39 @@
+# ComfyUI-CheckpointHandpickerSuite 0.2.1
+
+ComfyUI-CheckpointHandpickerSuite 0.2.1 is a maintenance release focused on ImageDir Preview performance and documentation.
+
+## Changes
+
+### Bounded ImageDir Preview search
+
+ImageDir Preview now stops collecting matching image candidates when the internal candidate limit (currently 3,000 matching images) is reached.
+
+Previously, the candidate list was truncated only after the directory walk had finished, so a large output directory could still consume unnecessary time and memory. The scan now stops at the limit and sorts the bounded candidate set by modification time before selecting preview images.
+
+### Japanese documentation improvements
+
+The Japanese usage guide now includes a job-time checkpoint evaluation workflow using Ephemeral Preview and Checkpoint Status Tagger.
+
+Formatting and navigation in the Japanese documentation have also been corrected.
+
+## Compatibility
+
+There are no public node or socket changes in 0.2.1.
+
+The intentional socket roles remain:
+
+* `ckpt_name` for checkpoint-loader-compatible connections
+* `ckpt_name_str` for Checkpoint Status Tagger and ImageDir Preview
+* `ckpt_name_safe` for filesystem-safe labels
+
+Existing 0.2.0 workflows should continue to work without reconnecting nodes.
+
+## Upgrade notes
+
+Update the custom node and restart ComfyUI.
+
+---
+
 # ComfyUI-CheckpointHandpickerSuite 0.2.0
 
 ComfyUI-CheckpointHandpickerSuite 0.2.0 is a major workflow upgrade for checkpoint review, tagging, thumbnail setup, and generated-image cleanup.

doc/HOW_TO_USE.ja.md

@@ -1,4 +1,4 @@
-# 📖 HOW_TO_USE.ja.md (大祭囃子・のじゃのじゃ確定版 v0.2.0)
+# 📖 HOW_TO_USE.ja.md (大祭囃子・のじゃのじゃ確定版 v0.2.1)
 
 # 🖥️ 使用方法（How to Use）
 
@@ -78,7 +78,7 @@ git clone [https://github.com/ruminar/ComfyUI-CheckpointHandpickerSuite.git](htt
 1. 前述の通り、`Checkpoint Name Cycler` と `Checkpoint List Selector` を配置する。
 2. **`Ephemeral Preview`** を配置し、ワークフローの中間に存在する `VAE Decode` などの画像出力を受け取れるように繋ぐ。
 3. **`Checkpoint Status Tagger`（右手）** を配置する。
-4. Taggerの `ckpt_name` 入力を、`Checkpoint Name Cycler` の `ckpt_name` 出力へ接続する。
+4. Taggerの `ckpt_name_str` 入力を、`Checkpoint Name Cycler` の `ckpt_name_str` 出力へ接続する。
 
 **🏆 執行結果：**
 ジョブの実行中、中間プレビュー画像を確認しながら、**「今まさにこの画像を吐き出しているCheckpoint」に対して、お気に入りや削除予約などのタグをその場でダイレクトに打てるようになる！**

doc/README.ja.md

@@ -1,4 +1,4 @@
-# 🧬 ComfyUI-CheckpointHandpickerSuite (日本語版聖典 v0.2.0)
+# 🧬 ComfyUI-CheckpointHandpickerSuite (日本語版聖典 v0.2.1)
 
 > 「**ディスク容量が節約できる保証はありません。なぜなら、あなたが空いた容量に歓喜して、明日さらに多くのCheckpointをダウンロードしてしまうからです。**」 
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "checkpoint-handpicker-suite"
-version = "0.2.0"
+version = "0.2.1"
 description = "A deluxe checkpoint jukebox and review desk for ComfyUI. Review-first checkpoint cycling and handpicking suite: non-invasive checkpoint switcher, rotation/cycler helper, random checkpoint selector, and cleanup workflow without replacing Load Checkpoint."
 license = { file = "LICENSE" }
 readme = "README.md"
@@ -15,4 +15,4 @@ Documentation = "https://github.com/ruminar/ComfyUI-CheckpointHandpickerSuite/bl
 [tool.comfy]
 PublisherId = "ruminar"
 DisplayName = "Checkpoint Handpicker Suite"
-Icon = "https://raw.githubusercontent.com/ruminar/ComfyUI-CheckpointHandpickerSuite/main/icon.png"
+Icon = "https://raw.githubusercontent.com/ruminar/ComfyUI-CheckpointHandpickerSuite/main/icon.png"