@zhin.js/adapter-icqq 1.1.15 → 1.1.16

package/schema.json

@@ -4,75 +4,169 @@
   "additionalProperties": false,
   "properties": {
     "master": {
-      "type": ["string", "number"],
-      "description": "框架 master QQ uin（/approve、AI/工具权限）；endpoints[i].master 可逐项覆盖"
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master QQ uin（/approve、AI/工具权限）；endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework master QQ uin list for approval and AI/tool permissions. endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
-      "items": { "type": ["string", "number"] },
-      "description": "框架 trusted QQ uin 列表（弱于 master）"
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ]
+      },
+      "description": "框架 trusted QQ uin 列表（弱于 master）",
+      "x-i18n": {
+        "en": {
+          "description": "Framework trusted QQ uin list, below master authority."
+        }
+      }
     },
     "password": {
       "type": "string",
-      "description": "QQ 密码（可选，不填则扫码登录）"
+      "description": "QQ 密码（可选，不填则扫码登录）",
+      "x-i18n": {
+        "en": {
+          "description": "QQ password (optional); scan a QR code to log in when omitted."
+        }
+      }
     },
     "platform": {
       "type": "number",
-      "enum": [1, 2, 3, 4, 5, 6, 7],
+      "enum": [
+        1,
+        2,
+        3,
+        4,
+        5,
+        6,
+        7
+      ],
       "default": 1,
-      "description": "登录设备平台：1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom"
+      "description": "登录设备平台：1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom",
+      "x-i18n": {
+        "en": {
+          "description": "Login device platform: 1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom."
+        }
+      }
     },
     "ver": {
       "type": "string",
-      "description": "协议版本号，仅在对应 platform 有多个版本时有效，不填则使用最新版本"
+      "description": "协议版本号，仅在对应 platform 有多个版本时有效，不填则使用最新版本",
+      "x-i18n": {
+        "en": {
+          "description": "Protocol version, only applicable when the selected platform has multiple versions. Uses the latest when omitted."
+        }
+      }
     },
     "signApiAddr": {
       "type": "string",
-      "description": "签名服务器地址；未配置时若安装了 @icqqjs/qqsign 则自动使用本地签名"
+      "description": "签名服务器地址；未配置时若安装了 @icqqjs/qqsign 则自动使用本地签名",
+      "x-i18n": {
+        "en": {
+          "description": "Signing server URL. When omitted, uses local signing automatically if @icqqjs/qqsign is installed."
+        }
+      }
     },
     "dataDir": {
       "type": "string",
-      "description": "数据存储文件夹路径，默认为主模块下的 data 文件夹"
+      "description": "数据存储文件夹路径，默认为主模块下的 data 文件夹",
+      "x-i18n": {
+        "en": {
+          "description": "Data directory path; defaults to the data directory under the main module."
+        }
+      }
     },
     "autoReconnect": {
       "type": "boolean",
       "default": true,
-      "description": "断线后是否自动重连（默认 true）"
+      "description": "断线后是否自动重连（默认 true）",
+      "x-i18n": {
+        "en": {
+          "description": "Reconnect automatically after disconnecting (default true)."
+        }
+      }
     },
     "outboundMedia": {
       "type": "string",
-      "enum": ["file", "base64"],
+      "enum": [
+        "file",
+        "base64"
+      ],
       "default": "file",
-      "description": "出站媒体模式：file=落盘本地路径（默认）; base64=CQ base64:// 内联"
+      "description": "出站媒体模式：file=落盘本地路径（默认）; base64=CQ base64:// 内联",
+      "x-i18n": {
+        "en": {
+          "description": "Outbound media mode: file uses local file paths (default); base64 uses inline CQ base64:// data."
+        }
+      }
     },
     "ignoreSelf": {
       "type": "boolean",
       "default": true,
-      "description": "群聊和频道中是否过滤自己的消息（默认 true）"
+      "description": "群聊和频道中是否过滤自己的消息（默认 true）",
+      "x-i18n": {
+        "en": {
+          "description": "Filter the bot's own messages in groups and channels (default true)."
+        }
+      }
     },
     "resend": {
       "type": "boolean",
       "default": false,
-      "description": "被风控时是否尝试用分片发送（默认 false）"
+      "description": "被风控时是否尝试用分片发送（默认 false）",
+      "x-i18n": {
+        "en": {
+          "description": "Attempt fragmented sending when rate-limited by the platform (default false)."
+        }
+      }
     },
     "cacheGroupMember": {
       "type": "boolean",
       "default": true,
-      "description": "是否缓存群员列表（默认 true）；群多时（500+）会多占约 100MB+ 内存"
+      "description": "是否缓存群员列表（默认 true）；群多时（500+）会多占约 100MB+ 内存",
+      "x-i18n": {
+        "en": {
+          "description": "Cache group member lists (default true). Large numbers of groups (500+) may use approximately 100 MB or more of extra memory."
+        }
+      }
     },
     "autoServer": {
       "type": "boolean",
       "default": true,
-      "description": "是否自动选择最优服务器（默认 true）"
+      "description": "是否自动选择最优服务器（默认 true）",
+      "x-i18n": {
+        "en": {
+          "description": "Automatically select the optimal server (default true)."
+        }
+      }
     },
     "qqnt": {
       "type": "boolean",
       "default": true,
-      "description": "是否使用 QQNT 协议（默认 true）"
+      "description": "是否使用 QQNT 协议（默认 true）",
+      "x-i18n": {
+        "en": {
+          "description": "Use the QQNT protocol (default true)."
+        }
+      }
     },
     "ntLogin": {
       "type": "boolean",
-      "description": "是否使用 NT 登录方式"
+      "description": "是否使用 NT 登录方式",
+      "x-i18n": {
+        "en": {
+          "description": "Use the NT login method."
+        }
+      }
     },
     "endpoints": {
       "type": "array",
@@ -88,81 +182,195 @@
             "description": "QQ uin"
           },
           "master": {
-            "type": ["string", "number"],
-            "description": "本 endpoint 的 master QQ uin；覆盖顶层 master"
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的 master QQ uin；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Master QQ uin list for this endpoint, overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
-            "items": { "type": ["string", "number"] },
-            "description": "本 endpoint 的 trusted 列表"
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ]
+            },
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "password": {
             "type": "string",
-            "description": "本 endpoint 的 QQ 密码"
+            "description": "本 endpoint 的 QQ 密码",
+            "x-i18n": {
+              "en": {
+                "description": "QQ password for this endpoint."
+              }
+            }
           },
           "platform": {
             "type": "number",
-            "enum": [1, 2, 3, 4, 5, 6, 7],
-            "description": "登录设备平台：1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom"
+            "enum": [
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7
+            ],
+            "description": "登录设备平台：1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom",
+            "x-i18n": {
+              "en": {
+                "description": "Login device platform: 1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom."
+              }
+            }
           },
           "ver": {
             "type": "string",
-            "description": "协议版本号"
+            "description": "协议版本号",
+            "x-i18n": {
+              "en": {
+                "description": "Protocol version."
+              }
+            }
           },
           "signApiAddr": {
             "type": "string",
-            "description": "签名服务器地址"
+            "description": "签名服务器地址",
+            "x-i18n": {
+              "en": {
+                "description": "Signing server URL."
+              }
+            }
           },
           "dataDir": {
             "type": "string",
-            "description": "数据存储文件夹路径"
+            "description": "数据存储文件夹路径",
+            "x-i18n": {
+              "en": {
+                "description": "Data directory path."
+              }
+            }
           },
           "autoReconnect": {
             "type": "boolean",
-            "description": "断线后是否自动重连"
+            "description": "断线后是否自动重连",
+            "x-i18n": {
+              "en": {
+                "description": "Reconnect automatically after disconnecting."
+              }
+            }
           },
           "outboundMedia": {
             "type": "string",
-            "enum": ["file", "base64"],
-            "description": "出站媒体模式"
+            "enum": [
+              "file",
+              "base64"
+            ],
+            "description": "出站媒体模式",
+            "x-i18n": {
+              "en": {
+                "description": "Outbound media mode."
+              }
+            }
           },
           "ignoreSelf": {
             "type": "boolean",
-            "description": "是否过滤自己的消息"
+            "description": "是否过滤自己的消息",
+            "x-i18n": {
+              "en": {
+                "description": "Filter the bot's own messages."
+              }
+            }
           },
           "resend": {
             "type": "boolean",
-            "description": "被风控时是否分片发送"
+            "description": "被风控时是否分片发送",
+            "x-i18n": {
+              "en": {
+                "description": "Use fragmented sending when rate-limited by the platform."
+              }
+            }
           },
           "cacheGroupMember": {
             "type": "boolean",
-            "description": "是否缓存群员列表"
+            "description": "是否缓存群员列表",
+            "x-i18n": {
+              "en": {
+                "description": "Cache group member lists."
+              }
+            }
           },
           "autoServer": {
             "type": "boolean",
-            "description": "是否自动选择最优服务器"
+            "description": "是否自动选择最优服务器",
+            "x-i18n": {
+              "en": {
+                "description": "Automatically select the optimal server."
+              }
+            }
           },
           "qqnt": {
             "type": "boolean",
-            "description": "是否使用 QQNT 协议"
+            "description": "是否使用 QQNT 协议",
+            "x-i18n": {
+              "en": {
+                "description": "Use the QQNT protocol."
+              }
+            }
           },
           "ntLogin": {
             "type": "boolean",
-            "description": "是否使用 NT 登录方式"
+            "description": "是否使用 NT 登录方式",
+            "x-i18n": {
+              "en": {
+                "description": "Use the NT login method."
+              }
+            }
           },
           "commandPrefix": {
             "type": "string",
-            "description": "本 endpoint 的命令前缀"
+            "description": "本 endpoint 的命令前缀",
+            "x-i18n": {
+              "en": {
+                "description": "Command prefix for this endpoint."
+              }
+            }
           }
         },
