查看“使用指南”的源代码

首先，欢迎您使用 Moonlark！

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

== 寻找节点 ==

{{main|节点}}

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

== 指令使用说明 ==

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

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

<pre>
/指令名 子命令或参数
</pre>

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

=== 指令前缀 ===

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

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

=== 参数 ===

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

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

=== 阅读帮助 ===
=== 阅读指令列表 ===

指令列表中包括每个公开指令的指令名、描述及所有用法。

以 preview 为例，其用法如下：

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

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

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

<pre>
/preview https://baidu.com --wait 2
</pre>

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

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