@zhin.js/adapter-icqq 6.0.2 → 7.0.0

package/lib/protocol.d.ts

@@ -0,0 +1,269 @@
+/**
+ * IPC 协议类型定义与 Action 常量 (ported from @icqqjs/cli)
+ *
+ * CLI 与守护进程通过 Unix Domain Socket 通信，
+ * 使用 JSON + 换行符（\n）分隔的文本协议。
+ *
+ * 通信流程（@icqqjs/cli `src/daemon/protocol.ts`）：
+ * 1. CLI 连接 Socket → auth（token）
+ * 2. 认证通过后发送 IpcRequest → 等待 IpcResponse
+ * 3. 认证通过后自动接收 icqq 事件推送（IpcEvent），断开连接自动停止
+ *
+ * 登录相关：**推送**走 IpcEvent（`system.login.*`）。
+ */
+/** CLI → Daemon 请求 */
+export type IpcRequest = {
+    id: string;
+    action: string;
+    params: Record<string, unknown>;
+};
+/** Daemon → CLI 响应 */
+export type IpcResponse = {
+    id: string;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+};
+/**
+ * Daemon → CLI 事件推送（icqq client.em 分发的全部事件）
+ *
+ * 登录/重连时推送 `system.login.*`（如 `system.login.auth` 含 url + device），
+ * 语义在 `event` 字段，不在 OneBot 式 `post_type` 里。
+ */
+export type IpcEvent = {
+    /** 固定为 `"*"`，客户端应忽略，由本地 handler 按 `event` 过滤 */
+    id: string;
+    /** icqq 事件名，如 `system.login.auth`、`message.group.normal` */
+    event: string;
+    /** icqq 事件 toJSON 后的 plain object */
+    data: unknown;
+};
+export type IpcMessage = IpcResponse | IpcEvent;
+export type { IcqqIpcMessageEvent } from "./icqq-inbound.js";
+/** 从 IPC 入站 payload 解析可用于引用/撤回的消息 ID */
+export { resolveIcqqInboundMessageId } from "./icqq-inbound.js";
+/** Guild 消息事件数据 */
+export interface IpcGuildMessageEventData {
+    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;
+}
+/**
+ * 所有 IPC 操作常量 (from @icqqjs/cli)
+ */
+export declare const Actions: {
+    readonly PING: "ping";
+    readonly LOGOUT: "logout";
+    readonly LIST_FRIENDS: "list_friends";
+    readonly LIST_GROUPS: "list_groups";
+    readonly LIST_GROUP_MEMBERS: "list_group_members";
+    readonly LIST_BLACKLIST: "list_blacklist";
+    readonly LIST_FRIEND_CLASSES: "list_friend_classes";
+    readonly GET_FRIEND_INFO: "get_friend_info";
+    readonly GET_GROUP_INFO: "get_group_info";
+    readonly GET_GROUP_MEMBER_INFO: "get_group_member_info";
+    readonly GET_STRANGER_INFO: "get_stranger_info";
+    readonly LIST_STRANGERS: "list_strangers";
+    readonly GET_PROFILE: "get_profile";
+    readonly GET_STATUS: "get_status";
+    readonly GET_ONLINE_STATUS: "get_online_status";
+    readonly GET_SELF_PROFILE: "get_self_profile";
+    readonly SEND_PRIVATE_MSG: "send_private_msg";
+    readonly SEND_GROUP_MSG: "send_group_msg";
+    readonly RECALL_MSG: "recall_msg";
+    readonly GET_MSG: "get_msg";
+    readonly HISTORY_PRIVATE: "history_private";
+    readonly HISTORY_GROUP: "history_group";
+    readonly HISTORY_BY_MSG_ID: "history_by_msg_id";
+    readonly SEND_LONG_MSG: "send_long_msg";
+    readonly MARK_READ: "mark_read";
+    readonly DELETE_MSG: "delete_msg";
+    readonly SET_NICKNAME: "set_nickname";
+    readonly SET_GENDER: "set_gender";
+    readonly SET_BIRTHDAY: "set_birthday";
+    readonly SET_SIGNATURE: "set_signature";
+    readonly SET_DESCRIPTION: "set_description";
+    readonly SET_AVATAR: "set_avatar";
+    readonly SET_ONLINE_STATUS: "set_online_status";
+    readonly SET_GROUP_NAME: "set_group_name";
+    readonly SET_GROUP_AVATAR: "set_group_avatar";
+    readonly SET_GROUP_CARD: "set_group_card";
+    readonly SET_GROUP_TITLE: "set_group_title";
+    readonly SET_GROUP_ADMIN: "set_group_admin";
+    readonly SET_GROUP_REMARK: "set_group_remark";
+    readonly GROUP_MUTE: "group_mute";
+    readonly GROUP_MUTE_ALL: "group_mute_all";
+    readonly GROUP_KICK: "group_kick";
+    readonly GROUP_QUIT: "group_quit";
+    readonly GROUP_INVITE: "group_invite";
+    readonly GROUP_POKE: "group_poke";
+    readonly GROUP_ANNOUNCE: "group_announce";
+    readonly GROUP_SIGN: "group_sign";
+    readonly GROUP_ESSENCE_ADD: "group_essence_add";
+    readonly GROUP_ESSENCE_REMOVE: "group_essence_remove";
+    readonly GROUP_ALLOW_ANONY: "group_allow_anony";
+    readonly GROUP_MUTED_LIST: "group_muted_list";
+    readonly GROUP_AT_ALL_REMAIN: "group_at_all_remain";
+    readonly FRIEND_POKE: "friend_poke";
+    readonly FRIEND_LIKE: "friend_like";
+    readonly FRIEND_DELETE: "friend_delete";
+    readonly FRIEND_REMARK: "friend_remark";
+    readonly FRIEND_CLASS: "friend_class";
+    readonly GET_SYSTEM_MSG: "get_system_msg";
+    readonly HANDLE_FRIEND_REQUEST: "handle_friend_request";
+    readonly HANDLE_GROUP_REQUEST: "handle_group_request";
+    readonly ADD_FRIEND_CLASS: "add_friend_class";
+    readonly DELETE_FRIEND_CLASS: "delete_friend_class";
+    readonly RENAME_FRIEND_CLASS: "rename_friend_class";
+    readonly GFS_LIST: "gfs_list";
+    readonly GFS_INFO: "gfs_info";
+    readonly GFS_MKDIR: "gfs_mkdir";
+    readonly GFS_DELETE: "gfs_delete";
+    readonly GFS_RENAME: "gfs_rename";
+    readonly GFS_STAT: "gfs_stat";
+    readonly GFS_MOVE: "gfs_move";
+    readonly GFS_DOWNLOAD: "gfs_download";
+    readonly IMAGE_OCR: "image_ocr";
+    readonly RELOAD_FRIEND_LIST: "reload_friend_list";
+    readonly RELOAD_GROUP_LIST: "reload_group_list";
+    readonly CLEAN_CACHE: "clean_cache";
+    readonly GET_GROUP_SHARE: "get_group_share";
+    readonly GROUP_SET_JOIN_TYPE: "group_set_join_type";
+    readonly GROUP_SET_RATE_LIMIT: "group_set_rate_limit";
+    readonly GROUP_MUTE_ANONY: "group_mute_anony";
+    readonly GROUP_ANON_INFO: "group_anon_info";
+    readonly ADD_FRIEND: "add_friend";
+    readonly SEND_TEMP_MSG: "send_temp_msg";
+    readonly GET_ROAMING_STAMP: "get_roaming_stamp";
+    readonly DELETE_STAMP: "delete_stamp";
+    readonly SEND_PRIVATE_FILE: "send_private_file";
+    readonly SEND_GROUP_FILE: "send_group_file";
+    readonly FRIEND_RECALL_FILE: "friend_recall_file";
+    readonly FRIEND_FORWARD_FILE: "friend_forward_file";
+    readonly SEARCH_SAME_GROUP: "search_same_group";
+    readonly SEND_CONTACT_SHARE: "send_contact_share";
+    readonly GFS_UPLOAD: "gfs_upload";
+    readonly GROUP_SET_REACTION: "group_set_reaction";
+    readonly GROUP_DEL_REACTION: "group_del_reaction";
+    readonly GET_FORWARD_MSG: "get_forward_msg";
+    readonly MAKE_FORWARD_MSG: "make_forward_msg";
+    readonly GUILD_LIST: "guild_list";
+    readonly GUILD_INFO: "guild_info";
+    readonly GUILD_CHANNELS: "guild_channels";
+    readonly GET_CHANNEL_INFO: "get_channel_info";
+    readonly GUILD_MEMBERS: "guild_members";
+    readonly GUILD_SEND_MSG: "guild_send_msg";
+    readonly GUILD_RECALL_MSG: "guild_recall_msg";
+    readonly GET_FILE_INFO: "get_file_info";
+    readonly GET_FILE_URL: "get_file_url";
+    readonly GET_AVATAR_URL: "get_avatar_url";
+    readonly GET_GROUP_AVATAR_URL: "get_group_avatar_url";
+    readonly SET_SCREEN_MEMBER_MSG: "set_screen_member_msg";
+    readonly GFS_FORWARD: "gfs_forward";
+    readonly GFS_FORWARD_OFFLINE: "gfs_forward_offline";
+    readonly RELOAD_BLACKLIST: "reload_blacklist";
+    readonly RELOAD_STRANGER_LIST: "reload_stranger_list";
+    readonly RELOAD_GUILDS: "reload_guilds";
+    readonly GET_STATUS_INFO: "get_status_info";
+    readonly GET_CLIENT_KEY: "get_client_key";
+    readonly GET_PSKEY: "get_pskey";
+    readonly UID2UIN: "uid2uin";
+    readonly UID2UINS: "uid2uins";
+    readonly UIN2UID: "uin2uid";
+    readonly UIN2UIDS: "uin2uids";
+    readonly GET_COOKIES: "get_cookies";
+    readonly GET_CSRF_TOKEN: "get_csrf_token";
+    readonly REFRESH_NT_PIC_RKEY: "refresh_nt_pic_rkey";
+    readonly SEND_DISCUSS_MSG: "send_discuss_msg";
+    readonly GET_VIDEO_URL: "get_video_url";
+    readonly GET_ADD_FRIEND_SETTING: "get_add_friend_setting";
+    readonly GET_FORUM_URL: "get_forum_url";
+    readonly GUILD_CHANNEL_SHARE: "guild_channel_share";
+    readonly GET_PIC_URL: "get_pic_url";
+    readonly GET_PTT_URL: "get_ptt_url";
+    readonly SUBSCRIBE: "subscribe";
+    readonly UNSUBSCRIBE: "unsubscribe";
+    readonly SET_WEBHOOK: "set_webhook";
+    readonly GET_WEBHOOK: "get_webhook";
+    readonly SET_NOTIFY: "set_notify";
+    readonly GET_NOTIFY: "get_notify";
+};
+/** 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 declare function resolveIcqqConfig(config?: IcqqAdapterConfig): ResolvedIcqqConfig;
+/** Gateway reply target: `private:uid` / `group:gid` / `temp:gid:uid` / `channel:guild:channel`. */
+export declare function formatInboundTarget(input: {
+    readonly channelType: 'private' | 'group' | 'channel';
+    readonly channelId: string;
+    readonly channelParentGroupId?: string;
+    readonly guildId?: string;
+}): string;
+export declare function parseSendTarget(target: string): ParsedIcqqSendTarget;
+export declare function formatOutboundBody(payload: unknown): string;
+export declare function formatInboundContent(rawMessage: string): string;

