Skip to content

تشخيص أخطاء العقد المخصصة: عطّل أولاً ثم استخدم البحث الثنائي ​

خطأ عند الإقلاع، عقد تحولت للأحمر، تعليق بعد تثبيت عقد جديدة؟ لا تتعجل بإعادة تثبيت ComfyUI——يمكن تحديد معظم أخطاء العقد المخصصة في ComfyUI خلال عشر دقائق: عطّل جميع العقد أولاً لتأكيد النطاق، ثم استخدم البحث الثنائي لتحديد العقدة المسببة.

الأعراض ​

عند ظهور أي من هذه الحالات، اشتبه بالعقد المخصصة أولاً:

  • عند الإقلاع تظهر في وحدة التحكم سلسلة من أخطاء فشل الاستيراد باللون الأحمر (مثل Failed to import وCannot import … module for custom nodes)، وتفتقد عقد في قائمة العقد.
  • بعد تحميل سير العمل، تظهر بعض العقد باللون الأحمر على اللوحة.
  • بعد تثبيت حزمة عقد جديدة مباشرة، يعلق ComfyUI عند شاشة الإقلاع أو ينهار فوراً.

الخطوة الأولى:

ظهور خطأ مثل Failed to import في سجل الإقلاع ​

أقِل مرة واحدة باستخدام --disable-all-custom-nodes أولاً، لتفصل بين "مشكلة العقد" و"مشكلة ComfyUI نفسه".

ظهور العقدة باللون الأحمر على اللوحة ​

تأكد من أن حزمة العقد مثبتة ومفعّلة؛ إذا بقيت حمراء بعد التحديث فهذا يعني أن استيراد الحزمة فشل، فارجع إلى سجل الإقلاع لمعرفة السبب.

تعليق الإقلاع أو الانهيار بعد تثبيت عقد جديدة ​

عطّل جميع العقد أولاً لاستعادة الإقلاع، ثم استخدم البحث الثنائي للعثور على العقدة المسببة للمشكلة.

فحص سريع (60 ثانية) ​

  • هل ثبّت أو حدّثت حزمة عقد مؤخراً؟ استرجعها أو أزلها أولاً.
  • هل تستخدم النسخة المحمولة (Portable)؟ أثناء التشخيص يجب تعديل ملف الإقلاع .bat لإضافة المعامل.
  • بعض العقد تقوم عند الإقلاع الأول بتنزيل نماذج عبر الإنترنت، فتحقق من الشبكة والوكيل أولاً.
  • يجب تثبيت التبعيات في بيئة Python التي يستخدمها ComfyUI فعلياً، وليس في Python الخاص بالنظام.

خطوات التشخيص الثلاث ​

الخطوة 1: الإقلاع مع تعطيل جميع العقد المخصصة ​

النسخة المحمولة: افتح ملف الإقلاع .bat الذي تنقر عليه عادةً بالمفكرة (لبطاقات NVIDIA هو run_nvidia_gpu.bat، و AMD هو run_amd_gpu.bat، و CPU هو run_cpu.bat)، وأضف --disable-all-custom-nodes إلى نهاية أمر الإقلاع، ثم احفظ وأعد التشغيل.

التثبيت من المصدر أو عبر venv: أضف المعامل نفسه بعد أمر الإقلاع.

إذا أقلّ بشكل طبيعي فالمشكلة في العقد، انتقل إلى الخطوة 2؛ إذا استمر الخطأ فالمشكلة في ComfyUI نفسه أو في البيئة، فارجع أولاً إلى نظرة عامة على استكشاف الأخطاء.

الخطوة 2: تحديد العقدة المسببة للمشكلة بالبحث الثنائي ​

قسّم حزم العقد في دليل custom_nodes إلى نصفين متساويين، وانقل نصفها مؤقتاً خارج الدليل (قصّه إلى مكان آخر كنسخة احتياطية)، وأبقِ النصف الآخر فقط لاختبار الإقلاع:

  • إذا ظهر الخطأ: المشكلة في النصف المُبقى، فاستمر في التقسيم إلى نصفين.
  • إذا عمل بشكل طبيعي: المشكلة في النصف المنقول، فأعده واستمر في التقسيم إلى نصفين.

بعد جولتين أو ثلاث يمكن تحديد حزمة عقد واحدة: عدد أقصى 4 جولات لـ 10 حزم، وهو أسرع بكثير من التجربة واحدة تلو الأخرى.

الخطوة 3: إصلاح أو استبدال العقدة المسببة للمشكلة ​

  • حدّث إلى أحدث إصدار أولاً: معظم الأخطاء سببها عدم مواكبة العقد لواجهات النسخة الجديدة من ComfyUI.
  • ثبّت التبعيات الناقصة حسب README: ادخل إلى دليل العقدة، ونفّذ pip install -r requirements.txt@@I18N_KEEP_000022@@ باستخدام Python الخاص بـ ComfyUI.
  • إذا استمر الفشل: افتح issue في مستودع العقدة مع سجل الإقلاع الكامل، أو احذفها واستبدلها بعقدة بديلة بنفس الوظيفة.

متى تتصاعد المشكلة ​

  • إذا لم يُقل رغم تعطيل جميع العقد: المشكلة ليست في العقد، انتقل إلى فشل تحميل النموذج.
  • إذا كان الخطأ في السجل يشير إلى torch أو CUDA أو ذاكرة الفيديو وليس إلى import: فهي مشكلة بيئة، لا تضيّع الوقت على العقد.
  • إذا استمر الخطأ بعد التحديث وإعادة تثبيت التبعيات: اطلب المساعدة في قسم issues بمستودع العقدة، مع إرفاق السجل الكامل ورقم إصدار ComfyUI.

قراءات ذات صلة: نظرة عامة على استكشاف الأخطاء · فشل تحميل النموذج · مكتبة القوالب: تحميل سير العمل الرسمي بنقرة واحدة

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.