@zhin.js/adapter-qq 1.0.51 → 1.0.52

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zhin.js/adapter-qq
 
+## 1.0.52
+
+### Patch Changes
+
+- zhin.js@1.0.51
+- @zhin.js/logger@0.1.35
+
 ## 1.0.51
 
 ### Patch Changes

package/lib/adapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * QQ 官方适配器
+ */
+import { Adapter, Plugin } from "zhin.js";
+import { QQBot } from "./bot.js";
+import type { QQBotConfig, ReceiverMode } from "./types.js";
+export declare class QQAdapter extends Adapter<QQBot<ReceiverMode>> {
+    constructor(plugin: Plugin);
+    createBot(config: QQBotConfig<ReceiverMode>): QQBot<ReceiverMode>;
+    kickMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
+    muteMember(botId: string, sceneId: string, userId: string, duration?: number): Promise<boolean>;
+    muteAll(botId: string, sceneId: string, enable?: boolean): Promise<boolean>;
+    listMembers(botId: string, sceneId: string): Promise<any[]>;
+    getGroupInfo(botId: string, sceneId: string): Promise<any>;
+    start(): Promise<void>;
+    /**
+     * 注册 QQ 官方平台特有工具（频道列表等）
+     */
+    private registerQQPlatformTools;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,EACP,MAAM,EAKP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,SAAU,SAAQ,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC7C,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;IAM3D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM;IAMzE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAO;IAMrD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQ3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;CA2MhC"}

package/lib/adapter.js

@@ -0,0 +1,263 @@
+/**
+ * QQ 官方适配器
+ */
+import { Adapter, createGroupManagementTools, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, } from "zhin.js";
+import { QQBot } from "./bot.js";
+export class QQAdapter extends Adapter {
+    constructor(plugin) {
+        super(plugin, "qq", []);
+    }
+    createBot(config) {
+        return new QQBot(this, config);
+    }
+    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+    async kickMember(botId, sceneId, userId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.removeGuildMember(sceneId, userId, false);
+    }
+    async muteMember(botId, sceneId, userId, duration = 600) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.muteMembers(sceneId, [userId], duration);
+    }
+    async muteAll(botId, sceneId, enable = true) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.muteAll(sceneId, enable ? 600 : 0);
+    }
+    async listMembers(botId, sceneId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.getGuildMembers(sceneId);
+    }
+    async getGroupInfo(botId, sceneId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.getGuildInfo(sceneId);
+    }
+    // ── 生命周期 ───────────────────────────────────────────────────────
+    async start() {
+        this.registerQQPlatformTools();
+        const groupTools = createGroupManagementTools(this, this.name);
+        groupTools.forEach((t) => this.addTool(t));
+        this.declareSkill({
+            description: 'QQ 官方机器人群管理：踢人、禁言、设管理员、改群名、查成员等。仅有昵称时请先 list_members 查 user_id 再操作。',
+            keywords: GROUP_MANAGEMENT_SKILL_KEYWORDS,
+            tags: GROUP_MANAGEMENT_SKILL_TAGS,
+        });
+        await super.start();
+    }
+    /**
+     * 注册 QQ 官方平台特有工具（频道列表等）
+     */
+    registerQQPlatformTools() {
+        // 获取频道列表工具
+        this.addTool({
+            name: 'qq_list_guilds',
+            description: '获取 QQ 频道列表',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                },
+                required: ['bot'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const guilds = await bot.getGuilds();
+                return { guilds, count: guilds.length };
+            },
+        });
+        // 获取子频道列表工具
+        this.addTool({
+            name: 'qq_list_channels',
+            description: '获取 QQ 频道下的子频道列表',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                },
+                required: ['bot', 'guild_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, guild_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const channels = await bot.getChannels(guild_id);
+                return { channels, count: channels.length };
+            },
+        });
+        // 获取角色列表工具
+        this.addTool({
+            name: 'qq_list_roles',
+            description: '获取 QQ 频道角色列表',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                },
+                required: ['bot', 'guild_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, guild_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const roles = await bot.getGuildRoles(guild_id);
+                return { roles, count: roles.length };
+            },
+        });
+        // 创建角色工具
+        this.addTool({
+            name: 'qq_create_role',
+            description: '创建 QQ 频道角色',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                    name: { type: 'string', description: '角色名称' },
+                    color: { type: 'number', description: '颜色（RGB 十进制数值）' },
+                },
+                required: ['bot', 'guild_id', 'name'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, guild_id, name, color } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const role = await bot.createGuildRole(guild_id, name, color);
+                return { success: !!role, role, message: role ? `角色 "${name}" 创建成功` : '创建失败' };
+            },
+        });
+        // 添加角色工具
+        this.addTool({
+            name: 'qq_add_role',
+            description: '给成员添加 QQ 频道角色',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                    channel_id: { type: 'string', description: '子频道 ID' },
+                    user_id: { type: 'string', description: '用户 ID' },
+                    role_id: { type: 'string', description: '角色 ID' },
+                },
+                required: ['bot', 'guild_id', 'channel_id', 'user_id', 'role_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, guild_id, channel_id, user_id, role_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.addMemberRole(guild_id, channel_id, user_id, role_id);
+                return { success, message: success ? `已给成员添加角色` : '操作失败' };
+            },
+        });
+        // 移除角色工具
+        this.addTool({
+            name: 'qq_remove_role',
+            description: '移除成员的 QQ 频道角色',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                    channel_id: { type: 'string', description: '子频道 ID' },
+                    user_id: { type: 'string', description: '用户 ID' },
+                    role_id: { type: 'string', description: '角色 ID' },
+                },
+                required: ['bot', 'guild_id', 'channel_id', 'user_id', 'role_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, guild_id, channel_id, user_id, role_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.removeMemberRole(guild_id, channel_id, user_id, role_id);
+                return { success, message: success ? `已移除成员的角色` : '操作失败' };
+            },
+        });
+        // 子频道详情
+        this.addTool({
+            name: 'qq_channel_info',
+            description: '获取 QQ 频道中指定子频道的详细信息',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    channel_id: { type: 'string', description: '子频道 ID' },
+                },
+                required: ['bot', 'channel_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, channel_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const info = await bot.getChannelInfo(channel_id);
+                return info;
+            },
+        });
+        // 单成员详情
+        this.addTool({
+            name: 'qq_member_detail',
+            description: '获取 QQ 频道中指定成员的详细信息',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '频道 ID' },
+                    user_id: { type: 'string', description: '用户 ID' },
+                },
+                required: ['bot', 'guild_id', 'user_id'],
+            },
+            platforms: ['qq'],
+            scopes: ['channel'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, guild_id, user_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const member = await bot.getGuildMember(guild_id, user_id);
+                return member;
+            },
+        });
+        this.plugin.logger.debug('已注册 QQ 官方平台频道管理工具');
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/lib/bot.d.ts

