@alemonjs/qq-bot 2.1.31 → 2.1.33

package/lib/register.js

@@ -1,15 +1,20 @@
-import { cbpPlatform, FormatEvent, ResultCode, createResult } from 'alemonjs';
+import { cbpPlatform, FormatEvent, createResult, ResultCode, logger } from 'alemonjs';
+import { createHash } from 'node:crypto';
+import { stat, readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { chunkedUpload } from './upload.js';
 import { GROUP_AT_MESSAGE_CREATE, C2C_MESSAGE_CREATE, DIRECT_MESSAGE_CREATE, AT_MESSAGE_CREATE, MESSAGE_CREATE } from './sends.js';
 import { getQQBotConfig, platform, getMaster, getIdentity } from './config.js';
 
-const register = (client) => {
+const register = (client, options) => {
+    const MAX_MEDIA_SIZE = 100 * 1024 * 1024;
     const config = getQQBotConfig();
-    const botId = String(config?.app_id ?? '');
+    const botId = String(options?.botId ?? config?.app_id ?? '');
     const port = process.env?.port || config?.port || 17117;
     const url = `ws://127.0.0.1:${port}`;
-    const cbp = cbpPlatform(url);
+    const cbp = options?.cbp ?? cbpPlatform(url);
     const createUserAvatarURL = (authorId) => {
-        return `https://q.qlogo.cn/qqapp/${config.app_id}/${authorId}/640`;
+        return `https://q.qlogo.cn/qqapp/${botId}/${authorId}/640`;
     };
     const getGroupMessageMeta = (event) => {
         const author = event?.author;
@@ -39,6 +44,122 @@ const register = (client) => {
             auditTime
         };
     };
+    const getMediaItems = (attachments) => {
+        return (attachments || []).flatMap(attachment => {
+            if (!attachment?.url) {
+                return [];
+            }
+            const mimeType = attachment.content_type || '';
+            const Type = mimeType.startsWith('image/')
+                ? 'image'
+                : mimeType.startsWith('audio/')
+                    ? 'audio'
+                    : mimeType.startsWith('video/')
+                        ? 'video'
+                        : 'file';
+            return [
+                {
+                    Type,
+                    Url: attachment.url,
+                    ...(attachment.filename && { FileName: attachment.filename }),
+                    ...(typeof attachment.size === 'number' && { FileSize: attachment.size }),
+                    ...(mimeType && { MimeType: mimeType })
+                }
+            ];
+        });
+    };
+    const normalizeTarget = (target) => {
+        if (!target?.targetId || !target.scope) {
+            return undefined;
+        }
+        return target;
+    };
+    const validateTargetBot = (target) => {
+        return !target.BotId || target.BotId === botId;
+    };
+    const mediaCache = new Map();
+    const mediaType = (type) => (type === 'image' ? 1 : type === 'video' ? 2 : type === 'audio' ? 3 : 4);
+    const prepareMedia = async (target, params) => {
+        const sources = [params?.url, params?.data, params?.filePath, params?.fileId].filter(value => value !== undefined && value !== '').length;
+        if (sources !== 1) {
+            throw new Error('Provide exactly one media source: url, data, filePath, or fileId');
+        }
+        if (params.fileId) {
+            return { fileId: String(params.fileId), reused: true };
+        }
+        let data = params.data;
+        let buffer;
+        let filePath;
+        let fileSize;
+        let hashes;
+        let name = params.name;
+        let hashSource = String(params.url || '');
+        if (params.filePath) {
+            const metadata = await stat(String(params.filePath));
+            if (!metadata.isFile()) {
+                throw new Error('media filePath must point to a regular file');
+            }
+            if (metadata.size > MAX_MEDIA_SIZE) {
+                throw new Error('QQ media files must not exceed 100 MiB');
+            }
+            filePath = String(params.filePath);
+            fileSize = metadata.size;
+            hashes = await client.getMediaFileHashes(filePath);
+            hashSource = hashes.sha256;
+            name ||= basename(filePath);
+            if (fileSize < 5 * 1024 * 1024) {
+                buffer = await readFile(filePath);
+                data = `base64://${buffer.toString('base64')}`;
+            }
+        }
+        else if (data) {
+            hashSource = data;
+            const value = data.replace(/^base64:\/\//, '');
+            buffer = Buffer.from(value, 'base64');
+            if (buffer.length > MAX_MEDIA_SIZE) {
+                throw new Error('QQ media files must not exceed 100 MiB');
+            }
+        }
+        const key = [botId, target.scope, target.targetId, params.type, createHash('sha256').update(hashSource).digest('hex')].join(':');
+        const cached = mediaCache.get(key);
+        if (cached && (!cached.expiresAt || cached.expiresAt > Date.now())) {
+            return { fileId: cached.fileId, expiresAt: cached.expiresAt, reused: true };
+        }
+        return { key, url: params.url, data, buffer, filePath, fileSize, hashes, name, reused: false };
+    };
+    const uploadMedia = async (target, params) => {
+        if (!validateTargetBot(target)) {
+            throw new Error(`BotId ${target.BotId} is not active`);
+        }
+        if (target.scope !== 'group' && target.scope !== 'c2c') {
+            throw new Error('QQ media upload only supports group and c2c targets');
+        }
+        const prepared = await prepareMedia(target, params);
+        if (prepared.fileId) {
+            return prepared;
+        }
+        const fileType = mediaType(params.type);
+        const value = prepared.filePath && prepared.fileSize && prepared.fileSize >= 5 * 1024 * 1024
+            ? await client.postChunkedRichMedia({
+                scope: target.scope,
+                targetId: target.targetId,
+                fileType,
+                filePath: prepared.filePath,
+                size: prepared.fileSize,
+                hashes: prepared.hashes,
+                name: prepared.name
+            })
+            : prepared.buffer && prepared.buffer.length >= 5 * 1024 * 1024
+                ? await client.postChunkedRichMedia({ scope: target.scope, targetId: target.targetId, fileType, data: prepared.buffer, name: prepared.name })
+                : target.scope === 'group'
+                    ? await client.postRichMediaByGroup(target.targetId, { file_type: fileType, url: prepared.url, file_data: prepared.data, srv_send_msg: false })
+                    : await client.postRichMediaByUser(target.targetId, { file_type: fileType, url: prepared.url, file_data: prepared.data, srv_send_msg: false });
+        const expiresAt = value.ttl ? Date.now() + value.ttl * 1000 : undefined;
+        if (prepared.key) {
+            mediaCache.set(prepared.key, { fileId: value.file_info, expiresAt });
+        }
+        return { fileId: value.file_info, expiresAt, reused: false };
+    };
     const createUserMeta = (UserId, extra = {}) => {
         const [IsMaster, UserKey] = getIdentity(UserId);
         return {
@@ -85,6 +206,7 @@ const register = (client) => {
         })
             .addMessage({ MessageId: meta.messageId })
             .addText({ MessageText: msg?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: meta.openId })
             .add({ tag: 'GROUP_MESSAGE_CREATE' }).value);
     });
@@ -108,6 +230,24 @@ const register = (client) => {
             .addUser({ UserId: UserId, UserKey, UserName: event?.username ?? '', UserAvatar: createUserAvatarURL(UserId), IsMaster: isMaster, IsBot: false })
             .add({ tag: 'GROUP_MEMBER_REMOVE' }).value);
     });
