nonebot-plugin-qqessentials 0.1.4

A basic plugin that meets a lot of your needs!

这些可爱的丛雨酱是来自@uoouchan的！
これらの可愛いムラサメちゃんは@uoouchanさんからのものです！
These adorable Murasame-chan are from @uoouchan!

nonebot-plugin-QQEssentials

✨ 一个能够满足你很多需求的基础插件！ ✨

📖 介绍

这是一个强大的QQ基础插件，覆盖了群聊管理，好友互动，Bot个人信息状态修改等功能，让你只需要使用指令就能解决很多繁琐的操作！

项目的发展少不了你们的 Issue，请对此插件提出意见或功能请求，我将尽可能实现你们的要求！

💿 安装

[!IMPORTANT] 此插件只支持 nonebot-adapter-onebot 适配器

以下提到的方法 任选其一 即可

[推荐] 使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-qqessentials

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

pip install nonebot-plugin-qqessentials

pdm

pdm add nonebot-plugin-qqessentials

poetry

poetry add nonebot-plugin-qqessentials

conda

conda install nonebot-plugin-qqessentials

uv

uv add nonebot-plugin-qqessentials

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分的 plugins 项里追加写入

[tool.nonebot]
plugins = [
    # ...
    "nonebot-plugin-qqessentials"
]

⚙️ 配置

env 配置示例，变量后面为默认配置:

# 超级用户，必须设置，不然大部分指令无法使用
配置多个超级用户:["123456","234567"]
superusers=[""]

# 命令头，可选配置，默认为 "/"
command_start=["/"]

# 头像上传超时时间（秒）
avatar_upload_timeout=30

# 默认点赞次数，SVIP可考虑修改到20次
default_like_times=10

# 删除好友功能开关（默认关闭，安全考虑）
enable_delete_friend=False

# === 加群请求功能配置 ===

# 加群请求信息推送开关（默认关闭）
enable_group_request_notify=False

# 加群请求推送目标群号列表（只有这些群的加群请求会推送到对应群）
需要 enable_group_request_notify=True
多个群号用逗号分隔，如：["123456789","987654321"]
group_request_notify_target=[]

# === 随机禁言功能配置 ===

# 随机禁言功能开关（默认开启）
# 环境变量：ENABLE_RANDOM_BAN
enable_random_ban=True

# 随机口球/我要口球的时间范围（格式："最小时间-最大时间"，单位：秒，示例："5-60"）
# 环境变量：RANDOM_BAN_TIME_RANGE
random_ban_time_range="5-60"

# 禅定/精致睡眠的禁言时间（秒，默认36000秒=10小时）
# 环境变量：LONG_BAN_TIME
long_ban_time=36000

# === 词库功能配置 ===

# 词条添加等待超时时间（秒，默认60秒）
# 环境变量：LEXICON_TIMEOUT
lexicon_timeout=60

🎉 使用

主要指令

带 "/" 则需要配置 COMMAND_START (默认为 "/")
带 "*" 则为 SUPERUSERS 才可以触发
带 "&" 则为 群管理，SUPERUSERS 才可以触发

• */QQEss帮助 - 主要帮助，有多个分页
• */状态设置 - 机器人在线状态设置，支持40+种个性状态，详情请见 /状态帮助
• */发送私聊 群消息 123456 - 详情请见 /消息发送帮助
• &/同意加群请求 or /拒绝加群请求 [理由] - 处理群聊的加群请求，需要配置 group_request_notify_target
• &设精 取精 - 对消息进行精华设置/取消操作
• 戳我 - 戳戳你的❤
• 戳@Murasame - 戳戳丛雨酱❤Ciallo～(∠・ω< )⌒★(此处指的是你在群内@的对象)

效果图

📞 联系

TG群组：点此加入 柚子厨群：1049319982 邮箱：[e-mail]

💡 鸣谢

NapCat - 高强度研究其接口实现不同功能

📝 更新日志

芝士刚刚发布的插件，还没有更新日志的说 qwq~