إنتقل إلى المحتوى الرئيسي

سجل النماذج

يستخدم AISCouncil سجل نماذج مجتمعي للحفاظ على قائمة نماذجه المتاحة محدثة. السجل هو ملف JSON مستضاف على GitHub Pages يجلبه التطبيق ويخزنه مؤقتًا.

كيف يعمل​

يحتوي ملف السجل (registry/models.json) على قائمة منظمة من المزودين ونماذجهم ومستويات الأسعار. عند تحميل الصفحة، تجلب وحدة AISCouncil.Registry أحدث بيانات السجل مع ذاكرة تخزين مؤقت 24 ساعة. إذا فشل الجلب، تعود لنسخة محلية مضمنة.

تنسيق السجل​

يحدد السجل المزودين والنماذج مع البيانات الوصفية:

{
  "providers": [
    {
      "id": "anthropic",
      "name": "Anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "tier": "standard"
        }
      ]
    }
  ]
}

المساهمة بالنماذج​

لإضافة أو تحديث النماذج في السجل:

  1. افرم المستودع
  2. حرّر registry/models.json بتغييراتك
  3. شغّل سكربت التحقق: python registry/validate.py
  4. قدّم طلب سحب

يتحقق سكربت التحقق من:

  • بنية JSON صالحة
  • الحقول المطلوبة (id، name، provider)
  • لا معرفات نماذج مكررة
  • قيم tier صحيحة

التحديث التلقائي​

يتجدد السجل تلقائيًا عند تحميل الصفحة. ذاكرة التخزين المؤقت 24 ساعة تمنع الطلبات المفرطة. يمكنك فرض التحديث بمسح البيانات المخزنة مؤقتًا للتطبيق في الإعدادات > الخصوصية.

استضافة GitHub Pages​

يُخدم السجل من GitHub Pages كملف JSON ثابت. هذا يعني:

  • لا منطق من جانب الخادم مطلوب
  • التغييرات تنشر بمجرد دمج PR وإعادة بناء Pages
  • الملف مخزن مؤقتًا في CDN للوصول السريع عالميًا
  • التطبيق يعود بأمان إذا كان GitHub غير قابل للوصول