+    client.on('GROUP_JOIN_REQUEST', event => {
+        const UserId = event.member_openid ?? '';
+        const [isMaster, UserKey] = getMaster(UserId);
+        cbp.send(FormatEvent.create('notice.create')
+            .addPlatform({ Platform: platform, value: event, BotId: botId })
+            .addGuild({ GuildId: event.group_openid ?? '', SpaceId: `GROUP:${event.group_openid ?? ''}` })
+            .addChannel({ ChannelId: event.group_openid ?? '' })
+            .addUser({
+            UserId: UserId,
+            UserKey,
+            UserName: event?.username ?? '',
+            UserAvatar: createUserAvatarURL(UserId),
+            IsMaster: isMaster,
+            IsBot: event.bot ?? false
+        })
+            .addMessage({ MessageId: `group_join_request_${event.group_openid}_${event.join_request_id}` })
+            .add({ tag: 'GROUP_JOIN_REQUEST' }).value);
+    });
     client.on('GROUP_AT_MESSAGE_CREATE', event => {
         if (event?.author?.bot) {
             return;
@@ -128,6 +268,7 @@ const register = (client) => {
         })
             .addMessage({ MessageId: meta.messageId })
             .addText({ MessageText: msg?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: meta.openId })
             .add({ tag: 'GROUP_AT_MESSAGE_CREATE' }).value);
     });
@@ -147,6 +288,7 @@ const register = (client) => {
         })
             .addMessage({ MessageId: event.id })
             .addText({ MessageText: event.content?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: `C2C:${event.author.user_openid}` })
             .add({ tag: 'C2C_MESSAGE_CREATE' }).value);
     });
