nonebot-plugin-ntqq-restart 0.1.4

A plugin for restarting NTQQ when bot disconnection

nonebot-plugin-ntqq-restart

✨ 一个简易的Bot断连重启NTQQ的插件 ✨

⚠警告

①本插件仅适用于Windows用户！（原理上使用了WinAPI和Win命令行）

②本插件由于Windows的窗口句柄的原因，在插件开启/关闭时会杀死存在的所有QQ进程！

③本插件只适用于NTQQ登录过期的情况（此情况仍旧可以重启后正常登录），
对于其他情况（包括但不限于账号冻结、版本过低），无法提供有效的解决方案 !

📖 介绍

此插件主要用于帮助llonebot用户在长时间运行机器人的情况下， 遇到的NTQQ登录过期导致Bot下线的情况。

当Bot断连时，本插件会自动重启NTQQ并窗口最小化。（账号登录靠NTQQ自带的自动登录）

💿 安装

使用 nb-cli 安装

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

nb plugin install nonebot-plugin-ntqq-restart

使用包管理器安装

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

pip

pip install nonebot-plugin-ntqq-restart

pdm

pdm add nonebot-plugin-ntqq-restart

poetry

poetry add nonebot-plugin-ntqq-restart

conda

conda install nonebot-plugin-ntqq-restart

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

plugins = ["nonebot-plugin-ntqq-restart"]

⚙️ 配置

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

配置项	必填	默认值	说明
NTQQ_Path	是	无	NTQQ的.exe文件的完整路径
enable_restart_when_disc	否	True	允许Bot断连后重启NTQQ
enable_login_when_nbrun	否	False	允许nb加载时运行NTQQ
enable_close_qq_when_shutdown	否	False	允许nb关闭时关闭NTQQ
restart_after_disc_time	否	10	在Bot断连的{int}秒后重启NTQQ
retry_max_time	否	5	重试NTQQ窗口最小化的最大时间(秒)

🎉 使用

①插件配置

你可以参照配置文件示例或文档-配置以配置插件参数

②NTQQ端设置（此两个选项保持打开状态）

③配置后直接运行nonebot即可

nb run

效果图