MizurenNanako / LiteLoaderQQNT-RawApi

LiteloaderQQNT的消息API插件

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

LLOneBot API

将NTQQLiteLoaderAPI封装成OneBot11/12标准的API, V12没有完整测试

注意:本文档对应的是 LiteLoader 1.0.0及以上版本,如果你使用的是旧版本请切换到本项目v1分支查看文档

安装方法

1.安装LiteLoaderQQNT

2.安装修改后的LiteLoaderQQNT-Plugin-LLAPI,原版的功能有缺陷

3.安装本项目插件OneBotApi, 注意本插件2.0以下的版本不支持LiteLoader 1.0.0及以上版本

关于插件的安装方法: 上述的两个插件都没有上架NTQQLiteLoader插件市场,需要自己下载复制到插件目录

插件目录:LiteLoaderQQNT/plugins

支持的API

目前只支持http协议POST方法,不支持websocket,事件上报也是http协议

主要功能:

  • 发送好友消息
  • 发送群消息
  • 获取好友列表
  • 获取群列表
  • 获取群成员列表
  • 撤回消息
  • 上报好友消息
  • 上报群消息

消息格式支持:

  • 文字
  • 图片
  • 引用消息
  • @群成员
  • 发送语音(只测试了silk编码的amr)
  • 转发消息记录
  • xml

支持的api:

  • get_login_info
  • send_msg
  • send_group_msg
  • send_private_msg
  • delete_msg
  • get_group_list
  • get_group_member_list
  • get_group_member_info
  • get_friend_list

自己发送成功的消息也会上报,可以用于获取需要撤回消息的id

示例

暂时不支持"message": "hello"这种message为字符串的形式

一些坑

下载了插件但是没有看到在NTQQ中生效
检查是否下载的是插件release的版本,如果是源码的话需要自行编译。依然不生效请查阅LiteLoaderQQNT的文档

调用接口报404
目前没有支持全部的onebot规范接口,请检查是否调用了不支持的接口,并且所有接口都只支持POST方法,调用GET方法会报404

发送不了图片和语音
检查当前操作用户是否有LiteLoaderQQNT/data/LLOneBot的写入权限,如Windows把QQ上安装到C盘有可能会出现无权限导致发送失败

不支持cq码
cq码已经过时了,没有支持的打算(主要是我不用这玩意儿,加上我懒)

onebot 12对接不了
onebot 12只写了部分兼容,没有完整测试,不保证能用,慎用

QQ多开时事件没有上报
小概率事件,有可能是IPC通信串台了(不确定),重启QQ可解决,目前正在想办法修复

QQ变得很卡
这是你的群特别多导致的,因为启动后会批量获取群成员列表,获取完之后就正常了

如何查看日志
LiteLoaderQQNT/data/LLOneBot/*.log

TODO

  • 接口返回更详细的错误信息,目前消息发不出去也会返回发送成功(这河里吗)
  • 转发消息记录
  • 支持websocket,等个有缘人提PR实现
  • 重构摆脱LLAPI,目前调用LLAPI只能在renderer进程调用,需重构成在main进程调用

onebot11文档

https://11.onebot.dev/

About

LiteloaderQQNT的消息API插件


Languages

Language:TypeScript 95.1%Language:JavaScript 4.9%