alias

•  强制开启
•   仅管理员

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

alias add

•   仅管理员

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

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

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

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

变量映射

“变量映射”可以帮助用户更灵活地使用命令，而不被传统的命令格式所约束。在别名与命令中分别加入配套的占位符 ${foo}，以实现变量映射。

以下以 emojimix 模块为示例：

• ~alias add ${emoji1}+${emoji2} ~emojimix ${emoji1} ${emoji2}

设置此命令后，输入 🐢+😡 即可得到此模块内的结果示例。
若在别名中有两个及以上变量粘贴在一起，机器人会尝试使用空格将其分离；在命令中则不会处理。占位符对变量文本进行贪婪选择，仅依靠空格将不同占位符分隔。若占位符无法选择任何文本，自身将返回空字符串。
示例：

• ~alias add 说 ${foo}${bar} ~say ${foo}${bar}
  • 当输入 说 foo bar 时，将会得到 ~say foobar 的结果。
  • 当输入 说 bar 时，将会得到 ~say bar 的结果。

若别名内的占位符与命令内的占位符不平衡，将出现以下情况：

• 若别名内的占位符超过命令内的占位符，则多余的占位符将被直接弃用。
• 若命令内的占位符超过别名内的占位符，则多余的占位符将以字符串形式输出。

优先级代表了不同别名处理同一字符串的先后顺序，数字越大，处理顺序越靠前。
示例：

2 - 说 ${foo}${bar} -> ~say ${foo}${bar}
1 - 说 ${foo}${bar}${baz} -> ~say ${foo}${bar}${baz}

当输入 说 foo bar baz 时，会输出 ~say foobar 的结果，而 baz 则会被省略，这正是优先级导致的结果。

alias remove

•   仅管理员

用法：~alias remove <别名>

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

alias reset

•   仅管理员

用法：~alias reset

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

alias ascend

•   仅管理员

用法：~alias ascend <别名>

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

alias descand

•   仅管理员

用法：~alias descand <别名>

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

alias list

•   仅管理员

用法：~alias list [--legacy]

选项：

• --legacy：强制使用文字模式。

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

另见

• prefix