DeepSeek Harness: مقدمة في DeepSeek Harness

آخر تحديث: 2026-08-31

DeepSeek Harness (DSH) هو إطار عمل Agent مفتوح المصدر من DeepSeek، بفلسفة أساسية "كل شيء مكون إضافي" — من محولات النماذج إلى أنظمة الأدوات، من إدارة الجلسات إلى آليات Sandbox، جميعها تُحقن كإضافات في سياق مشترك، محققةً قابلية توسع قصوى.

📋 المتطلبات المسبقة: لا حاجة لخبرة سابقة؛ معرفة أساسية بسطر الأوامر تكفي

1. ما ستتعلمه

• تموضع DSH وفلسفته الأساسية
• بنية إضافات Cordis: الخدمات، الأحداث، التأثيرات الجانبية
• نظرة عامة على أوضاع التشغيل الأربعة (Standard / PTC / Minimal / Creative)
• DSH مقابل أطر Agent الأخرى
• اعتبارات الاستخدام خلال مرحلة المعاينة للمطورين

2. قصة اختيار فريق هندسة الذكاء الاصطناعي

(1) المشكلة: تفتت أطر Agent

Alice مهندسة معمارية في شركة ناشئة للذكاء الاصطناعي. واجه فريقها معضلة اختيار إطار Agent في الربع الثاني من 2026:

• Claude Code: واجهة سطر أوامر رسمية من Anthropic، لكنها مقيدة بنموذج واحد دون إمكانية التبديل
• Cursor: تكامل ممتاز مع IDE، لكن قدرات Agent محدودة ببيئة المحرر
• OpenCode: أداة سطر أوامر مفتوحة المصدر، لكن نظام إضافات ضعيف
• AutoGPT: مفهوم أولاً، لكن استقرار الإنتاج غير كافٍ
• LangChain: تنسيق مرن، لكن تكلفة تشغيل عالية وتصحيح الأخطاء صعب

مدير المنتج Bob زاد الضغط:

"نحتاج إطار Agent لا يعتمد على نموذج محدد، قابل للتوسع بالإضافات، ويدعم أوضاع تفاعل متعددة. يجب أن ينطلق خلال ثلاثة أشهر."

(2) حل DSH

بعد التقييم، اختارت Alice إطار DeepSeek Harness:

نظام الإضافات:      0 قابل للتوسع → كل شيء إضافة
دعم النماذج:       1 مزود → DeepSeek + متوافق مع OpenAI
أوضاع التفاعل:     سطر أوامر فقط → واجهة ويب + سطر أوامر + SDK + Headless
تكلفة التشغيل:     عالية → دنيا (Cordis تحميل كسول)
المجتمع:           GitHub 187.3k نجمة، رخصة MIT

نهج DSH "كل شيء مكون إضافي" سمح لفريق Alice بتجميع القدرات حسب الحاجة:

1. الأسبوع 1: واجهة ويب + DeepSeek API لتشغيل أول Agent
2. الأسبوع 3: الاتصال بنقطة نهاية متوافقة مع OpenAI، التبديل إلى GPT-4o
3. الأسبوع 6: إضافة أداة مخصصة، الاتصال بواجهة API داخلية للشركة
4. الأسبوع 10: Python SDK مدمج في خط الإنتاج

(3) النتائج

بعد ثلاثة أشهر من استخدام DSH:

• كفاءة التطوير: دورة إصدار ميزات Agent قصرت من أسبوعين إلى 3 أيام
• مرونة النماذج: تبديل سلس بين 3 نماذج LLM بدون أي تغيير في الكود
• إعادة استخدام الإضافات: 5 فرق شاركت 12 إضافة مخصصة
• تكلفة التشغيل: نشر وضع Headless خفض استهلاك الموارد بنسبة 60%

3. ما هو DeepSeek Harness؟

DeepSeek Harness (DSH) هو إطار Agent مفتوح المصدر من فريق DeepSeek، يحظى بـ 187.3k نجمة على GitHub برخصة MIT. ليس Agent بحد ذاته، بل إطار لتشغيل Agents — يوفر البنية التحتية لتكييف النماذج، وتنسيق الأدوات، وإدارة الجلسات، وتنفيذ Sandbox.

