DEV Community

Cover image for ما هو DeepSeek Harness (dsh)؟ المنافس مفتوح المصدر لكود كلود، مشروحًا
Yusuf Khalidd
Yusuf Khalidd

Posted on Originally published at apidog.com

ما هو DeepSeek Harness (dsh)؟ المنافس مفتوح المصدر لكود كلود، مشروحًا

شحنت DeepSeek شيئًا غير عادي في 13 أغسطس 2026: ليس نموذجًا، بل الآلة التي تُشغِّل النموذج. DeepSeek Harness (dsh) هو نظام التحكم الرسمي مفتوح المصدر لعميل البرمجة من الشركة. إنه طبقة البرمجيات التي تحول نموذجًا لغويًا كبيرًا إلى عميل برمجة عامل، مع حلقة جلسة، وتنفيذ للأدوات، وفحوصات للأذونات، وواجهة مستخدم ويب محلية. أُطلق dsh في اليوم نفسه الذي أُطلق فيه DeepSeek V4-Pro عبر واجهة برمجة التطبيقات (API)، ووصفت VentureBeat المنتج بأنه منافس مفتوح المصدر لـ Claude Code.

جرّب Apidog اليوم

استجاب مجتمع المطورين بسرعة. حتى 20 أغسطس، وصل مستودع deepseek-harness إلى ما يقرب من 169,000 نجمة و18,100 شوكة، بعد أسبوع واحد من إصداره. لا تعكس هذه الأرقام الكود وحده، بل توضح رغبة المطورين في امتلاك نظام تحكم يمكنهم فحصه وتعديله وتوجيهه إلى أي نموذج.

ما هو DeepSeek Harness في الواقع؟

نظام التحكم هو كل ما يحيط بالنموذج. يتنبأ النموذج بالرموز (tokens)، بينما يحدد نظام التحكم:

  • ما الذي يراه النموذج.
  • الأدوات التي يمكنه استدعاؤها.
  • كيفية الموافقة على تعديلات الملفات وأوامر shell.
  • طريقة إدارة الجلسات متعددة الخطوات.
  • كيفية تجميع السياق وإعادة استخدامه.

تستخدم أدوات مثل Claude Code وCodex CLI وGemini CLI أنظمة تحكم مدمجة حول نماذج مزوديها. ولمعرفة المزيد عن المقارنة بين Claude Code وCodex CLI، راجع Claude Code vs Codex CLI.

DeepSeek Harness هو دخول DeepSeek إلى هذه الفئة، ويعتمد على ثلاث خصائص أساسية:

  • رسمي: مشروع مباشر من DeepSeek AI، وليس غلافًا مجتمعيًا حول واجهة API الخاصة بها.
  • مفتوح المصدر: مرخص بموجب MIT، مع توثيق تبعيات الطرف الثالث في ملف THIRD_PARTY_NOTICES داخل المستودع.
  • معاينة للمطورين: يحذر ملف README من وجود تغييرات تكسر التوافق. لذلك لا تفترض استقرار واجهات الإضافات أو ملفات الإعدادات بين الإصدارات.

وصل dsh بالتزامن مع DeepSeek V4-Pro عبر API، لذلك أصبح نظام التحكم والنموذج الرئيسي الافتراضي متاحين معًا. إذا كنت تقيّم النموذج أيضًا، فراجع دليل واجهة برمجة تطبيقات DeepSeek V4-Pro لمعرفة نقاط النهاية ومعرفات النماذج وأمثلة الطلبات.

الهندسة المعمارية: كل شيء عبارة عن إضافة (plugin)

تختلف بنية dsh عن معظم عملاء البرمجة السائدين. عادةً تكون أنظمة التحكم أحادية الكتلة (monolithic)، إذ تُشحن حلقة العميل، وعميل النموذج، وتعريفات الأدوات، ومخزن الجلسات كتطبيق واحد. يمكنك تهيئتها وأحيانًا توسيعها، لكن لا يمكنك استبدال الأجزاء الأساسية بسهولة.

يقلب dsh هذا التصميم. يعتمد على مبدأ «كل شيء عبارة عن إضافة»، ويُبنى فوق إطار عمل يسمى Cordis، ويصف تصميمه ورقة بحثية بعنوان «نموذج برمجة للتكوين المكاني الزماني».

