Koishi 指令系统
在了解了控制台的基本用法后，我们终于可以开始介绍如何与机器人对话了！让我们从上一节中看到的例子开始：
这里的输出与两个插件有关：
一个 Koishi 机器人的绝大部分功能都是通过指令提供给用户的。当你安装了更多的插件后，你也就有了更多的指令可供使用。
查看帮助
help 指令后还可以添加一个参数，用于查看特定指令的帮助信息：
那么细心的小伙伴可能会发现，既然 help 本身也是一个指令，那我能不能用来查看 help 自己的帮助信息呢？答案是肯定的：
参数和选项
在上面的用法中，我们接触到了两个新的概念：参数 (Argument) 和 选项 (Option)。
参数分为必选参数和可选参数，分别用尖括号 <> 和方括号 [] 表示。一个指令可以有任意多个参数，它们的顺序是固定的，用户必须按照指令定义的顺序来输入参数。必选参数一定出现在可选参数之前。如果用户输入的参数数量不足必选参数的个数，那么插件通常会给出错误提示；如果用户输入了额外的参数，那么会被忽略。
例如，help 指令共有一个参数，它是可选参数，表示要查看的指令名；echo 指令也有一个参数，它是必选参数，表示要发送的消息。让我们看看如果不填必选参数会怎么样：
选项同样可以控制指令的行为。它通常以 - 或 -- 开头，后面不带空格地跟着一个固定的单词，称为选项名称。选项之间没有顺序要求，但通常建议将选项放在参数之前。让我们试试看：
在上面的例子中，我们使用了 -E 选项，成功改变了输出的内容。关于这具体是怎么做到的，我们会在后续的章节中进行介绍。
参数除了可以分为必选和可选外，还可以分为定长和变长。定长参数的中不能出现空白字符，而变长参数则可以。变长参数通过参数名前后的 ... 来指示，例如 echo 指令的参数就是一个变长参数。如果要为定长参数传入带有空白字符的内容，可以使用引号将其包裹起来，例如：
此外，部分选项也可以接受参数。例如，当你安装了翻译插件，你将会获得如下的帮助信息：
在这个例子中，-s 和 -t 都是带有参数的选项。我们使用 -t ja 来指定目标语言为日语，源语言仍然采用了默认行为。
触发前缀
然而，如果仅仅通过一个词就能触发指令，在群聊环境下非常容易出现误触。为了避免这种情况，Koishi 引入了前缀触发的概念。在「全局设置」中，我们提供了名为 prefix 和 nickname 的配置项。假如将 prefix 设置为 /，nickname 设置为 四季酱，则在群聊环境下只有以下信息可以触发指令调用：
四季酱, echo hello
@四季酱 echo hello
/echo hello换句话说，一个指令能够被触发的实际条件为：
- 消息以
prefix开头，后面紧跟着指令调用 - 消息以
nickname开头，后面可以有逗号或空白字符，再后面是指令调用 - 消息以 @机器人 开头 (可以有多个
@，但至少一个是机器人账号)，后面是指令调用
对于人数较多或是含有不止一个机器人的群聊，我们强烈建议每一个机器人都配置不同的触发前缀。而在私聊环境下，由于不用担心误触，因此并没有上面的限制。没有触发前缀的指令调用也能被正常执行。
TIP
关于 prefix 的几点提示：
prefix是一个列表，默认值为['']表示无需前缀也能触发；将列表清空会导致所有指令都无法通过prefix触发 (但仍然可以通过私聊或nickname或 @机器人 触发)- 如果你在
prefix中设置了多个值，例如['.', '/', '']，那么.,/或无前缀都能触发指令；但由于 Koishi 是按顺序匹配各个前缀的，因此空串''必须写在最后一个 - 可以为不同的会话设置不同的
prefix，具体请参考 过滤器 一节
子指令
admin 插件提供了名为 user 的指令，现在让我们调用一下：
这里出现了一个新的概念：子指令。子指令在调用上与普通的指令并没有区别，但它们将不会显示在 help 返回的全局指令列表中，而只会显示在父指令 user 的帮助信息中。这样设计的目的是为了避免指令列表过于冗长，同时也将指令以一种更清晰的方式进行了组织。
在上面的例子中，我们还能发现 Koishi 存在两种不同的子指令：一种是 层级式，例如 authorize；而另一种则是 派生式，例如 user.locale。后者跟前者的区别是，它的名称带有父指令的名称，以及一个小数点 .。在调用时，我们也需要加上这个小数点：
如果父指令本身没有功能，那么 user 和 user -h 的效果是一样的。此时，我们也可以使用空格代替小数点进行派生式子指令的调用：
熟悉 Git 的用户可能会发现，这种设计正是借鉴了 Git 的二级指令：当一个指令的功能过于复杂时，我们可以将其拆分为多个子指令，从而使得指令的功能更加清晰。
TIP
至于 user.locale 是干什么的，想必大家也已经猜出来了。我们留到 国际化 一节再详细介绍。
指令管理
打开控制台，我们会在活动栏中找到名为「指令管理」的页面。你可以在这里查看当前所有指令的列表，并对指令的行为进行设置。
设置别名
点进任意指令的详情页，首先就能看到「名称设置」，这里展示了指令的全部别名。每个别名都能被用来触发指令，而第一个别名则会作为默认名称显示在帮助中。
你可以在这里添加或删除别名，也可以将任意别名设置为默认的显示名称。例如，在 echo 指令中点击「添加别名」，输入 复读，然后点击「设为默认」，这样一来，用户在帮助中看到的就是 复读 而不是 echo 了。
添加子指令
在左侧栏中，你可以将任何指令 (派生式指令除外) 拖至其他指令的下方，这将使得前者成为后者的子指令。例如，我们可以将 bind 指令设置为 user 指令的子指令，因为这属于用户管理的一部分。
点击右上角的加号按钮，我们可以创建一个新指令。这个新指令自然是没有行为的，它的主要目的是作为其他指令的父指令，已获得更好的展示效果。对于通过此方法创建的新指令，我们可以通过点击右上角的垃圾桶按钮将其移除。
权限管理
在「名称设置」下方还有更多的配置项，我们可以在这里进一步配置指令对用户的访问权限。例如，将 echo 指令的 authority 设置为 2，那么将只有 2 级以上权限的用户才能调用该指令。
我们甚至还可以单独设置每一个指令选项的权限等级。例如，我们可以单独给 -E, --unescape 选项设置 authority 为 3。这样一来，只有 3 级以上权限的用户才能使用 echo -E 的功能。
关于用户权限，请参考 权限管理 一节。