Wikipédia:Salebot
Un article de Wikipédia, l'encyclopédie libre.
Vous avez de 
| Pages anti-vandalisme de Wikipédia |
|---|
| Définition du vandalisme |
| Que faire en cas de vandalisme ? |
| Vandalisme en cours |
| Pages souvent vandalisées |
| Outils anti-vandalisme |
| Vandal Fighter |
| Salebot |
Cette page décrit le fonctionnement de Salebot. Pour signaler les bugs et faire des suggestions, vous pouvez utiliser la page de discussion.
Sommaire |
[modifier] Présentation
Salebot est un bot qui facilite la lutte contre le vandalisme. Son code est dérivé de CVUBot/pgkbot.
Il fonctionne sur le canal IRC #vandalism-fr-wp de Freenode.
Salebot lit les modifications récentes via IRC (#fr.wikipedia), les analyse, et envoie des alertes en temps réel pour les modifications suspectes.
Salebot n'interagit pas directement avec Wikipédia : il ne lit pas lui-même les pages de fr.wikipedia.org, et ne les modifie pas non plus.
Les seules données dont dispose automatiquement le bot sont celles qui sont envoyées sur le canal IRC des modifications récentes : nom de l'utilisateur et de l'article, modification de la taille de l'article, commentaires. Plusieurs listes sont disponibles afin d'affiner le mécanisme de détection du bot ; ces listes sont modifiées par les opérateurs du bot.
D'autres bots utilisant le même code sont souvent en veille sur le canal IRC, en cas de défaillance de Salebot.
[modifier] Les listes
Salebot sait gérer des listes d'utilisateurs :
- liste blanche : utilisateurs dont les modifications n'entraînent jamais d'alerte ;
- liste noire : utilisateurs dont les modifications entraînent toujours une alerte ;
- liste grise : nouveaux utilisateurs, ou utilisateurs dont une modification a été récemment révoquée, pour lesquels les modifications suivantes entraînent une alerte pour une période donnée ;
ainsi que des listes d'articles :
- liste d'articles à surveiller ;
- liste d'articles à ignorer ;
- liste d'images à surveiller ;
et des listes de mots :
- liste de mots à surveiller dans les noms de nouveaux utilisateurs ;
- liste de mots à surveiller dans les noms de nouveaux articles.
Des commandes envoyées au bot sur IRC permettent d'ajouter ou d'enlever des noms dans ces différentes listes.
[modifier] Contrôle des bots
Pour pouvoir envoyer des commandes aux bots, il faut soit avoir les droits de sysop sur le canal, soit être dans la liste des opérateurs du bot (liste aclo).
Un bot ne répond pas aux commandes des utilisateurs non reconnus. N'importe qui peut envoyer la commande : salebot status.
Pour envoyer une commande à tous les bots, il faut utiliser le pseudonyme bot au lieu du nick d'un bot.
[modifier] Commandes usuelles
Le plus souvent, il s'agit d'indiquer aux bots les utilisateurs à mettre sur liste blanche ou liste noire.
- Pour rajouter un utilisateur sur liste blanche :
bot wl add nom_utilisateur
- Pour rajouter un utilisateur sur liste noire :
bot bl add nom_utilisateur r=raison
Raison est n'importe quelle chaîne de caractères.
- Pour rajouter temporairement un utilisateur sur liste noire :
bot bl add nom_utilisateur x=durée r=raison
La durée est exprimée en heures.
[modifier] En cas de problème
Si un bot ne parle pas, il est peut-être en mode silencieux, ou son canal de lecture ne fonctionne plus.
La commande :
bot status
donne le statut de tous les bots qui sont en mode « bavard ».
La commande :
salebot status
donne le statut d'un bot donné, même s'il est « silencieux ».
Le message envoyé par le bot est de la forme :
<salebot> Mode bavard, réglé par le 16:34:34 22-Sep-2006 UTC <salebot> Lecteur de modifications récentes connecté, dernière modification reçue il y a 11.9069240093 secondes, de type rcEdit
Si le bot est en mode silencieux, la commande :
salebot speak
lui demande de devenir bavard.
Si le canal de lecture est bloqué (dernière modification reçue depuis longtemps), la commande :
salebot reader reset
fait redémarrer le canal de lecture.
[modifier] Toutes les commandes
Une aide en ligne est également disponible en tapant :
salebot help
[modifier] Using commands
Commands are issued to the bot by appending their name or "computer" to the beginning of the line. If you append the name, the command will only be recognized by the bot named. If you append "computer", all bots present will recognize the command. For example, if you want to add a user to pgkbot's blacklist, you would say pgkbot bl add username. Alternately, you could add the user to the blacklist of every bot in the channel. This is recommended, as it synchronises the backup bots. To do this, you would say computer bl add username.
Which commands a user can issue depends on which list they are in.
| Level | Users | List of commands |
|---|---|---|
| Information | Any user | intelligence commands; help. |
| Operation | Voiced users | watchlist; intelligence; help, status, quiet, speak. |
| Restricted | Channel operators | all commands. |
[modifier] Lists of users
The bots maintain several lists of users, which can be reported, formatted, and treated differently from each other.
- Whitelist: this is the list of trusted users. The relevant command is
computer wl add|del username. - Greylist: this is a temporary blacklist which the bot automatically populates with users that have recently been reverted, or matched one of the bnu list expression. This list cannot be modified by users.
- Blacklist: this is a list of suspicious users. All edits by blacklisted users are reported. The relevant command is
computer bl add|del username.
[modifier] Reference table
This table is a quick overview of commands. For additional help, address the following command to pgkbot on IRC: pgkbot help <command>. There are two optional flags which can be used with most commands. These can be used by appending them to the end of the command (expiry must be stated before the reason, if both are used).
- "
r=value" provides a reason. This is useful for other users, who may not know why something has been added to the list without. - "
x=value" provides an expiry time in hours. After the specified number of hours, the command will be automatically undone.
Note that the symbols "[|]" are used in the table; these symbols should not be used with the bot (for example, use "pgk add blah" and not "pgk [add] blah"). Multiple possible actions are denoted as [option 1|option 2]; only one can be used at a time. Values are designated as <value>; all strings accept regex.
[modifier] Restricted bot commands
| Command | Usage | Description |
|---|---|---|
| config (set) | computer config <option> <newvalue> | "Configuration"; modifies the configuration values. See in-depth documentation below. |
| config (list) | computer config list | List current settings |
| config (get) | computer config [getadmins|getbots] | Retrieve the list of admins or bots direct from the wiki being monitored |
| config (read) | computer config [readmsgs|readcmds] | Reread some configuration files. |
| dest (set) | computer dest [add|del] #<channel name> grey | "Destination"; configure the events to report to the channel. |
| dest (swap) | computer dest swap #<channel name> #<second channel name> | Switch the events reported between two channels, useful for changing to preset settings. |
| reader | computer reader reset | Reset the connection to the recent changes channel (if the bot stops reporting). |
[modifier] Bot- and channel-related commands
| Command | Usage | Description |
|---|---|---|
| help | computer help <command> | Provides detailed help on a command. If a command is not specified, it will provide a link to this page. |
| status | computer status | Provides basic status information about the bot, such as whether it is reporting and connected to the RC feed. |
| stats | computer stats | Miscellaneous channel statistics. |
| quiet | computer quiet | Stop reporting event to the channel. |
| speak | computer speak | Report events to the channel. |
[modifier] Watchlist commands
| Command | Usage | Description |
|---|---|---|
| bl | computer bl [add|del|show] <IP or username> | "Blacklist"; a list of distrusted or vandal users. |
| wl | computer wl [add|del|show] <username> | "Whitelist"; a list of trusted users. These users can issue commands to the bot. |
| al | computer al [add|del|show] <username> | "Administrator list"; a list of administrators. |
| bot | computer bot [add|del|show] <username> | A list of bots. |
| bnu | computer bnu [add|del|show] <string> | "Bad new user"; report all new usernames containing the string. |
| bna | computer bna [add|del|show] <string> | "Bad new article"; report all new articles created containing the string. |
| cvp | computer cvp [add|del|show] <string> | "Commonly vandalised page"; report all edits to a given article. |
| cnvp | computer cnvp [add|del|show] <article name> | "Commonly non-vandalised pages"; a list of articles to be ignored. |
| cvi | computer cvi [add|del|show] <image name>.<extension> | "Commonly vandalised images"; report all uploads to a particular image name. |
| wheels | computer wheels [add|del|show] <string> | "Willy on Wheels"; report pages renamed to a title containing the string. |
[modifier] Intelligence commands
| Command | Usage | Description |
|---|---|---|
| intel | computer intel <IP or username> | "Intelligence"; queries information about an IP or username. |
| aintel | computer aintel <article name> | "Article intelligence"; queries information about an article. |
| iintel | computer iintel <image name>.<extension> | "Image intelligence"; queries information about an image. |
[modifier] Détails de fonctionnement
Salebot est écrit en Python et utilise la bibliothèque Twisted. Il tourne sur le toolserver de Wikimedia Deutschland.
[modifier] Mises à jour
- 2 juin 2006 : Salebot tourne maintenant sur le toolserver
- 4 juin 2006 : le problème de blocage de la base de données n'est toujours pas résolu, mais j'ai rajouté un script de redémarrage automatique dans ce cas
- 11 juin 2006 : problème résolu
- 25 juin 2006 : mise à jour, mise sur greylist des nouveaux comptes, ligne d'explication après modifs de greylistés/blacklistés
- 17 septembre 2006 : version 1.5 et déplacement du bot sur hemlock, le nouveau toolserver
