@zhin.js/adapter-icqq 1.0.61 → 1.0.63

package/lib/index.js

@@ -1,898 +1,15 @@
-import { Client, } from "@icqqjs/icqq";
+/**
+ * ICQQ 适配器入口：类型扩展、导出、注册
+ */
 import path from "path";
-import { usePlugin, Adapter, Message, segment, MessageCommand, Notice, Request, createGroupManagementTools, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, } from "zhin.js";
+import { usePlugin } from "zhin.js";
+import { MessageCommand } from "zhin.js";
+import { IcqqAdapter } from "./adapter.js";
+export * from "./types.js";
+export { IcqqBot } from "./bot.js";
+export { IcqqAdapter } from "./adapter.js";
 const plugin = usePlugin();
-const { useContext, addCommand } = plugin;
-export class IcqqBot extends Client {
-    adapter;
-    $connected = false;
-    get $id() {
-        return this.$config.name;
-    }
-    constructor(adapter, config) {
-        if (!config.scope)
-            config.scope = "icqqjs";
-        if (!config.data_dir)
-            config.data_dir = path.join(process.cwd(), "data");
-        if (config.scope.startsWith("@"))
-            config.scope = config.scope.slice(1);
-        super(config);
-        this.adapter = adapter;
-        this.$config = config;
-    }
-    handleIcqqMessage(msg) {
-        const message = this.$formatMessage(msg);
-        this.adapter.emit("message.receive", message);
-        plugin.logger.debug(`${this.$config.name} recv  ${message.$channel.type}(${message.$channel.id}):${segment.raw(message.$content)}`);
-    }
-    async $connect() {
-        this.on("message", this.handleIcqqMessage.bind(this));
-        // 监听通知事件
-        this.on("notice.group.increase", (e) => this.handleGroupNotice(e, 'group_member_increase', 'increase'));
-        this.on("notice.group.decrease", (e) => this.handleGroupNotice(e, 'group_member_decrease', 'decrease'));
-        this.on("notice.group.recall", (e) => this.handleGroupNotice(e, 'group_recall', 'recall'));
-        this.on("notice.group.admin", (e) => this.handleGroupNotice(e, 'group_admin_change', 'admin'));
-        this.on("notice.group.ban", (e) => this.handleGroupNotice(e, 'group_ban', 'ban'));
-        this.on("notice.group.transfer", (e) => this.handleGroupNotice(e, 'group_transfer', 'transfer'));
-        this.on("notice.group.poke", (e) => this.handleGroupNotice(e, 'group_poke', 'poke'));
-        this.on("notice.friend.increase", (e) => this.handleFriendNotice(e, 'friend_add', 'increase'));
-        this.on("notice.friend.recall", (e) => this.handleFriendNotice(e, 'friend_recall', 'recall'));
-        this.on("notice.friend.poke", (e) => this.handleFriendNotice(e, 'friend_poke', 'poke'));
-        // 监听请求事件
-        this.on("request.friend.add", (e) => this.handleFriendRequest(e));
-        this.on("request.group.add", (e) => this.handleGroupRequest(e, 'group_add'));
-        this.on("request.group.invite", (e) => this.handleGroupRequest(e, 'group_invite'));
-        this.on("system.login.device", async (e) => {
-            await this.sendSmsCode();
-            plugin.logger.info("请输入短信验证码:");
-            process.stdin.once("data", (data) => {
-                this.submitSmsCode(data.toString().trim());
-            });
-        });
-        this.on("system.login.qrcode", (e) => {
-            plugin.logger.info(`取码地址：${e.image}\n请扫码完成后回车继续:`);
-            process.stdin.once("data", () => {
-                this.login();
-            });
-        });
-        this.on("system.login.slider", (e) => {
-            plugin.logger.info(`取码地址：${e.url}\n请输入滑块验证ticket:`);
-            process.stdin.once("data", (e) => {
-                this.submitSlider(e.toString().trim());
-            });
-        });
-        return new Promise((resolve) => {
-            this.once("system.online", () => {
-                this.$connected = true;
-                resolve();
-            });
-            this.login(Number(this.$config.name), this.$config.password);
-        });
-    }
-    async $disconnect() {
-        await this.logout();
-        this.$connected = false;
-    }
-    $formatMessage(msg) {
-        // 获取发送者的权限信息
-        const senderInfo = this.getSenderInfo(msg);
-        const result = Message.from(msg, {
-            $id: msg.message_id.toString(),
-            $adapter: "icqq",
-            $bot: `${this.$config.name}`,
-            $sender: senderInfo,
-            $channel: {
-                id: msg.message_type === "group"
-                    ? msg.group_id.toString()
-                    : msg.from_id.toString(),
-                type: msg.message_type,
-            },
-            $content: IcqqBot.toSegments(msg.message),
-            $raw: msg.raw_message,
-            $timestamp: msg.time,
-            $recall: async () => {
-                await this.$recallMessage(result.$id);
-            },
-            $reply: async (content, quote) => {
-                if (!Array.isArray(content))
-                    content = [content];
-                if (quote)
-                    content.unshift({
-                        type: "reply",
-                        data: { id: typeof quote === "boolean" ? result.$id : quote },
-                    });
-                return await this.adapter.sendMessage({
-                    ...result.$channel,
-                    context: "icqq",
-                    bot: `${this.uin}`,
-                    content,
-                });
-            },
-        });
-        return result;
-    }
-    /**
-     * 获取发送者的详细权限信息
-     */
-    getSenderInfo(msg) {
-        const senderInfo = {
-            id: msg.sender.user_id.toString(),
-            name: msg.sender.nickname.toString(),
-        };
-        // 群消息才有权限信息
-        if (msg.message_type === "group") {
-            const groupMsg = msg;
-            const sender = groupMsg.sender;
-            if (sender.role) {
-                senderInfo.role = sender.role;
-                senderInfo.isOwner = sender.role === "owner";
-                senderInfo.isAdmin = sender.role === "admin" || sender.role === "owner";
-                // 设置 permissions 数组，供 inferSenderPermissions 使用
-                const perms = [];
-                if (sender.role === "owner")
-                    perms.push("owner", "admin");
-                else if (sender.role === "admin")
-                    perms.push("admin");
-                senderInfo.permissions = perms;
-            }
-            if (sender.card) {
-                senderInfo.card = sender.card;
-            }
-            if (sender.title) {
-                senderInfo.title = sender.title;
-            }
-        }
-        return senderInfo;
-    }
-    // ==================== 通知/请求事件处理 ====================
-    handleGroupNotice(event, type, subType) {
-        const notice = Notice.from(event, {
-            $id: `${event.time || Date.now()}_${type}_${event.group_id}`,
-            $adapter: 'icqq',
-            $bot: this.$config.name,
-            $type: type,
-            $subType: subType,
-            $channel: { id: event.group_id?.toString() || '', type: 'group' },
-            $operator: event.operator_id ? { id: event.operator_id.toString(), name: event.operator_id.toString() } : undefined,
-            $target: event.user_id ? { id: event.user_id.toString(), name: event.user_id.toString() } : (event.target_id ? { id: event.target_id.toString(), name: event.target_id.toString() } : undefined),
-            $timestamp: event.time || Math.floor(Date.now() / 1000),
-        });
-        this.adapter.emit('notice.receive', notice);
-    }
-    handleFriendNotice(event, type, subType) {
-        const notice = Notice.from(event, {
-            $id: `${event.time || Date.now()}_${type}_${event.user_id}`,
-            $adapter: 'icqq',
-            $bot: this.$config.name,
-            $type: type,
-            $subType: subType,
-            $channel: { id: event.user_id?.toString() || '', type: 'private' },
-            $operator: event.operator_id ? { id: event.operator_id.toString(), name: event.operator_id.toString() } : undefined,
-            $target: event.user_id ? { id: event.user_id.toString(), name: event.user_id.toString() } : undefined,
-            $timestamp: event.time || Math.floor(Date.now() / 1000),
-        });
-        this.adapter.emit('notice.receive', notice);
-    }
-    handleFriendRequest(event) {
-        const request = Request.from(event, {
-            $id: event.flag || `${event.time}_friend_add_${event.user_id}`,
-            $adapter: 'icqq',
-            $bot: this.$config.name,
-            $type: 'friend_add',
-            $subType: event.sub_type,
-            $channel: { id: event.user_id.toString(), type: 'private' },
-            $sender: { id: event.user_id.toString(), name: event.nickname || event.user_id.toString() },
-            $comment: event.comment,
-            $timestamp: event.time || Math.floor(Date.now() / 1000),
-            $approve: async () => { await event.approve(true); },
-            $reject: async () => { await event.approve(false); },
-        });
-        this.adapter.emit('request.receive', request);
-    }
-    handleGroupRequest(event, type) {
-        const request = Request.from(event, {
-            $id: event.flag || `${event.time}_${type}_${event.user_id}`,
-            $adapter: 'icqq',
-            $bot: this.$config.name,
-            $type: type,
-            $subType: event.sub_type,
-            $channel: { id: event.group_id.toString(), type: 'group' },
-            $sender: { id: event.user_id.toString(), name: event.nickname || event.user_id.toString() },
-            $comment: 'comment' in event ? event.comment : undefined,
-            $timestamp: event.time || Math.floor(Date.now() / 1000),
-            $approve: async () => { await event.approve(true); },
-            $reject: async () => { await event.approve(false); },
-        });
-        this.adapter.emit('request.receive', request);
-    }
-    // ==================== 群管理 API ====================
-    /**
-     * 踢出群成员
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     * @param block 是否拉黑（加入黑名单）
-     */
-    async kickMember(groupId, userId, block) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.kickMember(userId, undefined, block);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 踢出成员 ${userId} 从群 ${groupId}${block ? "（已拉黑）" : ""}`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 踢出成员失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 禁言群成员
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     * @param duration 禁言时长（秒），0 表示解除禁言
-     */
-    async muteMember(groupId, userId, duration = 600) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.muteMember(userId, duration);
-            plugin.logger.info(`ICQQ Bot ${this.$id} ${duration > 0
-                ? `禁言成员 ${userId} ${duration}秒`
-                : `解除成员 ${userId} 禁言`}（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 禁言操作失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 全员禁言
-     * @param groupId 群号
-     * @param enable 是否开启全员禁言
-     */
-    async muteAll(groupId, enable = true) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.muteAll(enable);
-            plugin.logger.info(`ICQQ Bot ${this.$id} ${enable ? "开启" : "关闭"}全员禁言（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 全员禁言操作失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 设置管理员
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     * @param enable 是否设为管理员
-     */
-    async setAdmin(groupId, userId, enable = true) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.setAdmin(userId, enable);
-            plugin.logger.info(`ICQQ Bot ${this.$id} ${enable ? "设置" : "取消"}管理员 ${userId}（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 设置管理员失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 设置群名片
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     * @param card 群名片
-     */
-    async setCard(groupId, userId, card) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.setCard(userId, card);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 设置成员 ${userId} 群名片为 "${card}"（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 设置群名片失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 设置群头衔
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     * @param title 头衔
-     * @param duration 持续时间（秒），-1 表示永久
-     */
-    async setTitle(groupId, userId, title, duration = -1) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.setTitle(userId, title, duration);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 设置成员 ${userId} 头衔为 "${title}"（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 设置头衔失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 设置群名
-     * @param groupId 群号
-     * @param name 群名
-     */
-    async setGroupName(groupId, name) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.setName(name);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 设置群名为 "${name}"（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 设置群名失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 发送群公告
-     * @param groupId 群号
-     * @param content 公告内容
-     */
-    async sendAnnounce(groupId, content) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.announce(content);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 发送群公告（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 发送群公告失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 戳一戳
-     * @param groupId 群号
-     * @param userId 用户QQ号
-     */
-    async pokeMember(groupId, userId) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.pokeMember(userId);
-            plugin.logger.info(`ICQQ Bot ${this.$id} 戳了戳 ${userId}（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 戳一戳失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 获取群成员列表
-     * @param groupId 群号
-     */
-    async getMemberList(groupId) {
-        try {
-            const group = this.pickGroup(groupId);
-            return await group.getMemberMap();
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 获取群成员列表失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 获取被禁言成员列表
-     * @param groupId 群号
-     */
-    async getMutedMembers(groupId) {
-        try {
-            const group = this.pickGroup(groupId);
-            return await group.getMuteMemberList();
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 获取禁言列表失败:`, error);
-            throw error;
-        }
-    }
-    /**
-     * 允许/禁止匿名
-     * @param groupId 群号
-     * @param enable 是否允许匿名
-     */
-    async setAnonymous(groupId, enable = true) {
-        try {
-            const group = this.pickGroup(groupId);
-            const result = await group.allowAnony(enable);
-            plugin.logger.info(`ICQQ Bot ${this.$id} ${enable ? "开启" : "关闭"}匿名（群 ${groupId}）`);
-            return result;
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 设置匿名失败:`, error);
-            throw error;
-        }
-    }
-    async getGroupFiles(groupId) {
-        try {
-            const group = this.pickGroup(groupId);
-            return await group.fs.ls();
-        }
-        catch (error) {
-            plugin.logger.error(`ICQQ Bot ${this.$id} 获取群文件列表失败:`, error);
-            throw error;
-        }
-    }
-    async $recallMessage(id) {
-        await this.deleteMsg(id);
-    }
-    async $sendMessage(options) {
-        switch (options.type) {
-            case "private": {
-                const result = await this.sendPrivateMsg(Number(options.id), IcqqBot.toSendable(options.content));
-                plugin.logger.debug(`${this.$config.name} send ${options.type}(${options.id}):${segment.raw(options.content)}`);
-                return result.message_id.toString();
-            }
-            case "group": {
-                const result = await this.sendGroupMsg(Number(options.id), IcqqBot.toSendable(options.content));
-                plugin.logger.debug(`${this.$config.name} send ${options.type}(${options.id}):${segment.raw(options.content)}`);
-                return result.message_id.toString();
-            }
-            default:
-                throw new Error(`unsupported channel type ${options.type}`);
-        }
-    }
-}
-(function (IcqqBot) {
-    const allowTypes = [
-        "text",
-        "face",
-        "image",
-        "record",
-        "audio",
-        "dice",
-        "rps",
-        "video",
-        "file",
-        "location",
-        "share",
-        "json",
-        "at",
-        "reply",
-        "long_msg",
-        "button",
-        "markdown",
-        "xml",
-    ];
-    function toSegments(message) {
-        if (!Array.isArray(message))
-            message = [message];
-        return message
-            .filter((item, index) => {
-            return (typeof item === "string" || item.type !== "long_msg" || index !== 0);
-        })
-            .map((item) => {
-            if (typeof item === "string")
-                return { type: "text", data: { text: item } };
-            const { type, ...data } = item;
-            return { type, data };
-        });
-    }
-    IcqqBot.toSegments = toSegments;
-    function toSendable(content) {
-        if (!Array.isArray(content))
-            content = [content];
-        return content.map((seg) => {
-            if (typeof seg === "string")
-                return { type: "text", text: seg };
-            let { type, data } = seg;
-            if (typeof type === "function")
-                type = type.name;
-            if (!allowTypes.includes(type))
-                return { type: "text", text: segment.toString(seg) };
-            return { type, ...data };
-        });
-    }
-    IcqqBot.toSendable = toSendable;
-})(IcqqBot || (IcqqBot = {}));
-class IcqqAdapter extends Adapter {
-    constructor(plugin) {
-        super(plugin, "icqq", []);
-    }
-    createBot(config) {
-        return new IcqqBot(this, config);
-    }
-    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
-    async kickMember(botId, sceneId, userId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.kickMember(Number(sceneId), Number(userId), false);
-    }
-    async muteMember(botId, sceneId, userId, duration = 600) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.muteMember(Number(sceneId), Number(userId), duration);
-    }
-    async muteAll(botId, sceneId, enable = true) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.muteAll(Number(sceneId), enable);
-    }
-    async setAdmin(botId, sceneId, userId, enable = true) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.setAdmin(Number(sceneId), Number(userId), enable);
-    }
-    async setMemberNickname(botId, sceneId, userId, nickname) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.setCard(Number(sceneId), Number(userId), nickname);
-    }
-    async setGroupName(botId, sceneId, name) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.setGroupName(Number(sceneId), name);
-    }
-    async listMembers(botId, sceneId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        const memberMap = await bot.getMemberList(Number(sceneId));
-        const members = Array.from(memberMap.values()).map((m) => ({
-            user_id: m.user_id,
-            nickname: m.nickname,
-            card: m.card,
-            role: m.role,
-            title: m.title,
-        }));
-        return { members, count: members.length };
-    }
-    // ── 生命周期 ───────────────────────────────────────────────────────
-    async start() {
-        this.registerIcqqPlatformTools();
-        const groupTools = createGroupManagementTools(this, this.name);
-        groupTools.forEach((t) => this.addTool(t));
-        this.declareSkill({
-            description: 'ICQQ（QQ 协议）群管理：踢人、禁言、设管理员、改名片、头衔、群公告等。只有昵称时请先调用 list_members 查 QQ 号再操作。',
-            keywords: GROUP_MANAGEMENT_SKILL_KEYWORDS,
-            tags: GROUP_MANAGEMENT_SKILL_TAGS,
-        });
-        await super.start();
-    }
-    /**
-     * 注册 ICQQ 平台特有工具（头衔、戳一戳、群公告等）
-     */
-    registerIcqqPlatformTools() {
-        const CTX_BOT = {
-            type: "string",
-            description: "执行操作的 Bot QQ号",
-            contextKey: "botId",
-        };
-        const CTX_GROUP = {
-            type: "number",
-            description: "目标群号",
-            contextKey: "sceneId",
-        };
-        // 设置头衔工具
-        this.addTool({
-            name: "icqq_set_title",
-            description: "设置 QQ 群成员的专属头衔（显示在群昵称旁边的标签）。只有群主才能操作。可设置持续时间或永久。如果只有昵称没有 QQ号，请先调用 list_members 查询。",
-            tags: ["群管理", "成员管理", "头衔"],
-            keywords: ["头衔", "专属头衔", "设置头衔", "给头衔", "加头衔", "称号"],
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    group_id: CTX_GROUP,
-                    user_id: {
-                        type: "number",
-                        description: "目标成员 QQ号",
-                    },
-                    title: {
-                        type: "string",
-                        description: "头衔文字内容",
-                    },
-                    duration: {
-                        type: "number",
-                        description: "持续时间（秒），-1 表示永久，默认永久",
-                    },
-                },
-                required: ["bot", "group_id", "user_id", "title"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "group_owner",
-            execute: async (args, context) => {
-                const { bot: botId, group_id, user_id, title, duration = -1 } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                this.checkPermission(context, "group_owner");
-                const success = await bot.setTitle(group_id, user_id, title, duration);
-                return {
-                    success,
-                    message: success
-                        ? `已将 ${user_id} 的头衔设为 "${title}"`
-                        : "设置失败",
-                };
-            },
-        });
-        // 发送群公告工具
-        this.addTool({
-            name: "icqq_announce",
-            description: "发送 QQ 群公告（需要管理员权限）",
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    group_id: CTX_GROUP,
-                    content: {
-                        type: "string",
-                        description: "公告内容",
-                    },
-                },
-                required: ["bot", "group_id", "content"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "group_admin",
-            execute: async (args, context) => {
-                const { bot: botId, group_id, content } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                this.checkPermission(context, "group_admin");
-                const success = await bot.sendAnnounce(group_id, content);
-                return { success, message: success ? "群公告已发送" : "发送失败" };
-            },
-        });
-        // 戳一戳工具
-        this.addTool({
-            name: "icqq_poke",
-            description: '在 QQ 群中对某个成员执行"戳一戳"互动操作（类似拍一拍）。任何人都可以使用。注意：每次请求只戳一次，不要重复调用此工具。如果只有昵称没有 QQ号，请先调用 list_members 查询。',
-            tags: ["互动", "趣味", "戳一戳"],
-            keywords: ["戳", "戳一戳", "拍一拍", "拍", "碰一碰", "poke"],
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    group_id: CTX_GROUP,
-                    user_id: {
-                        type: "number",
-                        description: "要戳的目标成员 QQ号",
-                    },
-                },
-                required: ["bot", "group_id", "user_id"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "user",
-            execute: async (args) => {
-                const { bot: botId, group_id, user_id } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                const success = await bot.pokeMember(group_id, user_id);
-                return {
-                    success,
-                    message: success ? `已戳了戳 ${user_id}` : "戳一戳失败",
-                };
-            },
-        });
-        // 获取被禁言列表工具
-        this.addTool({
-            name: "icqq_list_muted",
-            description: "查询 QQ 群中当前被禁言的成员列表，返回被禁言成员的 QQ号和剩余禁言时间。此工具仅用于查询，不会执行禁言操作。如需禁言或解除禁言，请使用 icqq_mute_member 工具。",
-            tags: ["群查询", "禁言查询", "列表"],
-            keywords: ["禁言列表", "被禁言", "谁被禁言", "查看禁言", "禁言名单"],
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    group_id: CTX_GROUP,
-                },
-                required: ["bot", "group_id"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "user",
-            execute: async (args) => {
-                const { bot: botId, group_id } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                const mutedList = await bot.getMutedMembers(group_id);
-                return {
-                    muted_members: mutedList.filter((m) => m !== null),
-                    count: mutedList.filter((m) => m !== null).length,
-                };
-            },
-        });
-        this.addTool({
-            name: "icqq_send_user_like",
-            description: "给用户点赞（竖大拇指）。每人每天最多点赞 20 次，超出无效。如果只有昵称没有 QQ号，请先调用 list_members 查询。",
-            tags: ["互动", "趣味", "点赞"],
-            keywords: ["点赞", "赞我", "赞一下", "大拇指"],
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    user_id: {
-                        type: "number",
-                        description: "要点赞的目标用户 QQ号（如果只有昵称，先用 list_members 查询获取）",
-                    },
-                    times: {
-                        type: "number",
-                        description: "点赞次数（1-20），默认 1 次，每人每天上限 20 次",
-                        default: 1,
-                    },
-                },
-                required: ["bot", "user_id"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group", "private"],
-            permissionLevel: "user",
-            execute: async (args) => {
-                const { bot: botId, user_id, times = 1 } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                const success = await bot.sendLike(user_id, Math.min(times, 20));
-                return {
-                    success,
-                    message: success ? `已发送用户点赞消息给 ${user_id}` : "发送失败",
-                };
-            },
-        });
-        // 设置匿名状态工具
-        this.addTool({
-            name: "icqq_set_anonymous",
-            description: "开启或关闭 QQ 群的匿名聊天功能。开启后群成员可以匿名发言。需要 Bot 拥有管理员权限。",
-            tags: ["群管理", "群设置", "匿名"],
-            keywords: ["匿名", "匿名聊天", "开启匿名", "关闭匿名", "允许匿名"],
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: CTX_BOT,
-                    group_id: CTX_GROUP,
-                    enable: {
-                        type: "boolean",
-                        description: "true=开启匿名聊天，false=关闭匿名聊天，默认 true",
-                    },
-                },
-                required: ["bot", "group_id"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "group_admin",
-            execute: async (args, context) => {
-                const { bot: botId, group_id, enable = true } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                this.checkPermission(context, "group_admin");
-                const success = await bot.setAnonymous(group_id, enable);
-                return {
-                    success,
-                    message: success
-                        ? enable
-                            ? "已开启匿名聊天"
-                            : "已关闭匿名聊天"
-                        : "操作失败",
-                };
-            },
-        });
-        // 群文件列表
-        this.addTool({
-            name: "icqq_group_files",
-            description: "获取 QQ 群的群文件列表",
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: { type: "string", description: "Bot 名称" },
-                    group_id: { type: "number", description: "群号" },
-                },
-                required: ["bot", "group_id"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group"],
-            permissionLevel: "user",
-            execute: async (args) => {
-                const { bot: botId, group_id } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                const files = await bot.getGroupFiles(group_id);
-                if (!files?.length)
-                    return { files: [], message: "群文件为空" };
-                return {
-                    files: files.slice(0, 30).map((f) => ({
-                        name: f.name,
-                        size: f.size,
-                        uploader: f.uploader_uin,
-                        upload_time: f.upload_time,
-                    })),
-                    count: files.length,
-                };
-            },
-        });
-        // 好友列表
-        this.addTool({
-            name: "icqq_friend_list",
-            description: "获取 QQ 好友列表",
-            parameters: {
-                type: "object",
-                properties: {
-                    bot: { type: "string", description: "Bot 名称" },
-                },
-                required: ["bot"],
-            },
-            platforms: ["icqq"],
-            scopes: ["group", "private"],
-            permissionLevel: "user",
-            execute: async (args) => {
-                const { bot: botId } = args;
-                const bot = this.bots.get(botId);
-                if (!bot)
-                    throw new Error(`Bot ${botId} 不存在`);
-                const fl = bot.fl;
-                const friends = Array.from(fl.values()).map((f) => ({
-                    user_id: f.user_id,
-                    nickname: f.nickname,
-                    remark: f.remark,
-                }));
-                return { friends: friends.slice(0, 50), count: fl.size };
-            },
-        });
-        plugin.logger.debug("已注册 ICQQ 平台群管理工具");
-    }
-    /**
-     * 检查执行上下文中的权限
-     * 双重验证：优先从 ToolContext 获取权限级别，其次从消息发送者信息获取
-     */
-    checkPermission(context, required) {
-        const permissionLevels = {
-            user: 0,
-            group_admin: 1,
-            group_owner: 2,
-            bot_admin: 3,
-            owner: 4,
-        };
-        const requiredLevel = permissionLevels[required] ?? 0;
-        if (requiredLevel === 0)
-            return; // user 级别无需检查
-        // 1. 优先从 ToolContext.senderPermissionLevel 获取（AI Agent 路径注入）
-        if (context?.senderPermissionLevel) {
-            const ctxLevel = permissionLevels[context.senderPermissionLevel] ?? 0;
-            if (ctxLevel < requiredLevel) {
-                throw new Error(`权限不足：需要 ${required} 权限，当前为 ${context.senderPermissionLevel}`);
-            }
-            return; // 检查通过
-        }
-        // 2. 从消息的 $sender 获取权限（命令行/中间件路径）
-        const sender = context?.message?.$sender;
-        if (!sender) {
-            // 无上下文且无发送者信息 → 拒绝高权限操作
-            throw new Error(`权限不足：无法验证身份，拒绝执行需要 ${required} 权限的操作`);
-        }
-        let senderLevel = "user";
-        if (sender.isOwner || sender.role === "owner") {
-            senderLevel = "group_owner";
-        }
-        else if (sender.isAdmin || sender.role === "admin") {
-            senderLevel = "group_admin";
-        }
-        if (permissionLevels[senderLevel] < requiredLevel) {
-            throw new Error(`权限不足：需要 ${required} 权限，当前为 ${senderLevel}`);
-        }
-    }
-}
-const { provide } = usePlugin();
+const { provide, useContext, addCommand } = plugin;
 provide({
     name: "icqq",
     description: "ICQQ Adapter",
@@ -921,25 +38,19 @@ useContext("icqq", (icqq) => {
             times += 20;
         if (send3Result)
             times += 10;
-        return `给你咱好啦，你已经获得了${times}个赞`;
+        return `给你赞好啦，你已经获得了${times}个赞`;
     }));
 });
 useContext("web", (web) => {
-    // 注册ICQQ适配器的客户端入口文件
     const dispose = web.addEntry(path.resolve(import.meta.dirname, "../client/index.tsx"));
     return dispose;
 });
-useContext("router", async (router) => {
-    const icqq = plugin.root.inject("icqq");
+useContext("router", 'icqq', async (router, icqq) => {
     router.get("/api/icqq/bots", async (ctx) => {
         try {
             const bots = Array.from(icqq.bots.values());
             if (bots.length === 0) {
-                ctx.body = {
-                    success: true,
-                    data: [],
-                    message: "暂无ICQQ机器人实例",
-                };
+                ctx.body = { success: true, data: [], message: "暂无ICQQ机器人实例" };
                 return;
             }
             const result = bots.map((bot) => {
@@ -956,8 +67,7 @@ useContext("router", async (router) => {
                         lastActivity: new Date().toISOString(),
                     };
                 }
-                catch (botError) {
-                    // 单个机器人数据获取失败时的处理
+                catch {
                     return {
                         name: bot.$config.name,
                         connected: false,
@@ -971,11 +81,7 @@ useContext("router", async (router) => {
                     };
                 }
             });
-            ctx.body = {
-                success: true,
-                data: result,
-                timestamp: new Date().toISOString(),
-            };
+            ctx.body = { success: true, data: result, timestamp: new Date().toISOString() };
         }
         catch (error) {
             ctx.status = 500;
@@ -983,9 +89,7 @@ useContext("router", async (router) => {
                 success: false,
                 error: "ICQQ_API_ERROR",
                 message: "获取机器人数据失败",
-                details: process.env.NODE_ENV === "development"
-                    ? error.message
-                    : undefined,
+                details: process.env.NODE_ENV === "development" ? error.message : undefined,
                 timestamp: new Date().toISOString(),
             };
         }