goodspeed34 / oicq

Tencent QQ Bot Library for Node.js

oicq

• QQ(安卓)协议基于Node.js的实现，支持最低node版本为 v14
• 若你不熟悉Node.js或不会组织代码，可通过 template 创建一个简单的应用程序
• API Reference / Type Docs (文档仅供参考，具体类型以包内d.ts声明文件为准)
• 从v1.x升级 (v1在master分支)
• QQ频道未来不会直接支持，请使用插件 oicq-guild

---

Install:

> npm i oicq  # or > yarn add oicq

Usage:

const { createClient } = require("oicq")
const account = 147258369
const client = createClient(account)

client.on("system.online", () => console.log("Logged in!"))
client.on("message", e => {
  console.log(e)
  e.reply("hello world", true) //true表示引用对方的消息
})

client.on("system.login.qrcode", function (e) {
  //扫码后按回车登录
  process.stdin.once("data", () => {
    this.login()
  })
}).login()

注意：扫码登录现在仅能在同一ip下进行，建议使用密码登录，只需验证一次设备便长期有效
密码登录教程

Api Reference

• Class: Client 客户端
  • Events 事件
• Class: Group 群
• Class: User 用户
• Class: Friend 好友
• Class: Member 群员
• Class: Contactable 群和用户的基类
• Class: Gfs 群文件系统
• Class: Message 消息
• Namespace: segment 构造消息元素/发送消息

Class: Client

使用 createClient() 或 new Client 创建实例

Method	Description
login()	登录
logout()	登出
queryQrcodeResult()	获取扫码结果
submitSlider()	提交滑动验证码
sendSmsCode()	发短信
submitSmsCode()	提交短信验证码
pickGroup()	得到一个群对象
pickFriend()	得到一个好友对象
pickMember()	得到一个群员对象
pickUser()	得到一个用户对象
pickDiscuss()	得到一个讨论组对象
setOnlineStatus()	设置在线状态
setNickname()	设置昵称
setGender()	设置性别
setBirthday()	设置生日
setDescription()	设置个人说明
setSignature()	设置个性签名
setAvatar()	设置头像
getRoamingStamp()	获取漫游表情
deleteStamp()	删除漫游表情
addClass()	添加好友分组
deleteClass()	删除好友分组
renameClass()	重命名好友分组
reloadFriendList()	重载好友列表
reloadStrangerList()	重载陌生人列表
reloadGroupList()	重载群列表
reloadBlackList()	重载黑名单列表
getSystemMsg()	获取系统消息
getForwardMsg()	解析合并转发
makeForwardMsg()	制作合并转发
getVideoUrl()	获取视频地址
imageOcr()	ocr
cleanCache()	清空缓存文件

Property	Description
uin	我的账号
status	在线状态
nickname	昵称
sex	性别
age	年龄
fl	好友列表(Map)
gl	群列表(Map)
sl	陌生人列表(Map)
gml	群员列表缓存(Map)
blacklist	黑名单列表(Set)
classes	好友分组(Map)
stamp	漫游表情(Set))
logger	日志记录器
config	配置
dir	本地存储路径
stat	数据统计
bkn	csrf-token
cookies	cookies
tiny_id	我的频道账号

Events

Event	Description
system.login.qrcode	收到二维码
system.login.slider	滑动验证码
system.login.device	设备锁
system.login.error	登录错误
system.online	上线
system.offline.kickoff	服务器踢下线
system.offline.network	网络错误导致下线
request.friend	好友申请
request.group.add	加群申请
request.group.invite	群邀请
request	全部请求
message.group	群消息
message.private	私聊消息
message.discuss	讨论组消息
message	全部消息
notice.friend.increase	好友增加
notice.friend.decrease	好友减少
notice.friend.recall	好友撤回
notice.friend.poke	好友戳一戳
notice.friend	好友通知
notice.group.increase	群员增加
notice.group.decrease	群员减少
notice.group.recall	群撤回
notice.group.poke	群戳一戳
notice.group.ban	群禁言
notice.group.admin	群管理变更
notice.group.transfer	群转让
notice.group	群通知
notice	全部通知
sync.message	私聊消息同步
sync.read	已读同步
guild.message	频道消息

Class: Group

群。 notice.group 和 message.group 相关事件中含有此实例 ( e.group 访问)
或者使用 client.pickGroup() 获得群实例

Method	Description
sendMsg()	发送消息
recallMsg()	撤回消息
setName()	设置群名
setAvatar()	设置群头像
muteAll()	禁言全员
muteMember()	禁言群员
muteAnony()	禁言匿名者
kickMember()	踢人
pokeMember()	戳一戳
setCard()	设置名片
setAdmin()	设置管理员
setTitle()	设置头衔
invite()	邀请好友
quit()	退群/解散
getAnonyInfo()	获取匿名身份
allowAnony()	允许/禁止匿名
getChatHistory()	获取聊天记录
markRead()	标记已读
getFileUrl()	获取群文件下载地址
shareMusic()	分享音乐
getMemberMap()	获取群员列表
getAvatarUrl()	获取群头像地址
pickMember()	获取一个群成员对象
getAtAllRemainder()	获取@全体剩余次数
renew()	刷新群资料

