
إطار DeepSeek Harness: البنية البرمجية التضمينية لوكلاء الذكاء الاصطناعي
تعتمد أغلب أطر عمل وكلاء الذكاء الاصطناعي المعاصرة على نمط تصميمي أحادي مغلق (Monolithic). فالحلقة التنفيذية المركزية، وآلية استدعاء الأدوات، وسجلات الجلسات، وعميل الاتصال بالنماذج تأتي جميعها مدمجة في محرك برمجي صلب. وعندما تحتاج الفرق الهندسية إلى استبدال قاعدة بيانات الجلسات، أو تطبيق عزل أمني صارم، أو تخصيص هيكل التوجيهات، تجد نفسها مضطرة لإنشاء نسخ فرعية مشتقة (Forks) يصعب تحديثها وصيانتها.
مع إطلاق مشروع DeepSeek Harness المعرف اختصاراً باسم dsh، تقدم شركة DeepSeek AI نموذجاً مختلفاً تماماً. يعتمد المشروع على محرك Cordis الصغير، ويطبق مبدأ هندسياً صارماً يقوم على اعتبار كل شيء بمثابة ملحق برمجي (Everything is a plugin)، استناداً إلى ورقة بحثية حول التركيبية الزمانية المكانية في النظم البرمجية (arXiv:2608.25512).
وفق هذا التصميم، لا توجد نواة برمجية ذات امتيازات خاصة ومغلقة، بل إن محولات النماذج، وسجل الأدوات، وسجل أحداث الجلسة، وحلقة اتخاذ القرار هي ملحقات متكافئة تسجل أحداثاً نوعية وخدمات محددة النطاق، مع إمكانية إلغاء تأثيراتها بصورة عكسية وسلسة عند إيقافها.
نواة Cordis والتأثيرات العكسية القابلة للإلغاء
في بيئات البرمجة التقليدية، يؤدي تحميل ملحق برمجي أو إضافة خارجية في الغالب إلى إحداث تغييرات دائمة في الذاكرة المشتركة. فإذا قام الملحق بتسجيل أداة أو تعديل مسار معالجة ثم واجه فشلاً لاحقاً، يتطلب استعادة الاستقرار إعادة تشغيل التطبيق بالكامل.
يعالج DeepSeek Harness هذه المعضلة عبر سياقات Cordis المنعزلة (ctx). حيث يُعامل كل تسجيل برمجي كتأثير إجرائي قابل للتراجع:
يرتبط الملحق بسياق العمل المشترك، معلناً عن خدماته والاعتماديات التي يتطلبها من الملحقات المجاورة.
قراءة حزم التكوين المنظمة وتطبيق التعديلات عبر ملف cordis.patch.yml دون المساس بالكود المصدري الأصلي.
تنفيذ أدوار الوكيل عبر سجل الأحداث التراكمي وتمرير مخرجات الأدوات عبر بوابات فحص محكمة.
عند إيقاف الملحق أو تحديثه لحظياً، تُلغى جميع الأدوات والخطافات التابعة له تلقائياً دون الحاجة لإعادة تشغيل العملية.
تتيح هذه البنية للمطورين استبدال قوالب التوجيه، أو تبديل مزودي نماذج اللغة، أو تفعيل منصات المراقبة اللحظية أثناء عمل النظام ودون قطع الاتصالات النشطة للمستخدمين.
ملفات التعريف وحزم التكوين
يوحد 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:// | عميل مكتبي آمن يعمل في بيئة رملية معزولة |
لمعاينة شجرة الملحقات والاعتماديات التي سيتم تشغيلها على الجهاز:
# استعراض شجرة تكوين الملحقات لملف تعريف الويب
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:
# تشغيل واجهة الويب التفاعلية محلياً
npx @deepseek-ai/dsh web
# التشغيل على خادم بعيد دون فتح المتصفح تلقائياً
npx @deepseek-ai/dsh web --no-open
ولبناء المشروع وتطوير ملحقات مخصصة من الكود المصدري:
# استنساخ المستودع وبناء الحزم
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
# تشغيل نسخة التطوير
pnpm dsh web
يمكن للمطورين نشر ملحقاتهم الخارجية على npm وإضافة الوسم dsh-plugin في مستودعاتهم لتسهيل اكتشافها وتثبيتها من قبل المجتمع التقني.
الموازنات الهندسية ونقاط الانتباه
يقدم التصميم التضميني مرونة استثنائية، لكنه يفرض تحديات هندسية يجب أخذها بعين الاعتبار:
- طبيعة التفكير البرمجي: يتطلب الانتقال من السكربتات الخطية إلى نمط النواة التفاعلية في Cordis التكيف مع آلية الاستماع للأحداث والتعامل مع السياقات العكسية.
- استقرار واجهات البرمجة: نظراً لأن المشروع في مرحلة المعاينة التطويرية، قد تتطلب التحديثات الجديدة مراجعة تكوينات ملفات الرقع
cordis.patch.yml. - تتبع الأخطاء: يتطلب استكشاف الأخطاء تشخيص التفاعل بين طبقات الحزم المختلفة بدلاً من قراءة ملف تشغيل منفرد.
الخلاصة
يقدم DeepSeek Harness رؤية متقدمة لكيفية بناء البنية التحتية لوكلاء الذكاء الاصطناعي في المستقبل. من خلال التخلص من النواة الصلبة الأحادية وجعل كل وظيفة قابلة للتعديل والتبديل كملحق متكافئ، يوفر الإطار أساساً متيناً وقابلاً للنمو والتوسع في بيئات العمل الفردية والمؤسسية.