使用指南

首先，欢迎您使用 Moonlark！

本指南将帮助您了解如何与 Moonlark 互动，及获得更好的体验。

寻找节点

主条目：节点

您需要先找到一个可用的 Moonlark 节点，您可以点击上方链接访问关于此内容的条目获取关于 Moonlark 的节点的更多信息。

指令使用说明

指令是一种用于操作 Moonlark 的特殊消息，有时也称为“命令”，一般以命令前缀 / 开头。

大部分指令遵循以下格式：

/指令名 子命令或参数

不是每个指令有子命令和参数，一条指令至少由指令前缀和指令名组成。

指令前缀

一条指令的标识符，一般为 /。

部分节点指令前缀有所不同（如 0x07 节点的前缀为 @Moonlark /

参数

Moonlark 中参数是需要用户填入的内容，填入不同的参数可能导致指令执行结果不同，主要有如下 4 种形式：

Moonlark 中的参数类型

名称	说明	在命令帮助中的出现形式
必要参数	使用指令时必须正确填入的参数，不正确填入会导致指令无法执行。	<这是一个必要参数>
可选参数	使用指令时可以不填写的参数。	[这是一个可选参数]
选择参数	使用指令时在给出的可以选择的值中根据需求选择一个的参数。	这是另一个选项} [这是一个可选的选择参数，这是默认值|这是另一个选项，不是默认值]
选项 / 开关	由选项名（这个结构一般是选择参数）和参数值（有时候是可选参数）组成的参数，一般都是可选的。	[-t <这是一个可选的选项的值>]

阅读帮助

使用 /help 可以获取 Moonlark 的指令列表。

用法中的符号

为了便于阅读，Moonlark 会在用法中使用一些符号。

这些符号主要用于表示参数，不需要将这些符号键入指令中。

必须的

使用尖括号 <> 包围，表示这个参数在用法中必须填入。

可选的

使用方括号 [] 包围，表示这个参数在用法中不必要填入，或已经有默认值。

选择其一

使用管道符 | 分隔的两个或多个参数，表示需要在这些参数中选择一个填入，一般不含有空格。

部分情况下会使用花括号 {} 包围。

备注

使用圆括号 () 包围，用于解释用法，不用填入指令。

无需更改的

用法中除此之外的字符都可以原封不动的写在指令中。

阅读指令列表

指令列表中包括每个公开指令（部分在开发中的指令可能不存在于列表中）的指令名、描述及所有用法。

以 preview 为例，其用法如下：

!preview <URL> [-w|--wait <等待时间>] (截图URL)

注：示例来自测试服，所以前缀是 !

• ! 为指令前缀；
• preview 为指令名；
• <URL> 是一个必选参数；
• [-w|--wait <等待时间>] 是一个可选选项；
• <等待时间> 是 --wait 选项的必选参数；
• (截图URL) 是这个用法的说明。

所以，一个合法的 preview 用法应该是这样：

!preview https://baidu.com --wait 2

这个用法表示截图 https://baidu.com 并在网页打开后等待 2 秒。

注：可选选项的必选参数 的意思是，选项可以不提供，但是一旦在参数中包含了这个选项，就必须填入它的必选参数。