نظّم ونفّذ سيرورات عمل الذكاء الاصطناعي فوق اللوحة باستعمال dsh-jailbreak-workflow

مقدمة على المشروع

dsh-jailbreak-workflow، اللي كيقابلو الحزمة @xiaoso/dsh-workflow-lite، هو إضافة ديال سير العمل المرن لـ DeepSeek Harness. كيسمح ليك ترتّب مراحل المهام فاللوحة، ومن بعد تكمبايل العملية كاملة فواحد البرومبت ديال الخطة، باش ينفذها الموديل الموجود فالجلسة الحالية حسب الخطة.

كيدعم الترتيب، والتنفيذ بالتوازي، والتجميع، والتفرعات الشرطية، والتكرار، والرجوع. الروابط تقدر تحمل أي شرط، وبهذا ماشي غير مناسب للمهام الخطية البسيطة، بل حتى للمنطق المعقد بحال «إلى ما دازش الفحص رجع للتعديل» و«منين يتحقق الشرط سال العملية».

الإضافة بوحدها ما فيهاش محرك تنفيذ، وما كتحتاجش خدمة جدولة إضافية. جدولة المراحل، وفحص الشروط، وتنفيذ المهام كاملين كيتكلف بهم الموديل الموجود فالجلسة الحالية.

كيفاش كيخدم المبدأ الأساسي

تشغيل سير العمل كامل كيتقسم لثلاث مراحل:

1. التصميم: كتزيد المراحل فاللوحة، وكتكتب البرومبت ديال كل مرحلة، وكتوصف بالروابط ترتيب التنفيذ والتفرعات والتكرار.
2. الكمبايل: الإضافة كترتب محتوى اللوحة فبرومبت ديال الخطة، وكتوضح ترتيب المراحل، وشروط التكرار، والموارد الداخلة، والنتائج المتوقعة.
3. التنفيذ: الموديل كيقرا الخطة، وكيقرر بوحدو واش يكمل مباشرة، ولا يوزع المهمة على وكلاء فرعيين، ولا ينظم فريق، وكيزامن التقدم مع اللوحة.

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

الوظائف الرئيسية

• تحرير اللوحة: جرّ المراحل والروابط، وصايب تفرعات ديال داز أو ما دازش، وتكرارات، وقدر ترتب التصميم بكليك وحدة.
• إعداد الموارد: حدّد للمراحل الملفات، والمجلدات، والمواقع، وSkill اللي خاصها تقراها أو تكتب فيها.
• طرح الأسئلة قبل التنفيذ: جمع المعلومات الضرورية من المستخدم قبل التشغيل، ومن بعد صيفط الأجوبة للموديل مع الخطة.
• التحرير بالتعاون مع الموديل: خليه ينشئ أو يعدل سير العمل مباشرة فالمحادثة، والنتيجة غادي تتزامن مع اللوحة.
• حالة التشغيل: شوف التقدم المباشر، وملخص كل مرحلة، والحالة فاللوحة، وقدر تبدل الحالة وتخبر الموديل.
• تدبير الإصدارات: حفظ الإصدارات، وزيد ملاحظات، وقارن الفروقات، ورجع لإصدار قديم.
• الاستيراد والتصدير: جمع سير العمل، والإصدار المختار، والملفات، وSkill فحزمة .wflite.zip.
• التصدير كـ Skill: كمبايل إصدار فـ Skill فيها SKILL.md، ووصف المهام، والموارد المرتبطة، وتقدر تنزلها أو تثبتها فـ ~/.agents/skills.
• مركز سير العمل: دبر فبلاصة وحدة سجلات التنفيذ، وسير العمل، والإصدارات، والذاكرة، وإعدادات الإضافة ديال الجلسات المختلفة.
• اللغتين والثيمات: كيدعم الصينية، والإنجليزية، ومجموعة ديال الثيمات الفاتحة والداكنة.

التحضير قبل التثبيت