عمليًا، الأجزاء التي تكون ملحومة عادةً داخل العميل تصبح وحدات قابلة للاستبدال، ومنها:

  • محول النموذج: طبقة الاتصال بواجهة LLM API. استبدالها يتيح توجيه dsh إلى واجهة خلفية مختلفة.
  • سجل الأدوات: الأدوات التي يستطيع العميل استدعاءها، مثل تعديل الملفات وshell والبحث، تُسجل بواسطة إضافات.
  • سجل الجلسات: طريقة حفظ الجلسات وإعادة تشغيلها قابلة للتوصيل.
  • حلقة العميل: حتى دورة اتخاذ القرار والتنفيذ والملاحظة الأساسية يمكن استبدالها.

تظهر أهمية هذا التصميم عندما تحتاج الفرق إلى تجربة:

  • استراتيجيات مختلفة لإدارة السياق.
  • نماذج أذونات مخصصة.
  • مجموعات أدوات مختلفة لكل مستودع.
  • نماذج مستضافة محليًا أو عبر مزودين مختلفين.

مع عميل أحادي الكتلة، تنتظر دعم هذه السيناريوهات من البائع. أما مع dsh، فتستطيع بناء إضافة.

المقايضة واضحة: كلما زادت قابلية الاستبدال، زادت مساحة التعطل المحتملة. وبما أن المشروع معاينة للمطورين، فقد تؤدي التغييرات التي تكسر التوافق إلى تعطيل الإضافات. الرهان هنا هو المرونة الآن مقابل الاستقرار لاحقًا.

بدء سريع: من الصفر إلى عميل عامل

لتشغيل واجهة الويب المحلية، نفّذ:

npx @deepseek-ai/dsh web
Enter fullscreen mode Exit fullscreen mode

سيشغل الأمر واجهة على:

http://127.0.0.1:3080
Enter fullscreen mode Exit fullscreen mode

وسيفتحها في المتصفح تلقائيًا. لمنع فتح المتصفح، استخدم:

npx @deepseek-ai/dsh web --no-open
Enter fullscreen mode Exit fullscreen mode

لا تحتاج إلى تثبيت عالمي أو إنشاء حساب كبوابة.

البناء من المصدر

إذا أردت البناء من المستودع:

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Enter fullscreen mode Exit fullscreen mode

إعداد الجلسة الأولى

بعد تشغيل dsh، نفّذ الخطوات التالية:

  1. أضف مفتاح DeepSeek API من الإعدادات. تُحفظ المفاتيح في: 
   $DSH_HOME/.credentials.yaml
Enter fullscreen mode Exit fullscreen mode

ويحتوي ملف الإعدادات الرئيسي على إشارات إلى بيانات الاعتماد بدلًا من تخزينها مباشرة.

  1. حدد مساحة العمل. اختر Choose workspace، ثم أضف دليل المشروع الذي تريد أن يعمل عليه dsh. لن يصبح منشئ الجلسة متاحًا قبل تحديد مساحة عمل؛ لأن dsh يحتاج إلى معرفة الملفات التي يُسمح له بقراءتها والتفكير فيها.

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

ملفات التعريف ووضع headless

واجهة الويب ليست نقطة الدخول الوحيدة. يعمل dsh عبر ملفات تعريف (profiles):

dsh web
Enter fullscreen mode Exit fullscreen mode

هو اختصار لـ:

dsh --profile web
Enter fullscreen mode Exit fullscreen mode

وتوجد ملفات التعريف عادةً تحت:

$DSH_HOME/profiles/<name>
Enter fullscreen mode Exit fullscreen mode

لتشغيل جلسة واحدة دون واجهة رسومية، استخدم:

dsh --profile headless "job"
Enter fullscreen mode Exit fullscreen mode

ينفذ هذا الوضع جلسة جديدة، ويطبع النتيجة، ثم يخرج. لذلك يناسب النصوص البرمجية وCI.

لإدارة إضافات ملف تعريف، استخدم:

dsh plugin
Enter fullscreen mode Exit fullscreen mode

أما لفحص الإعدادات المركبة دون تشغيل الجلسة:

dsh --dump-config
dsh --dump-default-config
Enter fullscreen mode Exit fullscreen mode

توجد القائمة الكاملة للأوامر في README الخاص بواجهة CLI.

ما النماذج التي يمكن تشغيلها؟

نماذج DeepSeek هي الافتراضية، ويُعد V4-Pro الشريك الرئيسي عند الإطلاق. وبالنسبة إلى التكلفة، جعلت DeepSeek خصمها في أوقات الذروة دائمًا، ما يؤثر في اقتصاديات تشغيل عميل يستهلك الرموز طوال اليوم. راجع تفاصيل خفض سعر DeepSeek V4-Pro، كما يمكنك الرجوع إلى المرجع الرسمي.

