@zhin.js/adapter-icqq 6.0.2 → 7.0.0

package/src/icqq-agent-deps.ts

@@ -1,18 +1,57 @@
-import type { IcqqAdapter } from './adapter.js';
-import type { IcqqEndpoint } from './endpoint.js';
+/**
+ * Agent tool deps for icqq.
+ * Endpoints register themselves on start; tools look up by config name / QQ uin.
+ */
+
+import type { IpcClient } from './ipc-client.js';
+import type { IpcFriendInfo, IpcGroupInfo } from './types.js';
+import type { IpcResponse } from './protocol.js';
+
+export interface IcqqAgentEndpoint {
+  readonly name: string;
+  readonly ipc: {
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+  };
+  readonly friends: Map<number, IpcFriendInfo>;
+  readonly groups: Map<number, IpcGroupInfo>;
+  request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+}
 
 export interface IcqqAgentDeps {
-  getEndpoint: (endpointId: string) => IcqqEndpoint;
-  getAdapter: () => IcqqAdapter;
+  getEndpoint: (endpointId: string) => IcqqAgentEndpoint;
+  getAdapter?: () => { getEndpoint: (id: string) => IcqqAgentEndpoint };
 }
 
-let _deps: IcqqAgentDeps | null = null;
+const endpoints = new Map<string, IcqqAgentEndpoint>();
+let override: IcqqAgentDeps | null = null;
+
+export function registerIcqqAgentEndpoint(
+  endpointId: string,
+  endpoint: IcqqAgentEndpoint,
+): () => void {
+  endpoints.set(endpointId, endpoint);
+  return () => {
+    if (endpoints.get(endpointId) === endpoint) {
+      endpoints.delete(endpointId);
+    }
+  };
+}
+
+/** Optional override used by tests / transitional callers. Pass `null` to clear. */
+export function setIcqqAgentDeps(deps: IcqqAgentDeps | null): void {
+  override = deps;
+}
 
