Skip to content

أين تضع النماذج: شرح مفصّل لدليل models و extra_model_paths ​

إذا كنت تبحث عن «أين تضع نماذج ComfyUI»، فربما تحمل الآن ملف .safetensors بحجم عدة غيغابايت تم تنزيله للتو وتحير فيه: الدروس تقول فقط «ضعه في دليل models»، لكنك عند فتحه تجد عشرات المجلدات الفرعية ولا تعرف إلى أيها تسحبه.

يوضح هذا الدرس قواعد أدلة النماذج في ComfyUI بشكل واضح: كيف يبدو دليل models الافتراضي، وأي نموذج يدخل أي دليل فرعي، وكيف تجعل الملفات الموضوعة تظهر في القوائم المنسدلة للعقد، وكيفية استخدام extra_model_paths.yaml الرسمي لوضع النماذج في أي قرص كبير، بل ومشاركتها مع WebUI.

هذه الصفحة هي الدرس 4 من سلسلة البداية السريعة. يمكنك المتابعة بعد تثبيت ComfyUI مباشرة، دون الحاجة لفهم أي سير عمل مسبقًا.

ماذا ستستطيع فعله بعد هذا الدرس ​

  • إجابة من سطر واحد عن سؤال «أين تضع نماذج ComfyUI»:<安装目录>/ComfyUI/models/ الأدلة الفرعية المصنفة حسب النوع
  • وضع checkpoint و LoRA و VAE و ControlNet ونماذج التكبير في الأدلة الفرعية الصحيحة، وإيجادها في القوائم المنسدلة لعقد loader المقابلة
  • استخدام مفتاح r للتحديث (أو إعادة التشغيل) ليتعرف البرنامج على النماذج الموضوعة أثناء التشغيل
  • كتابة ملف extra_model_paths.yaml: لجعل عدة نسخ من ComfyUI، بل وحتى WebUI (A1111)، تتشارك نفس ملفات النماذج دون تنزيل متكرر
  • التمييز بين مواقع أدلة النماذج ومداخل الإعداد في ثلاث طرق تثبيت: الحزمة المحمولة، و Comfy Desktop، والتثبيت اليدوي

مشكلتك الحالية ​

  • نزّلت نموذجًا بحجم نحو 4GB، والدروس تقول فقط «ضعه في models»، فتفتح models وتجد عشرين أو ثلاثين مجلدًا، تتركه عشوائيًا، ثم لا تجده في أي عقدة
  • النموذج موضوع بالفعل، لكنه لا يظهر في القائمة المنسدلة لـ Load Checkpoint، وتحديث الصفحة لا يجدي
  • على حاسوبك WebUI و ComfyUI معًا، فتُنزّل نفس النموذج مرتين، وتختفي عشرات الغيغابايت من القرص؛ وتريد نقله إلى القرص D لكنك تخشى ألا يجده ComfyUI

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • إيجاد الدليل الفرعي الصحيح لملف نموذج تم تنزيله للتو
  • جعل ComfyUI يتعرّف على نماذج موضوعة خارج الدليل الافتراضي (مثل قرص مخصص للنماذج)
  • مشاركة عدة نسخ من ComfyUI، أو ComfyUI + WebUI، لملف نماذج واحد

ولا تريد:

  • إعادة تنزيل النماذج مع كل برنامج أو درس جديد
  • تكديس عشرات الغيغابايت من النماذج في الموقع الافتراضي على القرص C
  • قضاء وقت طويل في دراسة صيغة ملفات الإعداد

