[ 提醒 ] Bot 框架的适配情况

Stapxs commented 10 months ago

支持列表

此 issue 下是关于其他支持或不支持 Onebot 11 的 bot 的适配相关进度支持。(按功能完整度排序）

NapCat.OneBot / LLOneBot
Lagrange.OneBot
go-cqhttp
oicq（及其衍生）：由于我没法用 oicq 了，所以放弃了新版本的兼容

提醒

SQL2 使用正向 WebSocket 连接到 Bot，你需要为 Bot 打开正向 WebSocket 的相关功能并使用设置的端口连接。
SQL2 将默认加载 Napcat.OneBot 的配置文件，它兼容 gocq 的端点；如果你想要尝试连接一个不在此列表上的 bot，并且它兼容 gocq，那理论上说应该也能正常工作，如：opq-onebot、gensokyo 等。但是它们并没有经过兼容适配，如果遇到问题，欢迎提出新的 issue！

适配请求

如果你有 Bot 适配请求，请使用空白模版创建新的 issue；如果你是列表中某个 Bot 的开发者并且愿意跟进兼容性适配，您可以参考下面的端点列表考虑实现缺失的功能，OneBot11 协议端点是必须实现的功能，其他的没有也可以用；你可以在本 issue 直接反馈兼容进度。

使用到的端点

Bot 需要支持基本的 OneBot11 规范；目前使用到了以下端点来提供完整的功能

OneBot11 协议端点

这些是来自 Onebot11 规范的端点，这些端点用于 sql 最基本的功能实现；如果 bot 支持了这些端点，理论上说 sql 就能正常工作。

get_group_member_info - 自己在群内的详细信息、群内 AT 悬浮窗的内容
get_group_member_list - 群成员列表
get_system_msg - 主动刷新系统消息（好友、群申请之类的）
get_version_info - Bot 信息面板，同时用于 Bot 类型区分
get_login_info - 登录初始化信息
get_msg - 主动获取消息，主要用在没有开上报自己消息的情况下获取发送的消息
get_forward_msg - 合并转发消息面板
get_chat_history - 获取历史消息记录（可以拆为私聊群聊两个）
get_friend_list - 好友列表
get_group_list - 群列表
get_class_info - 分组信息（分组 class_id 对应的名字），用于显示分组
send_msg - 发送消息（可以拆为私聊群聊两个）
delete_msg - 撤回消息
set_group_kick - 群组踢人
set_friend_add_request - 好友请求处理
set_group_add_request - 群请求处理

扩展端点

这些端点是用来扩展一些功能的，如果没有也无伤大雅；但是有最好啦。

fetch_custom_face - 收藏表情列表
get_file_url - 获取文件下载链接（如果消息里没有返回）
get_video_url - 获取视频直链用于显示播放（如果消息里没有返回）
set_message_read - 设置消息已读，用于清除其他客户端的新消息提醒
send_temp_msg - 临时会话发送消息
set_nickname - 设置昵称
set_signature - 设置签名

SQL2 扩展端点

http_proxy - （计划遗弃）代理请求 Web API，主要用于获取一些从 Web API 请求的东西；由于 SQL2 是个 Web 应用，由前端直接请求会遇到跨域问题；同时对用户的 Cookie 来说也不安全。提供以下功能：群组文件功能、用户拓展信息、群组拓展信息、群公告功能、精华消息。有些 Bot 可能提供了单独的端口实现上述的某些功能，在未来这个功能或许可以被完全替换掉。

Stapxs commented 9 months ago

Lagrange.OneBot

📦 -> https://github.com/KonataDev/Lagrange.Core

一个用 Net 写的 NTQQ 协议 bot

缺失端点清单

[ ] get_system_msg
[x] get_chat_history
[x] get_class_info
[x] fetch_custom_face
[ ] set_message_read
[ ] send_temp_msg
[ ] set_nickname
[ ] set_signature
[ ] http_proxy

ghost commented 7 months ago

Lagrange.OneBot

好友列表历史消息都已经写完了剩下的几个你可以考虑Issue FeatReq WebAPI确实是没救了

（获取收藏表情也写好了好友分组暂时不想写

Stapxs commented 5 months ago

WakeCat.OneBot / LLOneBot

📦 -> https://github.com/NapNeko/NapCatQQ 📦 -> https://github.com/LLOneBot/LLOneBot

一个用 nodejs 写的 NTQQ headless client Bot 因为完整遵循 OneBot V11，所以完美支持 SQL2

LLOneBot 和 WakeCat 是同一个开发者，功能和设计上是一样的；一层并没有对它进行完整的测试，如果有问题请提交 issue

92

端点缺失清单

[x] get_system_msg
[ ] get_file_url
[ ] get_video_url
[x] set_message_read
[x] get_class_info
[ ] send_temp_msg
[x] fetch_custom_face
[ ] set_nickname
[ ] set_signature
[ ] http_proxy

Stapxs commented 2 months ago

go-cqhttp

📦 -> https://github.com/Mrs4s/go-cqhttp

老牌协议实现 bot，没有测试；但是考虑到上面 napcat 就完整支持 gocq，所以一定是兼容的（x 如果遇到问题，请提交 issue

shenjackyuanjie commented 1 month ago

不懂就问（有没有计划支持 icalingua oicq 衍生物（自带一个客户端协议（

Stapxs commented 1 month ago

不懂就问（有没有计划支持 icalingua oicq 衍生物（自带一个客户端协议（

其实一开始就支持 oicq 系的，但是因为我很久都没法上 oicq/icqq 这种协议端了怕用不了就把支持移除掉了 XD 晚点我再看看.png

Stapxs / Stapxs-QQ-Lite-2.0