跳至主要内容

節點參考

CodefyUI 內建 152 個節點，涵蓋 16 大類別。已安裝的 外掛包 與你自己的 自訂節點 會再加入更多。

提示

此表反映目前版本，但後端才是權威來源。請查看即時節點面板或 GET /api/nodes，確認目前安裝可用的節點。雙擊畫布可搜尋節點。

類別節點數量
CNNConv2d、Conv1d、Conv2dExplicit、ConvTranspose2d、MaxPool2d、AvgPool2d、AdaptiveAvgPool2d、BatchNorm2d、Dropout、Activation10
RNNLSTM、GRU、RNNCell3
TransformerMultiHeadAttention、TransformerEncoder、TransformerDecoder、MoELayer4
RLDQN、PPO、EnvWrapper、RewardModel、KLDivergence、PolicyRollout、PPOClipObjective、GroupRelativeAdvantage、Discount、GridWorldEnv、PreferenceDataset、BradleyTerryLoss、BradleyTerryTrain13
資料 (Data)Dataset、ImageFolderDataset、DataLoader、DatasetBatch、Transform、HuggingFaceDataset、KaggleDataset、TensorInput、TextInput、CSVReader、ColumnSelector、RowSelector、Normalize、SyntheticDataset、SyntheticShapes、SyntheticSegmentation、SyntheticSequence、TrainTestSplit、ResizeTransform、ToTensorTransform、NormalizeTransform、RandomCrop、RandomHorizontalFlip、RandomRotation、ColorJitter、RandAugment、ComposeTransform27
資料流 (Data Flow)Map、Reduce、Switch3
訓練 (Training)Optimizer、Loss、TrainingLoop、EvaluateModel、LRScheduler、SequentialModel、BackwardOnce7
IOImageReader、ImageWriter、ImageBatchReader、FileReader、CheckpointSaver、CheckpointLoader、ModelLoader、ModelSaver、Inference、GraphInput、GraphOutput、VideoLoad、VideoWrite13
控制 (Control)Start1
工具 (Utility)Print、Reshape、Concat、Flatten、Linear、Visualize、Embedding、PythonScript、ScatterPlot2D、DecisionBoundary10
正規化 (Normalization)BatchNorm1d、LayerNorm、GroupNorm、InstanceNorm2d4
張量運算 (Tensor Operations)Add、MatMul、Mean、Multiply、ScalarMultiply、Permute、Softmax、Argmax、Split、Squeeze、Stack、TensorCreate、Unsqueeze、MaskedFill14
LLMLLMChat、Tokenizer、WordVector、TextEmbedding、EmbeddingScatter、CosineSimilarity、AttentionMask、AttentionHeatmap、PositionalEncoding、CausalLMModel、LMCrossEntropyLoss、LMTokenizer、TextCorpusDataset、LMTokenizedDataset、DataMixDataset、PerplexityEvaluate、TextGenerate、DocumentLoader、TextChunker、VectorStore、Retriever、PromptBuilder、HFTextGenerate23
傳統機器學習 (Classical)KNN、LinearRegression、LogisticRegression、DecisionTreeClassifier、RandomForestClassifier、SVMClassifier、MLPClassifier、Accuracy8
DiffusionUpsample、TimestepEmbedding、Lerp、GaussianNoise、DDPMSampler、DiffusionUNet、DiffusionTrainingLoop7
VLAVLAModel、VLARollout、VLAActionEval、PushWorldEnv、PushWorldDemos5