-export function setIcqqAgentDeps(deps: IcqqAgentDeps): void {
-  _deps = deps;
+function lookup(endpointId: string): IcqqAgentEndpoint {
+  const registered = endpoints.get(endpointId);
+  if (!registered) throw new Error(`Endpoint ${endpointId} 不存在`);
+  return registered;
 }
 
 export function getIcqqAgentDeps(): IcqqAgentDeps {
-  if (!_deps) throw new Error('icqq agent deps not initialized');
-  return _deps;
+  if (override) return override;
+  return {
+    getEndpoint: lookup,
+    getAdapter: () => ({ getEndpoint: lookup }),
+  };
 }

package/src/icqq-guild.ts

@@ -1,11 +1,17 @@
 /**
  * ICQQ guild (QQ 频道) catalog sync, inbound normalize, Console channel list.
  */
-import type { MessageSegment } from "zhin.js";
+import { toCanonicalSegments, type MessageSegment } from "zhin.js";
 import { Actions, type IpcGuildMessageEventData } from "./protocol.js";
-import type { IpcClient } from "./ipc-client.js";
 import { parseCqMessage } from "./cq-message.js";
-import { toCanonicalSegments } from "./segment-mapper.js";
+
+/** Narrow request port shared by the real IPC client and endpoint test transports. */
+export interface IcqqGuildRpc {
+  request(
+    action: string,
+    params?: Record<string, unknown>,
+  ): Promise<{ ok: boolean; data?: unknown }>;
+}
 
 export interface IcqqGuildChannelEntry {
   channel_id: string;
@@ -37,7 +43,7 @@ export class IcqqGuildCatalog {
     this.guilds.clear();
   }
 
-  async syncAll(ipc: IpcClient): Promise<void> {
+  async syncAll(ipc: IcqqGuildRpc): Promise<void> {
     const listResp = await ipc.request(Actions.GUILD_LIST);
     if (!listResp.ok) return;
 

package/src/icqq-inbound.ts

@@ -1,9 +1,8 @@
 /**
  * icqq 守护进程 IPC 入站事件归一化（post_type / message_type / message 段）
  */
-import { Message, type MessageSegment, type QuotedMessagePayload } from "zhin.js";
+import { Message, toCanonicalSegments, type MessageSegment, type QuotedMessagePayload } from "zhin.js";
 import { parseCqMessage } from "./cq-message.js";
-import { toCanonicalSegments } from "./segment-mapper.js";
 import { extractForwardResidFromJsonElement } from "./forward-msg.js";
 import type { GroupRole } from "./types.js";
 
@@ -110,6 +109,36 @@ export function parseIcqqSenderGroupRole(
   return ICQQ_GROUP_ROLES.has(role) ? role : undefined;
 }
 
+/**
+ * 判断入站消息是否 @ 了本机账号（uin = endpoint 配置 name，即 QQ 号）。
+ * 新 Plugin Runtime 的 Message.content 为纯文本，at 信息只能经 metadata 传递，
+ * endpoint 在 admit 时用本函数标注 `metadata.mentioned`（供 Agent Host 的 @ 触发）。
+ */
+export function isIcqqBotMentioned(input: {
+  readonly uin: string;
+  readonly content?: readonly MessageSegment[] | null;
+  readonly rawMessage?: string;
+}): boolean {
+  const uin = String(input.uin ?? "").trim();
+  if (!uin) return false;
+  for (const seg of input.content ?? []) {
+    if (!seg || (seg.type !== "at" && seg.type !== "mention")) continue;
+    const data = (seg.data ?? {}) as Record<string, unknown>;
+    const target = String(
+      data.qq ?? data.user_id ?? data.id ?? data.target ?? "",
+    ).trim();
+    if (target && target !== "all" && Number(target) === Number(uin)) {
+      return true;
+    }
+  }
+  const raw = input.rawMessage ?? "";
+  if (!raw) return false;
+  const escaped = uin.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  // OneBot CQ 码 `[CQ:at,qq=uin]`；QQ 频道 markdown `<@!uin>`
+  return new RegExp(`\\[CQ:at,qq=${escaped}\\]`, "u").test(raw)
+    || new RegExp(`<@!?${escaped}>`, "u").test(raw);
+}
+
 const MESSAGE_POST_TYPES = new Set(["message"]);
 
 function isMessagePostType(postType: unknown): boolean {

package/src/icqq-inbox.ts

@@ -0,0 +1,155 @@
+/**
+ * icqq IPC request/notice 事件 → 统一收件箱行（unified_inbox_request / unified_inbox_notice）。
+ *
+ * daemon 经 IpcEvent 推送 icqq client.em 分发的全部事件（见 protocol.ts），
+ * 好友/群请求（request.friend.add、request.group.add、request.group.invite）
+ * 与通知（notice.friend.*、notice.group.*）随事件流实时到达，无需轮询；
+ * endpoint 启动时补一次 GET_SYSTEM_MSG 拉取离线期间积存的待处理请求。
+ */
+import type { IpcSystemMessage } from './types.js';
+
+/** 行级公共前缀：adapter 槽 localName + endpoint live 名（uin）。 */
+export interface IcqqInboxBase {
+  readonly adapter: string;
+  readonly endpointId: string;
+}
+
+/** post_type=request / request.* 判定（OneBot 事件壳）。 */
+export function isIcqqRequestPayload(payload: unknown): boolean {
+  const postType = (payload as { post_type?: unknown } | null)?.post_type;
+  return typeof postType === 'string'
+    && (postType === 'request' || postType.startsWith('request.'));
+}
+
+/** post_type=notice / notice.* 判定。 */
+export function isIcqqNoticePayload(payload: unknown): boolean {
+  const postType = (payload as { post_type?: unknown } | null)?.post_type;
+  return typeof postType === 'string'
+    && (postType === 'notice' || postType.startsWith('notice.'));
+}
+
+/**
+ * request 事件载荷 → unified_inbox_request 行。
+ * platform_request_id 取 flag（审批回执句柄），缺省回退 seq；两者皆无则无法审批，丢弃。
+ */
+export function buildIcqqInboxRequestRow(
+  payload: Record<string, unknown>,
+  base: IcqqInboxBase,
+): Record<string, unknown> | null {
+  const userId = payload.user_id ?? payload.actor_id;
+  if (userId == null) return null;
+  const flag = asNonEmptyString(payload.flag);
+  const platformRequestId = flag ?? (payload.seq != null ? String(payload.seq) : '');
+  if (!platformRequestId) return null;
+  const requestType = asNonEmptyString(payload.request_type) ?? asNonEmptyString(payload.type);
+  const groupId = payload.group_id;
+  const isGroup = requestType === 'group' || groupId != null;
+  return {
+    adapter: base.adapter,
+    endpoint_id: base.endpointId,
+    platform_request_id: platformRequestId,
+    type: isGroup ? 'group' : (requestType ?? 'friend'),
+    scene_type: isGroup ? 'group' : null,
+    scene_id: String(groupId ?? userId),
+    sub_type: asNonEmptyString(payload.sub_type),
+    actor_id: String(userId),
+    actor_name: asNonEmptyString(payload.nickname),
+    comment: asNonEmptyString(payload.comment),
+    created_at: toMillis(payload.time),
+    resolved: 0,
+    resolved_at: null,
+    consumed: 0,
+    consumed_at: null,
+  };
+}
+
+/**
+ * notice 事件载荷 → unified_inbox_notice 行。
+ * 事件本身无稳定 id，platform_notice_id 由 time + actor + type 合成（配合去重）。
+ */
+export function buildIcqqInboxNoticeRow(
+  payload: Record<string, unknown>,
+  base: IcqqInboxBase,
+): Record<string, unknown> | null {
+  const noticeType = asNonEmptyString(payload.notice_type) ?? asNonEmptyString(payload.type);
+  if (!noticeType) return null;
+  const subType = asNonEmptyString(payload.sub_type);
+  const userId = payload.user_id;
+  const operatorId = payload.operator_id;
+  const groupId = payload.group_id;
+  const createdAt = toMillis(payload.time);
+  const actorId = operatorId ?? userId;
+  const platformNoticeId = asNonEmptyString(payload.notice_id)
+    ?? (payload.seq != null ? String(payload.seq) : undefined)
+    ?? `${createdAt}_${String(actorId ?? '')}_${noticeType}${subType ? `.${subType}` : ''}`;
+  const targetId = userId != null && String(userId) !== String(actorId ?? '') ? userId : undefined;
+  return {
+    adapter: base.adapter,
+    endpoint_id: base.endpointId,
+    platform_notice_id: platformNoticeId,
+    type: noticeType,
+    scene_type: groupId != null ? 'group' : null,
+    scene_id: String(groupId ?? userId ?? operatorId ?? ''),
+    sub_type: subType,
+    actor_id: actorId != null ? String(actorId) : null,
+    actor_name: asNonEmptyString(payload.nickname),
+    target_id: targetId != null ? String(targetId) : null,
+    target_name: null,
+    payload: safeJson(payload),
+    created_at: createdAt,
+    consumed: 0,
+    consumed_at: null,
+  };
+}
+
+/**
+ * GET_SYSTEM_MSG 返回项 → unified_inbox_request 行（启动时首次拉取）。
+ * friend 列表项 type 语义即好友请求；group 列表项 type 为 add/invite（记 sub_type）。
+ */
+export function buildIcqqSystemRequestRow(
+  message: IpcSystemMessage,
+  kind: 'friend' | 'group',
+  base: IcqqInboxBase,
+): Record<string, unknown> | null {
+  if (message.user_id == null) return null;
+  const platformRequestId = asNonEmptyString(message.flag)
+    ?? (message.seq != null ? String(message.seq) : '');
+  if (!platformRequestId) return null;
+  return {
+    adapter: base.adapter,
+    endpoint_id: base.endpointId,
+    platform_request_id: platformRequestId,
+    type: kind,
+    scene_type: kind === 'group' ? 'group' : null,
+    scene_id: String(kind === 'group' ? (message.group_id ?? message.user_id) : message.user_id),
+    sub_type: kind === 'group' ? (asNonEmptyString(message.type) ?? null) : null,
+    actor_id: String(message.user_id),
+    actor_name: asNonEmptyString(message.nickname),
+    comment: asNonEmptyString(message.comment),
+    created_at: toMillis(message.time),
+    resolved: 0,
+    resolved_at: null,
+    consumed: 0,
+    consumed_at: null,
+  };
+}
+
+function asNonEmptyString(value: unknown): string | null {
+  if (typeof value !== 'string') return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+
+/** oicq 事件 time 为秒；缺失时回退当前时间。 */
+function toMillis(time: unknown): number {
+  const seconds = Number(time);
+  return Number.isFinite(seconds) && seconds > 0 ? seconds * 1000 : Date.now();
+}
+
+function safeJson(value: unknown): string {
+  try {
+    return JSON.stringify(value ?? {});
+  } catch {
+    return '{}';
+  }
+}

package/src/index.ts

@@ -1,73 +1,40 @@
-/**
- * ICQQ 适配器入口：类型扩展、导出、注册
- */
-import path from "path";
-import {
-  usePlugin,
-  type Plugin,
-  type ToolFeature,
-} from "zhin.js";
-import { registerAgentPromptContributor, unregisterAgentPromptContributor } from "zhin.js/agent";
-import { createIcqqAgentPromptContributor } from "./agent-prompt.js";
-import type { Router } from "@zhin.js/host-router";
-import { PageManager } from "@zhin.js/host-api";
-import { IcqqAdapter } from "./adapter.js";
-import { registerTools } from "./tools/index.js";
-import { registerRoutes } from "./routes.js";
-import { registerLoginAssistRoutes } from "./login-assist-routes.js";
+export {
+  Actions,
+  formatInboundContent,
+  formatInboundTarget,
+  formatOutboundBody,
+  parseSendTarget,
+  resolveIcqqConfig,
+  type IcqqAdapterConfig,
+  type IcqqInboundMessage,
+  type IcqqWireSegment,
+  type IpcEvent,
+  type IpcMessage,
+  type IpcRequest,
+  type IpcResponse,
+  type ParsedIcqqSendTarget,
+  type ResolvedIcqqConfig,
+} from './protocol.js';
 
-declare module "zhin.js" {
-  namespace Plugin {
-    interface Contexts {
-      web: PageManager;
-      router: Router;
-    }
-  }
-  interface Adapters {
-    icqq: IcqqAdapter;
-  }
-}
+export {
+  IcqqIpcEndpoint,
+  type CreateIcqqIpc,
+  type IcqqEndpointOptions,
+  type IcqqInboxHooks,
+  type IcqqIpcTransport,
+} from './endpoint.js';
 
-export * from "./types.js";
-export { IcqqEndpoint } from "./endpoint.js";
-export { IcqqAdapter } from "./adapter.js";
+export * from './types.js';
 
-const plugin = usePlugin();
-const { provide, useContext, addCommand, root } = plugin;
+export {
+  getIcqqAgentDeps,
+  registerIcqqAgentEndpoint,
+  setIcqqAgentDeps,
+  type IcqqAgentDeps,
+  type IcqqAgentEndpoint,
+} from './icqq-agent-deps.js';
 
-// ── 适配器注册 ─────────────────────────────────────────────────────
-provide({
-  name: "icqq",
-  description: "ICQQ Adapter",
-  mounted: async (p: Plugin) => {
-    registerAgentPromptContributor(createIcqqAgentPromptContributor());
-    const adapter = new IcqqAdapter(p);
-    await adapter.start();
-    return adapter;
-  },
-  dispose: async (adapter: IcqqAdapter) => {
-    unregisterAgentPromptContributor("icqq");
-    await adapter.stop();
-  },
-} as any);
-
-// ── AI 工具注册 ────────────────────────────────────────────────────
-useContext("tool", "icqq", (toolService: ToolFeature, icqq: IcqqAdapter) => {
-  return registerTools(toolService, icqq, plugin.name);
-});
-
-// ── Web 控制台入口 ─────────────────────────────────────────────────
-useContext("web", (pageManager) => {
-  pageManager.addEntry({
-    id: "icqq",
-    development: path.resolve(import.meta.dirname, "../client/index.tsx"),
-    production: path.resolve(import.meta.dirname, "../dist/index.js"),
-    meta: { name: "ICQQ" },
-  });
-});
-
-// ── HTTP 路由 ──────────────────────────────────────────────────────
-useContext("router", "icqq", async (router: Router, icqq: IcqqAdapter) => {
-  registerRoutes(router, icqq, root);
-  registerLoginAssistRoutes(router, root);
-});
+export { IpcClient } from './ipc-client.js';
+export {
+  resolveIcqqInboundMessageId,
+} from './icqq-inbound.js';

package/src/protocol.ts

@@ -9,9 +9,11 @@
  * 2. 认证通过后发送 IpcRequest → 等待 IpcResponse
  * 3. 认证通过后自动接收 icqq 事件推送（IpcEvent），断开连接自动停止
  *
- * 登录相关：**推送**走 IpcEvent（`system.login.*`），续传 invoke 见 `login-ipc-contract.ts`。
+ * 登录相关：**推送**走 IpcEvent（`system.login.*`）。
  */
 
+import { pickCredential } from '@zhin.js/adapter';
+
 /** CLI → Daemon 请求 */
 export type IpcRequest = {
   id: string;
@@ -265,3 +267,191 @@ export const Actions = {
   SET_NOTIFY: "set_notify",
   GET_NOTIFY: "get_notify",
 } as const;
+
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface IcqqAdapterConfig {
+  readonly name?: string;
+  readonly autoReconnect?: boolean;
+  readonly outboundMedia?: 'file' | 'base64';
+  readonly rpc?: {
+    readonly host?: string;
+    readonly port?: number;
+    readonly token?: string;
+  };
+  /** Transitional: legacy root `endpoints[]` with `context: icqq`. */
+  readonly endpoints?: ReadonlyArray<{
+    readonly context?: string;
+    readonly name?: string;
+    readonly autoReconnect?: boolean;
+    readonly outboundMedia?: 'file' | 'base64';
+    readonly rpc?: {
+      readonly host?: string;
+      readonly port?: number;
+      readonly token?: string;
+    };
+  }>;
+}
+
+export interface ResolvedIcqqConfig {
+  readonly context: 'icqq';
+  readonly name: string;
+  readonly autoReconnect: boolean;
+  readonly outboundMedia?: 'file' | 'base64';
+  readonly rpc?: {
+    readonly host: string;
+    readonly port: number;
+    readonly token: string;
+  };
+}
+
+export interface IcqqWireSegment {
+  readonly type: string;
+  readonly data?: Record<string, unknown>;
+}
+
+export interface IcqqInboundMessage {
+  readonly id: string;
+  readonly target: string;
+  readonly content: string;
+  readonly sender: string;
+  readonly channelType: 'private' | 'group' | 'channel';
+  readonly metadata?: Record<string, unknown>;
+}
+
+export type ParsedIcqqSendTarget =
+  | { readonly kind: 'private'; readonly userId: number }
+  | { readonly kind: 'group'; readonly groupId: number }
+  | { readonly kind: 'temp'; readonly groupId: number; readonly userId: number }
+  | { readonly kind: 'channel'; readonly guildId: string; readonly channelId: string };
+
+export function resolveIcqqConfig(config: IcqqAdapterConfig = {}): ResolvedIcqqConfig {
+  const entry = config.endpoints?.find((item) => item.context === 'icqq');
+  const name = pickCredential(config.name, entry?.name, process.env.ICQQ_ACCOUNT);
+  if (!/^\d+$/.test(name)) {
+    throw new TypeError(
+      'ICQQ adapter requires numeric name (QQ uin) via plugins.<key>.name or ICQQ_ACCOUNT',
+    );
+  }
+  const autoReconnect = config.autoReconnect ?? entry?.autoReconnect ?? true;
+  const outboundMedia = config.outboundMedia ?? entry?.outboundMedia;
+  const rpcRaw = config.rpc ?? entry?.rpc;
+  const rpc = rpcRaw?.host && rpcRaw.port != null && rpcRaw.token
+    ? { host: rpcRaw.host, port: Number(rpcRaw.port), token: rpcRaw.token }
+    : undefined;
+  return {
+    context: 'icqq',
+    name,
+    autoReconnect,
+    ...(outboundMedia ? { outboundMedia } : {}),
+    ...(rpc ? { rpc } : {}),
+  };
+}
+
+/** Gateway reply target: `private:uid` / `group:gid` / `temp:gid:uid` / `channel:guild:channel`. */
+export function formatInboundTarget(input: {
+  readonly channelType: 'private' | 'group' | 'channel';
+  readonly channelId: string;
+  readonly channelParentGroupId?: string;
+  readonly guildId?: string;
+}): string {
+  if (input.channelType === 'private' && input.channelParentGroupId) {
+    return `temp:${input.channelParentGroupId}:${input.channelId}`;
+  }
+  if (input.channelType === 'channel' && input.guildId) {
+    return `channel:${input.guildId}:${input.channelId}`;
+  }
+  return `${input.channelType}:${input.channelId}`;
+}
+
+export function parseSendTarget(target: string): ParsedIcqqSendTarget {
+  const trimmed = target.trim();
+  if (trimmed.startsWith('temp:')) {
+    const rest = trimmed.slice(5);
+    const [groupId, userId] = rest.split(':');
+    if (!groupId || !userId) throw new TypeError(`Invalid icqq temp target: ${target}`);
+    return { kind: 'temp', groupId: Number(groupId), userId: Number(userId) };
+  }
+  if (trimmed.startsWith('channel:')) {
+    const rest = trimmed.slice(8);
+    const idx = rest.indexOf(':');
+    if (idx <= 0) throw new TypeError(`Invalid icqq channel target: ${target}`);
+    return {
+      kind: 'channel',
+      guildId: rest.slice(0, idx),
+      channelId: rest.slice(idx + 1),
+    };
+  }
+  if (trimmed.startsWith('private:')) {
+    return { kind: 'private', userId: Number(trimmed.slice(8)) };
+  }
+  if (trimmed.startsWith('group:')) {
+    return { kind: 'group', groupId: Number(trimmed.slice(6)) };
+  }
+  // Bare numeric id → private (common reply path)
+  if (/^\d+$/.test(trimmed)) {
+    return { kind: 'private', userId: Number(trimmed) };
+  }
+  throw new TypeError(`Invalid icqq send target: ${target}`);
+}
+
+export function formatOutboundBody(payload: unknown): string {
+  if (typeof payload === 'string') {
+    const text = payload.trim();
+    return text || '\u200b';
+  }
+  if (payload == null) return '\u200b';
+  if (!Array.isArray(payload)) {
+    // 单个段对象（非数组）按单元素数组处理，杜绝 String(object) → '[object Object]'
+    if (isWireSegment(payload)) {
+      return formatOutboundBody([payload]);
+    }
+    if (typeof payload === 'object' && payload !== null && 'text' in payload) {
+      const text = String((payload as { text?: unknown }).text ?? '').trim();
+      return text || '\u200b';
+    }
+    const text = String(payload).trim();
+    return text || '\u200b';
+  }
+  const joined = payload.map((seg) => {
+    if (typeof seg === 'string') return seg;
+    const item = seg as IcqqWireSegment;
+    switch (item.type) {
+      case 'text':
+        return String(item.data?.text ?? '');
+      case 'at':
+      case 'mention':
+        return `[at:${item.data?.qq ?? item.data?.id ?? item.data?.target ?? ''}]`;
+      case 'image':
+        return `[image:${item.data?.file || item.data?.url || base64Media(item.data) || ''}]`;
+      case 'face':
+        return `[face:${item.data?.id ?? ''}]`;
+      case 'reply':
+        return `[reply:${item.data?.message_id ?? item.data?.id ?? ''}]`;
+      case 'record':
+      case 'audio':
+        return `[record:${item.data?.file || item.data?.url || base64Media(item.data) || ''}]`;
+      case 'video':
+        return `[video:${item.data?.file || item.data?.url || base64Media(item.data) || ''}]`;
+      default:
+        return String(item.data?.text ?? '');
+    }
+  }).join('').trim();
+  return joined || '\u200b';
+}
+
+export function formatInboundContent(rawMessage: string): string {
+  return rawMessage;
+}
+
+/** base64 媒体回退：CQ `base64://` 由守护进程解码（异机 RPC 场景）。 */
+function base64Media(data: Record<string, unknown> | undefined): string | undefined {
+  const b64 = data?.base64;
+  return typeof b64 === 'string' && b64 ? `base64://${b64}` : undefined;
+}
+
+/** 段对象判定：`{ type: string, data? }`（非数组 payload 的防御入口）。 */
+function isWireSegment(value: unknown): value is IcqqWireSegment {
+  return typeof value === 'object'
+    && value !== null
+    && typeof (value as { type?: unknown }).type === 'string';
+}

package/src/types.ts

@@ -76,3 +76,19 @@ export interface IpcMemberInfo {
   last_sent_time?: number;
   shutup_time?: number;
 }
+
+/**
+ * GET_SYSTEM_MSG 归一后的待处理请求（@icqqjs/cli NormalizedSystemMessage）。
+ * friendRequests 与 groupRequests 均为该形状，按 flag 处理。
+ */
+export interface IpcSystemMessage {
+  type: string;
+  user_id?: number;
+  nickname?: string;
+  group_id?: number;
+  group_name?: string;
+  comment?: string;
+  flag?: string;
+  seq?: number;
+  time?: number;
+}