package/lib/{src/protocol.js → protocol.js}

@@ -9,8 +9,9 @@
  * 2. 认证通过后发送 IpcRequest → 等待 IpcResponse
  * 3. 认证通过后自动接收 icqq 事件推送（IpcEvent），断开连接自动停止
  *
- * 登录相关：**推送**走 IpcEvent（`system.login.*`），续传 invoke 见 `login-ipc-contract.ts`。
+ * 登录相关：**推送**走 IpcEvent（`system.login.*`）。
  */
+import { pickCredential } from '@zhin.js/adapter';
 /** 从 IPC 入站 payload 解析可用于引用/撤回的消息 ID */
 export { resolveIcqqInboundMessageId } from "./icqq-inbound.js";
 /**
@@ -184,4 +185,125 @@ export const Actions = {
     SET_NOTIFY: "set_notify",
     GET_NOTIFY: "get_notify",
 };
-//# sourceMappingURL=protocol.js.map
+export function resolveIcqqConfig(config = {}) {
+    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) {
+    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) {
+    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) {
+    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.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;
+        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) {
+    return rawMessage;
+}
+/** base64 媒体回退：CQ `base64://` 由守护进程解码（异机 RPC 场景）。 */
+function base64Media(data) {
+    const b64 = data?.base64;
+    return typeof b64 === 'string' && b64 ? `base64://${b64}` : undefined;
+}
+/** 段对象判定：`{ type: string, data? }`（非数组 payload 的防御入口）。 */
+function isWireSegment(value) {
+    return typeof value === 'object'
+        && value !== null
+        && typeof value.type === 'string';
+}

