DeepSeek Harness

استخدم هذا الدليل لتشغيل DeepSeek Harness مفتوح المصدر مع نماذج يخدمها منصة Felo API. يعيد المسار الموصى به استخدام محوّل deepseek-official المدمج في الـharness. ويمكنك أيضًا إضافة Felo كمزوّد مخصص منفصل متوافق مع OpenAI في واجهة الويب.

DeepSeek Harness حاليًا إصدار معاينة للمطوّرين وقد يقدم تغييرات تكسر التوافق. راجع ملاحظات الإصدار في مستودعه الأعلى عندما يختلف خيار أو شاشة عن هذا الدليل.

قبل أن تبدأ

تحتاج إلى Node.js ومفتاح واحد من منصة Felo API. أبقِ المفتاح خارج التحكم في المصدر.

export FELO_API_KEY="YOUR_API_KEY"

تستخدم الأمثلة النموذج deepseek-v4-flash. راجع النماذج والتسعير قبل اختيار معرّف نموذج مختلف.

الإعداد الموصى به: محوّل DeepSeek المدمج

يقرأ DeepSeek Harness بيانات اعتماد المحوّل المدمج من DEEPSEEK_API_KEY وendpoint الخاص به من DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

افتح http://127.0.0.1:3080، ثم:

1. أضف مساحة عمل مشروعك أو اخترها.
2. افتح Settings → Models.
3. اختر مزوّد deepseek-official ونموذج deepseek-v4-flash.
4. ابدأ جلسة جديدة وأرسل مهمة صغيرة على المستودع.

لا تُلحق /chat/completions بعنوان URL الأساسي. فالمحوّل المدمج يرسل الطلبات إلى {DEEPSEEK_BASE_URL}/chat/completions بنفسه.

حفظ قيم البيئة

يمكن لـDeepSeek Harness قراءة ملف .env من الدليل الذي تشغّله فيه. أضف القيم التالية إلى ملف .env غير متعقَّب إذا كنت لا تريد تصديرها في كل جلسة:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

لا تُودع هذا الملف. ويمكنك أيضًا استخدام ملفات بيانات الاعتماد والإعدادات الخاصة بالـharness ضمن $DSH_HOME عندما تحتاج إلى إعدادات على مستوى المستخدم.

إعداد بديل: مزوّد مخصص متوافق مع OpenAI

استخدم هذا المسار عندما تريد أن يظهر Felo كمزوّد منفصل بدلًا من تجاوز اتصال DeepSeek المدمج.

1. شغّل واجهة الويب بالأمر npx @deepseek-ai/dsh web.
2. افتح Settings → Models.
3. اختر Add custom provider.
4. أدخل القيم التالية واحفظ المزوّد.

إذا فشل اكتشاف النماذج، فأضف معرّف النموذج يدويًا. يعتمد إجراء Get available models لدى المزوّد على مسار GET /models المتوافق مع OpenAI، وليس مطلوبًا للإعداد اليدوي.

التحقق من الإعداد

ابدأ جلسة جديدة واسأل:

Summarize this repository and identify its main packages.

يكون الإعداد جاهزًا عندما تكتمل الجلسة مع اختيار deepseek-v4-flash دون ظهور خطأ مصادقة أو خطأ نموذج غير معروف.

لاختبار سريع غير تفاعلي بالمحوّل الموصى به، شغّل من مساحة العمل الهدف:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

ملاحظة حول البحث على الويب

يوجّه هذا الإعداد طلبات النماذج عبر Felo. لدى مزوّد web_search المدمج في DeepSeek Harness متطلبات endpoint منفصلة، مع أن متغيّر بيانات الاعتماد الافتراضي له هو أيضًا DEEPSEEK_API_KEY. لا توجّه DEEPSEEK_SEARCH_BASE_URL إلى Felo إلا إذا كنت تستخدم endpoint بحثًا متوافقًا صراحةً. استخدم Chat API من Felo أو Felo Skills الأخرى بشكل منفصل عندما يحتاج سير عملك إلى بحث Felo.

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

الخطوات التالية

• مستودع DeepSeek Harness
• مرجع LLM API
• مرجع Chat API
• Felo Skills لوكلاء الذكاء الاصطناعي