لكن محول النموذج عبارة عن إضافة، لذلك لا يقتصر dsh على DeepSeek. يتوفر مساران رئيسيان:

  • مزودو الكتالوج: تكاملات مدمجة مع Anthropic وOpenAI وBedrock وVertex وAzure، مع معالجة بيانات اعتماد خاصة بكل مزود.
  • مزودون مخصصون: يمكنك تسجيل أي نقطة نهاية متوافقة مع OpenAI داخل: 
  $DSH_HOME/settings.yaml
Enter fullscreen mode Exit fullscreen mode

ويتضمن التعريف عنوان URL الأساسي، ومتغير البيئة الخاص بالمفتاح، وقائمة النماذج. يغطي ذلك البيئات المحلية والبوابات الداخلية، وليس واجهات API السحابية فقط.

يصبح النموذج المحدد افتراضيًا للجلسات الجديدة. كما تسجل كل جلسة النموذج الذي بدأت به، لذلك لا يؤدي تبديل الإعداد الافتراضي إلى تغيير سجل الجلسات السابقة.

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

نظام الإضافات بعد أسبوع واحد

يتم اكتشاف الإضافات عبر موضوع dsh-plugin على GitHub، ويناقشها المجتمع عبر GitHub وDiscord. بعد أسبوع من الإطلاق، ظهرت عدة فئات:

  • أغلفة سطح المكتب: مشاريع مثل deepseek-harness-desktop المبني على Tauri وdsh_desktop لنظام Windows تغلف واجهة الويب كتطبيق أصلي. هذه مشاريع مجتمعية وليست إصدارات رسمية من DeepSeek، لذا راجعها كما تراجع أي غلاف طرف ثالث يتعامل مع مفاتيح API.
  • إضافات القدرات: مستودعات مثل dsh-context وdsh-vision-router توسع ما يمكن للجلسات رؤيته أو كيفية توجيهه. وهي أيضًا مشاريع مجتمعية.
  • دعم MCP: لا يدعم dsh بروتوكول Model Context Protocol (MCP) أصليًا في جوهره حتى وقت كتابة المقال. المتاح هو إضافة مجتمعية باسم dsh-mcp-manager.

تضيف إضافة dsh-mcp-manager صفحة إعداد لـMCP، وتدعم:

  • خوادم HTTP عن بُعد.
  • خوادم stdio محلية.
  • مصادقة OAuth أو الرموز الثابتة.
  • أدوات بأسماء من نمط: 
  mcp__<name>__*
Enter fullscreen mode Exit fullscreen mode
  • إعدادات خادم خاصة بكل مشروع داخل دليل .dsh لمساحة العمل.

لذلك، عندما يقال إن dsh «يدعم MCP»، فالصياغة الأدق هي أن المجتمع أضاف دعم MCP عبر إضافة. قد يدمج المشروع هذا الدعم في الأساس لاحقًا، لكنه لم يفعل ذلك بعد.

أين يتناسب سير عمل API الخاص بك؟

نظام التحكم هو في جوهره آلة لتنفيذ استدعاءات API:

  1. يستدعي واجهة النموذج التي يعمل عليها.
  2. يتعامل مع واجهات API داخل المشروع.
  3. يكتب الكود بناءً على فهمه لنقاط النهاية والعقود المتاحة في المستودع.

إذا لم يتطابق السلوك الفعلي لواجهة API مع مواصفاتها، فسيبني العميل على عقد خاطئ، ولن يظهر الخطأ إلا وقت التشغيل.

الحل العملي هو التحقق من سطح API قبل توجيه العميل إليه. باستخدام Apidog يمكنك:

  • تصميم مواصفات OpenAPI أو استيرادها.
  • اختبار نقاط النهاية الحقيقية مقابل المواصفات.
  • تشغيل خوادم mock باستجابات مستقرة ومتوافقة مع المواصفات.
  • تطوير العميل قبل اكتمال الواجهة الخلفية.

عندما يعمل العميل مقابل mock server تم التحقق منه، تقل احتمالية بناء تكاملات وهمية اعتمادًا على كود قديم أو سلوك غير موثق.

يوفر خادم Apidog MCP مسار تكامل مباشرًا؛ إذ يعرض مواصفات API لأدوات الذكاء الاصطناعي عبر MCP. وفي dsh، يتم ذلك من خلال إضافة dsh-mcp-manager المجتمعية:

  1. ثبّت الإضافة.
  2. سجّل خادم Apidog MCP.
  3. اسمح للجلسات بالاستعلام عن المواصفات الفعلية بدل استنتاجها من الكود.

