README_AR.md

أداة اختبار API للنماذج اللغوية الكبيرة

🚀 أداة شاملة لاختبار ومقارنة أداء واجهات برمجة التطبيقات للنماذج اللغوية الكبيرة

🌐 🚀 العرض التوضيحي المباشر - جربه الآن!

اللغات: English | 中文 | العربية | Deutsch | Español | Français | 日本語

📖 نظرة عامة

أداة اختبار API للنماذج اللغوية الكبيرة هي أداة قوية تعتمد على الويب مصممة لقياس ومقارنة أداء واجهات برمجة التطبيقات المختلفة للنماذج اللغوية الكبيرة. سواء كنت تقيم مقدمي خدمات مختلفين، أو تحسن تطبيقات الذكاء الاصطناعي الخاصة بك، أو تجري بحثاً، فإن هذه الأداة توفر مقاييس ورؤى شاملة.

✨ الميزات الرئيسية

🔌 دعم واجهات برمجة التطبيقات

• OpenAI: GPT-3.5، GPT-4 والنماذج الأحدث
• Google Gemini: Gemini Pro، Gemini Pro Vision
• واجهات برمجة التطبيقات المخصصة: أي نقطة نهاية متوافقة مع OpenAI

📊 مقاييس الأداء

• وقت الاستجابة: قياس زمن استجابة الرمز الأول
• سرعة الإخراج: حساب الرموز في الثانية
• معدل النجاح: تتبع موثوقية واجهة برمجة التطبيقات
• تقييم الجودة: أدوات مقارنة الاستجابات

🌐 تجربة المستخدم

• واجهة متعددة اللغات: دعم 7 لغات
• تصميم متجاوب: يعمل على سطح المكتب والهاتف المحمول
• نتائج فورية: مراقبة الأداء المباشر
• تتبع التاريخ: سجلات اختبار دائمة

☁️ خيارات النشر

• التطوير المحلي: إعداد خادم HTTP بسيط
• الاستضافة الثابتة: متوافق مع أي مضيف ثابت

🚀 البدء السريع

المتطلبات الأساسية

• متصفح ويب حديث (Chrome، Firefox، Safari، Edge)
• Node.js و npm مثبتان
• مفاتيح API للخدمات التي تريد اختبارها

التطوير المحلي

1. استنساخ المستودع

   git clone https://github.com/qjr87/llm-api-test.git
   cd llm-api-test

2. تثبيت التبعيات وبدء الخادم

   npm install
   npm start

   الطرق البديلة:

   # باستخدام Python 3
   python -m http.server 8000
   
   # باستخدام PHP
   php -S localhost:8000

3. فتح في المتصفح انتقل إلى http://localhost:8000

🔧 دليل التكوين

إعداد واجهة برمجة التطبيقات

1. اختيار البروتوكول: اختر مقدم واجهة برمجة التطبيقات (OpenAI، Gemini، أو مخصص)
2. إدخال نقطة النهاية: رابط واجهة برمجة التطبيقات (يتم ملؤه تلقائياً للمقدمين القياسيين)
3. إضافة مفتاح API: مفتاح المصادقة الخاص بك
4. تكوين النماذج: حدد النماذج المراد اختبارها

معاملات الاختبار

• جولات الاختبار: عدد التكرارات لكل نموذج
• المطالبات: مطالبات اختبار مخصصة أو استخدام الافتراضية
• التزامن: معالجة الطلبات المتوازية

مثال على التكوين

// تكوين OpenAI
البروتوكول: "openai"
رابط API: "https://api.openai.com/v1/chat/completions"
مفتاح API: "sk-..."
النماذج: "gpt-3.5-turbo,gpt-4"

// تكوين Gemini
البروتوكول: "gemini"
رابط API: "https://generativelanguage.googleapis.com/v1beta/models"
النماذج: "gemini-pro"

🚀 النشر

الاستضافة الثابتة

انشر على أي خدمة استضافة ثابتة:

• Vercel: vercel --prod
• Netlify: اسحب وأفلت مجلد المشروع
• GitHub Pages: فعّل في إعدادات المستودع
• Firebase Hosting: firebase deploy

نشر Docker

FROM nginx:alpine
COPY . /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

docker build -t llm-api-test .
docker run -p 8080:80 llm-api-test

📁 هيكل المشروع

