@zhin.js/adapter-icqq 1.0.70 → 1.1.0

package/src/protocol.ts

@@ -0,0 +1,575 @@
+import { pickCredential } from 'zhin.js/adapter';
+import type { MessageElem, Sendable } from '@icqqjs/icqq';
+import type { ConversationRef } from '@zhin.js/im-contract';
+import type { MessageSegment } from "zhin.js";
+import { resolveIcqqMediaFile } from "./cq-message.js";
+
+export type ActionResult = {
+  id: string;
+  ok: boolean;
+  data?: unknown;
+  error?: string;
+};
+
+export type { IcqqMessageEvent } from "./icqq-inbound.js";
+
+export { resolveIcqqInboundMessageId } from "./icqq-inbound.js";
+
+export interface GuildMessageEventData {
+  type: "guild";
+  guild_id: string;
+  guild_name: string;
+  channel_id: string;
+  channel_name: string;
+  nickname: string;
+  tiny_id: string;
+  raw_message: string;
+  time: number;
+  seq: number;
+}
+
+/**
+ * 所有操作常量（@icqqjs/icqq）
+ */
+export const Actions = {
+  PING: "ping",
+  LOGOUT: "logout",
+
+  // ── 列表查询 ──
+  LIST_FRIENDS: "list_friends",
+  LIST_GROUPS: "list_groups",
+  LIST_GROUP_MEMBERS: "list_group_members",
+  LIST_BLACKLIST: "list_blacklist",
+  LIST_FRIEND_CLASSES: "list_friend_classes",
+
+  // ── 信息查询 ──
+  GET_FRIEND_INFO: "get_friend_info",
+  GET_GROUP_INFO: "get_group_info",
+  GET_GROUP_MEMBER_INFO: "get_group_member_info",
+  GET_STRANGER_INFO: "get_stranger_info",
+  LIST_STRANGERS: "list_strangers",
+  GET_PROFILE: "get_profile",
+  GET_STATUS: "get_status",
+  GET_ONLINE_STATUS: "get_online_status",
+  GET_SELF_PROFILE: "get_self_profile",
+
+  // ── 消息发送 ──
+  SEND_PRIVATE_MSG: "send_private_msg",
+  SEND_GROUP_MSG: "send_group_msg",
+
+  // ── 消息操作 ──
+  RECALL_MSG: "recall_msg",
+  GET_MSG: "get_msg",
+  HISTORY_PRIVATE: "history_private",
+  HISTORY_GROUP: "history_group",
+  HISTORY_BY_MSG_ID: "history_by_msg_id",
+  SEND_LONG_MSG: "send_long_msg",
+  MARK_READ: "mark_read",
+  DELETE_MSG: "delete_msg",
+
+  // ── 个人设置 ──
+  SET_NICKNAME: "set_nickname",
+  SET_GENDER: "set_gender",
+  SET_BIRTHDAY: "set_birthday",
+  SET_SIGNATURE: "set_signature",
+  SET_DESCRIPTION: "set_description",
+  SET_AVATAR: "set_avatar",
+  SET_ONLINE_STATUS: "set_online_status",
+
+  // ── 群设置 ──
+  SET_GROUP_NAME: "set_group_name",
+  SET_GROUP_AVATAR: "set_group_avatar",
+  SET_GROUP_CARD: "set_group_card",
+  SET_GROUP_TITLE: "set_group_title",
+  SET_GROUP_ADMIN: "set_group_admin",
+  SET_GROUP_REMARK: "set_group_remark",
+
+  // ── 群管理 ──
+  GROUP_MUTE: "group_mute",
+  GROUP_MUTE_ALL: "group_mute_all",
+  GROUP_KICK: "group_kick",
+  GROUP_QUIT: "group_quit",
+  GROUP_INVITE: "group_invite",
+  GROUP_POKE: "group_poke",
+  GROUP_ANNOUNCE: "group_announce",
+  GROUP_SIGN: "group_sign",
+  GROUP_ESSENCE_ADD: "group_essence_add",
+  GROUP_ESSENCE_REMOVE: "group_essence_remove",
+  GROUP_ALLOW_ANONY: "group_allow_anony",
+  GROUP_MUTED_LIST: "group_muted_list",
+  GROUP_AT_ALL_REMAIN: "group_at_all_remain",
+
+  // ── 好友操作 ──
+  FRIEND_POKE: "friend_poke",
+  FRIEND_LIKE: "friend_like",
+  FRIEND_DELETE: "friend_delete",
+  FRIEND_REMARK: "friend_remark",
+  FRIEND_CLASS: "friend_class",
+
+  // ── 系统消息/请求 ──
+  GET_SYSTEM_MSG: "get_system_msg",
+  HANDLE_FRIEND_REQUEST: "handle_friend_request",
+  HANDLE_GROUP_REQUEST: "handle_group_request",
+
+  // ── 好友分组 ──
+  ADD_FRIEND_CLASS: "add_friend_class",
+  DELETE_FRIEND_CLASS: "delete_friend_class",
+  RENAME_FRIEND_CLASS: "rename_friend_class",
+
+  // ── 群文件系统 ──
+  GFS_LIST: "gfs_list",
+  GFS_INFO: "gfs_info",
+  GFS_MKDIR: "gfs_mkdir",
+  GFS_DELETE: "gfs_delete",
+  GFS_RENAME: "gfs_rename",
+  GFS_STAT: "gfs_stat",
+  GFS_MOVE: "gfs_move",
+  GFS_DOWNLOAD: "gfs_download",
+
+  // ── 其他功能 ──
+  IMAGE_OCR: "image_ocr",
+  RELOAD_FRIEND_LIST: "reload_friend_list",
+  RELOAD_GROUP_LIST: "reload_group_list",
+  CLEAN_CACHE: "clean_cache",
+  GET_GROUP_SHARE: "get_group_share",
+
+  // ── 群管理扩展 ──
+  GROUP_SET_JOIN_TYPE: "group_set_join_type",
+  GROUP_SET_RATE_LIMIT: "group_set_rate_limit",
+  GROUP_MUTE_ANONY: "group_mute_anony",
+  GROUP_ANON_INFO: "group_anon_info",
+
+  // ── 好友操作扩展 ──
+  ADD_FRIEND: "add_friend",
+  SEND_TEMP_MSG: "send_temp_msg",
+
+  // ── 漫游表情 ──
+  GET_ROAMING_STAMP: "get_roaming_stamp",
+  DELETE_STAMP: "delete_stamp",
+
+  // ── 文件传输 ──
+  SEND_PRIVATE_FILE: "send_private_file",
+  SEND_GROUP_FILE: "send_group_file",
+  FRIEND_RECALL_FILE: "friend_recall_file",
+  FRIEND_FORWARD_FILE: "friend_forward_file",
+  SEARCH_SAME_GROUP: "search_same_group",
+  SEND_CONTACT_SHARE: "send_contact_share",
+  GFS_UPLOAD: "gfs_upload",
+
+  // ── 群消息表态 ──
+  GROUP_SET_REACTION: "group_set_reaction",
+  GROUP_DEL_REACTION: "group_del_reaction",
+
+  // ── 转发消息 ──
+  GET_FORWARD_MSG: "get_forward_msg",
+  MAKE_FORWARD_MSG: "make_forward_msg",
+
+  // ── 频道系统 ──
+  GUILD_LIST: "guild_list",
+  GUILD_INFO: "guild_info",
+  GUILD_CHANNELS: "guild_channels",
+  GET_CHANNEL_INFO: "get_channel_info",
+  GUILD_MEMBERS: "guild_members",
+  GUILD_SEND_MSG: "guild_send_msg",
+  GUILD_RECALL_MSG: "guild_recall_msg",
+
+  // ── 用户文件操作 ──
+  GET_FILE_INFO: "get_file_info",
+  GET_FILE_URL: "get_file_url",
+  GET_AVATAR_URL: "get_avatar_url",
+  GET_GROUP_AVATAR_URL: "get_group_avatar_url",
+
+  // ── 屏蔽群成员消息 ──
+  SET_SCREEN_MEMBER_MSG: "set_screen_member_msg",
+
+  // ── 群文件转发 ──
+  GFS_FORWARD: "gfs_forward",
+  GFS_FORWARD_OFFLINE: "gfs_forward_offline",
+
+  // ── 重载列表 ──
+  RELOAD_BLACKLIST: "reload_blacklist",
+  RELOAD_STRANGER_LIST: "reload_stranger_list",
+  RELOAD_GUILDS: "reload_guilds",
+
+  // ── 在线状态查询 ──
+  GET_STATUS_INFO: "get_status_info",
+
+  // ── 密钥/工具 ──
+  GET_CLIENT_KEY: "get_client_key",
+  GET_PSKEY: "get_pskey",
+  UID2UIN: "uid2uin",
+  UID2UINS: "uid2uins",
+  UIN2UID: "uin2uid",
+  UIN2UIDS: "uin2uids",
+  GET_COOKIES: "get_cookies",
+  GET_CSRF_TOKEN: "get_csrf_token",
+  REFRESH_NT_PIC_RKEY: "refresh_nt_pic_rkey",
+  SEND_DISCUSS_MSG: "send_discuss_msg",
+
+  // ── 视频/加好友设置 ──
+  GET_VIDEO_URL: "get_video_url",
+  GET_ADD_FRIEND_SETTING: "get_add_friend_setting",
+
+  // ── 频道扩展 ──
+  GET_FORUM_URL: "get_forum_url",
+  GUILD_CHANNEL_SHARE: "guild_channel_share",
+
+  // ── 获取图片/语音 URL ──
+  GET_PIC_URL: "get_pic_url",
+  GET_PTT_URL: "get_ptt_url",
+
+  // ── 消息订阅 ──
+  SUBSCRIBE: "subscribe",
+  UNSUBSCRIBE: "unsubscribe",
+
+  // ── Webhook ──
+  SET_WEBHOOK: "set_webhook",
+  GET_WEBHOOK: "get_webhook",
+
+  // ── 系统通知 ──
+  SET_NOTIFY: "set_notify",
+  GET_NOTIFY: "get_notify",
+} as const;
+
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface IcqqAdapterConfig {
+  readonly id?: string;
+  readonly autoReconnect?: boolean;
+  readonly outboundMedia?: 'file' | 'base64';
+  readonly password?: string;
+  readonly platform?: number;
+  readonly ver?: string;
+  readonly dataDir?: string;
+  readonly signApiAddr?: string;
+  readonly ignoreSelf?: boolean;
+  readonly resend?: boolean;
+  readonly cacheGroupMember?: boolean;
+  readonly autoServer?: boolean;
+  readonly qqnt?: boolean;
+  readonly ntLogin?: boolean;
+  /** Transitional: legacy root `endpoints[]` with `context: icqq`. */
+  readonly endpoints?: ReadonlyArray<{
+    readonly context?: string;
+    readonly id?: string;
+    readonly autoReconnect?: boolean;
+    readonly outboundMedia?: 'file' | 'base64';
+    readonly password?: string;
+    readonly platform?: number;
+    readonly ver?: string;
+    readonly dataDir?: string;
+    readonly signApiAddr?: string;
+    readonly ignoreSelf?: boolean;
+    readonly resend?: boolean;
+    readonly cacheGroupMember?: boolean;
+    readonly autoServer?: boolean;
+    readonly qqnt?: boolean;
+    readonly ntLogin?: boolean;
+  }>;
+}
+
+export interface ResolvedIcqqConfig {
+  readonly context: 'icqq';
+  readonly id: string;
+  readonly autoReconnect: boolean;
+  readonly outboundMedia?: 'file' | 'base64';
+  readonly password?: string;
+  readonly platform?: number;
+  readonly ver?: string;
+  readonly dataDir?: string;
+  readonly signApiAddr?: string;
+  readonly ignoreSelf?: boolean;
+  readonly resend?: boolean;
+  readonly cacheGroupMember?: boolean;
+  readonly autoServer?: boolean;
+  readonly qqnt?: boolean;
+  readonly ntLogin?: boolean;
+}
+
+export interface IcqqWireSegment {
+  readonly type: string;
+  readonly data?: Record<string, unknown>;
+}
+
+export interface IcqqInboundMessage {
+  readonly id: string;
+  readonly conversation: ConversationRef;
+  readonly content: string;
+  /**
+   * 结构化段视图（canonical Segment，经 toCanonicalSegments 归一）。
+   * 与 content（CQ 原文纯文本视图）同源，随 gateway.receive 上送。
+   */
+  readonly segments?: readonly MessageSegment[];
+  readonly sender: { readonly id: string; readonly name?: string };
+  readonly channelType: 'private' | 'group' | 'channel';
+  readonly metadata?: Record<string, unknown>;
+  readonly replyTo?: { readonly id: string };
+}
+
+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 id = pickCredential(config.id, entry?.id, process.env.ICQQ_ACCOUNT);
+  if (!/^\d+$/.test(id)) {
+    throw new TypeError(
+      'ICQQ adapter requires numeric id (QQ uin) via plugins.<key>.id or ICQQ_ACCOUNT',
+    );
+  }
+  const autoReconnect = config.autoReconnect ?? entry?.autoReconnect ?? true;
+  const outboundMedia = config.outboundMedia ?? entry?.outboundMedia;
+  const password = config.password ?? entry?.password;
+  const platform = config.platform ?? entry?.platform ?? 2;
+  const ver = config.ver ?? entry?.ver ?? '9.1.70';
+  const dataDir = config.dataDir ?? entry?.dataDir ?? `data/icqq/${id}`;
+  const signApiAddr = config.signApiAddr ?? entry?.signApiAddr;
+  const ignoreSelf = config.ignoreSelf ?? entry?.ignoreSelf ?? true;
+  const resend = config.resend ?? entry?.resend;
+  const cacheGroupMember = config.cacheGroupMember ?? entry?.cacheGroupMember ?? true;
+  const autoServer = config.autoServer ?? entry?.autoServer ?? true;
+  const qqnt = config.qqnt ?? entry?.qqnt;
+  const ntLogin = config.ntLogin ?? entry?.ntLogin;
+  return {
+    context: 'icqq',
+    id,
+    autoReconnect,
+    ...(outboundMedia ? { outboundMedia } : {}),
+    ...(password ? { password } : {}),
+    ...(platform != null ? { platform: Number(platform) } : {}),
+    ...(ver ? { ver } : {}),
+    ...(dataDir ? { dataDir } : {}),
+    ...(signApiAddr ? { signApiAddr } : {}),
+    ...(ignoreSelf != null ? { ignoreSelf } : {}),
+    ...(resend != null ? { resend } : {}),
+    ...(cacheGroupMember != null ? { cacheGroupMember } : {}),
+    ...(autoServer != null ? { autoServer } : {}),
+    ...(qqnt != null ? { qqnt } : {}),
+    ...(ntLogin != null ? { ntLogin } : {}),
+  };
+}
+
+/**
+ * 入站归一化 → ConversationRef：群临时会话（temp）映射为群容器内的 private
+ * 会话（parent kind 'group'）；频道消息的所属 guild 进 `parent`（kind 'channel'）。
+ */
+export function icqqInboundConversation(endpointKey: string, input: {
+  readonly channelType: 'private' | 'group' | 'channel';
+  readonly channelId: string;
+  readonly channelParentGroupId?: string;
+  readonly guildId?: string;
+}): ConversationRef {
+  const endpoint = { id: endpointKey, adapter: endpointKey.split('\0')[0] ?? endpointKey };
+  if (input.channelType === 'private' && input.channelParentGroupId) {
+    return {
+      endpoint,
+      kind: 'private',
+      id: input.channelId,
+      parent: { kind: 'group', id: input.channelParentGroupId },
+    };
+  }
+  if (input.channelType === 'channel' && input.guildId) {
+    return {
+      endpoint,
+      kind: 'channel',
+      id: input.channelId,
+      parent: { kind: 'channel', id: input.guildId },
+    };
+  }
+  return { endpoint, kind: input.channelType, id: input.channelId };
+}
+
+/**
+ * 出站：从 ConversationRef 派生 action 路由。
+ * 群容器（parent kind 'group'）内的 private 会话即 ICQQ 群临时会话（temp）。
+ */
+export function icqqOutboundTarget(conversation: ConversationRef): ParsedIcqqSendTarget {
+  if (conversation.kind === 'private' && conversation.parent?.kind === 'group') {
+    return {
+      kind: 'temp',
+      groupId: Number(conversation.parent.id),
+      userId: Number(conversation.id),
+    };
+  }
+  if (conversation.kind === 'private') {
+    return { kind: 'private', userId: Number(conversation.id) };
+  }
+  if (conversation.kind === 'group') {
+    return { kind: 'group', groupId: Number(conversation.id) };
+  }
+  const guildId = conversation.parent?.kind === 'channel' ? conversation.parent.id : undefined;
+  if (!guildId) {
+    throw new TypeError(`Invalid icqq channel conversation (missing guild parent): ${conversation.id}`);
+  }
+  return { kind: 'channel', guildId, channelId: conversation.id };
+}
+
+const ICQQ_STANDALONE_ELEMENTS = new Set([
+  'record',
+  'video',
+  'file',
+  'json',
+  'long_msg',
+] as const);
+
+/**
+ * Project canonical Zhin segments directly into the native ICQQ Sendable
+ * algebra. ICQQ's direct client does not parse Zhin's historical `[image:x]`
+ * notation; passing that notation would send it as literal text.
+ */
+export function formatOutboundBody(payload: unknown): Sendable {
+  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 elements = payload.flatMap<string | MessageElem>((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': {
+        const target = item.data?.qq ?? item.data?.id ?? item.data?.target;
+        if (target === 'all') return { type: 'at', qq: 'all' };
+        const qq = Number(target);
+        if (!Number.isSafeInteger(qq) || qq <= 0) {
+          throw new TypeError(`Invalid ICQQ mention target: ${String(target ?? '')}`);
+        }
+        return { type: 'at', qq };
+      }
+      case 'image': {
+        const arg = resolveIcqqMediaFile(item.data);
+        if (!arg) throw new TypeError('ICQQ image segment requires canonical data.media');
+        return { type: 'image', file: arg };
+      }
+      case 'face': {
+        const id = Number(item.data?.id);
+        if (!Number.isSafeInteger(id) || id < 0) {
+          throw new TypeError(`Invalid ICQQ face id: ${String(item.data?.id ?? '')}`);
+        }
+        return { type: 'face', id };
+      }
+      case 'reply': {
+        const id = String(item.data?.message_id ?? item.data?.id ?? '').trim();
+        if (!id) throw new TypeError('ICQQ reply segment requires message_id');
+        return { type: 'reply', id };
+      }
+      case 'record':
+      case 'audio': {
+        const arg = resolveIcqqMediaFile(item.data);
+        if (!arg) throw new TypeError('ICQQ audio segment requires canonical data.media');
+        return { type: 'record', file: arg };
+      }
+      case 'video': {
+        const arg = resolveIcqqMediaFile(item.data);
+        if (!arg) throw new TypeError('ICQQ video segment requires canonical data.media');
+        return { type: 'video', file: arg };
+      }
+      case 'file': {
+        const arg = resolveIcqqMediaFile(item.data);
+        if (!arg) throw new TypeError('ICQQ file segment requires canonical data.media');
+        const name = String(item.data?.name ?? '').trim();
+        return { type: 'file', file: arg, ...(name ? { name } : {}) };
+      }
+      case 'dice':
+        return { type: 'dice' };
+      case 'rps':
+        return { type: 'rps' };
+      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');
+        return { type: 'long_msg', resid };
+      }
+      case 'share':
+        return formatMusicShareJson(item.data);
+      default: {
+        const text = item.data?.text;
+        if (typeof text === 'string' && text) return text;
+        throw new TypeError(`Unsupported ICQQ outbound segment: ${item.type}`);
+      }
+    }
+  }).filter((element) => typeof element !== 'string' || element.length > 0);
+
+  if (elements.length === 0) return '\u200b';
+  const standalone = elements.find(
+    (element): element is MessageElem =>
+      typeof element !== 'string' && ICQQ_STANDALONE_ELEMENTS.has(element.type as never),
+  );
+  if (standalone && elements.length !== 1) {
+    throw new TypeError(`ICQQ ${standalone.type} element must be sent as a standalone message`);
+  }
+  return elements.length === 1 ? elements[0]! : elements;
+}
+
+export function formatInboundContent(rawMessage: string): string {
+  return rawMessage;
+}
+
+/** 段对象判定：`{ type: string, data? }`（非数组 payload 的防御入口）。 */
+function isWireSegment(value: unknown): value is IcqqWireSegment {
+  return typeof value === 'object'
+    && value !== null
+    && typeof (value as { type?: unknown }).type === 'string';
+}
+
+function formatMusicShareJson(data: Record<string, unknown> | undefined): MessageElem {
+  if (!data) throw new TypeError('ICQQ share segment requires data');
+  const config = data.config as {
+    appid?: number;
+    package?: string;
+    icon?: string;
+    sign?: string;
+  } | undefined;
+  const title = String(data.title ?? '');
+  const desc = String(data.artist ?? '');
+  const jumpUrl = String(data.url ?? '');
+  const musicUrl = String(data.audio ?? '');
+  const preview = String(data.image ?? '');
+  const tag = config?.appid === 100497308 ? 'QQ音乐'
+    : config?.appid === 100495085 ? '网易云音乐'
+    : config?.appid === 100243533 ? '酷我音乐'
+    : config?.appid === 205141 ? '酷狗音乐'
+    : '音乐';
+  const json = {
+    app: 'com.tencent.structmsg',
+    view: 'music',
+    ver: '0.0.0.1',
+    desc: 'music',
+    prompt: `[分享]${title}`,
+    meta: {
+      music: {
+        action: '',
+        android_pkg_name: config?.package ?? '',
+        app_type: 1,
+        appid: config?.appid ?? 0,
+        ctime: 0,
+        desc,
+        jumpUrl,
+        musicUrl,
+        preview,
+        sourceMsgId: '0',
+        source_icon: config?.icon ?? '',
+        source_url: '',
+        tag,
+        title,
+      },
+    },
+  };
+  return { type: 'json', data: json };
+}

