趣绮梦云黑检测插件
这是一个为 AstrBot 开发的插件，用于检测并自动踢出在趣绮梦云黑平台上有不良记录的用户。
功能特性
- 进群自动检测: 当新成员加入群聊时，自动检测其是否在云黑名单中
- 批量扫描: 可以对群内所有成员进行云黑状态扫描
- 安全踢出: 发现云黑成员后自动踢出，并可配置拒绝再次申请入群
- 防误踢机制: 提供确认踢出机制，避免误操作
- 频率限制: 内置API请求频率限制，避免对服务器造成过大压力
- 群组白名单: 可配置仅在指定群中启用自动检测功能
安装方法
- 在 AstrBot 管理界面中安装本插件
- 重启 AstrBot 以加载插件
配置说明
在插件配置中需要设置以下配置项：
必需配置
api_key: 趣绮梦云黑API Key- 请在趣绮梦云黑平台申请API Key
可选配置
auto_check_whitelist: 进群自动检测云黑功能的群白名单- 仅在列表中的群启用进群自动检测云黑功能
- 留空则在所有已启用群功能中生效
使用方法
命令列表
| 命令 | 功能说明 |
|---|---|
大扫除 |
扫描当前群内所有成员的云黑状态 |
确认踢出 |
确认踢出之前扫描发现的云黑成员 |
自动检测
当有新成员加入已在白名单中的群聊时，插件会自动检测该成员是否在云黑名单中。如果检测到该成员在云黑库中，则会：
- 自动将其踢出群聊
- 发送通知消息说明踢出原因
手动扫描
群管理员可以发送 大扫除 命令对群内所有成员进行一次全面扫描，插件会：
- 获取群成员列表
- 批量查询每个成员的云黑状态
- 显示所有检测到的云黑成员信息
- 等待管理员确认是否踢出
发送确认踢出命令后，插件会：
- 踢出所有检测到的云黑成员
- 显示操作结果（成功/失败数量）
注意事项
- 请妥善保管您的API Key，不要泄露给他人
- 插件有内置频率限制（20次请求/5秒），请不要尝试绕过
- 自动踢出功能需要机器人具有管理员权限
- 建议首次使用时先进行手动扫描，确认功能正常后再启用自动检测
版本更新
v3.5.1
- 增强了对群成员列表中无效用户ID的过滤机制
- 修复了群成员数量统计可能不准确的问题
- 添加了对用户ID位数的验证（QQ号最少为5位数）
v3.5.0(大更新支持添加扩展插件)
- 支持添加扩展插件图片生成扩展不添加默认使用文字大扫除结果添加扩展可自定义图片生成大扫除结果asbot_plugin_furry-API-hykz
v3.4.1
- 修复了API返回格式错误时的JSON解析问题
- 增强了对无效用户ID的处理能力
- 优化了批量扫描时的用户数量统计准确性
v3.4.0
- 增加了进群自动检测云黑功能的群白名单配置
- 创建了共享的httpx.AsyncClient以优化请求速度
- 增强了API请求频率限制机制
v3.3.0
- 初始版本，实现基本功能
前面的懒着写惹
作者信息
- 作者：furryhm
- 联系QQ：3322969592
- 项目仓库：GitHub
免责声明
本插件仅提供云黑信息查询功能，不保证信息的准确性和时效性。使用本插件造成的任何后果由使用者自行承担。