llm-api-test/
├── 📄 index.html          # واجهة التطبيق الرئيسية
├── 🧠 app.js             # منطق التطبيق الأساسي وتنسيق الاختبارات
├── 🔌 api-handlers.js    # تنفيذ بروتوكولات واجهة برمجة التطبيقات
├── 🎨 styles.css         # تصميم واجهة المستخدم المتجاوب
├── 🌍 i18n.js           # التدويل ودعم اللغات
└── 📜 LICENSE           # رخصة MIT

المكونات الأساسية

• فئة APITester: تنسيق الاختبار الرئيسي وإدارة واجهة المستخدم
• فئة APIHandler: تنفيذ واجهة برمجة التطبيقات الخاصة بالبروتوكول
• نظام I18n: دعم متعدد اللغات مع التحميل الديناميكي
• محرك النتائج: حساب مقاييس الأداء في الوقت الفعلي

🛠️ المكدس التقني

الواجهة الأمامية

• HTML5: ترميز دلالي وإمكانية الوصول
• CSS3: تصميم حديث مع Flexbox/Grid
• JavaScript خالص: بدون تبعيات إطار عمل
• واجهات برمجة تطبيقات الويب: Fetch، LocalStorage، التدويل

الهندسة المعمارية

• تصميم معياري: فصل الاهتمامات
• مدفوع بالأحداث: تحديثات واجهة المستخدم التفاعلية
• التحسين التدريجي: يعمل بدون JavaScript
• الهاتف المحمول أولاً: مبادئ التصميم المتجاوب

النشر

• الاستضافة الثابتة: توافق عالمي
• جاهز لـ CDN: توزيع المحتوى العالمي

📊 شرح مقاييس الأداء

المقياس	الوصف	النطاق الجيد
وقت الرمز الأول	الوقت لاستقبال أول رمز استجابة	< ثانيتان
سرعة الإخراج	الرموز المولدة في الثانية	> 10 رموز/ثانية
معدل النجاح	نسبة الطلبات الناجحة	> 95%
الوقت الإجمالي	وقت توليد الاستجابة الكامل	يختلف حسب الطول

🤝 المساهمة

نرحب بالمساهمات! إليك كيف يمكنك المساعدة:

إعداد التطوير

1. عمل Fork للمستودع
2. استنساخ الـ fork محلياً
3. إنشاء فرع ميزة

   git checkout -b feature/amazing-feature

4. إجراء تغييراتك
5. اختبار شامل
6. عمل Commit برسائل واضحة

   git commit -m "feat: add amazing feature"

7. دفع إلى الـ fork الخاص بك
8. تقديم طلب سحب

إرشادات المساهمة

• اتبع نمط الكود الموجود
• أضف اختبارات للميزات الجديدة
• حدث الوثائق
• تأكد من التوافق عبر المتصفحات

مجالات المساهمة

• 🌐 ترجمات لغات إضافية
• 🔌 دعم مقدمي واجهة برمجة تطبيقات جدد
• 📊 مقاييس وتصورات محسنة
• 🎨 تحسينات واجهة المستخدم/تجربة المستخدم
• 🐛 إصلاح الأخطاء والتحسينات

❓ الأسئلة الشائعة

كيف أحصل على مفاتيح API؟

• OpenAI: زر platform.openai.com
• Google Gemini: ابدأ في ai.google.dev
• واجهات برمجة التطبيقات المخصصة: راجع وثائق مقدم الخدمة

لماذا تفشل اختباراتي؟

• تحقق من أن مفتاح API صحيح وله رصيد كافٍ
• تأكد من دقة رابط نقطة نهاية API
• تأكد من أن عنوان IP الخاص بك غير محظور من قبل المقدم
• جرب تقليل التزامن أو جولات الاختبار

هل يمكنني اختبار نماذج مخصصة؟

نعم! استخدم خيار البروتوكول "مخصص" وقدم:

• رابط نقطة نهاية API الخاص بك
• طريقة المصادقة
• أسماء النماذج

📄 الرخصة

هذا المشروع مرخص تحت رخصة MIT - راجع ملف LICENSE للتفاصيل.

🙏 الشكر والتقدير

• شكراً لجميع المساهمين الذين يساعدون في تحسين هذه الأداة
• مستوحى من الحاجة لاختبار أداء الذكاء الاصطناعي الشفاف
• مبني بـ ❤️ لمجتمع تطوير الذكاء الاصطناعي

---

⭐ ضع نجمة على هذا المستودع إذا وجدته مفيداً!

صُنع بـ ❤️ بواسطة qjr87