إطار DeepSeek Harness الرسمي v0.1: معاينة للمطورين

deepseek v4موقع deepseek الرسميدليل deepseekDeepSeek HarnessAgent

مخطط يوضح إطار عمل العملاء الذكي المفتوح المصدر DeepSeek Harness وهيكلية الإضافات

أعلنت DeepSeek رسميًا عن إصدار DeepSeek Harness (dsh) كمصدر مفتوح. إنه إطار عمل مخصص لتطبيقات العملاء الذكيين (Agents)، والإصدار الحالي هو نسخة مطور أولية (Developer Preview) v0.1، ومرخص بموجب ترخيص MIT. إنه ليس نموذجًا جديدًا للذكاء الاصطناعي، ولا مجرد واجهة دردشة ويب، بل هو طبقة تشغيل تربط بين النماذج، والأدوات، ونظام الملفات، والبيئات المعزولة (Sandbox)، والجلسات، والواجهات.

إذا اعتبرنا DeepSeek V4 هو “الدماغ” المسؤول عن الفهم والاستدلال، فإن Harness هو “مكتب العمل” الذي يمكن النموذج من قراءة المشاريع، واستدعاء الأدوات، وتنفيذ الأوامر، وحفظ حالة المهام، والإكمال المستمر للعملية. لا تناقش هذه المقالة شعارات التسويق، بل تركز على توضيح ماهية DeepSeek Harness، وكيفية عملها، والمواقف المناسبة لها، وكيف يجب للمستخدم العادي الاختيار بينها.

ما هو DeepSeek Harness؟

تعمل تطبيقات الدردشة العادية عادةً بآلية “طرح المستخدم للسؤال—إجابة النموذج”. بينما تتطلب مهام العملاء الذكيين خطوات إضافية: يقرر النموذج أولاً الإجراء التالي، ثم يستدعي الأدوات، ويقرأ نتائج التنفيذ، ويعيد التخطيط عند الحاجة، حتى اكتمال المهمة. النظام المسؤول عن تنظيم هذه التدفق هو Agent Harness.

تم تطوير DeepSeek Harness بواسطة DeepSeek AI، ويستخدم إطار العمل المسمى Cordis كقاعدة له. الفكرة الأساسية التي طرحها المطورون مباشرة هي: Everything is a Plugin (كل شيء هو إضافة). يمكن تحميل واستبدال أو تركيب محولات النماذج، وجدول تسجيل الأدوات، وسجلات الجلسات، وAgent Loop، وحتى الواجهات وسياسات الموافقة كإضافات.

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

ما هي العلاقة بينها وبين DeepSeek V4 وموقع Deepseek الرسمي؟

هذه المفاهيم الثلاثة يسهل الخلط بينها، ويمكن التمييز بينها باستخدام الجدول التالي:

الاسمالوظيفة الرئيسيةالفئة المستهدفة
DeepSeek V4توفير قدرات النموذج مثل فهم اللغة، والاستدلال، وتوليد الكودالأفراد والمطورون الذين يحتاجون إلى قدرات النماذج
موقع DeepSeek الرسمي ودخل الدردشةيوفر تجربة دردشة عبر الإنترنت جاهزة للاستخدامالمستخدمون الراغبون في طرح الأسئلة بسرعة، أو الكتابة، أو الترجمة، أو معالجة المواد
DeepSeek Harnessدمج النماذج، والأدوات، والجلسات، ونظام الملفات، وسلسلة التنفيذ للعميل الذكيالمطورون الذين يرغبون في بناء، أو تخصيص، أو دراسة أنظمة العملاء الذكيين

لذلك، فإن Harness لن تحل محل النموذج. إنها تحل مشكلة “كيفية جعل النموذج يشارك بشكل موثوق في المهام الحقيقية”. إذا كنت ترغب فقط في تجربة النموذج مباشرة، يمكنك البدء من بوابة موقع DeepSeek الرسمي؛ وإذا كنت تريد فهم الاستخدام الأساسي، يمكنك الاستمرار في قراءة دليل DeepSeek ودليل الاستخدام عبر الويب.

ما المشكلة التي تحلها مقولة “كل شيء هو إضافة”؟

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

يقسم DeepSeek Harness القدرات إلى واجهات قابلة للاستبدال. يشار إلى هذا الحد في وثائق الهندسة الرسمية باسم capability seam، ويتكون عادةً من ثلاثة أدوار: Service Definition الذي يعرّف الواجهة، وService Provider الذي يطبق القدرة، وConsumer الذي يستدعي القدرة. على سبيل المثال، يمكن للمجلد المحلي، والحجم البعيد (Remote Volume)، والبيئة المعزولة المقيدة تقديم نفس واجهة الخدمة، ولا تحتاج الأدوات العليا إلى معرفة مكان تخزين الملفات فعليًا.

