查看“alias”的源代码

{{Instructors|
* {{Instructor source}}
* {{Instructor forced}}
* {{Instructor permission|admin}}
}}

此模块可以自定义命令别名。

== <code>alias add</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias add <别名> <命令></code>

此命令可以设置自定义机器人命令别名，被设置的命令同样需要命令前缀。

命令别名的优先级默认以加入别名的顺序来决定。

可使用类似 <code>${foo}</code> 的占位符符号来指定变量映射。

{{Mbox
|title=变量映射
|text=“变量映射”可以帮助用户更灵活地使用命令，而不被传统的命令格式所约束。在别名与命令中分别加入配套的占位符 <code>${foo}</code>，以实现变量映射。<br>
以下以 <code>[[emojimix]]</code> 模块为示例：
* <code>~alias add ${emoji1}+${emoji2} ~emojimix ${emoji1} ${emoji2}</code>
设置此命令后，输入 <code>🐢+😡</code> 即可得到模块内的结果示例。<br>
若在别名中有两个及以上变量粘贴在一起，机器人会尝试使用空格将其分离；在命令中则不会处理。占位符对变量文本进行贪婪选择，仅依靠空格将不同占位符分隔。若占位符无法选择任何文本，自身将返回空字符串。<br>
示例：
* <code>~alias add 说 ${foo}${bar} ~say ${foo}${bar}</code>
** 当输入 <code>说 foo bar</code> 时，将会得到 <code>~say foobar</code> 的结果。
** 当输入 <code>说 bar</code> 时，将会得到 <code>~say bar</code> 的结果。
若别名内的占位符与命令内的占位符不平衡，将出现以下情况：
* 若别名内的占位符超过命令内的占位符，则多余的占位符将被直接弃用。
* 若命令内的占位符超过别名内的占位符，则多余的占位符将以字符串形式输出。
优先级代表了不同别名处理同一字符串的先后顺序，数字越大，处理顺序越靠前。<br>
示例：
<pre>
2 - 说 ${foo}${bar} -> ~say ${foo}${bar}
1 - 说 ${foo}${bar}${baz} -> ~say ${foo}${bar}${baz}
</pre>
当输入 <code>说 foo bar baz</code> 时，会输出 <code>~say foobar</code> 的结果，而 <code>baz</code> 则会被省略，这正是优先级导致的结果。
|type=question
}}

== <code>alias remove</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias remove <别名></code>

此命令可以移除自定义机器人命令别名。

== <code>alias reset</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias reset</code>

此命令可以重置自定义机器人命令别名。

== <code>alias ascend</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias ascend <别名></code>

此命令可以将自定义命令别名提升 1 个优先级。

== <code>alias descand</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias descand <别名></code>

此命令可以将某自定义命令别名下降 1 个优先级。

== <code>alias list</code> ==
{{Instructors|
* {{Instructor permission|admin}}
}}

用法：<code>~alias list [--legacy]</code>

选项：
* <code>--legacy</code>：强制使用文字模式。

此命令可以列出自定义命令别名列表。

== 另见 ==
* [[prefix]]

{{Navbox modules|核心}}