(1) ▶ مثال 1

graph TB
    subgraph DSH[DeepSeek Harness]
        C[نواة Cordis<br/>محرك الإضافات]
        M[محول النماذج<br/>DeepSeek / OpenAI]
        T[نظام الأدوات<br/>file_edit / shell / search]
        S[محرك Sandbox<br/>الموافقة والعزل]
        L[سجل الجلسة<br/>سجل إلحاقي فقط]
    end
    C --> M
    C --> T
    C --> S
    C --> L
    U[المستخدم] -->|واجهة ويب / سطر أوامر / SDK| DSH

graph TB
    subgraph DSH[DeepSeek Harness]
        C[نواة Cordis<br/>محرك الإضافات]
        M[محول النماذج<br/>DeepSeek / OpenAI]
        T[نظام الأدوات<br/>file_edit / shell / search]
        S[محرك Sandbox<br/>الموافقة والعزل]
        L[سجل الجلسة<br/>سجل إلحاقي فقط]
    end
    C --> M
    C --> T
    C --> S
    C --> L
    U[المستخدم] -->|واجهة ويب / سطر أوامر / SDK| DSH

(2) ملاحظات المعاينة للمطورين

DSH حاليًا في مرحلة معاينة المطورين، مما يعني:

• قد تتعرض واجهات API لتغييرات جذرية في الإصدارات المستقبلية
• بعض الميزات لم تكتمل بعد (مثل الوسائط المتعددة، ميزات Sandbox المتقدمة)
• التوثيق قد يتأخر عن الكود
• لا يُنصح بالاستخدام المباشر في الإنتاج

# إشعار معاينة المطورين أثناء التثبيت
npx @deepseek-ai/dsh web
# ⚠️ DeepSeek Harness is in developer preview.
# APIs may change before stable release.

مع ذلك، معاينة المطورين لا تعني عدم قابلية الاستخدام — الميزات الأساسية (المحادثات، الأدوات، الإضافات) مستقرة وعاملة، والمجتمع يتكرر بسرعة.

4. نواة Cordis: كل شيء مكون إضافي

Cordis هو الإطار الأساسي لـ DSH، سُمي تيمُّنًا بالكلمة اللاتينية التي تعني "القلب" — إنه المركز النابض للنظام بأكمله.

(1) نموذج مساهمة الإضافات

كل إضافة تساهم بثلاثة أنواع من المحتوى في السياق المشترك لـ Cordis:

interface PluginContribution {
  services: Service[];        // قدرات قابلة للاستدعاء تكشفها الإضافة
  events: EventType[];        // تدفقات أحداث نوعية
  sideEffects: SideEffect[];  // عمليات تأثيرات جانبية قابلة للعكس
}

• الخدمات (Services): قدرات قابلة للاستدعاء تكشفها الإضافات، مثل llm.complete()، shell.execute()
• الأحداث (Events): تدفقات أحداث نوعية، مثل tool.beforeExecute، session.forked
• التأثيرات الجانبية (Side Effects): عمليات قابلة للعكس، مثل تعديلات الملفات التي يمكن التراجع عنها أو أوامر Shell التي يمكن إلغاؤها

(2) ▶ مثال 2

graph LR
    P1[إضافة LLM] -->|تساهم بخدمة| CTX[السياق المشترك]
    P2[إضافة أداة] -->|تساهم بخدمة| CTX
    P3[إضافة Sandbox] -->|تساهم بحدث| CTX
    P4[إضافة سجل] -->|تشترك في حدث| CTX
    CTX -->|يوزع| P1
    CTX -->|يوزع| P2
    CTX -->|يوزع| P3
    CTX -->|يوزع| P4