重點節點​

  • Start（控制）— 定義執行進入點。每個可執行的圖都需要一個；請參閱你的第一個圖。
  • TensorInput（資料）— 提供內嵌格狀編輯器，用來輸入明確的張量值。教學檢視器範例會以此節點作為輸入。
  • 變換鏈（資料）— 九個節點會組成 transforms.Compose：ResizeTransform 將圖片縮放為正方形；ToTensorTransform 將 PIL 圖片轉為 [0, 1] 張量；NormalizeTransform 套用逐通道正規化並提供預設組合；RandomCrop、RandomHorizontalFlip、RandomRotation、ColorJitter 與 RandAugment 套用資料增強；ComposeTransform 則合併兩條分別建構的鏈。參數與順序規則請參閱資料與資料增強。
  • ImageFolderDataset（資料）— 依 torchvision ImageFolder 預期的目錄結構，從每個類別各自的目錄載入圖片。
  • TrainingLoop（訓練）— 執行訓練，並將即時 loss 圖表傳至結果面板。其進階區段包含記憶體控制項 precision 與 accumulate_steps；請參閱訓練記憶體。
  • SequentialModel（訓練）— 以單一節點表示層堆疊。雙擊節點可開啟模型架構編輯器。編輯器提供依類別分組且可搜尋的層級面板，以及用來連接各層的畫布。架構必須恰好包含一個 Input 節點與一個 Output 節點，合併層則提供連接埠清單編輯器。控制項包括吸附 ON/OFF、由上至下的自動排列、JSON 匯入與匯出，以及套用。驗證會拒絕循環。
  • EmbeddingScatter（LLM）— 使用 PCA 或 t-SNE 將嵌入向量投影至 2D，並顯示可縮放的散佈圖。
  • AttentionHeatmap（LLM）— 傳遞 attention weight，可選擇其中一個 head，並傳遞選填的 token 標籤。節點卡片會將 weight 顯示為 heatmap，另提供完整尺寸的檢視器。
  • 由套件包提供的後端（LLM）— WordVector 的 glove-50d 與句子編碼器選項，以及整個 TextEmbedding，都會載入套件中心所安裝的模型。未安裝模型的選項會顯示為灰色。若缺少的選項是圖中已儲存的目前值，該選項仍可選取並會顯示警告。執行圖時不會下載這些模型。套件包大小、檔案位置與編碼器選擇方式請參閱選用套件包。
  • 語言模型鏈（LLM）— 七個節點組成 GPT 式解碼器的訓練路徑：TextCorpusDataset 從 Hugging Face Hub 或本機 .txt 讀取文字列；LMTokenizedDataset 建立固定長度的下一詞元區塊；DataLoader 將批次供應給 TrainingLoop；CausalLMModel 提供模型；LMCrossEntropyLoss 提供 loss；LMTokenizer 則提供共用的 tokenizer。PerplexityEvaluate 會評估保留資料切分，TextGenerate 則從已訓練權重取樣文字。CausalLMModel 的預設值會產生 203,668,480 個參數；若要在筆電上訓練，請降低 d_model 與 n_layers。請參閱範例集中的 Train a Causal LM on TinyStories。
  • RAG 鏈（LLM）— 七個節點使用指定文件作為回答脈絡：DocumentLoader 將目錄中的每個 .md 與 .txt 讀取為 {text, source}；TextChunker 建立可嵌入的切塊，並保留來源名稱與字元位移；TextEmbedding 建立向量；VectorStore 將一個 [N, D] 矩陣與切塊文字一併儲存，並以一次矩陣乘法搜尋；Retriever 回傳最接近的 top_k 個切塊與分數；PromptBuilder 將切塊及問題插入限定脈絡的範本；HFTextGenerate 則在本機執行 Qwen2.5-0.5B-Instruct。你可以用 LLMChat 取代 HFTextGenerate，改用 Ollama 或託管提供者。TextEmbedding 需要 sentence-embeddings 套件包，HFTextGenerate 需要 rag 套件包。請參閱範例集中的 RAG, fully local 與 RAG with a chat API，下載內容則請參閱選用套件包。
  • VLA 鏈（VLA）— VLA 類別包含五個專用節點。訓練與評估圖會連接 PushWorldEnv、PushWorldDemos、VLAModel 與 TrainingLoop，再使用 VLAActionEval 和 VLARollout。PushWorldEnv 以 torch 實作受語言條件控制的 2D 推動任務；干擾圓盤會使策略必須讀取指令才能識別目標。PushWorldDemos 會建立 scripted-expert 行為複製樣本與保留資料切分。VLAModel 結合視覺前端、位元組層級指令嵌入、Transformer 主幹與分塊動作專家。VLAActionEval 會測量相對於 expert 的保留資料開迴路 MSE，VLARollout 則以滾動時域執行測量閉迴路成功率。Train a VLA on PushWorld 的 README建議使用 CUDA GPU，並記錄 RTX 4080 約需執行 56 分鐘。
  • RL 節點（RL）— GridWorldEnv 提供不依賴 Gymnasium 的 gridworld。PolicyRollout 會執行策略 N 個回合，並記錄狀態、動作、獎勵與 logits。Discount 計算 return，GroupRelativeAdvantage 計算 GRPO 的群組平均 baseline，PPOClipObjective 則計算 PPO 的 clipped surrogate，並回傳指出哪些樣本使用 clipped branch 的 mask。RewardModel 會為每個 sequence 產生一個純量分數。PreferenceDataset 建立訓練與保留 preference pair；BradleyTerryLoss 計算 preference loss；BradleyTerryTrain 訓練 reward head，並回報訓練與保留資料的 accuracy，以呈現捷徑學習。KLDivergence 計算 policy 相對於 reference 的正則化項。DQN、PPO 與 EnvWrapper 會與 Gymnasium 整合。請參閱範例集中的 RLHF building blocks: reward + KL。
  • Diffusion 鏈（Diffusion）— GaussianNoise 建立帶 seed 的 noise，並可符合上游張量的 shape。DiffusionUNet 提供將 (x, t) 映射至 predicted noise 的 toy U-Net，DiffusionTrainingLoop 則訓練此模型。DDPMSampler 在單一節點內執行 reverse process，使圖維持無環；其詳細 trace 會記錄 trajectory snapshot。TimestepEmbedding、Upsample 與 Lerp 可用來明確建構相同運算。Diffusion 範例包括 Forward Process（GaussianNoise 與 Lerp），以及 Toy Sampling 和 Mini U-Net（GaussianNoise → DiffusionUNet → DDPMSampler）。請參閱範例集。
  • ModelSaver / ModelLoader（IO）— 寫入與讀取模型檔。預設的 state_dict 模式會儲存張量，且不要求載入任何類別。full_model 模式會儲存以 pickle 序列化的模組，並使用受限解序列化器載入；此解序列化器允許 torch 與 CodefyUI 的 layer class，以及 CodefyUI Transformer layer 所儲存的兩個 torch activation function。模式選擇與載入需求請參閱儲存與載入模型。
  • Switch（資料流）— 使用條件式路由，使只有一條分支執行。

連接埠資料型別​

連線是有型別的。內建的資料型別包括：Tensor、Model、Dataset、DataLoader、Optimizer、Loss、Scalar、String、Image、List、Transform、Any、Trigger。Trigger 型別正是 Start 節點所發出、用來驅動執行順序的型別，而 Transform 則是變換鏈節點之間互相傳遞的型別。