使用指南:修订间差异

来自Moonlark
标签wikieditor
 
(未显示同一用户的13个中间版本)
第3行: 第3行:
本指南将帮助您了解如何与 Moonlark 互动,及获得更好的体验。
本指南将帮助您了解如何与 Moonlark 互动,及获得更好的体验。


== 寻找节点 ==
== 开始使用 ==
 
跟随以下步骤能帮助您快速的开始使用 Moonlark。当然,我们建议您先阅读下方的指令使用指南。
 
=== 1. 寻找一个可用的节点 ===


{{main|节点}}
{{main|节点}}


您需要先找到一个可用的 Moonlark 节点,您可以点击上方链接访问关于此内容的条目获取关于 Moonlark 的节点的更多信息。
您需要先找到一个可用的 Moonlark 节点,添加 Moonlark 或直接在已经部署了 Moonlark 的群聊或服务器使用 Moonlark。您可以点击上方链接访问关于此内容的条目获取关于 Moonlark 的节点的更多信息。


== 指令 ==
==== 确认可用性 ====


指令是一种用于操作 Moonlark 的特殊消息有时也称为“命”,一般以命令前缀 '''/''' 开头
您可以向 Moonlark 发送 <code>status</code> 指令确认其状态,如果 Moonlark 正常回复则说明状态良好。此指响应慢(约 30s 之内)是正常现象
 
大部分指令遵循以下格式:


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


不是每个指令有子命令和参数但一个指令一定有一个独立的指令名,所以一条命令至少由指令前缀和指令名组
对于 <code>Moonlark 0x07</code> 节点您需要将指令更改这样:


=== 指令前缀 ===
<pre>
@Moonlark /status
</pre>


一条指令的标识符,一般为 '''/'''。
=== 2. 注册 Moonlark UID ===


部分节点指令前缀有所不同,如测试节点使用的是 '''!''',QQ 官方节点还需要在发送指令及 Moonlark
向 Moonlark 发送 <code>register</code> 指令,根据提示填写数据并交注册请求


具体可参考 [[节点#节点表]] 中的备注。


=== 参数 ===
<pre>
/register
</pre>


Moonlark 中参分为四种
对于 <code>Moonlark 0x07</code> 节点,您需要将指令更改成这样,并在每一个据填写时提及 Moonlark('''@Moonlark ''')


==== 必要参数 ====
<pre>
@Moonlark /register
</pre>


使用时必须填入的参数。
=== 3. 获取指令列表 ===


==== 可选参数 ====
此步骤能帮助您更好了解 Moonlark 包含的功能,只需要向 Moonlark 发送 <code>help</code>指令。


使用时可以不填写或有默认值的参数。
<pre>
 
/help
==== 选择参数 ====
</pre>
 
需要在给定的值中选择其一的参数。


==== 选项 ====
对于 <code>Moonlark 0x07</code> 节点您需要将指令更改成这样
 
选项可以出现在参数的任何位置大致格式如下


<pre>
<pre>
--选项名称 选项参数
@Moonlark /help
</pre>
</pre>


不是所有选项都有选项参数,没有选项参数的选项也被称为开关。
== 指令使用说明 ==


部分选项存在缩写在大部分选项中使用缩写时需将 <code>--</code> 改为 <code>-</code>
指令是一种用于操作 Moonlark 的特殊消息有时也称为“命令”一般以命令前缀 '''/''' 开头


== 阅读帮助 ==
大部分指令遵循以下格式:


使用 <code>/help</code> 可以获取 Moonlark 的指令列表。
<pre>
/指令名 子命令或参数
</pre>


=== 用法中的符号 ===
不是每个指令有子命令和参数,一条指令至少由指令前缀和指令名组成。


为了便于阅读,Moonlark 会在用法中使用一些符号。
=== 指令前缀 ===


这些号主要用于表示参数不需要将这些符号键入指令中
一条指令的标识符,一般为 '''/'''


==== 必须====
部分节点指令前缀有所不同(如 0x07 节点前缀为 '''@Moonlark /'''


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


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


使用方括号 <code>[]</code> 包围,表示这个参数在用法中不必要填入,或已经有默认值。
{| class="wikitable"
 
|+ Moonlark 中的参数类型
==== 择其一 ====
! 名称 !! 说明 !! 在命令帮助中的出现形式
 
|-
使用管道符 <code>|</code> 分隔的两个或多个参数,表示需要这些参数中选择一个填入,一般不含有空格
| 必要参数 || 使用指令时必须正确填入的参数,不正确填入会导致指令无法执行。 || <code><这是一必要参数></code>
 
|-
部分情况下会使用花括号 <code>{}</code> 包围。
| 参数 || 使用指令时可以不填写的参数。 || <code>[这是一个可选参数]</code>
 
|-
==== 备注 ====
| 选择参数 || 使用指令时给出的可以选择的值根据需求选择一个的参数|| <pre>{这是一个选择参数|这是另一个选择}</pre> <pre>[这是一个可选的选择参数|这是另一个选择]</pre>
 
|-
使用圆括号 <code>()</code> 包围,用于解释用法,不用填入指令。
| 选项 / 开关 || 由选项名(这个结构一般是选择参数)和参数值(有时候是可选参数)组成参数,一般的。 || <code>[-t <这是一个可选的选项的值>]</code>
 
|}
==== 无需更改的 ====
 
用法中除此之外字符都可以原封不动写在指令中


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


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


以 preview 为例,其用法如下:
以 preview 为例,其用法如下:


<pre>
<pre>
!preview <URL> [-w|--wait <等待时间>] (截图URL)
/preview <URL> [-w|--wait <等待时间>] (截图URL)
</pre>
</pre>
: 注:示例来自测试服,所以前缀是 '''!'''


* <code>!</code> 为指令前缀;
* <code>!</code> 为指令前缀;
第111行: 第112行:


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


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


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

2024年11月17日 (日) 00:00的最新版本

首先,欢迎您使用 Moonlark!

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

开始使用

跟随以下步骤能帮助您快速的开始使用 Moonlark。当然,我们建议您先阅读下方的指令使用指南。

1. 寻找一个可用的节点

您需要先找到一个可用的 Moonlark 节点,添加 Moonlark 或直接在已经部署了 Moonlark 的群聊或服务器使用 Moonlark。您可以点击上方链接访问关于此内容的条目获取关于 Moonlark 的节点的更多信息。

确认可用性

您可以向 Moonlark 发送 status 指令确认其状态,如果 Moonlark 正常回复,则说明状态良好。此指令响应慢(约 30s 之内)是正常现象。

/status

对于 Moonlark 0x07 节点,您需要将指令更改成这样:

@Moonlark /status

2. 注册 Moonlark UID

向 Moonlark 发送 register 指令,根据提示填写数据并提交注册请求。


/register

对于 Moonlark 0x07 节点,您需要将指令更改成这样,并在每一个数据填写时提及 Moonlark(@Moonlark ):

@Moonlark /register

3. 获取指令列表

此步骤能帮助您更好了解 Moonlark 包含的功能,只需要向 Moonlark 发送 help指令。

/help

对于 Moonlark 0x07 节点,您需要将指令更改成这样:

@Moonlark /help

指令使用说明

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

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

/指令名 子命令或参数

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

指令前缀

一条指令的标识符,一般为 /

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

参数

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

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

阅读帮助

阅读指令列表

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

以 preview 为例,其用法如下:

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

所以,一个合法的 preview 用法应该是这样:

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

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

注:可选选项的必选参数 值可以不提供选项,但是只要提供了这个选项,就必须填入它的必选参数。