自动退群插件

介绍

群成员少于配置值时自动退群，违禁词自动退群，被禁言自动退群，白名单群聊违禁词管理。

安装方式

# 进入 Yunzai 插件目录
cd Yunzai/plugins

# 克隆插件
git clone https://github.com/mmr233/auto-leave-plugin.git

# 安装依赖（可选，更新时会自动安装）
cd auto-leave-plugin && pnpm install

依赖要求

• Yunzai V3
• yaml (已内置)

指令列表

白名单管理

指令	说明	权限
t拉白 [群号]	添加群到白名单	主人
t取消拉白 [群号]	从白名单移除	主人
t白名单	查看白名单列表	主人

黑名单管理

指令	说明	权限
t拉黑 [群号]	添加群到黑名单	主人
t取消拉黑 [群号]	从黑名单移除	主人
t黑名单	查看黑名单列表	主人

违禁词管理

指令	说明	权限
t添加违禁词 内容	添加违禁词（支持批量，逗号分隔）	主人
t删除违禁词 内容/序号	删除违禁词（支持批量）	主人
t违禁词列表	查看违禁词列表	主人

用户黑名单管理

指令	说明	权限
t拉黑用户 QQ号	添加用户到黑名单	主人
t取消拉黑用户 QQ号	从用户黑名单移除	主人
t用户黑名单	查看用户黑名单列表	主人

插件更新

指令	说明	权限
t更新	更新插件	主人
t强制更新	强制更新（丢弃本地修改）	主人
t更新日志	查看更新日志	主人

配置说明

插件支持通过锅巴面板进行可视化配置，也可直接编辑配置文件：

基础配置

• minMemberCount: 最低群成员数量，低于此数量自动退群（默认：50）
• bannedWordTriggerLimit: 违禁词触发次数限制（默认：3）
• muteCountLimit: 禁言次数限制（默认：2）

白名单群管理配置

• whitelistManagement.enabled: 启用白名单群管理功能
• whitelistManagement.bannedWordMuteTrigger: 违禁词触发禁言次数
• whitelistManagement.muteLimitBeforeKick: 踢出前禁言次数
• whitelistManagement.baseMuteDuration: 基础禁言时长（分钟）

功能说明

自动退群触发条件

1. 群成员不足：群成员数量低于配置的最小值
2. 违禁词触发：用户艾特机器人发送违禁词达到次数限制
3. 被禁言：机器人被禁言达到次数限制
4. 黑名单群：机器人被拉入黑名单群聊

白名单群管理

白名单群聊不受上述退群条件影响，但启用了违禁词管理功能：

• 普通用户发送违禁词会被禁言/踢出
• 管理员发送违禁词会收到特殊回复
• 支持自动踢出黑名单用户

更新日志

v1.2.0

• 更新后自动安装依赖
• 自动检测包管理器（pnpm/npm/yarn）
• 优化更新命令提示信息
• 修正描述：群成员少于配置值时自动退群

v1.1.0

• 新增插件 Git 更新功能
• 新增更新日志查看功能
• 新增命令执行工具模块

v1.0.0

• 初始版本
• 实现自动退群功能
• 实现黑白名单管理
• 实现违禁词管理
• 实现白名单群违禁词管理
• 适配锅巴面板

常见问题

Q: 如何让群不触发自动退群？ A: 使用 t拉白 群号 将群添加到白名单。

Q: 违禁词如何触发？ A: 非白名单群需要艾特机器人并发送违禁词才会触发；白名单群直接发送违禁词即可触发管理操作。

Q: 如何关闭禁言自动退群？ A: 在锅巴面板或配置文件中将 muteCountLimit 设置为较大值即可。