🎒 التحضير قبل البدء ​

  • تثبيت ComfyUI وتشغيله بنجاح: لحزمة Windows المحمولة راجع التثبيت: حزمة Windows المحمولة، ولإصدار سطح المكتب / macOS / Linux راجع طرق التثبيت البديلة
  • امتلاك ملف نموذج: إن لم يكن لديك واحد، نزّل أولًا أوزان SD1.5 الرسمية للمبتدئين v1-5-pruned-emaonly-fp16.safetensors (نحو 4GB، وسيُستخدم أيضًا في الدرس التالي لأول توليد صورة)
  • توفير مساحة كافية على القرص: تنبّه الوثائق الرسمية إلى أن نموذج التوليد الواحد غالبًا ما يبلغ عدة غيغابايت، ويحتاج التنزيل والمزامنة إلى ميزانية من الوقت والمساحة
  • فنجان قهوة ☕ (وقت تنزيل النموذج يكفي لشربه)

⚠️ تنبيه للتنزيل داخل الصين

تُستضاف ملفات النماذج غالبًا على Hugging Face و Civitai (مصادر التنزيل المجتمعية المذكورة في الوثائق الرسمية). تشير الوثائق الرسمية إلى أن مستخدمي البر الرئيسي في الصين قد يحتاجون إلى إعداد وكيل (proxy) للوصول المستقر. بطء التنزيل لا يعني أنك أخطأت في الخطوات.

الفكرة الأساسية ​

**ComfyUI يعتمد على «مجلدات متفق عليها» للعثور على النماذج. ** حزمة التثبيت نفسها صغيرة جدًا ولا تحتوي على أي ملفات نماذج؛ ComfyUI مجلد النماذج افتراضيًا في <安装目录>/ComfyUI/models/، وتحته أدلة فرعية مصنفة حسب النوع. ComfyUI يفحص هذه الأدلة عند بدء التشغيل (بالإضافة إلى المسارات المكونة في extra_model_paths.yaml)، ويملأ الملفات التي يجدها في القوائم المنسدلة لعقد loader المقابلة (أسماؤها تبدأ غالبًا بـ Load).

«أين أضعه» دائمًا خطوتان: اسأل عن النوع أولًا، ثم عن الدليل. الـ checkpoint يدخل checkpoints، والـ LoRA يدخل loras، والـ VAE يدخل vae… وضعه في دليل فرعي خاطئ يعادل عدم وضعه — إذا ألقيت checkpoint في مجلد loras، لن تدرجه أي عقدة LoRA.

يمكن ترك الأدلة كما هي، أو إضافة المزيد. extra_model_paths.yaml هو الحل الرسمي لـ «مسارات البحث الإضافية»: ضع النماذج مجمّعة في قرص كبير واحد، وجعل عدة نسخ من ComfyUI، بل وحتى WebUI، تشير إليه. تختلف المداخل باختلاف طرق التثبيت الثلاث:

طريقة التثبيتدليل models الافتراضيمدخل إضافة المسارات الخارجية
حزمة Windows المحمولةComfyUI_windows_portable\ComfyUI\models\extra_model_paths.yaml في الدليل الجذري لـ ComfyUI
التثبيت اليدوي (git clone)<克隆位置>\ComfyUI\models\ (مجلد المستودع المستنسخ)نفس ما سبق (داخل مجلد المستودع)
Comfy Desktopيُدار عبر نسخة سطح المكتب، من قائمة الكبسولة → Storage اعرضواجهة Storage (أو ملف الإعدادات الخاص بها)

وضعته في المكان الصحيح فلماذا لا يُعثر عليه؟ إلى جانب الموقع، هناك بعدان آخران: امتداد الملف يجب أن يكون ضمن قائمة الصيغ المدعومة (.ckpt / .pt / .pt2 / .bin / .pth / .safetensors / .pkl / .sft)؛ والملفات الموضوعة أثناء التشغيل تحتاج إلى تحديث حتى تظهر في القائمة. هذه الأمور الثلاثة هي أبطال قسم «تنبيهات المخاطر» لاحقًا.

اتبع خطواتي ​

الخطوة 1: اعثر على مجلد models الخاص بك——ComfyUI أين توضع النماذج ​

لماذا: موقع المجلد يختلف باختلاف طريقة التثبيت الثلاث، فاعثر على الباب أولًا قبل الحديث عن وضع الأشياء داخله.