@@ -170,6 +312,7 @@ const register = (client) => {
         })
             .addMessage({ MessageId: event.id })
             .addText({ MessageText: msg?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: `DIRECT:${event.guild_id}` })
             .add({ tag: 'DIRECT_MESSAGE_CREATE' }).value);
     });
@@ -195,6 +338,7 @@ const register = (client) => {
         })
             .addMessage({ MessageId: event.id })
             .addText({ MessageText: msg?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: `DIRECT:${event.guild_id}` })
             .add({ tag: 'AT_MESSAGE_CREATE' }).value);
     });
@@ -238,10 +382,17 @@ const register = (client) => {
         })
             .addMessage({ MessageId: event.id })
             .addText({ MessageText: msg?.trim() })
+            .addMedia({ MessageMedia: getMediaItems(event.attachments) })
             .addOpen({ OpenId: `DIRECT:${event.guild_id}` })
             .add({ tag: 'MESSAGE_CREATE' }).value);
     });
-    client.on('INTERACTION_CREATE', event => {
+    client.on('INTERACTION_CREATE', async (event) => {
+        try {
+            await client.interactionResponse('group', event.id, 0);
+        }
+        catch (err) {
+            createResult(ResultCode.Fail, 'interactionResponse failed', err?.response?.data ?? err?.message ?? err);
+        }
         if (event.scene === 'group') {
             const UserAvatar = createUserAvatarURL(event.group_member_openid);
             const UserId = event.group_member_openid;
@@ -258,8 +409,13 @@ const register = (client) => {
                 IsMaster: isMaster,
                 IsBot: false
             })
-                .addMessage({ MessageId: `INTERACTION_CREATE:${event.id}` })
+                .addMessage({ MessageId: event.id })
                 .addText({ MessageText: MessageText })
+                .addInteraction({
+                InteractionId: event.id,
+                InteractionData: JSON.stringify(event.data.resolved),
+                Target: { scope: 'group', targetId: event.group_openid, BotId: botId }
+            })
                 .addOpen({ OpenId: `C2C:${event.group_member_openid}` })
                 .add({ tag: 'INTERACTION_CREATE_GROUP' }).value;
             cbp.send(e);
@@ -280,6 +436,11 @@ const register = (client) => {
             })
                 .addMessage({ MessageId: event.id })
                 .addText({ MessageText: MessageText })
+                .addInteraction({
+                InteractionId: event.id,
+                InteractionData: JSON.stringify(event.data.resolved),
+                Target: { scope: 'c2c', targetId: event.user_openid, BotId: botId }
+            })
                 .addOpen({ OpenId: `C2C:${event.user_openid}` })
                 .add({ tag: 'INTERACTION_CREATE_C2C' }).value;
             cbp.send(e);
@@ -296,6 +457,11 @@ const register = (client) => {
                 .addUser({ UserId: event.data.resolved.user_id, UserKey, UserAvatar: UserAvatar, IsMaster: isMaster, IsBot: false })
                 .addMessage({ MessageId: event.data.resolved.message_id })
                 .addText({ MessageText: MessageText })
+                .addInteraction({
+                InteractionId: event.id,
+                InteractionData: JSON.stringify(event.data.resolved),
+                Target: { scope: 'channel', targetId: event.channel_id, BotId: botId }
+            })
                 .addOpen({ OpenId: `DIRECT:${event.guild_id}` })
                 .add({ tag: 'INTERACTION_CREATE_GUILD' }).value;
             cbp.send(e);
@@ -483,6 +649,24 @@ const register = (client) => {
     const api = {
         active: {
             send: {
+                target: async (target, val, replyId) => {
+                    if (!validateTargetBot(target)) {
+                        return [createResult(ResultCode.FailParams, `BotId ${target.BotId} is not active`, null)];
+                    }
+                    if (target.scope === 'group') {
+                        return GROUP_AT_MESSAGE_CREATE(client, { ChannelId: target.targetId, MessageId: replyId }, val);
+                    }
+                    if (target.scope === 'c2c') {
+                        return C2C_MESSAGE_CREATE(client, { UserId: target.targetId, MessageId: replyId }, val);
+                    }
+                    if (target.scope === 'channel') {
+                        return AT_MESSAGE_CREATE(client, { ChannelId: target.targetId, MessageId: replyId }, val);
+                    }
+                    if (target.scope === 'direct') {
+                        return DIRECT_MESSAGE_CREATE(client, { UserId: target.targetId, MessageId: replyId }, val);
+                    }
+                    return [createResult(ResultCode.FailParams, `Unsupported target scope: ${target.scope}`, null)];
+                },
                 channel: async (SpaceId, val) => {
                     if (/^GUILD:/.test(SpaceId)) {
                         const id = SpaceId.replace('GUILD:', '');
@@ -522,19 +706,19 @@ const register = (client) => {
             }
         },
         use: {
-            send: async (event, val) => {
+            send: async (event, val, options) => {
                 if (!val || val.length <= 0) {
                     return [];
                 }
                 const tag = event._tag;
                 if (tag === 'GROUP_AT_MESSAGE_CREATE') {
-                    return await GROUP_AT_MESSAGE_CREATE(client, event, val);
+                    return await GROUP_AT_MESSAGE_CREATE(client, event, val, options);
                 }
                 if (tag === 'GROUP_MESSAGE_CREATE') {
-                    return await GROUP_AT_MESSAGE_CREATE(client, event, val);
+                    return await GROUP_AT_MESSAGE_CREATE(client, event, val, options);
                 }
                 if (tag === 'C2C_MESSAGE_CREATE') {
-                    return await C2C_MESSAGE_CREATE(client, event, val);
+                    return await C2C_MESSAGE_CREATE(client, event, val, options);
                 }
                 if (tag === 'DIRECT_MESSAGE_CREATE') {
                     return await DIRECT_MESSAGE_CREATE(client, event, val);
@@ -546,10 +730,10 @@ const register = (client) => {
                     return await MESSAGE_CREATE(client, event, val);
                 }
                 if (tag === 'INTERACTION_CREATE_GROUP') {
-                    return await GROUP_AT_MESSAGE_CREATE(client, event, val);
+                    return await GROUP_AT_MESSAGE_CREATE(client, event, val, options);
                 }
                 if (tag === 'INTERACTION_CREATE_C2C') {
-                    return await C2C_MESSAGE_CREATE(client, event, val);
+                    return await C2C_MESSAGE_CREATE(client, event, val, options);
                 }
                 if (tag === 'INTERACTION_CREATE_GUILD') {
                     return await AT_MESSAGE_CREATE(client, event, val);
@@ -581,6 +765,12 @@ const register = (client) => {
         }
     };
     const onactions = async (data, consume) => {
+        const event = data.payload.event ?? {};
+        const getGroupOpenId = () => data.payload.ChannelId ?? data.payload.params?.groupOpenId ?? data.payload.GuildId ?? event.ChannelId ?? event.GuildId ?? '';
+        const getMemberOpenId = () => data.payload.params?.memberOpenId ?? data.payload.UserId ?? event.UserId ?? '';
+        const getGuildId = () => data.payload.GuildId ?? event.GuildId ?? '';
+        const getUserId = () => data.payload.UserId ?? event.UserId ?? '';
+        const getChannelId = () => data.payload.ChannelId ?? event.ChannelId ?? '';
         try {
             if (data.action === 'me.info') {
                 const res = await client.usersMe();
@@ -599,7 +789,8 @@ const register = (client) => {
             else if (data.action === 'message.send') {
                 const event = data.payload.event;
                 const paramFormat = data.payload.params.format;
-                const res = await api.use.send(event, paramFormat);
+                const options = data.payload.params?.forceVerifyImageResource !== undefined ? { forceVerifyImageResource: data.payload.params.forceVerifyImageResource } : undefined;
+                const res = await api.use.send(event, paramFormat, options);
                 consume(res);
             }
             else if (data.action === 'mention.get') {
@@ -619,53 +810,96 @@ const register = (client) => {
                 const res = await api.active.send.user(userId, paramFormat);
                 consume(res);
             }
+            else if (data.action === 'message.send.target') {
+                const target = normalizeTarget(data.payload.target);
+                if (!target) {
+                    consume([createResult(ResultCode.FailParams, 'message.send.target 缺少 target', null)]);
+                    return;
+                }
+                const res = await api.active.send.target(target, data.payload.params?.format || [], data.payload.params?.replyId);
+                consume(res);
+            }
             else if (data.action === 'message.delete') {
-                const channelId = data.payload.ChannelId;
                 const messageId = data.payload.MessageId;
+                const params = data.payload.params ?? {};
+                const target = normalizeTarget(data.payload.target);
+                if (target && !validateTargetBot(target)) {
+                    consume([createResult(ResultCode.FailParams, `BotId ${target.BotId} is not active`, null)]);
+                    return;
+                }
+                const scope = target?.scope ?? params.scope ?? params.messageType;
+                const request = scope === 'group'
+                    ? client.grouMessageDelte(String(target?.targetId ?? params.groupId ?? data.payload.GroupId ?? data.payload.ChannelId), messageId)
+                    : scope === 'user' || scope === 'c2c'
+                        ? client.userMessageDelete(String(target?.targetId ?? params.userId ?? data.payload.UserId), messageId)
+                        : scope === 'direct'
+                            ? client.dmsMessageDelete(String(target?.targetId ?? params.guildId ?? data.payload.GuildId ?? data.payload.ChannelId), messageId)
+                            : client.channelsMessagesDelete(target?.targetId ?? data.payload.ChannelId, messageId);
+                const res = await request.then(r => createResult(ResultCode.Ok, data.action, r)).catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'interaction.ack') {
+                const params = data.payload.params ?? {};
+                const interactionId = String(params.interactionId ?? data.payload.InteractionId ?? '');
+                const mode = data.payload.target?.scope === 'channel' || data.payload.target?.scope === 'direct' || params.mode === 'guild' ? 'guild' : 'group';
+                if (!interactionId) {
+                    consume([createResult(ResultCode.Fail, 'interaction.ack 缺少 InteractionId', null)]);
+                    return;
+                }
                 const res = await client
-                    .channelsMessagesDelete(channelId, messageId)
+                    .interactionResponse(mode, interactionId, params.code)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
+                consume([res]);
             }
             else if (data.action === 'message.pin') {
                 const res = await client
-                    .channelsPinsPut(data.payload.ChannelId, data.payload.MessageId)
+                    .channelsPinsPut(getChannelId(), data.payload.MessageId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'message.unpin') {
                 const res = await client
-                    .channelsPinsDelete(data.payload.ChannelId, data.payload.MessageId)
+                    .channelsPinsDelete(getChannelId(), data.payload.MessageId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'reaction.add') {
                 const res = await client
-                    .channelsMessagesReactionsPut(data.payload.ChannelId, data.payload.MessageId, 1, data.payload.EmojiId)
+                    .channelsMessagesReactionsPut(getChannelId(), data.payload.MessageId, 1, data.payload.EmojiId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'reaction.remove') {
                 const res = await client
-                    .channelsMessagesReactionsDelete(data.payload.ChannelId, data.payload.MessageId, 1, data.payload.EmojiId)
+                    .channelsMessagesReactionsDelete(getChannelId(), data.payload.MessageId, 1, data.payload.EmojiId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'message.get') {
                 const res = await client
-                    .channelsMessagesById(data.payload.ChannelId, data.payload.MessageId)
+                    .channelsMessagesById(getChannelId(), data.payload.MessageId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
+            else if (data.action === 'interaction.response') {
+                const interactionId = data.payload.interaction_id;
+                const code = data.payload.code ?? 0;
+                const res = await client
+                    .interactionResponse('group', interactionId, code)
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
+            }
             else if (data.action === 'member.info') {
-                const guildId = data.payload.params?.guildId ?? data.payload.GuildId;
-                const userId = data.payload.params?.userId ?? data.payload.UserId;
+                const guildId = data.payload.params?.guildId ?? getGuildId();
+                const userId = data.payload.params?.userId ?? getUserId();
                 const res = await client
                     .guildsMembersMessage(guildId, userId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
@@ -673,7 +907,7 @@ const register = (client) => {
                 consume([res]);
             }
             else if (data.action === 'member.list') {
-                const guildId = data.payload.GuildId;
+                const guildId = getGuildId();
                 const after = data.payload.params?.After ?? '0';
                 const limit = data.payload.params?.Limit ?? 100;
                 const res = await client
@@ -684,14 +918,14 @@ const register = (client) => {
             }
             else if (data.action === 'member.kick') {
                 const res = await client
-                    .guildsMembersDelete(data.payload.GuildId, data.payload.UserId)
+                    .guildsMembersDelete(getGuildId(), getUserId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'member.ban') {
-                const guildId = data.payload.GuildId;
-                const userId = data.payload.UserId;
+                const guildId = getGuildId();
+                const userId = getUserId();
                 const duration = data.payload.params?.duration ?? 0;
                 const mute_seconds = String(duration > 0 ? duration : 604800);
                 const res = await client
@@ -702,14 +936,14 @@ const register = (client) => {
             }
             else if (data.action === 'member.unban') {
                 const res = await client
-                    .guildsMemberMute(data.payload.GuildId, data.payload.UserId, { mute_seconds: '0' })
+                    .guildsMemberMute(getGuildId(), getUserId(), { mute_seconds: '0' })
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'member.mute') {
-                const guildId = data.payload.GuildId;
-                const userId = data.payload.UserId;
+                const guildId = getGuildId();
+                const userId = getUserId();
                 const duration = data.payload.params?.duration ?? 0;
                 const mute_seconds = String(duration);
                 const res = await client
@@ -720,7 +954,7 @@ const register = (client) => {
             }
             else if (data.action === 'guild.info') {
                 const res = await client
-                    .guilds(data.payload.GuildId)
+                    .guilds(getGuildId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
@@ -733,7 +967,7 @@ const register = (client) => {
                 consume([res]);
             }
             else if (data.action === 'guild.mute') {
-                const guildId = data.payload.GuildId;
+                const guildId = getGuildId();
                 const duration = data.payload.params?.duration ?? 0;
                 const mute_seconds = String(duration);
                 const res = await client
@@ -742,22 +976,135 @@ const register = (client) => {
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
+            else if (data.action === 'group.info') {
+                const res = await client
+                    .groupsInfo(getGroupOpenId())
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.botState') {
+                const res = await client
+                    .groupsBotState(getGroupOpenId())
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.member.info') {
+                const res = await client
+                    .groupsMembersMessage(getGroupOpenId(), getMemberOpenId())
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.joinRequest.list') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsJoinRequestList(getGroupOpenId(), { cursor: params.cursor, limit: params.limit })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.joinRequest.approve') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsApprovalJoinRequest(getGroupOpenId(), getMemberOpenId(), {
+                    op: params.op,
+                    join_request_id: params.joinRequestId,
+                    reject_reason: params.rejectReason,
+                    add_to_member_blacklist: params.addToMemberBlacklist
+                })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.mute.setting') {
+                const res = await client
+                    .groupsRestrictChatSetting(getGroupOpenId())
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.mute.set') {
+                const res = await client
+                    .groupsRestrictChatSettingPost(getGroupOpenId(), { members: data.payload.params?.members })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.list') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsJoinApprovalStrategies({ cursor: params.cursor, limit: params.limit })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.create') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsJoinApprovalStrategyCreate({
+                    group_openids: params.groupOpenIds,
+                    group_ids: params.groupIds,
+                    is_enable: params.isEnable,
+                    expire_at: params.expireAt,
+                    remark: params.remark
+                })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.update') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsJoinApprovalStrategyPatch(data.payload.StrategyId, {
+                    is_enable: params.isEnable,
+                    expire_at: params.expireAt,
+                    group_action: params.groupAction,
+                    remark: params.remark
+                })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.delete') {
+                const res = await client
+                    .groupsJoinApprovalStrategyDelete(data.payload.StrategyId)
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.execute') {
+                const res = await client
+                    .groupsJoinApprovalStrategyExecute(data.payload.StrategyId)
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'group.strategy.whitelist') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .groupsJoinApprovalStrategyWhitelistUsers(data.payload.StrategyId, { op: params.op, whitelist_users: params.whitelistUsers })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
             else if (data.action === 'channel.info') {
                 const res = await client
-                    .channels(data.payload.ChannelId)
+                    .channels(getChannelId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'channel.list') {
                 const res = await client
-                    .guildsChannels(data.payload.GuildId)
+                    .guildsChannels(getGuildId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'channel.create') {
-                const guildId = data.payload.GuildId;
+                const guildId = getGuildId();
                 const params = data.payload.params;
                 const res = await client
                     .guildsChannelsCreate(guildId, { name: params.name, type: params.type ? Number(params.type) : 0, position: 0, parent_id: params.parentId ?? '' })
@@ -766,7 +1113,7 @@ const register = (client) => {
                 consume([res]);
             }
             else if (data.action === 'channel.update') {
-                const channelId = data.payload.ChannelId;
+                const channelId = getChannelId();
                 const params = data.payload.params;
                 const res = await client
                     .guildsChannelsUpdate(channelId, { name: params.name ?? '', position: params.position ?? 0 })
@@ -776,14 +1123,14 @@ const register = (client) => {
             }
             else if (data.action === 'channel.delete') {
                 const res = await client
-                    .guildsChannelsdelete(data.payload.ChannelId, {})
+                    .guildsChannelsdelete(getChannelId(), {})
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'role.list') {
                 const res = await client
-                    .guildsRoles(data.payload.GuildId)
+                    .guildsRoles(getGuildId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
@@ -791,7 +1138,7 @@ const register = (client) => {
             else if (data.action === 'role.create') {
                 const params = data.payload.params;
                 const res = await client
-                    .guildsRolesPost(data.payload.GuildId, { name: params.name, color: params.color })
+                    .guildsRolesPost(getGuildId(), { name: params.name, color: params.color })
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
@@ -799,35 +1146,35 @@ const register = (client) => {
             else if (data.action === 'role.update') {
                 const params = data.payload.params;
                 const res = await client
-                    .guildsRolesPatch(data.payload.GuildId, data.payload.RoleId, { name: params.name, color: params.color })
+                    .guildsRolesPatch(getGuildId(), data.payload.RoleId, { name: params.name, color: params.color })
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'role.delete') {
                 const res = await client
-                    .guildsRolesDelete(data.payload.GuildId, data.payload.RoleId)
+                    .guildsRolesDelete(getGuildId(), data.payload.RoleId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'role.assign') {
                 const res = await client
-                    .guildsRolesMembersPut(data.payload.GuildId, '', data.payload.UserId, data.payload.RoleId)
+                    .guildsRolesMembersPut(getGuildId(), '', getUserId(), data.payload.RoleId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'role.remove') {
                 const res = await client
-                    .guildsRolesMembersDelete(data.payload.GuildId, '', data.payload.UserId, data.payload.RoleId)
+                    .guildsRolesMembersDelete(getGuildId(), '', getUserId(), data.payload.RoleId)
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'file.send.channel') {
                 const res = await client
-                    .postRichMediaByGroup(data.payload.ChannelId, {
+                    .postRichMediaByGroup(getGroupOpenId(), {
                     file_type: data.payload.params?.file_type ?? 1,
                     url: data.payload.params?.url,
                     file_data: data.payload.params?.file_data,
@@ -839,7 +1186,7 @@ const register = (client) => {
             }
             else if (data.action === 'file.send.user') {
                 const res = await client
-                    .postRichMediaByUser(data.payload.UserId, {
+                    .postRichMediaByUser(getUserId(), {
                     file_type: data.payload.params?.file_type ?? 1,
                     url: data.payload.params?.url,
                     file_data: data.payload.params?.file_data,
@@ -860,7 +1207,7 @@ const register = (client) => {
                 consume([createResult(ResultCode.Warn, 'media.send.channel not directly supported, use message.send with format', null)]);
             }
             else if (data.action === 'media.send.user') {
-                const userId = data.payload.UserId;
+                const userId = getUserId();
                 const params = data.payload.params;
                 const fileType = params?.type === 'image' ? 1 : params?.type === 'video' ? 2 : params?.type === 'audio' ? 3 : 4;
                 const res = await client
@@ -870,11 +1217,116 @@ const register = (client) => {
                 consume([res]);
             }
             else if (data.action === 'media.upload') {
-                consume([createResult(ResultCode.Warn, 'media.upload not supported, use media.send.user or media.send.channel', null)]);
+                const target = normalizeTarget(data.payload.target);
+                if (!target) {
+                    consume([createResult(ResultCode.Warn, 'QQ media.upload requires target', null)]);
+                    return;
+                }
+                const res = await uploadMedia(target, data.payload.params || {})
+                    .then(value => createResult(ResultCode.Ok, data.action, value))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err));
+                consume([res]);
+            }
+            else if (data.action === 'media.send') {
+                const target = normalizeTarget(data.payload.target);
+                if (!target) {
+                    consume([createResult(ResultCode.FailParams, 'media.send 缺少 target', null)]);
+                    return;
+                }
+                if (!validateTargetBot(target)) {
+                    consume([createResult(ResultCode.FailParams, `BotId ${target.BotId} is not active`, null)]);
+                    return;
+                }
+                const params = data.payload.params || {};
+                if (params.fileId) {
+                    const send = target.scope === 'group'
+                        ? client.groupOpenMessages(target.targetId, { msg_type: 7, content: params.content || '', media: { file_info: params.fileId } })
+                        : target.scope === 'c2c'
+                            ? client.usersOpenMessages(target.targetId, { msg_type: 7, content: params.content || '', media: { file_info: params.fileId } })
+                            : null;
+                    if (!send) {
+                        consume([createResult(ResultCode.Warn, 'QQ media.send only supports group and c2c targets', null)]);
+                        return;
+                    }
+                    const res = await send
+                        .then(value => createResult(ResultCode.Ok, data.action, { id: value.id }))
+                        .catch(err => createResult(ResultCode.Fail, data.action, err));
+                    consume([res]);
+                    return;
+                }
+                const upload = await uploadMedia(target, params)
+                    .then(value => value.fileId)
+                    .catch(error => {
+                    consume([createResult(ResultCode.Fail, data.action, error)]);
+                    return null;
+                });
+                if (!upload) {
+                    return;
+                }
+                await onactions({ action: 'media.send', payload: { target, params: { ...params, fileId: upload, url: undefined, data: undefined, filePath: undefined } } }, consume);
+            }
+            else if (data.action === 'connection.status') {
+                const status = client.getConnectionStatus();
+                consume([
+                    createResult(ResultCode.Ok, data.action, {
+                        Platform: platform,
+                        state: status.state,
+                        bots: [{ BotId: botId, ...status }]
+                    })
+                ]);
+            }
+            else if (data.action === 'media.upload.prepare') {
+                const userId = getUserId();
+                const groupId = getGroupOpenId();
+                const res = await (userId ? client.usersUploadPrepare(userId, data.payload.params) : client.groupUploadPrepare(groupId, data.payload.params))
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
+            }
+            else if (data.action === 'media.upload.part.finish') {
+                const userId = getUserId();
+                const groupId = getGroupOpenId();
+                const res = await (userId ? client.usersUploadPartFinish(userId, data.payload.params) : client.groupUploadPartFinish(groupId, data.payload.params))
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
+            }
+            else if (data.action === 'media.upload.chunked') {
+                const userId = getUserId();
+                const groupId = getGroupOpenId();
+                const params = data.payload.params ?? {};
+                const res = await chunkedUpload(client, userId ? 'user' : 'group', userId || groupId, params.file ?? params.file_path, {
+                    file_type: params.file_type ?? 1,
+                    file_name: params.file_name,
+                    srv_send_msg: params.srv_send_msg
+                })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
+            }
+            else if (data.action === 'stream.message.send') {
+                const res = await client
+                    .streamMessages(getUserId(), data.payload.params ?? {})
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
+            }
+            else if (data.action === 'message.input.notify') {
+                const params = data.payload.params ?? {};
+                const res = await client
+                    .usersOpenMessages(getUserId(), {
+                    msg_type: 6,
+                    input_notify: { input_type: params.input_type ?? 1, input_second: params.input_second ?? 60 },
+                    msg_seq: params.msg_seq,
+                    msg_id: params.msg_id
+                })
+                    .then(r => createResult(ResultCode.Ok, data.action, r))
+                    .catch(err => createResult(ResultCode.Fail, data.action, err?.response?.data ?? err?.message ?? err));
+                consume([res]);
             }
             else if (data.action === 'permission.get') {
                 const res = await client
-                    .channelsPermissions(data.payload.ChannelId, data.payload.UserId)
+                    .channelsPermissions(getChannelId(), getUserId())
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
@@ -882,20 +1334,20 @@ const register = (client) => {
             else if (data.action === 'permission.set') {
                 const params = data.payload.params;
                 const res = await client
-                    .channelsPermissionsPut(data.payload.ChannelId, data.payload.UserId, params?.allow ?? '0', params?.deny ?? '0')
+                    .channelsPermissionsPut(getChannelId(), getUserId(), params?.allow ?? '0', params?.deny ?? '0')
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'reaction.list') {
                 const res = await client
-                    .channelsMessagesReactionsUsers(data.payload.ChannelId, data.payload.MessageId, 1, data.payload.EmojiId, { limit: data.payload.params?.limit ?? 20 })
+                    .channelsMessagesReactionsUsers(getChannelId(), data.payload.MessageId, 1, data.payload.EmojiId, { limit: data.payload.params?.limit ?? 20 })
                     .then(r => createResult(ResultCode.Ok, data.action, r))
                     .catch(err => createResult(ResultCode.Fail, data.action, err));
                 consume([res]);
             }
             else if (data.action === 'channel.announce') {
-                const guildId = data.payload.GuildId;
+                const guildId = getGuildId();
                 const params = data.payload.params;
                 if (params?.remove) {
                     const res = await client
@@ -920,7 +1372,6 @@ const register = (client) => {
             consume([createResult(ResultCode.Fail, '请求失败', error)]);
         }
     };
-    cbp.onactions((data, consume) => void onactions(data, consume));
     const onapis = async (data, consume) => {
         const key = data.payload?.key;
         const params = data.payload?.params;
@@ -947,7 +1398,11 @@ const register = (client) => {
             consume([createResult(ResultCode.Fail, '请求失败', error)]);
         }
     };
-    cbp.onapis((data, consume) => void onapis(data, consume));
+    if (options?.bindActions !== false) {
+        cbp.onactions((data, consume) => void onactions(data, consume));
+        cbp.onapis((data, consume) => void onapis(data, consume));
+    }
+    return { onAction: onactions, onApi: onapis };
 };
 
 export { register };