OlivOSOnebotV11

Onebot V11 for OlivOS

基于OlivOS的OneBot协议端，可以基于OlivOS实现多后端对多账号、多平台的支持。

鸣谢

本项目基于以下项目进行开发

• OlivOS-Team/OlivOS
• dpallot/simple-websocket-server
• OneBot

项目特点

• 采用了无扩展的实现方式，采用分端口的方式完美的实现了对于多账号的支持，可以无修改的支持现存的OnebotV11协议应用后端。
• 采用了ID映射机制，可以使CQ时代的后端完全无修改的适配诸如QQ开放平台这类ID并非纯数字的平台。
• 采用了群组映射机制，可以使CQ时代的后端完全无修改的适配诸如KOOK、Discord这类存在多层群组的平台。
• 多账号，丰富的映射机制，以及完整的交叉支持，基于先进的OlivOS对于大量平台的适配使得本项目可以完美的支持多账号，多后端，多平台的组合。

开始使用

在不进行任何设置的前提下即可使用本插件，你可以通过插件菜单打开设置面板查看并修改端口，未设置时将在第一次启动时为每个账号生成一个可用端口。

进阶使用

在OlivOS的0.9.7版本后的启动流程中你将能直接在日志中看到如下内容，其表明了每个已被加载的账号被分配到的的hash

[2022-03-23 23:06:50] - [INFO] - init account from [./conf/account.json] ... done
[2022-03-23 23:06:50] - [INFO] - generate [qq] account [123456789] as [3cfede0d58a99a0fe71846310e9cac47] ... done
[2022-03-23 23:06:50] - [INFO] - generate [telegram] account [456789123] as [48781dc6c1de335c504572b51420ea52] ... done
[2022-03-23 23:06:50] - [INFO] - generate [kaiheila] account [987654321] as [dea0b0e07ef3728456d4520eedc62fe7] ... done
[2022-03-23 23:06:50] - [INFO] - generate account ... all done

你需要创建或编辑plugin/data/OlivOSOnebotV11/config.json文件，其结构示例如下

{
    "route": [
        {
            "hash": "3cfede0d58a99a0fe71846310e9cac47",
            "port": 44007
        },
        {
            "hash": "48781dc6c1de335c504572b51420ea52",
            "port": 44008
        },
        {
            "hash": "dea0b0e07ef3728456d4520eedc62fe7",
            "port": 44009
        }
    ],
    "r-route": [
        {
            "hash": "3cfede0d58a99a0fe71846310e9cac47",
            "path": []
        },
        {
            "hash": "48781dc6c1de335c504572b51420ea52",
            "port": [
                "ws://127.0.0.1:8080/onebot/v11/ws"
            ]
        },
        {
            "hash": "dea0b0e07ef3728456d4520eedc62fe7",
            "port": []
        }
    ]
}

你还可以在route中设置正向WS服务，这表明了每个账号将会在分别对应的端口开启正向WS服务，如果设置成功，你将会看到如下日志内容

[2022-03-23 23:06:54] - [INFO] - [OlivOSOnebotV11] - 账号 [qq|123456789] 运行于Websocket，请使用 [ws://127.0.0.1:44007] 进行连接
[2022-03-23 23:06:54] - [INFO] - [OlivOSOnebotV11] - 账号 [telegram|456789123] 运行于Websocket，请使用 [ws://127.0.0.1:44008] 进行连接
[2022-03-23 23:06:54] - [INFO] - [OlivOSOnebotV11] - 账号 [kaiheila|987654321] 运行于Websocket，请使用 [ws://127.0.0.1:44009] 进行连接

并且，当你的后端完成连接时，你将看到如下日志内容，这意味着你的整个配置过程已经彻底完成，并将开始正常运作

[2022-03-23 23:07:12] - [INFO] - [OlivOSOnebotV11] - ('::ffff:X.X.X.X', YYYYY, 0, 0) - connected to [44008] for [telegram|456789123]

此外，你还可以在r-route中设置反向WS服务，OlivOSOnebotV11将会主动连接至你设置的地址，如果连接成功，你将会看到如下日志内容

[2022-03-23 23:07:12] - [INFO] - [OlivOSOnebotV11] - ws://127.0.0.1:8080/onebot/v11/ws - connected for [48781dc6c1de335c504572b51420ea52]

需要注意

本插件虽然可以基于OlivOS实现后端服务的跨平台，但是仍然需要后端服务本身给予足够的业务逻辑支持。