* docs: refresh shipped help and tooltips * docs: add snapshot transfer guide section * docs: refresh guide screenshots
65 lines
3.8 KiB
Markdown
65 lines
3.8 KiB
Markdown
# User Guide
|
|
|
|
End-user documentation for nodes shipped by `ComfyUI-Koolook`. Pages
|
|
mirror the ComfyUI category each node lives under, so the structure here
|
|
matches what you see when you type "koolook" in the node-add menu.
|
|
|
|
Each per-node page includes a **Source** block at the top that records
|
|
whether the node is Koolook-native or imported from a fork — so fork
|
|
attribution is visible without needing a fork-shaped directory tree.
|
|
|
|
## Browse by category
|
|
|
|
| ComfyUI menu | Status | Nodes |
|
|
|---|---|---|
|
|
| `Koolook/Pipeline` | ✅ [`EasyAIPipeline`](nodes/koolook_pipeline/easy_ai_pipeline.md) | `EasyAIPipeline` |
|
|
| `Koolook/Image` | ✅ [`EasyResize_Koolook`](nodes/koolook_image/easy_resize_koolook.md) · ✅ [`easy_ImageBatch`](nodes/koolook_image/easy_image_batch.md) | `EasyResize_Koolook`, `easy_ImageBatch` |
|
|
| `Koolook/Wan_Video` | ✅ [`EasyWan22Prompt`](nodes/koolook_wan_video/easy_wan22_prompt.md) | `EasyWan22Prompt` |
|
|
| `Koolook/VAE` | ✅ [`nodes/radiance_koolook_v2_3_3/`](nodes/radiance_koolook_v2_3_3/) | `Easy_hdr_VAE_encode`, `Easy_hdr_VAE_decode` |
|
|
| `Koolook/Video` | ✅ [`Easy_LoadVideo`](nodes/koolook_video/easy_load_video.md) · ✅ [`Easy_VideoCombine`](nodes/koolook_video/easy_video_combine.md) | `Easy_LoadVideo`, `Easy_VideoCombine` |
|
|
| `Koolook/Utility` | ✅ [`Easy_Utility`](nodes/koolook_utility/easy_utility.md) | `Easy_Utility` |
|
|
| `Koolook/Loop` | ✅ [`Koolook_LoopStatus`](nodes/koolook_loop/koolook_loop_status.md) | `Koolook_LoopStatus` |
|
|
| `Koolook/Publish` | ✅ [`Publish contract nodes`](nodes/koolook_publish/publish_contract_nodes.md) | `Koolook_PublishInput`, `Koolook_PublishOutput`, `Koolook_PublishRouter`, `Koolook_PublishResult` |
|
|
| `Koolook/Camera` | ✅ [`KoolookLoadCameraPosesAbsolute`](nodes/koolook_camera/koolook_load_camera_poses_absolute.md) | `KoolookLoadCameraPosesAbsolute` |
|
|
| `Koolook/Testing` | ✅ [`Easy_Pattern`](nodes/koolook_testing/easy_pattern.md) | `Easy_Pattern` |
|
|
| `Koolook/PromptRelay` | ✅ [`LTXDirector__koolook`](nodes/whatdreamscost_koolook/ltx_director_koolook.md) | `LTXDirector__koolook` |
|
|
|
|
## Cross-cutting concepts
|
|
|
|
Pages here cover ideas that span more than one node:
|
|
|
|
- [Kforge Labs sidebar guide](../../web/guide/index.html) — visual onboarding for
|
|
Snapshots, favorite nodes, saved workflows, reusable modules, tags, and recovery.
|
|
- [VAE encode/decode pairing](nodes/radiance_koolook_v2_3_3/encode_decode_pairing.md) — which
|
|
encoder fields must match the decoder for a clean roundtrip, with
|
|
worked examples for SDR / HDR / cinema-log / video workflows.
|
|
- [HDR modes deep dive](nodes/radiance_koolook_v2_3_3/hdr_modes.md) — what `Clip (SDR)`,
|
|
`Soft Clip`, `Compress (Log)`, and `Passthrough` actually do to your
|
|
pixels before they hit the VAE, with per-pixel worked examples.
|
|
|
|
## When to add a guide
|
|
|
|
A node deserves a page if it has any of:
|
|
|
|
- Non-obvious input semantics (e.g. aspect-ratio strings, frame indexing
|
|
conventions).
|
|
- A workflow recipe more useful than the per-input tooltips.
|
|
- A known limitation or compatibility caveat.
|
|
- An encode/decode or input/output pairing relationship with other nodes.
|
|
|
|
Convention:
|
|
|
|
- One markdown file per canonical node ID, named after the ID
|
|
(`easy_hdr_vae_encode.md`, `easy_image_batch.md`).
|
|
- Place it in the folder that matches the node's ComfyUI category.
|
|
- Screenshots and helper images go in [`img/`](img/), named to match the
|
|
page they're embedded in (e.g. `easy_hdr_vae_encode_pairing.png`).
|
|
|
|
## Where to find the canonical node ID list
|
|
|
|
The repo [`README.md`](../../README.md) lists the canonical public node IDs
|
|
and display names. Some compatibility aliases remain registered so older saved
|
|
workflows load, but new workflows should pick the canonical IDs documented
|
|
here. The historical inventory (including removed nodes) is in the
|
|
[`CHANGELOG.md`](../../CHANGELOG.md).
|