README-AR.md

عميل DeepSeek بلغة PHP

🚀 حزمة PHP مفتوحة المصدر ومدعومة من المجتمع للتكامل مع واجهة DeepSeek API

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

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

• ✨ المميزات
• 📦 التثبيت
• 🚀 البداية السريعة
  • الاستخدام الأساسي
  • التكوين المتقدم
  • تحذير هام عند استخدام وضع JSON
  • الاستخدام مع عميل 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)
    ->setMaxTokens(8192)
    ->setResponseFormat('text')
    ->query('Explain quantum computing in simple terms')
    ->run();

echo 'API Response:'.$response;

⚠️ متطلب وضع JSON في DeepSeek

عند استخدام:

->setResponseFormat('json_object')

يجب أن يحتوي الـ برومبت على كلمة "json" بشكل واضح.

وإلا سيتم رفض الطلب من قبل وترجع رسالة الخطأ التالية:

"Prompt must contain the word 'json' in some form to use 'response_format' of type 'json_object'"

---

🚫 استخدام غير صحيح

->setResponseFormat('json_object')
->query('اشرح الحوسبة الكمومية بطريقة مبسطة')

✅ استخدام صحيح

->setResponseFormat('json_object')
->query('أجب بصيغة JSON صحيحة. اشرح الحوسبة الكمومية بطريقة مبسطة.')

✅ نصيحة: للحصول على أفضل النتائج، قم أيضًا بإعطاء مثال على صيغة JSON في الرسالة.

---

الاستخدام مع عميل 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"}]}

استدعاء الدوال

يتيح استدعاء الدوال للنموذج استدعاء أدوات خارجية لتعزيز قدراته. يمكنك الرجوع إلى الوثائق الخاصة باستدعاء الدوال في الملف: FUNCTION-CALLING.md

---

هل ترغب في أن أضع النسخ الثلاث (الإنجليزية + العربية + الصينية) ضمن ملف Markdown موحد؟

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

حزمة Deepseek لـ Laravel

---

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

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

---

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

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

---

🧪 الاختبارات

./vendor/bin/pest

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

---

🐘✨ مجتمع DeepSeek PHP ✨🐘

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

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

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

---

🔒 الأمان

الإبلاغ عن الثغرات: إلى omaralwi2010@gmail.com

---

🤝 المساهمين

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

Omar AlAlwi 🏆 المُنشئ

Ayman Alhattami ⭐ مساهم

Mohammad Asaad ⭐ مساهم

Opada Alzaiede ⭐ مساهم

Hisham Bin Ateya ⭐ مساهم

Vinchan ⭐ مساهم

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

---

📄 الرخصة

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