Koishi Système commande
Après avoir appris les bases de l'utilisation de la console, nous pouvons enfin commencer à explorer comment dialoguer avec le robot ! Commençons par l'exemple que nous avons vu dans la section précédente :
La sortie ci-dessus concerne deux plugins :
La plupart des fonctionnalités d'un robot Koishi sont proposés via des commandes. Lorsque vous installez davantage de plugins, vous pouvez utiliser à plus de commandes.
Afficher l'aide
La commande « help » accepte un paramètre optionnel pour afficher des informations d'aide pour une commande spécifique :
Vous avez peut-être remarqué que la commande « help » est elle-même une commande. Vous vous demandez peut-être si vous pouvez utiliser « help » pour afficher des informations d'aide sur la commande « help ». La réponse est oui :
Arguments et options
在上面的用法中，我们接触到了两个新的概念：参数 (Argument) 和 选项 (Option)。
参数分为必选参数和可选参数，分别用尖括号 <> 和方括号 [] 表示。Une commande peut avoir un nombre quelconque d'arguments, et leur ordre est fixe. Les utilisateurs doivent saisir les arguments dans l'ordre spécifié par la commande. Les arguments obligatoires doivent apparaître avant les arguments facultatifs. Si les utilisateurs ne fournissent pas un nombre suffisant d'arguments obligatoires, le plugin génère généralement un message d'erreur. Les arguments supplémentaires fournis par les utilisateurs sont ignorés.
Par exemple, la commande « help » a un argument facultatif qui représente le nom de la commande à consulter. La commande « echo » a un argument obligatoire qui représente le message à envoyer. Voici ce qui se passe si l'utilisateur ne fournit pas l'argument obligatoire :
Les options contrôlent également le comportement d'une commande. 它通常以 - 或 -- 开头，后面不带空格地跟着一个固定的单词，称为选项名称。Les options n'ont pas d'ordre spécifique, mais il est généralement recommandé de les placer avant les arguments. Par exemple, nous pouvons essayer ceci :
在上面的例子中，我们使用了 -E 选项，成功改变了输出的内容。Nous expliquerons plus en détail comment cela fonctionne dans les sections suivantes.
Les arguments peuvent être également de longueur fixe ou variable. Les arguments de longueur fixe ne peuvent pas contenir d'espaces, tandis que les arguments de longueur variables le peuvent. 变长参数通过参数名前后的 ... 来指示，例如 echo 指令的参数就是一个变长参数。Si vous souhaitez saisir du contenu contenant des espaces pour un argument de longueur fixe, vous pouvez utiliser des guillemets pour l'encadrer, par exemple :
En outre, certaines options peuvent également accepter des arguments. Par exemple, si vous avez installé le plugin de traduction, voici ce que vous obtiendrez :
在这个例子中，-s 和 -t 都是带有参数的选项。我们使用 -t ja 来指定目标语言为日语，源语言仍然采用了默认行为。
Préfixe de déclenchement
Cependant, dans un canal de guilde, déclencher une commande avec un seul mot est très sujet aux erreurs. Pour éviter cette situation, Koishi introduit le concept de préfixe de déclenchement. 在「全局设置」中，我们提供了名为 prefix 和 nickname 的配置项。假如将 prefix 设置为 /，nickname 设置为 四季酱，则在群聊环境下只有以下信息可以触发指令调用：
Shiki, echo bonjour
@Shiki, echo bonjour
/echo bonjourEn d'autres termes, une commande peut être déclenchée si :
- 消息以
prefix开头，后面紧跟着指令调用 - 消息以
nickname开头，后面可以有逗号或空白字符，再后面是指令调用 - 消息以 @机器人 开头 (可以有多个
@，但至少一个是机器人账号)，后面是指令调用
Pour les guildes contenant un grand nombre de personnes ou plusieurs robots, nous vous recommandons fortement de configurer de préfixes de déclenchement différents pour chaque robot.En revanche, dans les canaux directs, il n'y aura pas de problème des erreurs de commande déclenchée, donc il n'y a les restrictions ci-dessus. Les commandes sans préfixes de déclenchement peuvent également être exécutés normalement.
TIP
关于 prefix 的几点提示：
prefix是一个列表，默认值为['']表示无需前缀也能触发；将列表清空会导致所有指令都无法通过prefix触发 (但仍然可以通过私聊或nickname或 @机器人 触发)- 如果你在
prefix中设置了多个值，例如['.', '/', '']，那么.,/或无前缀都能触发指令；但由于 Koishi 是按顺序匹配各个前缀的，因此空串''必须写在最后一个 - 可以为不同的会话设置不同的
prefix，具体请参考 过滤器 一节
sous-commande
admin 插件提供了名为 user 的指令，现在让我们调用一下：
这里出现了一个新的概念：子指令。子指令在调用上与普通的指令并没有区别，但它们将不会显示在 help 返回的全局指令列表中，而只会显示在父指令 user 的帮助信息中。这样设计的目的是为了避免指令列表过于冗长，同时也将指令以一种更清晰的方式进行了组织。
在上面的例子中，我们还能发现 Koishi 存在两种不同的子指令：一种是 层级式，例如 authorize；而另一种则是 派生式，例如 user.locale。后者跟前者的区别是，它的名称带有父指令的名称，以及一个小数点 .。在调用时，我们也需要加上这个小数点：
如果父指令本身没有功能，那么 user 和 user -h 的效果是一样的。此时，我们也可以使用空格代替小数点进行派生式子指令的调用：
熟悉 Git 的用户可能会发现，这种设计正是借鉴了 Git 的二级指令：当一个指令的功能过于复杂时，我们可以将其拆分为多个子指令，从而使得指令的功能更加清晰。
TIP
至于 user.locale 是干什么的，想必大家也已经猜出来了。我们留到 国际化 一节再详细介绍。
Gestion des commandes
打开控制台，我们会在活动栏中找到名为「指令管理」的页面。你可以在这里查看当前所有指令的列表，并对指令的行为进行设置。
设置别名
点进任意指令的详情页，首先就能看到「名称设置」，这里展示了指令的全部别名。每个别名都能被用来触发指令，而第一个别名则会作为默认名称显示在帮助中。
你可以在这里添加或删除别名，也可以将任意别名设置为默认的显示名称。例如，在 echo 指令中点击「添加别名」，输入 复读，然后点击「设为默认」，这样一来，用户在帮助中看到的就是 复读 而不是 echo 了。
添加子指令
在左侧栏中，你可以将任何指令 (派生式指令除外) 拖至其他指令的下方，这将使得前者成为后者的子指令。例如，我们可以将 bind 指令设置为 user 指令的子指令，因为这属于用户管理的一部分。
点击右上角的加号按钮，我们可以创建一个新指令。这个新指令自然是没有行为的，它的主要目的是作为其他指令的父指令，已获得更好的展示效果。对于通过此方法创建的新指令，我们可以通过点击右上角的垃圾桶按钮将其移除。
Gestion des autorisations
在「名称设置」下方还有更多的配置项，我们可以在这里进一步配置指令对用户的访问权限。例如，将 echo 指令的 authority 设置为 2，那么将只有 2 级以上权限的用户才能调用该指令。
我们甚至还可以单独设置每一个指令选项的权限等级。例如，我们可以单独给 -E, --unescape 选项设置 authority 为 3。这样一来，只有 3 级以上权限的用户才能使用 echo -E 的功能。
关于用户权限，请参考 权限管理 一节。