README-AR.md

عميل DeepSeek PHP

🚀 حزمة SDK لـ PHP مدعومة من المجتمع لتكامل واجهة برمجة التطبيقات الذكية DeepSeek

الإنجليزية | الصينية

فهرس المحتويات

• ✨ المميزات
• 📦 التثبيت
• 🚀 البداية السريعة
  • الاستخدام الأساسي
  • التكوين المتقدم
  • الاستخدام مع عميل HTTP من Symfony
  • الحصول على قائمة النماذج
  • تكامل مع الأطر
• 🆕 دليل الترحيل
• 📝 سجل التغييرات
• 🧪 الاختبارات
• 🔒 الأمان
• 🤝 المساهمين
• 📄 الرخصة

---

✨ المميزات

• تكامل API سلس: واجهة تعتمد على PHP لميزات الذكاء الاصطناعي في DeepSeek.
• نمط الباني السلس: أساليب قابلة للسلسلة لبناء الطلبات بطريقة بديهية.
• جاهز للمؤسسات: تكامل مع عميل HTTP متوافق مع PSR-18.
• مرونة النماذج: دعم لعدة نماذج من DeepSeek (Coder, Chat, وغيرها).
• جاهز للبث: دعم مدمج للتعامل مع الردود في الوقت الفعلي.
• العديد من عملاء HTTP: يمكنك استخدام عميل Guzzle http client (افتراضي) أو symfony http client بسهولة.
• متوافق مع الأطر: حزم Laravel و Symfony متاحة.

---

📦 التثبيت

قم بتثبيت الحزمة عبر Composer:

composer require deepseek-php/deepseek-php-client

المتطلبات:

• PHP 8.1+

---

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

الاستخدام الأساسي

ابدأ مع سطرين من الكود فقط:

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->query('Explain quantum computing in simple terms')
    ->run();

echo $response;

📌 الإعدادات الافتراضية المستخدمة:

• النموذج: deepseek-chat
• الحرارة: 0.8

التكوين المتقدم

use DeepSeek\DeepSeekClient;
use DeepSeek\Enums\Models;

$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'guzzle');

$response = $client
    ->withModel(Models::CODER->value)
    ->withStream()
    ->withTemperature(1.2)
    ->run();

echo 'API Response:'.$response;

الاستخدام مع عميل HTTP من Symfony

الحزمة مبنية مسبقاً مع symfony Http client، فإذا كنت بحاجة إلى استخدامها مع عميل HTTP الخاص بـ Symfony، فيمكن تحقيق ذلك بسهولة عن طريق تمرير clientType:'symfony' إلى دالة build.

مثال باستخدام Symfony:

//  مع القيم الافتراضية للـ baseUrl و timeout
$client = DeepSeekClient::build('your-api-key', clientType:'symfony')
// مع التخصيص
$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'symfony');

$client->query('Explain quantum computing in simple terms')
       ->run();

الحصول على قائمة النماذج

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->getModelsList()
    ->run();

echo $response; // {"object":"list","data":[{"id":"deepseek-chat","object":"model","owned_by":"deepseek"},{"id":"deepseek-reasoner","object":"model","owned_by":"deepseek"}]}

🛠 تكامل مع الأطر

حزمة Deepseek لـ Laravel

---

🚧 دليل الترحيل

هل تقوم بالترقية من الإصدار v1.x؟ اطلع على دليل الترحيل الشامل الخاص بنا للتغييرات الجذرية وتعليمات الترقية.

---

📝 سجل التغييرات

ملاحظات الإصدار التفصيلية متوفرة في CHANGELOG.md

---

🧪 الاختبارات

./vendor/bin/pest

تغطية الاختبارات ستتوفر في الإصدار v2.1.

---

🐘✨ مجتمع DeepSeek PHP ✨🐘

انقر على الزر أدناه أو انضم هنا لتكون جزءًا من مجتمعنا المتنامي!

هيكل القناة 🏗️

• 🗨️ عام - دردشة يومية
• 💡 الأفكار والاقتراحات - تشكيل مستقبل المجتمع
• 📢 الإعلانات والأخبار - التحديثات والأخبار الرسمية
• 🚀 الإصدارات والتحديثات - تتبع الإصدارات ودعم الترحيل
• 🐞 المشاكل وتقارير الأخطاء - حل مشكلات جماعي
• 🤝 طلبات السحب - التعاون والمراجعة البرمجية

---

🔒 الأمان

الإبلاغ عن الثغرات: إلى [email protected]

---

🤝 المساهمين

شكراً جزيلاً لهؤلاء الأشخاص المذهلين الذين ساهموا في هذا المشروع! 🎉💖

Omar AlAlwi 🏆 المُنشئ

Ayman Alhattami ⭐ مساهم

Mohammad Asaad ⭐ مساهم

Opada Alzaiede ⭐ مساهم

Hisham Bin Ateya ⭐ مساهم

Vinchan ⭐ مساهم

هل ترغب في المساهمة؟ اطلع على إرشادات المساهمة وقدم طلب سحب! 🚀

---

📄 الرخصة

هذه الحزمة هي برنامج مفتوح المصدر مرخص بموجب رخصة MIT.