@onebots/adapter-icqq 1.0.0

package/lib/adapter.js

@@ -0,0 +1,561 @@
+/**
+ * ICQQ 适配器
+ * 继承 Adapter 基类，实现 ICQQ 平台功能
+ */
+import { Account, AdapterRegistry, AccountStatus } from "onebots";
+import { Adapter } from "onebots";
+import { ICQQBot, segment } from "./bot.js";
+export class ICQQAdapter extends Adapter {
+    constructor(app) {
+        super(app, "icqq");
+        this.icon = "https://qzonestyle.gtimg.cn/qzone/qzact/act/external/tiqq/logo.png";
+    }
+    // ============================================
+    // 消息相关方法
+    // ============================================
+    /**
+     * 发送消息
+     */
+    async sendMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const { scene_id, scene_type, message } = params;
+        // 转换消息格式
+        const icqqMessage = this.buildICQQMessage(message);
+        const targetId = parseInt(scene_id.string);
+        let result;
+        if (scene_type === 'private') {
+            result = await bot.sendPrivateMessage(targetId, icqqMessage);
+        }
+        else if (scene_type === 'group') {
+            result = await bot.sendGroupMessage(targetId, icqqMessage);
+        }
+        else {
+            throw new Error(`不支持的消息类型: ${scene_type}`);
+        }
+        return {
+            message_id: this.createId(result.message_id || result.seq?.toString() || ''),
+        };
+    }
+    /**
+     * 删除/撤回消息
+     */
+    async deleteMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        await bot.recallMessage(params.message_id.string);
+    }
+    /**
+     * 获取消息
+     */
+    async getMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const msg = await bot.getMessage(params.message_id.string);
+        const isGroup = !!msg.group_id;
+        return {
+            message_id: this.createId(msg.message_id),
+            time: msg.time * 1000,
+            sender: {
+                scene_type: isGroup ? 'group' : 'private',
+                sender_id: this.createId(msg.user_id.toString()),
+                scene_id: this.createId(isGroup ? msg.group_id.toString() : msg.user_id.toString()),
+                sender_name: msg.sender?.nickname || '',
+                scene_name: '',
+            },
+            message: this.convertICQQMessageToSegments(msg.message || []),
+        };
+    }
+    // ============================================
+    // 用户相关方法
+    // ============================================
+    /**
+     * 获取机器人自身信息
+     */
+    async getLoginInfo(uin) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const info = bot.getLoginInfo();
+        if (!info)
+            throw new Error('Bot not ready');
+        return {
+            user_id: this.createId(info.user_id.toString()),
+            user_name: info.nickname,
+            user_displayname: info.nickname,
+            avatar: info.avatar,
+        };
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUserInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const userId = parseInt(params.user_id.string);
+        const info = await bot.getStrangerInfo(userId);
+        return {
+            user_id: this.createId(info.user_id.toString()),
+            user_name: info.nickname,
+            user_displayname: info.nickname,
+            avatar: info.avatar,
+        };
+    }
+    // ============================================
+    // 好友相关方法
+    // ============================================
+    /**
+     * 获取好友列表
+     */
+    async getFriendList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const friends = await bot.getFriendList();
+        return friends.map(friend => ({
+            user_id: this.createId(friend.user_id.toString()),
+            user_name: friend.nickname,
+            remark: friend.remark,
+        }));
+    }
+    /**
+     * 获取好友信息
+     */
+    async getFriendInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const userId = parseInt(params.user_id.string);
+        const info = await bot.getStrangerInfo(userId);
+        return {
+            user_id: this.createId(info.user_id.toString()),
+            user_name: info.nickname,
+        };
+    }
+    // ============================================
+    // 群组相关方法
+    // ============================================
+    /**
+     * 获取群列表
+     */
+    async getGroupList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groups = await bot.getGroupList();
+        return groups.map(group => ({
+            group_id: this.createId(group.group_id.toString()),
+            group_name: group.group_name,
+            member_count: group.member_count,
+            max_member_count: group.max_member_count,
+        }));
+    }
+    /**
+     * 获取群信息
+     */
+    async getGroupInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        const info = await bot.getGroupInfo(groupId);
+        if (!info)
+            throw new Error(`Group ${groupId} not found`);
+        return {
+            group_id: this.createId(info.group_id.toString()),
+            group_name: info.group_name,
+            member_count: info.member_count,
+            max_member_count: info.max_member_count,
+        };
+    }
+    /**
+     * 退出群组
+     */
+    async leaveGroup(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        await bot.leaveGroup(groupId);
+    }
+    /**
+     * 获取群成员列表
+     */
+    async getGroupMemberList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        const members = await bot.getGroupMemberList(groupId);
+        return members.map(member => ({
+            group_id: params.group_id,
+            user_id: this.createId(member.user_id.toString()),
+            user_name: member.nickname,
+            card: member.card || '',
+            role: member.role || 'member',
+        }));
+    }
+    /**
+     * 获取群成员信息
+     */
+    async getGroupMemberInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        const userId = parseInt(params.user_id.string);
+        const member = await bot.getGroupMemberInfo(groupId, userId);
+        if (!member)
+            throw new Error(`Member ${userId} not found in group ${groupId}`);
+        return {
+            group_id: params.group_id,
+            user_id: params.user_id,
+            user_name: member.nickname,
+            card: member.card || '',
+            role: member.role || 'member',
+        };
+    }
+    /**
+     * 踢出群成员
+     */
+    async kickGroupMember(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        const userId = parseInt(params.user_id.string);
+        await bot.kickGroupMember(groupId, userId, params.reject_add_request);
+    }
+    /**
+     * 设置群名片
+     */
+    async setGroupCard(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const groupId = parseInt(params.group_id.string);
+        const userId = parseInt(params.user_id.string);
+        await bot.setGroupCard(groupId, userId, params.card);
+    }
+    // ============================================
+    // 系统相关方法
+    // ============================================
+    /**
+     * 获取版本信息
+     */
+    async getVersion(uin) {
+        return {
+            app_name: 'onebots ICQQ Adapter',
+            app_version: '1.0.0',
+            impl: 'icqq',
+            version: '1.0.0',
+        };
+    }
+    /**
+     * 获取运行状态
+     */
+    async getStatus(uin) {
+        const account = this.getAccount(uin);
+        return {
+            online: account?.status === AccountStatus.Online,
+            good: account?.status === AccountStatus.Online,
+        };
+    }
+    // ============================================
+    // 账号创建
+    // ============================================
+    createAccount(config) {
+        const icqqConfig = {
+            account_id: config.account_id,
+            password: config.password,
+            protocol: config.protocol,
+        };
+        const bot = new ICQQBot(icqqConfig);
+        const account = new Account(this, bot, config);
+        // 监听 Bot 事件
+        bot.on('ready', (user) => {
+            this.logger.info(`ICQQ Bot ${user.nickname} (${user.user_id}) 已就绪`);
+            account.status = AccountStatus.Online;
+            account.nickname = user.nickname;
+            account.avatar = user.avatar;
+        });
+        bot.on('offline', (event) => {
+            this.logger.warn(`ICQQ Bot 离线: ${event.message}`);
+            account.status = AccountStatus.OffLine;
+        });
+        bot.on('qrcode', (event) => {
+            this.logger.info(`ICQQ 请扫描二维码登录`);
+            // 可以通过事件通知前端显示二维码
+            this.emit('qrcode', { account_id: config.account_id, image: event.image });
+        });
+        bot.on('slider', (event) => {
+            this.logger.info(`ICQQ 需要滑块验证: ${event.url}`);
+            // 可以通过事件通知前端进行滑块验证
+            this.emit('slider', { account_id: config.account_id, url: event.url });
+        });
+        bot.on('device', (event) => {
+            this.logger.info(`ICQQ 需要设备锁验证: ${event.url}`);
+            // 可以通过事件通知前端进行设备锁验证
+            this.emit('device', { account_id: config.account_id, url: event.url, phone: event.phone });
+        });
+        bot.on('login_error', (event) => {
+            this.logger.error(`ICQQ 登录失败:`, event);
+            account.status = AccountStatus.OffLine;
+        });
+        // 监听私聊消息
+        bot.on('private_message', (event) => {
+            // 打印消息接收日志
+            const contentPreview = event.raw_message.length > 100
+                ? event.raw_message.substring(0, 100) + '...'
+                : event.raw_message;
+            this.logger.info(`[ICQQ] 收到私聊消息 | 消息ID: ${event.message_id} | ` +
+                `发送者: ${event.sender.nickname} (${event.user_id}) | 内容: ${contentPreview}`);
+            // 转换为 CommonEvent 格式
+            const commonEvent = {
+                id: this.createId(event.message_id),
+                timestamp: event.time * 1000,
+                platform: 'icqq',
+                bot_id: this.createId(config.account_id),
+                type: 'message',
+                message_type: 'private',
+                sender: {
+                    id: this.createId(event.user_id.toString()),
+                    name: event.sender.nickname,
+                    avatar: `https://q1.qlogo.cn/g?b=qq&nk=${event.user_id}&s=640`,
+                },
+                message_id: this.createId(event.message_id),
+                raw_message: event.raw_message,
+                message: this.convertICQQMessageToSegments(event.message),
+            };
+            // 派发到协议层
+            account.dispatch(commonEvent);
+        });
+        // 监听群消息
+        bot.on('group_message', (event) => {
+            // 打印消息接收日志
+            const contentPreview = event.raw_message.length > 100
+                ? event.raw_message.substring(0, 100) + '...'
+                : event.raw_message;
+            this.logger.info(`[ICQQ] 收到群消息 | 消息ID: ${event.message_id} | 群: ${event.group.group_name} (${event.group_id}) | ` +
+                `发送者: ${event.sender.nickname} (${event.user_id}) | 内容: ${contentPreview}`);
+            // 转换为 CommonEvent 格式
+            const commonEvent = {
+                id: this.createId(event.message_id),
+                timestamp: event.time * 1000,
+                platform: 'icqq',
+                bot_id: this.createId(config.account_id),
+                type: 'message',
+                message_type: 'group',
+                sender: {
+                    id: this.createId(event.user_id.toString()),
+                    name: event.sender.nickname,
+                    avatar: `https://q1.qlogo.cn/g?b=qq&nk=${event.user_id}&s=640`,
+                },
+                group: {
+                    id: this.createId(event.group_id.toString()),
+                    name: event.group.group_name,
+                },
+                message_id: this.createId(event.message_id),
+                raw_message: event.raw_message,
+                message: this.convertICQQMessageToSegments(event.message),
+            };
+            // 派发到协议层
+            account.dispatch(commonEvent);
+        });
+        // 监听群成员增加
+        bot.on('group_increase', (event) => {
+            const noticeEvent = {
+                id: this.createId(`${event.group_id}_${event.user_id}_${event.time}`),
+                timestamp: event.time * 1000,
+                platform: 'icqq',
+                bot_id: this.createId(config.account_id),
+                type: 'notice',
+                notice_type: 'group_increase',
+                sub_type: event.operator_id === event.user_id ? 'approve' : 'invite',
+                group: {
+                    id: this.createId(event.group_id.toString()),
+                },
+                user: {
+                    id: this.createId(event.user_id.toString()),
+                },
+                operator: event.operator_id ? {
+                    id: this.createId(event.operator_id.toString()),
+                } : undefined,
+            };
+            account.dispatch(noticeEvent);
+        });
+        // 监听群成员减少
+        bot.on('group_decrease', (event) => {
+            const noticeEvent = {
+                id: this.createId(`${event.group_id}_${event.user_id}_${event.time}`),
+                timestamp: event.time * 1000,
+                platform: 'icqq',
+                bot_id: this.createId(config.account_id),
+                type: 'notice',
+                notice_type: 'group_decrease',
+                sub_type: event.sub_type,
+                group: {
+                    id: this.createId(event.group_id.toString()),
+                },
+                user: {
+                    id: this.createId(event.user_id.toString()),
+                },
+                operator: event.operator_id ? {
+                    id: this.createId(event.operator_id.toString()),
+                } : undefined,
+            };
+            account.dispatch(noticeEvent);
+        });
+        // 启动时初始化 Bot
+        account.on('start', async () => {
+            try {
+                await bot.start();
+            }
+            catch (error) {
+                this.logger.error(`启动 ICQQ Bot 失败:`, error);
+                account.status = AccountStatus.OffLine;
+            }
+        });
+        account.on('stop', async () => {
+            await bot.stop();
+            account.status = AccountStatus.OffLine;
+        });
+        return account;
+    }
+    // ============================================
+    // 消息转换
+    // ============================================
+    /**
+     * 构建 ICQQ 消息
+     */
+    buildICQQMessage(message) {
+        const result = [];
+        for (const seg of message) {
+            if (typeof seg === 'string') {
+                result.push(seg);
+            }
+            else if (seg.type === 'text') {
+                result.push(seg.data.text || '');
+            }
+            else if (seg.type === 'at') {
+                const qq = seg.data.qq || seg.data.id || seg.data.user_id;
+                if (qq === 'all') {
+                    result.push(segment.at('all'));
+                }
+                else {
+                    result.push(segment.at(parseInt(qq)));
+                }
+            }
+            else if (seg.type === 'image') {
+                const file = seg.data.url || seg.data.file;
+                if (file) {
+                    result.push(segment.image(file));
+                }
+            }
+            else if (seg.type === 'face') {
+                const id = seg.data.id;
+                if (id !== undefined) {
+                    result.push(segment.face(parseInt(id)));
+                }
+            }
+            else if (seg.type === 'record' || seg.type === 'audio') {
+                const file = seg.data.url || seg.data.file;
+                if (file) {
+                    result.push(segment.record(file));
+                }
+            }
+            else if (seg.type === 'video') {
+                const file = seg.data.url || seg.data.file;
+                if (file) {
+                    result.push(segment.video(file));
+                }
+            }
+            else if (seg.type === 'reply') {
+                const id = seg.data.id;
+                if (id) {
+                    result.push({ type: 'reply', id });
+                }
+            }
+            else if (seg.type === 'share') {
+                result.push(segment.share(seg.data.url || '', seg.data.title || '', seg.data.content, seg.data.image));
+            }
+            else if (seg.type === 'json') {
+                result.push(segment.json(seg.data.data || ''));
+            }
+            else if (seg.type === 'xml') {
+                result.push(segment.xml(seg.data.data || ''));
+            }
+        }
+        return result;
+    }
+    /**
+     * 转换 ICQQ 消息到 Segment
+     */
+    convertICQQMessageToSegments(message) {
+        const result = [];
+        for (const elem of message) {
+            switch (elem.type) {
+                case 'text':
+                    result.push({ type: 'text', data: { text: elem.text } });
+                    break;
+                case 'face':
+                    result.push({ type: 'face', data: { id: elem.id.toString() } });
+                    break;
+                case 'image':
+                    result.push({ type: 'image', data: { url: elem.url || elem.file, file: elem.file } });
+                    break;
+                case 'record':
+                    result.push({ type: 'record', data: { url: elem.url || elem.file, file: elem.file } });
+                    break;
+                case 'video':
+                    result.push({ type: 'video', data: { url: elem.url || elem.file, file: elem.file } });
+                    break;
+                case 'at':
+                    result.push({ type: 'at', data: { qq: elem.qq.toString() } });
+                    break;
+                case 'share':
+                    result.push({ type: 'share', data: { url: elem.url, title: elem.title, content: elem.content, image: elem.image } });
+                    break;
+                case 'json':
+                    result.push({ type: 'json', data: { data: elem.data } });
+                    break;
+                case 'xml':
+                    result.push({ type: 'xml', data: { data: elem.data } });
+                    break;
+                case 'reply':
+                    result.push({ type: 'reply', data: { id: elem.id } });
+                    break;
+                default:
+                    result.push({ type: 'text', data: { text: `[${elem.type}]` } });
+            }
+        }
+        return result;
+    }
+}
+AdapterRegistry.register('icqq', ICQQAdapter, {
+    name: 'icqq',
+    displayName: 'ICQQ 机器人',
+    description: '基于 ICQQ 协议的 QQ 机器人适配器，支持扫码登录和密码登录',
+    icon: 'https://qzonestyle.gtimg.cn/qzone/qzact/act/external/tiqq/logo.png',
+    homepage: 'https://github.com/icqqjs/icqq',
+    author: '凉菜',
+});
+//# sourceMappingURL=adapter.js.map