hotcat-bot-qq 0.0.1

package/dist/botApi.d.ts

@@ -0,0 +1,1163 @@
+import { NCWebsocket, NCWebsocketOptions } from 'node-napcat-ts';
+import { Message } from './message';
+import type { BotClient } from './botClient';
+export declare class BotApi {
+    napcat: NCWebsocket;
+    private _client;
+    get client(): BotClient;
+    set client(c: BotClient);
+    constructor(config: NCWebsocketOptions, debug?: boolean);
+    /** 建立 WebSocket 连接 */
+    connect(): Promise<void>;
+    /**
+     * 获取当前 bot 登录信息
+     * @returns `{ user_id: number, nickname: string }`
+     */
+    getLoginInfo(): Promise<{
+        user_id: number;
+        nickname: string;
+    }>;
+    /**
+     * 发送消息（群聊或私聊）
+     * @param target - `{ group_id: number }` 发群聊，`{ user_id: number }` 发私聊
+     * @param messages - 消息段
+     */
+    sendMessage(target: {
+        group_id: number;
+    } | {
+        user_id: number;
+    }, ...messages: Message[]): Promise<void>;
+    /**
+     * 发送群聊消息
+     * @param groupId - 群号
+     * @param messages - 消息段
+     */
+    sendGroupMessage(groupId: number, ...messages: Message[]): Promise<void>;
+    /**
+     * 发送私聊消息
+     * @param userId - QQ 号
+     * @param messages - 消息段
+     */
+    sendPrivateMessage(userId: number, ...messages: Message[]): Promise<void>;
+    /**
+     * 发送合并转发（通用，自动判断群/私聊）
+     * @param target - `{ group_id }` 或 `{ user_id }`
+     * @param nodes - 转发节点，由 `Message.node()` / `Message.customNode()` 构建
+     */
+    sendForwardMsg(target: {
+        group_id: number;
+    } | {
+        user_id: number;
+    }, nodes: Message[]): Promise<void>;
+    /**
+     * 发送群合并转发
+     * @param groupId - 群号
+     * @param nodes - 转发节点
+     */
+    sendGroupForwardMsg(groupId: number, nodes: Message[]): Promise<void>;
+    /**
+     * 发送私聊合并转发
+     * @param userId - QQ 号
+     * @param nodes - 转发节点
+     */
+    sendPrivateForwardMsg(userId: number, nodes: Message[]): Promise<void>;
+    /**
+     * 转发单条消息到私聊
+     * @param userId - 目标 QQ
+     * @param messageId - 消息 ID
+     */
+    forwardFriendSingleMsg(userId: number, messageId: number): Promise<void>;
+    /**
+     * 转发单条消息到群聊
+     * @param groupId - 群号
+     * @param messageId - 消息 ID
+     */
+    forwardGroupSingleMsg(groupId: number, messageId: number): Promise<void>;
+    /**
+     * 撤回消息
+     * @param messageId - 消息 ID
+     */
+    deleteMessage(messageId: number): Promise<void>;
+    /**
+     * 获取单条消息详情
+     * @param messageId - 消息 ID
+     */
+    getMessage(messageId: number): Promise<({
+        message_type: "private";
+        sender: {
+            user_id: number;
+            nickname: string;
+            card: string;
+        };
+        sub_type: "friend";
+    } | {
+        message_type: "group";
+        group_id: number;
+        sender: {
+            user_id: number;
+            nickname: string;
+            card: string;
+            role: "owner" | "admin" | "member";
+        };
+        sub_type: "normal";
+    }) & {
+        self_id: number;
+        user_id: number;
+        time: number;
+        message_id: number;
+        message_seq: number;
+        real_id: number;
+        real_seq: string;
+        raw_message: string;
+        font: number;
+        post_type: "message" | "message_sent";
+        emoji_likes_list: {
+            emoji_id: string;
+            emoji_type: string;
+            likes_cnt: string;
+        }[];
+    } & import("node-napcat-ts").MessageType>;
+    /**
+     * 获取合并转发消息
+     * @param messageId - 消息 ID
+     */
+    getForwardMsg(messageId: number): Promise<{
+        messages: import("node-napcat-ts").WSSendReturn["get_msg"][];
+    }>;
+    /**
+     * 获取群聊历史消息
+     * @param groupId - 群号
+     * @param messageSeq - 起始消息序号
+     * @param count - 获取数量
+     */
+    getGroupMsgHistory(groupId: number, messageSeq?: number, count?: number): Promise<{
+        messages: import("node-napcat-ts").WSSendReturn["get_msg"][];
+    }>;
+    /**
+     * 获取私聊消息历史
+     * @param userId - QQ 号
+     * @param messageSeq - 起始消息序号
+     * @param count - 获取数量
+     */
+    getFriendMsgHistory(userId: number, messageSeq?: number, count?: number): Promise<{
+        messages: import("node-napcat-ts").WSSendReturn["get_msg"][];
+    }>;
+    /**
+     * 标记消息已读
+     * @param target - `{ group_id: number }` | `{ user_id: number }` | `{ message_id: number }`
+     */
+    markMsgAsRead(target: {
+        group_id: number;
+    } | {
+        user_id: number;
+    } | {
+        message_id: number;
+    }): Promise<void>;
+    /** 标记私聊已读 */
+    markPrivateMsgAsRead(userId: number): Promise<void>;
+    /** 标记群聊已读 */
+    markGroupMsgAsRead(groupId: number): Promise<void>;
+    /** 标记所有消息已读 */
+    markAllAsRead(): Promise<void>;
+    /**
+     * 设置消息表情回应
+     * @param messageId - 消息 ID
+     * @param emojiId - 表情 ID
+     * @param set - true 添加 / false 移除
+     */
+    setMsgEmojiLike(messageId: number, emojiId: string, set?: boolean): Promise<void>;
+    /**
+     * 拉取表情回应列表
+     * @param messageId - 消息 ID
+     * @param emojiId - 表情 ID
+     */
+    fetchEmojiLike(messageId: number, emojiId?: string): Promise<{
+        result: 0;
+        errMsg: string;
+        emojiLikesList: {
+            tinyId: string;
+            nickName: string;
+            headUrl: string;
+        }[];
+        cookie: string;
+        isLastPage: boolean;
+        isFirstPage: boolean;
+    }>;
+    /** 英译中翻译 */
+    translateEn2zh(words: string[]): Promise<string[]>;
+    /**
+     * 群内禁言
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     * @param duration - 禁言时长（秒），0 解除
+     */
+    banMember(groupId: number, userId: number, duration: number): Promise<void>;
+    /**
+     * 踢出群成员
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     * @param rejectAdd - 是否拒绝再次加群
+     */
+    kickMember(groupId: number, userId: number, rejectAdd?: boolean): Promise<void>;
+    /**
+     * 全员禁言
+     * @param groupId - 群号
+     * @param enable - true 开启 / false 关闭，默认 true
+     */
+    setGroupWholeBan(groupId: number, enable?: boolean): Promise<void>;
+    /**
+     * 设置/取消管理员
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     * @param enable - true 设为管理 / false 取消，默认 true
+     */
+    setGroupAdmin(groupId: number, userId: number, enable?: boolean): Promise<void>;
+    /**
+     * 修改群名片
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     * @param card - 新群名片
+     */
+    setGroupCard(groupId: number, userId: number, card: string): Promise<void>;
+    /**
+     * 修改群名称
+     * @param groupId - 群号
+     * @param groupName - 新群名
+     */
+    setGroupName(groupId: number, groupName: string): Promise<void>;
+    /**
+     * 设置群备注
+     * @param groupId - 群号
+     * @param remark - 备注名
+     */
+    setGroupRemark(groupId: number, remark: string): Promise<void>;
+    /**
+     * 设置群头衔
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     * @param title - 头衔内容
+     */
+    setGroupSpecialTitle(groupId: number, userId: number, title: string): Promise<void>;
+    /**
+     * 退出 / 解散群
+     * @param groupId - 群号
+     * @param isDismiss - true 解散（群主），默认 false 仅退出
+     */
+    leaveGroup(groupId: number, isDismiss?: boolean): Promise<void>;
+    /**
+     * 处理加群申请
+     * @param flag - 申请标识（从事件中获取）
+     * @param approve - true 同意 / false 拒绝
+     * @param reason - 拒绝理由
+     */
+    handleGroupAddRequest(flag: string, approve?: boolean, reason?: string): Promise<void>;
+    /** 设置群头像，file 支持本地路径/base64/URL */
+    setGroupPortrait(groupId: number, file: string): Promise<void>;
+    /** 群打卡 */
+    sendGroupSign(groupId: number): Promise<void>;
+    /** 发送群公告 */
+    sendGroupNotice(groupId: number, title: string, content: string): Promise<void>;
+    /** 获取群公告 */
+    getGroupNotice(groupId: number): Promise<{
+        notice_id: string;
+        sender_id: number;
+        publish_time: number;
+        message: {
+            text: string;
+            images: {
+                id: string;
+                height: string;
+                width: string;
+            }[];
+        };
+    }[]>;
+    /** 删除群公告 */
+    deleteGroupNotice(groupId: number, noticeId: string): Promise<void>;
+    /**
+     * 获取群信息
+     * @param groupId - 群号
+     */
+    getGroupInfo(groupId: number): Promise<{
+        group_all_shut: number;
+        group_remark: string;
+        group_id: number;
+        group_name: string;
+        member_count: number;
+        max_member_count: number;
+    }>;
+    /** 获取群额外信息 */
+    getGroupInfoEx(groupId: number): Promise<{
+        groupCode: string;
+        resultCode: 0;
+        extInfo: {
+            groupInfoExtSeq: number;
+            reserve: number;
+            luckyWordId: string;
+            lightCharNum: number;
+            luckyWord: string;
+            starId: number;
+            essentialMsgSwitch: number;
+            todoSeq: number;
+            blacklistExpireTime: number;
+            isLimitGroupRtc: number;
+            companyId: number;
+            hasGroupCustomPortrait: number;
+            bindGuildId: string;
+            groupOwnerId: {
+                memberUin: string;
+                memberUid: string;
+                memberQid: string;
+            };
+            essentialMsgPrivilege: number;
+            msgEventSeq: string;
+            inviteRobotSwitch: number;
+            gangUpId: string;
+            qqMusicMedalSwitch: number;
+            showPlayTogetherSwitch: number;
+            groupFlagPro1: string;
+            groupBindGuildIds: {
+                guildIds: string[];
+            };
+            viewedMsgDisappearTime: string;
+            groupExtFlameData: {
+                switchState: number;
+                state: number;
+                dayNums: string[];
+                version: number;
+                updateTime: string;
+                isDisplayDayNum: false;
+            };
+            groupBindGuildSwitch: number;
+            groupAioBindGuildId: string;
+            groupExcludeGuildIds: {
+                guildIds: string[];
+            };
+            fullGroupExpansionSwitch: number;
+            fullGroupExpansionSeq: string;
+            inviteRobotMemberSwitch: number;
+            inviteRobotMemberExamine: number;
+            groupSquareSwitch: number;
+        };
+    }>;
+    /**
+     * 获取群列表
+     * @param noCache - true 跳过缓存
+     */
+    getGroupList(noCache?: boolean): Promise<{
+        group_all_shut: number;
+        group_remark: string;
+        group_id: number;
+        group_name: string;
+        member_count: number;
+        max_member_count: number;
+    }[]>;
+    /**
+     * 获取群成员信息
+     * @param groupId - 群号
+     * @param userId - QQ 号
+     * @param noCache - true 跳过缓存
+     */
+    getGroupMemberInfo(groupId: number, userId: number, noCache?: boolean): Promise<{
+        group_id: number;
+        user_id: number;
+        nickname: string;
+        card: string;
+        sex: "male" | "female" | "unknown";
+        age: number;
+        area: string;
+        level: string;
+        qq_level: number;
+        join_time: number;
+        last_sent_time: number;
+        title_expire_time: number;
+        unfriendly: boolean;
+        card_changeable: boolean;
+        is_robot: boolean;
+        shut_up_timestamp: number;
+        role: "owner" | "admin" | "member";
+        title: string;
+    }>;
+    /**
+     * 获取群成员列表
+     * @param groupId - 群号
+     * @param noCache - true 跳过缓存
+     */
+    getGroupMemberList(groupId: number, noCache?: boolean): Promise<{
+        group_id: number;
+        user_id: number;
+        nickname: string;
+        card: string;
+        sex: "male" | "female" | "unknown";
+        age: number;
+        area: string;
+        level: string;
+        qq_level: number;
+        join_time: number;
+        last_sent_time: number;
+        title_expire_time: number;
+        unfriendly: boolean;
+        card_changeable: boolean;
+        is_robot: boolean;
+        shut_up_timestamp: number;
+        role: "owner" | "admin" | "member";
+        title: string;
+    }[]>;
+    /**
+     * 获取群荣誉信息
+     * @param groupId - 群号
+     * @param type - 荣誉类型: all/talkative/performer/legend/strong_newbie/emotion
+     */
+    getGroupHonorInfo(groupId: number, type?: 'all' | 'talkative' | 'performer' | 'legend' | 'strong_newbie' | 'emotion'): Promise<{
+        group_id: string;
+        current_talkative: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        };
+        talkative_list: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        }[];
+        performer_list: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        }[];
+        legend_list: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        }[];
+        emotion_list: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        }[];
+        strong_newbie_list: {
+            user_id: number;
+            nickname: string;
+            avatar: string;
+            description: string;
+        }[];
+    }>;
+    /** 获取群系统消息 */
+    getGroupSystemMsg(count?: number): Promise<{
+        invited_requests: {
+            request_id: number;
+            invitor_uin: number;
+            invitor_nick: string;
+            group_id: number;
+            message: string;
+            group_name: string;
+            checked: boolean;
+            actor: number;
+            requester_nick: string;
+        }[];
+        join_requests: {
+            request_id: number;
+            invitor_uin: number;
+            invitor_nick: string;
+            group_id: number;
+            message: string;
+            group_name: string;
+            checked: boolean;
+            actor: number;
+            requester_nick: string;
+        }[];
+    }>;
+    /** 获取群 @全体成员 剩余次数 */
+    getGroupAtAllRemain(groupId: number): Promise<{
+        can_at_all: boolean;
+        remain_at_all_count_for_group: number;
+        remain_at_all_count_for_uin: number;
+    }>;
+    /** 获取群被禁言用户列表 */
+    getGroupShutList(groupId: number): Promise<{
+        uid: string;
+        qid: string;
+        uin: string;
+        nick: string;
+        remark: string;
+        cardType: number;
+        cardName: string;
+        role: number;
+        avatarPath: string;
+        shutUpTime: number;
+        isDelete: boolean;
+        isSpecialConcerned: boolean;
+        isSpecialShield: boolean;
+        isRobot: boolean;
+        groupHonor: {
+            [key: string]: number;
+        };
+        memberRealLevel: number;
+        memberLevel: number;
+        globalGroupLevel: number;
+        globalGroupPoint: number;
+        memberTitleId: number;
+        memberSpecialTitle: string;
+        specialTitleExpireTime: string;
+        userShowFlag: number;
+        userShowFlagNew: number;
+        richFlag: number;
+        mssVipType: number;
+        bigClubLevel: number;
+        bigClubFlag: number;
+        autoRemark: string;
+        creditLevel: number;
+        joinTime: number;
+        lastSpeakTime: number;
+        memberFlag: number;
+        memberFlagExt: number;
+        memberMobileFlag: number;
+        memberFlagExt2: number;
+        isSpecialShielded: boolean;
+        cardNameId: number;
+    }[]>;
+    /** 获取群忽略的加群请求 */
+    getGroupIgnoreAddRequest(groupId: number): Promise<{
+        request_id: number;
+        invitor_uin: number;
+        invitor_nick: string;
+        group_id: number;
+        message: string;
+        group_name: string;
+        checked: boolean;
+        actor: number;
+        requester_nick: string;
+    }[]>;
+    /** 获取精华消息列表 */
+    getEssenceMsgList(groupId: number): Promise<{
+        msg_seq: number;
+        msg_random: number;
+        sender_id: number;
+        sender_nick: string;
+        operator_id: number;
+        operator_nick: string;
+        message_id: number;
+        operator_time: number;
+        content: import("node-napcat-ts").Receive[keyof import("node-napcat-ts").Receive][];
+    }[]>;
+    /** 设置精华消息 */
+    setEssenceMsg(messageId: number): Promise<void>;
+    /** 移出精华消息 */
+    deleteEssenceMsg(messageId: number): Promise<void>;
+    /**
+     * 获取陌生人信息
+     * @param userId - QQ 号
+     */
+    getStrangerInfo(userId: number): Promise<{
+        uid: string;
+        uin: string;
+        nick: string;
+        remark: string;
+        constellation: number;
+        shengXiao: number;
+        kBloodType: number;
+        homeTown: string;
+        makeFriendCareer: number;
+        pos: string;
+        college: string;
+        country: string;
+        province: string;
+        city: string;
+        postCode: string;
+        address: string;
+        regTime: number;
+        interest: string;
+        labels: string[];
+        qqLevel: number;
+        qid: string;
+        longNick: string;
+        birthday_year: number;
+        birthday_month: number;
+        birthday_day: number;
+        age: number;
+        sex: "male" | "female" | "unknown";
+        eMail: string;
+        phoneNum: string;
+        categoryId: number;
+        richTime: number;
+        richBuffer: {
+            [key: string]: number;
+        };
+        topTime: string;
+        isBlock: boolean;
+        isMsgDisturb: boolean;
+        isSpecialCareOpen: boolean;
+        isSpecialCareZone: boolean;
+        ringId: string;
+        isBlocked: boolean;
+        recommendImgFlag: number;
+        disableEmojiShortCuts: number;
+        qidianMasterFlag: number;
+        qidianCrewFlag: number;
+        qidianCrewFlag2: number;
+        isHideQQLevel: number;
+        isHidePrivilegeIcon: number;
+        status: number;
+        extStatus: number;
+        batteryStatus: number;
+        termType: number;
+        netType: number;
+        iconType: number;
+        customStatus: null;
+        setTime: string;
+        specialFlag: number;
+        abiFlag: number;
+        eNetworkType: number;
+        showName: string;
+        termDesc: string;
+        musicInfo: {
+            buf: {
+                [key: string]: number;
+            };
+        };
+        extOnlineBusinessInfo: {
+            buf: {
+                [key: string]: number;
+            };
+            customStatus: null;
+            videoBizInfo: {
+                cid: string;
+                tvUrl: string;
+                synchType: string;
+            };
+            videoInfo: {
+                name: string;
+            };
+        };
+        extBuffer: {
+            buf: {
+                [key: string]: number;
+            };
+        };
+        user_id: number;
+        nickname: string;
+        long_nick: string;
+        reg_time: number;
+        is_vip: boolean;
+        is_years_vip: boolean;
+        vip_level: number;
+        login_days: number;
+    }>;
+    /** 获取好友列表 */
+    getFriendList(): Promise<{
+        birthday_year: number;
+        birthday_month: number;
+        birthday_day: number;
+        user_id: number;
+        age: number;
+        phone_num: string;
+        email: string;
+        category_id: number;
+        nickname: string;
+        remark: string;
+        sex: "male" | "female" | "unknown";
+        level: number;
+    }[]>;
+    /** 获取好友分类列表 */
+    getFriendsWithCategory(): Promise<{
+        categoryId: number;
+        categorySortId: number;
+        categoryName: string;
+        categoryMbCount: number;
+        onlineCount: number;
+        buddyList: import("node-napcat-ts").WSSendReturn["get_friend_list"];
+    }[]>;
+    /**
+     * 删除好友
+     * @param userId - QQ 号
+     * @param tempBlock - 是否拉黑
+     * @param tempBothDel - 是否双向删除
+     */
+    deleteFriend(userId: number, tempBlock?: boolean, tempBothDel?: boolean): Promise<void>;
+    /**
+     * 处理好友申请
+     * @param flag - 申请标识（从事件中获取）
+     * @param approve - true 同意 / false 拒绝
+     * @param remark - 好友备注
+     */
+    handleFriendAddRequest(flag: string, approve?: boolean, remark?: string): Promise<void>;
+    /** 获取用户在线状态 */
+    getUserStatus(userId: number): Promise<{
+        status: number;
+        ext_status: number;
+    }>;
+    /** 设置个人签名 */
+    setSelfLongnick(longnick: string): Promise<void>;
+    /**
+     * 群内戳一戳
+     * @param groupId - 群号
+     * @param userId - 目标 QQ
+     */
+    groupPoke(groupId: number, userId: number): Promise<void>;
+    /**
+     * 好友戳一戳
+     * @param userId - 目标 QQ
+     */
+    friendPoke(userId: number): Promise<void>;
+    /** 发送戳一戳（通用，自动判断群/私聊） */
+    sendPoke(userId: number, groupId?: number): Promise<void>;
+    /**
+     * 点赞
+     * @param userId - 目标 QQ
+     * @param times - 次数，默认 1
+     */
+    sendLike(userId: number, times?: number): Promise<void>;
+    /**
+     * 获取图片文件
+     * @param file - 图片 file_id 或 URL
+     */
+    getImage(file: string): Promise<{
+        file: string;
+        url: string;
+        file_size: string;
+        file_name: string;
+    }>;
+    /**
+     * 获取语音文件
+     * @param file - 语音 file_id 或 URL
+     * @param outFormat - 输出格式
+     */
+    getRecord(file: string, outFormat?: 'mp3' | 'amr' | 'wma' | 'm4a' | 'spx' | 'ogg' | 'wav' | 'flac'): Promise<{
+        file: string;
+        url: string;
+        file_size: string;
+        file_name: string;
+    }>;
+    /**
+     * 上传群文件
+     * @param groupId - 群号
+     * @param file - 本地文件路径
+     * @param name - 显示名称
+     * @param folderId - 目标文件夹 ID
+     */
+    uploadGroupFile(groupId: number, file: string, name: string, folderId?: string): Promise<void>;
+    /**
+     * 上传私聊文件
+     * @param userId - QQ 号
+     * @param file - 本地文件路径
+     * @param name - 显示名称
+     */
+    uploadPrivateFile(userId: number, file: string, name: string): Promise<void>;
+    /**
+     * 获取群文件下载链接
+     * @param groupId - 群号
+     * @param fileId - 文件 ID
+     */
+    getGroupFileUrl(groupId: number, fileId: string): Promise<{
+        url: string;
+    }>;
+    /**
+     * 图片 OCR 识别
+     * @param image - 图片 file_id 或 base64
+     */
+    ocrImage(image: string): Promise<{
+        text: string;
+        pt1: {
+            x: string;
+            y: string;
+        };
+        pt2: {
+            x: string;
+            y: string;
+        };
+        pt3: {
+            x: string;
+            y: string;
+        };
+        pt4: {
+            x: string;
+            y: string;
+        };
+        charBox: {
+            charText: string;
+            charBox: {
+                pt1: {
+                    x: string;
+                    y: string;
+                };
+                pt2: {
+                    x: string;
+                    y: string;
+                };
+                pt3: {
+                    x: string;
+                    y: string;
+                };
+                pt4: {
+                    x: string;
+                    y: string;
+                };
+            };
+        }[];
+        score: string;
+    }[]>;
+    /** 获取文件信息 */
+    getFile(file: string): Promise<{
+        file: string;
+        url: string;
+        file_size: string;
+        file_name: string;
+    }>;
+    /** 下载文件到缓存目录 */
+    downloadFile(url: string, name?: string, headers?: string[]): Promise<{
+        file: string;
+    }>;
+    /** 获取收藏表情 */
+    fetchCustomFace(count?: number): Promise<string[]>;
+    /** 删除群文件 */
+    deleteGroupFile(groupId: number, fileId: string): Promise<void>;
+    /** 创建群文件夹 */
+    createGroupFileFolder(groupId: number, folderName: string): Promise<void>;
+    /** 删除群文件夹 */
+    deleteGroupFolder(groupId: number, folderId: string): Promise<void>;
+    /** 获取群文件系统信息 */
+    getGroupFileSystemInfo(groupId: number): Promise<{
+        file_count: number;
+        limit_count: 10000;
+        used_space: 0;
+        total_space: 10737418240;
+    }>;
+    /** 获取群根目录文件列表 */
+    getGroupRootFiles(groupId: number): Promise<{
+        files: {
+            group_id: number;
+            file_id: string;
+            file_name: string;
+            busid: number;
+            size: number;
+            file_size: number;
+            upload_time: number;
+            dead_time: number;
+            modify_time: number;
+            download_times: number;
+            uploader: number;
+            uploader_name: string;
+        }[];
+        folders: {
+            group_id: number;
+            folder_id: string;
+            folder: string;
+            folder_name: string;
+            create_time: number;
+            creator: number;
+            creator_name: string;
+            total_file_count: number;
+        }[];
+    }>;
+    /** 获取群子目录文件列表 */
+    getGroupFilesByFolder(groupId: number, folderId: string): Promise<{
+        files: {
+            group_id: number;
+            file_id: string;
+            file_name: string;
+            busid: number;
+            size: number;
+            file_size: number;
+            upload_time: number;
+            dead_time: number;
+            modify_time: number;
+            download_times: number;
+            uploader: number;
+            uploader_name: string;
+        }[];
+        folders: {
+            group_id: number;
+            folder_id: string;
+            folder: string;
+            folder_name: string;
+            create_time: number;
+            creator: number;
+            creator_name: string;
+            total_file_count: number;
+        }[];
+    }>;
+    /** 获取最近的聊天记录 */
+    getRecentContact(): Promise<({
+        lastestMsg: import("node-napcat-ts").WSSendReturn["get_msg"];
+        peerUin: string;
+        remark: string;
+        msgTime: string;
+        chatType: number;
+        msgId: string;
+        sendNickName: string;
+        sendMemberName: string;
+        peerName: string;
+    } | {
+        peerUin: string;
+        remark: string;
+        msgTime: number;
+        chatType: number;
+        msgId: string;
+        sendNickName: string;
+        sendMemberName: string;
+        peerName: string;
+    })[]>;
+    /** 获取自身点赞列表 */
+    getProfileLike(): Promise<{
+        uid: string;
+        time: number;
+        favoriteInfo: {
+            total_count: number;
+            last_time: number;
+            today_count: number;
+            userInfos: {
+                age: number;
+                bAvailableCnt: number;
+                bTodayVotedCnt: number;
+                count: number;
+                customId: number;
+                gender: number;
+                giftCount: number;
+                isFriend: boolean;
+                isSvip: boolean;
+                isvip: boolean;
+                lastCharged: number;
+                latestTime: number;
+                nick: string;
+                src: number;
+                uid: string;
+                uin: number;
+            }[];
+        };
+        voteInfo: {
+            total_count: number;
+            new_count: number;
+            new_nearby_count: number;
+            last_visit_time: number;
+            userInfos: {
+                age: number;
+                bAvailableCnt: number;
+                bTodayVotedCnt: number;
+                count: number;
+                customId: number;
+                gender: number;
+                giftCount: number;
+                isFriend: boolean;
+                isSvip: boolean;
+                isvip: boolean;
+                lastCharged: number;
+                latestTime: number;
+                nick: string;
+                src: number;
+                uid: string;
+                uin: number;
+            }[];
+        };
+    }[]>;
+    /** 创建文本收藏 */
+    createCollection(rawData: string, brief: string): Promise<void>;
+    /** 获取收藏列表 */
+    getCollectionList(category?: number, count?: number): Promise<{
+        result: 0;
+        errMsg: string;
+        collectionSearchList: {
+            collectionItemList: {
+                cid: string;
+                type: number;
+                status: number;
+                author: {
+                    type: number;
+                    numId: string;
+                    strId: string;
+                    groupId: string;
+                    groupName: string;
+                    uid: string;
+                };
+                bid: number;
+                category: number;
+                createTime: string;
+                collectTime: string;
+                modifyTime: string;
+                sequence: string;
+                shareUrl: string;
+                customGroupId: number;
+                securityBeat: boolean;
+                summary: {
+                    textSummary: unknown;
+                    linkSummary: unknown;
+                    gallerySummary: unknown;
+                    audioSummary: unknown;
+                    videoSummary: unknown;
+                    fileSummary: unknown;
+                    locationSummary: unknown;
+                    richMediaSummary: unknown;
+                };
+            }[];
+            hasMore: boolean;
+            bottomTimeStamp: string;
+        };
+    }>;
+    /** 推荐联系人/群聊 */
+    recommendContact(userId: number, phoneNumber?: string): Promise<void>;
+    /** 推荐群聊 */
+    recommendGroup(groupId: number): Promise<void>;
+    /** 获取 AI 语音角色列表 */
+    getAiCharacters(): Promise<{
+        type: string;
+        characters: {
+            character_id: string;
+            character_name: string;
+            preview_url: string;
+        }[];
+    }[]>;
+    /** AI 文字转语音 */
+    getAiRecord(characterId: string, text: string): Promise<string>;
+    /** 群聊发送 AI 语音 */
+    sendGroupAiRecord(groupId: number, characterId: string, text: string): Promise<void>;
+    /** 签名小程序卡片（如 B 站分享卡片） */
+    getMiniAppArk(app: string, bizSrc: string, meta: any): Promise<{
+        data: {
+            ver: string;
+            prompt: string;
+            config: {
+                type: string;
+                width: number;
+                height: number;
+                forward: number;
+                autoSize: number;
+                ctime: number;
+                token: string;
+            };
+            app: string;
+            view: string;
+            meta: {
+                detail_1: {
+                    appid: string;
+                    appType: number;
+                    title: string;
+                    desc: string;
+                    icon: string;
+                    preview: string;
+                    url: string;
+                    scene: number;
+                    host: {
+                        uin: number;
+                        nick: string;
+                    };
+                    shareTemplateId: string;
+                    shareTemplateData: {
+                        [key: string]: number;
+                    };
+                    showLittleTail: string;
+                    gamePoints: string;
+                    gamePointsUrl: string;
+                    shareOrigin: number;
+                };
+            };
+            miniappShareOrigin: number;
+            miniappOpenRefer: string;
+        } | {
+            appName: string;
+            appView: string;
+            ver: string;
+            desc: string;
+            prompt: string;
+            metaData: {
+                detail_1: {
+                    appid: string;
+                    appType: number;
+                    title: string;
+                    desc: string;
+                    icon: string;
+                    preview: string;
+                    url: string;
+                    scene: number;
+                    host: {
+                        uin: number;
+                        nick: string;
+                    };
+                    shareTemplateId: string;
+                    shareTemplateData: {
+                        [key: string]: number;
+                    };
+                    showLittleTail: string;
+                    gamePoints: string;
+                    gamePointsUrl: string;
+                    shareOrigin: number;
+                };
+            };
+            config: {
+                type: string;
+                width: number;
+                height: number;
+                forward: number;
+                autoSize: number;
+                ctime: number;
+                token: string;
+            };
+        };
+    }>;
+    /** 获取 bot 运行状态 */
+    getStatus(): Promise<{
+        online: boolean;
+        good: true;
+        stat: {};
+    }>;
+    /** 获取 napcat 版本信息 */
+    getVersionInfo(): Promise<{
+        app_name: "NapCat.Onebot";
+        protocol_version: "v11";
+        app_version: string;
+    }>;
+    /** 获取 Cookies */
+    getCookies(domain: string): Promise<{
+        cookies: string;
+        bkn: string;
+    }>;
+    /** 获取 CSRF Token */
+    getCsrfToken(): Promise<{
+        token: number;
+    }>;
+    /** 获取 QQ 相关接口凭证 (cookies + csrf_token) */
+    getCredentials(): Promise<{
+        cookies: string;
+        token: number;
+    }>;
+    /** 检查是否可以发送图片 */
+    canSendImage(): Promise<{
+        yes: true;
+    }>;
+    /** 检查是否可以发送语音 */
+    canSendRecord(): Promise<{
+        yes: true;
+    }>;
+    /** 清理缓存 */
+    cleanCache(): Promise<void>;
+    /** 获取 Rkey */
+    getRkey(): Promise<{
+        rkey: string;
+        ttl: string;
+        time: number;
+        type: number;
+    }[]>;
+    /** 获取 PacketServer 状态 */
+    getPacketStatus(): Promise<undefined>;
+    /** 获取机器人 QQ 号区间 */
+    getRobotUinRange(): Promise<{
+        minUin: string;
+        maxUin: string;
+    }[]>;
+    /** 设置在线状态 */
+    setOnlineStatus(status: number, extStatus?: number, batteryStatus?: number): Promise<void>;
+    /** 设置 QQ 资料 */
+    setQQProfile(nickname: string, personalNote?: string, sex?: number): Promise<void>;
+    /** 设置 QQ 头像，file 支持本地路径/base64/URL */
+    setQQAvatar(file: string): Promise<void>;
+    /**
+     * 设置输入状态（"正在输入…"）
+     * @param userId - QQ 号
+     * @param eventType - 状态类型（具体值参考 napcat 文档）
+     */
+    setInputStatus(userId: number, eventType: number): Promise<void>;
+    /** 对事件执行快速操作（隐藏 API） */
+    handleQuickOperation(context: any, operation: any): Promise<void>;
+}