@zhin.js/adapter-icqq 1.1.15 → 1.1.17

package/agents/icqq/skills/icqq-group-directory/tools/group_member_info/index.js

@@ -1,4 +1,6 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
+import { freshMember } from "../../../../members.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -12,15 +14,24 @@ export default defineAgentTool({
     permissions: ['role(master,admin,trusted,owner)'],
     requiresApproval: 'never',
     async execute({ group_id, user_id }, context) {
-        const group = context.$client.pickGroup(group_id);
-        if (!group)
-            return { success: false, message: '目标群不存在' };
-        const memberInfo = group.pickMember(user_id);
-        if (!memberInfo)
-            return { success: false, message: '目标成员不存在' };
+        // pickMember 返回的是实体对象，序列化后只剩 `{}`：模型会据此以为成员不在群里。按 group_kick 的口径实时查询。
+        const info = await freshMember(context.$client, group_id, user_id);
+        if (!info)
+            return { success: false, message: t(context.locale, 'memberMissing') };
         return {
             success: true,
-            member: memberInfo,
+            member: {
+                group_id: info.group_id,
+                user_id: info.user_id,
+                nickname: info.nickname,
+                card: info.card,
+                role: info.role,
+                title: info.title,
+                level: info.level,
+                join_time: info.join_time,
+                last_sent_time: info.last_sent_time,
+                shutup_time: info.shutup_time,
+            },
         };
     },
 });

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

@@ -1,3 +1,5 @@
+import { messages as t } from "../../../../messages.js";
+import { freshMember } from "../../../../members.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 interface GroupMemberInfoInput {
@@ -16,13 +18,23 @@ export default defineAgentTool<GroupMemberInfoInput>({
   permissions: ['role(master,admin,trusted,owner)'],
   requiresApproval: 'never',
   async execute({ group_id, user_id }, context) {
-    const group = context.$client.pickGroup(group_id);
-    if (!group) return { success: false, message: '目标群不存在' };
-    const memberInfo = group.pickMember(user_id);
-    if (!memberInfo) return { success: false, message: '目标成员不存在' };
+    // pickMember 返回的是实体对象，序列化后只剩 `{}`：模型会据此以为成员不在群里。按 group_kick 的口径实时查询。
+    const info = await freshMember(context.$client, group_id, user_id);
+    if (!info) return { success: false, message: t(context.locale, 'memberMissing') };
     return {
       success: true,
-      member: memberInfo,
+      member: {
+        group_id: info.group_id,
+        user_id: info.user_id,
+        nickname: info.nickname,
+        card: info.card,
+        role: info.role,
+        title: info.title,
+        level: info.level,
+        join_time: info.join_time,
+        last_sent_time: info.last_sent_time,
+        shutup_time: info.shutup_time,
+      },
     };
   },
 });

package/agents/icqq/skills/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-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-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-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/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/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（或消息头里的 m<n> 别名），按转发顺序排列') }),
+    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（或消息头里的 m<n> 别名），按转发顺序排列') }),
+  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，或消息头里的 m<n> 别名'),
+        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，或消息头里的 m<n> 别名'),
+    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，或消息头里的 m<n> 别名') }),
+    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，或消息头里的 m<n> 别名') }),
+  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.
+You are the icqq platform specialist. Interpret requests in the current icqq conversation and load only the narrowest available Skill needed for the task.
+
+Use the current Bot snapshot for your platform role. Load `icqq-conversation` and query `conversation_info` when the role is unknown or you need more scene or permission details. Sender roles describe the requester, not you. Do not infer your role from old session summaries or another endpoint account.
+
+Discover message and management operations from the current scene's Skill catalog; follow each tool's target, platform and approval rules. Recalling your own messages needs no group management role or per-call approval. Leaving a group requires fresh approval and is forbidden when you own the group. Do not load a Skill that is absent from the current catalog.

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;

package/lib/endpoint.js

@@ -8,12 +8,13 @@ import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logge
 import { runIcqqLoginAssistStep } from './icqq-login-assist.js';
 import { IcqqContentResolver } from './content-resolver.js';
 import { InboundMessageDeduper, findIcqqNestedMessageSource, isIcqqBotMentioned, isIcqqMessagePostType, normalizeIcqqInboundMessage, messageLookupFromIcqqSource, resolveIcqqQuoteIdFromEvent, resolveIcqqInboundMedia, resolveIcqqSelfUserId, shouldSkipSelfInboundMessage, } from './icqq-inbound.js';
-import { isIcqqNoticePayload, isIcqqRequestPayload, } from './icqq-inbox.js';
+import { icqqNoticeDedupeKey, isIcqqNoticePayload, isIcqqRequestPayload, } from './icqq-inbox.js';
 import { IcqqGuildCatalog, normalizeIcqqGuildInboundMessage, } from './icqq-guild.js';
 import { prepareIcqqOutboundMedia, resolveIcqqOutboundMediaMode, } from './outbound-media.js';
 import { formatInboundContent, formatOutboundMessages, normalizeIcqqImageMedia, icqqInboundConversation, icqqOutboundTarget, } from './protocol.js';
 import { ManagedIcqqClient } from './managed-client.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
