Add H3 scene image plan helpers

README.md

@@ -16,6 +16,17 @@
   - Saves images to any folder, not just ComfyUI's output directory.
   - Supports filename tokens including `%input%`, `%input2%`, `%date:yyyy-MM-dd%`, `%counter%`, `%width%`, `%height%`, and `%batch_num%`.
 
+- `Dumas H3 Plan Attach Scene Images`
+  - Inputs: `plan`, `scene_index`, optional `image1`..`image6`
+  - Outputs: `plan`, `connected_images`
+  - Attaches up to six optional image sockets to one MiniMax H3 plan scene while keeping the plan JSON-serializable for the upstream archive system.
+  - Chain one node per scene that needs its own six-image bundle.
+
+- `Dumas H3 Plan Extract Scene Images`
+  - Inputs: `plan`, `scene_index`
+  - Outputs: `plan`, `image1`..`image6`, `connected_images`
+  - Reads back the six optional images for a selected MiniMax H3 plan scene, for example by connecting the current `clip_index`.
+
 - `Dumas JSON String to Object`
   - Input: `json_string`
   - Output: parsed `JSON`
@@ -170,6 +181,8 @@ decr  -> use index - 1
 
 `Save Image Dumas` leaves `folder` empty to use ComfyUI's output directory. `name` feeds `%input%` and `name_2` feeds `%input2%`, so a pattern like `project/%input%_%input2%_%counter%` can combine two upstream strings into the saved filename.
 
+`Dumas H3 Plan Attach Scene Images` and `Dumas H3 Plan Extract Scene Images` are a companion pair for `ComfyUI-MiniMaxH3-Contex-Loop`. The upstream H3 plan node cannot dynamically grow six new image sockets for every JSON-defined scene, so Dumas stores scene image bindings beside the plan using a lightweight token and an in-memory registry. That keeps `plan.json` archiving intact while still letting you wire up six IMAGE sockets per scene through chained helper nodes.
+
 `Dumas Strip Iteration Suffix` keeps the part before the first underscore and drops the rest. Names like `char123_pose_final.png` become `char123.png`, while names with no underscore such as `char123.png` are left untouched.
 
 `Dumas Slugify String` lowercases text, strips accents, replaces non-alphanumeric runs with `-`, and trims leading or trailing dashes.