Nonebot-Plugin-easy-blacklist

_✨ 一个轻量级的黑名单插件,支持api接入全平台,内存占用优化中✨_

如何下载

两种方法，一种pip安装，一种nb安装

1.nonebot安装

nb plugin install nonebot-plugin-easy-blacklist

1.pip安装

pip install nonebot-plugin-easy-blacklist

配置项

schedule_save_blacklist

类型:bool

定时保存黑名单数据，如果在消息量大的场景建议定时保存，默认是False

schedule_save_time

类型:int

隔多久保存一次数据，默认为120，也就是120秒

check_global

类型:bool

是否开启全局检测黑名单，默认关闭

指令

• 添加黑名单+艾特[QQ号]+空格+原因 可以不填写原因
• 删除黑名单+[QQ号]
• 搜索黑名单+[QQ号] 可批量搜索见如下示例

规则

规则检测仅支持onebot v11

功能检测

如果你需要添加一个功能，而这个功能黑名单用户不能用，我们的api模块还提供了check_hmd参数，添加方法如下

改之前

a = on_command("test")

改之后

a = on_command("test",rule=check_hmd)

全局检测

如果你需要全局检测黑名单用户，只需要添加配置参数，添加一句check_global=True即可！

功能性

• 添加黑名单
• 删除黑名单
• 搜索黑名单
• 批量添加黑名单
• 批量搜索黑名单
• 批量删除黑名单
• 快速搜索
• 开放API
• 全局检测黑名单

API文档

API调用如下代码所示

from nonebot import require,on_command
require("nonebot_plugin_easy_blacklist")
from nonebot_plugin_easy_blacklist import api

a = on_command("test")

@a.handle()
async def _():
    api.add_black(qq="111",time=-1,ly="111",account=-1)
    await a.finish("ok")

API大全

添加黑名单

• 地址:api.add_black

请求参数

返回参数 bool

搜索黑名单

• 地址:api.search

请求参数

返回参数 List[bool,time,account,ly]

删除黑名单

• 地址:api.del_black

请求参数

返回参数 bool

批量添加黑名单

• 地址:api.many_add

请求参数:List[[qq,time,ly,account],[qq,time,ly,account]]

返回参数 bool

批量搜索黑名单

• 地址:api.many_search

请求参数:List[qq,qq,qq]

返回参数:List[[bool,time,account,ly],[bool,time,account,ly]]

批量删除黑名单

• 地址:api.many_del

请求参数:List[qq,qq,qq]

返回参数:List[bool,bool]

性能

实测数据，因电脑配置不同，仅供参考

在黑名单id数量10000000，内存占用266m，1秒内可以被搜索93万次