@zhin.js/adapter-icqq 1.1.15 → 1.1.16

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，按转发顺序排列') }),
+    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;

package/lib/endpoint.js

@@ -87,6 +87,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 +627,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,

package/lib/i18n.d.ts

@@ -0,0 +1 @@
+export declare const messages: (locale: import("zhin.js").Locale | undefined, key: "direct" | "addUsage" | "uinRequired" | "uinInvalid" | "endpointAdded" | "endpointAddFailed" | "loginQr" | "loginSlider" | "loginSms" | "loginAuth" | "loginOther", values?: import("zhin.js").MessageValues) => string;

package/lib/i18n.js

@@ -0,0 +1,47 @@
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    "direct": {
+        "zh-CN": "direct（直连 @icqqjs/icqq）",
+        "en": "direct (@icqqjs/icqq)"
+    },
+    "addUsage": {
+        "zh-CN": "用法：{command} <uin>（uin 为纯数字 QQ 号）",
+        "en": "Usage: {command} <uin> (a numeric QQ account ID)"
+    },
+    "uinRequired": {
+        "zh-CN": "请提供纯数字 QQ 号（uin）",
+        "en": "Provide a numeric QQ account ID (uin)"
+    },
+    "uinInvalid": {
+        "zh-CN": "icqq endpoint 名必须是纯数字 QQ 号（uin）",
+        "en": "The ICQQ endpoint name must be a numeric QQ account ID (uin)"
+    },
+    "endpointAdded": {
+        "zh-CN": "✅ endpoint「{id}」已追加到 {file} 的 plugins.icqq.endpoints。\n重启 zhin 后生效。",
+        "en": "✅ Endpoint “{id}” added to plugins.icqq.endpoints in {file}.\nRestart zhin to apply."
+    },
+    "endpointAddFailed": {
+        "zh-CN": "添加失败：{error}",
+        "en": "Could not add the endpoint: {error}"
+    },
+    "loginQr": {
+        "zh-CN": "扫码登录：请在手机 QQ 扫描二维码，完成后在 Console / 终端确认继续",
+        "en": "Scan the QR code in mobile QQ, then confirm in Console or your terminal."
+    },
+    "loginSlider": {
+        "zh-CN": "滑动验证：打开链接完成滑块，将返回的 ticket（可含 randstr）提交继续",
+        "en": "Open the link, complete the slider challenge, and submit the returned ticket (with randstr if provided)."
+    },
+    "loginSms": {
+        "zh-CN": "设备锁：已请求短信验证码，请提交短信验证码继续",
+        "en": "Device verification: an SMS code was requested. Submit the code to continue."
+    },
+    "loginAuth": {
+        "zh-CN": "身份验证：完成后在 Console / 终端确认继续",
+        "en": "Complete identity verification, then confirm in Console or your terminal."
+    },
+    "loginOther": {
+        "zh-CN": "登录辅助（{step}）",
+        "en": "Login assistance ({step})"
+    }
+});

package/lib/icqq-login-assist.d.ts

