توثيق IRC · متقدم
وسوم الرسائل: البيانات الوصفية في IRC
تضيف وسوم الرسائل بيانات وصفية قبل بقية رسالة IRC. وقد تحمل وقتًا أو حسابًا أو مرجع دفعة. يمكن تجاهل وسم غير معروف في العرض، لكن يجب تحليل صيغته بطريقة صحيحة.
فريق Dialova · تم التحقق في
قراءة منطقة الوسوم #
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjourتبدأ المنطقة بعلامة @ وتنتهي عند أول مسافة غير محمية بمحرف إفلات. تفصل ; بين الوسوم، ويمكن أن يتبع كل مفتاح قيمة بعد =. لا يحمل ترتيبها معنى، وتميز المفاتيح بين حالة الأحرف. لا تفصل معاملات الرسالة قبل عزل هذه المنطقة.
فك ترميز القيم مرة واحدة #
| التسلسل في البروتوكول | القيمة بعد فك الترميز |
|---|---|
| \: | فاصلة منقوطة |
| \s | مسافة |
| \\ | شرطة مائلة عكسية |
| \r | عودة إلى بداية السطر |
| \n | سطر جديد |
تخص محارف الإفلات قيمة الوسم، لا نص الرسالة كله. تستخدم قيم الوسوم UTF-8. وتعادل القيمة الفارغة غياب القيمة في هذه الآلية، فلا ينبغي للواجهة اختلاق فرق في المعنى.
القدرة العامة والامتدادات المتخصصة #
تعلن message-tags دعم الصيغة الكاملة، وتتيح خصوصًا الوسوم الخاصة بالعملاء وTAGMSG. وتعتمد امتدادات مثل server-time وaccount-tag وbatch على صيغة الوسوم أيضًا، دون أن يعني ذلك دمج تفاوضها مع تفاوض القدرة العامة.
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=مرحبًا\sهنا TAGMSG #atelierتشير البادئة + إلى وسم عميل. ولا تحول ادعاء العميل إلى معلومة يشهد بصحتها الخادم. يجب التمييز بين حساب يعلنه الخادم ونص عشوائي يرسله مشارك.
بيانات وصفية محدودة الحجم، لا رسائل بلا حدود #
للوسوم حد حجم مستقل عن الجزء التقليدي من الرسالة. ولا يجعل وجودها نص PRIVMSG غير محدود. تُعالج الوسوم المجهولة والتسلسلات غير الصالحة والمفاتيح المكررة وفق المواصفة. تجنب محللًا يرفض أي تطور أو يحتفظ ببيانات غير محدودة إلى أجل غير مسمى.
المصادر والتحقق
تستخدم الأمثلة أسماء مستعارة ونطاقات خيالية، باستثناء نقاط الاتصال الموثقة صراحةً. ويوضح النص الإضافات والإعدادات الخاصة بكل شبكة.
- IRCv3 — وسوم الرسائل ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29
- IRCv3 — وسم وقت الخادم server-time ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29
- IRCv3 — وسم الحساب account-tag ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29
- IRCv3 — دفعات batch ↗مصدر للمواصفة · تاريخ الاطلاع 2026-10-29