• 欢迎来到小可 · Wiki,人人可编辑的,多平台聊天机器人“小可”的官方文档资源。
  • 小可很可爱,请给我们打钱
  • 原 MkDocs 已迁入本站。若发现 404 属正常现象,请点击左上角搜索您想要的模块。

alias

来自小可 · Wiki,人人可编辑的,QQ机器人“小可”的官方文档资源

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

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:强制使用文字模式。

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

另见

Cookie帮助我们提供我们的服务。通过使用我们的服务,您同意我们使用cookie。