@zhin.js/adapter-icqq 1.1.17 → 1.1.18

package/pages/index/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+export const meta = definePage({
+    title: 'ICQQ',
+    titleI18n: { en: 'ICQQ' },
+    icon: 'MessageCircle',
+    order: 64,
+    requiredPermissions: ['icqq:read'],
+});
+/**
+ * Convention page: `pages/index/index.ts` → `/icqq`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('icqq');

package/pages/index/index.ts

@@ -0,0 +1,16 @@
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+
+export const meta = definePage({
+  title: 'ICQQ',
+  titleI18n: { en: 'ICQQ' },
+  icon: 'MessageCircle',
+  order: 64,
+  requiredPermissions: ['icqq:read'],
+});
+
+/**
+ * Convention page: `pages/index/index.ts` → `/icqq`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('icqq');

package/plugin.js

@@ -1,8 +1,10 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { createEndpointRuntimeState } from 'zhin.js/adapter';
-import { definePlugin } from 'zhin.js';
+import { definePlugin, pluginConsoleRpcToken } from 'zhin.js';
 import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/permission';
 import { icqqRuntimeStateToken } from "./lib/icqq-runtime-state.js";
+import { icqqLoginControlToken } from "./lib/icqq-login-control.js";
+import { createIcqqConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'icqq',
     metadata: {
@@ -11,6 +13,9 @@ export default definePlugin({
     setup(context) {
         // 运行中 endpoint 注册表（icqq endpoint list 的"运行中"数据源）
         context.resources.provide(icqqRuntimeStateToken, createEndpointRuntimeState());
+        // 掉线恢复命令用：当前 generation 每个 UIN 的登录控制面
+        context.resources.provide(icqqLoginControlToken, new Map());
+        context.resources.provide(pluginConsoleRpcToken, createIcqqConsoleRpc(context.resources, () => context.config.get()));
         const disposePlatform = context.resources.has(permissionHostToken)
             ? context.resources.use(permissionHostToken).registerPlatform('icqq', createSceneRolePlatformChecker())
             : undefined;

package/schema.json

@@ -346,6 +346,93 @@
                 "description": "Command prefix for this endpoint."
               }
             }
+          },
+          "notify": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "掉线/登录失败时通过另一个适配器实例给 master 发通知（adapter/endpoint/kind/id 指向实际会话）",
+            "x-i18n": {
+              "en": {
+                "description": "Send outage/login notices to the master through another adapter instance (adapter/endpoint/kind/id identify the actual conversation)."
+              }
+            },
+            "properties": {
+              "adapter": {
+                "type": "string",
+                "description": "通知使用的适配器类型，如 qq / icqq",
+                "x-i18n": {
+                  "en": {
+                    "description": "Adapter type used for the notice, such as qq or icqq."
+                  }
+                }
+              },
+              "endpoint": {
+                "type": "string",
+                "description": "该适配器的 endpoint id",
+                "x-i18n": {
+                  "en": {
+                    "description": "Endpoint id of that adapter."
+                  }
+                }
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "private",
+                  "group",
+                  "channel"
+                ],
+                "default": "private",
+                "description": "会话类型，默认 private",
+                "x-i18n": {
+                  "en": {
+                    "description": "Conversation kind; defaults to private."
+                  }
+                }
+              },
+              "id": {
+                "type": [
+                  "string",
+                  "number"
+                ],
+                "description": "master 在该平台上的会话 id（QQ 官方为 openid，ICQQ 为 QQ 号）",
+                "x-i18n": {
+                  "en": {
+                    "description": "Master conversation id on that platform (openid for QQ official, QQ number for ICQQ)."
+                  }
+                }
+              },
+              "parent": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "private",
+                      "group",
+                      "channel"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "kind",
+                  "id"
+                ],
+                "description": "可选的父频道/群容器"
+              }
+            },
+            "required": [
+              "adapter",
+              "endpoint",
+              "id"
+            ]
           }
         },
         "required": [
@@ -367,6 +454,93 @@
           "description": "Command prefix, empty by default. Each endpoints[i] can override it."
         }
       }
+    },
+    "notify": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "掉线/登录失败时通过另一个适配器实例给 master 发通知（adapter/endpoint/kind/id 指向实际会话）",
+      "x-i18n": {
+        "en": {
+          "description": "Send outage/login notices to the master through another adapter instance (adapter/endpoint/kind/id identify the actual conversation)."
+        }
+      },
+      "properties": {
+        "adapter": {
+          "type": "string",
+          "description": "通知使用的适配器类型，如 qq / icqq",
+          "x-i18n": {
+            "en": {
+              "description": "Adapter type used for the notice, such as qq or icqq."
+            }
+          }
+        },
+        "endpoint": {
+          "type": "string",
+          "description": "该适配器的 endpoint id",
+          "x-i18n": {
+            "en": {
+              "description": "Endpoint id of that adapter."
+            }
+          }
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "private",
+            "group",
+            "channel"
+          ],
+          "default": "private",
+          "description": "会话类型，默认 private",
+          "x-i18n": {
+            "en": {
+              "description": "Conversation kind; defaults to private."
+            }
+          }
+        },
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "master 在该平台上的会话 id（QQ 官方为 openid，ICQQ 为 QQ 号）",
+          "x-i18n": {
+            "en": {
+              "description": "Master conversation id on that platform (openid for QQ official, QQ number for ICQQ)."
+            }
+          }
+        },
+        "parent": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "private",
+                "group",
+                "channel"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "number"
+              ]
+            }
+          },
+          "required": [
+            "kind",
+            "id"
+          ],
+          "description": "可选的父频道/群容器"
+        }
+      },
+      "required": [
+        "adapter",
+        "endpoint",
+        "id"
+      ]
     }
   },
   "required": [

package/src/console-spec.ts

@@ -0,0 +1,17 @@
+/**
+ * ICQQ Console 页面元数据（浏览器与服务端共享；不要在这里 import 服务端代码）。
+ */
+import type { AdapterConsoleField } from 'zhin.js/adapter';
+
+export const icqqConsoleSpec = {
+  adapterKey: 'icqq',
+  adapterDisplayName: 'ICQQ',
+  fields: [
+  ] as readonly AdapterConsoleField[],
+  docsUrl: 'https://zhin.js.org/adapters/icqq',
+  readPermission: 'icqq:read',
+  writePermission: 'icqq:write',
+  idPattern: /^\d+$/,
+  idHint: 'ICQQ endpoint id 是 QQ 号（纯数字）',
+  idHintI18n: { en: 'ICQQ endpoint ID is the QQ number (digits only)' },
+} as const;

