ما هو DeepSeek Harness؟ دليل شامل
Updated August 16, 2026 · first published August 16, 2026
DeepSeek Harness — اسم الحزمة dsh — هو إطار عمل وكلاء (agent harness) مفتوح المصدر ومرخص برخصة MIT من شركة DeepSeek AI. إليك الدليل الشامل والمبسط: ما هو، وكيفية تشغيله، وبنيته الهندسية، ولماذا يهمك أمره في إدارة تكاليف وهندسة الذكاء الاصطناعي.
ما هو إطار عمل الوكيل (Agent Harness) في الأساس
النموذج اللغوي يولد نصوصاً واستدعاءات أدوات فقط. لا يفعل أي شيء آخر. كل ما يجعل الوكيل مفيداً عملياً يقع على عاتق إطار العمل (Harness): تجميع التعليمات البرمجية، وتنفيذ الأدوات المطلوبة، وفرض صلاحيات الأمان، وتسجيل ما حدث، وإدارة حلقة اتخاذ القرار، وتفويض المهام لوكلاء فرعيين.
هذا الفارق جوهري؛ فمعظم ما يفعله الوكيل بنجاح أو فشل يعود لسلوك إطار العمل وليس للنموذج نفسه. يمكن لفريقين تشغيل النموذج ذاته والحصول على نتائج وتكاليف متباينة تماماً — والفارق يكمن في إطار العمل.
ما الذي يقدمه DeepSeek Harness
يقوم بتشغيل وكلاء البرمجة والأتمتة. عملياً، يستطيع الوكيل قراءة الملفات وتعديلها، وتشغيل أوامر shell، والبحث في الكود، وتفويض العمل إلى وكلاء فرعيين، وتخطيط المهام، وطلب الإذن وفقاً لسياسة الأمان المحددة. يتضمن واجهة متصفح، ووضع التشغيل الآلي بدون واجهة (headless)، وخادم أتمتة عبر JSON-RPC عبر الإدخال والإخراج القياسي.
الفكرة الأساسية: كل شيء عبارة عن إضافة (Plugin)
يعتمد الإطار على بيئة تشغيل Cordis، حيث تقدم الإضافات الخدمات والأحداث والتأثيرات القابلة للعكس في سياق مشترك. لا توجد نواة خاصة متميزة: محول النماذج هو إضافة، وسجل الأدوات إضافة، وسجل الجلسة إضافة، وحلقة الوكيل نفسها إضافة.
طريقة التشغيل
الطريقة السريعة
npx @deepseek-ai/dsh webيبدأ تشغيل واجهة الويب المحلية على المنفذ http://127.0.0.1:3080.
من المصدر (Source)
git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh webالمتطلبات: Node 22.19 أو أحدث، وGit 2.26 أو أحدث، مع pnpm مثبت عبر Corepack. مفتاح DeepSeek API اختياري أثناء التثبيت ولكنه ضروري للعمل الفعلي.
خطوتان يغفل عنهما الكثيرون
- الإعدادات ← النماذج: أدخل مفتاح API لتفعيل التوجيه فوراً دون إعادة تشغيل.
- اختر مساحة العمل: أضف مجلد المشروع وقم بتنشيطه، وإلا سيظل محرر الجلسة مقفلاً.
الوضع الآلي (Headless)
pnpm dsh --profile headless "summarize this workspace"المفاهيم الأساسية
| المصطلح | المعنى |
|---|---|
| الخطوة (Step) | استدعاء نموذج واحد بالإضافة إلى استدعاءات الأدوات الناتجة عنه |
| الدور (Turn) | إفراغ المدخلات، وينتهي بتوقف النموذج أو تدخل السياسة |
| الجولة (Round) | تكرار سياسة خارجي عبر الأدوار، مثل إعادة محاولة لتحقيق هدف |
| الجلسة (Session) | سجل إلحاقي فقط للأحداث يمثل المصدر الوحيد للحقيقة |
| واجهة القدرة | واجهة خدمة قابلة للتبديل بتطبيقات متعددة |
| الملف التعريفي (Profile) | تكوين مسمى لمجموعة إضافات مرتبة مع تصحيحات |
| النطاق (Scope) | وحدة تسجيل للأدوات والمطالبات والقيود لكل وكيل |
أبرز ما يميزه
- استبدال مزود النماذج: واجهة خدمة النماذج تدعم موفرين متعددين، بما في ذلك إعادة تشغيل جلسة مسجلة بدون تكلفة استنتاج جديدة.
- تسجيل كامل للجلسة: كل ما يراه النموذج يتم تسجيله، مع ربط استهلاك الرموز (tokens) بالاستدعاء المسبب لها مباشرة.
- نقاط حماية وفرض صريحة: نقطة قبل إرسال طلب النموذج ونقطة قبل تنفيذ أي أداة لمنع النفقات الخارجة عن السيطرة.
- تشغيل بدون واجهة (Headless): يتيح وضعه داخل مسارات التكامل المستمر CI/CD ومراقبته دورياً.
بنية الإضافات ليست مجرد ميزة تسويقية: أحد العروض التوضيحية المدمجة تفحص وتعدل بيئة إضافاتها قيد التشغيل ذاتياً.
متى تستخدمه ومتى تتجنبه
استخدمه: للتقييم، وبناء النماذج الأولية، وكمعيار هندسي للمقارنة مع حزمة الوكلاء التي تشغلها حالياً.
لا تعتمده كمعيار إنتاجي نهائي هذا الربع: يصف المشروع نفسه بأنه معاينة للمطورين (Developer Preview) وستطرأ عليه تغييرات جذرية في التوافق.
تكاليف التشغيل
الإطار نفسه مجاني ومرخص بـ MIT. لكن الاستنتاج ليس مجانياً: فاتورتك تتحدد بعدد الخطوات، والأدوات في الكتالوج، وعمق تفويض الوكلاء، وعدد جولات تحقيق الأهداف — وهي كلها قرارات يحددها إطار العمل وليس سعر الرمز وحده.
Related
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →