@zhin.js/adapter-icqq 1.1.14 → 1.1.16

package/agents/icqq/skills/icqq-group-admin/tools/set_mute/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; duration?: number }>({
@@ -13,10 +14,10 @@ export default defineAgentTool<{ group_id: number; user_id: number; duration?: n
   async execute({ group_id, user_id, duration }, 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.is_admin && !selfInfo.is_owner) return { success: false, message: t(context.locale, 'muteForbidden') };
     const memberInfo= client.pickMember(group_id,user_id);
-    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    if(!memberInfo) 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 }) };
   },
 });

package/agents/icqq/skills/icqq-group-admin/tools/set_title/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,11 +17,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, 'titleForbidden') };
         const memberInfo = client.pickMember(group_id, user_id);
         if (!memberInfo)
-            return { success: false, message: '目标成员不存在' };
+            return { success: false, message: t(context.locale, 'memberMissing') };
         await client.setGroupSpecialTitle(group_id, user_id, title, duration ?? -1);
-        return { success: true, message: `已将 ${user_id} 的头衔设为 "${title}"` };
+        return { success: true, message: t(context.locale, 'titleChanged', { p0: user_id, p1: title }) };
     },
 });

package/agents/icqq/skills/icqq-group-admin/tools/set_title/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; title: string; duration?: number }>({
@@ -14,10 +15,10 @@ export default defineAgentTool<{ group_id: number; user_id: number; title: strin
   async execute({ group_id, user_id, title, duration }, 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.is_admin && !selfInfo.is_owner) return { success: false, message: t(context.locale, 'titleForbidden') };
     const memberInfo= client.pickMember(group_id,user_id);
-    if(!memberInfo) return { success: false, message: '目标成员不存在' };
+    if(!memberInfo) return { success: false, message: t(context.locale, 'memberMissing') };
     await client.setGroupSpecialTitle(group_id, user_id, title, duration ?? -1);
-    return { success: true, message: `已将 ${user_id} 的头衔设为 "${title}"` };
+    return { success: true, message: t(context.locale, 'titleChanged', { p0: user_id, p1: title }) };
   },
 });

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

@@ -0,0 +1,16 @@
+---
+name: icqq-group-directory
+platforms:
+  - icqq
+scopes:
+  - group
+description: ICQQ 群成员信息查询。
+keywords:
+  - icqq
+  - 成员信息
+tools:
+  - group_member_info
+---
+# icqq-group-directory
+
+目标群和成员必须明确；只把工具返回的信息当作已验证事实。

