跳到主要内容

命令

本部分将介绍 Aki-Lite 的可用命令。

调用约定

Aki-Lite 的所有命令使用时,均需要在消息开头 At Bot,否则该消息将被忽略。

通常,一条正确的命令调用看起来应该类似于:@(Bot昵称) [命令名称] (一级子命令) (二级子命令) <参数1> <参数2>

子命令

有的命令包含一些子命令,子命令本身也可能包含子命令。这种情况下,子命令名称应当紧随上级命令。

例如,要调用 tarkov 命令的子命令 btc,你应该发送 @Bot tarkov btc

如果还有其他参数,应当跟随在最低级子命令后面。

参数

参数是跟随在命令后面的内容,通常以空格分隔。

如果您的参数内容中包含空格,则应当使用半角引号 " 将其包裹起来。如果要输入 " 作为参数,可以使用转义符 \";如果要输入 \ 本身,则可以使用 \\

目前,Aki-Lite 支持两种参数传递方式,具体采用哪种取决于具体命令。

匿名参数

所有参数都不具有名称。在这种情况下,参数的顺序不能随意改变,也只有靠后的参数可以省略(取决于具体命令)。

例如,wordle 命令接受一个可选参数,那么调用时 @Bot wordle@Bot wordle 参数 都是合法的调用。

具名参数

所有参数都应当指定名称,以 参数名=参数值 的形式传递。在这种情况下,参数顺序是无关紧要的,如果命令允许,也可以省略任意参数。

特别的,如果某个参数只传递了参数名,而没有传递参数值,该参数将被视为 true(字符串)。

例如,@Bot 命令 arg1=val1 arg2 将传递两个参数,arg1 的值为 val1arg2 的值为 true

权限

调用部分命令需要相应权限,详情请参阅对应文档。