6 طرق لنشر DeepSeek Harness محليًا

الخلاصة DeepSeek Harness (dsh) هو بيئة تشغيل للوكلاء مفتوحة المصدر من DeepSeek AI، أُتيحت بنسخة معاينة للمطورين حوالي 13 أغسطس 2026 تحت ترخيص MIT. يتبع مبدأ “النموذج + الحاضنة = الوكيل”، حيث تُنفَّذ كل القدرات (النماذج، الأدوات، الجلسات، البيئات المعزولة، الحلقات، واجهة المستخدم) كملحقات Cordis قابلة للاستبدال.

أسرع طريقة لتشغيله محليًا هي npx @deepseek-ai/dsh web (يتطلب Node.js ^22.19 أو ≥24)، والذي يُطلق واجهة ويب على http://127.0.0.1:3080. ستزوّد مفتاح API من DeepSeek (أو متوافق مع OpenAI) ومساحة عمل. تتوفر أيضًا بناءات من المصدر، تطبيقات سطح المكتب، Docker، حزمة Python SDK، وتكاملات Ollama. للوصول الإنتاجي إلى عدة نماذج مع تحسين الاعتمادية والتحكم في التكلفة أثناء استخدام الحاضنة، وجّه الطلبات عبر نقطة CometAPI الموحدة والمتوافقة مع OpenAI.

أهم النقاط الرئيسية

• DeepSeek Harness ليس نموذجًا—بل هو مشغّل/منسّق محلي يمكّن النماذج من التعامل مع الملفات والأصداف والأدوات والجلسات.
• الأمر الرسمي المختصر: 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 للأتمتة.

المصادر الرسمية:

• GitHub: https://github.com/deepseek-ai/deepseek-harness
• صفحة المنتج/الهبوط: https://www.deepseek.com/harness/en/ (ونظيرتها الصينية)
• صفحات إرشادات التثبيت ومرايا المجتمع تعزز نفس الأوامر الأساسية.

ملاحظة مصطلحية مهمة: يمكن أن تعني “النشر المحلي” أمرين مختلفين. الحاضنة DeepSeek Harness المذكورة هنا تعمل محليًا على حاسوبك، لكن مشروع deepseek-harness القياسي يتصل بـDeepSeek V4-Pro أو V4-Flash عبر API. هذا يعني أن الحاضنة والإعدادات والجلسات والتحقق المنطقي ومنطق العميل يمكن أن تكون محلية، بينما يُجرى الاستدلال على النموذج عادةً عبر واجهة DeepSeek. إذا كنت تحتاج استدلالًا دون اتصال مع أوزان النموذج على وحدة معالجة الرسومات لديك، فهذه بنية نشر مختلفة.

المتطلبات الأساسية ومواصفات النظام

قبل التثبيت، تحقق مما يلي:

• أنظمة التشغيل: 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 + مفتاح + اسم نموذج.
• العتاد: لا تُطلب وحدة معالجة رسوميات للحاضنة نفسها—يتم تنفيذ الاستدلال على النموذج عن بُعد (أو عبر مزوّد محلي تُعدّه). موارد حاسوب محمول عادية تكفي لواجهة الويب والأوركسترا.
• الشبكة: مطلوبة في التشغيل الأول لجلب الحِزم؛ بعد ذلك يمكن للواجهة العمل مع اتصالات واجهة برمجة نموذج فقط.
• مساحة العمل: حضّر دليلًا معزولًا. يمكن للوكيل القراءة والكتابة وتنفيذ الأوامر داخل مساحة العمل المكوّنة—لا توجهه أبدًا إلى بيانات إنتاجية أو شخصية دون ضوابط.

مصادر المتطلبات: README الرسمي وعدة أدلة تثبيت مستقلة نُشرت بعد الإطلاق.

الطريقة 1: الأمر الرسمي المختصر عبر npx (موصى به لمعظم المستخدمين)

هذا هو المسار الأسرع والمروج له رسميًا.

1. تأكد من أن Node.js يفي بمتطلبات الإصدار.
2. افتح الطرفية وشغّل:

Bash

npx @deepseek-ai/dsh web

1. يقوم الحِزم بالتنزيل (أو يستخدم الكاش)، ويبدأ وضع واجهة الويب، ويطبع عنوان الاستماع—افتراضيًا http://127.0.0.1:3080.
2. افتح ذلك العنوان في متصفح. اقبل إشعار معاينة المطور إن ظهر.
3. عند أول استخدام، اضبط مزوّد النموذج (Settings → Models) عبر لصق مفتاح API واختيار نموذج مثل deepseek-v4-flash أو deepseek-v4-pro.
4. اختر أو أنشئ دليل مساحة عمل.
5. ابدأ تنفيذ المهام.

لاستخدام منفذ مختلف:

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 ويزامنون أحدث إصدار من الحاضنة عند الإطلاق. تعمل على 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:

Bash

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
python -m pip install deepseek-harness-sdk

اضبط متغيرات البيئة:

Bash

export DEEPSEEK_API_KEY=sk-your-key-here
# optional: export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# optional: export DSH_MODEL=deepseek-v4-flash

ثم شغّل الأمثلة الموجودة أو استخدم الصنف DeepSeekHarness في كودك الخاص مقابل مساحة عمل ودليل جلسات معزولين. الحزمة تتضمن بيئتها ولا تتطلب 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.” زوِّد معرف مزوّد دائمًا، وعنوان الأساس، والبروتوكول (عادة 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 أو تحسين التكلفة دون تغيير إعدادات الحاضنة باستثناء معرف النموذج.
• توافق مباشر: أنماط SDK الخاصة بـ OpenAI تعمل بعد تغيير 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.

مقارنة طرق التثبيت والنشر

بيانات مُستخلصة من الوثائق الرسمية وأدلة ما بعد الإطلاق (أغسطس 2026).

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

يجلب DeepSeek Harness بيئة تشغيل للوكلاء بتصميم نظيف وقابلة للتركيب بالكامل إلى الأجهزة المحلية مع شبه انعدام احتكاك عبر الأمر المختصر npx. مقترنًا بتوجيه مرن للنماذج—خصوصًا عبر منصة موحّدة مثل CometAPI—تحصل على قوة سير عمل الترميز الوكيلي الحديثة مع تحكم عملي في التكلفة واختيار النموذج وموضع البيانات.

ابدأ اليوم بـ:

npx @deepseek-ai/dsh web

اضبط مفتاح DeepSeek أو CometAPI، وجّه إلى مساحة عمل آمنة، واستكشف وضع Standard. ثم جرّب وضع Minimal للمقارنات، ومزوّدين مخصصين لتحسين التكلفة، أو حزمة Python SDK للأتمتة.

للحصول على أحدث التعليمات الرسمية فضّل دائمًا مستودع GitHub والوثائق. ولأجل الاعتمادية متعددة النماذج ومزايا التسعير أثناء تشغيل الحاضنة، استكشف CometAPI وتوثيقها على https://apidoc.cometapi.com/.