+import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
 const BOUND_EVENTS = [
     'message.private',
     'message.group',
@@ -57,6 +58,8 @@ export class IcqqEndpoint extends Endpoint {
     content;
     management = Object.freeze({
         inspectGroupMember: (group, user, signal) => inspectGroupMember(this.client, group, user, signal),
+        inspectGroupScene: (group, signal) => inspectGroupScene(this.client, group, signal),
+        inspectGroupMemberProfile: (group, user, signal) => inspectGroupMemberProfile(this.client, group, user, signal),
         moderateGroupMember: (group, user, action, signal) => moderateGroupMember(this.client, group, user, action, signal, () => this.#open && !this.#retiring && !this.#stopped),
         listFriends: async () => Array.from(this.client.fl.values()).map((f) => ({
             user_id: f.user_id,
@@ -87,6 +90,11 @@ export class IcqqEndpoint extends Endpoint {
         deleteFriend: async (userId) => {
             await this.client.deleteFriend(Number(userId));
         },
+        sendGroupNotice: async (groupId, content) => {
+            if (await this.client.sendGroupNotice(Number(groupId), content) === false) {
+                throw new Error('QQ did not confirm the group notice');
+            }
+        },
     });
     control = Object.freeze({
         recall: async (message) => {
@@ -622,6 +630,7 @@ export class IcqqEndpoint extends Endpoint {
         this.#logSystemEvent(`login.${step}`, event);
         void runIcqqLoginAssistStep({
             assist: this.#options.loginAssist,
+            locale: this.#options.locale,
             client: this.client,
             adapter: 'icqq',
             endpointKey: this.endpointName,
@@ -737,6 +746,7 @@ export class IcqqEndpoint extends Endpoint {
             channelType: normalized.channelType,
             channelId: normalized.channelId,
             channelParentGroupId: normalized.channelParentGroupId,
+            name: normalized.groupName,
         });
         const quoteId = resolveIcqqQuoteIdFromEvent(data);
         const quoted = messageLookupFromIcqqSource(findIcqqNestedMessageSource(data));
@@ -851,13 +861,7 @@ export class IcqqEndpoint extends Endpoint {
     #onNoticeEvent(payload) {
         if (!payload || !isIcqqNoticePayload(payload))
             return;
-        const key = [
-            payload.time,
-            payload.operator_id ?? payload.user_id,
-            payload.notice_type ?? payload.type,
-            payload.sub_type,
-        ].join('_');
-        if (!this.#sideEventDeduper.shouldProcess(`notice:${key}`))
+        if (!this.#sideEventDeduper.shouldProcess(icqqNoticeDedupeKey(payload)))
             return;
         this.#dispatchIcqqSideEvent(payload);
     }

package/lib/group-moderation.js

@@ -3,17 +3,22 @@ export async function inspectGroupMember(client, groupId, userId, signal) {
     signal.throwIfAborted();
     const group = numericId(groupId);
     const user = numericId(userId);
+    const selfLookup = client.getGroupMemberInfo(group, client.uin, true);
     const [self, member] = await Promise.all([
-        client.getGroupMemberInfo(group, client.uin, true),
-        client.getGroupMemberInfo(group, user, true),
+        selfLookup,
+        user === client.uin ? selfLookup : client.getGroupMemberInfo(group, user, true),
     ]);
     signal.throwIfAborted();
     const joinedAt = member.join_time * 1000;
+    const platformRole = member.user_id === user && member.group_id === group
+        && (member.role === 'owner' || member.role === 'admin' || member.role === 'member')
+        ? member.role : undefined;
     return {
         canModerate: client.isOnline() && user !== client.uin
             && self.user_id === client.uin && self.group_id === group
             && member.user_id === user && member.group_id === group
             && (self.role === 'owner' || self.role === 'admin') && member.role === 'member',
+        ...(platformRole ? { platformRole } : {}),
         ...(Number.isSafeInteger(joinedAt) && joinedAt > 0 && joinedAt <= Date.now() ? { joinedAt } : {}),
     };
 }

package/lib/group-scene.d.ts

@@ -0,0 +1,11 @@
+import type { Client } from '@icqqjs/icqq';
+import type { GroupMemberProfile, GroupSceneFacts } from 'zhin.js/adapter';
+/** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
+export declare const ADMIN_SCAN_MAX_MEMBERS = 1000;
+/**
+ * ADR 0041 scene facts: one uncached group-info read, plus (small groups only) one roster read for
+ * admins. A roster failure leaves adminIds unknown instead of failing the other facts.
+ */
+export declare function inspectGroupScene(client: Client, groupId: string, signal: AbortSignal): Promise<GroupSceneFacts>;
+/** ADR 0041 member facts from one uncached lookup (same rationale as the agent `freshMember` helper). */
+export declare function inspectGroupMemberProfile(client: Client, groupId: string, userId: string, signal: AbortSignal): Promise<GroupMemberProfile>;