@@ -1,3 +1,4 @@
+import type { Locale } from 'zhin.js/i18n';
 import type { LoginAssist, LoginAssistType } from '@zhin.js/core';
 type IcqqLoginClient = {
     login(password?: string): Promise<unknown>;
@@ -23,5 +24,6 @@ export declare function runIcqqLoginAssistStep(input: {
     logger: Logger;
     step: LoginAssistType;
     event: unknown;
+    locale?: Locale;
 }): Promise<void>;
 export {};

package/lib/icqq-login-assist.js

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 import { formatCompact } from '@zhin.js/logger';
 /**
  * Drive ICQQ login challenges through LoginAssist (refresh-safe pending tasks).
@@ -7,7 +8,7 @@ import { formatCompact } from '@zhin.js/logger';
 export async function runIcqqLoginAssistStep(input) {
     const { assist, client, adapter, endpointKey, owner, logger, step, event } = input;
     assist.cancelOwned(owner, `replaced_by_${step}`);
-    const payload = buildPayload(step, event);
+    const payload = buildPayload(step, event, input.locale);
     logger.info(formatCompact({
         op: 'login_assist_pending',
         endpoint: endpointKey,
@@ -56,33 +57,33 @@ export async function runIcqqLoginAssistStep(input) {
         }));
     }
 }
-function buildPayload(step, event) {
+function buildPayload(step, event, locale) {
     const raw = event && typeof event === 'object' ? event : {};
     switch (step) {
         case 'qrcode':
             return {
-                message: '扫码登录：请在手机 QQ 扫描二维码，完成后在 Console / 终端确认继续',
+                message: t(locale, 'loginQr'),
                 image: bufferToDataUrl(raw.image),
             };
         case 'slider':
             return {
-                message: '滑动验证：打开链接完成滑块，将返回的 ticket（可含 randstr）提交继续',
+                message: t(locale, 'loginSlider'),
                 url: typeof raw.url === 'string' ? raw.url : undefined,
             };
         case 'device':
             return {
-                message: '设备锁：已请求短信验证码，请提交短信验证码继续',
+                message: t(locale, 'loginSms'),
                 url: typeof raw.url === 'string' ? raw.url : undefined,
                 phone: raw.phone,
             };
         case 'auth':
             return {
-                message: '身份验证：完成后在 Console / 终端确认继续',
+                message: t(locale, 'loginAuth'),
                 url: typeof raw.url === 'string' ? raw.url : undefined,
                 device: raw.device,
             };
         default:
-            return { message: `登录辅助（${step}）` };
+            return { message: t(locale, 'loginOther', { step }) };
     }
 }
 function normalizeSubmitValue(value) {

package/lib/protocol.d.ts

@@ -198,6 +198,7 @@ export interface ResolvedIcqqConfig {
 export interface IcqqWireSegment {
     readonly type: string;
     readonly data?: Record<string, unknown>;
+    readonly platform?: Readonly<Record<string, unknown>>;
 }
 export interface IcqqInboundMessage {
     readonly id: string;

package/lib/protocol.js

@@ -265,6 +265,7 @@ const ICQQ_STANDALONE_ELEMENTS = new Set([
     'json',
     'share',
     'long_msg',
+    'multimsg',
 ]);
 /** Normalize inline image bytes before either temporary-file or native-base64 delivery. */
 export function normalizeIcqqImageMedia(content) {
@@ -336,7 +337,7 @@ export function formatOutboundMessages(payload) {
     }
     const messages = groups.filter(group => group.some(element => typeof element === 'string'
         ? element.trim() !== ''
-        : element.type !== 'reply'));
+        : element.type !== 'reply' && element.type !== 'quote'));
     if (messages.length === 0)
         return ['\u200b'];
     return messages.map(group => group.length === 1 ? group[0] : group);
@@ -380,6 +381,14 @@ function formatOutboundElements(payload) {
                 const id = String(item.data?.message_id ?? item.data?.id ?? '').trim();
                 if (!id)
                     throw new TypeError('ICQQ reply segment requires message_id');
+                const quote = item.platform?.icqqQuote;
+                if (quote) {
+                    const { user_id, seq, rand, time, message } = quote;
+                    if (typeof user_id !== 'number' || typeof seq !== 'number' || typeof rand !== 'number'
+                        || typeof time !== 'number' || typeof message !== 'string')
+                        throw new TypeError('Invalid ICQQ quote source');
+                    return { type: 'quote', user_id, seq, rand, time, message };
+                }
                 return { type: 'reply', id };
             }
             case 'record':
@@ -410,6 +419,10 @@ function formatOutboundElements(payload) {
                 const resid = String(item.data?.forward_id ?? item.data?.resid ?? item.data?.id ?? '').trim();
                 if (!resid)
                     throw new TypeError('ICQQ forward segment requires forward_id');
+                // Prepared merged forwards need their filename; a long_msg would expand inline.
+                const filename = item.platform?.icqqForwardFilename;
+                if (typeof filename === 'string' && filename)
+                    return { type: 'multimsg', resid, filename };
                 return { type: 'long_msg', resid };
             }
             case 'share':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.15",
+  "version": "1.1.16",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,24 +33,24 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.22",
-    "@zhin.js/agent-feature": "1.1.9",
-    "@zhin.js/core": "1.1.50",
-    "@zhin.js/feature-kit": "1.1.8",
-    "@zhin.js/im-contract": "1.1.6",
+    "@zhin.js/adapter": "1.1.23",
+    "@zhin.js/agent-feature": "1.1.10",
+    "@zhin.js/core": "1.1.51",
+    "@zhin.js/feature-kit": "1.1.9",
+    "@zhin.js/im-contract": "1.1.7",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/permission": "1.1.8",
-    "@zhin.js/skill": "1.1.9",
-    "@zhin.js/tool": "1.1.9"
+    "@zhin.js/permission": "1.1.9",
+    "@zhin.js/skill": "1.1.10",
+    "@zhin.js/tool": "1.1.10"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.22",
-    "@zhin.js/command": "^1.1.10",
-    "@zhin.js/core": "^1.1.50",
-    "@zhin.js/prompt-section": "^1.1.8",
-    "zhin.js": "^1.1.15"
+    "@zhin.js/adapter": "^1.1.23",
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/core": "^1.1.51",
+    "@zhin.js/prompt-section": "^1.1.9",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -75,8 +75,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/prompt-section": "1.1.8",
-    "zhin.js": "1.1.15"
+    "@zhin.js/prompt-section": "1.1.9",
+    "zhin.js": "1.1.16"
   },
   "files": [
     "adapters",