دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

تدبير وتتبع DSH Skills باستعمال echocat-skill-panel 3.0

كيشرح هاد المقال كيفاش تركّب echocat-skill-panel 3.0، وتتبع الـ skill اللي كتستعمل فكل جولة ديال الحوار، وتثبّت skills بنقرة وحدة من مصادر مختلفة، وتستعمل الإحالات السريعة، وتضبط السميات بالصينية، وتدير النسخ الاحتياطية والحذف بأمان.

تدبير وتتبع DSH Skills بـ echocat-skill-panel 3.0

نبذة على المشروع

echocat-skill-panel 3.0 هو إضافة cordis موجهة لـ DSH Desktop Beta. كتستنتج من تدفق أحداث الجلسة شنوما الـ skills اللي تستعملو فعلياً فكل جولة ديال الحوار، بلا ما تعتمد على أن النموذج يصرّح بها من راسو.

سواء كان النموذج هو اللي عيّط للـ skill أو المستخدم عيّط ليه يدوياً باستعمال /name، أو ما تعيّط حتى skill فهاد الجولة، الإضافة كتقدر تعطي النتيجة المناسبة.

لوحة إحصائيات وتدبير الـ skills

دور كل واجهة من الواجهات الثلاثة

المداخل الثلاثة ديال الإضافة كيتشاركو نفس البيانات، ولكن كل واحد مناسب لسيناريو مختلف:

  • الشريط اللي فوق خانة الإدخال: كيبقى باين وكيعرض خلاصة فسطّر واحد، وبالنقر عليه كتقدر تفتح التقرير الكامل فبلاصتو. هادي هي الواجهة الوحيدة اللي كتدعم الإحالة على skill بنقرة وحدة.
  • الأيقونة فالجهة اليسرى: مدخل دائم، وبالنقر عليها كتفتح اللوحة فالمنطقة الوسطى.
  • اللوحة فالوسط: مخصصة لمشاهدة التقرير الكامل ودليل الـ skills.

تثبيت الإضافة

الطريقة الأولى: التثبيت من كود GitHub

التثبيت من الكود هو الطريقة الموصى بها حيث كتوفّر الحزمة كاملة. نفّذ فـ PowerShell:

git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1"

سكريبت التثبيت كيدير بالترتيب نسخة احتياطية من لائحة profile، وكيعالج المرآة، وكيحيد أسماء الحزم القديمة، وكينشئ الروابط، وكيعدّل manifest، وكيشغّل pnpm install.

الطريقة الثانية: التثبيت عبر npm أو DSH

الإضافة منشورة فـ npm، واسم الحزمة هو echocat-skill-panel-3.0. تقدر تخلي DSH يكمل التثبيت:

dsh plugin --profile web add echocat-skill-panel-3.0

وتقدر حتى تثبّتها مباشرة فدليل profile:

npm install echocat-skill-panel-3.0

@deepseek-ai/dsh-llm و@deepseek-ai/schemastery مصرّح بهم كـ peer dependencies اختياريين. DSH runtime هو اللي كيوفّرهم، وnpm ما كيحمّلش نسخ إضافية باش يعوّض نسخة المضيف.

من بعد ما يكمل التثبيت، خاصك تعاود تشغّل DSH Desktop Beta. كود جهة المضيف كيتحمّل فالذاكرة وقت التشغيل، وبهذا حتى من بعد تعديل host خاص إعادة التشغيل. إلا كان التعديل غير فالكود ديال العميل، يكفي تنعش الصفحة باش يتعاود جلب client bundle.

الرجوع للخلف وأمان التثبيت

سكريبت تثبيت الكود كيدير نسخة احتياطية من لائحة profile قبل ما يبدا. إلا بغيتي ترجع للحالة السابقة، استعمل المعامل -Rollback اللي كيوفّرو السكريبت. بالنسبة للتثبيت اليدوي، والرجوع بعد الحذف، والقيود الصارمة اللي تقدر تخلي التطبيق ما يبداش، رجع لـتعليمات التثبيت فالمستودع.

تثبيت skill

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

لوحة تثبيت skill بنقرة وحدة

مثلاً، لصق رابط دليل فرعي من GitHub:

https://github.com/owner/repo/tree/main/skills/my-skill

الـ host كيتعرّف على نوع الرابط، وكيحدّد واش خاصو يدير clone ولا download، وكيستخرج الفرع والدليل الفرعي من الرابط. الإضافة كتدعم أشكال الإدخال التالية:

  • رابط الصفحة الرئيسية ديال مستودع GitHub.
  • رابط مجلد داخل المستودع.
  • رابط ملف SKILL.md.
  • رابط مباشر لملف ZIP.
  • الصيغة owner/repo.
  • رابط SSH.
  • رفع ملف محلي بصيغة .md أو .zip.
  • لصق المحتوى الكامل ديال SKILL.md مباشرة.