Property	Description
group_id	群号
name	群名
info	群资料
is_owner	我是否群主
is_admin	我是否管理
all_muted	是否全员禁言
mute_left	我的禁言剩余时间
fs	群文件系统

Class: User

Method	Description
sendMsg()	发送消息
recallMsg()	撤回消息
getSimpleInfo()	查询资料
getChatHistory()	获取聊天记录
markRead()	标记已读
getFileUrl()	获取离线文件下载地址
getAvatarUrl()	获取头像地址
asFriend()	获取作为好友的对象
asMember()	获取作为某群群员的对象
addFriendBack()	回添双向好友
setFriendReq()	同意好友申请
setGroupReq()	同意加群申请
setGroupInvite()	同意群邀请

Property	Description
user_id	QQ号

Class: Friend

好友。继承 User 的所有方法和属性
notice.friend 和 message.private 相关事件中含有此实例 ( e.friend 访问)
或者使用 client.pickFriend() 获得好友实例

Method	Description
shareMusic()	分享音乐
setRemark()	设置备注
setClass()	设置分组
thumbUp()	点赞
poke()	戳一戳
delete()	删除
sendFile()	发送文件
forwardFile()	转发文件
recallFile()	撤回文件

Property	Description
nickname	昵称
sex	性别
remark	备注
class_id	分组id
class_name	分组名
info	好友资料

Class: Member

群成员。继承 User 的所有方法和属性
message.group 相关事件中含有此实例 ( e.member 访问)
或者使用 client.pickMember() 获得群成员实例

Method	Description
setAdmin()	设置管理
setTitle()	设置头衔
setCard()	设置名片
kick()	踢群
mute()	禁言
poke()	戳一戳
addFriend()	加为好友
renew()	更新群员资料

Property	Description
group_id	群号
card	名片或昵称
title	头衔
is_friend	是否好友
is_owner	是否群主
is_admin	是否管理
mute_left	禁言剩余时间
group	所在群对象
info	群员资料

Class: Contactable

抽象类，用户和群的基类，里面的方法和属性都会被继承

Method	Description
uploadImages()	上传一批图片以备发送
uploadVideo()	上传一个视频以备发送
uploadPtt()	上传一个语音以备发送
makeForwardMsg()	制作合并转发消息以备发送
getForwardMsg()	解析合并转发消息
getVideoUrl()	获取视频下载地址

Property	Description
client	所在客户端对象

Class: Gfs

群文件系统，通过 group.fs 获取

Method	Description
df()	查询使用空间
stat()	获取文件或目录属性
dir()	列出文件和目录
ls()	dir的别名
mkdir()	创建目录
rm()	删除文件或目录
rename()	重命名文件或目录
mv()	移动文件
upload()	上传文件
forward()	转发文件
download()	获取下载链接

Property	Description
group_id	群号
group	所在群对象
client	所在客户端对象

Class: Message

拥有子类: PrivateMessage, GroupMessage, DiscussMessage
对应的消息事件中含有这些实例中的一个

Method	Description
serialize()	序列化一条消息
toString()	一种适合阅读的形式

Static Method	Description
deserialize()	反序列化一条消息

Property	Description
message_type	消息类别：群或私聊
sub_type	子类别
group_id	群号
from_id	发送者
to_id	接收者
anonymous	匿名者信息
auto_reply	是否自动回复
block	是否屏蔽
atme	是否atme
atall	是否atall
message	消息链
raw_message	消息摘要
sender	发送者
time	消息时间
seq	消息序号
rand	消息随机数
font	字体
source	引用回复的消息

Namespace: segment

用于创建可发送的消息元素类型

//样例代码，文字+图片+表情+AT
const { segment } = require("oicq")
const message = [
  "hello world",
  segment.image("/tmp/abc.jpg"),
  segment.face(104),
  segment.at(10001),
]

Method	Description
at()	创建at元素
face()	创建表情元素
image()	创建图片元素
flash()	创建闪照元素
video()	创建视频元素
record()	创建语音元素
xml()	创建xml元素
json()	创建json元素
share()	创建链接分享元素
location()	创建地点分享元素
poke()	创建戳一戳元素
bface()	创建bface元素
sface()	创建sface元素
mirai()	创建特殊元素

---

其他：

• QQWebApi QQ Web Api 收集整理 (途中)
• 码云镜像仓库
• 赞助记录
• TXHook 抓包工具推荐