package/lib/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ICQQ 适配器类型与配置
+ *
+ * 不再直接依赖 @icqqjs/icqq，通过 @icqqjs/cli 守护进程 IPC 通信。
+ */
+export type GroupRole = "owner" | "admin" | "member";
+export interface IcqqSenderInfo {
+    id: string;
+    name: string;
+    role?: GroupRole;
+    isOwner?: boolean;
+    isAdmin?: boolean;
+    permissions?: string[];
+    card?: string;
+    title?: string;
+}
+/**
+ * Endpoint 配置：支持本地 IPC 和远程 RPC 两种连接模式。
+ *
+ * - 本地模式（默认）：只需 name（QQ号），自动连接 ~/.icqq/<uin>/daemon.sock
+ * - 远程模式：额外配置 rpc.host / rpc.port / rpc.token
+ */
+export interface IcqqEndpointConfig {
+    context: "icqq";
+    /** QQ 号码字符串 */
+    name: `${number}`;
+    /** RPC 远程连接配置（不配置则使用本地 IPC） */
+    rpc?: {
+        /** 远程主机地址 */
+        host: string;
+        /** 远程端口 */
+        port: number;
+        /** 认证 token（用于 HMAC-SHA256 挑战-响应，不会明文传输） */
+        token: string;
+    };
+    /**
+     * IPC/RPC 与守护进程连接意外断开时是否自动重连（指数退避，上限约 30s）。
+     * 默认 true；设为 false 则断开后仅将 `$connected` 置为 false，需手动重连。
+     */
+    autoReconnect?: boolean;
+    /**
+     * 出站图片/语音/视频：file=本机临时文件路径（需与 icqq 守护进程同机可读）；
+     * base64=经 CQ `base64://` 交给守护进程解码（Zhin 与 icqq 异进程/异机时用，配置 rpc 时默认 base64）。
+     */
+    outboundMedia?: "file" | "base64";
+}
+/** IPC 返回的好友信息 */
+export interface IpcFriendInfo {
+    user_id: number;
+    nickname: string;
+    remark?: string;
+    class_id?: number;
+}
+/** IPC 返回的群信息 */
+export interface IpcGroupInfo {
+    group_id: number;
+    group_name: string;
+    member_count: number;
+    max_member_count: number;
+    owner_id?: number;
+}
+/** IPC 返回的群成员信息 */
+export interface IpcMemberInfo {
+    user_id: number;
+    nickname: string;
+    card: string;
+    role: GroupRole;
+    title: string;
+    join_time?: number;
+    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;
+}