مستخدمو الحزمة المحمولة لـ Windows ​

اكتب في شريط العنوان في مستكشف الملفات (استبدل ComfyUI_windows_portable بموقع فك الضغط لديك، مثل D:\ComfyUI_windows_portable\ComfyUI\models\):

text
ComfyUI_windows_portable\ComfyUI\models\

مستخدمو التثبيت اليدوي ​

التثبيت اليدوي الرسمي هو git clone https://github.com/Comfy-Org/ComfyUI.git، والمجلد الناتج عن الاستنساخ يُسمى ComfyUI، وبداخله models هو مجلد النماذج:

text
<你的克隆位置>\ComfyUI\models\

مستخدمو Comfy Desktop ​

لا حاجة للتنقل بين المجلدات: انقر على قائمة الكبسولة في أعلى نسخة سطح المكتب → افتح علامة تبويب Storage لترى مجلدات النماذج المختلفة؛ وانقر على أيقونة المجلد بجانب أي مجلد لفتحه مباشرة في مستكشف ملفات النظام. ملاحظة رسمية: النماذج في نسخة سطح المكتب تُشارك افتراضيًا بين عدة نسخ (instances).

ينبغي أن ترى: صفًا من المجلدات الفرعية داخل مجلد models——checkpoints، loras، vae، controlnet وغيرها.

  • أستطيع فتح مجلد models الخاص بي ورؤية المجلدات الفرعية مثل checkpoints

الخطوة 2: اعرف المجلدات——أي نموذج يوضع في أي مجلد ​

لماذا: يجب أن يتطابق نوع النموذج مع المجلد الفرعي المناسب، والنموذج الموضوع في مكان خاطئ لن يظهر في أي عقدة.

جدول مطابقة الأنواع الشائعة (اسم المجلد الفرعي هو نفس الاسم المسجل في الكود المصدري ComfyUI في folder_paths.py):

نوع النموذجالمجلد الفرعي الذي يوضع فيهعقدة الـ loader المقابلة (مكان القائمة المنسدلة)
Checkpoint النموذج الرئيسيmodels/checkpoints/Load Checkpoint
LoRAmodels/loras/Load LoRA
VAEmodels/vae/Load VAE
ControlNetmodels/controlnet/ (models/t2i_adapter/ يُحتسب أيضًا ضمن هذا النوع)Load ControlNet
نماذج الانتشار (DiT / UNet، شائعة في البنى الجديدة)models/diffusion_models/ (يُعترف أيضًا باسم المجلد القديم models/unet/)Load Diffusion Model
مرمّز النص (CLIP / T5 / Qwen وغيرها)models/text_encoders/ (يُعترف أيضًا باسم المجلد القديم models/clip/)Load CLIP (تستخدم النماذج ذات المرمّز المزدوج مثل FLUX عقدة DualCLIPLoader)
نماذج التكبير (ESRGAN وغيرها)models/upscale_models/Load Upscale Model
Embeddingmodels/embeddings/—

💡 النماذج الجديدة غالبًا ما تكون «ثلاثة ملفات توضع منفصلة»

النماذج الجديدة مثل Z-Image-Turbo و Qwen-Image و Wan2.2 ليست checkpoint واحدًا، بل تنقسم إلى ثلاثة ملفات تُوضع في مجلدات منفصلة: نموذج الانتشار (→ diffusion_models)، ومرمّز النص (→ text_encoders)، وVAE (→ vae)——وقوائم النماذج في الدروس الرسمية تعطي المسارات بهذا التنسيق. لمعرفة أي ملف يدخل في أي خانة، راجع درس النموذج المقابل في نظرة عامة على النماذج×المهام.

💡 يمكن التصنيف داخل المجلدات الفرعية

كل مجلد نوع يدعم التداخل: يمكنك إنشاء مجلدات مثل sd15/ وflux/ داخل models/checkpoints/ للتصنيف، وسيفحص ComfyUI بشكل تكراري، وتظهر الملفات في القائمة المنسدلة بمساراتها متضمنة المجلدات الفرعية.