-        "required": ["id"]
+        "required": [
+          "id"
+        ]
+      },
+      "x-i18n": {
+        "en": {
+          "description": "Multiple accounts: mount multiple endpoints in one plugin instance. Each entry uses the top-level fields; id is required and other fields override defaults."
+        }
       }
     },
     "commandPrefix": {
       "type": "string",
       "default": "",
-      "description": "命令前缀（默认 '' 无前缀）。endpoints[i] 可逐项覆盖"
+      "description": "命令前缀（默认 '' 无前缀）。endpoints[i] 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Command prefix, empty by default. Each endpoints[i] can override it."
+        }
+      }
     }
   },
-  "required": ["master", "endpoints"]
+  "required": [
+    "master",
+    "endpoints"
+  ]
 }

package/src/endpoint.ts

@@ -67,6 +67,7 @@ export interface IcqqEndpointOptions {
   readonly id: CapabilityId;
   readonly config: ResolvedIcqqConfig;
   readonly loginAssist: LoginAssist;
+  readonly locale?: import('zhin.js/i18n').Locale;
 }
 
 const BOUND_EVENTS = [
@@ -149,6 +150,11 @@ export class IcqqEndpoint extends Endpoint<Client> {
     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');
+      }
+    },
   });
 
   readonly control: EndpointControl = Object.freeze({
@@ -699,6 +705,7 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.#logSystemEvent(`login.${step}`, event);
     void runIcqqLoginAssistStep({
       assist: this.#options.loginAssist,
+      locale: this.#options.locale,
       client: this.client,
       adapter: 'icqq',
       endpointKey: this.endpointName,

package/src/i18n.ts

@@ -0,0 +1,48 @@
+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/src/icqq-login-assist.ts

@@ -1,3 +1,5 @@
+import type { Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 import type { LoginAssist, LoginAssistType, PendingLoginTaskPayload } from '@zhin.js/core';
 import { formatCompact } from '@zhin.js/logger';
 
@@ -27,11 +29,12 @@ export async function runIcqqLoginAssistStep(input: {
   logger: Logger;
   step: LoginAssistType;
   event: unknown;
+  locale?: Locale;
 }): Promise<void> {
   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,
@@ -82,33 +85,33 @@ export async function runIcqqLoginAssistStep(input: {
   }
 }
 
-function buildPayload(step: LoginAssistType, event: unknown): PendingLoginTaskPayload {
+function buildPayload(step: LoginAssistType, event: unknown, locale?: Locale): PendingLoginTaskPayload {
   const raw = event && typeof event === 'object' ? event as Record<string, unknown> : {};
   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 }) };
   }
 }
 

package/src/protocol.ts

@@ -269,6 +269,7 @@ export interface ResolvedIcqqConfig {
 export interface IcqqWireSegment {
   readonly type: string;
   readonly data?: Record<string, unknown>;
+  readonly platform?: Readonly<Record<string, unknown>>;
 }
 
 export interface IcqqInboundMessage {
@@ -394,6 +395,7 @@ const ICQQ_STANDALONE_ELEMENTS = new Set([
   'json',
   'share',
   'long_msg',
+  'multimsg',
 ] as const);
 
 /** Normalize inline image bytes before either temporary-file or native-base64 delivery. */
@@ -461,7 +463,7 @@ export function formatOutboundMessages(payload: unknown): Sendable[] {
   }
   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);
 }
@@ -502,6 +504,13 @@ function formatOutboundElements(payload: readonly unknown[]): (string | MessageE
       case 'reply': {
         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 as Record<string, unknown> | undefined;
+        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':
@@ -528,6 +537,9 @@ function formatOutboundElements(payload: readonly unknown[]): (string | MessageE
       case 'forward': {
         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':