توثيق IRC · متقدم
التفاوض على القدرات باستخدام CAP
يتيح تفاوض CAP اختيار الامتدادات التي يعرف العميل معالجتها. قائمة الخادم عرض للمتاح، وليست تفعيلًا تلقائيًا. وتظل إدارة حالات الاتصال بدقة ضرورية، خصوصًا مع SASL أو قائمة قدرات موزعة على عدة رسائل.
فريق Dialova · تم التحقق في
اكتشاف القائمة كاملة #
يطلب CAP LS 302 الإعلان الحديث. قد يرسل الخادم عدة أسطر، ويشير المعامل * بعد LS إلى أن سطرًا آخر سيأتي. اجمع القائمة قبل اتخاذ القرار. تصف قيمة مثل sasl=PLAIN,EXTERNAL الآليات، لكن اسم القدرة المطلوب يظل sasl.
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS * :message-tags server-time
S: :irc.example CAP * LS :batch sasl=PLAIN,EXTERNALفعّل ما يستطيع العميل معالجته فقط #
يختار العميل قائمة ويرسل CAP REQ. يؤكد ACK التفعيل، بينما يرفض NAK الطلب. لا تعتبر القدرة المعلن عنها نشطة لمجرد ظهورها. ولا تنسخ قيم LS إلى REQ دون فهمها.
C: CAP REQ :server-time sasl
S: :irc.example CAP Alice ACK :server-time saslأثناء التسجيل، يعلق CAP إكماله. نفّذ المصادقة المطلوبة ثم أرسل CAP END للسماح بمتابعة التسجيل. يجب ألا تعرض الواجهة حالة «متصل» لمجرد فتح مقبس TLS.
بعد التسجيل وعند تغير القدرات #
يعرض CAP LIST القدرات النشطة. ويمكن استخدام CAP REQ بعد التسجيل أيضًا. تنتمي إشعارات CAP NEW وCAP DEL إلى آلية cap-notify؛ فقد يؤدي تعطل خدمة إلى تغيير ما يتيحه الخادم. يجب أن يحدث العميل حالته، لا أن يواصل العمل وكأن القدرة المسحوبة ما زالت متاحة.
يمكن للعميل توفير مسار اتصال تقليدي مع خادم قديم لا يفهم CAP. لكن إذا اشترطت السياسة المصادقة قبل الوصول، فليس الانتقال بصمت إلى اتصال دون تلك الحماية حلًا مقبولًا.
مثال عملي على أثر التفاوض #
على Ergo، قد يؤدي التفاوض على الاسترجاع الصريح للسجل إلى تعطيل الإرسال التلقائي للرسائل الفائتة. لذلك يجب على العميل الذي يطلب هذه القدرة تنفيذ الاسترجاع المتوقع، لا مجرد التعرف إلى اسمها. ويحتفظ Dialova بعد ذلك بمحادثاته الخاصة عبر الويب في سجله الخاص، إذ تظل مسؤوليات الخادم والتطبيق منفصلة.
المصادر والتحقق
تستخدم الأمثلة أسماء مستعارة ونطاقات خيالية، باستثناء نقاط الاتصال الموثقة صراحةً. ويوضح النص الإضافات والإعدادات الخاصة بكل شبكة.
- IRCv3 — التفاوض على قدرات العميل ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29
- Ergo — التعريف الرسمي ↗مصدر رسمي · تاريخ الاطلاع 2026-10-29
- IRCv3 — chathistory، مواصفة قيد التطوير ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29