<![CDATA[Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁]]>Mirai Administrator

基于 Mirai Console 的 管理员 Bot 及其标准

Release
Downloads
maven-central
Codacy Badge

使用前应该查阅的相关文档或项目

本插件实现的功能有:

  • 联系人相关 自动审批，指令查看，用户留言
  • 消息相关 发送消息，撤回消息
  • 群管理相关 群消息审核，自动宵禁，自动清理不发言，禁言自动退群

本插件提供服务接口以供其他插件拓展功能
例如使用 Mirai Content Censor 依靠百度API审查群消息
例如使用 Mirai Authenticator 验证加群请求

MCL 指令安装

请确认 mcl.jar 的版本是 2.1.0+
./mcl --update-package xyz.cssxsh.mirai:mirai-administrator --channel maven-stable --type plugin

指令

注意: 使用前请确保可以 在聊天环境执行指令
<...>中的是指令名
[...]表示参数，当[...]后面带?时表示参数可选

本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.mirai-administrator:command.*, * 是指令的第一指令名
例如 /send to 12345 的权限ID为 xyz.cssxsh.mirai.plugin.mirai-administrator:command.send
对 机器人发送的联系人请求通知消息 回复 同意 或 不同意 或 拉黑 即可处理
插件提供黑名单功能，使用指令 /contact black u12345, 即可拉黑用户，Bot将不响应用户动作（包括其他插件的功能）

AdminContactCommand

Command Description
/<contact> <delete> [contact] 删除联系人
/<contact> <handle> [id] [accept]? [black]? 处理联系人申请
/<contact> <request> 查看申请列表
/<contact> <black> {permitteeIds} 拉黑
/<contact> <white> {permitteeIds} 取消拉黑
/<contact> <backup> 触发备份功能
  1. id 是 事件id 或 好友id 或 群id
  2. accept 和 black 参数为 true, yes, enabled, on, 1 时表示 true (不区分大小写)
  3. 对 机器人发送的新联系人通知消息 回复 同意 或 不同意 或 拉黑 即可处理，详见 联系人审批配置
  4. permitteeIds 是 权限系统的用户标识符，例如 m12345.6789, 可以提供多个 PermitteeId 一次性拉黑/取消拉黑
  5. 黑名单通过 @EventHandler(priority = EventPriority.HIGH, concurrency = ConcurrencyKind.LOCKED) 拦截消息

AdminFriendCommand

Command Description
/<friend> <list> 好友列表
/<friend> <delete> [friend] 删除好友

AdminGroupCommand

Command Description
/<group> <list> 群列表
/<group> <member> [group] 群成员
/<group> <quit> [group] 退出群聊
/<group> <kick> [member] [reason]? [black]? 踢出群员
/<group> <nick> [member] [nick] 群昵称
/<group> <title> [member] [title] 群头衔
/<group> <mute> [member] [second] 禁言
/<group> <quiet> [group] [open]? 全体禁言
/<group> <admin> [member] [operation]? 设置管理员
/<group> <announce> [group] 设置公告
/<group> <rank> [group] {levels} 设置等级头衔

AdminRecallCommand

Command Description
/<recall> [contact]? 撤回消息
  1. 不指定contact时，可以通过回复消息指定要撤销的消息，如果没有指定，将尝试撤销最后一条不是由指令发送者发送的消息
  2. contact是群员时，将尝试撤销这个群员的最后一条消息
  3. contact是群或好友时，将尝试撤销bot的最后一条消息

AdminRegisteredCommand

Command Description
/<registered> 查看已注册指令
/<reg> 查看已注册指令

AdminSendCommand

Command Description
/<send> <groups> [bot]? [at]? [second]? 发送给所有群
/<send> <friends> [bot]? [second]? 发送给所有好友
/<send> <to> [contact] [at]? 发送给指定联系人
/<send> <nudge> [user] 戳一戳指定联系人
/<send> <log> {addresses} 备份日志到邮箱
  1. bot 参数在命令行模式下需要指定
  2. at 参数为 true, yes, enabled, on, 1 时表示 true, 将附加一个At
  3. second 参数为 延迟的秒数 例如 /send groups 123456 false 10
  4. addresses 参数为 邮箱地址

AdminTimerCommand

