@zhin.js/adapter-icqq 1.1.14 → 1.1.16

package/agents/icqq/skills/icqq-conversation/tools/conversation_info/index.js

@@ -0,0 +1,61 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentConversation } from '../../../../conversation.js';
+export default defineAgentTool({
+    description: '读取当前 ICQQ 会话及机器人自己的群／频道身份；区分调用者权限、机器人平台权限和不支持的操作',
+    adapter: 'icqq',
+    requiresApproval: 'never',
+    inputSchema: z.object({}),
+    async execute(_input, context) {
+        const conversation = currentConversation(context);
+        const client = context.$client;
+        const roles = context.principal.roles;
+        const common = {
+            conversation,
+            requester: {
+                roles,
+                canRequestGroupModeration: roles.some(role => ['master', 'admin', 'trusted', 'owner'].includes(role)),
+                canRequestLeave: roles.includes('master'),
+            },
+            operations: {
+                quoteReply: conversation.kind !== 'channel',
+                forwardMessages: conversation.kind !== 'channel',
+                recallOwnMessage: conversation.kind !== 'channel',
+                recallMemberMessage: conversation.kind === 'group',
+                leaveGroup: conversation.kind === 'group',
+            },
+        };
+        if (conversation.kind === 'group') {
+            const id = Number(conversation.id);
+            const [group, self] = await Promise.all([
+                client.getGroupInfo(id, true),
+                client.getGroupMemberInfo(id, client.uin, true),
+            ]);
+            context.signal.throwIfAborted();
+            const role = group.owner_id === client.uin ? 'owner' : self.role;
+            return {
+                ...common,
+                group: { id: group.group_id, name: group.group_name, ownerId: group.owner_id, memberCount: group.member_count },
+                bot: { id: client.uin, role, canModerateMembers: role === 'owner' || role === 'admin', canLeave: role === 'admin' || role === 'member' },
+            };
+        }
+        if (conversation.kind === 'channel') {
+            const guildId = conversation.parent?.id;
+            const guild = guildId ? client.guilds.get(guildId) : undefined;
+            const channel = guild?.channels.get(conversation.id);
+            const members = guildId ? await client.getGuildMemberList(guildId) : [];
+            context.signal.throwIfAborted();
+            const self = members.find(member => member.tiny_id === client.tiny_id);
+            const role = self?.role === 4 ? 'owner' : self?.role === 2 ? 'admin'
+                : self?.role === 5 ? 'channel_admin' : self?.role === 1 ? 'member' : 'unknown';
+            return {
+                ...common,
+                guild: { id: guildId, name: guild?.guild_name },
+                channel: { id: conversation.id, name: channel?.channel_name, type: channel?.channel_type },
+                bot: { id: client.tiny_id, role, channelAdminScope: 'unknown' },
+            };
+        }
+        return { ...common, bot: { id: client.uin, role: 'not_applicable' } };
+    },
+});

package/agents/icqq/skills/icqq-conversation/tools/conversation_info/index.ts