هاد الإضافة متوافقة مع DeepSeek Harness 0.2.0 و0.2.1، بما فيها الإصدارات التجريبية الموافقة، بحال 0.2.1-rc.2. إلا كنت كتستعمل النسخة فالويب، خاصك حتى تثبت Node.js 22 أو إصدار أحدث.

المشروع باقي فمرحلة تجريبية، والوظائف وصيغة البيانات يقدرو يتبدلو بطريقة ماشي متوافقة فالإصدارات الجاية. من الأفضل تصدّر سير العمل المهم وتحافظ على الإصدارات ديالو فالحين.

تثبيت إضافة نسخة الويب

حلّ التيرمينال، وزيد الإضافة لـ Web profile ديال DeepSeek Harness، ومن بعد شغّل نسخة الويب:

dsh plugin --profile web add @xiaoso/dsh-workflow-lite
dsh web

منين يكمل التشغيل، دخل لصفحة الجلسة. إلا كان التثبيت ناجح، غادي يبان تبويب «سير العمل» فالفوق ديال الصفحة.

تثبيت إضافة نسخة سطح المكتب

1. حلّ «الإضافات» من الشريط الجانبي ديال DeepSeek Harness.
2. اختار «إضافة إضافة»، ومن بعد كليك على «تثبيت إضافة من طرف ثالث».
3. دخل @xiaoso/dsh-workflow-lite وأكد التثبيت.
4. عاود شغّل DeepSeek Harness.
5. دخل لصفحة الجلسة وتأكد بلي تبويب «سير العمل» بان فالفوق.

الاستعمال الأساسي 1: خلّي الموديل ينشئ سير العمل

أسهل طريقة هي توصف مراحل المهمة وشروط الحكم عليها بلغة طبيعية فالمحادثة. مثال:

صايب سير عمل: كتب الكود الأول، من بعد راجعو، وإلى ما دازش الفحص رجع صلحو، بحد أقصى ثلاث جولات.

الموديل غادي ينشئ المراحل، ويربط تفرع الفحص، ويضبط التكرار، واللوحة غادي تعرض النتيجة مباشرة. قبل التشغيل خاصك تراجع هاد النقط:

• واش البرومبت ديال كل مرحلة واضح.
• واش تفرعا «داز» و«ما دازش» مربوطين بالعقد الصحيحة.
• واش التكرار عندو شرط خروج واضح أو عدد أقصى ديال المرات.
• واش ملفات الإدخال ومكان الإخراج مضبوطين مزيان.

منين تتأكد، كليك على «تنفيذ» فالجهة اليمنى الفوقانية، وتقدر حتى تكمل فالمحادثة وتطلب من الموديل ينفذ سير العمل مباشرة.

الاستعمال الأساسي 2: بناء سير العمل يدويا

1. حلّ تبويب «سير العمل» وصايب سير عمل جديد.
2. جرّ المراحل اللي محتاج من مكتبة المراحل فالجهة اليسرى.
3. كتب فكل مرحلة البرومبت اللي غادي تعطي للموديل.
4. استعمل الروابط باش تحدد ترتيب التنفيذ، وزيد الشروط أو التفرعات أو التكرار عند الحاجة.
5. ربط بالمراحل الملفات، والمجلدات، والمواقع، أو Skill اللي خاصها تقراها أو تكتب فيها.
6. كليك على «تنفيذ»، أو طلب من الموديل فالمحادثة يشغّل سير العمل الحالي.

مثال: عملية محتوى فيها تكرار ديال إعادة العمل

تقدر تقسم مهمة ديال المحتوى لأربع مراحل: «جمع المعلومات»، و«إنشاء المسودة الأولى»، و«فحص الجودة»، و«تعديل المسودة الأولى». إلا داز فحص الجودة كتسالي العملية؛ وإلا ما دازش، كتمشي لمرحلة التعديل ومن بعد كترجع لفحص الجودة. حيت الحكم الفعلي كيديرو الموديل، خاص البرومبت ديال مرحلة الفحص يوضح معايير النجاح.

