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

首先，欢迎您使用 Moonlark！

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

== 寻找节点 ==

{{main|节点}}

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

== 指令使用说明 ==

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

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

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

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

=== 指令前缀 ===

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

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

=== 参数 ===

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

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

== 阅读帮助 ==

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

=== 用法中的符号 ===

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

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

==== 必须的 ====

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

==== 可选的 ====

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

==== 选择其一 ====

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

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

==== 备注 ====

使用圆括号 <code>()</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 秒'''。

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