本插件为 AstrBot 提供了强大的新成员智能验证功能,能有效过滤广告机器人和可疑用户,全面提升群聊质量。
- 🧠 动态数学题验证:新成员需回答随机生成的 100 以内加减法问题,代替呆板的静态关键词,极大提升验证强度。
- 🏢 分群启用 (White-list):支持指定特定群号开启验证,未在名单内的群组将不触发验证流程,更加灵活。
- 🔄 错误重试与上限:回答错误后自动生成新题,超过设定次数直接踢出,兼顾容错与防刷屏。
- 🔀 多群隔离:同一用户同时加入多个验证群时,各群验证状态互不干扰。
- ⏱️ 多段式时间控制:自定义验证总时长、超时前警告时机、失败后踢出延迟等,答错不重置计时。
- 🎨 完全可定制化消息:欢迎语、错误提示、超时警告、踢出公告等均可自定义,支持丰富变量。
- 🛡️ 安全生命周期:插件卸载/重载时自动取消所有后台任务,不会产生资源泄漏。
展开查看详细安装步骤
- 打开 AstrBot 插件管理界面。
- 在插件市场搜索
astrbot_plugin_Group-Verification_PRO并安装。 - 安装完成后,进入插件配置页面进行参数设置。
- 保存配置并重启机器人,或在插件管理中手动重载本插件。
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled_groups |
list | [] |
启用插件的群号列表。留空则全局生效,否则仅对名单内的群生效。 |
max_retries |
int | 3 |
最大答错重试次数。超过后直接踢出。设为 0 表示不限制。 |
verification_timeout |
int | 300 |
验证总超时时间(秒)。 |
kick_countdown_warning_time |
int | 60 |
超时前发送警告的秒数。设为 0 可禁用警告。 |
kick_delay |
int | 5 |
发送"验证超时"消息后延迟踢出的秒数。 |
new_member_prompt |
text | 见下方 | 新成员入群时发送的欢迎及验证提示语。 |
welcome_message |
text | 见下方 | 验证成功后的祝贺提示语。 |
wrong_answer_prompt |
text | 见下方 | 回答错误后的提示语(自动附带新题)。 |
countdown_warning_prompt |
text | 见下方 | 验证即将超时时的警告消息。 |
failure_message |
text | 见下方 | 验证超时后、踢出前的"最后通牒"消息。 |
kick_message |
text | 见下方 | 成员被踢出后在群内的公开通知。 |
| 变量 | 说明 | 适用模板 |
|---|---|---|
{at_user} |
@目标用户的 CQ 码 | 所有模板 |
{member_name} |
用户的群名片或 QQ 昵称 | 所有模板 |
{question} |
随机生成的数学题(如 76 + 24 = ?) |
new_member_prompt、wrong_answer_prompt |
{timeout} |
验证超时时长(分钟) | new_member_prompt |
{countdown} |
踢出前的延迟秒数 | failure_message |
- 白名单设置:在
enabled_groups中填入需要开启验证的群号。若保持为空,则插件会对机器人加入的所有群组生效。 - 验证流程:新成员入群后,机器人会 @ 该成员并出题。成员需在规定时间内 @ 机器人 并回复数字答案。
- 容错机制:回答错误后系统会更换题目,但不会重置超时计时。超过
max_retries次答错将直接踢出。 - 清理逻辑:如果成员在验证期间主动退群,系统会自动撤销验证任务,释放资源。
- 多群场景:同一用户同时加入多个启用验证的群时,各群验证独立进行,互不影响。
-
Q: 为什么输入正确答案没反应?
A: 请确保回复时 @了机器人。为了避免干扰日常聊天,插件仅识别 @ 机器人的验证消息。 -
Q: 机器人没有踢人权限?
A: 请确保机器人帐号拥有 群管理员 或 群主 权限。 -
Q: 如何彻底关闭某个群的验证?
A: 如果你设置了enabled_groups,只需将该群号移出列表;如果列表为空,则需要在 AstrBot 插件管理中禁用本插件。 -
Q: 答错后计时会重置吗?
A: 不会。答错只会换题,超时计时从入群那一刻开始,不会因答错而延长。 -
Q: 支持哪些消息平台?
A: 目前仅支持 aiocqhttp(OneBot v11 协议),如 NapCat、Lagrange 等。
本版本为架构级重构,提升了稳定性、并发安全性和可维护性。
- 🆕 新增:
max_retries配置项,答错超过次数直接踢出,防止恶意刷屏。 - 🆕 新增:多群隔离,同一用户同时加入多个群时验证状态互不冲突。
- 🆕 新增:
terminate()生命周期方法,插件卸载/重载时自动取消所有后台任务。 - 🔧 优化:答错不再重置超时计时,防止恶意用户通过反复答错无限续命。
- 🔧 优化:使用
asyncio.Lock保护并发状态访问,消除竞态条件。 - 🔧 优化:存储 bot 引用到验证状态中,不再依赖非公开 API
get_platform().get_client()。 - 🔧 优化:使用
@filter.platform_adapter_type装饰器替代手动平台判断。 - 🔧 优化:消息模板配置类型改为
text,WebUI 编辑体验更好。 - 📝 变更:元数据迁移至
metadata.yaml,移除@register装饰器。
此版本重点解决了在复杂网络环境下或接收特殊事件时插件崩溃的问题。
- 🐛 修复:解决了在处理非标准事件时,由于
raw_message为空导致的'NoneType' object has no attribute 'get'严重报错。 - 🔧 优化:将事件过滤器调整为
EventMessageType.ALL,确保能更稳健地捕获入群通知(Notice)事件。 - 🛡️ 健壮性:增加了防御性编程检查,确保在数据异常或平台 API 调用失败时插件不会崩溃。
- 🆕 新增:分群启用功能,新增
enabled_groups配置项,支持白名单模式。 - 🔧 优化:完善数学题重试逻辑,确保每次回答错误后生成的题目具有随机性。
- 🐛 修复:解决了因
from astrbot.api.bot import Bot在部分版本中不兼容导致的ModuleNotFoundError。
- 🐛 修复:修复了
_timeout_kick函数中不完整代码行导致的语法错误。
- 🔧 优化:重构消息格式化逻辑,模板缺少占位符时不再崩溃。
- 🔧 优化:升级答案提取算法,智能识别用户回复中的数字。
- 🆕 核心验证方式从静态关键词升级为 100 以内动态数学题验证。
- 🆕 新增验证超时前警告、错误重试、自定义踢出延迟功能。
- 作者:huotuo146
- 🌐 GitHub:huntuo146
- 📧 Email:support@mali.yumeacg.com
- 🔗 项目地址:astrbot_plugin_Group-Verification_PRO
本项目采用 AGPLv3 许可证 开源。
如果您觉得这个插件有用,请考虑给项目一个 ⭐Star!
Made with ❤️ by huotuo146