package/agents/icqq/skills/{icqq-directory → icqq-group-directory}/tools/group_member_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({
@@ -14,10 +15,10 @@ export default defineAgentTool({
     async execute({ group_id, user_id }, context) {
         const group = context.$client.pickGroup(group_id);
         if (!group)
-            return { success: false, message: '目标群不存在' };
+            return { success: false, message: t(context.locale, 'groupMissing') };
         const memberInfo = group.pickMember(user_id);
         if (!memberInfo)
-            return { success: false, message: '目标成员不存在' };
+            return { success: false, message: t(context.locale, 'memberMissing') };
         return {
             success: true,
             member: memberInfo,

package/agents/icqq/skills/{icqq-directory → icqq-group-directory}/tools/group_member_info/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 interface GroupMemberInfoInput {
@@ -17,9 +18,9 @@ export default defineAgentTool<GroupMemberInfoInput>({
   requiresApproval: 'never',
   async execute({ group_id, user_id }, context) {
     const group = context.$client.pickGroup(group_id);
-    if (!group) return { success: false, message: '目标群不存在' };
+    if (!group) return { success: false, message: t(context.locale, 'groupMissing') };
     const memberInfo = group.pickMember(user_id);
-    if (!memberInfo) return { success: false, message: '目标成员不存在' };
+    if (!memberInfo) return { success: false, message: t(context.locale, 'memberMissing') };
     return {
       success: true,
       member: memberInfo,

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

@@ -0,0 +1,18 @@
+---
+name: icqq-group-interaction
+platforms:
+  - icqq
+scopes:
+  - group
+description: ICQQ 群成员戳一戳与群签到。
+keywords:
+  - icqq
+  - 戳一戳
+  - 签到
+tools:
+  - poke
+  - group_sign
+---
+# icqq-group-interaction
+
+确认当前群和目标成员后调用；点赞使用 icqq-interaction。遵守各 Tool 审批策略。

package/agents/icqq/skills/{icqq-interaction → icqq-group-interaction}/tools/group_sign/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,8 +14,8 @@ export default defineAgentTool({
         const client = context.$client;
         const groupInfo = client.pickGroup(group_id);
         if (!groupInfo)
-            return { success: false, message: '目标群不存在' };
+            return { success: false, message: t(context.locale, 'groupMissing') };
         await client.sendGroupSign(group_id);
-        return { success: true, message: '群签到成功' };
+        return { success: true, message: t(context.locale, 'checkedIn') };
     },
 });

package/agents/icqq/skills/{icqq-interaction → icqq-group-interaction}/tools/group_sign/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 }>({
@@ -11,8 +12,8 @@ export default defineAgentTool<{ group_id: number }>({
   async execute({ group_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') };
     await client.sendGroupSign(group_id);
-    return { success: true, message: '群签到成功' };
+    return { success: true, message: t(context.locale, 'checkedIn') };
   },
 });

package/agents/icqq/skills/{icqq-interaction → icqq-group-interaction}/tools/poke/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({
@@ -12,6 +13,6 @@ export default defineAgentTool({
     requiresApproval: 'never',
     async execute({ group_id, user_id }, context) {
         await context.$client.sendGroupPoke(group_id, user_id);
-        return { success: true, message: `已戳了戳 ${user_id}` };
+        return { success: true, message: t(context.locale, 'poked', { p0: user_id }) };
     },
 });

package/agents/icqq/skills/{icqq-interaction → icqq-group-interaction}/tools/poke/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 }>({
@@ -11,6 +12,6 @@ export default defineAgentTool<{ group_id: number; user_id: number }>({
   requiresApproval: 'never',
   async execute({ group_id, user_id }, context) {
     await context.$client.sendGroupPoke(group_id, user_id);
-    return { success: true, message: `已戳了戳 ${user_id}` };
+    return { success: true, message: t(context.locale, 'poked', { p0: user_id }) };
   },
 });

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

@@ -4,14 +4,15 @@ platforms:
   - icqq
 description: ICQQ 群文件与禁言状态查询能力。
 keywords:
-  - "icqq"
-  - "群文件"
-  - "禁言列表"
+  - icqq
+  - 群文件
+  - 禁言列表
 tools:
-  - "group_files"
-  - "list_muted"
+  - group_files
+  - list_muted
+scopes:
+  - group
 ---
-
 # icqq-group-state
 
 用于读取群文件和禁言状态。确认群号后调用，不把列表之外的信息当作已验证事实。

package/agents/icqq/skills/icqq-group-state/tools/group_files/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,7 +14,7 @@ export default defineAgentTool({
     async execute({ group_id }, context) {
         const files = await context.$client.acquireGfs(group_id).ls('/');
         if (!files.length)
-            return { files: [], message: '群文件为空' };
+            return { files: [], message: t(context.locale, 'filesEmpty') };
         return {
             files: files.slice(0, 30).map((f) => 'size' in f
                 ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }

package/agents/icqq/skills/icqq-group-state/tools/group_files/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 }>({
@@ -11,7 +12,7 @@ export default defineAgentTool<{ group_id: number }>({
   permissions: ['role(master,admin,trusted,owner)'],
   async execute({ group_id }, context) {
     const files = await context.$client.acquireGfs(group_id).ls('/');
-    if (!files.length) return { files: [], message: '群文件为空' };
+    if (!files.length) return { files: [], message: t(context.locale, 'filesEmpty') };
     return {
       files: files.slice(0, 30).map((f) => 'size' in f
         ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }

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

@@ -2,18 +2,13 @@
 name: icqq-interaction
 platforms:
   - icqq
-description: ICQQ 点赞、戳一戳和群签到互动能力。
+description: ICQQ 用户点赞。
 keywords:
-  - "icqq"
-  - "点赞"
-  - "戳一戳"
-  - "签到"
+  - icqq
+  - 点赞
 tools:
-  - "poke"
-  - "send_user_like"
-  - "group_sign"
+  - send_user_like
 ---
-
 # icqq-interaction
 
-用于低风险社交互动。确认目标用户或群后再调用，并遵守各 Tool 的审批策略。
+用于给用户点赞；先确认真实 QQ 号，遵守 Tool 审批策略。

package/agents/icqq/skills/icqq-interaction/tools/send_user_like/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({
@@ -20,7 +21,7 @@ export default defineAgentTool({
         }));
         const successTimes = successArray.reduce((a, b) => a + b, 0);
         if (!successTimes)
-            return { success: false, message: '点赞失败' };
-        return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+            return { success: false, message: t(context.locale, 'likeFailed') };
+        return { success: true, message: t(context.locale, 'likesSent', { p0: user_id, p1: successTimes }) };
     },
 });

package/agents/icqq/skills/icqq-interaction/tools/send_user_like/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 }>({
@@ -16,7 +17,7 @@ export default defineAgentTool<{ user_id: number }>({
       } catch { /* ignore */ }
     }));
     const successTimes = successArray.reduce((a, b) => a + b, 0);
-    if (!successTimes) return { success: false, message: '点赞失败' };
-    return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+    if (!successTimes) return { success: false, message: t(context.locale, 'likeFailed') };
+    return { success: true, message: t(context.locale, 'likesSent', { p0: user_id, p1: successTimes }) };
   },
 });

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

@@ -0,0 +1,28 @@
+---
+name: icqq-messages
+platforms:
+  - icqq
+description: ICQQ 当前会话的引用回复、真实消息合并转发，以及撤回机器人自己的发言。
+keywords:
+  - 引用
+  - 回复原消息
+  - 转发
+  - 撤回
+  - 自己的消息
+tools:
+  - quote_reply
+  - forward_messages
+  - recall_own_message
+scopes:
+  - private
+  - group
+---
+# icqq-messages
+
+Only use real message IDs from the current conversation. Do not invent IDs, source authors or forwarded content. The tools resolve the originals and send through the unified outbound pipeline. Cross-conversation forwarding is not supported.
+
+`quote_reply` sends a text reply quoting one original; `forward_messages` sends a merged forward of the supplied originals. Use `inspect_conversation_reference` to read an incoming quote/forward when available; it does not send messages.
+
+`recall_own_message` needs no management role or per-call approval, including when the bot is an ordinary group member. It verifies the bot authored the message. The platform decides the recall time window; never promise success before receiving confirmation or retry an unconfirmed result automatically. To recall another member's message, load `icqq-group-admin` instead.
+
+These tools currently support QQ private/group conversations, not guild channels. A failed or suppressed outbound receipt is not a delivered message.

package/agents/icqq/skills/icqq-messages/tools/forward_messages/index.js

@@ -0,0 +1,42 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentConversation, resolveMessage, sendToConversation } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+export default defineAgentTool({
+    description: '将当前 QQ 群或私聊中的真实消息合并转发到本会话；保留真实作者和内容，不支持跨会话转发',
+    adapter: 'icqq',
+    scopes: ['private', 'group'],
+    requiresApproval: 'never',
+    inputSchema: z.object({ message_ids: z.array(z.string().min(1)).min(1).describe('当前会话的真实消息 ID，按转发顺序排列') }),
+    async execute({ message_ids }, context) {
+        const conversation = currentConversation(context);
+        if (conversation.kind === 'channel')
+            throw new Error(t(context.locale, 'channelOperationUnsupported'));
+        const originals = [];
+        for (const id of message_ids)
+            originals.push(await resolveMessage(context, id));
+        const client = context.$client;
+        const target = conversation.kind === 'group' ? client.pickGroup(Number(conversation.id))
+            : conversation.parent?.kind === 'group' ? client.pickMember(Number(conversation.parent.id), Number(conversation.id))
+                : client.pickFriend(Number(conversation.id));
+        // SDK preparation uploads a resource; only the gateway below delivers a message.
+        const card = await target.makeForwardMsg(originals.map(message => ({
+            user_id: message.sender.user_id,
+            nickname: message.sender.nickname,
+            time: message.time,
+            message: message.message,
+        })));
+        context.signal.throwIfAborted();
+        const data = typeof card.data === 'string' ? JSON.parse(card.data) : card.data;
+        const detail = data?.meta?.detail;
+        if (typeof detail?.resid !== 'string' || !detail.resid || typeof detail.uniseq !== 'string' || !detail.uniseq) {
+            throw new Error('ICQQ did not return a complete merged-forward resource');
+        }
+        return sendToConversation(context, {
+            type: 'forward',
+            data: { forward_id: detail.resid },
+            platform: { icqqForwardFilename: detail.uniseq },
+        });
+    },
+});

package/agents/icqq/skills/icqq-messages/tools/forward_messages/index.ts

@@ -0,0 +1,40 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { currentConversation, resolveMessage, sendToConversation } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+
+export default defineAgentTool({
+  description: '将当前 QQ 群或私聊中的真实消息合并转发到本会话；保留真实作者和内容，不支持跨会话转发',
+  adapter: 'icqq',
+  scopes: ['private', 'group'],
+  requiresApproval: 'never',
+  inputSchema: z.object({ message_ids: z.array(z.string().min(1)).min(1).describe('当前会话的真实消息 ID，按转发顺序排列') }),
+  async execute({ message_ids }, context) {
+    const conversation = currentConversation(context);
+    if (conversation.kind === 'channel') throw new Error(t(context.locale, 'channelOperationUnsupported'));
+    const originals = [];
+    for (const id of message_ids) originals.push(await resolveMessage(context, id));
+    const client = context.$client;
+    const target = conversation.kind === 'group' ? client.pickGroup(Number(conversation.id))
+      : conversation.parent?.kind === 'group' ? client.pickMember(Number(conversation.parent.id), Number(conversation.id))
+        : client.pickFriend(Number(conversation.id));
+    // SDK preparation uploads a resource; only the gateway below delivers a message.
+    const card = await target.makeForwardMsg(originals.map(message => ({
+      user_id: message.sender.user_id,
+      nickname: message.sender.nickname,
+      time: message.time,
+      message: message.message,
+    })));
+    context.signal.throwIfAborted();
+    const data = typeof card.data === 'string' ? JSON.parse(card.data) : card.data;
+    const detail = data?.meta?.detail;
+    if (typeof detail?.resid !== 'string' || !detail.resid || typeof detail.uniseq !== 'string' || !detail.uniseq) {
+      throw new Error('ICQQ did not return a complete merged-forward resource');
+    }
+    return sendToConversation(context, {
+      type: 'forward',
+      data: { forward_id: detail.resid },
+      platform: { icqqForwardFilename: detail.uniseq },
+    });
+  },
+});

package/agents/icqq/skills/icqq-messages/tools/quote_reply/index.js

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { resolveMessage, sendToConversation } from '../../../../conversation.js';
+export default defineAgentTool({
+    description: '引用当前 QQ 群或私聊中的真实消息并回复文字；无需群管角色，发送走统一链路',
+    adapter: 'icqq',
+    scopes: ['private', 'group'],
+    requiresApproval: 'never',
+    inputSchema: z.object({
+        message_id: z.string().min(1).describe('当前会话中真实的原消息 ID'),
+        text: z.string().min(1).describe('本次回复的文字'),
+    }),
+    async execute({ message_id, text }, context) {
+        const original = await resolveMessage(context, message_id);
+        return sendToConversation(context, [
+            { type: 'reply', data: { message_id }, platform: { icqqQuote: {
+                        user_id: original.sender.user_id, seq: original.seq, rand: original.rand,
+                        time: original.time, message: original.raw_message,
+                    } } },
+            { type: 'text', data: { text } },
+        ]);
+    },
+});

package/agents/icqq/skills/icqq-messages/tools/quote_reply/index.ts

@@ -0,0 +1,24 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { resolveMessage, sendToConversation } from '../../../../conversation.js';
+
+export default defineAgentTool({
+  description: '引用当前 QQ 群或私聊中的真实消息并回复文字；无需群管角色，发送走统一链路',
+  adapter: 'icqq',
+  scopes: ['private', 'group'],
+  requiresApproval: 'never',
+  inputSchema: z.object({
+    message_id: z.string().min(1).describe('当前会话中真实的原消息 ID'),
+    text: z.string().min(1).describe('本次回复的文字'),
+  }),
+  async execute({ message_id, text }, context) {
+    const original = await resolveMessage(context, message_id);
+    return sendToConversation(context, [
+      { type: 'reply', data: { message_id }, platform: { icqqQuote: {
+        user_id: original.sender.user_id, seq: original.seq, rand: original.rand,
+        time: original.time, message: original.raw_message,
+      } } },
+      { type: 'text', data: { text } },
+    ]);
+  },
+});

package/agents/icqq/skills/icqq-messages/tools/recall_own_message/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { recallMessage, resolveMessage } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+export default defineAgentTool({
+    description: '撤回机器人在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
+    adapter: 'icqq',
+    scopes: ['private', 'group'],
+    requiresApproval: 'never',
+    inputSchema: z.object({ message_id: z.string().min(1).describe('机器人在当前会话中发送的真实消息 ID') }),
+    async execute({ message_id }, context) {
+        const message = await resolveMessage(context, message_id);
+        if (message.sender.user_id !== context.$client.uin)
+            return { success: false, message: t(context.locale, 'ownMessageRequired') };
+        return recallMessage(context, message_id);
+    },
+});

package/agents/icqq/skills/icqq-messages/tools/recall_own_message/index.ts

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { recallMessage, resolveMessage } from '../../../../conversation.js';
+import { messages as t } from '../../../../messages.js';
+
+export default defineAgentTool({
+  description: '撤回机器人在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
+  adapter: 'icqq',
+  scopes: ['private', 'group'],
+  requiresApproval: 'never',
+  inputSchema: z.object({ message_id: z.string().min(1).describe('机器人在当前会话中发送的真实消息 ID') }),
+  async execute({ message_id }, context) {
+    const message = await resolveMessage(context, message_id);
+    if (message.sender.user_id !== context.$client.uin) return { success: false, message: t(context.locale, 'ownMessageRequired') };
+    return recallMessage(context, message_id);
+  },
+});

package/agents/icqq/system.md

@@ -1,3 +1,7 @@
 # ICQQ Platform Agent
 
 You are the icqq platform specialist. Interpret requests in the current icqq conversation and load only the narrowest private Skill needed for the task.
+
+For your own group/guild role, current scene information or platform permissions, load `icqq-conversation` and query `conversation_info`. Sender roles describe the requester, not you. Do not infer your role from old session summaries or another endpoint account.
+
+For quoting, forwarding or recalling your own speech, load `icqq-messages`. Your own-message recall needs no group management role or per-call approval. For recalling another member's message or leaving a group, load `icqq-group-admin` and follow the tool-specific rules; only leaving requires fresh approval. All these message tools are restricted to the current conversation. Guild-channel limitations are explicit in `conversation_info`.

package/commands/icqq/endpoint/definition.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../lib/i18n.js";
 import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
 import { icqqRuntimeStateToken } from "../../../lib/icqq-runtime-state.js";
@@ -6,14 +7,16 @@ export const icqqEndpointCommands = createEndpointCommands({
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
     running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
-    describeEntry: () => 'direct（直连 @icqqjs/icqq）',
+    describeEntry: (_entry, locale) => t(locale, 'direct'),
     addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-    bindFlow: async ({ id, use }) => {
+    addDescriptionI18n: { en: 'Register an ICQQ endpoint; restart zhin to apply' },
+    bindFlow: async ({ id, use, locale, formatCommand }) => {
         if (!id) {
-            return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
+            const command = formatCommand?.('icqq endpoint add');
+            return command ? t(locale, 'addUsage', { command }) : t(locale, 'uinRequired');
         }
         if (!/^\d+$/.test(id)) {
-            return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
+            return t(locale, 'uinInvalid');
         }
         try {
             const { filePath } = await use(endpointConfigurationStoreToken).add({
@@ -21,11 +24,10 @@ export const icqqEndpointCommands = createEndpointCommands({
                 entry: { id },
                 environment: {},
             });
-            return (`✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
-                `重启 zhin 后生效。`);
+            return t(locale, 'endpointAdded', { id, file: filePath });
         }
         catch (error) {
-            return `添加失败：${error instanceof Error ? error.message : String(error)}`;
+            return t(locale, 'endpointAddFailed', { error: error instanceof Error ? error.message : String(error) });
         }
     },
 }, defineCommand);

package/commands/icqq/endpoint/definition.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../src/i18n.js';
 import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
 import { icqqRuntimeStateToken } from '../../../src/icqq-runtime-state.js';
@@ -6,14 +7,16 @@ export const icqqEndpointCommands = createEndpointCommands({
   adapterKey: 'icqq',
   adapterDisplayName: 'ICQQ',
   running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
-  describeEntry: () => 'direct（直连 @icqqjs/icqq）',
+  describeEntry: (_entry, locale) => t(locale, 'direct'),
   addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-  bindFlow: async ({ id, use }) => {
+  addDescriptionI18n: { en: 'Register an ICQQ endpoint; restart zhin to apply' },
+  bindFlow: async ({ id, use, locale, formatCommand }) => {
     if (!id) {
-      return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
+      const command = formatCommand?.('icqq endpoint add');
+      return command ? t(locale, 'addUsage', { command }) : t(locale, 'uinRequired');
     }
     if (!/^\d+$/.test(id)) {
-      return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
+      return t(locale, 'uinInvalid');
     }
     try {
       const { filePath } = await use(endpointConfigurationStoreToken).add({
@@ -21,12 +24,9 @@ export const icqqEndpointCommands = createEndpointCommands({
         entry: { id },
         environment: {},
       });
-      return (
-        `✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
-        `重启 zhin 后生效。`
-      );
+      return t(locale, 'endpointAdded', { id, file: filePath });
     } catch (error) {
-      return `添加失败：${error instanceof Error ? error.message : String(error)}`;
+      return t(locale, 'endpointAddFailed', { error: error instanceof Error ? error.message : String(error) });
     }
   },
 }, defineCommand);

package/lib/endpoint.d.ts

@@ -9,6 +9,7 @@ export interface IcqqEndpointOptions {
     readonly id: CapabilityId;
     readonly config: ResolvedIcqqConfig;
     readonly loginAssist: LoginAssist;
+    readonly locale?: import('zhin.js/i18n').Locale;
 }
 export declare class IcqqEndpoint extends Endpoint<Client> {
     #private;