@zhin.js/adapter-icqq 8.0.8 → 8.0.10

package/lib/forward-msg.d.ts

@@ -1,8 +1,4 @@
-/**
- * 合并转发（聊天记录）解析：从 json/xml 提取 resid，经 IPC get_forward_msg 拉取正文。
- */
 import { type MessageSegment, type QuotedMessagePayload } from 'zhin.js';
-import type { IpcClient } from "./ipc-client.js";
 import { type IcqqMessageElement } from "./icqq-inbound.js";
 /** 从 QQ 合并转发 json 元素提取 resid */
 export declare function extractForwardResidFromJsonElement(el: IcqqMessageElement): string | undefined;
@@ -16,11 +12,14 @@ export declare function extractForwardResidFromGetMsgElements(elements: IcqqMess
 export declare function extractForwardResidFromGetMsg(data: unknown): string | undefined;
 export declare function extractForwardResidFromSegments(content: MessageSegment[]): string | undefined;
 export declare function extractForwardResidFromPayload(payload: QuotedMessagePayload): string | undefined;
-/** 在 get_msg / IPC 原始对象里深度搜索 resid */
+/** 在 get_msg 原始对象里深度搜索 resid */
 export declare function extractForwardResidDeep(root: unknown, maxDepth?: number): string | undefined;
 export declare function isForwardPlaceholderPayload(payload: QuotedMessagePayload): boolean;
 /** 将 get_forward_msg 响应格式化为可读聊天记录 */
 export declare function formatForwardMsgResponse(data: unknown): string;
-export declare function fetchForwardMsgText(ipc: IpcClient, id: string): Promise<string>;
-/** 若 payload 含合并转发，拉取并追加到 content */
-export declare function enrichQuotedPayloadWithForward(ipc: IpcClient | null | undefined, payload: QuotedMessagePayload, ipcRaw?: unknown): Promise<QuotedMessagePayload>;
+export declare function fetchForwardMsgText(client: {
+    getForwardMsg(resId: string, fileName?: string): Promise<unknown[]>;
+}, id: string): Promise<string>;
+export declare function enrichQuotedPayloadWithForward(client: {
+    getForwardMsg(resId: string, fileName?: string): Promise<unknown[]>;
+} | null | undefined, payload: QuotedMessagePayload, rawData?: unknown): Promise<QuotedMessagePayload>;

package/lib/forward-msg.js

@@ -1,8 +1,4 @@
-/**
- * 合并转发（聊天记录）解析：从 json/xml 提取 resid，经 IPC get_forward_msg 拉取正文。
- */
 import { segment } from 'zhin.js';
-import { Actions } from "./protocol.js";
 import { icqqElementsToSegments, } from "./icqq-inbound.js";
 import { parseCqMessage } from "./cq-message.js";
 const RESID_IN_XML_RE = /(?:m_resid|resid|fileid|res_id)=["']?([A-Za-z0-9+/=_.-]{8,})/i;
@@ -191,7 +187,7 @@ export function extractForwardResidFromPayload(payload) {
     }
     return undefined;
 }
-/** 在 get_msg / IPC 原始对象里深度搜索 resid */
+/** 在 get_msg 原始对象里深度搜索 resid */
 export function extractForwardResidDeep(root, maxDepth = 14) {
     const seen = new Set();
     function walk(node, depth) {
@@ -336,22 +332,14 @@ export function formatForwardMsgResponse(data) {
     }
     return lines.join("\n\n");
 }
-export async function fetchForwardMsgText(ipc, id) {
-    const attempts = [
-        { message_id: id },
-        { id },
-        { resid: id },
-        { res_id: id },
-        { msg_id: id },
-    ];
-    for (const params of attempts) {
-        const resp = await ipc.request(Actions.GET_FORWARD_MSG, params);
-        if (!resp.ok)
-            continue;
-        const text = formatForwardMsgResponse(resp.data);
+export async function fetchForwardMsgText(client, id) {
+    try {
+        const messages = await client.getForwardMsg(id);
+        const text = formatForwardMsgResponse(messages);
         if (text.trim())
             return text.trim();
     }
+    catch { /* ignore */ }
     return "";
 }
 function appendForwardBlock(payload, block) {
@@ -367,19 +355,18 @@ function appendForwardBlock(payload, block) {
         content: prev ? `${prev}\n\n${block}` : block,
     };
 }
-/** 若 payload 含合并转发，拉取并追加到 content */
-export async function enrichQuotedPayloadWithForward(ipc, payload, ipcRaw) {
-    if (!ipc || hasMergedForwardBlock(payload))
+export async function enrichQuotedPayloadWithForward(client, payload, rawData) {
+    if (!client || hasMergedForwardBlock(payload))
         return payload;
     const resid = extractForwardResidFromPayload(payload) ??
-        (ipcRaw ? extractForwardResidFromGetMsg(ipcRaw) : undefined) ??
-        (ipcRaw ? extractForwardResidDeep(ipcRaw) : undefined);
+        (rawData ? extractForwardResidFromGetMsg(rawData) : undefined) ??
+        (rawData ? extractForwardResidDeep(rawData) : undefined);
     const fetchIds = [
         resid,
         isForwardPlaceholderPayload(payload) ? payload.messageId : undefined,
     ].filter((v, i, a) => !!v && a.indexOf(v) === i);
     for (const fetchId of fetchIds) {
-        const forwardText = await fetchForwardMsgText(ipc, fetchId);
+        const forwardText = await fetchForwardMsgText(client, fetchId);
         if (!forwardText.trim())
             continue;
         const block = `[Merged chat history — id ${fetchId}]\n${forwardText.trim()}`;

package/lib/icqq-agent-deps.d.ts

@@ -1,17 +1,6 @@
-/**
- * Agent tool deps for icqq.
- * Endpoints register themselves on start; tools look up by config name / QQ uin.
- */
-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>;
+import type { Client } from '@icqqjs/icqq';
+export interface IcqqAgentEndpoint extends Client {
+    readonly endpointName: string;
 }
 export interface IcqqAgentDeps {
     getEndpoint: (endpointKey: string) => IcqqAgentEndpoint;
@@ -20,6 +9,5 @@ export interface IcqqAgentDeps {
     };
 }
 export declare function registerIcqqAgentEndpoint(endpointKey: string, endpoint: IcqqAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
 export declare function setIcqqAgentDeps(deps: IcqqAgentDeps | null): void;
 export declare function getIcqqAgentDeps(): IcqqAgentDeps;

package/lib/icqq-agent-deps.js

@@ -1,7 +1,3 @@
-/**
- * Agent tool deps for icqq.
- * Endpoints register themselves on start; tools look up by config name / QQ uin.
- */
 const endpoints = new Map();
 let override = null;
 export function registerIcqqAgentEndpoint(endpointKey, endpoint) {
@@ -12,7 +8,6 @@ export function registerIcqqAgentEndpoint(endpointKey, endpoint) {
         }
     };
 }
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
 export function setIcqqAgentDeps(deps) {
     override = deps;
 }

package/lib/icqq-endpoint-commands.js

@@ -1,12 +1,3 @@
-/**
- * `icqq.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- *
- * ICQQ 的凭据由外部守护进程（@icqqjs/cli）按账号持有（~/.icqq/<uin>/），
- * 其 IPC/RPC 协议是「按 uin 连接 + auth + 账号级 action」，没有 add-account /
- * 触发 login 的 action——扫码登录只能经 `icqq login <uin>` CLI 完成。
- * 因此 add 不走 kv 凭据录入，而是 bindFlow：校验 uin、把 { id: '<uin>' }
- * 追加到 plugins.icqq.endpoints，并引导用户先完成守护进程登录。
- */
 import { addEndpointToConfig, createEndpointCommands } from '@zhin.js/adapter';
 import { defineCommand } from '@zhin.js/command';
 import { icqqRuntimeStateToken } from './icqq-runtime-state.js';
@@ -14,11 +5,11 @@ export const icqqEndpointCommands = createEndpointCommands({
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
     running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
-    describeEntry: (entry) => (entry.rpc ? 'rpc（远程守护进程）' : 'ipc（本地守护进程）'),
-    addDescription: '登记 ICQQ endpoint（uin 需先经 icqq login 完成扫码登录；重启 zhin 生效）',
+    describeEntry: () => 'direct（直连 @icqqjs/icqq）',
+    addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
     bindFlow: ({ id }) => {
         if (!id) {
-            return '用法：icqq.endpoint add <uin>（uin 为纯数字 QQ 号，且需先执行 icqq login <uin> 完成扫码登录）';
+            return '用法：icqq.endpoint add <uin>（uin 为纯数字 QQ 号）';
         }
         if (!/^\d+$/.test(id)) {
             return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
@@ -26,7 +17,7 @@ export const icqqEndpointCommands = createEndpointCommands({
         try {
             const filePath = addEndpointToConfig('icqq', { id });
             return (`✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
-                `⚠️ 请确保已执行 icqq login ${id} 启动守护进程并完成扫码登录；重启 zhin 后生效。`);
+                `重启 zhin 后生效。`);
         }
         catch (error) {
             return `添加失败：${error instanceof Error ? error.message : String(error)}`;

package/lib/icqq-guild.d.ts

@@ -2,12 +2,16 @@
  * ICQQ guild (QQ 频道) catalog sync, inbound normalize, Console channel list.
  */
 import { type MessageSegment } from "zhin.js";
-import { type IpcGuildMessageEventData } from "./protocol.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;
+import type { GuildMessageEventData } from "./protocol.js";
+export interface IcqqGuildClient {
+    getGuildList(): Array<{
+        guild_id: string;
+        guild_name: string;
+    }>;
+    getChannelList(guildId: string): Array<{
+        guild_id: string;
+        channel_id: string;
+        channel_name: string;
     }>;
 }
 export interface IcqqGuildChannelEntry {
@@ -27,14 +31,14 @@ export interface NormalizedIcqqGuildInbound {
     content: MessageSegment[];
     rawMessage: string;
     timestampMs: number;
-    raw: IpcGuildMessageEventData;
+    raw: GuildMessageEventData;
 }
 export declare class IcqqGuildCatalog {
     private readonly channels;
     private readonly guilds;
     clear(): void;
-    syncAll(ipc: IcqqGuildRpc): Promise<void>;
-    upsertFromInbound(data: IpcGuildMessageEventData): void;
+    syncAll(client: IcqqGuildClient): Promise<void>;
+    upsertFromInbound(data: GuildMessageEventData): void;
     getGuildChannelList(): Array<{
         id: string;
         name: string;
@@ -49,5 +53,5 @@ export declare class IcqqGuildCatalog {
         parentName?: string;
     };
 }
-export declare function isIcqqGuildIpcEvent(eventName: string | undefined): boolean;
-export declare function normalizeIcqqGuildInboundMessage(data: IpcGuildMessageEventData & Record<string, unknown>): NormalizedIcqqGuildInbound | null;
+export declare function isIcqqGuildEvent(eventName: string | undefined): boolean;
+export declare function normalizeIcqqGuildInboundMessage(data: GuildMessageEventData & Record<string, unknown>): NormalizedIcqqGuildInbound | null;

package/lib/icqq-guild.js

@@ -2,7 +2,6 @@
  * ICQQ guild (QQ 频道) catalog sync, inbound normalize, Console channel list.
  */
 import { toCanonicalSegments } from "zhin.js";
-import { Actions } from "./protocol.js";
 import { parseCqMessage } from "./cq-message.js";
 export class IcqqGuildCatalog {
     channels = new Map();
@@ -11,27 +10,20 @@ export class IcqqGuildCatalog {
         this.channels.clear();
         this.guilds.clear();
     }
-    async syncAll(ipc) {
-        const listResp = await ipc.request(Actions.GUILD_LIST);
-        if (!listResp.ok)
-            return;
-        const guildRows = Array.isArray(listResp.data) ? listResp.data : [];
+    async syncAll(client) {
+        const guildRows = client.getGuildList();
         for (const row of guildRows) {
-            const rec = row;
-            const guild_id = String(rec.guild_id ?? rec.id ?? "");
+            const guild_id = String(row.guild_id ?? "");
             if (!guild_id)
                 continue;
-            const guild_name = String(rec.guild_name ?? rec.name ?? guild_id);
+            const guild_name = String(row.guild_name ?? guild_id);
             this.guilds.set(guild_id, { guild_id, guild_name });
-            const chResp = await ipc.request(Actions.GUILD_CHANNELS, { guild_id });
-            if (!chResp.ok || !Array.isArray(chResp.data))
-                continue;
-            for (const ch of chResp.data) {
-                const chRec = ch;
-                const channel_id = String(chRec.channel_id ?? chRec.id ?? "");
+            const channels = client.getChannelList(guild_id);
+            for (const ch of channels) {
+                const channel_id = String(ch.channel_id ?? "");
                 if (!channel_id)
                     continue;
-                const channel_name = String(chRec.channel_name ?? chRec.name ?? channel_id);
+                const channel_name = String(ch.channel_name ?? channel_id);
                 this.channels.set(channel_id, {
                     channel_id,
                     channel_name,
@@ -79,7 +71,7 @@ export class IcqqGuildCatalog {
         return {};
     }
 }
-export function isIcqqGuildIpcEvent(eventName) {
+export function isIcqqGuildEvent(eventName) {
     return typeof eventName === "string" && eventName.startsWith("message.guild");
 }
 export function normalizeIcqqGuildInboundMessage(data) {

package/lib/icqq-inbound.d.ts

@@ -1,15 +1,15 @@
 /**
- * icqq 守护进程 IPC 入站事件归一化（post_type / message_type / message 段）
+ * icqq 入站事件归一化（post_type / message_type / message 段）
  */
 import { type MessageSegment, type QuotedMessagePayload } from "zhin.js";
 import type { GroupRole } from "./types.js";
 /** 守护进程推送的通用事件壳 */
-export interface IcqqIpcEventBase {
+export interface IcqqEventBase {
     post_type?: string;
     self_id?: number;
 }
 /** post_type=message 时的消息体（字段随 icqqjs/cli 演进，未知字段保留） */
-export interface IcqqIpcMessageEvent extends IcqqIpcEventBase {
+export interface IcqqMessageEvent extends IcqqEventBase {
     post_type: "message";
     message_id?: string;
     msg_id?: string;
@@ -28,7 +28,7 @@ export interface IcqqIpcMessageEvent extends IcqqIpcEventBase {
         card?: string;
         /** 群临时会话来源群号 */
         group_id?: number;
-        /** NT/IPC 群成员角色：owner | admin | member */
+        /** 群成员角色：owner | admin | member */
         role?: GroupRole | string;
     };
     from_id?: number;
@@ -36,7 +36,7 @@ export interface IcqqIpcMessageEvent extends IcqqIpcEventBase {
     group_id?: number;
     to_id?: number;
     nickname?: string;
-    /** 旧版 IPC 仅有 type 无 message_type */
+    /** 旧版仅有 type 无 message_type */
     type?: "group" | "private";
     /** oicq Message#source：被引用回复的源消息 */
     source?: IcqqMessageSource;
@@ -80,14 +80,14 @@ export interface NormalizedIcqqInbound {
     channelParentGroupId?: string;
     userId: string;
     nickname: string;
-    /** 群聊时来自 IPC sender.role（私聊无） */
+    /** 群聊时来自 sender.role（私聊无） */
     senderRole?: GroupRole;
     content: MessageSegment[];
     rawMessage: string;
     timestampMs: number;
-    raw: IcqqIpcMessageEvent;
+    raw: IcqqMessageEvent;
 }
-/** 从 IPC sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
+/** 从 sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
 export declare function parseIcqqSenderGroupRole(sender: {
     role?: unknown;
 } | undefined): GroupRole | undefined;
@@ -101,36 +101,36 @@ export declare function isIcqqBotMentioned(input: {
     readonly content?: readonly MessageSegment[] | null;
     readonly rawMessage?: string;
 }): boolean;
-/** 从 IPC 事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
-export declare function unwrapIcqqIpcEventPayload(event: {
+/** 从事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
+export declare function unwrapIcqqEventPayload(event: {
     data?: unknown;
     [key: string]: unknown;
 }): unknown;
 export declare function resolveIcqqInboundUserId(data: Record<string, unknown>): number | undefined;
-export declare function isIcqqMessagePostType(data: unknown): data is IcqqIpcMessageEvent;
-export declare function shouldSkipSelfInboundMessage(data: IcqqIpcMessageEvent): boolean;
+export declare function isIcqqMessagePostType(data: unknown): data is IcqqMessageEvent;
+export declare function shouldSkipSelfInboundMessage(data: IcqqMessageEvent): boolean;
 /** 群临时会话私聊：icqq message_type=private & sub_type=group */
-export declare function isIcqqGroupTempPrivateMessage(data: IcqqIpcMessageEvent): boolean;
-export declare function resolveChannelFromIcqqMessage(data: IcqqIpcMessageEvent): {
+export declare function isIcqqGroupTempPrivateMessage(data: IcqqMessageEvent): boolean;
+export declare function resolveChannelFromIcqqMessage(data: IcqqMessageEvent): {
     channelType: "group" | "private";
     channelId: string;
     channelParentGroupId?: string;
 };
-export declare function resolveIcqqInboundMessageId(data: IcqqIpcMessageEvent, channelId: string): {
+export declare function resolveIcqqInboundMessageId(data: IcqqMessageEvent, channelId: string): {
     id: string;
     source: "message_id" | "msg_id" | "seq" | "synthetic";
 };
 export declare function icqqElementsToSegments(elements: IcqqMessageElement[] | undefined): MessageSegment[] | null;
-/** IPC 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
+/** 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
 export declare function findIcqqNestedMessageSource(root: unknown, maxDepth?: number): IcqqMessageSource | undefined;
 /** 从 oicq MessageEvent.source 解析被引用消息的 message_id */
 export declare function resolveQuoteIdFromIcqqSource(source: unknown): string | undefined;
 /** 将 source 转为 QuotedMessagePayload（供 $getMsg 缓存，避免重复拉取） */
 export declare function quotedPayloadFromIcqqSource(source: unknown): QuotedMessagePayload | null;
-/** 从 IPC 事件顶层字段解析引用 message_id（与 message 段互补） */
-export declare function resolveIcqqQuoteIdFromEvent(data: IcqqIpcMessageEvent): string | undefined;
-export declare function resolveInboundContent(data: IcqqIpcMessageEvent): MessageSegment[];
-export declare function normalizeIcqqInboundMessage(data: IcqqIpcMessageEvent): NormalizedIcqqInbound | null;
+/** 从事件顶层字段解析引用 message_id（与 message 段互补） */
+export declare function resolveIcqqQuoteIdFromEvent(data: IcqqMessageEvent): string | undefined;
+export declare function resolveInboundContent(data: IcqqMessageEvent): MessageSegment[];
+export declare function normalizeIcqqInboundMessage(data: IcqqMessageEvent): NormalizedIcqqInbound | null;
 /** 按 message_id 去重（多路 subscribe 会收到同一消息多次） */
 export declare class InboundMessageDeduper {
     private readonly seen;

package/lib/icqq-inbound.js

@@ -1,12 +1,12 @@
 /**
- * icqq 守护进程 IPC 入站事件归一化（post_type / message_type / message 段）
+ * icqq 入站事件归一化（post_type / message_type / message 段）
  */
 import { Message, toCanonicalSegments } from "zhin.js";
 import { parseCqMessage, icqqMediaRefFromString } from "./cq-message.js";
 import { extractForwardResidFromJsonElement } from "./forward-msg.js";
 const DEDUPE_TTL_MS = 120_000;
 const ICQQ_GROUP_ROLES = new Set(["owner", "admin", "member"]);
-/** 从 IPC sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
+/** 从 sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
 export function parseIcqqSenderGroupRole(sender) {
     const raw = sender?.role;
     if (typeof raw !== "string" || !raw.trim())
@@ -49,12 +49,12 @@ function isMessagePostType(postType) {
     // 如 message.private / message.group
     return postType.startsWith("message.");
 }
-/** 从 IPC 事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
-export function unwrapIcqqIpcEventPayload(event) {
+/** 从事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
+export function unwrapIcqqEventPayload(event) {
     const nested = event.data;
     if (nested && typeof nested === "object" && !Array.isArray(nested)) {
         const d = nested;
-        if (isRecognizedIcqqIpcPayload(d)) {
+        if (isRecognizedIcqqPayload(d)) {
             return nested;
         }
         for (const key of ["data", "detail", "payload", "event"]) {
@@ -65,12 +65,12 @@ export function unwrapIcqqIpcEventPayload(event) {
         }
     }
     const { id: _id, event: _ev, data: _data, ok: _ok, ...rest } = event;
-    if (isRecognizedIcqqIpcPayload(rest)) {
+    if (isRecognizedIcqqPayload(rest)) {
         return rest;
     }
     return nested;
 }
-function isRecognizedIcqqIpcPayload(d) {
+function isRecognizedIcqqPayload(d) {
     const pt = d.post_type;
     if (typeof pt === "string") {
         if (isMessagePostType(pt) ||
@@ -359,7 +359,7 @@ function looksLikeIcqqMessageSource(value) {
         return false;
     return !!resolveQuoteIdFromIcqqSource(value);
 }
-/** IPC 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
+/** 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
 export function findIcqqNestedMessageSource(root, maxDepth = MAX_SOURCE_WALK_DEPTH) {
     const seen = new Set();
     function walk(node, depth) {
@@ -453,7 +453,7 @@ export function quotedPayloadFromIcqqSource(source) {
         time: typeof s.time === "number" ? s.time : undefined,
     };
 }
-/** 从 IPC 事件顶层字段解析引用 message_id（与 message 段互补） */
+/** 从事件顶层字段解析引用 message_id（与 message 段互补） */
 export function resolveIcqqQuoteIdFromEvent(data) {
     const fromSource = resolveQuoteIdFromIcqqSource(data.source) ??
         resolveQuoteIdFromIcqqSource(findIcqqNestedMessageSource(data));

package/lib/icqq-inbox.d.ts

@@ -1,12 +1,4 @@
-/**
- * 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';
+import type { SystemMessage } from './types.js';
 /** 行级公共前缀：adapter 槽 localName + endpoint live 名（uin）。 */
 export interface IcqqInboxBase {
     readonly adapter: string;
@@ -30,4 +22,4 @@ export declare function buildIcqqInboxNoticeRow(payload: Record<string, unknown>
  * GET_SYSTEM_MSG 返回项 → unified_inbox_request 行（启动时首次拉取）。
  * friend 列表项 type 语义即好友请求；group 列表项 type 为 add/invite（记 sub_type）。
  */
-export declare function buildIcqqSystemRequestRow(message: IpcSystemMessage, kind: 'friend' | 'group', base: IcqqInboxBase): Record<string, unknown> | null;
+export declare function buildIcqqSystemRequestRow(message: SystemMessage, kind: 'friend' | 'group', base: IcqqInboxBase): Record<string, unknown> | null;

package/lib/index.d.ts

@@ -1,6 +1,5 @@
-export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, resolveIcqqConfig, type IcqqAdapterConfig, type IcqqInboundMessage, type IcqqWireSegment, type IpcEvent, type IpcMessage, type IpcRequest, type IpcResponse, type ParsedIcqqSendTarget, type ResolvedIcqqConfig, } from './protocol.js';
-export { IcqqIpcEndpoint, type CreateIcqqIpc, type IcqqEndpointOptions, type IcqqInboxHooks, type IcqqIpcTransport, } from './endpoint.js';
+export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, type ActionResult, type IcqqAdapterConfig, type IcqqInboundMessage, type IcqqWireSegment, type ParsedIcqqSendTarget, type ResolvedIcqqConfig, } from './protocol.js';
+export { IcqqEndpoint, type IcqqEndpointOptions, type IcqqInboxHooks, } from './endpoint.js';
 export * from './types.js';
 export { getIcqqAgentDeps, registerIcqqAgentEndpoint, setIcqqAgentDeps, type IcqqAgentDeps, type IcqqAgentEndpoint, } from './icqq-agent-deps.js';
-export { IpcClient } from './ipc-client.js';
 export { resolveIcqqInboundMessageId, } from './icqq-inbound.js';

package/lib/index.js

@@ -1,6 +1,5 @@
-export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, resolveIcqqConfig, } from './protocol.js';
-export { IcqqIpcEndpoint, } from './endpoint.js';
+export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, } from './protocol.js';
+export { IcqqEndpoint, } from './endpoint.js';
 export * from './types.js';
 export { getIcqqAgentDeps, registerIcqqAgentEndpoint, setIcqqAgentDeps, } from './icqq-agent-deps.js';
-export { IpcClient } from './ipc-client.js';
 export { resolveIcqqInboundMessageId, } from './icqq-inbound.js';

package/lib/outbound-media.d.ts

@@ -1,15 +1,10 @@
 import type { SendContent } from "zhin.js";
 import type { IcqqEndpointConfig } from "./types.js";
 export type IcqqOutboundMediaMode = "file" | "base64";
-/**
- * 出站媒体模式：file=本机落盘后 CQ [image:path]（与 icqq 同机时可用）；
- * base64=保留 MediaRef base64，CQ 编码为 [image:base64://...] 经 IPC 交给守护进程解码（异机 RPC 默认）。
- */
-export declare function resolveIcqqOutboundMediaMode(config: Pick<IcqqEndpointConfig, "rpc" | "outboundMedia">): IcqqOutboundMediaMode;
+export declare function resolveIcqqOutboundMediaMode(config: Pick<IcqqEndpointConfig, "outboundMedia">): IcqqOutboundMediaMode;
 /**
  * file 模式：将 canonical MediaRef（`data.media`，kind=base64）物化为本机路径，
- * 并把 media 改写为 path 引用（与 icqq 同机时守护进程直接读盘）。
- * base64 模式：不改动（由 toCqString/formatOutboundBody 生成 base64://，供异机守护进程解码）。
- * 无 canonical MediaRef 的段原样保留（不可投递，由下游 CQ 序列化 warn + 丢弃）。
+ * 并把 media 改写为 path 引用（icqq 客户端直接读盘）。
+ * base64 模式：不改动（由 toCqString/formatOutboundBody 生成 base64://）。
  */
 export declare function materializeOutboundBase64(content: SendContent, mode?: IcqqOutboundMediaMode): SendContent;

package/lib/outbound-media.js

@@ -23,21 +23,16 @@ function spoolBase64ToFile(base64, mime, kind) {
     fs.writeFileSync(filePath, Buffer.from(base64, "base64"));
     return filePath;
 }
-/**
- * 出站媒体模式：file=本机落盘后 CQ [image:path]（与 icqq 同机时可用）；
- * base64=保留 MediaRef base64，CQ 编码为 [image:base64://...] 经 IPC 交给守护进程解码（异机 RPC 默认）。
- */
 export function resolveIcqqOutboundMediaMode(config) {
     if (config.outboundMedia === "base64" || config.outboundMedia === "file") {
         return config.outboundMedia;
     }
-    return config.rpc ? "base64" : "file";
+    return "file";
 }
 /**
  * file 模式：将 canonical MediaRef（`data.media`，kind=base64）物化为本机路径，
- * 并把 media 改写为 path 引用（与 icqq 同机时守护进程直接读盘）。
- * base64 模式：不改动（由 toCqString/formatOutboundBody 生成 base64://，供异机守护进程解码）。
- * 无 canonical MediaRef 的段原样保留（不可投递，由下游 CQ 序列化 warn + 丢弃）。
+ * 并把 media 改写为 path 引用（icqq 客户端直接读盘）。
+ * base64 模式：不改动（由 toCqString/formatOutboundBody 生成 base64://）。
  */
 export function materializeOutboundBase64(content, mode = "file") {
     if (mode === "base64")