Command Description
/<timer> <config> 显示当前设置
/<timer> <mute> [moment] [cron] [group]? 宵禁
/<timer> <cleaner> [day] [cron] [group]? 清理不发言
/<timer> <status> [cron] [bot]? 定时发送机器人状态
/<timer> <message> [cron] [target] [at] 定时发送消息

  1. group 为 要操作的群，在群聊中可以不指定

  2. cron, 为 CRON 表达式, 由 秒 分钟 小时 日 月 周 组成
    例如 0 0 1 * * ? 表示每天 01:00 执行一次，0 30 2 ? * 2-6 表示星期一至星期五 每天 02:30 执行一次
    可以使用在线编辑器生成 https://www.bejson.com/othertools/cron/
    为防止被 空格 分成多个参数，请使用 " 包裹参数

  3. moment 为 DURATION 表达式, 由 PnDTnHnMn.nS 组成
    例如 P1DT2H3M4.5S 表示 一天二小时三分钟四点五秒，PT5H 表示 五小时

  4. mute 指令，moment 小于 0 宵禁就会关闭
    例如 /timer mute PT5H "0 0 1 ? * 2-6", 将会在 星期一到星期五的凌晨01:00 禁言 5 小时
    例如 /timer mute PT0S "0 0 0 1 * ?", 将会 取消 禁言定时器

  5. day 单位为天数的发言期限, 小于 0 宵禁就会关闭
    例如 /timer cleaner 365 "0 0 12 ? * 0", 将会 取消 禁言定时器

配置

联系人审批配置

  1. AdminAutoApproverConfig.yml

禁言自动退群配置

  1. AdminAutoQuitConfig.yml
  2. mute_limit 大于这个设置秒数的禁言会触发自动退群

留言配置

  1. AdminCommentConfig.yml
  2. xyz.cssxsh.mirai.plugin.mirai-administrator:comment.include 作用: 拥有此权限的用户，可以给机器人留言

机器人上线消息配置

  1. AdminOnlineMessageConfig.yml
  2. xyz.cssxsh.mirai.plugin.mirai-administrator:online.include 作用: 拥有此权限的群，会发送上线通知

消息审查及机器人所有者

  1. AdminSetting.yml
  2. censor_types 可选值 IMAGE, FLASH, SERVICE, APP, AUDIO, FORWARD, VIP, MARKET, MUSIC, POKE
  3. 正则词库, 须手动添加，将会加载 censor 文件夹中的 txt 文件，每一行对应一个正则匹配，会监听文件改动，无需重启

邮件配置

  1. AdminMailConfig.yml 配置一些默认的发送对象
  2. admin.mail.properties 配置邮箱账号等

格式参考

mail.host=smtp.mail.qq.com
mail.auth=true
mail.user=xxx
mail.password=***
mail.from=cssxsh@qq.com
mail.store.protocol=smtp
mail.transport.protocol=smtp
# smtp
mail.smtp.starttls.enable=true
mail.smtp.auth=true
mail.smtp.timeout=15000

QQ邮箱帮助： https://service.mail.qq.com/cgi-bin/help?subtype=1&&id=28&&no=1001256

]]>https://mirai.mamoe.net/topic/972/mirai-administrator-机器人管理插件-好友-群管理-黑名单-宵禁RSS for NodeFri, 10 Apr 2026 22:53:23 GMTSun, 06 Feb 2022 13:22:07 GMT60<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Fri, 01 Mar 2024 04:15:25 GMT]]>请问机器人上线功能是否可以上线时不@全体成员？

]]>https://mirai.mamoe.net/post/27393https://mirai.mamoe.net/post/27393Fri, 01 Mar 2024 04:15:25 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Tue, 27 Feb 2024 01:29:47 GMT]]>这个拉黑是指拉黑用户不能使用bot吗？还是拉黑后无法加群

]]>https://mirai.mamoe.net/post/27382https://mirai.mamoe.net/post/27382Tue, 27 Feb 2024 01:29:47 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 17 Feb 2024 12:11:01 GMT]]>为什么加群提示现在不发了，是我设置出了问题吗？

]]>https://mirai.mamoe.net/post/27310https://mirai.mamoe.net/post/27310Sat, 17 Feb 2024 12:11:01 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Mon, 05 Feb 2024 02:10:52 GMT]]>大佬您好，请问如果我想设置多个管理员账号，在AdminSetting.yml owner中应该怎么填写两个或两个以上的qq？

]]>https://mirai.mamoe.net/post/27268https://mirai.mamoe.net/post/27268Mon, 05 Feb 2024 02:10:52 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 12 Aug 2023 15:59:06 GMT]]>这个上线通知怎么触发，/perm add * xyz.cssxsh.mirai.plugin.mirai-administrator:online.include还是没有通知

]]>https://mirai.mamoe.net/post/25638https://mirai.mamoe.net/post/25638Sat, 12 Aug 2023 15:59:06 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Mon, 07 Aug 2023 08:55:00 GMT]]>请问可以设置多个机器人所有者吗？

]]>https://mirai.mamoe.net/post/25510https://mirai.mamoe.net/post/25510Mon, 07 Aug 2023 08:55:00 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Mon, 24 Jul 2023 11:53:16 GMT]]>@kiri

