ذاكرة عرض غير كافية وتعليق: حل منهجي لـ OOM
يظهر CUDA out of memory في منتصف التوليد، أو يتجمد شريط التقدم وتُمتلئ ذاكرة العرض — هذا هو نقص ذاكرة العرض، وهو من أكثر أنواع المشكلات شيوعاً في ComfyUI. لا تتعجل في تغيير بطاقة الرسوميات: باتّباع ترتيب الفحص أدناه، يمكن حل معظم حالات OOM على مستوى البرمجيات. إن كانت هذه أول مرة تستكشف فيها الأخطاء، يُنصح بالاطلاع أولاً على نظرة عامة على استكشاف الأخطاء.
الأعراض: حدّد حالتك أولاً
CUDA out of memory / torch.OutOfMemoryError
أعد تشغيل ComfyUI أولاً لتحرير ذاكرة العرض التي قد تكون تسربت، ثم شغّله بـ --lowvram ليجعل مشفّر النص يعمل على المعالج ويخفض استهلاك ذاكرة العرض.
شريط التقدم يتجمد، وذاكرة العرض ممتلئة لكن دون ظهور خطأ
استخدم nvidia-smi أولاً لتتضح من يشغل ذاكرة العرض، وأغلق المتصفح والألعاب وبرامج الرسم الأخرى، ثم أعد المحاولة.
ينهار حتماً بعد التبديل إلى نموذج أكبر
أوزان النموذج الكبير تتجاوز ذاكرة العرض الفعلية مباشرة، وتعديل المعاملات يخفف فقط؛ التبديل إلى نسخة مكممة أو checkpoint أصغر هو الحل الجذري.
فحص سريع (60 ثانية)
- تأكد باستخدام
nvidia-smiأو مدير المهام: لا متصفح ولا ألعاب ولا برامج ذكاء اصطناعي أخرى تتنافس على ذاكرة العرض. - أعد تشغيل ComfyUI. بعد الانقطاعات غير الطبيعية غالباً لا تُحرَّر ذاكرة العرض، وإعادة التشغيل هي أسرع وسيلة لـ«التصفير».
- اخفض الدقة وحجم الدفعة (batch size) إلى الحد الأدنى، لتثبت أولاً أن سير العمل نفسه يعمل.
- عُدّ كم نموذجاً يُحمَّل في وقت واحد في هذا التوليد: checkpoint وControlNet ونموذج التكبير وLoRA كلها تُحسب.
ما زال OOM يظهر بعد ذلك؟ انتقل إلى الفحص الرسمي.
خطوات الفحص
الخطوة 1: خفض ضغط ذاكرة العرض لتوليد واحد
OOM في الغالب يعني «طلب أشياء كثيرة جداً في المرة الواحدة». اخفض الدقة درجة واحدة أولاً (مثل 512×768) واضبط حجم الدفعة على 1، وبعد أن يعمل أعد رفعها تدريجياً لتجد النقطة الحرجة لجهازك. ثم تحقق مما إذا كان سير العمل يحمل في الوقت نفسه عقد نماذج كبيرة متعددة، وافصل ما لا تحتاجه — كل نموذج مقيم في ذاكرة العرض يرفع الذروة.
الخطوة 2: إعادة توزيع ذاكرة العرض بمعاملات التشغيل
يوفر ComfyUI مجموعة من معاملات التشغيل للتحكم في استراتيجية ذاكرة العرض، ركّبها حسب الحاجة:
--lowvram: وضع ذاكرة العرض المنخفضة، يجعل مشفّر النص يعمل على المعالج، يضحّي بالسرعة مقابل ذاكرة العرض، وهو الأكثر استخداماً.--cpu: ينقل الحساب إلى الذاكرة والمعالج، بطيء للغاية لكنه لا يكاد يسبب OOM، مناسب للتحقق الطارئ من سير العمل.--reserve-vram: يحجز جزءاً من ذاكرة العرض للنظام أو البرامج الأخرى، لتجنب تجمّد الجهاز كله بعد استنزاف بطاقة الرسوميات.--async-offload: يبدّل أوزان النماذج داخلاً وخارجاً بشكل غير متزامن أثناء التوليد، ليخفض الاستهلاك الذروي أكثر (مفعّل افتراضياً على بطاقات NVIDIA).--cache-*سلسلة: تتحكم في استراتيجية استرجاع ذاكرة التخزين المؤقت للنماذج ونتائج العقد، والقيم الشائعة--cache-none(استهلاك أقل للذاكرة/ذاكرة العرض، لكن كل عقدة تُنفَّذ من جديد في كل تشغيل)،--cache-lru 10(تخزين حتى 10 من نتائج العقد)،--cache-classic(تخزين مؤقت عدواني بالإصدار القديم).
مستخدمو الحزمة المحمولة على Windows يضيفون هذه المعاملات عادةً في سكربت التشغيل: حرّر run_nvidia_gpu.bat في جذر الحزمة المحمولة، وأضفها في نهاية سطر .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build.
الخطوة 3: التبديل إلى نموذج أصغر أو نسخة مكممة
إذا استمر OOM المتكرر رغم ضبط المعاملات للحد الأقصى، فهذا يعني أن النموذج نفسه كبير جداً لذاكرة العرض لديك. طريقان: الأول استخدام نماذج GGUF المكممة التي تشغّل النماذج الكبيرة على ذاكرة عرض منخفضة، والطريقة في نماذج GGUF المكممة: تشغيل النماذج الكبيرة على ذاكرة عرض منخفضة؛ والثاني التبديل مباشرة إلى checkpoint أصغر، لتشغيل العملية بسلاسة بنموذج صغير أولاً.
انتبه للتمييز: إذا كان الخطأ يظهر بمجرد تحميل النموذج (وليس OOM في منتصف التوليد)، فالأمر غالباً ليس مشكلة ذاكرة عرض، انتقل إلى الصفحة السابقة فشل تحميل النموذج.
شروط الترقية: متى تتوقف عن ضبط المعاملات
إذا تحقق أي شرط منها، فلا تستمر في إهدار الوقت على مستوى البرمجيات:
--lowvram+ أدنى دقة + نموذج مكمم وما زال OOM يظهر حتماً: ذاكرة العرض أقل فعلياً من الحد الأدنى للنموذج، فكّر في ترقية بطاقة الرسوميات، أو تقبّل التوليد طويل الأمد بالوضع البطيء--cpu.- ذاكرة العرض غير ممتلئة ومع ذلك استمرار التعليق: المشكلة قد لا تكون في ذاكرة العرض، عد إلى نظرة عامة على استكشاف الأخطاء لتحديد السبب بالسجلات.
- الخطأ ليس OOM بل خطأ تحميل أو بنية: انتقل إلى فشل تحميل النموذج.
- لا ينطبق أي منها: خذ سجلات وحدة التحكم الكاملة وابحث عن "out of memory" في مستودع GitHub الخاص بـ ComfyUI، فالأرجح أن أحدهم وقع في المشكلة نفسها.