docs: archive workflow construction guide and node reference

2026-11-01 17:12:31 +08:00
parent b0e2544c09
commit 08b987172c
4 changed files with 1486 additions and 0 deletions
@@ -0,0 +1,493 @@
+# 当前节点端口速查（自动读取实际接口）
+
+核对：2026-10-31，服务器ComfyUI 0.39.0。39种节点。此附录列接口，功能、连线和应用见主指南。
+
+COMBO是下拉参数；COMFY_AUTOGROW_V3是可增长的一组输入。一个同名数据类型仍需匹配正确模型家族。
+
+## CheckpointLoaderSimple
+
+Load Checkpoint
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `ckpt_name` | COMBO（68项） | — |
+| 输出0 | `MODEL` | MODEL | — |
+| 输出1 | `CLIP` | CLIP | — |
+| 输出2 | `VAE` | VAE | — |
+
+## UNETLoader
+
+Load Diffusion Model
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `unet_name` | COMBO（157项） | — |
+| 必填输入 | `weight_dtype` | COMBO（4项） | — |
+| 输出0 | `MODEL` | MODEL | — |
+
+## CLIPLoader
+
+Load CLIP
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip_name` | COMBO（65项） | — |
+| 必填输入 | `type` | COMBO（29项） | — |
+| 可选输入 | `device` | COMBO（2项） | — |
+| 输出0 | `CLIP` | CLIP | — |
+
+## DualCLIPLoader
+
+Load CLIP (Dual)
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip_name1` | COMBO（65项） | — |
+| 必填输入 | `clip_name2` | COMBO（65项） | — |
+| 必填输入 | `type` | COMBO（12项） | — |
+| 可选输入 | `device` | COMBO（2项） | — |
+| 输出0 | `CLIP` | CLIP | — |
+
+## VAELoader
+
+Load VAE
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `vae_name` | COMBO（40项） | — |
+| 输出0 | `VAE` | VAE | — |
+
+## LoadImage
+
+Load Image
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `image` | COMBO（48项） | — |
+| 输出0 | `IMAGE` | IMAGE | — |
+| 输出1 | `MASK` | MASK | — |
+
+## ImageScale
+
+Upscale Image
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `image` | IMAGE | — |
+| 必填输入 | `upscale_method` | COMBO（5项） | — |
+| 必填输入 | `width` | INT | 512 |
+| 必填输入 | `height` | INT | 512 |
+| 必填输入 | `crop` | COMBO（2项） | — |
+| 输出0 | `IMAGE` | IMAGE | — |
+
+## VAEEncode
+
+VAE Encode
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `pixels` | IMAGE | — |
+| 必填输入 | `vae` | VAE | — |
+| 输出0 | `LATENT` | LATENT | — |
+
+## VAEDecode
+
+VAE Decode
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `samples` | LATENT | — |
+| 必填输入 | `vae` | VAE | — |
+| 输出0 | `IMAGE` | IMAGE | — |
+
+## EmptyLatentImage
+
+Empty Latent Image
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `width` | INT | 1024 |
+| 必填输入 | `height` | INT | 1024 |
+| 必填输入 | `batch_size` | INT | 1 |
+| 输出0 | `LATENT` | LATENT | — |
+
+## EmptySD3LatentImage
+
+EmptySD3LatentImage
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `width` | INT | 1024 |
+| 必填输入 | `height` | INT | 1024 |
+| 必填输入 | `batch_size` | INT | 1 |
+| 输出0 | `LATENT` | LATENT | — |
+
+## CLIPTextEncode
+
+CLIP Text Encode (Prompt)
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `text` | STRING | — |
+| 必填输入 | `clip` | CLIP | — |
+| 输出0 | `CONDITIONING` | CONDITIONING | — |
+
+## KSampler
+
+KSampler
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `seed` | INT | 0 |
+| 必填输入 | `steps` | INT | 20 |
+| 必填输入 | `cfg` | FLOAT | 8.0 |
+| 必填输入 | `sampler_name` | COMBO（45项） | — |
+| 必填输入 | `scheduler` | COMBO（9项） | — |
+| 必填输入 | `positive` | CONDITIONING | — |
+| 必填输入 | `negative` | CONDITIONING | — |
+| 必填输入 | `latent_image` | LATENT | — |
+| 必填输入 | `denoise` | FLOAT | 1.0 |
+| 输出0 | `LATENT` | LATENT | — |
+
+## ModelSamplingAuraFlow
+
+ModelSamplingAuraFlow
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `shift` | FLOAT | 1.73 |
+| 可选输入 | `sampling` | COMBO（2项） | flow |
+| 输出0 | `MODEL` | MODEL | — |
+
+## LoraLoader
+
+Load LoRA (Model and CLIP)
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `lora_name` | COMBO（117项） | — |
+| 必填输入 | `strength_model` | FLOAT | 1.0 |
+| 必填输入 | `strength_clip` | FLOAT | 1.0 |
+| 输出0 | `MODEL` | MODEL | — |
+| 输出1 | `CLIP` | CLIP | — |
+
+## LoraLoaderModelOnly
+
+Load LoRA
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `lora_name` | COMBO（117项） | — |
+| 必填输入 | `strength_model` | FLOAT | 1.0 |
+| 输出0 | `MODEL` | MODEL | — |
+
+## TextEncodeQwenImage21
+
+Text Encode Qwen Image 2.1
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `prompt` | STRING | — |
+| 必填输入 | `negative_prompt` | STRING | — |
+| 必填输入 | `resolution` | INT | 1024 |
+| 必填输入 | `images` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `vae` | VAE | — |
+| 输出0 | `positive` | CONDITIONING | — |
+| 输出1 | `negative` | CONDITIONING | — |
+| 输出2 | `latent` | LATENT | — |
+
+## QwenImage21Cache
+
+Qwen Image 2.1 Cache
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `device` | COMBO | auto |
+| 必填输入 | `dtype` | COMBO | default |
+| 输出0 | `MODEL` | MODEL | — |
+
+## RandomNoise
+
+RandomNoise
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `noise_seed` | INT | 0 |
+| 输出0 | `NOISE` | NOISE | — |
+
+## BasicGuider
+
+Basic Guider
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `conditioning` | CONDITIONING | — |
+| 输出0 | `GUIDER` | GUIDER | — |
+
+## KSamplerSelect
+
+KSamplerSelect
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `sampler_name` | COMBO | — |
+| 输出0 | `SAMPLER` | SAMPLER | — |
+
+## BasicScheduler
+
+BasicScheduler
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `model` | MODEL | — |
+| 必填输入 | `scheduler` | COMBO | — |
+| 必填输入 | `steps` | INT | 20 |
+| 必填输入 | `denoise` | FLOAT | 1.0 |
+| 输出0 | `SIGMAS` | SIGMAS | — |
+
+## SamplerCustomAdvanced
+
+SamplerCustomAdvanced
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `noise` | NOISE | — |
+| 必填输入 | `guider` | GUIDER | — |
+| 必填输入 | `sampler` | SAMPLER | — |
+| 必填输入 | `sigmas` | SIGMAS | — |
+| 必填输入 | `latent_image` | LATENT | — |
+| 输出0 | `output` | LATENT | — |
+| 输出1 | `denoised_output` | LATENT | — |
+
+## MiniMaxH3ImageToVideo
+
+MiniMax H3 Image to Video
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `vae` | VAE | — |
+| 必填输入 | `prompt` | STRING | — |
+| 必填输入 | `width` | INT | 1344 |
+| 必填输入 | `height` | INT | 768 |
+| 必填输入 | `length` | INT | 124 |
+| 可选输入 | `first_frame` | IMAGE | — |
+| 可选输入 | `last_frame` | IMAGE | — |
+| 输出0 | `positive` | CONDITIONING | — |
+| 输出1 | `LATENT` | LATENT | — |
+
+## MiniMaxH3ReferenceToVideo
+
+MiniMax H3 Reference to Video
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `prompt` | STRING | — |
+| 必填输入 | `width` | INT | 1344 |
+| 必填输入 | `height` | INT | 768 |
+| 必填输入 | `length` | INT | 124 |
+| 必填输入 | `ref_image_size` | COMBO | match |
+| 可选输入 | `vae` | VAE | — |
+| 可选输入 | `audio_vae` | VAE | — |
+| 可选输入 | `ref_images` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_videos` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_video_audios` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_audios` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 输出0 | `positive` | CONDITIONING | — |
+| 输出1 | `LATENT` | LATENT | — |
+
+## VAEDecodeAudio
+
+VAE Decode Audio
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `samples` | LATENT | — |
+| 必填输入 | `vae` | VAE | — |
+| 输出0 | `AUDIO` | AUDIO | — |
+
+## CreateVideo
+
+Create Video
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `images` | IMAGE | — |
+| 必填输入 | `fps` | FLOAT | 30.0 |
+| 可选输入 | `audio` | AUDIO | — |
+| 可选输入 | `bit_depth` | COMBO | auto |
+| 可选输入 | `color_space` | COMBO | sRGB |
+| 可选输入 | `codec` | COMBO | none |
+| 输出0 | `VIDEO` | VIDEO | — |
+
+## SaveVideo
+
+Save Video
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `video` | VIDEO | — |
+| 必填输入 | `filename_prefix` | STRING | video/ComfyUI |
+| 必填输入 | `format` | COMFY_DYNAMICCOMBO_V3 | — |
+| 可选输入 | `codec` | COMFY_DYNAMICCOMBO_V3 | — |
+| 输出0 | `video` | VIDEO | — |
+
+## SaveImage
+
+Save Image
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `images` | IMAGE | — |
+| 必填输入 | `filename_prefix` | STRING | ComfyUI |
+| 输出0 | `images` | IMAGE | — |
+
+## LoadAudio
+
+Load Audio
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `audio` | COMBO | — |
+| 输出0 | `AUDIO` | AUDIO | — |
+
+## SaveAudioAdvanced
+
+Save Audio (Advanced)
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `audio` | AUDIO | — |
+| 必填输入 | `filename_prefix` | STRING | audio/ComfyUI |
+| 必填输入 | `format` | COMFY_DYNAMICCOMBO_V3 | — |
+| 输出0 | `audio` | AUDIO | — |
+
+## MiniMaxH3AudioConditioningT8
+
+MiniMax H3 Audio Conditioning (T8)
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `video_vae` | VAE | — |
+| 必填输入 | `audio_vae` | VAE | — |
+| 必填输入 | `prompt` | STRING | — |
+| 必填输入 | `width` | INT | 1344 |
+| 必填输入 | `height` | INT | 768 |
+| 必填输入 | `length` | INT | 124 |
+| 必填输入 | `task_type` | COMBO | auto |
+| 必填输入 | `audio_mode` | COMBO | lock_source |
+| 必填输入 | `audio_denoise_strength` | FLOAT | 0.35 |
+| 必填输入 | `add_source_as_reference` | BOOLEAN | True |
+| 必填输入 | `prompt_primary_audio_ordinal` | INT | 1 |
+| 必填输入 | `strict_prompt_tags` | BOOLEAN | True |
+| 必填输入 | `ref_image_size` | COMBO | match |
+| 必填输入 | `reference_video_policy` | COMBO | official_2_to_15s |
+| 可选输入 | `drive_audio` | AUDIO | — |
+| 可选输入 | `final_audio` | AUDIO | — |
+| 可选输入 | `first_frame` | IMAGE | — |
+| 可选输入 | `last_frame` | IMAGE | — |
+| 可选输入 | `ref_images` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_videos` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_video_audios` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `ref_audios` | COMFY_AUTOGROW_V3 | 可增长输入；展开后逐个接线 |
+| 可选输入 | `allow_above_reference_area` | BOOLEAN | True |
+| 可选输入 | `semantic_bridge` | T8_SEMANTIC_BRIDGE | — |
+| 输出0 | `positive` | CONDITIONING | — |
+| 输出1 | `av_latent` | LATENT | — |
+| 输出2 | `mux_audio` | AUDIO | — |
+| 输出3 | `conditioned_prompt` | STRING | — |
+| 输出4 | `media_map_json` | STRING | — |
+| 输出5 | `report` | STRING | — |
+
+## MiniMaxMusic3TextEncode
+
+MiniMax Music3 Text Encode
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `clip` | CLIP | — |
+| 必填输入 | `caption` | STRING | — |
+| 必填输入 | `lyrics` | STRING | — |
+| 必填输入 | `seed` | INT | 0 |
+| 必填输入 | `max_duration` | FLOAT | 120.0 |
+| 必填输入 | `cfg_scale` | FLOAT | 1.5 |
+| 必填输入 | `top_k` | INT | 50 |
+| 输出0 | `CONDITIONING` | CONDITIONING | — |
+| 输出1 | `seconds` | FLOAT | — |
+
+## EmptyMiniMaxMusic3LatentAudio
+
+Empty MiniMax Music3 Latent Audio
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `seconds` | FLOAT | 120.0 |
+| 必填输入 | `batch_size` | INT | 1 |
+| 输出0 | `LATENT` | LATENT | — |
+
+## ConditioningZeroOut
+
+Conditioning Zero Out
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `conditioning` | CONDITIONING | — |
+| 输出0 | `CONDITIONING` | CONDITIONING | — |
+
+## ControlNetLoader
+
+Load ControlNet Model
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `control_net_name` | COMBO（34项） | — |
+| 输出0 | `CONTROL_NET` | CONTROL_NET | — |
+
+## ControlNetApplyAdvanced
+
+Apply ControlNet
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `positive` | CONDITIONING | — |
+| 必填输入 | `negative` | CONDITIONING | — |
+| 必填输入 | `control_net` | CONTROL_NET | — |
+| 必填输入 | `image` | IMAGE | — |
+| 必填输入 | `strength` | FLOAT | 1.0 |
+| 必填输入 | `start_percent` | FLOAT | 0.0 |
+| 必填输入 | `end_percent` | FLOAT | 1.0 |
+| 可选输入 | `vae` | VAE | — |
+| 输出0 | `positive` | CONDITIONING | — |
+| 输出1 | `negative` | CONDITIONING | — |
+
+## LoadVideo
+
+Load Video
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `file` | COMBO | — |
+| 输出0 | `VIDEO` | VIDEO | — |
+
+## GetVideoComponents
+
+Get Video Components
+
+| 方向 | 端口/参数 | 数据类型 | 默认值/说明 |
+|---|---|---|---|
+| 必填输入 | `video` | VIDEO | — |
+| 输出0 | `images` | IMAGE | — |
+| 输出1 | `audio` | AUDIO | — |
+| 输出2 | `fps` | FLOAT | — |
+| 输出3 | `bit_depth` | COMBO | — |
+| 输出4 | `color_space` | COMBO | — |