感谢反馈

]]>https://mirai.mamoe.net/post/25339https://mirai.mamoe.net/post/25339Mon, 24 Jul 2023 11:53:16 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sun, 23 Jul 2023 17:27:15 GMT]]>给邮件教程的一点提醒

好像是tx更新了地址？
现在腾讯smtp的地址是smtp.qq.com而不是smtp.mail.qq.com了
端口587

实测有效
来自：https://service.mail.qq.com/detail/0/427

]]>https://mirai.mamoe.net/post/25325https://mirai.mamoe.net/post/25325Sun, 23 Jul 2023 17:27:15 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Thu, 15 Jun 2023 04:29:31 GMT]]>@sjxkfnskdd

×窗口导致的问题自己解决
自己的问题非得发到我的插件发布贴里

]]>https://mirai.mamoe.net/post/24556https://mirai.mamoe.net/post/24556Thu, 15 Jun 2023 04:29:31 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Thu, 15 Jun 2023 04:16:07 GMT]]>@cssxsh 52ca7107-fd66-40cd-883f-fad3119aadb1-image.png 我用了/stop指令关闭还是如此

]]>https://mirai.mamoe.net/post/24555https://mirai.mamoe.net/post/24555Thu, 15 Jun 2023 04:16:07 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Thu, 15 Jun 2023 04:01:17 GMT]]>@sjxkfnskdd

你自己不正确关闭 mirai 导致的

]]>https://mirai.mamoe.net/post/24552https://mirai.mamoe.net/post/24552Thu, 15 Jun 2023 04:01:17 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Thu, 15 Jun 2023 03:58:33 GMT]]>@cssxsh 对了大佬，我最近还发现那个整合包好像有点问题，就是每次关闭cmd命令行之后似乎插件会重置成默认值，我本来改好的配置都失效了，比如auto login里保存的账号密码会恢复成默认的123456和空字符，其他插件config里的配置文件也是如此，而且mirai 的权限也需要重新给，/status都用不了。

]]>https://mirai.mamoe.net/post/24551https://mirai.mamoe.net/post/24551Thu, 15 Jun 2023 03:58:33 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Wed, 14 Jun 2023 10:56:59 GMT]]>@cssxsh 下载了个jdk17,问题已解决,谢谢帮忙

]]>https://mirai.mamoe.net/post/24532https://mirai.mamoe.net/post/24532Wed, 14 Jun 2023 10:56:59 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Wed, 14 Jun 2023 09:59:04 GMT]]>@sjxkfnskdd

从日志来看你安装了 java 8
我的这个插件需要 java 11

]]>https://mirai.mamoe.net/post/24530https://mirai.mamoe.net/post/24530Wed, 14 Jun 2023 09:59:04 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Wed, 14 Jun 2023 04:54:51 GMT]]>d2b39f47-d3c1-4947-96e1-9c77bddd3fe5-image.png
6.11公告中发布的 https://github.com/cssxsh/fix-protocol-version/actions/runs/5233985323 的整合包 console-runtime 貌似无法成功加载这个插件

]]>https://mirai.mamoe.net/post/24523https://mirai.mamoe.net/post/24523Wed, 14 Jun 2023 04:54:51 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Tue, 06 Jun 2023 03:39:06 GMT]]>@cssxsh 在 Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 中说：

./mcl --update-package xyz.cssxsh.mirai:mirai-administrator --channel maven-stable --type plugin

]]>https://mirai.mamoe.net/post/24397https://mirai.mamoe.net/post/24397Tue, 06 Jun 2023 03:39:06 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Tue, 16 May 2023 08:52:20 GMT]]>求教，上线提醒这么写就好了吗fc0facfa-d7de-41a5-867a-fd56a7fe876b-图片.png

]]>https://mirai.mamoe.net/post/24116https://mirai.mamoe.net/post/24116Tue, 16 May 2023 08:52:20 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 13 May 2023 00:58:01 GMT]]>问题：好友多的账号好友列表/friend list拿不到，私聊少数人不回复。

系统：windows sever 2012r2-x64
mirai版本：2.14.0
插件版本: 1.4.0
java：17.0.6

试过两个号

A账号好友不多，50个不到 正常获取好友列表
A账号好友列表

B账号好友有427人，friend list获取不到，只返回bot自身qq
B账号好友列表

两个号都能正常获取/group list（就算B账号有318个群）
群列表
B账号好友数
B账号群数

