TLDR DeepSeek Harness (dsh) هو وقت تشغيل للوكلاء مفتوح المصدر من DeepSeek AI، صدر كمعاينة للمطورين حوالي 13 أغسطس 2026 بموجب رخصة MIT. يتبع مبدأ "Model + Harness = Agent"، حيث يتم تنفيذ كل قدرة (النماذج، الأدوات، الجلسات، الصناديق المعزولة، الحلقات، الواجهة) كملحقات Cordis قابلة للاستبدال.
أسرع طريقة لتشغيله محليًا هي npx @deepseek-ai/dsh web (يتطلب Node.js ^22.19 أو ≥24)، والذي يفتح واجهة ويب على http://127.0.0.1:3080. أنت توفر مفتاح API لـ DeepSeek (أو متوافق مع OpenAI) ومساحة عمل. تتوفر أيضًا بناءات من المصدر، وتطبيقات سطح المكتب، وDocker، وPython SDK، وتكاملات Ollama. للوصول الإنتاجي متعدد النماذج، والموثوقية، والتحكم في التكلفة أثناء استخدام الحاضنة، وجّه الطلبات عبر نقطة النهاية الموحدة المتوافقة مع OpenAI لدى CometAPI.
الخلاصة الأساسية
DeepSeek Harness ليس نموذجًا—إنه بيئة تشغيل محلية/منسّق تُمكّن النماذج من التعامل مع الملفات، والأصداف، والأدوات، والجلسات.
تمت المراجعة للوضوح ودقة المصدر ومصطلحات API الحالية.
الأمر الرسمي المختصر: npx @deepseek-ai/dsh web → يفتح واجهة ويب محلية على المنفذ 3080.
شرط Node.js صارم: ^22.19.0 أو ≥24.x.
يدعم نماذج DeepSeek الرسمية (deepseek-v4-flash, deepseek-v4-pro)، وبوابات مخصصة متوافقة مع OpenAI، ونماذج محلية عبر الملحقات/Ollama.
البنية معتمدة بالكامل على الملحقات (نواة Cordis)؛ الأوضاع تشمل Standard وMinimal وCode وCreator.
تبنٍ سريع: من عشرات الآلاف إلى أكثر من 100 ألف نجمة على GitHub خلال أيام من الإطلاق.
موصى به للمستخدمين المتقدمين: إقرانه مع CometAPI (https://www.cometapi.com/) كمزوّد مخصص للوصول إلى 500+ نموذج، وتوفير 20–40% بالتكلفة، ومفتاح API واحد.
استخدم دائمًا مساحة عمل معزولة؛ يمكن للوكيل تعديل الملفات وتشغيل الأوامر.
حالة المعاينة للمطورين تعني احتمالية تغييرات كاسرة—ثبّت الإصدارات للتجارب القريبة من الإنتاج.
ما هو DeepSeek Harness ولماذا هو مهم في 2026
DeepSeek Harness (dsh) هو وقت تشغيل للوكلاء مفتوح المصدر تطوره DeepSeek AI. أُطلق بموجب رخصة MIT كمعاينة للمطورين ويؤكد على التركيبية: كل قدرة—محوّلات النماذج، الأدوات، المهارات، الجلسات، الصناديق المعزولة، التخزين، حلقات الوكلاء، الجدولة، والواجهة—توجد كملحق Cordis يمكن تركيبه/إزالته/استبداله/إعادة تركيبه عبر الإعدادات. لا توجد نواة ذات امتيازات تتطلب الترقيع فعليًا.
المبادئ التصميمية الأساسية تشمل:
الوكيل = النموذج + الحاضنة.
تدفقات أحداث قابلة للتتبع تدعم الاستئناف، والتفريع، والبحث، وإعادة التشغيل.
أوضاع تشغيل متعددة (الوضع القياسي الكامل الأدوات، وضع الكود/التنسيق، الوضع الأدنى للقياس، أوضاع المُبدع/التجريب).
واجهة ويب محلية أولًا للاستخدام التفاعلي بالإضافة إلى خيارات بدون واجهة وSDK للأتمتة.
صفحات إرشاد التثبيت والمرايا المجتمعية تعزز نفس الأوامر الأساسية.
ملاحظة مصطلحية مهمة: "النشر المحلي" قد يعني شيئين مختلفين. DeepSeek Harness المذكور في هذا الدليل يعمل محليًا على جهازك، لكن مشروع deepseek-harness القياسي يتصل بـDeepSeek V4-Pro أو V4-Flash عبر API. هذا يعني أن الحاضنة، والإعدادات، والجلسات، والتحقق، ومنطق العميل يمكن أن تكون محلية، بينما يجري الاستدلال على النموذج عادةً عبر واجهة DeepSeek البرمجية. إذا كنت تحتاج استدلالًا غير متصل فعليًا مع الأوزان على GPU الخاص بك، فهذا معمار نشر مختلف.
المتطلبات الأساسية ومتطلبات النظام
قبل التثبيت، تحقق مما يلي:
أنظمة التشغيل: Windows 10+، macOS 10.15+، توزيعات Linux الشائعة (x64 أو arm64). لدى Python SDK قيود إضافية (Linux x64/arm64 أو macOS 14+ arm64).
Node.js: مطلوب لمسار واجهة الويب الرئيسي. النطاق المستهدف هو ^22.19.0 || ≥24.0.0. تحقق بأمر node --version. الإصدارات الفردية الوسيطة خارج هذا النطاق غير مدعومة.
مدراء الحزم: npm/npx (يأتي مع Node). بناءات المصدر تحتاج pnpm (ثبّت عبر npm install -g pnpm).
Git: مطلوب لاستنساخ المصدر.
Python (اختياري): 3.10+ لـ Python SDK الرسمي.
مفتاح API/نقطة النهاية: مفتاح DeepSeek من platform.deepseek.com، أو أي نقطة نهاية متوافقة مع OpenAI + مفتاح + اسم نموذج.
العتاد: لا حاجة لـ GPU للحاضنة نفسها—الاستدلال يتم عن بُعد (أو عبر مزوّد محلي تقوم بإعداده). موارد لابتوب عادية تكفي لواجهة الويب والتنظيم.
الشبكة: مطلوبة في التشغيل الأول لجلب الحزم؛ بعدها يمكن للواجهة العمل مع مكالمات API للنموذج فقط.
مساحة العمل: جهّز مجلدًا معزولًا. يمكن للوكيل قراءة وكتابة وتنفيذ الأوامر داخل مساحة العمل المُعدّة—لا توجهه أبدًا إلى بيانات إنتاجية أو شخصية دون ضوابط.
مصادر المتطلبات: README الرسمي وعدة أدلة تثبيت مستقلة نُشرت بعد الإطلاق مباشرة.
الطريقة 1: الأمر الرسمي المختصر عبر npx (موصى به لمعظم المستخدمين)
هذا هو المسار الأسرع والمروج له رسميًا.
تأكد من أن Node.js يستوفي متطلبات الإصدار.
افتح الطرفية ونفّذ:
Bash
npx @deepseek-ai/dsh web
سيقوم الحزم بالتنزيل (أو استخدام ذاكرة التخزين)، ويبدأ ملف تعريف واجهة الويب، ويعرض عنوان الاستماع—افتراضيًا http://127.0.0.1:3080.
افتح ذلك العنوان في المتصفح. اقبل إشعار المعاينة للمطورين إن ظهر.
عند الاستخدام الأول، قم بإعداد مزوّد نموذج (Settings → Models) بلصق مفتاح API واختيار نموذج مثل deepseek-v4-flash أو deepseek-v4-pro.
اختر أو أنشئ دليل مساحة عمل.
ابدأ بتنفيذ المهام.
لاستخدام منفذ مختلف:
Bash
npx @deepseek-ai/dsh web --port 8080
أوامر مختصرة خاصة بالمنصات التي تضمن أيضًا وجود Node متاحة من مواقع المجتمع (PowerShell على Windows مع winget، وHomebrew على macOS، وNodeSource على Debian/Ubuntu، إلخ).
الإيجابيات: لا يوجد أثر تثبيت دائم بخلاف ذاكرة npm؛ يسحب دائمًا إصدارًا حديثًا منشورًا؛ أبسط إدخال. السلبيات: يعتمد على الشبكة للباقة الأولية؛ أقل ملاءمة لفحص المصدر بعمق أو بناءات مخصصة.
الطريقة 2: التثبيت والتشغيل من المصدر
استخدم هذا إن أردت قراءة ملحقات Cordis، تثبيت التزام محدد، تطوير إعدادات مخصصة، أو المساهمة.
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
ستظهر نفس واجهة الويب على المنفذ الافتراضي. بناءات معاينة المطور قد تنكسر بين الالتزامات، لذا تعامل معها كمسار تجريبي.
الطريقة 3: تطبيقات سطح المكتب (بدون إعداد Node)
أغلفة سطح مكتب من المجتمع وأطراف ثالثة تُغلّف وقت التشغيل لكي لا يضطر المستخدمون لتثبيت Node/pnpm بأنفسهم:
عملاء خفاف مبنيون على Tauri يقلعون وقت تشغيل Node المرفق ويزامنون الحاضنة الأحدث upstream عند الإطلاق. يعملون على 127.0.0.1:3080، ويحفظون البيانات محليًا، ويسجّلون أوامر dsh.
حزم مبنية على Electron تتضمن تبعيات مثبتة.
حمّل المُثبِّتين من صفحات إصدارات GitHub الخاصة بها (ابحث عن “deepseek-harness-desktop”). التنزيل الأول يجلب المكونات الأساسية (بضع مئات من الميغابايت). هذه مناسبة لغير التقنيين لكنها ليست منتجات رسمية من DeepSeek—راجِع المستودع وتحقق من قيم SHA.
الطريقة 4: نشر Docker/الحاويات
توجد صور Docker وملفات compose مجتمعية لتشغيل واجهة الويب داخل حاوية، غالبًا مع إنهاء HTTPS عبر nginx ودعم بوابات متوافقة مع OpenAI. التدفق النموذجي:
Bash
git clone <docker-repo>
cd <docker-repo>
cp .env.example .env # set API key / public host
docker compose up -d --build
مفيد للوصول عبر الشبكة المحلية، والخوادم، أو البيئات التي لا يُرغب فيها بـ Node على المضيف. بعض الإعدادات تدعم settings.yaml مخصصًا لمزوّدين غير DeepSeek.
الطريقة 5: Python SDK للاستخدام البرمجي/بدون واجهة
للوكلاء غير التفاعليين أو الدمج ضمن خطوط أنابيب Python:
ثم شغّل الأمثلة المتضمنة أو استخدم الفئة DeepSeekHarness في كودك الخاص مقابل مساحة عمل معزولة ودليل جلسات. SDK يحزم وقت التشغيل الخاص به ولا يحتاج Node.js على النظام.
الطريقة 6: تكامل Ollama
يوفر Ollama مُطلقًا مريحًا:
Bash
ollama launch dsh
# or with a specific model
ollama launch dsh --model deepseek-v4-flash:cloud
يمكن لـ Ollama تثبيت الحزمة عند الحاجة ويخزن إعدادات الإطلاق بشكل منفصل. يعتمد دعم البحث على الويب والأدوات على النموذج المختار وإتاحة سحابة Ollama.
إعداد النماذج والمزوّدين (بما في ذلك CometAPI)
داخل واجهة الويب، انتقل إلى Settings → Models.
لـ DeepSeek الرسمي: الصق المفتاح من platform.deepseek.com. النماذج الشائعة هي deepseek-v4-flash وdeepseek-v4-pro.
لمزودي الكتالوج (Anthropic, OpenAI, إلخ): استخدم تدفق “Add provider”.
لنقاط النهاية المخصصة/المستضافة ذاتيًا/المجمّعة: اختر “Add a custom provider.” قدّم معرف مزوّد دائمًا، عنوان base URL، البروتوكول (عادة openai-completions)، مرجع أو قيمة مفتاح API، وعلى الأقل معرّف نموذج واحد.
توصية CometAPI (موصى بها بقوة للعديد من الأعباء الشبيهة بالإنتاج): CometAPI منصة بنية تحتية موحدة للذكاء الاصطناعي تعرض 500+ نموذج (بما في ذلك نسخ DeepSeek، وGPT، وClaude، وGemini، وGrok، وغيرها) عبر نقطة نهاية واحدة متوافقة مع OpenAI: https://api.cometapi.com/v1.
الفوائد عند استخدامها مع DeepSeek Harness:
مفتاح API واحد بدل إدارة بيانات اعتماد متعددة للمزوّدين.
تسعير تنافسي (يُذكر توفير 20–40% مقارنة بأسعار البائع المباشرة للعديد من النماذج).
إتاحة عالية (هدف SLA 99.9%)، كمون وسطي منخفض، وفوترة حسب الاستخدام.
تبديل سهل للنماذج لاختبار A/B أو تحسين التكلفة دون تغيير إعدادات الحاضنة سوى معرّف النموذج.
توافق إسقاط مباشر: أنماط OpenAI SDK القائمة تعمل بعد تغيير base_url والمفتاح فقط.
في نموذج المزود المخصص داخل الحاضنة:
Base URL: https://api.cometapi.com/v1
Protocol: openai-completions (أو الخيار المعادل المدعوم)
API key: مفتاح CometAPI الخاص بك
Model ID: أي سلسلة نموذج مدعومة من كتالوج نماذج CometAPI
يجمع هذا بين وقت تشغيل الوكيل المحلي القوي وإمكانية الوصول المرنة والمتكلفة إلى نماذج متعددة من مزودين مختلفين. عادةً ما يتلقى المستخدمون الجدد أرصدة اختبار مجانية. التوثيق: https://apidoc.cometapi.com/.
تُحفظ المفاتيح بطريقة كتابة فقط (مثلًا تحت $DSH_HOME/.credentials.yaml)؛ تعرض الواجهة أوصافًا محجوبة فقط.
استكشاف أخطاء DeepSeek Harness وإصلاحها
DEEPSEEK_API_KEY غير موجود
تحقق:
echo $DEEPSEEK_API_KEY
على Windows:
echo $env:DEEPSEEK_API_KEY
إذا كان فارغًا، أعد الإعداد.
خطأ 400 reasoning_content
يشير هذا عادةً إلى معالجة غير صحيحة لدورة حياة التفكير.
تحقق أن تطبيقك يحافظ على معلومات تفكير المساعد ذات الصلة عبر طلبات التفكير/استدعاء الأدوات متعددة الأدوار.
هذا أحد المحاور الأساسية التي صُممت الحاضنة لمعالجتها.
خطأ طول السياق
تحقق:
input tokens + max_tokens
الحد الأقصى الموثق هو:
1,048,576 tokens
قلل إما سياق الإدخال أو حجم الإكمال المطلوب.
تصبح استدعاءات الأدوات مشوهة أثناء البث
لا تفترض أن قطع البث تصل بترتيب الأدوات.
قم بتجميع فروق استدعاءات الأدوات بواسطة tool_call.index، كما توصي به عقد الحاضنة.
الطلبات مكلفة بشكل غير متوقع
تحقق من:
وضع التفكير
طول الإخراج
معدل إصابة الذاكرة المؤقتة
استقرار بادئة الموجه
اختيار النموذج
أسعار API الحالية
تحسين بسيط غالبًا هو نقل المهام الروتينية من Pro إلى Flash.
مقارنة طرق التثبيت والنشر
Method
Ease of Use
Node Required
Best For
Persistence / Control
Typical Port / Access
Notes
npx one-liner
أعلى
نعم
تجارب سريعة، معظم المستخدمين
مؤقت (ذاكرة التخزين فقط)
3080 (قابل للضبط)
موصى به رسميًا
Source (pnpm)
متوسط
نعم
التطوير، الملحقات، التثبيت
تحكم كامل بالمصدر
3080
يحتاج pnpm + build
Desktop (Tauri/Electron)
عالٍ
لا (مضمّن)
المستخدمون غير التقنيين
ملفات تعريف محلية وتحديث تلقائي
3080 (داخلي)
حِزم مجتمعية
Docker
متوسط
لا (حاوية)
الخوادم، الشبكة المحلية، HTTPS
مجلدات الحاوية
مخصص / 443
صور مجتمعية
Python SDK
متوسط
لا (مضمّن)
بدون واجهة، الأتمتة، خطوط الأنابيب
جلسات برمجية
غير متاح (بدون واجهة افتراضيًا)
SDK رسمي
Ollama launch
عالٍ
اختياري
تجارب النماذج المحلية
إعدادات Ollama
3080
يتكامل مع Ollama
بيانات مُركّبة من الوثائق الرسمية وأدلة ما بعد الإطلاق (أغسطس 2026).
الخلاصة والخطوات التالية
يقدم DeepSeek Harness بيئة وكلاء نظيفة التصميم، مبنية بالكامل على الملحقات، إلى الأجهزة المحلية مع احتكاك شبه معدوم عبر الأمر المختصر npx. مع توجيه مرن للنماذج—خصوصًا عبر منصة موحدة مثل CometAPI—تحصل على قوة سير عمل الترميز القائم على الوكلاء الحديثة مع تحكم عملي في التكلفة، واختيار النماذج، ومحلية البيانات.
ابدأ اليوم بـ:
npx @deepseek-ai/dsh web
اضبط مفتاح DeepSeek أو CometAPI، أشر إلى مساحة عمل آمنة، واستكشف الوضع Standard. ثم جرّب الوضع Minimal للقياسات، والمزودين المخصصين لتحسين التكلفة، أو Python SDK للأتمتة.
لأحدث التعليمات الرسمية فضّل دائمًا مستودع GitHub وdoc. للموثوقية متعددة النماذج ومزايا التسعير أثناء تشغيل الحاضنة، استكشف CometAPI وتوثيقها على https://apidoc.cometapi.com/.