طبقة الإضافاتالمحتوى المسؤول عنهالقيمة الناتجة عن قابلية الاستبدال
محول النموذجطلبات النموذج، والرسائل، والإخراج المتدفقإمكانية ربط نماذج مختلفة أو نقاط نهاية متوافقة
الأدوات والصلاحياتتسجيل الأدوات، وفحص ما قبل التنفيذ، والتنفيذ، ومعالجة النتائجتقييد القراءة/الكتابة، والأوامر، وصلاحيات الشبكة حسب السيناريو
الجلسات والسجلاتحفظ الرسائل، واستدعاءات الأدوات، والنتائج، وتغييرات الحالةدعم استئناف المهام، وإعادة التشغيل، والتفرع والتدقيق
نظام الملفات والبيئة المعزولةالقراءة/الكتابة على الملفات، وتنفيذ الأوامر، والبيئات المعزولةإمكانية التبديل بين بيئات التنفيذ المحلية والبعيدة
Agent Loopتنظيم طلبات النموذج، واستدعاءات الأدوات، والخطوات التاليةإمكانية تخصيص حلقة المهام وشروط الإيقاف
Web أو Headlessتوفير واجهة متصفح أو طريقة تشغيل بدون واجهةيمكن استخدام نفس القدرات للتفاعل الآلي والأتمتة

القيمة الحقيقية للإضافات ليست “كثرة عدد الإضافات”، بل تقليل تكلفة الاستبدال. يمكن للمطور استبدال مقدم خدمة واحد فقط، بدلاً من نسخ وصيانة مجموعة كاملة من العملاء الذكيين.

كيف ينهي DeepSeek Harness مهمة واحدة؟

يسمى المطورون مهمة المستخدم الواحدة Turn، ويمكن أن يحتوي Turn واحد على عدة Steps. كل Step يقابل طلبًا للنموذج، والتنفيذ الذي تثيره الأدوات الناتجة عن هذا الطلب. تتمثل العملية المبسطة في ما يلي:

  1. يستقبل Harness رسالة المستخدم، ويجمع توجيهات النظام، ورسائل التاريخ، والأدوات المتاحة حاليًا.
  2. يقرر النموذج ما إذا كان يجب الرد مباشرة، أم استدعاء أدوات مثل الملفات، أو الطرفية (Terminal)، أو البحث.
  3. تمر استدعاءات الأدوات عبر سياسة الصلاحيات وأنابيب التنفيذ، وتُكتب النتائج في سجل الجلسة.
  4. إذا تطلبت نتائج الأداة من النموذج الاستمرار في المعالجة، يشغّل Harness الخطوة التالية.
  5. عند عدم وجود أدوات بانتظار المعالجة أو مدخلات جديدة، تنتهي مهمة هذه الجولة.

سجل الجلسة هو جزء مهم من هذا الهندسة. يجب أن تكون المحتوى الذي رآه النموذج قابلًا لإعادة البناء من السجل؛ يمكن للرسائل، واستدعاءات الأدوات، والإخراج المتدفق، وتغييرات الحالة أن تصبح أحداثًا دائمة. يسهل ذلك استئناف المهام، وتصحيح الأخطاء، ويوفر أساسًا موثوقًا لإعادة التشغيل والتدقيق لاحقًا.

ما هي السيناريوهات المناسبة لاستخدام DeepSeek Harness؟

1. العملاء الذكيين المبرمجين الذين يحتاجون لقراءة وكتابة المشاريع

عندما لا تقتصر المهمة على توليد قطعة كود، بل تتطلب فهم المستودع (Repository)، وتعديل ملفات متعددة، وتشغيل الفحوصات، والمتابعة في الإصلاح بناءً على أخطاء، يمكن لـ Harness دمج نظام الملفات، والطرفية، وLSP، والتخطيط، والموافقة في نفس التدفق. إنها مناسبة أكثر للمهام المستمرة، وليس لأسئلة وأجوبة الكود لمرة واحدة.

2. أدوات الشركات الداخلية وأتمتة العمليات

يمكن للفرق تحميل الأدوات التي تحتاجها أعمالها فقط، ووضع العمليات الحساسة خلف موافقة يدوية. على سبيل المثال، العميل الذكي للبحث عن البيانات يفتح صلاحيات القراءة فقط، بينما يمكن للعميل الذكي للنشر الكتابة في دلائل محددة. تأتي الصلاحيات من حدود الأدوات والبيئة المعزولة، وهي أسهل في الإدارة بكثير من مجرد كتابة “لا تعدل الملفات” في التوجيه (Prompt).

3. تجارب النماذج المتعددة أو بيئات التنفيذ المتعددة

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

4. المهام الطويلة، والمهام الخلفية (Background)، والتعاون متعدد العملاء الذكيين

غالبًا ما تتطلب المهام المعقدة التقسيم، أو الانتظار لنتائج خارجية، أو إسنادها لعملاء ذكيين فرعيين (Sub-Agents). قد وضع Harness بالفعل قدرات الجلسات، والأهداف، والعمل الخلفي، والعملاء الذكيين الفرعيين في هندسة موحدة، مما يجعله مناسبًا لبناء عمليات طويلة قابلة للاستئناف وقابلة للرصد. ومع ذلك، لا تزال v0.1 في مرحلة المطور الأولي، ويجب إجراء اختبارات مكثفة قبل الاستخدام الإنتاجي.

