Przejdź do treści
Dialova

Dokumentacja IRC · Średnio zaawansowany

Jak działa bot IRC i jak go zaprojektować

Bot IRC to program połączony z siecią jak klient. Może nasłuchiwać zdarzeń, odpowiadać na polecenia i prowadzić zabawy na kanale. Jego niezawodność zależy przede wszystkim od obsługi protokołu, uprawnień i tempa wysyłania.

Zespół Dialovy · Sprawdzono

Cykl pracy bota #

  1. Otwórz połączenie TLS i sprawdź certyfikat.
  2. Wynegocjuj CAP, a następnie uwierzytelnij konto, jeśli wymagają tego zasady.
  3. Podaj tożsamość IRC i czekaj na zakończenie rejestracji połączenia.
  4. Dołącz do dozwolonych kanałów i obsługuj wiadomości, błędy oraz zdarzenia.
  5. Odpowiadaj na PING, ograniczaj wysyłanie i zaplanuj ponowne łączenie z rosnącym opóźnieniem.
Fragment już zarejestrowanej i uprawnionej sesji
S: PING :jeton-123
C: PONG :jeton-123
S: :Alice!alice@cloak.example PRIVMSG #atelier :!bonjour
C: PRIVMSG #atelier :Cześć Alice!

Fragment pokazuje przepływ, a nie gotowy program do uruchomienia. Rozwijana biblioteka IRC może obsługiwać transport i składnię zamiast zakładania, że każde wywołanie odczytu sieciowego zwraca pełną linię.

Oddziel protokół, zasady i działania #

CzęśćOdpowiedzialność
Transport i parserTLS, bajty, CRLF, fragmenty wiadomości, limity.
Stan IRCRejestracja, możliwości, kanały, tożsamość i zmiany.
Logika botaRozpoznanie żądania, sprawdzenie warunków i określenie zamierzonego działania.
Kolejka wyjściowaOgraniczanie szybkości, zachowanie kolejności i unikanie powtarzania wysyłki po ponownym połączeniu.

Nie ufaj samemu nickowi #

Uczestnik może zmienić nick lub naśladować składnię. Przy wrażliwym działaniu korzystaj z tożsamości potwierdzonej przez serwer, jeśli jest dostępna, a następnie sprawdź uprawnienia do danej czynności. Nie nadawaj botowi gry uprawnień operatora tylko po to, żeby mógł pisać.

Odebrane teksty są niezaufanymi danymi wejściowymi: nie przekazuj ich do powłoki, zapytania tworzonego przez łączenie ciągów ani wykonawcy kodu. Sekrety połączenia przechowuj w prywatnej konfiguracji, nie w repozytorium ani odpowiedzi bota.

Unikaj floodu i pętli #

Limity ustala sieć: nie ma jednego tempa wysyłania bezpiecznego wszędzie. Reaguj na błędy, grupuj odpowiedzi tam, gdzie ma to sens, i ograniczaj działania na użytkownika oraz kanał. Ponowne łączenie powinno mieć rosnące opóźnienie zamiast natychmiastowej pętli.

Nie odpowiadaj automatycznie na NOTICE i nie wykonuj dawnego polecenia użytkownika podczas odtwarzania historii. Przy echo-message własna odpowiedź może wrócić: odróżniaj ją od nowych żądań.

Bobot na Dialovie #

Bobot prowadzi między innymi gry w pokojach Dialovy. Jest odrębny od graficznych gier serwisu i kont użytkowników. Pokazuje, że automatyczny klient może wzbogacać społeczność bez wymagania własnościowego protokołu rozmów.

Ź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.