@@ -0,0 +1,61 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentConversation } from '../../../../conversation.js';
+
+export default defineAgentTool({
+  description: '读取当前 ICQQ 会话及机器人自己的群／频道身份；区分调用者权限、机器人平台权限和不支持的操作',
+  adapter: 'icqq',
+  requiresApproval: 'never',
+  inputSchema: z.object({}),
+  async execute(_input, context) {
+    const conversation = currentConversation(context);
+    const client = context.$client;
+    const roles = context.principal.roles;
+    const common = {
+      conversation,
+      requester: {
+        roles,
+        canRequestGroupModeration: roles.some(role => ['master', 'admin', 'trusted', 'owner'].includes(role)),
+        canRequestLeave: roles.includes('master'),
+      },
+      operations: {
+        quoteReply: conversation.kind !== 'channel',
+        forwardMessages: conversation.kind !== 'channel',
+        recallOwnMessage: conversation.kind !== 'channel',
+        recallMemberMessage: conversation.kind === 'group',
+        leaveGroup: conversation.kind === 'group',
+      },
+    };
+    if (conversation.kind === 'group') {
+      const id = Number(conversation.id);
+      const [group, self] = await Promise.all([
+        client.getGroupInfo(id, true),
+        client.getGroupMemberInfo(id, client.uin, true),
+      ]);
+      context.signal.throwIfAborted();
+      const role = group.owner_id === client.uin ? 'owner' : self.role;
+      return {
+        ...common,
+        group: { id: group.group_id, name: group.group_name, ownerId: group.owner_id, memberCount: group.member_count },
+        bot: { id: client.uin, role, canModerateMembers: role === 'owner' || role === 'admin', canLeave: role === 'admin' || role === 'member' },
+      };
+    }
+    if (conversation.kind === 'channel') {
+      const guildId = conversation.parent?.id;
+      const guild = guildId ? client.guilds.get(guildId) : undefined;
+      const channel = guild?.channels.get(conversation.id);
+      const members = guildId ? await client.getGuildMemberList(guildId) : [];
+      context.signal.throwIfAborted();
+      const self = members.find(member => member.tiny_id === client.tiny_id);
+      const role = self?.role === 4 ? 'owner' : self?.role === 2 ? 'admin'
+        : self?.role === 5 ? 'channel_admin' : self?.role === 1 ? 'member' : 'unknown';
+      return {
+        ...common,
+        guild: { id: guildId, name: guild?.guild_name },
+        channel: { id: conversation.id, name: channel?.channel_name, type: channel?.channel_type },
+        bot: { id: client.tiny_id, role, channelAdminScope: 'unknown' },
+      };
+    }
+    return { ...common, bot: { id: client.uin, role: 'not_applicable' } };
+  },
+});

package/agents/icqq/skills/icqq-directory/SKILL.md

@@ -2,19 +2,17 @@
 name: icqq-directory
 platforms:
   - icqq
-description: ICQQ 好友、群和成员目录查询能力。
+description: ICQQ 好友列表、群列表和用户资料查询。
 keywords:
-  - "icqq"
-  - "好友列表"
-  - "群列表"
-  - "成员信息"
+  - icqq
+  - 好友列表
+  - 群列表
+  - 用户资料
 tools:
-  - "friend_list"
-  - "group_list"
-  - "user_info"
-  - "group_member_info"
+  - friend_list
+  - group_list
+  - user_info
 ---
-
 # icqq-directory
 
-查询用户或群成员前先获取稳定 QQ 号或群号。目录信息只向群主、管理员、master 或 trusted 披露；不要根据昵称猜测身份。
+先查询稳定 QQ 号或群号，不猜测昵称对应的 ID。目录信息只向群主、管理员、master 或 trusted 披露。

package/agents/icqq/skills/icqq-directory/tools/user_info/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -10,6 +11,6 @@ export default defineAgentTool({
     requiresApproval: 'never',
     async execute({ user_id }, context) {
         const profile = await context.$client.getProfile(user_id);
-        return { success: true, message: `已获取 ${user_id} 的用户信息:${JSON.stringify(profile, null, 2)}` };
+        return { success: true, message: t(context.locale, 'userInfo', { p0: user_id, p1: JSON.stringify(profile, null, 2) }) };
     },
 });