ينبغي أن ترى: بمطابقة الجدول أعلاه، تستطيع تحديد المجلد الفرعي المناسب لكل ملف نموذج لديك——النموذج الأول v1-5-pruned-emaonly-fp16.safetensors هو checkpoint، فيدخل models/checkpoints/.

  • بمطابقة الجدول أعلاه، أعرف المجلد الفرعي الذي يجب أن يدخله كل نموذج لدي

الخطوة 3: ضع النموذج ليظهر في قائمة العقد ​

لماذا: يفحص ComfyUI المجلدات عند بدء التشغيل فقط؛ ونسخة ComfyUI قيد التشغيل لن تكتشف الملفات الموضوعة حديثًا تلقائيًا.

الخطوات:

  1. ضع ملف النموذج في المجلد الفرعي المقابل. يُنصح بالنموذج الأول أن يكون SD1.5 الرسمي للمبتدئين: v1-5-pruned-emaonly-fp16.safetensors → models/checkpoints/
  2. إذا كان ComfyUI مفتوحًا، اضغط المفتاح r على اللوحة لتحديث تعريفات العقد؛ وإذا لم يظهر في القائمة فأعد تشغيل ComfyUI
  3. انقر نقرًا مزدوجًا على اللوحة للبحث عن Load Checkpoint (أو اسحب واحدة من مكتبة العقد)، ثم افتح قائمتها المنسدلة

ينبغي أن ترى: ظهور v1-5-pruned-emaonly-fp16.safetensors في القائمة المنسدلة لعقدة Load Checkpoint.

💡 الشريط الجانبي لمكتبة النماذج: اسحب للإدراج

انقر على أيقونة Models في الشريط الجانبي الأيسر لفتح مكتبة النماذج: تصفح عبر شجرة المجلدات أو ابحث بالاسم؛ اسحب النموذج مباشرة إلى اللوحة وسيُدرج تلقائيًا في عقدة الـ loader المقابلة مع اختيار الملف——سحب checkpoints يُنتج CheckpointLoaderSimple، وloras هو LoraLoader، وvae هو VAELoader. إذا لم يظهر ملف وُضع للتو، انقر على زر التحديث أعلى اللوحة (نفس الاختصار r).

بعد وضع النموذج الأول، يمكنك في الواقع الانتقال مباشرة إلى أول توليد صورة لإنشاء صورة؛ وإذا أردت إدارة مجلدات النماذج بشكل منهجي، تابع إلى الخطوة 4.

  • ظهر نموذجي في القائمة المنسدلة لعقدة الـ loader

الخطوة 4: إضافة مسارات نماذج خارجية باستخدام extra_model_paths.yaml (الحزمة المحمولة / التثبيت اليدوي) ​

لماذا: النماذج يبلغ حجمها عدة GB غالبًا. إذا أردت تجميع النماذج في قرص كبير مخصص، أو مشاركة نسخة واحدة من الملفات بين عدة نسخ من ComfyUI أو مع WebUI، فهذا الملف yaml هو الحل الرسمي الوحيد.

الطريقة A: نسخ ملف المثال الرسمي (موصى بها) ​

  1. افتح الدليل الجذر لـ ComfyUI — في الحزمة المحمولة هو ComfyUI_windows_portable\ComfyUI\، وفي التثبيت اليدوي هو مجلد المستودع الذي استنسخته. في الداخل ستجد extra_model_paths.yaml.example (ملف الشرح الرسمي المرفق بالحزمة المحمولة يذكر أيضًا: أعد تسميته إلى extra_model_paths.yaml ثم عدّله)
  2. انسخ نسخة منه وأعد تسميتها إلى extra_model_paths.yaml وضعها في نفس الدليل
  3. افتحه باستخدام المفكرة أو أي محرر نصوص، واكتب الإعدادات وفقًا لموقع مكتبة النماذج لديك. لنفترض أن كل نماذجك موجودة تحت D:\AIModels\models\:
text
D:\AIModels\
  └── models\
        ├── checkpoints\
        ├── loras\
        ├── vae\
        └── controlnet\

الإعدادات الدنيا المقابلة (مثال من التوثيق الرسمي):

yaml
my_custom_config:
    base_path: D:\AIModels
    loras: models/loras/
    checkpoints: models/checkpoints/
    vae: models/vae/
    controlnet: models/controlnet/

طريقة القراءة: my_custom_config في المستوى الأعلى هو اسم كتلة الإعدادات، سمِّه كما تشاء؛ base_path هو الدليل الجذر لمكتبة النماذج؛ وكل مفتاح تحته هو نوع نموذج (مطابق للأنواع في جدول الخطوة 2)، وقيمته مجلد فرعي نسبي إلى base_path. يكفي أن تكتب الأنواع التي تملكها فعلًا.

  1. احفظ، ثم أعد تشغيل ComfyUI — يوضح التوثيق الرسمي صراحةً: يجب إعادة التشغيل بعد التعديل حتى يسري المفعول.

يجب أن ترى: ظهور سطر مثل Adding extra search path ... في سجل الإقلاع (مع كل مسار تضيفه، يطبع ComfyUI سجلًا كهذا)؛ وظهور نماذج من الدليل الخارجي في القائمة المنسدلة للـ loader.

  • ظهور Adding extra search path في سجل الإقلاع، وإمكانية اختيار النماذج الموجودة في الدليل الخارجي

الطريقة B: إذا لم يكن الملف موجودًا فأنشئه بنفسك ​

لا مشكلة إذا لم تجد .example — يوضح التوثيق الرسمي: أنشئ extra_model_paths.yaml بأي محرر نصوص وضعه في الدليل الجذر لـ ComfyUI. للحصول على القائمة الكاملة لأسماء المفاتيح راجع ملف المثال الرسمي (الكود المصدري folder_paths.py هو المرجع النهائي لأسماء المفاتيح).

تقدم في طريقة الكتابة (كلها وردت في ملف المثال الرسمي) ​

  • ربط عدة مجلدات بنوع واحد: استخدم صيغة | متعددة الأسطر في YAML، سطر لكل مجلد:
yaml
loras: |
    models/loras/
    models/LyCORIS/
  • يدعم base_path كتابة ~ (الدليل الرئيسي للمستخدم)؛ وعند كتابة مسار نسبي، يتم تحليله اعتمادًا على الدليل الذي يقع فيه ملف yaml
  • is_default: true: يضع هذا المسار في مقدمة القائمة ويجعله دليل التنزيل الافتراضي (مثلًا التنزيل التلقائي لمكتبة القوالب يُحفظ فيه)
  • يمكن أيضًا ربط عقد مخصصة خارجية: أضف custom_nodes: <路径>. لاحظ أنه لا يغيّر موقع التثبيت الافتراضي للعقد، بل يضيف مسار بحث إضافيًا فقط؛ ولا تزال تبعيات Python للعقد بحاجة إلى التثبيت في البيئة المقابلة

الطريقة C: مشاركة نسخة واحدة من النماذج مع WebUI (A1111) ​

يقدم التوثيق الرسمي مباشرةً كتلة إعدادات للتعايش مع A1111 WebUI. إذا كان WebUI مثبتًا لديك في D:\stable-diffusion-webui\، فاكتبها هكذا وفقًا للمثال الرسمي:

yaml
a111:
    base_path: D:\stable-diffusion-webui\
    checkpoints: models/Stable-diffusion
    configs: models/Stable-diffusion
    vae: models/VAE
    loras: |
         models/Lora
         models/LyCORIS
    upscale_models: |
                  models/ESRGAN
                  models/RealESRGAN
                  models/SwinIR
    embeddings: embeddings
    hypernetworks: models/hypernetworks
    controlnet: models/ControlNet

