2024-03-24

Overflow 溢出核心——基于LLOneBot实现与部署 [置顶]

猫猫式 mirai 实现于 Onebot 11。
让 mirai 框架加入 Onebot 大家庭!

前言

Overflow

Overflow 是 mirai-core-api 的实现，该项目因腾讯官方持续更新签名算法打击机器人社区而产生，产生目的是扩展 mirai 的可用范围，当实在没有人更新 mirai-core 的协议实现时，可使用本项目将 mirai 接口嫁接到 Onebot 实现上，以实现快速迁移，而无需修改原有业务代码。

LiteLoaderQQNT

LiteLoaderQQNT 是 QQNT 的插件加载器，一般在 QQNT 的环境内简称为 LiteLoader。它可以让你自由地为 QQNT 添加各种插件，并实现例如美化主题、增加功能等各种功能。

LLOneBot API

LLOneBot API是LiteLoaderQQNT的一个插件，使你的NTQQ支持OneBot11协议进行QQ机器人开发。

快速开始

本人部署在Windows端，其他操作系统部署方法类似。

一、安装QQNT

进入QQ PC版官方网站，选择全新版本下载并安装。
QQNT
注意：强烈建议使用小号！

二、安装LiteLoaderQQNT

注意在安装之前请先关闭 QQ ！
推荐使用一键安装脚本，支持 Windows、Linux、MacOS.
手动安装见LiteLoaderQQNT文档
注：一键安装脚本请以管理员身份运行，运行成功结果如下：

安装成功后打开QQ的设置，看到了 LiteLoaderQQNT 就代表安装成功了.

三、安装LLOneBot

下载LLOneBot 最新版本解压放到 plugins 目录下，然后重启 QQ 即可.
注：plugins 目录可以在 LiteLoaderQQNT 的页面找到并一键打开.
plugins目录1
plugins目录2
plugins目录3
目录结构如下：

├── plugins
│   ├── LLOneBot
│   │   └── main/main.cjs
│   │   └── preload/preload.cjs
│   │   └── renderer/index.js
│   │   └── manifest.json
│   │   └── node_modules/...

重启QQ后检查是否安装成功
LLOneBot
至此OneBot部署完毕。

四、下载 Overflow + mirai-console 整合包

进入Overflow官网，根据自己的网络环境选择下载源，然后点击刷新版本。选择最新overflow版本后点击下载。
overflow1
(补充：如果版本加载不出来，可以使用已修改的MCL安装。)
下载后解压并运行start.bat
overflow2
出现下图即可关闭
overflow3
文件夹内生成配置文件。打开配置文件 overflow.json 以备用。
overflow4

五、OneBot对接配置

Onebot 实现部署完成后，取得其 正向 WebSocket 地址 或 反向 WebSocket 地址，任选其一填入配置文件中，再次启动即可。

1.正向WebSocket

用于接受应用端的正向WS连接。即让 Overflow 去连接 Onebot 协议实现。
如正向 ws 绑定的端口为 3001
需要在应用端配置的WS地址为 ws://localhost:3001
websocket1

{
    "ws_host": "ws://localhost:3001",
    "reversed_ws_port": -1,
    "token": "",
    "no_platform": false,
    "retry_times": 5,
    "retry_wait_mills": 5000,
    "retry_rest_mills": 60000
}

websocket2
点击保存后运行start.bat,出现已连接到服务器字样即可。
websocket3

2.反向WebSocket

用于LLOneBot主动连接应用端绑定的反向WS地址
如在 overflow 配置了 onebot 的端口为 3002
那么在 LLOneBot 配置的反向WS地址为 ws://localhost:3002
websocket4

{
    "ws_host": "ws://localhost:3001",
    "reversed_ws_port": 3002,
    "token": "",
    "no_platform": false,
    "retry_times": 5,
    "retry_wait_mills": 5000,
    "retry_rest_mills": 60000
}

websocket5
点击保存后运行start.bat，出现反向WebSocket客户端已连接字样即可
websocket6
可选：鉴权令牌，可自定义
websocket7
websocket8

六、总结

以上将 mirai 接口嫁接到 Onebot 实现上，以实现快速迁移，而无需修改原有业务代码。

前言