5. أبحاث إطار عمل العملاء الذكي والإضافات

بالنسبة لمطوري الأطر، تكمن قيمة DeepSeek Harness أيضًا في أنها توفر مستودع كود حقيقيًا: كيفية تقسيم Agent Loop، وأحداث الجلسة، وتنفيذ الأدوات، وواجهات القدرة، وUI. يمكن للباحثين قراءة وتعديل والتحقق من التصميم بناءً على ترخيص MIT، بدلاً من الاعتماد فقط على المقالات المفاهيمية.

في أي الحالات لا يلزم الاستخدام؟

ليس كل مستخدمي DeepSeek يحتاجون إلى تثبيت Harness.

  • إذا كنت تقوم فقط بطرح الأسئلة، أو الكتابة، أو الترجمة، أو تنظيم المواد، فإن استخدام الدردشة عبر الإنترنت مباشرًا هو الأسهل.
  • إذا كان استدعاء واجهة برمجة التطبيقات (API) للنموذج لمرة واحدة فقط، ودورة الأدوات والجلسات الدائمة غير مطلوبة، فإن SDK العادي كافٍ.
  • إذا كانت الفريق يفتقر حاليًا إلى خبرة Node.js، أو البيئة المعزولة، والصلاحيات، وصيانة الإضافات، فلا ينبغي إدخال النسخة الأولية في عمليات الإنتاج الحساسة على الفور.
  • إذا كانت المتطلبات ثابتة جدًا وتعمل سكريبتات الأتمتة الحالية بشكل مستقر، فقد لا يجلب الانتقال إلى العميل الذكي فوائد حقيقية.

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

دليل البدء السريع مع DeepSeek Harness

أكثر الطرق مباشرة حاليًا هي بدء Web UI عبر npm. قم بتثبيت إصدار Node.js المدعوم أولاً، ثم شغّل:

npx @deepseek-ai/dsh web

افتراضيًا، سيعمل واجهة الويب على http://127.0.0.1:3080. بعد الدخول إلى الواجهة، يمكنك اتباع الخطوات التالية:

  1. افتح الإعدادات في Models، وأدخل DeepSeek API Key واحفظه.
  2. اختر دليل العمل؛ لن يتم تمكين مربع إدخال المهمة قبل اختيار مساحة العمل (Workspace).
  3. ابدأ جلسة جديدة، وابدأ بمهمة للقراءة فقط مثل “تلخيص هذا المستودع وتوضيح الدلائل الرئيسية”.
  4. راجع تلميحات الموافقة لكل عملية أداة، وتأكد من أن نطاق الصلاحيات يتوافق مع المتوقع.
  5. حاول بعد ذلك عمليات أكثر تعقيدًا مثل تعديل الملفات، وتشغيل الاختبارات، أو تقسيم المهام الفرعية.

إذا كنت تحتاج إلى التشغيل من الكود المصدري، يمكنك استنساخ المستودع الرسمي، ثم تثبيت التبعيات وبناء المشروع:

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

يُنصح بفصل دليل التجربة عن الدلائل الإنتاجية الحقيقية، وعدم منح صلاحيات الوصول إلى الملفات الحساسة، أو البيانات الاعتمادية (Credentials)، أو الأوامر عالية الخطورة دون فهم سياسات الصلاحيات. يمكنك أيضًا الرجوع إلى دليل الاستخدام لموقع DeepSeek الرسمي للحصول على مدخلات أساسية إضافية.

قيود يجب الانتباه إليها قبل الاستخدام

توضح DeepSeek رسميًا أن النسخة الحالية هي Developer Preview، وسيتبعها تكرار سريع، وقد تحدث تغييرات تكسر التوافق. لذلك، من الممكن تعديل ملفات التكوين، أو واجهات الإضافات، أو طريقة التشغيل.

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

الخلاصة

يمكن تلخيص موقع DeepSeek Harness في: تنظيم قدرات النموذج في نظام عميل ذكي قابل للتنفيذ، وقابل للتوسع، وقابل للاستعادة. يعتمد على Cordis، ويدمج النماذج، والأدوات، والجلسات، والبيئة المعزولة، ونظام الملفات، وAgent Loop، وUI في نظام الإضافات. بالنسبة للمطورين الذين يحتاجون إلى تخصيص العملاء الذكيين، أو تبديل بيئات التنفيذ، أو دراسة هندسة العملاء الذكيين، فهو يوفر نقطة انطلاق مفتوحة المصدر تستحق القراءة المتعمقة؛ أما بالنسبة للمستخدم العادي، فإن استخدام DeepSeek V4 عبر دردشة الويب مباشرة يظل الخيار الأبسط.

إذا كنت ترغب في تجربة قدرات الدردشة، والكود، ومعالجة المواد لـ DeepSeek V4 أولاً، يمكنك البدء من الدخول أدناه.

ابدأ استخدام DeepSeek

المصادر