package/agents/icqq/skills/icqq-directory/tools/user_info/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ user_id: number }>({
@@ -9,6 +10,6 @@ export default defineAgentTool<{ user_id: number }>({
   requiresApproval: 'never',
   async execute({ user_id }, context) {
     const profile = await context.$client.getProfile(user_id);
-    return { success: true, message: `已获取 ${user_id} 的用户信息:${JSON.stringify(profile,null,2)}` };
+    return { success: true, message: t(context.locale, 'userInfo', { p0: user_id, p1: JSON.stringify(profile,null,2) }) };
   },
 });

package/agents/icqq/skills/icqq-group-admin/SKILL.md

@@ -2,24 +2,41 @@
 name: icqq-group-admin
 platforms:
   - icqq
-description: ICQQ 邀请、踢人、禁言、头衔、匿名、公告和精华管理能力。
+description: ICQQ 群管理、撤回他人消息，以及仅主人可申请的退群操作；工具分别声明权限与审批要求。
 keywords:
-  - "icqq"
-  - "群管理"
-  - "禁言"
-  - "踢人"
-  - "公告"
-  - "精华"
+  - icqq
+  - 群管理
+  - 禁言
+  - 踢人
+  - 公告
+  - 精华
+  - 退群
+  - 撤回他人消息
 tools:
-  - "group_invite"
-  - "group_kick"
-  - "set_mute"
-  - "set_title"
-  - "set_anonymous"
-  - "announce"
-  - "essence"
+  - group_invite
+  - group_kick
+  - set_mute
+  - set_title
+  - set_anonymous
+  - announce
+  - essence
+  - group_leave
+  - recall_member_message
+scopes:
+  - group
 ---
-
 # icqq-group-admin
 
 仅在目标群和目标成员明确时加载。所有写操作遵守 Tool 审批与角色权限；不可逆或影响成员关系的操作先复核参数。
+
+自动管群必须先确认具体规则和目标群，不能仅凭权限许可自行制定触发条件。
+
+本技能的踢人工具每次都需人工审批，必须展示本次目标群、目标成员和理由；上一笔操作的批准不能授权下一笔踢人。
+
+已配置的自动审核流程可对入群 10 分钟内的明确广告直接踢出；该例外由审核流程核验，不授权本技能或普通对话绕过人工审批。
+
+`group_leave` 仅主人（master）可发起，每次人工审批，只能退出当前群。Bot 为群主时拒绝执行，因为 SDK 的退群会解散群。
+
+`recall_member_message` 沿用 master/admin/trusted/owner 发起权限，无需逐次审批；目标固定在当前群中的真实消息。执行前实时查询 Bot 与目标成员角色：管理员只能撤回普通成员，群主可撤回管理员或普通成员。平台时限与执行结果仍然有效，不自动重试未确认的结果。
+
+撤回 Bot 自己的消息不要求群管角色：使用 `icqq-messages` 的 `recall_own_message`。已配置自动群审核的撤回继续走原有审核路径，不因本工具新增审批，也不扩大审核类别或目标群。

package/agents/icqq/skills/icqq-group-admin/tools/announce/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     permissions: ['role(master,admin,trusted,owner)'],
     async execute({ group_id, content }, context) {
         await context.$client.sendGroupNotice(group_id, content);
-        return { success: true, message: '群公告已发送' };
+        return { success: true, message: t(context.locale, 'announcementSent') };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/announce/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ group_id: number; content: string }>({
@@ -12,6 +13,6 @@ export default defineAgentTool<{ group_id: number; content: string }>({
   permissions: ['role(master,admin,trusted,owner)'],
   async execute({ group_id, content }, context) {
     await context.$client.sendGroupNotice(group_id, content);
-    return { success: true, message: '群公告已发送' };
+    return { success: true, message: t(context.locale, 'announcementSent') };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/essence/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -19,6 +20,6 @@ export default defineAgentTool({
         else {
             await client.removeEssenceMessage(message_id);
         }
-        return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
+        return { success: true, message: action === 'add' ? t(context.locale, 'essenceAdded') : t(context.locale, 'essenceRemoved') };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/essence/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ message_id: string; action: 'add' | 'remove' }>({
@@ -17,6 +18,6 @@ export default defineAgentTool<{ message_id: string; action: 'add' | 'remove' }>
     } else {
       await client.removeEssenceMessage(message_id);
     }
-    return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
+    return { success: true, message: action === 'add' ? t(context.locale, 'essenceAdded') : t(context.locale, 'essenceRemoved') };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/group_invite/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -8,16 +9,17 @@ export default defineAgentTool({
         user_id: z.number().describe('要邀请的 QQ号'),
     }),
     adapter: 'icqq',
+    scopes: ["group"],
     requiresApproval: 'always',
     async execute({ group_id, user_id }, context) {
         const client = context.$client;
         const groupInfo = client.pickGroup(group_id);
         if (!groupInfo)
-            return { success: false, message: '目标群不存在' };
+            return { success: false, message: t(context.locale, 'groupMissing') };
         const memberInfo = client.pickMember(group_id, user_id);
         if (memberInfo)
-            return { success: false, message: '目标成员已加入群' };
+            return { success: false, message: t(context.locale, 'memberExists') };
         await client.inviteFriend(group_id, user_id);
-        return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+        return { success: true, message: t(context.locale, 'inviteAttempted', { p0: user_id, p1: group_id }) };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/group_invite/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ group_id: number; user_id: number }>({
@@ -7,14 +8,15 @@ export default defineAgentTool<{ group_id: number; user_id: number }>({
     user_id: z.number().describe('要邀请的 QQ号'),
   }),
   adapter: 'icqq',
+  scopes: ["group"],
   requiresApproval: 'always',
   async execute({ group_id, user_id }, context) {
     const client = context.$client;
     const groupInfo= client.pickGroup(group_id);
-    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    if(!groupInfo) return { success: false, message: t(context.locale, 'groupMissing') };
     const memberInfo= client.pickMember(group_id,user_id);
-    if(memberInfo) return { success: false, message: '目标成员已加入群' };
+    if(memberInfo) return { success: false, message: t(context.locale, 'memberExists') };
     await client.inviteFriend(group_id, user_id);
-    return { success: true, message: `已尝试邀请 ${user_id} 加入群 ${group_id}` };
+    return { success: true, message: t(context.locale, 'inviteAttempted', { p0: user_id, p1: group_id }) };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/group_kick/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -6,22 +7,24 @@ export default defineAgentTool({
     inputSchema: z.object({
         group_id: z.number().describe('目标群号'),
         user_id: z.number().describe('要踢出的成员 QQ号'),
+        reason: z.string().min(1).describe('本次踢人的具体原因，随目标群和成员一起供人工确认'),
     }),
     adapter: 'icqq',
     scopes: ['group'],
     permissions: ['role(master,admin,trusted,owner)'],
-    requiresApproval: 'once',
+    requiresApproval: 'human',
     async execute({ group_id, user_id }, context) {
         const client = context.$client;
-        const selfInfo = client.pickMember(group_id, client.uin);
-        if (!selfInfo.is_admin && !selfInfo.is_owner)
-            return { success: false, message: '机器人不是群主或管理员，无法踢出成员' };
-        if (selfInfo.user_id === user_id)
-            return { success: false, message: '机器人不能踢出自己' };
-        const memberInfo = client.pickMember(group_id, user_id);
-        if (!memberInfo)
-            return { success: false, message: '目标成员不存在' };
-        await client.setGroupKick(group_id, user_id);
-        return { success: true, message: `已踢出 ${user_id} 成员` };
+        const [self, member] = await Promise.all([
+            client.getGroupMemberInfo(group_id, client.uin, true),
+            client.getGroupMemberInfo(group_id, user_id, true),
+        ]);
+        if (user_id === client.uin || (self.role !== 'owner' && self.role !== 'admin')
+            || member.role !== 'member')
+            return { success: false, message: t(context.locale, 'kickForbidden') };
+        context.signal.throwIfAborted();
+        if (!await client.setGroupKick(group_id, user_id))
+            return { success: false, message: t(context.locale, 'kickUnconfirmed') };
+        return { success: true, message: t(context.locale, 'memberKicked', { p0: user_id }) };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/group_kick/index.ts

@@ -1,23 +1,27 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-export default defineAgentTool<{ group_id: number; user_id: number }>({
+export default defineAgentTool<{ group_id: number; user_id: number; reason: string }>({
   description: '踢出 QQ 群中的某个成员',
   inputSchema: z.object({
     group_id: z.number().describe('目标群号'),
     user_id: z.number().describe('要踢出的成员 QQ号'),
+    reason: z.string().min(1).describe('本次踢人的具体原因，随目标群和成员一起供人工确认'),
   }),
   adapter: 'icqq',
   scopes:['group'],
   permissions: ['role(master,admin,trusted,owner)'],
-  requiresApproval: 'once',
+  requiresApproval: 'human',
   async execute({ group_id, user_id }, context) {
     const client = context.$client;
-    const selfInfo= client.pickMember(group_id,client.uin);
-    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '机器人不是群主或管理员，无法踢出成员' };
-    if(selfInfo.user_id === user_id) return { success: false, message: '机器人不能踢出自己' };
-    const memberInfo= client.pickMember(group_id,user_id);
-    if(!memberInfo) return { success: false, message: '目标成员不存在' };
-    await client.setGroupKick(group_id, user_id);
-    return { success: true, message: `已踢出 ${user_id} 成员` };
+    const [self, member] = await Promise.all([
+      client.getGroupMemberInfo(group_id, client.uin, true),
+      client.getGroupMemberInfo(group_id, user_id, true),
+    ]);
+    if (user_id === client.uin || (self.role !== 'owner' && self.role !== 'admin')
+      || member.role !== 'member') return { success: false, message: t(context.locale, 'kickForbidden') };
+    context.signal.throwIfAborted();
+    if (!await client.setGroupKick(group_id, user_id)) return { success: false, message: t(context.locale, 'kickUnconfirmed') };
+    return { success: true, message: t(context.locale, 'memberKicked', { p0: user_id }) };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/group_leave/index.js

@@ -0,0 +1,33 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentGroup } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+export default defineAgentTool({
+    description: '让机器人退出当前 QQ 群；仅主人可发起且每次人工审批，机器人是群主时拒绝执行以免解散群',
+    adapter: 'icqq',
+    scopes: ['group'],
+    permissions: ['role(master)'],
+    requiresApproval: 'human',
+    risk: 'dangerous',
+    riskCategory: 'member',
+    inputSchema: z.object({
+        group_id: z.number().int().positive().describe('当前群号，展示于本次退群审批'),
+        reason: z.string().min(1).describe('本次退群原因，供主人逐次确认'),
+    }),
+    async execute({ group_id }, context) {
+        if (currentGroup(context) !== group_id)
+            return { success: false, message: t(context.locale, 'leaveForbidden') };
+        const client = context.$client;
+        const [group, self] = await Promise.all([
+            client.getGroupInfo(group_id, true),
+            client.getGroupMemberInfo(group_id, client.uin, true),
+        ]);
+        if (group.owner_id === client.uin || (self.role !== 'admin' && self.role !== 'member')) {
+            return { success: false, message: t(context.locale, 'leaveForbidden') };
+        }
+        context.signal.throwIfAborted();
+        const success = await client.setGroupLeave(group_id);
+        return { success, message: t(context.locale, success ? 'groupLeft' : 'leaveUnconfirmed') };
+    },
+});

package/agents/icqq/skills/icqq-group-admin/tools/group_leave/index.ts

@@ -0,0 +1,32 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentGroup } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+
+export default defineAgentTool({
+  description: '让机器人退出当前 QQ 群；仅主人可发起且每次人工审批，机器人是群主时拒绝执行以免解散群',
+  adapter: 'icqq',
+  scopes: ['group'],
+  permissions: ['role(master)'],
+  requiresApproval: 'human',
+  risk: 'dangerous',
+  riskCategory: 'member',
+  inputSchema: z.object({
+    group_id: z.number().int().positive().describe('当前群号，展示于本次退群审批'),
+    reason: z.string().min(1).describe('本次退群原因，供主人逐次确认'),
+  }),
+  async execute({ group_id }, context) {
+    if (currentGroup(context) !== group_id) return { success: false, message: t(context.locale, 'leaveForbidden') };
+    const client = context.$client;
+    const [group, self] = await Promise.all([
+      client.getGroupInfo(group_id, true),
+      client.getGroupMemberInfo(group_id, client.uin, true),
+    ]);
+    if (group.owner_id === client.uin || (self.role !== 'admin' && self.role !== 'member')) {
+      return { success: false, message: t(context.locale, 'leaveForbidden') };
+    }
+    context.signal.throwIfAborted();
+    const success = await client.setGroupLeave(group_id);
+    return { success, message: t(context.locale, success ? 'groupLeft' : 'leaveUnconfirmed') };
+  },
+});

package/agents/icqq/skills/icqq-group-admin/tools/recall_member_message/index.js

@@ -0,0 +1,33 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentGroup, recallMessage, resolveMessage } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+export default defineAgentTool({
+    description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及机器人具备实时平台权限，无需逐次审批',
+    adapter: 'icqq',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
+    requiresApproval: 'never',
+    inputSchema: z.object({
+        message_id: z.string().min(1).describe('当前群中要撤回的真实消息 ID'),
+        reason: z.string().min(1).describe('撤回的具体原因，自动处理必须依据已确认的群规'),
+    }),
+    async execute({ message_id }, context) {
+        const group = currentGroup(context);
+        const message = await resolveMessage(context, message_id);
+        const client = context.$client;
+        // Own messages do not depend on membership administration rights.
+        if (message.sender.user_id === client.uin)
+            return recallMessage(context, message_id);
+        const [self, target] = await Promise.all([
+            client.getGroupMemberInfo(group, client.uin, true),
+            client.getGroupMemberInfo(group, message.sender.user_id, true),
+        ]);
+        if (!(self.role === 'owner' && (target.role === 'admin' || target.role === 'member'))
+            && !(self.role === 'admin' && target.role === 'member')) {
+            return { success: false, message: t(context.locale, 'recallForbidden') };
+        }
+        return recallMessage(context, message_id);
+    },
+});

package/agents/icqq/skills/icqq-group-admin/tools/recall_member_message/index.ts

@@ -0,0 +1,32 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentGroup, recallMessage, resolveMessage } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+
+export default defineAgentTool({
+  description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及机器人具备实时平台权限，无需逐次审批',
+  adapter: 'icqq',
+  scopes: ['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
+  requiresApproval: 'never',
+  inputSchema: z.object({
+    message_id: z.string().min(1).describe('当前群中要撤回的真实消息 ID'),
+    reason: z.string().min(1).describe('撤回的具体原因，自动处理必须依据已确认的群规'),
+  }),
+  async execute({ message_id }, context) {
+    const group = currentGroup(context);
+    const message = await resolveMessage(context, message_id);
+    const client = context.$client;
+    // Own messages do not depend on membership administration rights.
+    if (message.sender.user_id === client.uin) return recallMessage(context, message_id);
+    const [self, target] = await Promise.all([
+      client.getGroupMemberInfo(group, client.uin, true),
+      client.getGroupMemberInfo(group, message.sender.user_id, true),
+    ]);
+    if (!(self.role === 'owner' && (target.role === 'admin' || target.role === 'member'))
+      && !(self.role === 'admin' && target.role === 'member')) {
+      return { success: false, message: t(context.locale, 'recallForbidden') };
+    }
+    return recallMessage(context, message_id);
+  },
+});

package/agents/icqq/skills/icqq-group-admin/tools/set_anonymous/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -16,8 +17,8 @@ export default defineAgentTool({
         const on = enable ?? true;
         const selfInfo = client.pickMember(group_id, client.uin);
         if (!selfInfo.is_admin && !selfInfo.is_owner)
-            return { success: false, message: '机器人不是群主或管理员，无法开启或关闭匿名聊天' };
+            return { success: false, message: t(context.locale, 'anonymousForbidden') };
         await client.setGroupAnonymous(group_id, on);
-        return { success: true, message: on ? '已开启匿名聊天' : '已关闭匿名聊天' };
+        return { success: true, message: on ? t(context.locale, 'anonymousEnabled') : t(context.locale, 'anonymousDisabled') };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/set_anonymous/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ group_id: number; enable?: boolean }>({
@@ -14,8 +15,8 @@ export default defineAgentTool<{ group_id: number; enable?: boolean }>({
     const client = context.$client;
     const on = enable ?? true;
     const selfInfo= client.pickMember(group_id,client.uin);
-    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: '机器人不是群主或管理员，无法开启或关闭匿名聊天' };
+    if(!selfInfo.is_admin && !selfInfo.is_owner) return { success: false, message: t(context.locale, 'anonymousForbidden') };
     await client.setGroupAnonymous(group_id, on);
-    return { success: true, message: on ? '已开启匿名聊天' : '已关闭匿名聊天' };
+    return { success: true, message: on ? t(context.locale, 'anonymousEnabled') : t(context.locale, 'anonymousDisabled') };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/set_mute/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -15,11 +16,11 @@ export default defineAgentTool({
         const client = context.$client;
         const selfInfo = client.pickMember(group_id, client.uin);
         if (!selfInfo.is_admin && !selfInfo.is_owner)
-            return { success: false, message: '机器人不是群主或管理员，无法禁言/解除禁言成员' };
+            return { success: false, message: t(context.locale, 'muteForbidden') };
         const memberInfo = client.pickMember(group_id, user_id);
         if (!memberInfo)
-            return { success: false, message: '目标成员不存在' };
+            return { success: false, message: t(context.locale, 'memberMissing') };
         await client.setGroupBan(group_id, user_id, duration === 0 ? 0 : duration);
-        return { success: true, message: `已${duration === 0 ? '解除' : ''}禁言 ${user_id} 成员${duration === 0 ? '' : `(${duration}秒)`}` };
+        return { success: true, message: duration === 0 ? t(context.locale, 'unmuted', { user: user_id }) : t(context.locale, 'muted', { user: user_id, seconds: duration ?? 0 }) };
     },
 });