أوامر الدردشة الأصلية

تقبل كاظمه نص الأوامر المائلة العادي في Telegram وDiscord وSlack. ويقبل Discord وSlack أيضًا الأمر الأصلي /kazma مع حقل للأمر ووسائطه: x help أو ide help أو documents list أو help. يمر التنفيذ كله عبر موزّع البوابة الحالي وبوابات الموافقة وصلاحيات المشرف.

Telegram

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

Discord

عند حدث Gateway READY تسجّل كاظمه /kazma فقط أو تحدّثه في كل خادم مسموح ومضبوط، أو عالميًا إن لم تُضبط قائمة خوادم. وتقرأ التسجيل للتحقق؛ يلخّص اختبار الموصل النطاقات المتحقق منها وإخفاقات التسجيل. يحتاج التطبيق المثبّت إلى النطاق applications.commands. التسجيل وحده لا يثبت وصول أمر فعلي من الخادم: تحقّق من /kazma command:help في خادم اختباري.

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

Slack

اضبط أمرًا مائلًا واحدًا في تطبيق Slack القائم. ادمج هذا الجزء في بيان التطبيق مع الإبقاء على نطاقاته وميزاته الحالية:

features:
  slash_commands:
    - command: /kazma
      description: Run a Kazma command
      usage_hint: help | x help | ide help | documents list
      should_escape: false
settings:
  socket_mode_enabled: true

احفظ البيان، وأعد تثبيت التطبيق إذا طلب Slack ذلك، وأبقِ رمز البوت ورمز Socket Mode على مستوى التطبيق مضبوطين في كاظمه. لا تمنح هذه الرموز حقوق تعديل بيان التطبيق. ونجاح اختبار الموصل في تفعيل المستقبل لا يثبت تثبيت هذا البيان الخارجي. جرّب /kazma help في مساحة وقناة مسموحتين بمستخدم مسموح.

يُقرّ باستلام الأغلفة الأصلية سريعًا، وتُزال تكراراتها، وتُفحص مقابل قوائم الفِرق والقنوات والمستخدمين المسموحين. يستخدم الرد المؤجّل عنوان الاستجابة الخاص الذي يوفّره Slack. ولا تقبل كاظمه إلا نقاط أوامر HTTPS التابعة لـSlack.

حدود التسليم

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

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

يمكن لردود Discord الأصلية رفع ملفات خاصة حتى 8 MiB. ولا تستطيع عناوين استجابة Slack رفع بايتات ملفات خاصة: توضّح كاظمه هذا الحد في الرد الخاص وتسجّل إخفاق التسليم. استخدم دردشة الويب أو أمرًا برسالة عادية لملفات Slack؛ ولا ترفعها كاظمه إلى قناة عامة كبديل.

يستخدم الإكمال التلقائي على الويب دليل القدرات نفسه. توفّر /x و/model و/documents و/kb و/ide روابط إلى صفحات إدارتها على الويب؛ ولا تُعامل أوامر البوابة الفرعية بصمت كتعليمات للنموذج. تعيد الأوامر غير المدعومة المساعدة.

مراجع البروتوكول: تفاعلات Discord، أوامر Slack المائلة.