什麼是 LoRA 檔案?
LoRA 檔案儲存學習得到的低秩適配器張量,用於修改相容基礎模型的選定層。它通常不包含基礎模型本身。在擴散社群中,適配器常作為一個 .safetensors 檔案分發;在 PEFT 工作流程中,適配器權重通常位於 adapter_config.json 旁。

權重檔案實際包含什麼
從概念上看,LoRA 為所選模組學習成對低秩矩陣。序列化適配器把這些張量值儲存在能夠告訴載入器更新所屬位置的名稱下。它還可能包含容器支援的少量後設資料。
它無需重複基礎模型的每個凍結參數。這是AI 中 LoRA的儲存優勢,也是下載的適配器通常無法獨立使用的原因。
每個 .safetensors 檔案都是 LoRA 嗎?
不是。SafeTensors 是張量容器,不是適配器型別。.safetensors 檔案可以儲存完整檢查點、VAE、嵌入、適配器或其他張量。張量名稱、後設資料和載入器上下文共同確定它所表示的內容。
反過來,LoRA 也不必使用 SafeTensors。Hugging Face PEFT 預設可將適配器權重儲存為 adapter_model.safetensors,或在停用安全序列化時儲存為二進位檔案。其他生態使用自己的打包慣例。應判斷整個軟體套件,而不是熟悉的副檔名。
配套檔案可能必不可少
標準 PEFT 適配器目錄包含權重和 adapter_config.json。該設定記錄 PEFT 型別、目標模組以及重建適配器行為所需參數;還可以標示基礎模型名稱或路徑。模型卡可能包含授權、預期用途和評估上下文。
my_adapter/
├── adapter_model.safetensors # 學習得到的適配器張量
├── adapter_config.json # 如何套用以及套用於何處
└── README.md # 來源、用途和條款
擴散 LoRAs 常作為單一檔案共享,因為目標生態擁有相應慣例或嵌入式後設資料。這種便利可能掩蓋上下文缺失。在重要時,請保留原頁面或模型卡 URL、精確基礎模型識別碼、觸發詞、建議強度、授權和總和檢查碼。
精確基礎模型為何重要
適配器針對特定架構和基礎狀態訓練。載入器可以立即拒絕不相容的張量名稱,但更隱蔽的不相容可能只是產生較差輸出。“SDXL LoRA”或“Llama adapter”並不總是足夠精確的識別碼;可重現性重要時,請使用已釋出儲存庫、修訂版本或精確本機總和檢查碼。
本機修改的基礎模型會形成更強依賴。如果沒有公開來源可以重現,僅保留 LoRA 會讓你只剩下針對已經遺失權重的更新。
LoRA 強度會改變檔案嗎?
通常,執行環境會套用縮放比例而不重寫已儲存適配器。因此,不同 UI 強度值會由相同位元組產生不同推理行為。把適配器融合進基礎模型則不同:它會計算派生權重,並可能儲存新的完整產出物。
當縮放比例和組合順序屬於生產方案時,請記錄它們。如果需要精確融合輸出,請單獨保留該輸出;如果需要靈活性,請保留基礎模型和未融合適配器。
快速檢查清單
- 識別容器並確認載入器支援它。
- 使用受維護的工具檢查張量名稱和後設資料;不要執行未知輔助程式碼。
- 記錄精確相容基礎模型和修訂版本。
- 把設定和模型卡上下文儲存在權重旁。
- 下載後以及每次傳輸後對檔案求雜湊。
- 封存該系列前,請在預期執行環境中測試。
保留依賴關係,而不只是適配器
對於公開、不可變基礎模型,你可以認定精確識別碼已經足夠。對於私有、修改過或可能消失的基礎模型,請把精確基礎模型與適配器一同保留。檢查點與 LoRA 對比有助於判斷哪些產出物滿足復原目標。
Tensor Archive 將選定本機張量分組,以實現經過驗證的精確還原。它不會推斷缺失觸發詞、承諾跨架構相容性,也不會從適配器權重重建基礎模型。
將檔案放入易於管理的模型庫
使用一個基礎模型配多個適配器來整理依賴關係,再在刪除重複或實驗性變體前遵循LoRA 磁碟空間指南。
來源
- LoRA: Low-Rank Adaptation of Large Language Models — 原始低秩更新方法。
- Hugging Face PEFT檢查點格式 — 適配器權重檔名、設定和基礎模型引用。
- Hugging Face PEFT:LoRA — 目前適配器設定和實現。
- Diffusers:載入適配器 — 擴散 LoRA 的載入、加權與融合行為。
- SafeTensors 文件 — 容器保證什麼以及如何載入張量。