ntqq

import * as log4js from "log4js"; import { BaseClient, Domain, Platform } from "./core"; import { Gender, OnlineStatus } from "./common"; import { EventMap } from "./events"; import { Friend } from "./entiries/friend"; import { Group } from "./entiries/group"; import { GroupMember } from "./entiries/groupMember"; import { User } from "./entiries/user"; import { Forwardable, ImageElem, Quotable, Sendable } from "./message"; import { Configuration } from "log4js"; import { Guild } from "./entiries/guild"; import { GuildMember } from "./entiries/guildMember"; /** 事件接口 */ export interface Client extends BaseClient { on<T extends keyof EventMap>(event: T, listener: EventMap[T]): this; on<S extends string | symbol>(event: S & Exclude<S, keyof EventMap>, listener: (...args: any[]) => any | void): this; once<T extends keyof EventMap>(event: T, listener: EventMap[T]): this; once<S extends string | symbol>(event: S & Exclude<S, keyof EventMap>, listener: (...args: any[]) => any | void): this; off<T extends keyof EventMap>(event: T, listener: EventMap[T]): this; off<S extends string | symbol>(event: S & Exclude<S, keyof EventMap>, listener: (...args: any[]) => any | void): this; emit<T extends keyof EventMap>(event: T, ...args: Parameters<EventMap[T]>): boolean; emit<S extends string | symbol>(event: S & Exclude<S, keyof EventMap>, ...args: any[]): boolean; } /** 一个客户端 */ export declare class Client extends BaseClient { /** * 得到一个群对象, 通常不会重复创建、调用 * @param gid 群号 * @param strict 严格模式，若群不存在会抛出异常 * @returns 一个`Group`对象 */ readonly pickGroup: (gin: number, strict?: boolean | undefined) => Group; /** * 得到一个好友对象, 通常不会重复创建、调用 * @param uid 好友账号 * @param strict 严格模式，若好友不存在会抛出异常 * @returns 一个`Friend`对象 */ readonly pickFriend: (uin: number, strict?: boolean | undefined) => Friend; /** * 得到一个群员对象, 通常不会重复创建、调用 * @param gid 群员所在的群号 * @param uid 群员的账号 * @param strict 严格模式，若群员不存在会抛出异常 * @returns 一个`Member`对象 */ readonly pickMember: (gid: number, uid: number, strict?: boolean | undefined) => GroupMember; /** * 创建一个用户对象 * @param uid 用户的账号 * @returns 一个`User`对象 */ readonly pickUser: (uid: number) => User; /** 日志记录器，初始情况下是`log4js.Logger` */ logger: Logger | log4js.Logger; /** 账号本地数据存储目录 */ readonly dir: string; /** 配置 */ readonly config: Required<Config>; protected readonly _cache: Map<number, Set<string>>; protected _sync_cookie?: Uint8Array; /** 密码的md5值，调用 {@link login} 后会保存在这里，用于`token`过期时恢复登录 */ password_md5?: Buffer; get [Symbol.toStringTag](): string; /** 好友列表 */ readonly fl: Map<number, Friend.Info>; /** 群列表 */ readonly gl: Map<number, Group.Info>; /** 群员列表缓存 */ readonly gml: Map<number, Map<number, GroupMember.Info>>; /** 频道列表缓存 */ readonly gpl: Map<string, Guild.Info>; /** 频道成员缓存 */ readonly gpml: Map<string, GuildMember.Info>; /** 勿手动修改这些属性 */ /** 在线状态 */ status: OnlineStatus; /** 昵称 */ nickname: string; /** 性别 */ sex: Gender; /** 年龄 */ age: number; /** @todo 未知属性 */ bid: string; /** 漫游表情缓存 */ stamp: Set<string>; /** 相当于频道中的qq号 */ tiny_id: string; /** csrf token */ get bkn(): number; /** @todo 未知属性 */ readonly cookies: { [domain in Domain]: string; }; /** 数据统计 */ get stat(): { start_time: number; lost_times: number; recv_pkt_cnt: number; sent_pkt_cnt: number; lost_pkt_cnt: number; recv_msg_cnt: number; sent_msg_cnt: number; msg_cnt_per_min: number; remote_ip: string; sign_api_addr: string; sign_api_init: boolean; remote_port: number; }; /** 修改日志级别 */ set log_level(level: LogLevel); /** * 继承原版`oicq`的构造方式，建议使用另一个构造函数 * @param uin 账号 * @param conf 配置 */ constructor(uin: number, conf?: Config); /** * 账号在调用 {@link login} 时传入 * @param conf 配置 */ constructor(conf?: Config); /** * 只能在初始化Client时传了`uin`或扫码登录，才能调用 * * 传了`password`则尝试密码登录 * * 不传`password`则尝试扫码登录 * 未传任何参数则尝试扫码登录 * 掉线重连时也是自动调用此函数，走相同逻辑 * 你也可以在配置中修改`reconn_interval`，关闭掉线重连并自行处理 * @param password 可以为密码原文，或密码的md5值 */ login(password?: string | Buffer): Promise<void>; /** * 传了`uin`，未传`password` * 会优先尝试使用token登录 (token在上次登录成功后存放在`this.dir`的`${uin}_token`中) * 传了`uin`无token或token失效时： * * 传了`password`则尝试密码登录 * * 不传`password`则尝试扫码登录 * 未传任何参数则尝试扫码登录 * 掉线重连时也是自动调用此函数，走相同逻辑 * 你也可以在配置中修改`reconn_interval`，关闭掉线重连并自行处理 * @param uin 登录账号 * @param password 可以为密码原文，或密码的md5值 */ login(uin?: number, password?: string | Buffer): Promise<void>; /** 设置在线状态 */ setOnlineStatus(status?: OnlineStatus.Online | OnlineStatus.Absent | OnlineStatus.Invisible | OnlineStatus.Busy | OnlineStatus.Qme | OnlineStatus.DontDisturb): Promise<void>; /** 设置昵称 */ setNickname(nickname: string): Promise<boolean>; /** * 设置性别 * @param gender 0：未知，1：男，2：女 */ setGender(gender: 0 | 1 | 2): Promise<boolean>; /** * 设置生日 * @param birthday `YYYYMMDD`格式的`string`（会过滤非数字字符）或`number` * */ setBirthday(birthday: string | number): Promise<boolean>; /** 设置个人说明 */ setDescription(description?: string): Promise<boolean>; /** 设置个性签名 */ setSignature(signature?: string): Promise<boolean>; /** 获取个性签名 */ getSignature(): Promise<string>; /** 设置头像 */ setAvatar(file: ImageElem["file"]): Promise<void>; /** 获取漫游表情 */ getRoamingStamp(no_cache?: boolean): Promise<string[]>; /** 删除表情(支持批量) */ deleteStamp(id: string | string[]): Promise<void>; /** 获取系统消息 */ getSystemMsg(): Promise<(import("./events").FriendRequestEvent | import("./events").GroupRequestEvent | import("./events").GroupInviteEvent)[]>; /** 重载好友列表 */ reloadFriendList(): Promise<void>; /** 重载群列表 */ reloadGroupList(): Promise<void>; /** 重载群成员列表 */ reloadGroupMemberList(group_id: number): Promise<Map<number, GroupMember.Info>>; reloadGuildList(): Promise<void>; /** 清空缓存文件 fs.rm need v14.14 */ cleanCache(): void; /** * 获取视频下载地址 * use {@link Friend.getVideoUrl} */ getVideoUrl(fid: string, md5: string | Buffer): Promise<string>; /** * 获取转发消息 * use {@link Friend.getForwardMsg} */ getForwardMsg(resid: string, fileName?: string): Promise<import("./message").ForwardMessage[]>; /** * 制作转发消息 * use {@link Friend.makeForwardMsg} or {@link Group.makeForwardMsg} */ makeForwardMsg(fake: Forwardable[], dm?: boolean): Promise<import("./message").JsonElem>; /** Ocr图片转文字 */ imageOcr(file: ImageElem["file"]): Promise<import("./internal").OcrResult>; /** @cqhttp (cqhttp遗留方法) use {@link cookies[domain]} */ getCookies(domain?: Domain): string; /** @cqhttp use {@link bkn} */ getCsrfToken(): number; /** @cqhttp use {@link fl} */ getFriendList(): Map<number, Friend.Info>; /** @cqhttp use {@link gl} */ getGroupList(): Map<number, Group.Info>; /** * 添加群精华消息 * use {@link Group.addEssence} * @param message_id 消息id */ setEssenceMessage(group_id: number, message_seq: number): Promise<string>; /** * 移除群精华消息 * use {@link Group.removeEssence} * @param group_id * @param message_seq */ removeEssenceMessage(group_id: number, message_seq: number): Promise<string>; /** @cqhttp use {@link User.getSimpleInfo} */ getStrangerInfo(user_id: number): Promise<void>; /** @cqhttp use {@link Group.info} or {@link Group.renew} */ getGroupInfo(group_id: number, no_cache?: boolean): Promise<Group.Info>; /** @cqhttp use {@link Group.getMemberMap} */ getGroupMemberList(group_id: number, no_cache?: boolean): Promise<Map<number, GroupMember.Info>>; /** @cqhttp use {@link GroupMember.info} or {@link GroupMember.renew} */ getGroupMemberInfo(group_id: number, user_id: number, no_cache?: boolean): Promise<GroupMember.Info>; /** @cqhttp use {@link Friend.sendMsg} */ sendPrivateMsg(user_id: number, message: Sendable, source?: Quotable): Promise<import("./events").MessageRet>; /** @cqhttp use {@link Group.sendMsg} */ sendGroupMsg(group_id: number, message: Sendable, source?: Quotable): Promise<import("./events").MessageRet>; /** @cqhttp use {@link Group.sign} */ sendGroupSign(group_id: number): Promise<{ result: number; }>; /** @cqhttp use {@link GroupMember.sendMsg} */ sendTempMsg(group_id: number, user_id: number, message: Sendable): Promise<import("./events").MessageRet>; /** @cqhttp use {@link User.recallMsg} or {@link Group.recallMsg} */ deleteMsg(group_id: number, message_seq: number): Promise<boolean>; /** @cqhttp use {@link User.markRead} or {@link Group.markRead} */ reportReaded(message_id: string): Promise<void>; /** @cqhttp use {@link User.getChatHistory} or {@link Group.getChatHistory} */ getMsg(group_id: number, message_seq: number): Promise<void>; /** @cqhttp use {@link User.getChatHistory} or {@link Group.getChatHistory} */ getChatHistory(message_id: string, count?: number): Promise<void>; /** @cqhttp use {@link Group.muteAnony} */ setGroupAnonymousBan(group_id: number, flag: string, duration?: number): Promise<void>; /** @cqhttp use {@link Group.allowAnony} */ setGroupAnonymous(group_id: number, enable?: boolean): Promise<boolean>; /** @cqhttp use {@link Group.muteAll} */ setGroupWholeBan(group_id: number, enable?: boolean): Promise<boolean>; /** * 设置当前群成员消息屏蔽状态 * @param group_id {number} 群号 * @param member_id {number} 成员QQ号 * @param isScreen {boolean} 是否屏蔽默认true */ setGroupMemberScreenMsg(group_id: number, member_id: number, isScreen?: boolean): Promise<boolean>; /** @cqhttp use {@link Group.setName} */ setGroupName(group_id: number, name: string): Promise<boolean>; /** @cqhttp use {@link Group.announce} */ sendGroupNotice(group_id: number, content: string): Promise<boolean>; /** @cqhttp use {@link Group.setAdmin} or {@link GroupMember.setAdmin} */ setGroupAdmin(group_id: number, user_id: number, enable?: boolean): Promise<boolean>; /** @cqhttp use {@link Group.setTitle} or {@link GroupMember.setTitle} */ setGroupSpecialTitle(group_id: number, user_id: number, special_title: string, duration?: number): Promise<boolean>; /** @cqhttp use {@link Group.setCard} or {@link GroupMember.setCard} */ setGroupCard(group_id: number, user_id: number, card: string): Promise<boolean>; /** @cqhttp use {@link Group.kickMember} or {@link GroupMember.kick} */ setGroupKick(group_id: number, user_id: number, reject_add_request?: boolean, message?: string): Promise<boolean>; /** @cqhttp use {@link Group.muteMember} or {@link GroupMember.mute} */ setGroupBan(group_id: number, user_id: number, duration?: number): Promise<void>; /** @cqhttp use {@link Group.quit} */ setGroupLeave(group_id: number): Promise<boolean>; /** @cqhttp use {@link Group.pokeMember} or {@link GroupMember.poke} */ sendGroupPoke(group_id: number, user_id: number): Promise<boolean>; /** @cqhttp use {@link GroupMember.addFriend} */ addFriend(group_id: number, user_id: number, comment?: string): Promise<void>; /** @cqhttp use {@link Friend.delete} */ deleteFriend(user_id: number, block?: boolean): Promise<void>; /** @cqhttp use {@link Group.invite} */ inviteFriend(group_id: number, user_id: number): Promise<boolean>; /** @cqhttp use {@link Friend.thumbUp} */ sendLike(user_id: number, times?: number): Promise<void>; /** @cqhttp use {@link setAvatar} */ setPortrait(file: Parameters<Client["setAvatar"]>[0]): Promise<void>; /** @cqhttp use {@link Group.setAvatar} */ setGroupPortrait(group_id: number, file: Parameters<Group["setAvatar"]>[0]): Promise<void>; /** @cqhttp use {@link Group.fs} */ acquireGfs(group_id: number): import("./entiries").FileSystem; /** @cqhttp use {@link User.setFriendReq} or {@link User.addFriendBack} */ setFriendAddRequest(flag: string, approve?: boolean, remark?: string, block?: boolean): Promise<boolean>; /** @cqhttp use {@link User.setGroupInvite} or {@link User.setGroupReq} */ setGroupAddRequest(flag: string, approve?: boolean, reason?: string, block?: boolean): Promise<boolean>; /** emit an event */ em(name?: string, data?: any): void; protected _msgExists(from: number, type: number, seq: number, time: number): boolean; protected _calcMsgCntPerMin(): number; private _setProfile; /** @deprecated use {@link submitSlider} */ sliderLogin(ticket: string): Promise<void>; /** @deprecated use {@link sendSmsCode} */ sendSMSCode(): Promise<void>; /** @deprecated use {@link submitSmsCode} */ submitSMSCode(code: string): Promise<void>; /** @deprecated use {@link status} */ get online_status(): OnlineStatus; } /** 日志等级 */ export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "mark" | "off"; export type LogLevelMap = { [key in LogLevel]: number; }; export type LoggerFn = { [key in LogLevel]: (...args: any[]) => any; }; export interface Logger extends LoggerFn { level?: LogLevel; } /** 配置项 */ export interface Config { /** * 日志等级，默认`info` * 打印日志会降低性能，若消息量巨大建议修改此参数 */ log_level?: LogLevel; /** 登录设备，默认为安卓手机 */ platform?: Platform; /** 使用版本，仅在对应platform中有多个版本是有效，不填则使用最新版本 */ ver?: string; /** log4js配置 */ log_config?: Configuration | string; /** 群聊和频道中过滤自己的消息，默认`true` */ ignore_self?: boolean; /** 被风控时是否尝试用分片发送，默认`true` */ resend?: boolean; /** 数据存储文件夹，需要可写权限，默认主模块下的data文件夹 */ data_dir?: string; /** * 触发`system.offline.network`事件后的重新登录间隔秒数，默认5(秒)，不建议设置过低 * 设置为0则不会自动重连，然后你可以监听此事件自己处理 */ reconn_interval?: number; /** * 签名服务器地址，未配置可能会导致登录失败和无法收发消息 */ sign_api_addr?: string; /** 是否缓存群员列表(默认true)，群多的时候(500~1000)会多占据约100MB+内存，关闭后进程只需不到20MB内存 */ cache_group_member?: boolean; /** 自动选择最优服务器(默认true)，关闭后会一直使用`msfwifi.3g.qq.com:8080`进行连接 */ auto_server?: boolean; /** ffmpeg */ ffmpeg_path?: string; ffprobe_path?: string; } /** 数据统计 */ export type Statistics = Client["stat"]; /** 创建一个客户端 (=new Client) */ export declare function createClient(config?: Config): Client;