İçeriğe geç
Dialova

IRC belgeleri · Orta

IRC botlarının işleyişi ve tasarımı

IRC botu, istemci gibi ağa bağlanan programdır. Olayları dinleyebilir, komutlara yanıt verebilir veya kanala etkinlik katabilir. Güvenilirliği özellikle protokolü, yetkileri ve gönderim hızını doğru yönetmesine bağlıdır.

Dialova ekibi · Kontrol tarihi

Botun çalışma döngüsü #

  1. TLS bağlantısı açıp sertifikayı doğrulayın.
  2. CAP uzlaşması yapın; politika gerektiriyorsa hesabı doğrulayın.
  3. IRC kimliğini bildirin ve kaydın tamamlanmasını bekleyin.
  4. İzin verilen kanallara katılıp mesajları, hataları ve olayları işleyin.
  5. PING’e yanıt verin, gönderimleri sınırlayın ve aşamalı yeniden bağlanma planlayın.
Kaydı tamamlanmış ve yetkilendirilmiş oturumdan kesit
S: PING :jeton-123
C: PONG :jeton-123
S: :Alice!alice@cloak.example PRIVMSG #atelier :!bonjour
C: PRIVMSG #atelier :Merhaba Alice!

Bu kesit akışı gösterir; çalıştırılacak tam program değildir. Her ağ okumasında tam satır geldiğini varsaymak yerine bakımı sürdürülen IRC kütüphanesi taşıma ve sözdizimini yönetebilir.

Protokolü, kuralları ve işlemleri ayırın #

BölümSorumluluk
Taşıma ve ayrıştırıcıTLS, baytlar, CRLF, parçalı mesajlar, sınırlar.
IRC durumuKayıt, yetenekler, kanallar, kimlik ve değişiklikler.
Bot mantığıİsteği tanıyıp koşullarını kontrol etmek ve işlem niyeti oluşturmak.
Çıkış kuyruğuHızı sınırlamak, sırayı korumak ve yeniden bağlantıda yinelenen gönderimi önlemek.

Yalnızca takma ada güvenmeyin #

Katılımcı takma ad değiştirebilir veya bir sözdizimini taklit edebilir. Hassas işlemde varsa sunucunun onayladığı kimliği kullanıp işlem yetkilerini kontrol edin. Yalnızca konuşabilmesi için oyun botuna operatör yetkisi vermeyin.

Alınan metinler güvenilmeyen girdilerdir; bunları kabuğa, birleştirilerek oluşturulan sorguya veya kod çalıştırıcıya aktarmayın. Bağlantı sırları depoda veya bot yanıtında değil, özel yapılandırmada kalmalıdır.

Flood ve döngüleri önleyin #

Sınırları ağ belirler; evrensel güvenli gönderim hızı yoktur. Hatalara tepki verin, anlamlıysa çıktıları birleştirin, kullanıcı ve kanal başına işlemleri sınırlayın. Yeniden bağlantı anlık döngü yerine artan bekleme süresi kullanmalıdır.

NOTICE’a otomatik yanıt vermeyin ve geçmiş yeniden oynatılırken eski kullanıcı komutunu yürütmeyin. echo-message ile kendi çıktınız geri gelebilir; bunu gelen isteklerden ayırın.

Dialova’da Bobot #

Bobot özellikle Dialova oda oyunlarını yönetir. Sitenin grafik oyunlarından ve üye hesaplarından ayrıdır. Bu örnek, otomatik istemcinin özel bir sohbet protokolü gerektirmeden topluluğa katkı sağlayabileceğini gösterir.

Kaynaklar ve doğrulama

Açıkça belgelenen bağlantı adresleri dışında örneklerde kurgusal takma adlar ve alan adları kullanılır. Ağa özgü uzantılar ve ayarlar metinde belirtilir.