Перейти к содержимому
Dialova

Документация IRC · Продвинутый

Согласование возможностей через CAP

Согласование CAP позволяет выбрать расширения, которые клиент умеет обрабатывать. Список сервера — предложение, а не автоматическое включение. Корректное управление состояниями особенно важно при SASL и получении списка частями.

Команда Dialova · Проверено

Получить полный список #

CAP LS 302 запрашивает современное объявление. Сервер может ответить несколькими строками; параметр * после LS означает продолжение. Соберите список целиком перед выбором. Значение sasl=PLAIN,EXTERNAL описывает механизмы, но запрашиваемое имя остаётся sasl.

Обмен IRC: C — клиент, S — сервер
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.

Обмен IRC: C — клиент, S — сервер
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 отдельно сохраняет личные веб-беседы в собственной истории: ответственность сервера и приложения различается.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.