nonebot-plugin-quote 0.2.2

一款适用于QQ群聊天的语录库插件

nonebot-plugin-quote

✨ QQ群聊 语录库 ✨

🧬 支持OCR识别，关键词搜索 | 一起记录群友的逆天言论吧！🎉

📖 介绍

一款适用于QQ群聊天的语录库插件。

• 上传聊天截图
• 随机投放聊天语录
• 根据关键词投放聊天语录
• 支持白名单内用户删除语录

🎉 使用

上传

@机器人，发送上传指令，开启上传通道。

以图片的形式发送聊天语录，即可将语录上传至语录库中。

随机发送语录

@机器人，发送语录指令，机器人将从语录库中随机挑选一条语录发送。

关键词检索语录

@机器人，发送语录+关键词指令，机器人将从语录库中进行查找。若有匹配项，将从匹配项中随机一条发送；若无匹配项，将从整个语录库中随机挑选一条发送。

删除语录

回复机器人发出的语录，发送删除指令，机器人将执行删除操作。（该操作只允许设置的白名单用户进行，如何设置白名单请看下方配置）

详细命令

默认配置下，@机器人加指令即可。

指令	需要@	范围	说明
上传/开始上传/上传开始	是	群聊	开启语录上传通道
语录上传通道开启后直接发送图片	否	群聊	上传图片至语录库
语录 + 关键词(可选)	是	群聊	根据关键词返回一个符合要求的图片, 没有关键词时随机返回
回复机器人 + 删除	是	群聊	删除该条语录
语句中包含语录	是	群聊	对如何使用语录进行说明

💿 安装

下载

1. 通过包管理器安装，可以通过nb，pip，或者poetry等方式安装，以pip为例

pip install nonebot-plugin-quote -U

2. 手动安装

git clone https://github.com/RongRongJi/nonebot_plugin_quote.git

3. 使用nb-cli安装

nb plugin install nonebot-plugin-quote

⚙️ 配置

在 nonebot2 项目的 .env 文件中添加下表中的必填配置

配置项	必填	默认值	说明
RECORD_PATH	是	空字符串	必要的json文件路径, 示例"/data/record.json"
INVERTED_INDEX_PATH	是	空字符串	必要的json文件路径, 示例"/data/inverted_index.json"
QUOTE_SUPERUSER	否	空字典	白名单字典(分群)
GLOBAL_SUPERUSER	否	空数组	全局管理员(可以删除每个群的语录)

其中，需要在RECORD_PATH和INVERTED_INDEX_PATH中手动创建两个json文件，并在其中填入{}以确保其能够正确运行，如下图所示：

QUOTE_SUPERUSER的示例如下:

{"群号1":["语录管理员qq号","语录管理员qq号"],"群号2":["语录管理员qq号"]}

GLOBAL_SUPERUSER的示例如下:

["全局管理员qq号"]

完整的.env配置可以参考以下内容

 # linux环境下路径
RECORD_PATH=/home/your_name/your_path/record.json      
INVERTED_INDEX_PATH=/home/your_name/your_path/inverted_index.json   

# Windows环境下路径
RECORD_PATH=D:\your_path\record.json       
INVERTED_INDEX_PATH=D:\your_path\inverted_index.json  

QUOTE_SUPERUSER={"12345":["123456"],"54321":["123456","654321]}
GLOBAL_SUPERUSER=["6666666"]

随后，在项目的pyproject.toml或bot.py中加上如下代码，加载插件（根据版本而定）

pyproject.toml中添加

# pip install的填这个
plugins = ["nonebot_plugin_quote"]

# 手动安装的填这个
plugin_dirs = ["nonebot_plugin_quote"]

或

bot.py中添加

# pip install的填这个
nonebot.load_plugin("nonebot_plugin_quote")

# 手动安装的填这个
nonebot.load_plugins("src/plugins", "nonebot_plugin_quote")

Change Log

v0.2.0 (2023/3/20)

• 删除了对Docker OCR的依赖，现在无需使用Docker，直接安装插件运行即可
• 增加了删除语录功能，只有在白名单中的用户拥有删除权限
• 增加了部分gif的OCR能力，但目前并不准确

v0.2.2 (2023/3/21)

• 增加了全局管理员的设置，全局管理员拥有删除每个群语录库的权限
• 修复了一个关于上传后缀名不匹配的bug

🎉 鸣谢

• NoneBot2：本插件使用的开发框架。
• go-cqhttp：稳定完善的 CQHTTP 实现。