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

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

Как устроить надёжного IRC-бота

IRC-бот — программа, подключённая к сети как клиент. Он может отслеживать события, отвечать на команды и проводить игры в комнате. Надёжность зависит прежде всего от обработки протокола, прав и темпа отправки.

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

Жизненный цикл бота #

  1. Открыть TLS-соединение и проверить сертификат.
  2. Согласовать CAP и аутентифицировать запись, если этого требует политика.
  3. Объявить данные IRC и дождаться завершения регистрации подключения.
  4. Войти в разрешённые комнаты и обрабатывать сообщения, ошибки и события.
  5. Отвечать на PING, ограничивать отправку и постепенно увеличивать задержку переподключения.
Фрагмент уже зарегистрированного подключения с необходимыми правами
S: PING :jeton-123
C: PONG :jeton-123
S: :Alice!alice@cloak.example PRIVMSG #atelier :!bonjour
C: PRIVMSG #atelier :Привет, Alice!

Пример показывает обмен, а не готовую программу. Поддерживаемая библиотека IRC может обрабатывать транспорт и грамматику вместо наивного чтения, предполагающего получение полной строки при каждом сетевом вызове.

Разделить протокол, правила и действия #

ЧастьОтветственность
Транспорт и парсерTLS, байты, CRLF, неполные сообщения, ограничения.
Состояние IRCРегистрация, возможности, комнаты, идентификация и изменения.
Логика ботаРаспознать запрос, проверить условия и сформировать намерение.
Очередь отправкиОграничить частоту, сохранить порядок и избежать повторной массовой отправки при восстановлении.

Не доверять одному лишь нику #

Участник может сменить ник или имитировать синтаксис. Для важных действий используйте подтверждённую сервером идентификацию, если доступна, и проверяйте разрешения на конкретную операцию. Игровому боту не нужны права оператора только ради отправки сообщений.

Полученный текст — недоверенный ввод. Не передавайте его в оболочку, запрос с конкатенацией или исполнитель кода. Секреты подключения хранятся в закрытой конфигурации, а не в репозитории и не в ответах бота.

Избегать флуда и зацикливания #

Ограничения задаёт сеть: универсально безопасной частоты отправки нет. Обрабатывайте ошибки, объединяйте вывод, где уместно, ограничивайте действия по участнику и комнате. При восстановлении используйте нарастающую задержку вместо мгновенного цикла.

Не отвечайте автоматически на NOTICE и не выполняйте старые команды при воспроизведении истории. С echo-message собственный вывод может вернуться: отличайте его от входящих запросов.

Bobot на Dialova #

Bobot, в частности, проводит игры в комнатах Dialova. Он отличается от графических игр сайта и учётных записей участников. Это пример того, как автоматизированный клиент дополняет сообщество без собственного закрытого протокола общения.

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

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