كيفية استخدام DeepSeek V4-Pro مع Cursor: دليل إعداد وكيل الاستدلال (2026)

Ashley Innocent

Ashley Innocent

25 مايو 2026

كيفية استخدام DeepSeek V4-Pro مع Cursor: دليل إعداد وكيل الاستدلال (2026)

enterprise.banner.title

enterprise.banner.feature1

enterprise.banner.feature2

enterprise.banner.feature3

enterprise.banner.ctaB

عند توصيل DeepSeek V4-Pro بـ Cursor باستخدام إعداداته الافتراضية المتوافقة مع OpenAI، تُرجع أول استدعاء أداة خطأ 400. السبب صغير ولكنه عنيد: V4-Pro هو نموذج تفكير يُرجع كتلة `reasoning_content`، ويزيل Cursor هذا الحقل من طلباته اللاحقة، وترفض واجهة برمجة تطبيقات DeepSeek رسائل استدعاء الأداة التي تحذف سلسلة التفكير. يقوم وكيل مفتوح المصدر على yxlao/deepseek-cursor-proxy بتخزين محتوى التفكير مؤقتًا وإعادة حقنه في الطلبات الصادرة. بمجرد تشغيل الوكيل، يتصرف V4-Pro مثل أي نموذج آخر في لوحة النماذج المخصصة لـ Cursor، مع عرض رموز التفكير كعلامة Markdown قابلة للطي. فيما يلي الإعداد الكامل، وحساب التكلفة، وقائمة استكشاف الأخطاء وإصلاحها.

الخلاصة

لماذا تحتاج إلى وكيل من الأساس

يعيد V4-Pro أمرين في كل استجابة: حقل `content` عادي وحقل `reasoning_content` الذي يحمل سلسلة التفكير. بالنسبة للمحادثات العادية، يمكنك تجاهل `reasoning_content`. تبدأ المشكلة باستدعاءات الأداة.

يتطلب عقد واجهة برمجة تطبيقات DeepSeek لنماذج التفكير أنه عند متابعة محادثة تحتوي على كتلة `reasoning_content`، يجب أن تتضمن هذه الكتلة في الطلب التالي جنبًا إلى جنب مع نتيجة `tool_calls`. تعتبر سلسلة التفكير جزءًا من حالة المحادثة. لا يعرف Cursor بهذا الشرط. إنه يشحن عميل دردشة على نمط OpenAI، وحقل `reasoning_content` ليس جزءًا من مخطط OpenAI، لذلك يتجاهل هذا الحقل. يعود استدعاء الأداة التالي بخطأ HTTP 400 ورسالة تفيد بوجود `reasoning_content` مفقود.

هذا ليس خطأ في Cursor بالضبط. إنه عدم توافق في العقد بين مزودين يتشاركان معظم واجهة برمجة التطبيقات الخاصة بهما. حتى يضيف Cursor دعمًا من الدرجة الأولى لـ V4-Pro أو يخفف DeepSeek العقد، فإن الحل البديل هو وكيل يتذكر ما نسيه Cursor.

ما يفعله الوكيل، في ثلاثة أسطر

كما أنه يعرض المنفذ المحلي عبر نفق ngrok، لأن إعداد النموذج المخصص في Cursor يتطلب HTTPS ولن يقبل عنوان URL `localhost`.

يوجد التخزين المؤقت في `~/.deepseek-cursor-proxy/reasoning_content.sqlite3`. يعني استخدام مفتاح SHA-256 عدم تضارب محادثتين متوازيتين. يتم تخزين محتوى التفكير تمامًا كما أعاده DeepSeek، لذا لا يزال ذاكرة التخزين المؤقت لـ DeepSeek تستفيد، وهو أمر مهم للتسعير الدائم الجديد.

المتطلبات المسبقة

تحتاج إلى أربعة أمور جاهزة قبل البدء:

إذا لم تقم بتثبيت `uv` من قبل، فراجع وثائق تثبيت uv الرسمية. بالنسبة لـ ngrok، يرشدك دليل البدء السريع لـ ngrok خلال خطوة الرمز المميز للمصادقة.

الخطوة 1: تثبيت الوكيل

أسرع طريقة هي `uv`. من أي دليل:

uv tool install deepseek-cursor-proxy

