گره TrainLoraNode یک مدل LoRA (انطباق رتبه-پایین) را بر روی یک مدل انتشار با استفاده از لیتنت‌ها و داده‌های شرطی‌سازی ارائه‌شده ایجاد و آموزش می‌دهد. این گره به شما امکان می‌دهد یک مدل را با پارامترهای آموزشی سفارشی، بهینه‌سازها و توابع خطا تنظیم کنید. خروجی گره شامل وزن‌های LoRA آموزش‌دیده، یک نقشه تاریخچه خطا و تعداد کل مراحل آموزشی تکمیل‌شده است.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
| --- | --- | --- | --- | --- |
| `مدل` | مدلی که LoRA روی آن آموزش داده می‌شود. | MODEL | بله | - |
| `لاتنت‌ها` | لیتنت‌هایی که برای آموزش استفاده می‌شوند، به عنوان مجموعه داده/ورودی مدل عمل می‌کنند. | LATENT | بله | - |
| `شرط مثبت` | شرطی‌سازی مثبت برای استفاده در آموزش. | CONDITIONING | بله | - |
| `اندازه بچ` | اندازه دسته برای استفاده در آموزش (پیش‌فرض: 1). | INT | بله | 1-10000 |
| `تعداد مراحل انباشت گرادیان` | تعداد مراحل انباشت گرادیان برای استفاده در آموزش (پیش‌فرض: 1). | INT | بله | 1-1024 |
| `تعداد مراحل` | تعداد مراحل برای آموزش LoRA (پیش‌فرض: 16). | INT | بله | 1-100000 |
| `نرخ یادگیری` | نرخ یادگیری برای استفاده در آموزش (پیش‌فرض: 0.0005). | FLOAT | بله | 0.0000001-1.0 |
| `رتبه` | رتبه لایه‌های LoRA (پیش‌فرض: 8). | INT | بله | 1-128 |
| `بهینه‌ساز` | بهینه‌سازی که برای آموزش استفاده می‌شود (پیش‌فرض: "AdamW"). | COMBO | بله | "AdamW"<br>"Adam"<br>"SGD"<br>"RMSprop" |
| `تابع خطا` | تابع خطا برای استفاده در آموزش (پیش‌فرض: "MSE"). | COMBO | بله | "MSE"<br>"L1"<br>"Huber"<br>"SmoothL1" |
| `بذر` | دانه (seed) برای استفاده در آموزش (در مولد برای مقداردهی اولیه وزن LoRA و نمونه‌گیری نویز استفاده می‌شود) (پیش‌فرض: 0). | INT | بله | 0-18446744073709551615 |
| `نوع داده آموزش` | نوع داده (dtype) برای استفاده در آموزش. 'none' نوع محاسباتی اصلی مدل را حفظ می‌کند و آن را بازنویسی نمی‌کند. برای مدل‌های fp16، GradScaler به طور خودکار فعال می‌شود (پیش‌فرض: "bf16"). | COMBO | بله | "bf16"<br>"fp32"<br>"none" |
| `نوع داده LoRA` | نوع داده (dtype) برای استفاده در LoRA (پیش‌فرض: "bf16"). | COMBO | بله | "bf16"<br>"fp32" |
| `quantized_backward` | هنگام استفاده از training_dtype 'none' و آموزش بر روی مدل کوانتایز شده، در صورت فعال بودن، backward با ضرب ماتریس کوانتایز شده انجام می‌شود (پیش‌فرض: False). | BOOLEAN | بله | - |
| `الگوریتم` | الگوریتمی که برای آموزش استفاده می‌شود. | COMBO | بله | گزینه‌های متعدد موجود |
| `ذخیره‌سازی گرادیان` | استفاده از ایست بازرسی گرادیان برای آموزش (پیش‌فرض: True). | BOOLEAN | بله | - |
| `checkpoint_depth` | سطح عمق برای ایست بازرسی گرادیان (پیش‌فرض: 1). | INT | بله | 1-5 |
| `offloading` | تخلیه وزن‌های مدل به CPU در طول آموزش برای صرفه‌جویی در حافظه GPU (پیش‌فرض: False). | BOOLEAN | بله | - |
| `LoRA موجود` | LoRA موجود برای الحاق به آن. برای LoRA جدید روی "[None]" تنظیم کنید (پیش‌فرض: "[None]"). | COMBO | بله | گزینه‌های متعدد موجود |
| `حالت سطل‌بندی رزولوشن` | فعال‌سازی حالت سطل وضوح (resolution bucket). در صورت فعال بودن، انتظار لیتنت‌های از پیش سطل‌بندی‌شده از گره ResolutionBucket را دارد (پیش‌فرض: False). | BOOLEAN | بله | - |
| `bypass_mode` | فعال‌سازی حالت عبور (bypass) برای آموزش. در صورت فعال بودن، آداپتورها از طریق هوک‌های پیشرو (forward hooks) به جای تغییر وزن اعمال می‌شوند. برای مدل‌های کوانتایز شده که وزن‌ها را نمی‌توان مستقیماً تغییر داد مفید است (پیش‌فرض: False). | BOOLEAN | بله | - |

**توجه:** تعداد ورودی‌های شرطی‌سازی مثبت باید با تعداد تصاویر لیتنت مطابقت داشته باشد. اگر تنها یک شرطی‌سازی مثبت با چندین تصویر ارائه شود، به طور خودکار برای همه تصاویر تکرار می‌شود.

**توجه در مورد `training_dtype`:** هنگامی که روی "none" تنظیم می‌شود، نوع محاسباتی اصلی مدل حفظ می‌شود. برای مدل‌های fp16، GradScaler به طور خودکار فعال می‌شود تا از زیرریزی (underflow) در طول محاسبه گرادیان جلوگیری کند. اگر `fp16_accumulation` نیز فعال باشد (از طریق پرچم‌های `--fast`)، این ترکیب می‌تواند از نظر عددی ناپایدار باشد و باعث ایجاد مقادیر NaN شود.

**توجه در مورد `quantized_backward`:** این پارامتر تنها زمانی مرتبط است که `training_dtype` روی "none" تنظیم شده باشد و مدل یک مدل کوانتایز شده باشد. این پارامتر ضرب ماتریس کوانتایز شده را در طول پاس backward فعال می‌کند.

**توجه در مورد `bypass_mode`:** در صورت فعال بودن، آداپتورها از طریق هوک‌های پیشرو به جای تغییر مستقیم وزن‌های مدل اعمال می‌شوند. این امر به ویژه برای مدل‌های کوانتایز شده که وزن‌ها را نمی‌توان مستقیماً تغییر داد مفید است.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `lora` | وزن‌های LoRA آموزش‌دیده که می‌توانند ذخیره شوند یا به مدل‌های دیگر اعمال شوند. | LORA_MODEL |
| `loss_map` | یک دیکشنری حاوی مقادیر خطای آموزشی در طول زمان. | LOSS_MAP |
| `تعداد مراحل` | تعداد کل مراحل آموزشی تکمیل‌شده (شامل هر مرحله قبلی از LoRA موجود). | INT |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TrainLoraNode/fa.md)

---
**Source fingerprint (SHA-256):** `df315ef416ff3ce81e6a526af2c4e5115980e6c35830825967e7189d4f8541d8`
