ComfyUI 模型庫備份:保留工作流程,回收磁碟空間
有用的 ComfyUI 備份始於正在執行的安裝實際載入的路徑。盤點原生資料夾和每個額外模型路徑,把已知工作流程所需的檢查點與配套模型歸為一個系列,將該系列封存,再復原到單獨測試位置。只有工作流程成功執行後,你才可以選擇刪除冗餘副本。

從 ComfyUI 的活動模型路徑開始
原生 ComfyUI 模型資料夾按型別組織:檢查點、擴散模型、LoRAs、VAEs、文字編碼器、ControlNets 等。extra_model_paths.yaml 或 Desktop 的 extra_models_config.yaml 可以把這些型別指向其他模型庫。自訂節點可能會註冊額外位置。
這意味著僅複製 ComfyUI/models 可能會產生一個看似可信但並不完整的備份。開啟活動模型資料夾,檢查額外路徑設定,並記錄你關心的工作流程所使用的自訂節點儲存。
ComfyUI/models/ # 原生型別資料夾
/Volumes/AI-Library/models/ # 一個可能的額外路徑
custom_nodes/... # 僅當某個節點軟體套件在此擁有資產時
先備份一個工作流程系列,而不是整個硬碟
選擇一個重要工作流程。檢視其載入器節點,確定它引用的確切檢查點或擴散模型、VAE、文字編碼器、LoRAs、ControlNets 及其他模型資產。儲存工作流程 JSON 或包含工作流程後設資料的影像,但不要把該圖誤認為權重本身。
模型系列邊界讓首次復原測試易於理解。如果復原後的工作流程失敗,你可以看出遺漏了哪項依賴。未經篩選的數 TB 副本會讓遺漏更難診斷,並推遲你確認任何內容可復原的時點。
尋找副本時,不要假定名稱能證明檔案相同
同一個檢查點可能以不同名稱同時存在於原生和額外資料夾中。兩個相同檔名也可能包含不同位元組。在把候選檔案稱作副本前先進行雜湊,並記錄哪些活動路徑和工作流程引用每份副本。
共享額外路徑可以消除多個 ComfyUI 安裝之間的冗餘工作副本,但也會形成共享故障域。從該模型庫中刪除內容會影響所有指向它的安裝。共享路徑是組織方式,不是備份。
建立並驗證封存
- 停止對所選模型系列進行中的下載、訓練和寫入。
- 記錄來源路徑、大小和總和檢查碼。
- 在不改變張量精度或格式的情況下封存完整的相關模型系列。
- 接觸工作檔案前先執行封存驗證。
- 復原到有足夠空間進行真實測試的新目錄。
- 逐位元組比較還原內容和原始檔。
Tensor Archive 專為這個本機精確保留步驟設計:選擇相關本機張量,將其封存並驗證,然後復原原始位元組以作證明。它不會編輯 ComfyUI 的 YAML、自動刪除原始檔,也不會認定兩個視覺相似的輸出來自可互換模型。
讓 ComfyUI 載入復原後的模型系列
將測試目錄新增為額外模型路徑,或把還原後的檔案放入隔離的 ComfyUI 測試安裝。重新啟動 ComfyUI,使路徑狀態的變化毫無歧義。開啟已儲存工作流程,並在加入佇列前檢查每個模型載入器。
執行適合該工作流程的小型確定性測試或其他可識別測試。目標不是證明產生輸出在每種硬體和軟體環境中都能達到位級一致,而是證明模型檔案已逐位元組還原,並且預期工作流程能夠載入它們。
不要意外地用原件進行測試。 在隔離的測試設定中暫時刪除或停用原來的額外路徑,防止 ComfyUI 靜默回退到工作副本。
按最安全的順序回收空間
- 刪除已重新導向引用的位元組級相同冗餘工作副本。
- 只有在記錄來源後,才審查過時的實驗性 LoRAs 和檢查點。
- 當派生的量化或合併副本無法重建原始產出物時,請保留原始產出物。
- 在復原後的模型系列經受一次重啟和真實工作流程載入前,不要改動活動路徑。
對於適配器密集的安裝,請遵循專門的LoRA 模型庫磁碟空間釋放指南。對於更廣泛的梳理,請使用模型庫保留清單。
此備份本身不會保留的內容
模型權重只是可重現 ComfyUI 環境的一部分。請使用適合相應資產的工具,保留 ComfyUI 和自訂節點版本、工作流程檔案、相關 Python 或軟體套件狀態、提示詞、隨機種子和授權條款。Tensor Archive 專注於張量保留;原始碼控制和環境清單仍各有職責。
來源
- ComfyUI 文件:模型 — 原生資料夾型別、Desktop 位置、額外路徑和故障排除。
- ComfyUI extra model paths example(額外模型路徑範例) — 目前外部模型庫設定鍵。
- ComfyUI folder_paths.py — 目前預設註冊和執行環境路徑處理。