DeepSeek Harness (dsh): ما هو وكيف تشغّله
DeepSeek Harness طبقة وكيل مفتوحة المصدر طوّرتها DeepSeek AI، صدرت في 13 أغسطس 2026 بموجب رخصة MIT. إنها ليست نموذجاً لغوياً ولا مجرد وكيل برمجي آخر — بل هي البنية التحتية التي تحوّل أي نموذج إلى وكيل فعّال، وهو ما تعبّر عنه صفحة المنتج الرسمية مباشرةً بالمعادلة البسيطة: الوكيل = النموذج + Harness.
DSH Field Guide مورد مجتمعي مستقل أُنشئ لتوثيق DeepSeek Harness لمن يضبطونه ويستخدمونه يومياً. وهو غير تابع لـ DeepSeek ولا معتمد منها ولا تديره، وتظل DeepSeek وDeepSeek Harness علامتين تجاريتين لمالكهما المعني.
ما الذي يمثّله DeepSeek Harness فعلاً
DeepSeek Harness — اسمه في سطر الأوامر dsh — طوّرته DeepSeek AI وكُتب بـ TypeScript بموجب رخصة MIT، وشعاره “كل شيء إضافة (Plugin)”. جمع مستودع GitHub deepseek-ai/deepseek-harness حتى 3 سبتمبر 2026 ما يزيد على 210,610 نجمة و24,639 تشعباً (fork)، في نمو يُصنَّف بين أسرع الإطلاقات مفتوحة المصدر في التاريخ.
النموذج روح الوكيل. والـ harness يتيح للوكيل فهم بيئته واستخدام الأدوات والعمل في ظروف حقيقية.— DeepSeek، صفحة منتج DeepSeek Harness الرسمية
يختصر هذا الاقتباس القصد التصميمي بأكمله. DeepSeek Harness ليس نموذجاً لغوياً — إذ يُربط النموذج من الخارج، بما في ذلك طرف ثالث أو نموذج محلي. وليس مجرد وكيل برمجة: فـ Claude Code وCodex يمكن تركيبهما بداخله كوكلاء فرعيين بدلاً من منافسته. وليس إطار عمل لقياس الأداء — فـ lm-evaluation-harness الخاص بـ EleutherAI مشروع Python مستقل يُستخدم لتقييم النماذج، ولا يوجد مستودع باسم deepseek-ai/DeepSeek-Harness بإعداد pip install -r requirements.txt. الـ dsh الحقيقي يعمل على Node.js ويُثبَّت عبر npx.
معادلة الوكيل = النموذج + Harness
كل شيء ما عدا تدريب النموذج نفسه يقع داخل DeepSeek Harness: تخطيط المهام، واستدعاء الأدوات، وتنفيذ الأكواد، وإدارة السياق، والجلسات، والصلاحيات، والواجهة. تصف مواد توظيف DeepSeek هذه الطبقة صراحةً بأنها طبقة التحكم في النموذج — الجزء الذي يدير السياق، ويستدعي الأدوات، ويقرأ الملفات ويكتبها، ويشغّل الطرفية، ويصحّح النتيجة ذاتياً.
ما الذي dsh ليس عليه
ثلاثة فروق تظهر دائماً أمام كل من يبدأ مع المشروع:
- ليس نموذجاً لغوياً. يتصل DeepSeek Harness بالنموذج عبر محوّل (adapter)؛ والنموذج قد يكون من DeepSeek نفسها أو من مزوّد مختلف كلياً.
- ليس مجرد وكيل برمجة. يمكن لـ Claude Code وCodex CLI الفعليَّين أن يعملا كوكلاء فرعيين تحته.
- ليس إطار قياس أداء.
lm-evaluation-harness (EleutherAI) مشروع Python يُستخدم لتقدير أداء نماذج DeepSeek، وليس منتجاً من DeepSeek — قاعدتا الكود غير مرتبطتين وتشتركان في كلمة واحدة فقط من الاسم.
كل شيء إضافة (Plugin)
يُبنى DeepSeek Harness على Cordis، وهو بيئة تشغيل الإضافات، وشعار “كل شيء إضافة” ليس مجرد تسويق — فالنماذج والأدوات والمهارات والجلسات وصناديق الرمل وأنظمة الملفات والحلقة الرئيسية والتنسيق والواجهة كلها مُنفَّذة كإضافات. يضم دليل packages/ أكثر من 200 حزمة عمل، ويمكن إلغاء تحميل أي إضافة في أثناء التشغيل دون إعادة تشغيل العملية.
لماذا يختلف هذا عن إطار وكيل اعتيادي
يتألف إطار الوكيل الاعتيادي من حلقة رئيسية وحزمة من القدرات تُوصَّل يدوياً؛ وإضافة قدرة جديدة تعني تعديل الحلقة وإعادة بناء تجميع التعليمات وإعادة تسجيل الأدوات. حوّل DeepSeek Harness الحلقة الرئيسية ذاتها إلى إضافة، فامتداده لا يحتاج سوى تعليق إضافة جديدة بجانب الموجودة بدلاً من تغيير النواة.
نقاط الفصل بين القدرات
كل قدرة قابلة للاستبدال مُقسَّمة إلى ثلاثة أدوار: التعريف والتنفيذ والمستهلك. استبدال تنفيذ واحد يغيّر سلوك المنتج في كل مكان تُستخدم فيه تلك القدرة، دون الحاجة إلى تفرّع (fork).
Cordis: النواة في وقت التشغيل
Cordis هو بيئة تشغيل الإضافات التي يقوم عليها DeepSeek Harness، ويصف نفسه بأنه إطار عمل لـ “التركيب الزمكاني” (spatiotemporal composability). توثّق تصميمه الورقة البحثية arXiv 2608.25512، “A Programming Paradigm for Spatiotemporal Composability”، وهي ورقة من 88 صفحة نُشرت في 13 أغسطس 2026 بقلم Yifan Shi وWei Zhang وTianyi Cui.
تحدّد النموذجَ خاصيتان: التركيب الزمني يعني أن تفريغ مكوّن ما يُلغي تاماً كل تأثير أحدثه. والتركيب المكاني يعني أن المكوّنات تُعلن عن تبعياتها وتُوصَّل ببعضها بصورة تفاعلية. تُدمج DeepSeek مكتبة Cordis مباشرةً في DeepSeek Harness عوضاً عن الاعتماد عليها كحزمة خارجية.
يسبق Cordis نفسه DeepSeek Harness زمنياً — إذ هو مشروع مستقل مفتوح المصدر للمطوّر Yifan Shi (المعروف بـ Shigma)، وقد عمل نواةً للإضافات في إطار شات بوت Koishi منذ 2019. وقاعدة “يجب أن يتراجع تفريغ الإضافة عن كل ما فعلته” جاءت من ذلك المشروع الأقدم.
سجل الجلسة للإلحاق فقط
يكتب كل تشغيل في سجل يقبل الإلحاق فقط (append-only): تعليمات النظام، ومسارات التفكير، واستدعاءات الأدوات ونتائجها، وتخطيط الوكيل الفرعي، وكل حقن للسياق. تعتمد ميزات الاستئناف والتفرّع والبحث وإعادة التشغيل على القراءة من هذا السجل بدلاً من مخزن حالة منفصل.
تعرض واجهة الويب إحصائيات تخفيها معظم بيئات تشغيل الوكلاء تماماً: توكنز في الثانية، ومعدل إصابة ذاكرة التخزين المؤقت، وعدد الدورات، والوقت المنقضي. حين نُوقش المشروع على Hacker News، جمعت الخيط 747 نقطة و314 تعليقاً، وكان شفافية سجل الجلسة من أبرز ما أثنى عليه المشاركون.
أربعة أوضاع: قياسي، برمجي، مبسّط، منشئ
| الوضع | ما يوفّره | متى تستخدمه |
|---|---|---|
| قياسي (Standard) | مجموعة أدوات كاملة، وكيل متعدد الأغراض | المهام اليومية |
| برمجي (Code) | أدوات مكشوفة عبر Code Mode SDK؛ يكتب النموذج برنامج TypeScript | الأتمتة المعقدة متعددة الخطوات |
| مبسّط (Minimal) | bash ومحرّر str_replace فقط | قياس أداء عادل ومتكافئ بين النماذج |
| منشئ (Creator) | تجميع إعدادك المخصصة | بناء ملف شخصي أو حزمة مخصصة |
بدء سريع بأمر واحد
أسرع طريق لتشغيل نسخة فعّالة هو سطر واحد:
npx @deepseek-ai/dsh webيشغّل هذا الأمر واجهة ويب على http://127.0.0.1:3080 ويفتحها في المتصفح؛ أضف --no-open لتخطي فتح المتصفح على الأجهزة غير المصحوبة بشاشة. يتطلّب Node.js ^22.19.0 أو ≥ 24.0.0، وpnpm 11.7.0 إن أردت البناء من المصدر:
git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm installpnpm run buildpnpm dsh web- اقرأ
SAFETY.mdقبل توجيه الوكيل نحو مشروع حقيقي — README يطالب بذلك صراحةً. - أضف مفتاح API حين يُطلب منك؛ يُخزَّن في
$DSH_HOME/.credentials.yamlويظهر مُعمّى في الواجهة.
أول تشغيل في ثلاث خطوات
افتح الإعدادات (Settings)، اذهب إلى النماذج (Models)، والصق مفتاح API — يُفعَّل المسار فوراً دون إعادة تشغيل الخادم. أضف مجلد عمل وحدّده؛ تظل خانة المهمة معطّلة حتى يُختار مجلد. ثم أرسل المهمة. كل ما يتجاوز الصلاحيات الممنوحة مسبقاً يُعرض عليك للموافقة قبل التنفيذ.
نقاط دخول أخرى
فضلاً عن واجهة الويب، يأتي DeepSeek Harness بواجهة TUI (dsh --profile tui)، ووضع بلا رأس للسكريبتات وبيئات CI (dsh --profile headless "task description")، وحزمة SDK لـ Python (pip install deepseek-harness-sdk، وتتضمن بيئة تشغيل خاصة بها فلا تستلزم Node.js على النظام — نزل إصدار Windows x64 في 0.1.2-rc.1)، وحزمة SDK لـ TypeScript لدمجه مباشرةً في تطبيق آخر.
النماذج والمزوّدون والتكلفة
DeepSeek Harness نفسه مجاني ومفتوح بموجب رخصة MIT — التكلفة الدورية الوحيدة هي استخدام توكنز النموذج. تقدّم DeepSeek API النماذج deepseek-v4-flash وdeepseek-v4-pro والتجريبي deepseek-v4-flash-vision-exp، وجميعها بنافذة سياق مليون توكن وإخراج يصل إلى 384K توكن. دخلت أسعار جديدة حيّز التطبيق في 16 أغسطس 2026 الساعة 16:00 UTC، وتُقسَّم الأسعار إلى فترات ذروة وخارج الذروة (الذروة: 01:00–04:00 و06:00–10:00 UTC، من الاثنين إلى الجمعة).
| v4-flash | v4-pro | |
|---|---|---|
| مدخلات، إصابة تخزين مؤقت، خارج الذروة | $0.007 / 1M | $0.022 / 1M |
| مدخلات، خطأ تخزين مؤقت، خارج الذروة | $0.22 / 1M | $0.66 / 1M |
| مدخلات، خطأ تخزين مؤقت، ذروة | $0.44 / 1M | $1.32 / 1M |
| مخرجات، خارج الذروة | $0.66 / 1M | $1.98 / 1M |
التفاصيل الكاملة على صفحة أسعار DeepSeek API. لمن يريد تكلفة API صفرية، يربط محوّل @deepseek-ai/dsh-llm-pi-ai بين DeepSeek Harness وخلفيات نماذج الطرف الثالث والمحلية، بما فيها Ollama وvLLM وLM Studio وllama.cpp وأي بوابة متوافقة مع OpenAI — فنموذج محلي كامل يعمل مجاناً مع الإعداد ذاته لـ dsh.
Claude Code وCodex كوكلاء فرعيين
من الاختيارات التصميمية الأقل وضوحاً: يمكن لـ DeepSeek Harness التفويض إلى وكلاء برمجة حقيقيين من طرف ثالث عوضاً عن استبدالهم. تُطلق حزمة @deepseek-ai/dsh-subagent-claude-code واجهة سطر أوامر Claude Code الفعلية كعملية فرعية عبر Agent SDK الرسمي، وتفعل @deepseek-ai/dsh-subagent-codex الشيء ذاته لـ Codex عبر بروتوكول app-server --stdio. يحتفظ كل وكيل فرعي بإعداداته وتفويضاته الأصلية — لا يعترض DeepSeek Harness طريقة تسجيل دخول تلك الأدوات ولا يتجاوزها. بدءاً من الإصدار 0.1.2-rc.1 يمكن تهيئة النموذج الذي يستخدمه كل وكيل فرعي بصورة مستقلة عن الجلسة الأم.
الجدول الزمني للإصدارات والوضع الراهن
شُحنت قدرات DeepSeek Harness بهدوء داخل الإصدار الرسمي DeepSeek V4 في 31 يوليو 2026، دون منتج مستقل أو مصدر عام. جاء الإطلاق الفعلي في 13 أغسطس 2026: في الساعة 11:56 UTC انطلق المستودع العام، نشر @deepseek_ai أن “DeepSeek Harness v0.1 متاح الآن في المعاينة التطويرية”، ووصل DeepSeek-V4-Pro-0813 إلى التوافر العام، وظهرت الورقة البحثية لـ Cordis على arXiv في اليوم ذاته. 14 أغسطس 2026 تاريخ آخر يستحق المعرفة: إنه أقدم commit مرئي في تاريخ المستودع العام، ولهذا يصفه بعض الكتّاب بأنه يوم فتح الكود — غير أن المستودع أُنشئ في الـ13.
منذ ذلك الحين يصدر المشروع بناءً جديداً تقريباً كل يوم: وصل الإصدار 0.1.1 في 21 أغسطس جنباً إلى جنب مع DeepSeek-V4-Flash-Vision-Exp، وتلاه 0.1.2-rc.1 في 3 سبتمبر. يحذّر README بأحرف كبيرة من وجود تغييرات تكسر التوافق، وكلا قسمَي issues وpull requests معطّلان في المستودع — تُرسَل الملاحظات عبر GitHub Discussions أو Discord بدلاً منهما.
ما التالي
لكل جزء من DeepSeek Harness صفحته الخاصة في هذا الدليل، وهي مكتوبة لتُقرأ بأي ترتيب.
ابدأ بـ تثبيت DeepSeek Harness إن كنت تريده يعمل فوراً، واقرأ DeepSeek Harness على Windows أولاً إن كان جهازك يعمل بـ Windows — فمعظم إخفاقات التثبيت المعروفة تقع على Windows. حين يتعطّل شيء، يغطّي دليل الأخطاء الإخفاقات بالصياغة الحرفية التي يبحث عنها الناس.
لفهم ما تشغّله، يشرح استعراض مستودع GitHub ما بداخل الـ monorepo فعلاً، وتشرح صفحة Cordis نواة الإضافات في أسفله. ومن هناك، يُظهر دليل الإضافات كيف تُضاف القدرات وتُستبدل وتُشحن، بينما تغطّي صفحة الوكلاء الفرعيين ما لا يكتب عنه أحد تقريباً — تشغيل dsh لـ Claude Code وCodex كعمليات فرعية.
للقرارات لا للآليات: تعمل صفحة الأسعار واقتصاديات التوكنز على تحليل أثر تغيير أسعار API في أغسطس 2026 على حجة “أرخص من Claude Code”، وتقارن صفحة DeepSeek Harness مقابل Claude Code بينهما بصدق في الاتجاهين، وتغطّي صفحة تشغيل النماذج المحلية أدوات Ollama وvLLM وLM Studio وllama.cpp لمن يفضّل عدم إرسال كوده إلى أي مكان. إن كنت مهتماً بمن يبني هذا، تجمع صفحة الفريق ما هو معروف علناً عن المجموعة داخل DeepSeek المسؤولة عنه.