🚀 دمج Cursor مع نماذج CodingPlanX المخصصة

مقدمة: Cursor هو محرر أكواد مدعوم بالذكاء الاصطناعي ومحبوب للغاية من قبل المطورين، ويتميز بقدرات مدمجة قوية للنماذج اللغوية الكبيرة (LLM). ومع ذلك، نظرًا لـ قيود الشبكة، أو التحكم في التكلفة (استخدام واجهات برمجة تطبيقات بروكسي تابعة لجهات خارجية أو نماذج أرخص مثل DeepSeek)، أو احتياجات النشر في الشبكة الداخلية للمؤسسات، نحتاج غالبًا إلى تكوين رابط API مخصص ومفتاح API.

سيرشدك هذا البرنامج التعليمي خطوة بخطوة حول كيفية إكمال هذا التكوين بسهولة.

---

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

قبل البدء، يرجى التأكد من تجهيز المعلومات التالية:

1. تثبيت Cursor: تأكد من تحديث Cursor الخاص بك إلى أحدث إصدار.
2. مفتاح API (API Key): مثال، sk-xxxxxxxxxxxxxxxxxxxxxxxx.
3. الرابط الأساسي (Base URL): عنوان بروكسي API المخصص الخاص بك.
   • ملاحظة: يحتاج عادةً إلى أن ينتهي بـ /v1، على سبيل المثال، https://api.codingplanx.ai/v1.
4. اسم النموذج (Model Name): الاسم القياسي للنموذج الذي تنوي استخدامه (مثل gpt-4o، claude-3-5-sonnet، deepseek-chat، إلخ).

---

⚙️ خطوات التكوين التفصيلية

الخطوة 1: فتح إعدادات Cursor

1. قم بتشغيل محرر Cursor.
2. انقر على أيقونة الترس ⚙️ في الزاوية العلوية اليمنى، أو استخدم الاختصار لفتح الإعدادات:
   • Windows / Linux: Ctrl + ,
   • macOS: Cmd + ,

الخطوة 2: الانتقال إلى صفحة تكوين النماذج

في شريط التنقل الأيسر للوحة الإعدادات، ابحث وانقر على علامة التبويب Models.

الخطوة 3: تكوين مفتاح API

1. قم بالتمرير لأسفل في صفحة النماذج للعثور على قسم OpenAI API Key.
2. الصق مفتاح API المخصص الخاص بك في مربع الإدخال.
3. انقر على زر Verify (تحقق) على اليمين. (إذا فشل التحقق في هذه المرحلة، فلا تقلق، لأننا لم نقم بتكوين الرابط بعد).
4. ⚠️ ملاحظة هامة: يرجى التأكد من أن Cursor Tab الرسمي ومفاتيح الاشتراك المدفوعة الأخرى أعلاه في الحالة المناسبة (إذا كنت تستخدم واجهة برمجة تطبيقات مجانية تابعة لجهة خارجية، يوصى بإيقاف تشغيل مفاتيح النماذج الرسمية).

الخطوة 4: تكوين الرابط الأساسي (تجاوز نقطة النهاية الافتراضية)

هذه هي الخطوة الأكثر أهمية، لأنها تحدد المكان الذي يتم إرسال طلباتك إليه:

1. أسفل مربع إدخال OpenAI API Key، ابحث عن خيار Override OpenAI Base URL.
2. قم بتوسيع هذا الخيار وأدخل عنوان الواجهة المخصصة في المربع.

   💡 تنسيق المثال:

   • CodingplanX AI: https://api.codingplanx.ai/v1

3. بعد ملئه، يجب عليك الضغط على مفتاح Enter لحفظ الإعدادات.

الخطوة 5: إضافة أسماء نماذج مخصصة (اختياري ولكنه موصى به)

إذا كان النموذج الذي تستخدمه غير موجود في قائمة Cursor الافتراضية (مثل deepseek-coder)، فستحتاج إلى إضافته يدويًا:

1. قم بالتمرير إلى أعلى صفحة النماذج وابحث عن قسم Model Names.
2. انقر على + Add Model (إضافة نموذج).
3. اكتب اسم النموذج الخاص بك بدقة (مثل deepseek-chat)، ثم اضغط على Enter للتأكيد.
4. قم بتشغيل المفتاح بجوار النموذج الذي أضفته للتو، ويوصى بإيقاف تشغيل النماذج الأخرى التي لا تستخدمها لمنع تحديد النموذج الخطأ.

---

✅ الاختبار والتحقق

بعد التكوين، نحتاج إلى اختبار ما إذا كان يعمل:

1. عد إلى واجهة تحرير التعليمات البرمجية.
2. اضغط على Ctrl + L (في Windows) أو Cmd + L (في macOS) لإظهار نافذة الدردشة (Chat) على اليمين.
3. في الجزء السفلي من نافذة الدردشة، انقر على اسم النموذج المعروض حاليًا وقم بالتبديل إلى النموذج الذي قمت بتكوينه للتو (مثل gpt-4o أو deepseek-chat).
4. أرسل تحية بسيطة، على سبيل المثال: "من أنت؟ يرجى إخباري بإصدار النموذج الخاص بك."
5. إذا رد الذكاء الاصطناعي بشكل طبيعي وسريع، تهانينا، نجح التكوين! 🎉

---

❓ الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها

---

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