بعد الحفظ وإعادة التشغيل، يقرأ ComfyUI مباشرةً دليل نماذج WebUI — نسخة واحدة من النماذج يستخدمها الطرفان، دون حاجة أي منهما إلى إعادة التنزيل.

الخطوة 5: مستخدمو Comfy Desktop — أضف الدليل عبر واجهة Storage ​

لماذا: النسخة المكتبية لديها واجهة رسومية، ويوصي التوثيق الرسمي بالإضافة مباشرةً من الواجهة دون كتابة yaml يدويًا.

الخطوات: انقر فوق قائمة الكبسولة في الأعلى → تبويب Storage → أضف دليل النماذج لديك. يقدم توثيق سطح المكتب الرسمي درجتين من الدقة:

  • للمشاركة مع جميع النسخ: Desktop Settings → Storage → Shared Models → + Add Shared Directory
  • لاستخدام نسخة واحدة فقط: Manage → Storage → Model Directories

يمكنك أيضًا تعديل ملف الإعدادات مباشرةً: في Windows يكون في C:\Users\<用户名>\AppData\Roaming\ComfyUI\extra_models_config.yaml، وفي macOS في ~/Library/Application Support/ComfyUI/extra_models_config.yaml. لدى التوثيق الرسمي ثلاث ملاحظات:

  • قبل التعديل قم بـنسخة احتياطية من ملف الإعدادات حتى تتمكن من الاستعادة إذا أفسدته؛ لا تستبدل إعدادات المسارات المولّدة أثناء التثبيت
  • يضيف توثيق سطح المكتب في الإصدار الجديد: الملف في app data المذكور أعلاه كان مخصصًا للنسخة المكتبية القديمة، أما الإصدار الحالي فيُفضَّل فيه استخدام واجهة Storage
  • يمكن أيضًا وضع extra_model_paths.yaml في مجلد ComfyUI الخاص بالنسخة (<安装目录>/ComfyUI/extra_model_paths.yaml)، وسيُحمَّل عند الإقلاع كذلك

يجب أن ترى: ظهور الدليل الذي أضفته في تبويب Storage؛ وبعد إعادة التشغيل يمكن للشريط الجانبي لمكتبة النماذج استعراض النماذج الموجودة في الدليل الخارجي.

  • (لمستخدمي Desktop) أضفت الدليل في تبويب Storage، وقد أخذت نسخة احتياطية من ملف الإعدادات

نقطة تحقق ✅ ​

  • أستطيع فتح دليل models الخاص بي بنقرة واحدة، وأعرف المسار الكامل
  • أعرف أي مجلد فرعي يذهب إليه كل من checkpoint / LoRA / VAE / ControlNet / نماذج التكبير
  • النماذج التي وضعتها أثناء التشغيل، أقوم بتحديثها عبر r (وإن لم ينجح أعيد التشغيل) لتظهر في القائمة المنسدلة
  • إذا ضبطت مسارات خارجية: extra_model_paths.yaml موجود في الدليل الجذر لـ ComfyUI، وأعدت التشغيل بعد التعديل، وظهر Adding extra search path في السجل
  • إذا شاركت مع WebUI: يستطيع الـ loader في كلا الطرفين عرض نفس ملفات النماذج

تنبيهات للمزالق ​

❌ وضعت النموذج لكنه لا يظهر في القائمة المنسدلة ​

راجع بالترتيب وفق خطوات استكشاف الأخطاء الرسمية: تأكد أن الملف في المجلد الفرعي الصحيح (الـ checkpoint في models/checkpoints/، وليس في الدليل الجذر لـ models، وليس في loras) → حدّث تعريفات العقد عبر r → أعد تشغيل ComfyUI → تأكد أنك تنظر إلى عقدة loader الصحيحة. إن لم تجده بعد، فتحقق من الامتداد: قائمة الامتدادات المدعومة هي .ckpt / .pt / .pt2 / .bin / .pth / .safetensors / .pkl / .sft. إن لم ينجح أي من ذلك، فقد يكون النموذج نفسه غير معروف للإصدار الحالي — يذكّر التوثيق الرسمي بالحفاظ على تحديث ComfyUI وبالتأكد أولًا من وجود سير عمل مطابق في مكتبة القوالب؛ لمزيد من أخطاء النماذج (عدم تطابق البنية، فشل التحميل) راجع فشل تحميل النماذج.

