自定义回复
权限id：session
参数
所有自定义回复都会携带作用域和匹配方式参数！
支持更简洁的输入且都是可选！默认为精准和全局！
[]和()指数学中的域，在本插件表示可填写和必填写；
|为或，表示两边都可以用；
以下所有指令均适用于此表示方法!
[精准|1]精准匹配[模糊|2]模糊匹配[头部|3]头部匹配[结尾|4]结尾匹配[全局|0]全局匹配[当前|-1]当前群匹配[群组(id)|gr(id)]指定群组匹配
具体参数含义可以去壶言1查看
一对一回复(会话)
权限id：sessionx
直接上指令
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
xx (触发内容) (回复内容) [参数] |
快速添加关键字回复 参数可多填，以空格隔开 | xx 怎么办 凉拌 2 0 |
学习 怎么办 凉拌 模糊 全局 |
xx：[触发内容] |
查询所有已保存的关键词回复,冒号中英都支持，后续的触发内容填上就是查询对应的那条 | xx: |
查询 怎么办 |
-xx：(触发内容) |
删除对应的关键词 | -xx:怎么办 |
删除 怎么办 |
%xx |
通过多次消息发送的形式添加对话,便于手机使用 | %xx |
学习对话 |
-%xx |
由于多次消息形式添加的对话的触发词可能含有空格，因此要用对应的方式删除 | -%xx |
删除对话 |
学习对话参数：
0 | 全局修改触发作用域为这个机器人的所有群1 | 精准只有发的消息跟触发词相同，才能触发回复，不填写参数默认2 | 模糊发送消息包含触发词即可触发。3 | 头部发送消息的开头为触发词即可触发4 | 结尾发送消息的结尾为触发词即可触发5 | 正则以正则匹配触发消息，仅限%xx学习功能-1 | 当前修改触发作用域为当期这个群，不填写参数默认gr(id) | 群组(id)修改作用域为对应的群组id，()不是指令，只是说明这个id必须填写，群组的使用方式在下方
所有参数都在聊天指令的结尾以(空格)(参数)添加，无序。
对话和多词条支持的动态消息：
欢迎词支持的动态消息:
| 动态消息类型 | 动态消息参数 | 含义 | 案例 | 匹配结果 |
|---|---|---|---|---|
at |
this |
@(at)触发这条消息的人 | $at(this) |
@放空 |
qq |
@群里的这个人，会固定@这个人 | $at(572490972) |
@放空 | |
message |
this |
这个人触发这条消息的内容 | $message(this) |
不会写插件怎么办？ |
user |
name |
获取这个人的名称 | $user(name) |
放空 |
id |
获取这个人的qq | $user(id) |
572490972 | |
avatar |
获取这个人的头像 | $user(avatar) |
[图片] | |
title |
获取这个人的头衔，优先获取特殊头衔 | $user(title) |
才不是放空了~ | |
info |
详细信息?? | $user(info) |
||
time |
now |
获取当前时间，默认格式yyyy-MM-dd HH:mm:ss |
$time(now) |
2022-8-28 02:15:15 |
(时间格式) |
按照指定的时间格式进行现在的时间输出 | $time(HH:mm:ss) |
02:16:20 |
正则消息回流(仅限一对一回复)
请以%xx学习，学习内容为(你的正则1)，与之对应的回复内容为$mate(1)，
参数为5，也就是正则匹配，1对应第一个括号匹配的内容。
案例：
与之类似的，你只需要更改括号中正则，就可以达到你想要的东西。
一对多回复(多词条)
权限id：sessiondct
指令:
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
%dct |
添加多词条 | %dct |
添加多词条 |
dct: |
查询所有多词条 | %dct |
查询多词条 |
-dct:(id) [id] |
删除多词条，id通过查询得到，第一个id是对应的多次条id，第二个id是对应回复语句id，如果填写，就是删除这个多次回复语句下的这条回复，支持空格隔开一次删除多条 | -dct：5 |
删除：2 34 44 23 |
在添加多词条消息的途中，
发送
!!! | ！！！结束添加，不进行保存，直接结束这次操作!! | ！！在循环添加回复内容时，停止添加，退出进行多词条消息的保存! | ！删除上一条添加的内容
添加多词条参数：
1 | 精准只有发的消息跟触发词相同，才能触发回复，不填写参数默认2 | 模糊发送消息包含触发词即可触发。3 | 头部发送消息的开头为触发词即可触发4 | 结尾发送消息的结尾为触发词即可触发lx | 轮询多个词条回复的顺序为轮询，就是一条一条发送去,不填写参数默认sj | 随机修改回复顺序为随机,就是触发后随机从多词条中取一条拿来回复0 | 全局修改触发作用域为这个机器人的所有群gr(id) | 群组(id)修改作用域为对应的群组id，()不是指令，只是说明这个id必须填写
单个多词条回复语句也支持动态消息，具体支持看上面的对话动态消息支持
群组
权限id：list
用于设定特定几个群的群组系统，用于一些东西只在这几个群中触发，其他插件有个相反的功能叫群黑名单，我这个是正向的，只在那些群触发。
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
+gr:(id) (群号) |
添加多个群为一个群组，群号支持多个 | +gr：1 780594692 |
添加群组：1 780594692 390444068 |
gr:[id] |
查询所有群组信息，id填写后只查询对应的id所属群组信息 | gr： |
查询群组：1 |
-gr:(id) [群号] |
删除这个群组里面的某个群号，支持多个群号 | -gr:1 |
删除群组：1 390444068 780594692 |
与之类似，你只需要更换你的正则匹配就可以
定时器
1 | 权限id：ds |
定时任务是指，按照指定的时间频率发送对应的消息，时间频率是cron表达式，不懂的人可以花5分钟了解一下，基本能满足任何时间频率
cron输入格式$cron(* * * * * ?)
定时管理
指令:
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
%ds |
添加定时任务，具体根据提示进行添加 | %ds |
添加定时器 | 添加定时任务 |
-ds(id) |
删除定时任务，id查询获得 | -ds：1 |
删除定时器：1 | 删除定时任务：1 |
在添加回复消息的途中，
发送
!!! | ！！！结束添加，不进行保存，直接结束这次操作!! | ！！在循环添加回复内容时，停止添加，退出进行定时任务的保存! | ！删除上一条添加的内容
定时任务的参数：
hf | 回复定时器触发后只回复一条消息，不填参数默认lx | 轮询定时器的回复内容将成为多词条的样式，并且回复词条顺序为轮询，与随机冲突！sj | 随机定时器的回复内容将成为多词条的样式，并且回复词条顺序为随机，与轮询冲突！-1 | 当前作用域-当前这个群默认0 | 全局作用域-全部群gr(id) | 群组(id)作用域-指定群组
定时器操作
1 | 权限id：dscz |
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
ds: |
查询定时任务 | ds： |
查询定时器 | 查询定时任务 |
%ds:(id) |
切换定时任务的状态，如果已经开启，则切换为关闭，id查询获取 | %ds:1 |
切换定时器:1 | 切换定时任务：1 |
群管理
权限id：group 此权限不是指令权限
对于几个检测群的功能，需要先将对于群添加为检测群
1 | /hy agroup (群号) #添加 |
依然支持在config文件手动添加
特殊头衔
当你的机器人是群主时才可以使用,拥有admin、group权限的用户也可以用于使用。
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
%@(user) (内容) |
给这个人修改特殊头衔 | %@放空 才不是放空了~ |
设置头衔@放空 才不是放空了~ |
是群主才行哦~
群欢迎词
权限id：grouphyc
当有人申请的时候，拥有管理员权限的机器人并且加入了检测的群
机器人会给出提示
在配置文件中有是否启用开关
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
开门 id|all |
同意这个人的进群申请 | 开门 1 |
开门 all |
同意 id|all |
同意这个人的进群申请 | 同意 1 |
同意 all |
关门 id|all |
关门这个人的进群申请 | 关门 1 |
关门 all |
拒绝 id|all |
拒绝这个人的进群申请 | 拒绝 1 |
拒绝 all |
id是进群时所提示的门牌号
欢迎词功能不需要检测群支持！
欢迎词指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
%hyc |
添加欢迎词 | %hyc |
添加欢迎词 |
hyc： |
查询欢迎词词 | hyc: |
查询欢迎词 |
-hyc:(id) [id] |
删除欢迎，id查询获得，第二个id是对应的欢迎词集合中的某条欢迎词，不支持多条删除 | -hyc：2 |
删除欢迎词：1 15 |
参数:
lx | 轮询欢迎词将以轮询的方式逐条发送，默认sj | 随机欢迎词将随机发送0 | 全局作用域：全局gr(id) | 群组(id)作用域：群组
欢迎词支持的动态消息:
| 动态消息类型 | 动态消息参数 | 含义 | 案例 | 匹配结果 |
|---|---|---|---|---|
at |
this |
@(at)这个进群的人 | $at(this) |
@放空 |
that |
这个要请他的人，如果没有邀请的人则会at同意他进来的那个人 | $at(that) |
@放空 | |
qq |
@群里的这个人，会固定@这个人 | $at(572490972) |
@放空 | |
message |
apply |
获取这个人进群申请的消息 | $message(apply) |
这个人什么都没说… |
user |
name |
获取这个人进群时的名称 | $user(name) |
放空 |
id |
获取这个人的qq | $user(id) |
572490972 | |
avatar |
获取这个人的头像 | $user(avatar) |
[图片] | |
time |
所有支持动态消息的都支持时间，具体用法在文档前面的对话 |
禁言
1 | 权限id：groupjy |
此指令只有在你的机器人是管理员或群主才能触发
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
@某人(禁言时间) |
在机器人有权限的情况下，对你@的这个人进行指定时间的禁言 | @放空 3m |
`` |
@某人 0s |
解除禁言 | @放空 |
`` |
时间频率：
s秒m分钟h小时d天
违禁词
不需要检测群支持。
此指令只有在你的机器人是管理员或群主才能起作用。
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
+wjc:(内容) [param] |
添加违禁词，内容是触发内容，param是参数，具体可以查看下方 | +wjc:色图 ch 2m |
添加违禁词：色图 % jy |
-wjc:(id) |
删除违禁词，id查询获得 | -wjc：2 |
删除违禁词：2 |
wjc： |
查询所有违禁词 | wjc： |
查询违禁词 |
参数的意义
ch违禁词默认撤回，当输入ch后，wjc将不撤回消息jy违禁词默认禁言，当输入jy后，wjc将不禁言3s修改禁言时间,具体时间格式查看禁言%重写回复语句,支持动态消息，具体支持动态消息查看下方[gr1 | 0 ]群组或全局，默认当前群1,2,3,4匹配方式，跟关键词回复的匹配同理hmd3开启触发3次后就会踢出群聊，数字可自选
hmd参数输入后，将会开启小黑屋功能，不会提示！当某个人触发这个wjc到达次数，直接踢出本群，可以和下面的自动添加黑名单配合！
违禁词回复消息支持动态消息：
| 动态消息类型 | 动态消息参数 | 含义 | 案例 | 匹配结果 |
|---|---|---|---|---|
at |
this |
@(at)触发这条消息的人 | $at(this) |
@放空 |
qq |
@群里的这个人，会固定@这个人 | $at(572490972) |
@放空 | |
message |
this |
这个人触发这条消息的内容 | $message(this) |
不会写插件怎么办？ |
jyString |
这条违禁词的禁言时间中文 | $message(jyString) |
禁言2分钟 | |
prohibitString |
同上 | |||
null |
不发送消息 | $message(null) |
||
user |
name |
获取这个人的名称 | $user(name) |
放空 |
id |
获取这个人的qq | $user(id) |
572490972 | |
avatar |
获取这个人的头像 | $user(avatar) |
[图片] | |
title |
获取这个人的头衔，优先获取特殊头衔 | $user(title) |
才不是放空了~ | |
info |
详细信息?? | $user(info) |
||
time |
now |
获取当前时间，默认格式yyyy-MM-dd HH:mm:ss |
$time(now) |
2022-8-28 02:15:15 |
(时间格式) |
按照指定的时间格式进行现在的时间输出 | $time(HH:mm:ss) |
02:16:20 |
黑名单
1 | 权限id：grouphmd |
不需要检测群支持。
此指令只有在你的机器人是管理员或群主才能触发。
支持作用域！！设置为全局时，该用户将被你的bot封禁！
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
+hmd:@(user) [param] |
添加黑名单，参数看下方 | +hmd:@放空 jy |
添加黑名单:@放空 % |
hmd: |
查询黑名单 | hmd: |
查询黑名单 |
-hmd:(id) |
删除黑名单,id查询获得 | -hmd:3 |
删除黑名单:2 |
参数：
t默认检测到就踢出，携带参数不踢出jy默认禁言(优先踢出),携带参数不禁言ch默认撤回该用户的消息，携带不提出0 | gr(id)作用域不携带参数默认当前群%重写封禁理由
此功能需要检测群支持！
在配置文件blacklist有退群自动添加黑名单开关！
里面还有重写封禁理由！
撤回消息
1 | 权限id：groupch |
用于撤回上面的群消息，机器人是管理员和群主才能使用
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
!recall |
撤回上面这条消息 | !recall |
撤回 |
！recall (number) |
撤回前面几条消息，不包含这条消息 | ！recall 5 |
撤回 5 |
!recall 1-5 |
撤回上面1到5条，从第0条算起，包含这条消息 | !recall 1-5 |
撤回 25-55 |
具体用法试一试就明白，撤回多条消息时，权限可能会有冲突。
踢人
1 | 权限id：grouptr |
此指令只有在你的机器人是管理员或群主才能触发
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
tr@(user) [hmd] |
踢人 | tr@放空 |
踢人@放空 |
参数：
hmdqq的踢人有个禁止此用户再次加群，输入后将禁止此用户再次加群
权限系统
1 | 权限id：admin |
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
+@(user) (权限id) |
赋予这个群的这个人的某个权限,权限id可在文档查看 | +@放空 admin |
添加@放空 all |
-@(user) |
移除这个权限 | -@放空 all |
删除@放空 group |
！power [param] |
查询权限列表，参数如下 | !power all |
权限列表 all |
参数：
- ``不填默认当前群
@某人查看指定人在本群的权限all查询所有权限或添加所有权限或删除所有权限
查询可以输入对应的群号 或者 qq号 来查询指定区域的权限信息
也可以直接 all 查询全部
然后通过 上一页 和 下一页 来进行翻译阅读
多机器人互冲
对于同时加载多个bot的使用者
容易存在一条指令两个bot触发，因此，加了一个‘暂停功能’
指令：
| 指令 | 含义 | 案例 | 中文格式 |
|---|---|---|---|
！pause @(bot) |
你发的下一条消息，这个机器人将会忽略(包括触发) | ！pause@乌拉 |
|
!pause @(bot) 5 |
忽略下5条消息，消息数量自定 | ！pause @乌拉 5 |
不带参数，默认忽略你的下一条消息
也可以自定义忽略下几条消息，这个记录是写在内存的，如果不小心输入多了（9999999999），重启就行。
插件指令
| 指令 | 含义 | 案例 |
|---|---|---|
/hy aGroup |
添加一个监测群 | /hy aGroup 390444068 |
/hy dGroup |
删除一个监测群 | /hy dGroup 390444068 |
/hy v |
查询当前插件版本 | /hy v |
/hy transfer |
转移一个所属bot的数据到另一个bot | /hy transfer 2061954151 3630254205 |
wechat- alipay
