Caution
警告，目前此插件只能用于9.9.15版本以下的NTQQ，新版本的NTQQ禁止使用本插件，否则会因路径异常无法运行！
由于开发者精力有限，暂时不会进行新版本QQ的适配，新版本请自行使用 install_llob 进行安装！
Caution
请不要在任何影响力较大的简中互联网平台（包括但不限于哔哩哔哩、抖音），发布和讨论任何与LLOB、本插件存在相关性的信息！
Warning
仅 Windows系统 可使用本插件！！！
Important
推荐在 Windows10或更高版本 或 Windows Sever 2019或更高版本 使用此插件。
Note
觉得好用的话，就给个⭐Star吧！
- 检查NTQQ更新
- 检查LLOB更新
- 自动安装LLOB
- 自动配置LLOB
- 断连重启NTQQ
- 指令更新LLOB
本插件可帮助小白 用Windows系统一键安装LLOB 并 对接NoneBot ，
每次启动NoneBot时，还可 自动检查LLOB版本更新并自动安装 ,
以及 自动管理NTQQ进程 (启动、断连重启) 。
Important
本插件适合LLOB与NoneBot同时运行在同一台机器上的用户
使用本插件管理进程并开启自动登录，即可做到命令行nb run自动连接Bot！
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-llob-master
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令pip
pip install nonebot-plugin-llob-master
pdm
pdm add nonebot-plugin-llob-master
poetry
poetry add nonebot-plugin-llob-master
conda
conda install nonebot-plugin-llob-master
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot-plugin-llob-master"]
在 nonebot2 项目的.env文件中添加下表中的必填配置
| 配置项 | 必填 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| LM_NTQQ_Path | 否 | str | None | NTQQ的.exe文件的路径 |
| LM_Enable_LookUp_Reg | 否 | bool | False | 允许从注册表查询NTQQ路径 |
| LM_NTQQ_Update_Check | 否 | bool | True | 允许插件加载时, 检查NTQQ版本更新 (只进行提醒) |
| 配置项 | 必填 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| LM_LLOB_Update_Check | 否 | bool | True | 允许插件加载时, 检查LLOB更新(只进行提醒) |
| LM_LLOB_First_Auto_Install | 否 | bool | True | 允许插件没有检测到LLOB时(大概率没安装), 自动安装LLOB |
| LM_LLOB_Auto_Install | 否 | bool | False | 允许插件检测到LLOB有新版本时, 自动安装LLOB |
| LM_LLOB_First_Auto_Setting_QQID | 否 | int | None | (可选)此处填QQ号, 当插件初次安装LLOB时, 自动为你填写一份初始LLOB配置，NTQQ启动并登录该QQ号时，可直接连接Bot |
| 配置项 | 必填 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| LM_Enable_Auto_Restart | 否 | bool | False | 允许插件管理你的NTQQ进程, 并且Bot断连时自动重启NTQQ |
| LM_Restart_Time | 否 | int | 10 | 在Bot断连的 {LM_Restart_Time} 秒后重启NTQQ |
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
| 检查更新 | 超级用户（机器人管理员） | 否 | 私聊/群聊 | 指令别名：更新LLOB、检查LLOB更新 |
Warning
使用指令更新需要已经安装了LLOB才能正常使用!
Important
启用自动管理NTQQ进程以及配置NTQQ登录设置，指令更新LLOB效果会更好！
Important
此处已假设你已经安装NoneBot2、FastAPI驱动器、OneBotV11适配器，
如果上述未安装，请先参考NoneBot2官方文档进行安装!
此处一并假设你已经安装成功本插件！
在 nonebot2 项目的.env文件中设置监听IP和端口，例如：
HOST=0.0.0.0 # 配置 NoneBot 监听的 IP / 主机名
PORT=8080 # 配置 NoneBot 监听的端口
Note
当使用第一次安装LLOB并自动配置LLOB时， 会使用端口号自动生成反向WS地址以连接Bot
请在 nonebot2 项目的.env文件中进行配置：
（“⚠”代表必选，“👍”代表推荐选择）
⚠①配置你的NTQQ路径
方法一 (使用指定路径下的NTQQ)：
LM_NTQQ_Path="C:\Users\Administrator\Desktop\QQNT\QQ.exe" # 此处替换成你的路径
方法二： (使用系统默认安装的NTQQ)：
LM_Enable_LookUp_Reg=True # 直接查询注册表获取NTQQ路径 (可不填，默认False)
Note
当插件检测不到配置中“NTQQ路径”时，
会根据配置中是否“允许查询注册表”，再次从注册表查询NTQQ路径。
（查询注册表适用于用默认安装的NTQQ的情况）
(可选) ②启动时检查NTQQ更新：
LM_NTQQ_Update_Check=True # 设置为'False'则关闭 (默认True)
👍③启动时检查LLOB更新：
LM_LLOB_Update_Check=True # 设置为'False'则关闭 (默认True)
Note
启用“检查LLOB更新”才能激活后面的功能(自动安装、配置)
若你初次安装使用LLOB，可在“LM_LLOB_First_Auto_Setting_QQID”填上自己的账号,
在安装完成后，启动程序并登录该账号，预设配置会直接生效，连接上Bot。
(可选) ④检测到LLOB更新时，自动安装新版本：
LM_LLOB_Auto_Install=True # 设置为'False'则关闭 (可不填，默认False)
👍⑤(可选) 没有检测到LLOB时，自动安装LLOB：
LM_LLOB_First_Auto_Install=True # 设置为'False'则关闭 (可不填，默认True)
👍⑥(可选) 没有检测到LLOB时，自动安装LLOB后，自动生成LLOB配置（登录该账号即可直接连接Bot）：
LM_LLOB_First_Auto_Setting_QQID=<要登录的账号> # 填整数，直接替换“<要登录的账号>”的字符 (可不填，默认None)
👍⑦自动管理NTQQ进程，并在Bot断连时重启进程：
LM_Enable_Auto_Restart=True # 设置为'False'则关闭 (可不填，默认False)
Note
NTQQ、LLOB更新检查完之后，若允许“自动管理NTQQ进程”，会自动启动NTQQ， 若Bot断连，则会自动重启NTQQ。
Warning
断连重启 只适用于登录过期的情况（此情况仍旧可以正常登录）
对于其他情况（包括不限于账号封禁），无法提供有效的解决方案 !
(可选) ⑧断连时经过多少秒重启NTQQ：
LM_Restart_Time=10 # (可不填，默认10秒)
Important
🤓☝️️此处假设我是一个小白
①很久以前，有一个小白，他在 nonebot2 项目的.env文件配置如下：
# NoneBot的配置
DRIVER=~fastapi
HOST=0.0.0.0 # 配置 NoneBot 监听的 IP / 主机名
PORT=8080 # 配置 NoneBot 监听的端口
COMMAND_START=["/", ""] # 配置命令起始字符（一般配置成这样比较好）
COMMAND_SEP=[" "] # 配置命令分割字符（一般采用空格分割命令参数）
SUPERUSERS=["1919810"] # 小白的账号，用于管理机器人
# LLOneBot-Master的配置
LM_NTQQ_Path = "C:\Users\Administrator\Desktop\QQNT\QQ.exe"
LM_LLOB_Auto_Install = True # 允许启动时自动安装新版本LLOB
LM_LLOB_First_Auto_Install = True # 没检测到安装LLOB时，自动安装
LM_LLOB_First_Auto_Setting_QQID = 114514 # 小白的 机器人 账号，填写后初次安装后，自动生成LLOB账号配置
LM_Enable_Auto_Restart = True # 允许管理NTQQ进程，断连重启
②配置完毕，小白启动了NoneBot！
Note
看！小白只是启动了NoneBot，其他事压根不用做！
剩下的事只是动动手指，登录配置的账号，就能连接Bot啦！
③小白打开了NTQQ的设置，启用了这些选项！
Important
咦？小白为什么要设置这些呢？
！！！
原来，这样就可以让插件更好管理NTQQ，实现自动登录、断连重启啦！
④小白不信邪，非要测试下断连重启！
⑤小白的故事结束了，你觉得LLOneBot-Master的表现如何呢？
看到这里，也别忘记👇👇👇
Caution
请不要在任何影响力较大的简中互联网平台（包括但不限于哔哩哔哩、抖音），发布和讨论任何与LLOB、本插件存在相关性的信息！