Skip to content
/ go-cqhttp Public

cqhttp的golang实现,轻量、原生跨平台.

License

NotificationsYou must be signed in to change notification settings

Mrs4s/go-cqhttp

Repository files navigation

go-cqhttp

go-cqhttp

✨ 基于 Mirai 以及 MiraiGoOneBot Golang 原生实现 ✨

license release cqhttp action GoReportCard

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

重要信息

由于QQ官方针对协议库的围追堵截, 不断更新加密方案, 我们已无力继续维护此项目. 建议Bot开发者尽快迁移至无头NTQQ项目 -> #2471

兼容性

go-cqhttp 兼容 OneBot-v11 绝大多数内容,并在其基础上做了一些扩展,详情请看 go-cqhttp 的文档。

接口

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

拓展支持

拓展 API 可前往 文档 查看

  • HTTP POST 多点上报
  • 反向 WS 多点连接
  • 修改群名
  • 消息撤回事件
  • 解析/发送 回复消息
  • 解析/发送 合并转发
  • 使用代理请求网络图片

实现

已实现 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 消息

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

拓展 CQ 码功能
[CQ:image]图片
[CQ:redbag]红包
[CQ:poke]戳一戳
[CQ:node]合并转发消息节点
[CQ:cardimage]一种 xml 的图片消息(装逼大图)
[CQ:tts]文本转语音
已实现 API

符合 OneBot 标准的 API

API功能
/send_private_msg发送私聊消息
/send_group_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重启 go-cqhttp
/.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
  • 询问已知问题
  • 提问找不到重点
  • 重复提问

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

性能

在关闭数据库的情况下, 加载 25 个好友 128 个群运行 24 小时后内存使用为 15MB 左右. 开启数据库后内存使用将根据消息量增加 10-20MB, 如果系统内存小于 128M 建议关闭数据库使用.