package/src/console.ts

@@ -0,0 +1,21 @@
+/**
+ * ICQQ Console RPC：运行状态 + endpoint 增删（原 `icqq endpoint` 聊天命令）。
+ *
+ * 页面绑定 `pages/index`，读取 / 写入分别要求 `<adapter>:read` / `<adapter>:write`。
+ */
+import { createAdapterConsoleRpc, type AdapterConsoleResources } from 'zhin.js/adapter';
+import type { PluginConsoleRpc } from 'zhin.js';
+import { icqqRuntimeStateToken } from './icqq-runtime-state.js';
+import { icqqConsoleSpec } from './console-spec.js';
+
+export function createIcqqConsoleRpc(
+  resources: AdapterConsoleResources,
+  getConfig: () => unknown,
+): PluginConsoleRpc {
+  const state = resources.use(icqqRuntimeStateToken);
+  return createAdapterConsoleRpc({
+    ...icqqConsoleSpec,
+    running: () => state.endpoints.values(),
+    getConfig,
+  }, resources);
+}

package/src/endpoint.ts

@@ -17,12 +17,14 @@ import {
   type EndpointPendingRequest,
   type EndpointSendRequest,
   type EndpointTransportState,
+  type AdapterOutageNotifier,
 } from 'zhin.js/adapter';
 import type { EndpointContentPort } from '@zhin.js/adapter';
-import { receiveOneBotLikeSideEvent, buildSystem, toCanonicalSegments, type LoginAssist } from '@zhin.js/core';
-import { EndpointDeliveryError, type MessageRef } from '@zhin.js/im-contract';
+import { receiveOneBotLikeSideEvent, buildSystem, toCanonicalSegments, type LoginAssist, type PendingLoginTask } from '@zhin.js/core';
+import { EndpointDeliveryError, type EndpointSendPart, type EndpointSendResult, type MessageRef } from '@zhin.js/im-contract';
 import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