تشرح طريقة استخدام Apidog CLI في DeepSeek Harness العملية كاملة، بما في ذلك تشغيل اختبارات سطر الأوامر التي يستطيع العميل تشغيلها بنفسه.

وإذا أردت تجهيز جانب API أولًا، نزّل Apidog واستورد مواصفاتك قبل بدء التجربة.

هل يجب أن تجربه الآن أم تنتظر؟

تعتمد الإجابة على طريقة الاستخدام.

جرّبه الآن إذا:

  • تريد فهم كيفية عمل أنظمة التحكم داخليًا. dsh نظام قابل للفحص، وقراءة حلقة عميل حقيقية قد تكون أكثر فائدة من الاكتفاء بالوثائق النظرية.
  • تحتاج إلى تبديل النماذج أو تشغيل نماذج مستضافة ذاتيًا.
  • تبني أدوات أو إضافات؛ فالنظام البيئي ما يزال في بدايته.
  • تستخدم واجهة DeepSeek API وتريد تجربة عميل V4-Pro المباشرة.

انتظر إذا:

  • تحتاج إلى برنامج تشغيل يومي مستقر. تحذير «ستكون هناك تغييرات تكسر التوافق» يعني أن الإعدادات والإضافات قد تتعطل بين الإصدارات.
  • تتطلب مؤسستك أدوات مدققة ومدعومة. الإضافات المجتمعية التي تتعامل مع بيانات الاعتماد لها ملف مخاطر مختلف.
  • تريد تجربة نظام تحكم ناضج. تتمتع أدوات مثل Claude Code بمدة أطول في بيئة العمل، بينما لا تزال معاينة dsh حديثة.

النهج العملي لمعظم المطورين هو استخدام الخيارين معًا:

  1. احتفظ بالعميل الحالي لأعمال الإنتاج.
  2. شغّل dsh في مشروع جانبي.
  3. اختبر الإضافات ومزودي النماذج.
  4. راقب تغييرات التوافق قبل اعتماده على مستودعات حساسة.

وللمقارنة المباشرة، راجع DeepSeek Harness vs Claude Code.

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

هل DeepSeek Harness مجاني؟

نظام التحكم نفسه مجاني ومفتوح المصدر بموجب ترخيص MIT. أما التكلفة فتأتي من النموذج أو مزود API الذي تهيئه. تُحاسبك منصة DeepSeek أو أي مزود آخر على الاستخدام وفق أسعاره.

وبما أن محول النموذج قابل للتوصيل، يمكنك أيضًا توجيه dsh إلى نموذج مستضاف محليًا، وفي هذه الحالة لا تدفع مقابل الرموز لمزود سحابي. راجع تشغيل أي نموذج في DeepSeek Harness لمعرفة الإعداد.

هل يعمل dsh فقط مع نماذج DeepSeek؟

لا. نماذج DeepSeek هي الافتراضية، لكن محول النموذج إضافة قابلة للاستبدال. يدعم dsh مزودي الكتالوج مثل Anthropic وOpenAI وBedrock وVertex وAzure، كما يمكنك إضافة أي نقطة نهاية متوافقة مع OpenAI عبر:

$DSH_HOME/settings.yaml
Enter fullscreen mode Exit fullscreen mode

هل DeepSeek Harness آمن للتشغيل على قاعدة التعليمات البرمجية الخاصة بي؟

تعتمد السلامة على نموذج الأذونات وعلى مراجعتك للإضافات والإعدادات.

تطلب واجهة الويب تحديد مساحة عمل قبل تشغيل أي جلسة، وتطلب الموافقة على العمليات التي تتطلبها سياسة الأذونات النشطة. لكن المشروع ما يزال معاينة للمطورين، والإضافات المجتمعية، بما فيها أغلفة سطح المكتب، قد تتعامل مع مفاتيح API.

قبل استخدامه:

  • راجع الكود الذي تثبته.
  • اختبره خارج المستودعات الحساسة.
  • لا تمنح الإضافات صلاحيات غير ضرورية.
  • راقب أوامر الكتابة وshell التي يطلب العميل تنفيذها.

كيف يختلف نظام التحكم عن النموذج؟

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

  • إدارة الجلسات.
  • استدعاء الأدوات.
  • الوصول إلى الملفات.
  • مطالبات الأذونات.
  • تجميع السياق.
  • تنفيذ الأوامر وإعادة النتائج إلى النموذج.

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

Top comments (0)