是mirai获取好友列表失败的问题吗？因为几个插件出现了对少数人私聊插件指令不回的情况（导致要拉群才能使用指令，甚至当事人是administrator设定的所有者也不回，刚上线时是正常回复的，过几十分钟就不行了，需要用其他插件主动向当事人发消息来激活一小会儿，）

]]>https://mirai.mamoe.net/post/24112https://mirai.mamoe.net/post/24112Sat, 13 May 2023 00:58:01 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sun, 16 Apr 2023 08:05:10 GMT]]>已改用gmail的smtp。功能正常！
————————————————
以下是原问题：

想要一个bot下线提醒的功能，我开启了qq邮箱的smtp并在配置文件密码处填好了授权码，结果测试logout登出时一直报无法链接到host，我去qq邮箱的帮助文档里也看到host是smtp.mail.qq.com

mirai版本2.14.0
mcl版本2.1.2
administrator版本1.3.3
以下是报错：

2023-04-16 08:07:03 I/Bot.2040209149: Bot cancelled: Job was cancelled                                                  
2023-04-16 08:07:03 E/mirai-administrator: 邮件发送失败                                                                 
com.sun.mail.util.MailConnectException: Couldn't connect to host, port: smtp.mail.qq.com, 25; timeout -1;                 
nested exception is:                                                                                                          
java.net.UnknownHostException: smtp.mail.qq.com                                                                         
    at mirai-administrator-1.3.2.mirai2.jar[private]//com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:2259)                                                                                                                           
    at mirai-administrator-1.3.2.mirai2.jar[private]//com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:754)                                                                                                                       
    at mirai-administrator-1.3.2.mirai2.jar[shared]//jakarta.mail.Service.connect(Service.java:364)                         
    at mirai-administrator-1.3.2.mirai2.jar[shared]//jakarta.mail.Service.connect(Service.java:222)                         
    at mirai-administrator-1.3.2.mirai2.jar[shared]//jakarta.mail.Service.connect(Service.java:171)                         
    at mirai-administrator-1.3.2.mirai2.jar[shared]//jakarta.mail.Transport.send0(Transport.java:230)                       
    at mirai-administrator-1.3.2.mirai2.jar[shared]//jakarta.mail.Transport.send(Transport.java:100)                        
    at mirai-administrator-1.3.2.mirai2.jar//xyz.cssxsh.mirai.admin.MiraiAdministrator$handle$15.invokeSuspend(MiraiAdministrator.kt:546)                                                                                                           
    at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)                               
    at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:106)                                                         
    at kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely(CoroutineScheduler.kt:570)                                
    at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.executeTask(CoroutineScheduler.kt:750)                       
    at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.runWorker(CoroutineScheduler.kt:677)                         
    at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.run(CoroutineScheduler.kt:664)                       
Caused by: java.net.UnknownHostException: smtp.mail.qq.com                                                                      
    at java.base/java.net.AbstractPlainSocketImpl.connect(Unknown Source)                                                   
    at java.base/java.net.SocksSocketImpl.connect(Unknown Source)                                                           
    at java.base/java.net.Socket.connect(Unknown Source)                                                                    
    at java.base/java.net.Socket.connect(Unknown Source)                                                                    
    at mirai-administrator-1.3.2.mirai2.jar[private]//com.sun.mail.util.SocketFetcher.createSocket(SocketFetcher.java:361)                                                                                                                          
    at mirai-administrator-1.3.2.mirai2.jar[private]//com.sun.mail.util.SocketFetcher.getSocket(SocketFetcher.java:236)                                                                                                                             
    at mirai-administrator-1.3.2.mirai2.jar[private]//com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:2209)
    ... 13 more
]]>https://mirai.mamoe.net/post/23641https://mirai.mamoe.net/post/23641Sun, 16 Apr 2023 08:05:10 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 25 Mar 2023 02:21:38 GMT]]>请求添加 关键词回复功能 已开issue https://github.com/cssxsh/mirai-administrator/issues/22

QSlotus created this issue in cssxsh/mirai-administrator

open 关键词回复功能 #22

]]>https://mirai.mamoe.net/post/23149https://mirai.mamoe.net/post/23149Sat, 25 Mar 2023 02:21:38 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 25 Feb 2023 09:31:07 GMT]]>@cssxsh 开了，#21

]]>https://mirai.mamoe.net/post/22288https://mirai.mamoe.net/post/22288Sat, 25 Feb 2023 09:31:07 GMT<![CDATA[Reply to Mirai Administrator 机器人管理插件，好友/群管理，黑名单，宵禁 on Sat, 25 Feb 2023 08:51:35 GMT]]>@MAX_XiaoKui

有条件开 issue

]]>https://mirai.mamoe.net/post/22287https://mirai.mamoe.net/post/22287Sat, 25 Feb 2023 08:51:35 GMT