STACKDUST
EN
مخطط بنية DeepSeek Harness يوضح نواة Cordis وملفات تعريف التشغيل ومسارات الأدوات المعزولة

إطار DeepSeek Harness: البنية البرمجية التضمينية لوكلاء الذكاء الاصطناعي


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

مع إطلاق مشروع DeepSeek Harness المعرف اختصاراً باسم dsh، تقدم شركة DeepSeek AI نموذجاً مختلفاً تماماً. يعتمد المشروع على محرك Cordis الصغير، ويطبق مبدأ هندسياً صارماً يقوم على اعتبار كل شيء بمثابة ملحق برمجي (Everything is a plugin)، استناداً إلى ورقة بحثية حول التركيبية الزمانية المكانية في النظم البرمجية (arXiv:2608.25512).

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

نواة Cordis والتأثيرات العكسية القابلة للإلغاء

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

يعالج DeepSeek Harness هذه المعضلة عبر سياقات Cordis المنعزلة (ctx). حيث يُعامل كل تسجيل برمجي كتأثير إجرائي قابل للتراجع:

دورة حياة الملحقات البرمجية في نظام Cordis
1. تثبيت الملحق البرمجي تركيب

يرتبط الملحق بسياق العمل المشترك، معلناً عن خدماته والاعتماديات التي يتطلبها من الملحقات المجاورة.

2. تطبيق طبقات التخصيص إعداد

قراءة حزم التكوين المنظمة وتطبيق التعديلات عبر ملف cordis.patch.yml دون المساس بالكود المصدري الأصلي.

3. التنفيذ المحدود وإدارة الأدوار نشط

تنفيذ أدوار الوكيل عبر سجل الأحداث التراكمي وتمرير مخرجات الأدوات عبر بوابات فحص محكمة.

4. إلغاء التثبيت العكسي النظيف إزالة

عند إيقاف الملحق أو تحديثه لحظياً، تُلغى جميع الأدوات والخطافات التابعة له تلقائياً دون الحاجة لإعادة تشغيل العملية.

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

ملفات التعريف وحزم التكوين

يوحد DeepSeek Harness بيئات التشغيل عبر مفهومين أساسيين: ملفات التعريف (Profiles) وحزم التكوين (Bundles):

  • ملف التعريف (Profile): ملف تكوين منظم يُحفظ في مسار المستخدم الخاص بالنظام ($DSH_HOME/profiles/). يحدد قائمة الحزم البرمجية المراد تشغيلها، ويدير الملحقات الخارجية، ويطبق تخصيصات cordis.patch.yml.
  • حزمة التكوين (Bundle): وسيلة لتوزيع إعدادات Cordis مع الشيفرات البرمجية التي تقوم بتشغيلها.

يوفر النظام ملفات تعريف قياسية جاهزة للاستخدام تناسب حالات التشغيل المختلفة:

اسم ملف التعريفبيئة التشغيل المستهدفةواجهة الاتصال الأساسيةالاستخدام النموذجي
webخادم Node.jsواجهة متصفح على المنفذ 3080التطوير التفاعلي واختبار الوكلاء مباشرة
headlessسطر الأوامر المستقلدفق نصوص الإدخال والإخراج القياسيةخطوط أتمتة CI/CD وتشغيل السكربتات المجمعة
sdkخدمة خلفية دائمةخادم بروتوكول JSON-RPCدمج النظام مع تطبيقات Python وTypeScript
acpمحرك الأتمتة المتقدمبروتوكول التحكم في الأتمتةإدارة أسراب الوكلاء وأحواض المعالجة الموزعة
desktopتطبيق Electron محليبروتوكول الاتصال الداخلي dsh-app://عميل مكتبي آمن يعمل في بيئة رملية معزولة

لمعاينة شجرة الملحقات والاعتماديات التي سيتم تشغيلها على الجهاز:

Terminal
# استعراض شجرة تكوين الملحقات لملف تعريف الويب
dsh --profile web --dump-config

يمكن استبدال أي سطر يظهر في هذا المخطط أو تعديله بسهولة عبر ملف cordis.patch.yml دون تعديل أي ملف في المستودع الأصلي.

الحزم الأساسية وحدود الأمان

تقسم المنظومة المهام الوظيفية إلى حزم برمجية مستقلة تحت مجلد packages/core/:

1. سجل الأحداث التراكمي (core/session)

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

2. مسارات الأدوات المقيدة (core/tools)

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

3. تجريد دفق النماذج (llm/llm)

تفصل المنظومة التفاعل مع النماذج اللغوية داخل طبقة موحدة عبر ctx.llm. ورغم تحسين هذه الطبقة للعمل بكفاءة مع نماذج DeepSeek مثل DeepSeek V4.1-Flash، إلا أنها تتصل مباشرة بأي منفذ متوافق مع OpenAI أو Anthropic أو الخوادم المحلية.

خطوات البدء السريع

يتوفر DeepSeek Harness حالياً للمطورين برخصة MIT عبر مدير الحزم npm:

Terminal
# تشغيل واجهة الويب التفاعلية محلياً
npx @deepseek-ai/dsh web

# التشغيل على خادم بعيد دون فتح المتصفح تلقائياً
npx @deepseek-ai/dsh web --no-open

ولبناء المشروع وتطوير ملحقات مخصصة من الكود المصدري:

Terminal
# استنساخ المستودع وبناء الحزم
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build

# تشغيل نسخة التطوير
pnpm dsh web

يمكن للمطورين نشر ملحقاتهم الخارجية على npm وإضافة الوسم dsh-plugin في مستودعاتهم لتسهيل اكتشافها وتثبيتها من قبل المجتمع التقني.

الموازنات الهندسية ونقاط الانتباه

يقدم التصميم التضميني مرونة استثنائية، لكنه يفرض تحديات هندسية يجب أخذها بعين الاعتبار:

  1. طبيعة التفكير البرمجي: يتطلب الانتقال من السكربتات الخطية إلى نمط النواة التفاعلية في Cordis التكيف مع آلية الاستماع للأحداث والتعامل مع السياقات العكسية.
  2. استقرار واجهات البرمجة: نظراً لأن المشروع في مرحلة المعاينة التطويرية، قد تتطلب التحديثات الجديدة مراجعة تكوينات ملفات الرقع cordis.patch.yml.
  3. تتبع الأخطاء: يتطلب استكشاف الأخطاء تشخيص التفاعل بين طبقات الحزم المختلفة بدلاً من قراءة ملف تشغيل منفرد.

الخلاصة

يقدم DeepSeek Harness رؤية متقدمة لكيفية بناء البنية التحتية لوكلاء الذكاء الاصطناعي في المستقبل. من خلال التخلص من النواة الصلبة الأحادية وجعل كل وظيفة قابلة للتعديل والتبديل كملحق متكافئ، يوفر الإطار أساساً متيناً وقابلاً للنمو والتوسع في بيئات العمل الفردية والمؤسسية.

المصادر


→المقال التاليمنصة OpenBot: زملاء العمل الأذكياء في بيئات استضافة ذاتية معزولة وحوكمة CELالمقال السابق←نظام ECC v2.2.1: البنية التحتية لهندسة وتحسين أداء وكلاء البرمجة