Przejdź do treści
Dialova

Dokumentacja IRC · Zaawansowany

Message tags: metadane wiadomości IRC

Znaczniki wiadomości dodają metadane przed pozostałą częścią wiadomości IRC. Mogą zawierać czas, konto lub odwołanie do pakietu. Interfejs może pominąć nieznany znacznik, ale jego format nadal trzeba poprawnie przeanalizować.

Zespół Dialovy · Sprawdzono

Odczytywanie obszaru znaczników #

Wiadomość serwera z dwoma znacznikami
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjour

Obszar zaczyna się od @ i kończy na pierwszej spacji bez poprzedzającej sekwencji ucieczki. Znaczniki rozdziela średnik. Po każdej nazwie może wystąpić wartość po =. Kolejność nie ma znaczenia, a wielkość liter w nazwach jest istotna. Najpierw wydziel ten obszar, dopiero potem rozdzielaj parametry wiadomości.

Dekodowanie wartości tylko raz #

Sekwencja w protokoleOdczytana wartość
\:Średnik
\sSpacja
\\Ukośnik odwrotny
\rPowrót karetki
\nNowa linia

Sekwencje ucieczki dotyczą wartości znacznika, nie całego tekstu wiadomości. Wartości są kodowane w UTF-8. Pusta wartość i brak wartości są w tym mechanizmie równoważne; interfejs nie powinien dopisywać im odmiennego znaczenia.

Możliwość ogólna i wyspecjalizowane rozszerzenia #

message-tags ogłasza obsługę pełnego formatu i umożliwia między innymi znaczniki klienta oraz TAGMSG. Rozszerzenia server-time, account-tag i batch również opierają się na formacie znaczników, ale ich negocjowanie należy odróżniać od negocjowania ogólnej możliwości.

Fikcyjny znacznik klienta bez zakładanego działania
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=czesc\stutaj TAGMSG #atelier

Prefiks + oznacza znacznik klienta. Nie zamienia deklaracji klienta w informację potwierdzoną przez serwer. Konto ogłoszone przez serwer i dowolny tekst wysłany przez uczestnika muszą pozostać rozróżnione.

Ograniczone metadane, nie nieskończone wiadomości #

Znaczniki mają limit rozmiaru odrębny od historycznej części wiadomości. Ich obecność nie oznacza nieograniczonej długości PRIVMSG. Nieznane znaczniki, nieprawidłowe sekwencje i powtórzone nazwy obsługuj według specyfikacji; unikaj parsera odrzucającego każde rozszerzenie lub przechowującego bez końca nieograniczone dane.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.