+import type { IcqqLoginControl } from './icqq-login-control.js';
 import { runIcqqLoginAssistStep } from './icqq-login-assist.js';
 import { IcqqContentResolver } from './content-resolver.js';
 import {
@@ -53,7 +55,7 @@ import {
 } from './outbound-media.js';
 import {
   formatInboundContent,
-  formatOutboundMessages,
+  formatOutboundMessageParts,
   normalizeIcqqImageMedia,
   icqqInboundConversation,
   icqqOutboundTarget,
@@ -70,6 +72,8 @@ export interface IcqqEndpointOptions {
   readonly config: ResolvedIcqqConfig;
   readonly loginAssist: LoginAssist;
   readonly locale?: import('zhin.js/i18n').Locale;
+  /** Out-of-band outage notifier; absent in tests/hosts without outbound. */
+  readonly notifier?: AdapterOutageNotifier;
 }
 
 const BOUND_EVENTS = [
@@ -114,6 +118,12 @@ export class IcqqEndpoint extends Endpoint<Client> {
   readonly #inboundOwner = new AsyncLocalStorage<symbol>();
   readonly #contentResolver: IcqqContentResolver;
   readonly content: EndpointContentPort;
+  readonly loginControl: IcqqLoginControl;
+  #reloginTimer?: ReturnType<typeof setTimeout>;
+  #reloginAttempts = 0;
+  #reloginInFlight?: Promise<void>;
+  #offlineNoticeAt = 0;
+  #challengeNoticeAt = 0;
 
   readonly management: EndpointManagement = Object.freeze<EndpointManagement>({
     inspectGroupMember: (group, user, signal) => inspectGroupMember(this.client, group, user, signal),
@@ -210,6 +220,19 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.#logger = getAdapterLogger('icqq', options.config.id);
     this.#options = options;
     this.endpointName = options.config.id;
+    this.loginControl = Object.freeze({
+      endpointId: this.endpointName,
+      state: () => ({
+        endpointId: this.endpointName,
+        transportState: this.transportState,
+        online: this.client.isOnline(),
+        pending: this.#pendingLoginTasks(),
+      }),
+      pending: () => this.#pendingLoginTasks(),
+      relogin: () => this.relogin(),
+      submit: (taskId: string, value: string | Record<string, unknown>) => this.#options.loginAssist.submit(taskId, value),
+      cancel: (taskId: string, reason?: string) => this.#options.loginAssist.cancel(taskId, reason),
+    });
   }
 
   #handleBackgroundFailure(operation: IcqqBackgroundOperation, error: unknown): void {
@@ -228,6 +251,141 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.client.emit('internal.error.network', -2, `ICQQ ${operation} failed`);
   }
 
+  /** Force a login attempt (manual recovery command). */
+  relogin(): Promise<void> {
+    return this.#startRelogin(true);
+  }
+
+  #startRelogin(resetAttempts: boolean): Promise<void> {
+    if (this.#stopped || this.#retiring) {
+      return Promise.reject(new Error('ICQQ endpoint 已停止'));
+    }
+    if (this.#reloginInFlight) return this.#reloginInFlight;
+    if (resetAttempts) this.#reloginAttempts = 0;
+    const task = this.#performRelogin();
+    this.#reloginInFlight = task;
+    void task.catch(() => undefined).finally(() => {
+      if (this.#reloginInFlight === task) this.#reloginInFlight = undefined;
+      if (this.#started && !this.#stopped && !this.#retiring && !this.client.isOnline()) {
+        this.#scheduleRelogin('relogin_failed');
+      }
+    });
+    return task;
+  }
+
+  async #performRelogin(): Promise<void> {
+    this.#clearReloginTimer();
+    this.client.cancelReconnect();
+    this.#logger.info(formatCompact({ op: 'icqq_relogin', endpoint: this.endpointName }));
+    try {
+      await this.client.login(this.#options.config.password);
+    } catch (error) {
+      this.#logger.warn(formatCompact({
+        op: 'icqq_relogin_failed',
+        endpoint: this.endpointName,
+        error: error instanceof Error ? error.message : String(error),
+      }));
+      throw error;
+    }
+  }
+
+  #scheduleRelogin(reason: string): void {
+    if (!this.#options.config.autoReconnect || this.#stopped || this.#retiring) return;
+    if (this.#reloginTimer || this.#reloginInFlight) return;
+    if (this.#reloginAttempts >= 8) return;
+    const attempt = this.#reloginAttempts++;
+    const delayMs = Math.min(300_000, 5_000 * (2 ** Math.min(attempt, 5)));
+    this.#logger.info(formatCompact({
+      op: 'icqq_relogin_scheduled',
+      endpoint: this.endpointName,
+      reason,
+      attempt: attempt + 1,
+      delay_ms: delayMs,
+    }));
+    this.#reloginTimer = setTimeout(() => {
+      this.#reloginTimer = undefined;
+      void this.#startRelogin(false).catch(() => {
+        // #performRelogin already scheduled the next attempt.
+      });
+    }, delayMs);
+    this.#reloginTimer.unref?.();
+  }
+
+  #clearReloginTimer(): void {
+    if (!this.#reloginTimer) return;
+    clearTimeout(this.#reloginTimer);
+    this.#reloginTimer = undefined;
+  }
+
+  #pendingLoginTasks(): readonly PendingLoginTask[] {
+    return this.#options.loginAssist.listPending()
+      .filter((task) => task.adapter === 'icqq' && task.endpointKey === this.endpointName);
+  }
+
+  #notifyOffline(reason: string, willRetry: boolean): void {
+    const notifier = this.#options.notifier;
+    if (!notifier?.configured) return;
+    const now = Date.now();
+    if (now - this.#offlineNoticeAt < 60_000) return;
+    this.#offlineNoticeAt = now;
+    const recovery = willRetry
+      ? '已开始自动重新登录。'
+      : '请手动重新登录。';
+    const qrCommand = `icqq login qr ${this.endpointName}`;
+    const confirmCommand = `icqq login confirm ${this.endpointName}`;
+    const codeCommand = `icqq login code ${this.endpointName} <内容>`;
+    const text = `[Zhin] ICQQ ${this.endpointName} 掉线（${reason}）。${recovery}\n`
+      + `恢复：在 QQ 回复 \`${qrCommand}\` 获取二维码，扫码后回复 \`${confirmCommand}\`；`
+      + `滑块/短信验证请回复 \`${codeCommand}\`。也可以打开 Console 的 ICQQ 页面完成登录。`;
+    void notifier.send(text).then((sent) => {
+      if (sent) return;
+      this.#logger.warn(formatCompact({
+        op: 'icqq_notify_failed',
+        endpoint: this.endpointName,
+        reason,
+      }));
+    });
+  }
+
+  #notifyChallenge(step: 'qrcode' | 'slider' | 'device' | 'auth'): void {
+    const notifier = this.#options.notifier;
+    if (!notifier?.configured) return;
+    const now = Date.now();
+    if (now - this.#challengeNoticeAt < 30_000) return;
+    this.#challengeNoticeAt = now;
+    const label = step === 'qrcode' ? '二维码验证'
+      : step === 'slider' ? '滑块验证'
+        : step === 'device' ? '设备确认'
+          : '登录确认';
+    const qrCommand = `icqq login qr ${this.endpointName}`;
+    const confirmCommand = `icqq login confirm ${this.endpointName}`;
+    const codeCommand = `icqq login code ${this.endpointName} <内容>`;
+    const text = `[Zhin] ICQQ ${this.endpointName} 需要${label}。\n`
+      + (step === 'qrcode' || step === 'auth'
+        ? `在 QQ 回复 \`${qrCommand}\` 获取二维码，完成后回复 \`${confirmCommand}\`。`
+        : `在 QQ 回复 \`icqq login status ${this.endpointName}\` 查看验证链接，再用 \`${codeCommand}\` 提交验证码；也可以打开 Console 的 ICQQ 页面。`);
+    void notifier.send(text).then((sent) => {
+      if (sent) return;
+      this.#logger.warn(formatCompact({
+        op: 'icqq_notify_failed',
+        endpoint: this.endpointName,
+        reason: `login_${step}`,
+      }));
+    });
+  }
+
+  #notifyRecovered(): void {
+    const notifier = this.#options.notifier;
+    const hadOfflineNotice = this.#offlineNoticeAt > 0;
+    this.#offlineNoticeAt = 0;
+    this.#challengeNoticeAt = 0;
+    if (!notifier?.configured || !hadOfflineNotice) return;
+    void notifier.send(`[Zhin] ICQQ ${this.endpointName} 已重新上线。`).then((sent) => {
+      if (sent) return;
+      this.#logger.warn(formatCompact({ op: 'icqq_notify_failed', endpoint: this.endpointName, reason: 'recovered' }));
+    });
+  }
+
   #ignoreReactionAck(action: 'add' | 'remove', task: Promise<unknown> | unknown): void {
     void Promise.resolve(task).catch((error) => {
       this.#logger.debug(formatCompact({
@@ -274,6 +432,7 @@ export class IcqqEndpoint extends Endpoint<Client> {
         `connected (direct) | friends: ${this.client.fl.size} | groups: ${this.client.gl.size}`,
       );
     } catch (error) {
+      this.#notifyOffline('start_failed', false);
       await this.stop();
       this.#logger.debug(`Failed to connect ICQQ client: ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
       throw error;
@@ -308,6 +467,7 @@ export class IcqqEndpoint extends Endpoint<Client> {
 
   async stop(): Promise<void> {
     this.#stopped = true;
+    this.#clearReloginTimer();
     this.#assertExternalLifecycle('stop');
     this.#armRetirementFence();
     await Promise.allSettled([...this.#inflightInbound]);
@@ -358,7 +518,7 @@ export class IcqqEndpoint extends Endpoint<Client> {
     });
   }
 
-  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
+  async send({ conversation, payload }: EndpointSendRequest): Promise<EndpointSendResult> {
     if (!this.#started) throw new EndpointDeliveryError('endpoint_disconnected', 'icqq endpoint 未连接', 'not_sent');
     const mediaMode = resolveIcqqOutboundMediaMode(this.#options.config);
     const prepared = isIcqqSegmentPayload(payload)
@@ -366,10 +526,10 @@ export class IcqqEndpoint extends Endpoint<Client> {
       : { content: payload, dispose() {} };
     try {
       // Standalone elements (share / file / …) are split into ordered messages.
-      const messages = formatOutboundMessages(prepared.content);
+      const messages = formatOutboundMessageParts(prepared.content);
       const parsed = icqqOutboundTarget(conversation);
-      let messageId: string | undefined;
-      for (const [index, message] of messages.entries()) {
+      const parts: EndpointSendPart[] = [];
+      for (const [index, { message, sourceIndices }] of messages.entries()) {
         const preview = formatIcqqSendablePreview(message);
         let result: { message_id?: unknown };
         try {
@@ -383,48 +543,30 @@ export class IcqqEndpoint extends Endpoint<Client> {
             preview: truncatePreview(preview, 120),
           }));
           if (index === 0) throw error;
-          // Earlier parts are already delivered: a retry would duplicate them.
-          throw new EndpointDeliveryError('partial_delivery', `ICQQ delivered ${index} of ${messages.length} message parts`, 'unknown', { cause: error });
+          // Earlier sends completed; retrying can duplicate accepted messages, even without ids.
+          throw new EndpointDeliveryError('partial_delivery', `ICQQ completed ${index} of ${messages.length} message sends`, 'unknown', { cause: error, parts });
         }
         const rawId = result?.message_id;
         const id = (typeof rawId === 'string' || (typeof rawId === 'number' && Number.isFinite(rawId))) && String(rawId).trim() !== ''
           ? String(rawId) : undefined;
-        messageId ??= id;
+        parts.push({ ...(id ? { messageId: id } : {}), ...(sourceIndices ? { sourceIndices } : {}) });
         this.#logger.info(
           `send ${conversation.kind}:${conversation.id} | id: ${id ?? '-'} | ${truncatePreview(preview, 80)}`,
         );
       }
-      // Native share / file APIs return no id; the reply is confirmed by any part that has one.
-      if (!messageId) {
-        throw new EndpointDeliveryError('delivery_unconfirmed', 'Message delivery is unconfirmed: ICQQ returned no message_id', 'unknown');
+      // A resolved share/file call has no message identity; retain that unknown slot in the batch.
+      if (!parts.some(part => part.messageId)) {
+        throw new EndpointDeliveryError('delivery_unconfirmed', 'Message delivery is unconfirmed: ICQQ returned no message_id', 'unknown', { parts });
       }
-      return messageId;
+      return { parts };
     } finally {
-      prepared.dispose();
-    }
-  }
-
-  /**
-   * ICQQ's share API returns no message id; a resolved call only means the server accepted it.
-   * The card is the bot's own newest card message in the conversation history, so read the id
-   * from there (once more after a short wait, history can lag). Undefined keeps the delivery
-   * unconfirmed rather than inventing an id.
-   */
-  async #findOwnCard(
-    history: () => Promise<readonly { message_id?: unknown; time?: number; message?: readonly { type?: string }[]; sender?: { user_id?: number }; user_id?: number }[]>,
-    sentAt: number,
-  ): Promise<string | undefined> {
-    const self = Number(this.client.uin);
-    for (const wait of [0, 500]) {
-      if (wait) await new Promise(resolve => setTimeout(resolve, wait));
-      // A missing or throwing history API must not turn an accepted share into a send failure.
-      const messages = await Promise.resolve().then(history).catch(() => []);
-      const card = [...messages].reverse().find(item => Number(item.sender?.user_id ?? item.user_id) === self
-        && (item.time ?? 0) >= sentAt - 2
-        && (item.message ?? []).some(element => element.type === 'json' || element.type === 'xml' || element.type === 'share'));
-      if (card && card.message_id != null && String(card.message_id).trim()) return String(card.message_id);
+      try {
+        prepared.dispose();
+      } catch (error) {
+        // Temporary-file cleanup cannot change an already observed platform send outcome.
+        this.#logger.warn(formatCompact({ op: 'icqq_media_cleanup_failed', error: describeUnknownError(error) }));
+      }
     }
-    return undefined;
   }
 
   async #sendNative(
@@ -434,16 +576,14 @@ export class IcqqEndpoint extends Endpoint<Client> {
     if (isIcqqShareElement(message)) {
       switch (target.kind) {
         case 'private': {
-          const sentAt = Math.floor(Date.now() / 1000);
           const friend = this.client.pickFriend(target.userId);
           await friend.share(message);
-          return { message_id: await this.#findOwnCard(() => friend.getChatHistory(), sentAt) };
+          return {};
         }
         case 'group': {
-          const sentAt = Math.floor(Date.now() / 1000);
           const group = this.client.pickGroup(target.groupId);
           await group.share(message);
-          return { message_id: await this.#findOwnCard(() => group.getChatHistory(), sentAt) };
+          return {};
         }
         case 'temp':
           await this.client.pickMember(target.groupId, target.userId).share(message);
@@ -614,12 +754,16 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.#bindSystemOnlineEvent();
     this.client.on('system.offline', (event) => {
       this.#logSystemEvent('offline', event);
+      this.#notifyOffline('offline', this.#options.config.autoReconnect);
     });
     this.client.on('system.offline.network', (event) => {
       this.#logSystemEvent('offline.network', event);
+      this.#notifyOffline('network', this.#options.config.autoReconnect);
     });
     this.client.on('system.offline.kickoff', (event) => {
       this.#logSystemEvent('offline.kickoff', event);
+      this.#notifyOffline('kickoff', this.#options.config.autoReconnect);
+      this.#scheduleRelogin('kickoff');
     });
     this.client.on('system.login.qrcode', (event) => {
       this.#logger.info('icqq 收到二维码登录事件，等待 LoginAssist / 终端确认后继续');
@@ -634,6 +778,8 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.client.on('system.login.error', (event) => {
       this.#options.loginAssist.cancelOwned(this.#loginAssistOwner, 'login_error');
       this.#logSystemEvent('login.error', event);
+      this.#notifyOffline('login_error', this.#options.config.autoReconnect);
+      this.#scheduleRelogin('login_error');
     });
     this.client.on('system.login.auth', (event) => {
       this.#handleLoginChallenge('auth', event);
@@ -644,6 +790,9 @@ export class IcqqEndpoint extends Endpoint<Client> {
     this.client.on('system.online', (event) => {
       if (this.#retiring) return;
       this.#everOnline = true;
+      this.#clearReloginTimer();
+      this.#reloginAttempts = 0;
+      this.#notifyRecovered();
       try {
         this.#resolveStartOnline?.();
         this.#options.loginAssist.cancelOwned(this.#loginAssistOwner, 'online');
@@ -707,6 +856,8 @@ export class IcqqEndpoint extends Endpoint<Client> {
       ? event as Record<string, unknown>
       : null);
     this.#logSystemEvent(`login.${step}`, event);
+    this.#clearReloginTimer();
+    this.#notifyChallenge(step);
     void runIcqqLoginAssistStep({
       assist: this.#options.loginAssist,
       locale: this.#options.locale,