Skip to content

基于qq官方api开发的符合onebot标准的golang实现,轻量、原生跨平台.

License

Notifications You must be signed in to change notification settings

xrcuo/Gensokyo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2d01c05 · Nov 5, 2023

History

34 Commits
Oct 26, 2023
Nov 3, 2023
Nov 2, 2023
Nov 2, 2023
Nov 4, 2023
Oct 31, 2023
Nov 5, 2023
Nov 3, 2023
Nov 2, 2023
Nov 3, 2023
Nov 3, 2023
Nov 2, 2023
Nov 5, 2023
Nov 3, 2023
Nov 3, 2023
Nov 5, 2023
Nov 3, 2023
Oct 31, 2023
Oct 24, 2023
Nov 5, 2023
Nov 3, 2023
Nov 3, 2023
Nov 5, 2023
Nov 2, 2023
Nov 5, 2023

Repository files navigation

gensokyo

gensokyo

✨ 基于 OneBot QQ官方机器人Api Golang 原生实现 ✨

license release gensokyo action GoReportCard

文档 · 下载 · 开始使用 · 参与贡献

兼容性

gensokyo兼容 OneBot-v11 ,并在其基础上做了一些扩展,详情请看 OneBot 的文档。

可将官方的websocket和api转换至onebotv11标准,和koishi,nonebot2,trss等项目的onebot适配器相连接使用.

实现插件开发和用户开发者无需重新开发,复用过往生态的插件和使用体验.

目前还处于早期阶段.....交流群:196173384

欢迎测试,询问任何有关使用的问题,有问必答,有难必帮~

特别鸣谢

接口

  • HTTP API
  • 反向 HTTP POST
  • 正向 WebSocket
  • 反向 WebSocket

拓展支持

拓展 API 可前往 文档 查看

  • 配合gocq-bridge连接多个ws/wss
  • 将频道虚拟成群事件
  • 将私信虚拟成频道或群事件

实现

已实现 CQ 码

符合 OneBot 标准的 CQ 码

CQ 码 功能
[CQ:face] [QQ 表情]
[CQ:record] [语音]
[CQ:video] [短视频]
[CQ:at] [@某人]
[CQ:share] [链接分享]
[CQ:music] [音乐分享] [音乐自定义分享]
[CQ:reply] [回复]
[CQ:forward] [合并转发]
[CQ:node] [合并转发节点]
[CQ:xml] [XML 消息]
[CQ:json] [JSON 消息]

todo,正在施工中

拓展 CQ 码及与 OneBot 标准有略微差异的 CQ 码

拓展 CQ 码 功能
[CQ:image] [图片]
[CQ:poke] [戳一戳]
[CQ:node] [合并转发消息节点]
[CQ:markdown] [markdown卡片收发]
[CQ:tts] [文本转语音]
已实现 API

符合 OneBot 标准的 API

API 功能
/send_private_msg√ [发送私聊消息]
/send_group_msg√ [发送群消息]
/send_guild_channel_msg√ [发送频道消息]
/send_msg√ [发送消息]
/delete_msg [撤回信息]
/set_group_kick [群组踢人]
/set_group_ban√ [群组单人禁言]
/set_group_whole_ban√ [群组全员禁言]
/set_group_admin [群组设置管理员]
/set_group_card [设置群名片(群备注)]
/set_group_name [设置群名]
/set_group_leave [退出群组]
/set_group_special_title [设置群组专属头衔]
/set_friend_add_request [处理加好友请求]
/set_group_add_request [处理加群请求/邀请]
/get_login_info√ [获取登录号信息]
/get_stranger_info [获取陌生人信息]
/get_friend_list√ [获取好友列表]
/get_group_info√ [获取群/频道信息]
/get_group_list√ [获取群列表]
/get_group_member_info√ [获取群成员信息]
/get_group_member_list√ [获取群成员列表]
/get_group_honor_info [获取群荣誉信息]
/can_send_image√ [检查是否可以发送图片]
/can_send_record [检查是否可以发送语音]
/get_version_info√ [获取版本信息]
/set_restart [重启 gensokyo]
/.handle_quick_operation [对事件执行快速操作]

拓展 API 及与 OneBot 标准有略微差异的 API

拓展 API 功能
/set_group_portrait [设置群头像]
/get_image [获取图片信息]
/get_msg [获取消息]
/get_forward_msg [获取合并转发内容]
/send_group_forward_msg [发送合并转发(群)]
/.get_word_slices [获取中文分词]
/.ocr_image [图片 OCR]
/get_group_system_msg [获取群系统消息]
/get_group_file_system_info [获取群文件系统信息]
/get_group_root_files [获取群根目录文件列表]
/get_group_files_by_folder [获取群子目录文件列表]
/get_group_file_url [获取群文件资源链接]
/get_status [获取状态]
已实现 Event

符合 OneBot 标准的 Event(部分 Event 比 OneBot 标准多上报几个字段,不影响使用)

事件类型 Event
消息事件 [私聊信息]
消息事件 [群消息]
通知事件 [群文件上传]
通知事件 [群管理员变动]
通知事件 [群成员减少]
通知事件 [群成员增加]
通知事件 [群禁言]
通知事件 [好友添加]
通知事件 [群消息撤回]
通知事件 [好友消息撤回]
通知事件 [群内戳一戳]
通知事件 [群红包运气王]
通知事件 [群成员荣誉变更]
请求事件 [加好友请求]
请求事件 [加群请求/邀请]

拓展 Event

事件类型 拓展 Event
通知事件 [好友戳一戳]
通知事件 [群内戳一戳]
通知事件 [群成员名片更新]
通知事件 [接收到离线文件]

关于 ISSUE

以下 ISSUE 会被直接关闭

  • 提交 BUG 不使用 Template
  • 询问已知问题
  • 提问找不到重点
  • 重复提问

请注意, 开发者并没有义务回复您的问题. 您应该具备基本的提问技巧。
有关如何提问,请阅读《提问的智慧》

性能

有待测试

About

基于qq官方api开发的符合onebot标准的golang实现,轻量、原生跨平台.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 73.0%
  • TypeScript 13.8%
  • Vue 10.5%
  • JavaScript 1.8%
  • Shell 0.7%
  • HTML 0.1%
  • SCSS 0.1%