小 (→prefix reset) |
无编辑摘要 |
||
(未显示同一用户的27个中间版本) | |||
第2行: | 第2行: | ||
* {{Instructor source}} | * {{Instructor source}} | ||
* {{Instructor forced}} | * {{Instructor forced}} | ||
* {{Instructor permission|admin}} | |||
}} | }} | ||
第8行: | 第9行: | ||
== <code>alias add</code> == | == <code>alias add</code> == | ||
{{Instructors| | {{Instructors| | ||
* {{Instructor type|option}} | |||
* {{Instructor permission|admin}} | * {{Instructor permission|admin}} | ||
}} | }} | ||
此命令可以设置自定义机器人命令别名。 | 用法:<code>~alias add <别名> <命令></code> | ||
此命令可以设置自定义机器人命令别名 ,被设置的命令同样需要命令前缀 。 | |||
输入设置的命令 别名 即可激活对应命令。 命令 别名的优先级默认以加入别名的顺序来决定。 | |||
可使用类似 <code>${foo}</code> 的占位符符号来指定变量映射。使用 <code>_</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> 的结果。 | |||
若别名内 的 占位符与 命令 内的占位符不配套,将出现以下情况: | |||
* 若 别名 内的占位符超过命令内的占位符,则多余的占位符将被直接弃用。 | |||
* 若 命令 内的占位符超过别名内的占位符,则多余的占位符将以字符串形式输出。 | |||
优先级代表了不同别名处理同一字符串的先后顺序,数字越大,处理顺序越靠前。<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> == | == <code>alias remove</code> == | ||
{{Instructors| | {{Instructors| | ||
* {{Instructor type|option}} | |||
* {{Instructor permission|admin}} | * {{Instructor permission|admin}} | ||
}} | }} | ||
用法:<code>~alias remove < 别名></code> | |||
此命令可以移除自定义机器人命令 别名 。 | |||
== <code>alias reset</code> == | == <code>alias reset</code> == | ||
{{Instructors| | {{Instructors| | ||
* {{Instructor type|option}} | |||
* {{Instructor permission|admin}} | * {{Instructor permission|admin}} | ||
}} | }} | ||
用法:<code>~alias reset</code> | |||
此命令可以重置自定义机器人命令别名。 | 此命令可以重置自定义机器人命令别名。 | ||
用法:<code>~alias | == <code>alias raise</code> == | ||
{{Instructors| | |||
* {{Instructor type|option}} | |||
* {{Instructor permission|admin}} | |||
}} | |||
用法:<code>~alias raise <别名></code> | |||
此命令可以将自定义命令别名提升 1 个优先级。 | |||
== <code>alias lower</code> == | |||
{{Instructors| | |||
* {{Instructor type|option}} | |||
* {{Instructor permission|admin}} | |||
}} | |||
用法:<code>~alias lower <别名></code> | |||
此命令可以将某自定义命令别名下降 1 个优先级。 | |||
== <code>alias list</code> == | |||
{{Instructors| | |||
* {{Instructor permission|admin}} | |||
}} | |||
用法:<code>~alias list [--legacy]</code> | |||
选项: | |||
* <code>--legacy</code>:强制使用文字模式。 | |||
此命令可以列出自定义命令别名列表。 | |||
== 另见 == | |||
* [[prefix]] | |||
{{Navbox modules|核心}} | {{Navbox modules|核心}} |
2024年7月21日 (日) 16:17的最新版本
- 强制开启
- 仅管理员
此模块可以自定义命令别名。
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
的结果。
- 当输入
若别名内的占位符与命令内的占位符不配套,将出现以下情况:
- 若别名内的占位符超过命令内的占位符,则多余的占位符将被直接弃用。
- 若命令内的占位符超过别名内的占位符,则多余的占位符将以字符串形式输出。
优先级代表了不同别名处理同一字符串的先后顺序,数字越大,处理顺序越靠前。
示例:
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 raise
用法:~alias raise <别名>
此命令可以将自定义命令别名提升 1 个优先级。
alias lower
用法:~alias lower <别名>
此命令可以将某自定义命令别名下降 1 个优先级。
alias list
用法:~alias list [--legacy]
选项:
--legacy
:强制使用文字模式。
此命令可以列出自定义命令别名列表。
另见
模块 | ||
---|---|---|
核心 | ||
MediaWiki | ||
信息获取 | ||
维护实用工具 | ||
GitHub | ||
Minecraft | ||
Mojira | ||
信息 | ||
版本更新 | ||
Wiki每周页面 | ||
音乐游戏 | ||
Arcaea | ||
Cytoid | ||
Maimai | ||
Phigros | ||
osu! | ||
人工智能 | ||
小工具 | ||
信息获取 | ||
计算与查询 | ||
娱乐 |