Документация IRC · Продвинутый
Message tags: метаданные сообщений 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