package/src/types.ts

@@ -1,9 +1,4 @@
-/**
- * ICQQ 适配器类型与配置
- */
-import type { Config, GroupRole, MemberInfo } from "@icqqjs/icqq";
-
-export type { Config, GroupRole, MemberInfo };
+export type GroupRole = "owner" | "admin" | "member";
 
 export interface IcqqSenderInfo {
   id: string;
@@ -16,13 +11,47 @@ export interface IcqqSenderInfo {
   title?: string;
 }
 
-export interface IcqqBotConfig extends Config {
+export interface IcqqEndpointConfig {
   context: "icqq";
   name: `${number}`;
-  password?: string;
-  scope?: string;
+  autoReconnect?: boolean;
+  outboundMedia?: "file" | "base64";
+}
+
+export interface FriendInfo {
+  user_id: number;
+  nickname: string;
+  remark?: string;
+  class_id?: number;
+}
+
+export interface GroupInfo {
+  group_id: number;
+  group_name: string;
+  member_count: number;
+  max_member_count: number;
+  owner_id?: number;
+}
+
+export interface MemberInfo {
+  user_id: number;
+  nickname: string;
+  card: string;
+  role: GroupRole;
+  title: string;
+  join_time?: number;
+  last_sent_time?: number;
+  shutup_time?: number;
 }
 
-export interface IcqqBot {
-  $config: IcqqBotConfig;
+export interface SystemMessage {
+  type: string;
+  user_id?: number;
+  nickname?: string;
+  group_id?: number;
+  group_name?: string;
+  comment?: string;
+  flag?: string;
+  seq?: number;
+  time?: number;
 }

package/tools/announce.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '发送 QQ 群公告（需要管理员权限）',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        content: z.string().describe('公告内容'),
+    }),
+    adapter: 'icqq',
+    permissions: ['role(master,admin,trusted,owner)'],
+    async execute({ group_id, content }, context) {
+        await context.$client.sendGroupNotice(group_id, content);
+        return { success: true, message: '群公告已发送' };
+    },
+});

package/tools/announce.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; content: string }>({
+  description: '发送 QQ 群公告（需要管理员权限）',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    content: z.string().describe('公告内容'),
+  }),
+  adapter: 'icqq',
+  permissions: ['role(master,admin,trusted,owner)'],
+  async execute({ group_id, content }, context) {
+    await context.$client.sendGroupNotice(group_id, content);
+    return { success: true, message: '群公告已发送' };
+  },
+});

package/tools/essence.js

@@ -0,0 +1,22 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '设置或移除 QQ 群精华消息',
+    inputSchema: z.object({
+        message_id: z.string().describe('消息 ID'),
+        action: z.enum(['add', 'remove']).describe('add=设为精华, remove=移除精华'),
+    }),
+    adapter: 'icqq',
+    approval: 'always',
+    async execute({ message_id, action }, context) {
+        const client = context.$client;
+        if (action === 'add') {
+            await client.setEssenceMessage(message_id);
+        }
+        else {
+            await client.removeEssenceMessage(message_id);
+        }
+        return { success: true, message: action === 'add' ? '已设为精华' : '已移除精华' };
+    },
+});