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

alias:修订间差异

来自小可 · Wiki,人人可编辑的,QQ机器人“小可”的官方文档资源
无编辑摘要
 
(未显示同一用户的14个中间版本)
第9行: 第9行:
== <code>alias add</code> ==
== <code>alias add</code> ==
{{Instructors|
{{Instructors|
* {{Instructor type|option}}
* {{Instructor permission|admin}}
* {{Instructor permission|admin}}
}}
}}
第16行: 第17行:
 此命令可以设置自定义机器人命令别名,被设置的命令同样需要命令前缀。
 此命令可以设置自定义机器人命令别名,被设置的命令同样需要命令前缀。


 可使用类似 <code>${foo}</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}}
}}
}}
第29行: 第56行:
== <code>alias reset</code> ==
== <code>alias reset</code> ==
{{Instructors|
{{Instructors|
* {{Instructor type|option}}
* {{Instructor permission|admin}}
* {{Instructor permission|admin}}
}}
}}
第36行: 第64行:
 此命令可以重置自定义机器人命令别名。
 此命令可以重置自定义机器人命令别名。


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


 用法:<code>~alias ascend <别名></code>
 用法:<code>~alias raise <别名></code>


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


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


 用法:<code>~alias descand <别名></code>
 用法:<code>~alias lower <别名></code>


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

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

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

另见

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