❌ ملف .gguf لا يتفاعل بعد وضعه ​

ComfyUI لا يدعم GGUF أصلًا — فـ .gguf غير موجود في قائمة الامتدادات أعلاه. لاستخدام نماذج GGUF المكممة، ثبّت أولًا عقدة المجتمع city96/ComfyUI-GGUF، ثم استخدم الـ loader الذي توفره. لمعرفة متى يستحق GGUF الاستخدام وكيفية ضبطه، راجع نماذج GGUF المكممة.

❌ تعديل extra_model_paths.yaml لم يسري مفعوله ​

ثلاثة أسباب شائعة:

  • الموقع خاطئ: يجب أن يكون الملف في الدليل الجذر لـ ComfyUI (في الحزمة المحمولة هو ComfyUI_windows_portable\ComfyUI\، وليس المجلد الخارجي المحيط)
  • لم تتم إعادة التشغيل: يوضح التوثيق الرسمي صراحةً أن إعادة التشغيل ضرورية ليسري المفعول
  • اسم الملف غير صحيح: عند الحفظ من المفكرة في Windows يُحفظ الملف غالبًا باسم extra_model_paths.yaml.txt — افتح خيار «إظهار امتدادات الملفات» في مستكشف الملفات للتأكد

إذا عدّلت الإعدادات ثم أعدت التشغيل ولم يبدأ البرنامج، فهذه مشكلة في الإقلاع، راجع ماذا أفعل إذا فشل التثبيت.

❌ خلط Tab مع المسافات البادئة في yaml فلا تُقرأ الإعدادات ​

تتطلب صياغة YAML استخدام مسافات للمسافات البادئة، وملف المثال الرسمي يستخدم مسافات 4 بالكامل. عند التحرير بالمفكرة لا تضغط مفتاح Tab؛ ويجب محاذاة أسماء مفاتيح الأنواع أسفل اسم كتلة الإعدادات (كما في المثال أعلاه). إذا أفسدت الملف، انسخ نسخة أخرى من .example وابدأ من جديد.

نصائح متقدمة (اختياري) ​

🔧 تغيير مجلد النماذج مباشرة عبر معاملات الإقلاع: بدون تعديل yaml، يمكنك استخدام معاملات الإقلاع. --models-directory <目录> يوجّه مجلد النماذج بالكامل إلى مكان آخر؛ و--base-directory <目录> أكثر شمولًا، إذ ينقل models وcustom_nodes وinput وoutput وtemp وuser معًا. يقوم مستخدمو الحزمة المحمولة بتحرير .bat لإضافة المعامل (يجب إنشاء المجلد الهدف مسبقًا):

bat
.\python_embeded\python.exe -s ComfyUI\main.py --models-directory D:\AIModels\models --windows-standalone-build
pause

🔧 جعل ComfyUI يقرأ ملف إعدادات إضافيًا: --extra-model-paths-config <路径> يمكنه تحميل ملف yaml إضافي أو أكثر إلى جانب extra_model_paths.yaml — مثلًا وضع الإعدادات المشتركة في مجلد مزامنة منفصل وتوصيله عند الحاجة.

🔧 أين تُحفظ التنزيلات التلقائية لمكتبة القوالب: عند التنزيل التلقائي للنماذج الناقصة عبر مكتبة القوالب، يقوم زر Download في Desktop بالحفظ مباشرة في المجلد الفرعي المقابل في ComfyUI/models/؛ أما النسخة المستضافة ذاتيًا المفتوحة في المتصفح فتُطلق تنزيل المتصفح، وتحتاج إلى وضع الملف في المجلد يدويًا. لمعرفة المزيد عن مكتبة القوالب راجع مكتبة القوالب.

