預設模組

預設模組是封裝成單一黑箱節點的可重用子圖。CodefyUI 內建模型模板讓你能快速上手，你也可以把自己的選取儲存為預設模組，在不同的圖之間重複使用。

使用預設模組

預設模組會和一般節點一起出現在節點面板與快速搜尋中（在畫布上雙擊開啟）。把它拖進來，它的行為就和任何節點一樣——具備預設模組作者選擇暴露的輸入連接埠、輸出連接埠與參數。

執行時，圖引擎會在執行前把每個預設模組展開成其內部節點，所以預設模組只是封裝上的便利，並不是獨立的執行階段。

建立自己的預設模組

1. 選取你想要封裝的節點（Shift 點擊或框選）。
2. 開啟 Create Preset 對話框。
3. 暴露你想讓預設模組對外呈現的輸入、輸出與參數——其餘的都維持在內部。
4. 儲存。你的預設模組現在會出現在面板中供重複使用。

預設模組以 JSON 儲存，內含其 nodes、edges、exposed_inputs、exposed_outputs 與 exposed_params。內建預設模組位於後端的 presets/ 目錄，並於啟動時載入；外掛包也可以隨附自己的預設模組。

REST API

端點	方法	說明
/api/presets	GET	列出預設模組定義。
/api/presets/{name}	GET	取得單一預設模組定義。
/api/presets/create	POST	從選取的節點建立新預設模組。

請參閱完整的 API 參考。

:::tip 預設模組 vs 自訂節點 當你想封裝一張由既有節點組成的圖時，使用預設模組。當你需要用 Python 實作新行為時，撰寫一個**自訂節點**。 :::