命令
本部分将介绍 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 的值为 val1,arg2 的值为 true。
权限
调用部分命令需要相应权限,详情请参阅对应文档。