package/lib/{src/types.js → types.js}

@@ -4,4 +4,3 @@
  * 不再直接依赖 @icqqjs/icqq，通过 @icqqjs/cli 守护进程 IPC 通信。
  */
 export {};
-//# sourceMappingURL=types.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "6.0.2",
-  "description": "Zhin.js adapter for ICQQ (QQ Bot)",
+  "version": "7.0.0",
+  "description": "Zhin.js ICQQ adapter for Plugin Runtime (IPC daemon client)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -33,60 +33,49 @@
     "type": "git",
     "directory": "plugins/adapters/icqq"
   },
-  "files": [
-    "src",
-    "lib",
-    "client",
-    "dist",
-    "plugin.yml",
-    "README.md",
-    "CHANGELOG.md",
-    "agent"
-  ],
-  "devDependencies": {
-    "@radix-ui/themes": "^3.2.1",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.22.0",
-    "radix-ui": "^1.6.2",
-    "typescript": "^6.0.3",
-    "zod": "^4.4.3",
-    "@zhin.js/agent": "1.0.3",
-    "@zhin.js/cli": "1.0.93",
-    "@zhin.js/client": "2.0.5",
-    "@zhin.js/contract": "1.0.3",
-    "@zhin.js/core": "1.3.4",
-    "@zhin.js/host-api": "2.0.5",
-    "@zhin.js/host-router": "2.0.3",
-    "zhin.js": "4.1.2"
+  "dependencies": {
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/logger": "1.0.75",
+    "@zhin.js/plugin-runtime": "1.1.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/agent": "1.0.3",
-    "@zhin.js/client": "2.0.5",
-    "@zhin.js/host-api": "2.0.5",
-    "@zhin.js/contract": "1.0.3",
-    "@zhin.js/core": "1.3.4",
-    "@zhin.js/host-router": "2.0.3",
-    "zhin.js": "4.1.2"
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/agent": "1.0.5",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/plugin-runtime": "1.1.0",
+    "zhin.js": "5.0.0"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
-    "@zhin.js/client": {
-      "optional": true
-    },
-    "@zhin.js/host-router": {
+    "zhin.js": {
       "optional": true
     },
-    "@zhin.js/host-api": {
+    "@zhin.js/agent": {
       "optional": true
     },
     "zod": {
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/agent": "1.0.5",
+    "zhin.js": "5.0.0"
+  },
+  "files": [
+    "adapters",
+    "plugin.ts",
+    "schema.json",
+    "src",
+    "lib",
+    "agent",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -94,8 +83,23 @@
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "zhin build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/icqq/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,32 @@
+import { definePlugin } from '@zhin.js/plugin-runtime';
+
+// Module-level guard: multiple icqq instances (icqq, icqq-2, …) share this
+// module, but the prompt contributor is per-platform — register it once.
+let promptContributorRegistered = false;
+
+export default definePlugin({
+  name: 'icqq',
+  metadata: {
+    displayName: 'ICQQ Adapter',
+  },
+  setup() {
+    // Agent prompt contributor (orchestrator/deferred-worker ICQQ guidance).
+    // `zhin.js/agent` is an optional peer — skip silently on IM-only installs.
+    if (promptContributorRegistered) return;
+    let cancelled = false;
+    let unregister: (() => void) | undefined;
+    void Promise.all([
+      import('zhin.js/agent'),
+      import('./src/agent-prompt.js'),
+    ]).then(([agent, prompt]) => {
+      if (cancelled || promptContributorRegistered) return;
+      agent.registerAgentPromptContributor(prompt.createIcqqAgentPromptContributor());
+      promptContributorRegistered = true;
+      unregister = () => agent.unregisterAgentPromptContributor('icqq');
+    }).catch(() => { /* optional peer not installed */ });
+    return () => {
+      cancelled = true;
+      unregister?.();
+    };
+  },
+});