توثيق IRC · متقدم
أمر CAP: عرض الامتدادات والتفاوض بشأنها
CAP هو أمر التفاوض على امتدادات IRC. يتيح للعميل تفعيل الآليات التي يدعمها. يشرح دليل IRCv3 CAP مراحل التفاوض بالتفصيل، بينما تقدم هذه الصفحة الصيغة التي تتعرف إليها في السجل.
فريق Dialova · تم التحقق في
الصيغة والمعاملات #
CAP <LS [302] | LIST | REQ :<إمكانات> | END>| المعامل | المعنى |
|---|---|
| LS 302 | طلب القائمة بآلية الإعلان الحديثة، بما فيها القيم والردود التي قد تمتد على عدة رسائل. |
| REQ | طلب تفعيل القدرات المختارة. ويجيب ACK أو NAK عن الطلب. |
| LIST / END | يعرض LIST القدرات النشطة، وينهي END تعليق إكمال التسجيل. |
مثال مع الشرح #
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP ENDالأسماء المستعارة وعناوين المضيفين والنصوص في هذا المثال افتراضية. قد يعرض البرنامج الردود بصورة أسهل للقراءة من إطارات البروتوكول المعروضة هنا.
الردود والأخطاء المحتملة #
| الرد | دلالته |
|---|---|
| CAP LS | القائمة المتاحة. تشير العلامة * الوسطية إلى أن القائمة ستتواصل في رسالة أخرى. |
| CAP ACK / NAK | قبول التفعيل أو رفض الطلب. |
| CAP LIST | قائمة القدرات النشطة. |
| الخطأ | السبب المعتاد |
|---|---|
| 410 | أمر CAP الفرعي غير صالح، بحسب التنفيذ. |
| 421 | خادم قديم لا يتعرف إلى CAP. |
الصلاحيات والتوافق والاحتياطات #
لا يفعّل إعلان LS أي شيء. يجب ألا يستخدم العميل قدرة إلا بعد تفعيلها. ولا يرسل CAP END رسالة إلى غرفة، بل هو خطوة من خطوات الاتصال.
يمكن استخدام CAP بعد التسجيل أيضًا. لكن يجب تفسير الأوامر الفرعية والإصدار المعلن وإشعارات NEW وDEL وفق المواصفة. قيمة القدرة، مثل sasl=PLAIN، ليست اسم القدرة نفسه.
أسئلة شائعة #
لماذا يظهر CAP دون /؟ نتحدث هنا عن البروتوكول، وتتولى الواجهة إدارة الأمر داخليًا.
هل يؤدي CAP و005 ISUPPORT الوظيفة نفسها؟ لا، يصف ISUPPORT خصائص وحدودًا، بينما يفعّل CAP امتدادات يتم التفاوض عليها.
المصادر والتحقق
تستخدم الأمثلة أسماء مستعارة ونطاقات خيالية، باستثناء نقاط الاتصال الموثقة صراحةً. ويوضح النص الإضافات والإعدادات الخاصة بكل شبكة.
- Modern IRC — مواصفة بروتوكول العميل ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29
- IRCv3 — التفاوض على قدرات العميل ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29