فحص واش المسودة الأولى كتستوفي هاد الشروط:
1. الاستنتاجات مدعومة بالمعلومات؛
2. البنية كاملة؛
3. ما كاينش تكرار واضح؛
4. خرج «داز» أو «ما دازش»، وشرح السبب.

فأي عملية فيها تكرار، من الأحسن تزيد عدد أقصى ديال الجولات فالبومبت أو فشروط العملية، باش ما يبقاش الموديل كيعيد العمل بلا نهاية.

تتبع تقدم التنفيذ

حلّ «إعدادات سير العمل» وفعّل «تسجيل حالة التشغيل». من بعد، كل تنفيذ غادي ينشئ سجلا مستقلا، واللوحة غادي تتحدث مع تقدم التنفيذ. تقدر تشوف ملخص كل مرحلة، وتقدر حتى تبدل حالة المراحل وتخبر الموديل.

سير العمل، والإصدارات، وسجلات التنفيذ ديال الجلسات كاملين مجموعين فـ «مركز سير العمل» اللي كاين فالجهة اليسرى الفوقانية من اللوحة. ملي تبغي تراجع تشغيل قديم أو تبدل إصدار، من الأفضل تبدا من تما.

الاستعمال الصحيح لمتغيرات المسارات

مسارات الموارد والمجلد الجذري ديال النتائج كيدعمو جوج متغيرات: {workflow} و{instance}. الاستعمال المعقول ديالهم كيعاونك ما تكتبش المسارات المطلقة المرتبطة بالجهاز داخل سير العمل.

{workflow}: مجلد الموارد المشتركة ديال سير العمل

تقدر تكتب هاد المتغير فمسار ملف أو مجلد مورد، مثلا:

{workflow}/refs/notes.md

وقت التنفيذ، غادي يتبدل بمجلد سير العمل الحالي، والمكان الافتراضي ديالو كيكون بحال:

~/.dsh/workflow-lite/assets/<اسم سير العمل>/

هاد المجلد ما كيتبدلش مع مساحة العمل ديال التنفيذ، وحتى ملي كتبدل اسم سير العمل أو كتصدرو كيتعالج معاه، وبهذا فهو مناسب لحفظ المراجع، والقوالب، والملفات اللي كيستعملها سير العمل على المدى الطويل. الإصدار القديم {assets}/… باقي خدام، وملي كتفتح سير العمل كيتحول أوتوماتيكيا لـ {workflow}/….

{instance}: مجلد نسخة تشغيل واحدة

هاد المتغير مخصص للمجلد الجذري ديال النتائج فـ «إعدادات سير العمل». مثال على الإعداد الافتراضي:

.workflow-lite/runs/{instance}/out

وقت التشغيل، {instance} كيتبدل بمعرف نسخة التنفيذ الحالية، وبهذا كل تشغيل كيتخزن الناتج ديالو بوحدو، وهاد الشي مناسب للمهام اللي خاصها تحتافظ وتقارن نتائج جولات متعددة.

استيراد سير عمل جاهز

المشرفون على المشروع موفرين مجموعة dsh-workflows ديال سير العمل مستقلة. من بعد ما تنزل ملف .wflite.zip منها، تقدر تستوردو من «مركز سير العمل».

حزمة الاستيراد تقدر تحتوي على سير العمل، وإصدار محدد، والملفات المرتبطة، وSkill. الإضافة غادي تعرض قبل الاستيراد أماكن تثبيت كل عنصر، ومن الأفضل تتأكد من المسارات قبل ما تكمل.

الـ README فيه مثال «صناعة درع» على شكل خط أنابيب بحث من 15 مرحلة، وكيشمل اختبار المجسات، وتحليل أنماط الرفض، وإنشاء محتوى مخصص، والتحقق من API، وإخراج الملفات. عند استعمال أي سير عمل بحثي من هاد النوع، خاصك تتأكد بلي الهدف، ومصادر البيانات، وسلوك الاختبارات متوافقين مع القوانين المعمول بها، وقواعد المنصة، ونطاق التفويض.

عرض اللوحة ومعاينة الملفات

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

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

ذاكرة سير العمل