إذا كنت تفضل pip، فاستنسخ المستودع وقم بتثبيته كحزمة قابلة للتحرير:

git clone https://github.com/yxlao/deepseek-cursor-proxy.git
cd deepseek-cursor-proxy
pip install -e .

يضع أي من المسارين الأمر `deepseek-cursor-proxy` في مسار النظام (PATH) الخاص بك. تحقق من ذلك باستخدام `deepseek-cursor-proxy --help`.

الخطوة 2: تهيئة ngrok

يحتاج الوكيل إلى عنوان URL عام عبر HTTPS لأن حقل النموذج المخصص في Cursor لن يقبل `http://localhost`. يوفر ngrok النفق.

ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN

احصل على رمز المصادقة الخاص بك من لوحة تحكم ngrok بعد التسجيل. تمنحك الطبقة المجانية نطاقًا فرعيًا عشوائيًا عند كل إعادة تشغيل. إذا كانت هذه مشكلة، فاحجز نطاقًا مخصصًا في لوحة التحكم وقم بتمريره إلى الوكيل باستخدام `—ngrok-url https://your-reserved.ngrok-free.app`.

الخطوة 3: تشغيل الوكيل

الإعدادات الافتراضية مناسبة لمعظم التكوينات:

deepseek-cursor-proxy

عند التشغيل الأول، يقوم الوكيل بإنشاء `~/.deepseek-cursor-proxy/config.yaml`، ويفتح نفقًا، ويطبع عنوان URL العام. يبدو الإخراج كالتالي:

Starting deepseek-cursor-proxy
Tunnel: https://random-name.ngrok-free.app
Local:  http://127.0.0.1:9000
Cache:  /Users/you/.deepseek-cursor-proxy/reasoning_content.sqlite3

علامات مفيدة:

اجعل الوكيل يعمل في نافذة طرفية منفصلة، أو ادمجه في مهمة launchctl على نظام macOS. يتحدث Cursor إليه في كل طلب.

الخطوة 4: تهيئة Cursor

افتح إعدادات Cursor، انتقل إلى النماذج (Models)، وأضف نموذجًا مخصصًا. الحقول التي تحتاجها:

يُجري Cursor فحص "التحقق من النموذج" (Verify model). يرسل الفحص إكمال دردشة واحدًا. تشير علامة الصح الخضراء إلى أنك انتهيت. يشير خطأ الاتصال عادةً إلى عنوان URL لـ ngrok: انسخه مرة أخرى من مخرجات الوكيل وتأكد من أنه ينتهي بـ `/v1`.

الخطوة 5: اختر النموذج وجرب استدعاء أداة

افتح منتقي النموذج في لوحة الدردشة واختر نموذجك المخصص الجديد. أول موجه لتجربته هو موجه يجبر على استخدام الأداة، لأن استدعاءات الأدوات هي المكان الذي ظهرت فيه أخطاء 400 الأصلية:

“Open the README in this repo, list every code block, and tell me which ones are missing language hints.”

سيصدر Cursor استدعاء أداة `read_file`. إذا كان الوكيل يقوم بعمله، فستبدو سلسلة الاستجابة كما يلي:

  1. يرسل Cursor رسالة المستخدم إلى الوكيل.
  2. يعيد الوكيل التوجيه إلى DeepSeek بدون `reasoning_content` (إنها الجولة الأولى).
  3. يعيد DeepSeek نصًا بالإضافة إلى كتلة `reasoning_content` بالإضافة إلى طلب `tool_calls` .
  4. يخزن الوكيل `reasoning_content` مؤقتًا باستخدام تجزئة بادئة المحادثة كمفتاح.
  5. يشغل Cursor الأداة، ثم يرسل متابعة بنتيجة الأداة. لا تحتوي المتابعة على `reasoning_content` لأن Cursor أسقطها.
  6. يبحث الوكيل عن `reasoning_content` المخزن مؤقتًا بواسطة تجزئة البادئة ويعيد حقنه قبل إعادة التوجيه.
  7. يقبل DeepSeek الطلب، ويواصل التفكير، ويعيد الإجابة النهائية.

شغل الوكيل باستخدام `--verbose` وسترى عملية الحقن تحدث في السجلات.

