Home

Awesome

为了更好的维护和更新,该项目作为官方http-api与oicq仓库合并,今后请前往这里查看

↓↓推荐该项目的使用者迁移到更方便管理和维护的模式

> npm i -g oicq@1
> oicq <account>

该仓库的代码以及衍生fork等仍可以正常使用不受影响

node-onebot

基于 oicqonebot(cqhttp) QQ机器人协议的实现
将机器人部署为独立的服务,通过http或ws与外界通信
已支持手机QQ扫码直接登录(提示输入密码时直接按回车)
master分支是独立运行版,另提供插件版

core node engine discord

使用方法:

  1. 下载安装 nodejs 安装版 (版本必须高于v12.16)
  2. 下载此源码包 (建议用git clone)
  3. 重命名 config.sample.jsconfig.js 并配置
  4. 运行 node main 123456789 (数字是登陆账号)

config.js 支持更多的配置,可参考 ConfBot
如何获得滑动验证码的ticket
其他常见问题
当前master分支下只进行http/ws的bug修复,及时更新依赖即可获得新特性。


通信


API (参考文档)

<details> <summary>已实现(文档中已列出)</summary>
名称备注
get_friend_list
get_group_list
get_group_info
get_group_member_list
get_group_member_info
get_stranger_info
send_private_msgmessage_id是string
send_group_msgmessage_id是string
send_msg
delete_msg
get_msg
set_friend_add_request
set_group_add_request
set_group_special_title
set_group_admin
set_group_card
set_group_kick
set_group_ban
set_group_leave
set_group_name
set_group_whole_ban
set_group_anonymous_ban仅支持flag字段,不支持另外两种
set_group_anonymous
send_like
get_login_info
can_send_image
can_send_record
get_status
get_version_info
.handle_quick_operation仅WS有效
get_cookies
get_csrf_token
clean_cache
</details> <details> <summary>已实现(新增)</summary>
名称参数备注
get_stranger_list获取陌生人列表
send_discuss_msgdiscuss_id<br>message<br>auto_escape发讨论组消息,没有message_id
send_group_noticecontent发送群公告
send_group_pokegroup_id<br>user_id群戳一戳,未来可能会用CQ码实现
set_online_statusstatus设置在线状态(※仅限手机协议支持)<br>11我在线上 31离开 41隐身 50忙碌 60Q我吧 70请勿打扰
add_friendgroup_id<br>user_id<br>comment添加群员为好友
delete_frienduser_id<br>block删除好友<br>block默认为true
invite_friendgroup_id<br>user_id邀请好友入群
set_nicknamenickname设置昵称
set_gendergender设置性别 0未知 1男 2女
set_birthdaybirthday设置生日 格式:20110202
set_descriptiondescription设置个人说明
set_signaturesignature设置签名
set_portraitfile设置个人头像,与CQ码中的file格式相同
set_group_portraitfile设置群头像
get_system_msg获得未处理的申请
get_chat_historymessage_id<br>count返回message_id往前的count条消息<br>count默认20
get_forward_msgresid
send_temp_msggroup_id<br>user_id<br>message<br>auto_escape
</details> <details> <summary>尚未实现</summary>
名称
get_group_honor_info
get_credentials
get_vip_info
get_record
get_image
set_restart
</details>

Events

<details> <summary>点开</summary>

新版事件的notice部分的上报格式默认与cqhttp中的格式不同。
如需使用cqhttp格式,在config.js中将use_cqhttp_notice设置为true

新版格式(文档)cqhttp格式(文档)
好友请求request.friend.addrequest.friend
加群请求request.group.addrequest.group.add
加群邀请request.group.inviterequest.group.invite
好友消息message.private.friendmessage.private.friend
单向好友message.private.single
临时会话message.private.groupmessage.private.group
临时会话message.private.othermessage.private.other
群聊消息message.group.normalmessage.group.normal
匿名消息message.group.anonymousmessage.group.anonymous
讨论组消message.discuss
好友增加notice.friend.increasenotice.friend_add
好友减少notice.friend.decrease
好友撤回notice.friend.recallnotice.friend_recall
资料变更notice.friend.profile
群员增加notice.group.increasenotice.group_increase
群员减少notice.group.decreasenotice.group_decrease
群组撤回notice.group.recallnotice.group_recall
管理变更notice.group.adminnotice.group_admin
群组禁言notice.group.bannotice.group_ban
群组转让notice.group.transfer
群组文件表现为CQ码notice.group_upload
群戳一戳notice.group.poke
群设置变notice.group.setting
元事件meta_event.lifecycle.enablemeta_event.lifecycle.enable
元事件meta_event.lifecycle.disablemeta_event.lifecycle.disable
元事件meta_event.lifecycle.connectmeta_event.lifecycle.connect
元事件meta_event.heartbeatmeta_event.heartbeat
</details>

支持的CQ码


其他

考古

旧版cqhttp文档