@@ -0,0 +1,102 @@
+/**
+ * QQ 官方 Bot 实现
+ */
+import { Bot, PrivateMessageEvent, GroupMessageEvent } from "qq-official-bot";
+import { Bot as ZhinBot, Message, SendOptions } from "zhin.js";
+import type { QQBotConfig, ReceiverMode, ApplicationPlatform } from "./types.js";
+import type { QQAdapter } from "./adapter.js";
+export declare class QQBot<T extends ReceiverMode, M extends ApplicationPlatform = ApplicationPlatform> extends Bot implements ZhinBot<QQBotConfig<T, M>, PrivateMessageEvent | GroupMessageEvent> {
+    adapter: QQAdapter;
+    $connected: boolean;
+    $config: QQBotConfig<T, M>;
+    get pluginLogger(): import("zhin.js").Logger;
+    get $id(): string;
+    constructor(adapter: QQAdapter, config: QQBotConfig<T, M>);
+    private handleQQMessage;
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+    $formatMessage(msg: PrivateMessageEvent | GroupMessageEvent): Message<PrivateMessageEvent | GroupMessageEvent>;
+    $sendMessage(options: SendOptions): Promise<string>;
+    $recallMessage(id: string): Promise<void>;
+    /**
+     * 获取频道列表
+     */
+    getGuilds(): Promise<any[]>;
+    /**
+     * 获取频道详情
+     * @param guildId 频道 ID
+     */
+    getGuildInfo(guildId: string): Promise<any>;
+    /**
+     * 获取子频道列表
+     * @param guildId 频道 ID
+     */
+    getChannels(guildId: string): Promise<any[]>;
+    /**
+     * 获取子频道详情
+     * @param channelId 子频道 ID
+     */
+    getChannelInfo(channelId: string): Promise<any>;
+    /**
+     * 获取频道成员列表
+     * @param guildId 频道 ID
+     */
+    getGuildMembers(guildId: string): Promise<any[]>;
+    /**
+     * 获取频道成员详情
+     * @param guildId 频道 ID
+     * @param userId 用户 ID
+     */
+    getGuildMember(guildId: string, userId: string): Promise<any>;
+    /**
+     * 删除频道成员（踢出）
+     * @param guildId 频道 ID
+     * @param userId 用户 ID
+     * @param addBlacklist 是否加入黑名单
+     * @param deleteHistoryMsg 删除历史消息天数 (-1不删除，0全部删除，3/7/15/30)
+     */
+    removeGuildMember(guildId: string, userId: string, addBlacklist?: boolean, deleteHistoryMsg?: -1 | 0 | 3 | 7 | 15 | 30): Promise<boolean>;
+    /**
+     * 获取频道角色列表
+     * @param guildId 频道 ID
+     */
+    getGuildRoles(guildId: string): Promise<any[]>;
+    /**
+     * 创建频道角色
+     * @param guildId 频道 ID
+     * @param name 角色名
+     * @param color 颜色
+     * @param hoist 是否在成员列表中单独展示 (0 或 1)
+     */
+    createGuildRole(guildId: string, name: string, color?: number, hoist?: 0 | 1): Promise<any>;
+    /**
+     * 给成员添加角色
+     * @param guildId 频道 ID
+     * @param channelId 子频道 ID
+     * @param userId 用户 ID
+     * @param roleId 角色 ID
+     */
+    addMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+    /**
+     * 移除成员角色
+     * @param guildId 频道 ID
+     * @param channelId 子频道 ID
+     * @param userId 用户 ID
+     * @param roleId 角色 ID
+     */
+    removeMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+    /**
+     * 禁言成员（批量）
+     * @param guildId 频道 ID
+     * @param userIds 用户 ID 列表
+     * @param muteSeconds 禁言时长（秒），0 表示解除禁言
+     */
+    muteMembers(guildId: string, userIds: string[], muteSeconds: number): Promise<boolean>;
+    /**
+     * 全员禁言
+     * @param guildId 频道 ID
+     * @param muteSeconds 禁言时长（秒），0 表示解除禁言
+     */
+    muteAll(guildId: string, muteSeconds: number): Promise<boolean>;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"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"}