إدارة النماذج في المحرر

يوفر الملحق لوحة إعدادات داخل محرر Unreal Engine حيث يمكنك استعراض النماذج وتنزيلها واستيرادها وحذفها واختبار نماذج LLM.

الوصول إلى إعدادات الملحق

1. افتح Edit → Project Settings
2. انتقل إلى Plugins → Runtime Local LLM

تحتوي لوحة الإعدادات على قسمين رئيسيين:

• Downloaded Models: النماذج الموجودة حاليًا على القرص وجاهزة للاستخدام
• Available Models: نماذج مُعرَّفة مسبقًا من الكتالوج المدمج يمكنك تنزيلها

تنزيل النماذج

1. في قسم Available Models، ابحث عن عائلة النموذج والبديل الذي تريده
2. انقر فوق زر Download بجوار البديل
3. يظهر شريط تقدم حالة التنزيل
4. بمجرد الانتهاء، ينتقل النموذج إلى قسم Downloaded Models

يمكنك تنزيل عدة نماذج في وقت واحد. لإلغاء عملية تنزيل قيد التقدم، انقر فوق زر Cancel بجوارها.

لحذف أي نماذج تم تنزيلها، انقر فوق زر Delete بجوار النموذج الذي تريد إزالته.

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

اختيار نموذج

بالنسبة لمنصات الهواتف المحمولة/الواقع الافتراضي، ابدأ بنموذج صغير (1B–3B معلمات) بتكميم Q4_K_M. بالنسبة لأجهزة سطح المكتب، توفر نماذج 7B بتكميم Q4_K_M أو Q5_K_M توازنًا جيدًا بين الجودة والأداء.

استيراد النماذج المخصصة

يمكنك استيراد أي ملف GGUF من نظام الملفات المحلي أو عبر رابط URL:

1. انقر على زر Import Custom Model في أعلى لوحة الإعدادات
2. في مربع الحوار الذي يظهر، اختر وضعًا:
   • Import Local File: استعرض بحثًا عن ملف .gguf على القرص
   • Download from URL: أدخل رابط URL مباشر لملف .gguf
3. املأ اسم النموذج والوصف الاختياري / عدد المعلمات
4. انقر على Confirm للاستيراد أو بدء التنزيل

عند استيراد ملف محلي، يقوم الملحق بنسخه إلى مجلد Content/RuntimeLocalLLM/Models وينشئ ملف بيانات وصفية جانبي. عند الاستيراد من عنوان URL، يقوم الملحق بتنزيل الملف مباشرة إلى ذلك المجلد.

تُعامل النماذج المخصصة مثل النماذج المُنزَّلة وسيتم تجميعها مع مشروعك.

اختبار النماذج في المحرر

يتضمن الملحق نافذة اختبار لاختبار الاستدلال السريع دون تشغيل لعبتك:

1. انقر على زر Test LLM في أعلى لوحة الإعدادات
2. في نافذة الاختبار، اختر نموذجًا من القائمة المنسدلة للنماذج الموجودة على القرص
3. اضبط معامِلات الاستدلال (درجة الحرارة، الحد الأقصى للرموز، موجه النظام، إلخ)
4. أدخل موجّهًا وانقر على Send
5. شاهد تدفق الاستجابة في الوقت الفعلي
6. انقر على Stop لإلغاء التوليد، أو Clear لإعادة ضبط المحادثة

هذا مفيد للتحقق من أن النموذج يعمل بشكل صحيح قبل دمجه في منطق لعبتك.

إعدادات التغليف

عندما تقوم بتنزيل نموذج أو استيراده، يقوم المكون الإضافي تلقائيًا بتحديث إعدادات التغليف لمشروعك لتضمين مجلد RuntimeLocalLLM/Models في Additional Non-Asset Directories To Copy (DirectoriesToAlwaysStageAsNonUFS). هذا يضمن شحن جميع ملفات النموذج مع البنية المُجمَّعة. لا تحتاج إلى تكوين هذا يدويًا.