إلا كان كاين skill بنفس الاسم فالمكان المستهدف، الإضافة ما غاديش تبدلو فصمت، بل غادي تنشئ نسخة احتياطية قبل الاستبدال. ومنين كتحيد skill، الملف كيمشي حتى هو لدليل النسخ الاحتياطية وما كيتحيدش نهائياً بالقوة.

معرفة الـ skills المستعملة فكل جولة ديال الحوار

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

  1. كمّل جولة ديال الحوار.
  2. شوف الخلاصة اللي فالشريط اللي فوق خانة الإدخال.
  3. نقر على الشريط باش تفتح التقرير الكامل ديال هاد الجولة.
  4. وتقدر حتى تدخل للوحة فالوسط من خلال الأيقونة فالجهة اليسرى، وتشوف التقرير ودليل الـ skills.

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

الإحالة على skill واستعماله بنقرة وحدة

الشريط اللي فوق خانة الإدخال هو الواجهة الوحيدة اللي كتوفّر الإحالة بنقرة وحدة. من بعد ما تفتح الشريط، نقر على إحالة فبطاقة الـ skill المستهدف، والإضافة غادي تزيد الاختصار المناسب للمسودة الحالية:

/الاسم 

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

ضبط الاسم اللي كيبان بالصينية

الإضافة كتستعمل الحقل display-name-zh فـ meta.yaml ديال الـ skill باش تعرض الاسم بالصينية. تقدر تعمّرو وقت التثبيت، أو تعدّلو من بعد التثبيت من خلال بطاقة الـ skill.

  • منين كتعمّر الاسم بالصينية، اللوحة كتفضّل تعرضو.
  • إلا خليتي الحقل خاوي، تقدر تمسح الاسم الصيني المعروض.
  • الاختصار /الاسم كيبقى مستعمل فيه الرمز ASCII، وما كيتأثرش بالاسم الصيني المعروض.

بالنسبة للـ skills اللي ما عندهاش اسم بالصينية، الإضافة تقدر حتى تترجم الاسم تلقائياً وتخزّن النتيجة مؤقتاً.

نصائح للاستعمال المتقدم

فهم وضع القراءة فقط

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

استعمال النسخ الاحتياطية لتفادي الأخطاء

قبل استبدال skill بنفس الاسم كتدار نسخة احتياطية تلقائياً، وحتى الحذف ما كيحيدش الملفات بالقوة. قبل ترقية skill أو تجربة واحد المصدر ديالو ما معروفش، من الأحسن تتأكد أن دليل النسخ الاحتياطية ونسخة لائحة profile خدامين، باش تقدر ترجع للحالة السابقة وقت الحاجة.

التمييز بين تعديلات العميل وتعديلات host

الـ client bundle كيتجلب من جديد ملي كتفتح الصفحة، وبهذا التعديلات اللي غير فالعميل غالباً كيكون كافي فيها تنعش الصفحة. محتوى جهة الـ host كيتحمّل فالذاكرة وقت تشغيل DSH، لذلك أي تعديل فـ host أو إكمال تثبيت الإضافة خاصو إعادة تشغيل DSH Desktop Beta.

تفعيل الثيم الداكن وإعدادات أخرى

الإضافة كتدعم الثيم الداكن، والإشعارات النظامية من بعد كل جولة، والكاش ديال الترجمة التلقائية، وجميع إعدادات التكوين. تقدر تشوف الاختيارات والقيود ديال التثبيت فـتعليمات التثبيت.

التطوير والبناء

إلا عدّلتي src/client/، خاصك تعاود تولّد ملفات بناء العميل:

node tools/build-client.mjs

lib/client.js هو ملف البناء اللي خاصو يتسجّل فالمستودع، حيث ممكن الجهاز المستهدف ما يكونش فيه toolchain. خاص تعديلات src/client/ وملف البناء الجديد يكونو فـ نفس commit، وإلا غادي يفشل verify-install.mjs فالفحص ديال تطابق الـ bundle مع الحزمة.

المشروع ما عندوش dependencies إضافية وقت التشغيل؛ جوج peer dependencies كيوفّرهم الـ host. تقدر ترجع لـنقط التصميم باش تعرف تفاصيل التصميم، وقواعد الأمان ديال محرك التثبيت، ومشاكل التنفيذ، والاختبارات.

الخلاصة

echocat-skill-panel 3.0 كيجمع تتبع استعمال الـ skills، وتصفح الدليل، والتثبيت، والإحالة، والعرض بالصينية، والحذف الآمن داخل DSH Desktop Beta. من بعد تثبيت الإضافة وإعادة تشغيل التطبيق، تقدر تشوف بسرعة تقرير كل جولة من الشريط اللي فوق خانة الإدخال، وتستعمل زر الإحالة باش تزيد الـ skill المستهدف للمسودة. المشروع مرخّص برخصة MIT.