rboot
est un framework de chatbot simple et efficace écrit en golang
, facile à étendre. Il peut fonctionner sur différents services de chat et peut implémenter聊天
,工作助手
,服务监控
,警报触发
et d'autres fonctions via des scripts étendus.
golang v1.13+
$ go get github.com/ghaoo/ rboot
$ cd $GOPATH /github.com/ghaoo/ rboot /robot
$ go build
$ ./robot
L'adaptateur de message est utilisé pour surveiller les messages entrants et sortants. Grâce à l'adaptateur de message, les messages du client de discussion peuvent être envoyés au robot. Après avoir été traités par le script, le message renvoyé est envoyé au client.
rboot
fournit une implémentation simple de命令行cli
微信网页版
en ligne de commande企业微信
adaptateur倍洽
d'entreprise WeChat钉钉
.
Plugin
ne fournit pas beaucoup de plug-ins prêts à l'emploi, à l'exception d'un plug-in help
, et les autres doivent être développés par les développeurs en fonction de leurs propres besoins.
utilisation du plugin d'aide :
!help <plugin>
: Afficher les informations d'aide du plug-in Lorsque la commande n'inclut pas de nom de plug-in, toutes les informations d'aide du plug-in seront répertoriées avec un nom de plug-in, seules les informations d'aide pour ce plug-in. dans sera répertorié.
Il existe des cas de plug-ins simples dans le dossier
robot/plugins
. Les développeurs peuvent vérifier comment écrire des plug-ins.
Plugin
peut non seulement utiliser Golang pour écrire des plug-ins, mais également utiliser des plug-ins de script pour exécuter des commandes système ou des fichiers de plug-in écrits dans des langages de script.
Le plug-in de script est un plug-in Plugin
utilisé pour analyser les langages de script. Il s'agit d'une extension du plug-in rboot . Exécutez des commandes système ou des scripts via les fichiers de configuration yaml
.
Étant donné que les plug-ins de script sont construits sur
Plugin
, chaque script sera enregistré dansPlugin
, alors assurez-vous que les noms des plug-ins ne se chevauchent pas, sinon le plug-in enregistré en premier pourrait être remplacé par le plug-in enregistré plus tard !
PLUGIN_DIR
: Le dossier dans lequel le fichier de configuration du plug-in de script est stocké. S'il n'est pas configuré, la valeur par défaut est scripts
Nous pouvons créer un plug-in de script en créant un fichier yaml
et configurer le plug-in de script via les options de configuration du fichier. Par exemple, nous créons un fichier hello.yml
avec le contenu suivant :
name : hello
version : 0.1.0
ruleset :
hello : " ^hello "
usage :
hi : echo hello world and 你好
description : 脚本插件示例
command :
-
cmd :
- echo hi
- echo hello world
-
dir : plugins
cmd :
- echo 你好
Ce plug-in utilise la commande système echo
. Cela signifie que lorsque nous entrons "hello", le script renverra trois messages : hi
, hello world
et你好
.
La signification de chaque champ dans la configuration :
Configuration | doit | importance |
---|---|---|
nom | Oui | Nom du plugin |
ensemble de règles | Oui | ensemble de règles |
version | Non | Version du plugin |
usage | Non | Utilisation du plug-in |
description | Non | Présentation du plug-in |
commande | Oui | Ensemble de commandes de plug-in |
--- | --- | --- |
dir | Non | Dossier d'exécution des commandes |
cmd | Oui | Commandes du plugin |
command
peut configurer plusieurs jeux de commandes et l'ordre d'exécution est de haut en bas.
cmd
peut être configuré avec plusieurs commandes et l'ordre d'exécution est de haut en bas.
Les plug-ins de script prennent en charge系统命令
et脚本语言
. Le mode de commande système est comme hello.yml
ci-dessus. Remplissez simplement le dossier et la commande système dans le fichier. Lorsque vous émettez la commande, le robot l'exécutera dans l'ordre de haut en bas.
Le langage de script est une méthode d'exécution basée sur le mode de commande système. Nous pouvons utiliser des commandes système pour appeler des scripts de langage afin d'exécuter des scripts plus complexes. Par exemple, nous utilisons Python pour afficher "hello robot".
Notre script python est le suivant :
#!/usr/bin/env python
print ( "Hello, robot! i am a python script" )
Notre fichier de configuration est le suivant :
name : pyscript
version : 0.1.0
ruleset :
py : " ^hello python "
usage :
py : execute python script
description : python插件示例
command :
dir : script
cmd :
- ./hello.py
Lorsque nous entrons hello python
, le robot appellera le script hello.py
, et le script affichera "Bonjour robot ! Je suis un script python" et nous l'affichera via le robot.
Veuillez confirmer si
目录分隔符
correspond aux paramètres système actuels sous différents systèmes d'exploitation. Veuillez l'utiliser souswindows
Veuillez utiliser
/
sousunix
Ce projet utilise la licence open source MIT et les instructions complètes de licence se trouvent dans le fichier LICENSE.