🔧 حذف النماذج: لا يوجد زر «إزالة النموذج» في الواجهة — إذا لم تعد تريده، احذف الملف مباشرة من المجلد الفرعي المقابل.

🔧 الاسم الرسمي لمفتاح r: اختصار التحديث هذا يقابل خيار الإعدادات Comfy.RefreshNodeDefinitions. لمزيد من الاختصارات راجع مرجع سريع للاختصارات والواجهة.

خلاصة هذا الدرس ​

✅ أين تضع نماذج ComfyUI: الافتراضي <安装目录>/ComfyUI/models/، وفي الحزمة المحمولة يكون ComfyUI_windows_portable\ComfyUI\models\؛ أما Comfy Desktop فتعرض وتدير من قائمة الكبسولة → Storage.

✅ أي نموذج في أي مجلد: checkpoint→checkpoints، LoRA→loras، VAE→vae، ControlNet→controlnet، نماذج الانتشار→diffusion_models، مرمّزات النصوص→text_encoders، التكبير→upscale_models؛ امتدادات الملفات مقصورة على .ckpt / .pt / .pt2 / .bin / .pth / .safetensors / .pkl / .sft.

✅ بعد وضع النماذج يجب التحديث: اضغط r أثناء التشغيل، وإن لم ينجح فأعد التشغيل، حتى يظهر النموذج في القائمة المنسدلة للمحمّل.

✅ يمكن إضافة مسارات نماذج ComfyUI: ضع extra_model_paths.yaml في المجلد الجذري لـ ComfyUI، مع base_path + اسم مفتاح النوع، ويمكن توصيل عدة مجلدات لنوع واحد، ويجب إعادة التشغيل بعد التعديل؛ في Desktop استخدم واجهة Storage. هذا هو حل النماذج المشتركة الرسمي لـ ComfyUI.

مراجعة حقول الإعدادات الأساسية:

الحقلالصياغةالوصف
base_pathالمجلد الجذري لمكتبة النماذج (يدعم ~)جذر كتلة الإعدادات، وتُحل المسارات الفرعية بالنسبة إليه
checkpoints / loras / vae / controlnet…مجلدات فرعية نسبية إلى base_path؛ المتعددة تُكتب بـ `` أسطر متعددة
is_defaulttrue (اختياري)يوضع المسار في المقدمة ويعمل كمجلد التنزيل الافتراضي
custom_nodesمجلد العقد الخارجية (اختياري)يضيف مسارات بحث للعقد دون تغيير مكان التثبيت الافتراضي
مكان الملفComfyUI المجلد الجذري (بجانب main.py)الحزمة المحمولة في ComfyUI_windows_portable\ComfyUI\
شرط سريان الإعداداتإعادة التشغيل بعد الحفظيشترطه ComfyUI رسميًا بشكل صريح

استعراض الدرس التالي ​

النماذج في مكانها، وفي الدرس التالي سننتج أول صورة: التوليد الأول: شرح مفصل لسير العمل الافتراضي عقدة بعقدة.

ستتعلم:

  • ماذا تفعل كل عقدة من عقد سير العمل الافتراضي للنص إلى صورة البالغ عددها 6 عقدة (Load Checkpoint → Empty Latent Image → CLIP Text Encode → KSampler → VAE Decode → Save Image)
  • أين تُكتب التعليمات الإيجابية والسلبية، وكيفية استخدام صياغة الأوزان (关键词:1.2)
  • كيفية ضبط معاملات KSampler مثل steps / cfg / denoise
  • تشغيل وحفظ أول صورة لك بالضغط على Run (Ctrl+Enter)

لا تريد البدء من SD1.5 وتريد الانتقال مباشرة إلى مسارات عمل النماذج الجديدة مثل Z-Image-Turbo وQwen-Image وFLUX؟ اذهب إلى نظرة عامة على النماذج×المهام واختر صفحة واتبعها.

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.