graph LR
    P1[إضافة LLM] -->|تساهم بخدمة| CTX[السياق المشترك]
    P2[إضافة أداة] -->|تساهم بخدمة| CTX
    P3[إضافة Sandbox] -->|تساهم بحدث| CTX
    P4[إضافة سجل] -->|تشترك في حدث| CTX
    CTX -->|يوزع| P1
    CTX -->|يوزع| P2
    CTX -->|يوزع| P3
    CTX -->|يوزع| P4

هذا التصميم يضمن:

• صفر تبعيات مباشرة بين الإضافات — تتواصل بشكل غير مباشر عبر السياق المشترك
• إضافة إضافات جديدة لا تتطلب تعديل كود الإضافات الموجودة
• التأثيرات الجانبية قابلة للعكس — تدعم التراجع عن العمليات واستعادة الجلسات

(3) ▶ مثال 3

import { definePlugin } from '@deepseek-ai/dsh';

export default definePlugin({
  name: 'hello-dsh',
  version: '1.0.0',
  contribute(ctx) {
    ctx.registerService('hello', {
      greet(name: string) {
        return `Hello, ${name}! Welcome to DSH.`;
      }
    });
    ctx.emit('hello.registered', { timestamp: Date.now() });
  }
});

5. نظرة عامة على أوضاع التشغيل الأربعة

يوفر DSH أربعة أوضاع تشغيل، مُكيَّفة لحالات استخدام وتفضيلات مختلفة:

(1) نظرة سريعة على الأوضاع

(2) تبديل الأوضاع

# تبديل الوضع عبر سطر الأوامر
dsh --mode standard
dsh --mode ptc
dsh --mode minimal
dsh --mode creative

في واجهة الويب، يمكن تبديل الأوضاع في الوقت الفعلي عبر القائمة المنسدلة في الأعلى.

graph LR
    USER[إدخال المستخدم] --> MODE{وضع التشغيل}
    MODE -->|standard| S[قرار Agent المستقل]
    MODE -->|ptc| P[خطط أولاً، ثم برمج]
    MODE -->|minimal| M[أقل استدعاءات للأدوات]
    MODE -->|creative| C[مخرجات استكشافية]
    S --> TOOLS[نظام الأدوات]
    P --> TOOLS
    M --> TOOLS
    C --> TOOLS

graph LR
    USER[إدخال المستخدم] --> MODE{وضع التشغيل}
    MODE -->|standard| S[قرار Agent المستقل]
    MODE -->|ptc| P[خطط أولاً، ثم برمج]
    MODE -->|minimal| M[أقل استدعاءات للأدوات]
    MODE -->|creative| C[مخرجات استكشافية]
    S --> TOOLS[نظام الأدوات]
    P --> TOOLS
    M --> TOOLS
    C --> TOOLS

للمقارنة التفصيلية وإعدادات الأوضاع، راجع 04-modes.md.

6. المقارنة مع أطر Agent الأخرى

(1) مقارنة الأبعاد الأساسية

(2) مزايا DSH التفريقية

1. حرية النموذج: غير مقيد بأي مزود LLM؛ DeepSeek API ونقاط النهاية المتوافقة مع OpenAI جاهزة للاستخدام الفوري
2. نظام الإضافات: بنية Cordis تحول توسيع الميزات إلى "كتابة إضافات" بدلاً من "تعديل الكود المصدري"
3. تفاعل متعدد القنوات: واجهة ويب للمبتدئين، سطر أوامر للمطورين، SDK للدمج، Headless للأتمتة
4. تأثيرات جانبية قابلة للعكس: يمكن التراجع عن العمليات، وهو أمر نادر جدًا بين أطر Agent

(3) سيناريوهات لا يناسبها DSH

• الحاجة لاستقرار إنتاج بنسبة 100% (معاينة المطورين)
• التشغيل البحت من المتصفح (DSH يتطلب بيئة Node.js)
• بيئات الموارد المنخفضة للغاية (نواة Cordis لها تكلفة أساسية)

7. نظرة عامة على حزمة التقنيات

حزمة تقنيات DSH الكاملة:

graph TB
    subgraph طبقة التفاعل
        WEB[واجهة ويب<br/>React + Vite]
        CLI[سطر أوامر<br/>تفاعل الطرفية]
        SDK[Python SDK<br/>وصول برمجي]
        HEAD[Headless<br/>تنفيذ غير مراقب]
    end
    subgraph الطبقة الأساسية
        CORDIS[Cordis<br/>محرك الإضافات]
        SESSION[مدير الجلسات<br/>إدارة الجلسات]
        TRAJ[Trajectory<br/>محرك السجلات]
    end
    subgraph طبقة الإضافات
        LLM[محول LLM<br/>DeepSeek / OpenAI]
        TOOLS[إضافات الأدوات<br/>file_edit / shell / search]
        SANDBOX[إضافة Sandbox<br/>الموافقة والعزل]
        PROFILE[إضافة Profile<br/>تكوين التشكيلات]
    end
    WEB --> CORDIS
    CLI --> CORDIS
    SDK --> CORDIS
    HEAD --> CORDIS
    CORDIS --> SESSION
    CORDIS --> TRAJ
    CORDIS --> LLM
    CORDIS --> TOOLS
    CORDIS --> SANDBOX
    CORDIS --> PROFILE

graph TB
    subgraph طبقة التفاعل
        WEB[واجهة ويب<br/>React + Vite]
        CLI[سطر أوامر<br/>تفاعل الطرفية]
        SDK[Python SDK<br/>وصول برمجي]
        HEAD[Headless<br/>تنفيذ غير مراقب]
    end
    subgraph الطبقة الأساسية
        CORDIS[Cordis<br/>محرك الإضافات]
        SESSION[مدير الجلسات<br/>إدارة الجلسات]
        TRAJ[Trajectory<br/>محرك السجلات]
    end
    subgraph طبقة الإضافات
        LLM[محول LLM<br/>DeepSeek / OpenAI]
        TOOLS[إضافات الأدوات<br/>file_edit / shell / search]
        SANDBOX[إضافة Sandbox<br/>الموافقة والعزل]
        PROFILE[إضافة Profile<br/>تكوين التشكيلات]
    end
    WEB --> CORDIS
    CLI --> CORDIS
    SDK --> CORDIS
    HEAD --> CORDIS
    CORDIS --> SESSION
    CORDIS --> TRAJ
    CORDIS --> LLM
    CORDIS --> TOOLS
    CORDIS --> SANDBOX
    CORDIS --> PROFILE

❓ أسئلة شائعة

📖 ملخص

• DSH هو إطار Agent مفتوح المصدر من DeepSeek بفلسفة "كل شيء مكون إضافي"
• نواة Cordis تحقق فك إضافة الإضافات عبر سياق مشترك: الخدمات، الأحداث، التأثيرات الجانبية القابلة للعكس
• أربعة أوضاع تشغيل تتكيف مع سيناريوهات مختلفة: Standard / PTC / Minimal / Creative
• مقارنة بـ Claude Code و Cursor وغيرها، المزايا الأساسية لـ DSH هي: لا يعتمد على نموذج + نظام إضافات + تفاعل متعدد القنوات
• حاليًا في مرحلة معاينة المطورين؛ الميزات الأساسية قابلة للاستخدام لكن واجهات API قد تتغير
• GitHub 187.3k نجمة، رخصة MIT مفتوحة المصدر، مجتمع نشط

📝 تمارين

1. ⭐ أساسي： زر مستودع DSH على GitHub، اقرأ README، اذكر ثلاث ميزات تجذبك أكثر، واشرح لماذا.

2. ⭐⭐ متوسط： استخدم جدولًا لمقارنة DSH مع أداة Agent أخرى تعرفها (مثل Claude Code، Cursor)، مع تضمين 6 أبعاد مقارنة على الأقل.

3. ⭐⭐⭐ تحدٍ： ارسم مخطط بنية Mermaid يوضح فهمك لنموذج مساهمة إضافات Cordis — ضمّن 3 إضافات على الأقل، مع توضيح الخدمات والأحداث والتأثيرات الجانبية التي تساهم بها.

فريق Web-Tutorial التقني

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

من نحن