كيف تبدو التكلفة على أرض الواقع

يدفع V4-Pro داخل Cursor أسعار DeepSeek القياسية لواجهة برمجة التطبيقات، وليس تسعير رصيد Cursor المجمع. هذه الأسعار دائمة اعتبارًا من مايو 2026:

نوع الرمز السعر لكل مليون رمز
الإدخال (فشل ذاكرة التخزين المؤقت) 0.435 دولار
الإدخال (نجاح ذاكرة التخزين المؤقت) 0.003625 دولار
الإخراج 0.87 دولار

يبدو يوم عمل مكثف لـ Cursor تقريبًا 50 دورة دردشة بالإضافة إلى 20 سلسلة استدعاء أدوات. يبلغ متوسط كل دورة حوالي 8,000 رمز موجه (سياق الملف بالإضافة إلى موجه النظام بالإضافة إلى السجل) و 1,500 رمز إخراج. وهذا يعني:

الإجمالي: حوالي 1 دولار في اليوم المكثف. مقارنة بتشغيل نفس حجم العمل من خلال حصة GPT-5.5 المجمعة في Cursor Pro، فإن هذا أرخص بمقدار كبير قبل تفعيل قيود الحصة. تفاصيل حساب تخفيض السعر الكامل موجودة في خصم سعر DeepSeek V4-Pro الدائم بنسبة 75%.

للاطلاع على سياق بقية تشكيلة DeepSeek، راجع ما هو DeepSeek V4 و كيفية استخدام واجهة برمجة تطبيقات DeepSeek V4.

كيف يبدو V4-Pro داخل Cursor

تظهر ثلاثة اختلافات مقارنة بنموذج Cursor الافتراضي لديك.

توجد إرشادات أخرى لـ DeepSeek مع Cursor لنماذج سابقة. راجع كيفية استخدام DeepSeek R1 محليًا مع Cursor و DeepSeek V3 مع Cursor: خطوة بخطوة للأنماط القديمة. يحل الوكيل في هذا الدليل محل عمليات حقن التفكير اليدوية الموثقة في تلك المنشورات.

اختبار إعداد DeepSeek الخاص بك باستخدام Apidog

يثبت تكامل Cursor المسار من داخل Cursor فقط. إذا كنت تقوم بشحن V4-Pro إلى أسطح أخرى (روبوت CI، وكيل خلفي، مكون إضافي مخصص لبيئة التطوير المتكاملة)، فأنت تريد مجموعة اختبار حتمية ضد نفس نقطة النهاية التي يعيد وكيلك التوجيه إليها.

هنا يكتسب Apidog مكانته. وجه بيئة Apidog إلى `https://api.deepseek.com/v1`، أدخل مفتاح API الخاص بك، واستورد مخطط إكمال الدردشة لـ OpenAI. يمكنك:

قم بتنزيل Apidog، واستورد مواصفات DeepSeek OpenAPI، وسيكون لديك مقعد اختبار V4-Pro جاهز للعمل في خمس دقائق. نفس سير العمل الذي نمر به في كيفية استخدام واجهة برمجة تطبيقات DeepSeek V4.

المزالق الشائعة

بدائل إذا لم يكن الوكيل مناسبًا لك

الوكيل هو المسار الأنظف اليوم، ولكن يوجد بديلان:

تكاملات نماذج Cursor الأخرى المغطاة بالتفصيل: Claude Opus 4.6 مع Cursor، Kimi K2.5 مع Cursor، و Gemini 3.0 Pro مع Cursor.

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

إلى أين يقودك هذا

تقع قدرة V4-Pro على الترميز ضمن بضع نقاط معيارية من GPT-5.5 (مقارنة DataCamp) بسعر إخراج أقل بنحو 34 مرة. العقبة الوحيدة لمستخدمي Cursor كانت عدم توافق عقد واجهة برمجة التطبيقات حول `reasoning_content`. يحل مستودع `deepseek-cursor-proxy` هذه المشكلة في أقل من مائة سطر من التعليمات البرمجية الهادفة وإعداد يستغرق خمس دقائق.

ثلاث خطوات عملية تالية:

تم دفع ضريبة رموز التفكير. ولكن السعر لم يرتفع.

زر

ممارسة تصميم API في Apidog

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