«الذاكرة» وظيفة تجريبية كتستعمل باش تجمع الطرق اللي نجحات والمشاكل اللي وقعات وتحولها لـ Skill، باش يستافد منها التنفيذ من بعد. تقدر تفعّل الذاكرة لمرحلة معينة بوحدها، أو تجرّ عقدة «الذاكرة» من مجموعة «الأساسيات» فمكتبة المراحل، وبهذا يشارك فيها سير العمل كامل.

كل ذاكرة كتقابلها حافظة Skill وحدة، و«المسار السريع» فيها كيسجل طريقة تنفيذ أسهل فالمرة الجاية. أثناء التشغيل، كل مرحلة كتكتب التجربة فالرد؛ ومنين كيسالي سير العمل، الموديل كيرتبها كاملة.

حدود وظيفة الذاكرة

• إلا عدلو بزاف ديال النسخ نفس الذاكرة فنفس الوقت، ما كاينش قفل، والمحتوى اللي تكتب من بعد كيغطّي على اللي تكتب قبل.
• إعادة تصدير Skill وتثبيتها فوق النسخة الموجودة كيغطّي على الذاكرة اللي تراكمات فـ Skill المثبتة.
• التجارب الأولى ديال التنفيذ المتكرر ما بيناتش تسريعا مستقرا؛ والنتيجة الفعلية من بعد إضافة «المسار السريع» ما زالت خاصها تحقق فعدد أكبر من سير العمل.

إلا كنت محتاج تدبير أكثر تعقيدا وتحكما للتجارب طويلة المدى، فالـ README كينصح باستعمال «الموارد» مع البرومبتات وتنفيذ الحل بوحدك.

نصائح متقدمة فالممارسة

خلّي برومبتات المراحل قابلة للتحقق

ما تكتبش غير «فحص النتيجة». خاصك تذكر معايير الحكم، والمدخلات اللي خاص تقرا، وصيغة الإخراج، والعملية اللي خاص تدوز أو ما تدوزش. الموديل محتاج هاد المعلومات باش يدير الحكم على الشروط.

حط حدود للتكرار

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

فرّق بين الموارد المشتركة ونتائج التشغيل

حط القوالب، والمراجع، والملفات طويلة المدى تحت {workflow}؛ وحط التقارير، والسجلات، والنتائج الوسيطة ديال كل تنفيذ فمجلد فيه {instance}. بهاد الطريقة كيولي التصدير ساهل، وكتقدر تقارن بين عمليات متعددة.

حفظ الإصدارات قبل التغييرات المهمة

قبل ما تبدل البرومبتات، أو شروط الروابط، أو مسارات الموارد، حفظ إصدار وزيد ملاحظة. إلا وقع مشكل، تقدر تقارن الفروقات بين الإصدارات أو ترجع مباشرة لإصدار سابق.

التصدير كـ Skill باش تزيد قابلية النقل

إلا كانت البيئة المستهدفة ما غاديش تثبت الإضافة، تقدر تكمبايل إصدار مستقر كـ Skill. المحتوى المصدر كيشمل SKILL.md، ووصف مهام كل مرحلة، والملفات وSkill المجمعة، وتقدر تستعملو كمورد مستقل.

استعمل الوظائف التجريبية بحذر

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

الخلاصة

dsh-jailbreak-workflow كيحوّل المهام المعقّدة لكانفاس مرئي، ومن بعد كيترجمها لبرومبت ديال الخطة وكيعطيها للموديل اللي خدام فجلسة DeepSeek Harness الحالية باش ينفّذها. تقدر تبدا بواحد المسار البسيط ديال «التوليد—المراجعة—إعادة الخدمة»، ومن بعد تزيد بالتدريج الموارد، ومتغيّرات المسارات، وسجلات التشغيل، وتدبير الإصدارات، وتصدير Skill. فهم المبدأ ديال «الإضافة كتكلّف بترجمة الخطة، والموديل كيتكلف بالتنسيق الفعلي» هو المفتاح لتصميم سير عمل مستقر.