@zhin.js/adapter-icqq 8.0.9 → 8.0.10

package/src/forward-msg.ts

@@ -1,10 +1,5 @@
-/**
- * 合并转发（聊天记录）解析：从 json/xml 提取 resid，经 IPC get_forward_msg 拉取正文。
- */
 import { segment, type MessageSegment, type QuotedMessagePayload } from 'zhin.js';
 
-import { Actions } from "./protocol.js";
-import type { IpcClient } from "./ipc-client.js";
 import {
   icqqElementsToSegments,
   type IcqqMessageElement,
@@ -215,7 +210,7 @@ export function extractForwardResidFromPayload(
   return undefined;
 }
 
-/** 在 get_msg / IPC 原始对象里深度搜索 resid */
+/** 在 get_msg 原始对象里深度搜索 resid */
 export function extractForwardResidDeep(
   root: unknown,
   maxDepth = 14,
@@ -367,22 +362,14 @@ export function formatForwardMsgResponse(data: unknown): string {
 }
 
 export async function fetchForwardMsgText(
-  ipc: IpcClient,
+  client: { getForwardMsg(resId: string, fileName?: string): Promise<unknown[]> },
   id: string,
 ): Promise<string> {
-  const attempts: Record<string, unknown>[] = [
-    { 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);
+  try {
+    const messages = await client.getForwardMsg(id);
+    const text = formatForwardMsgResponse(messages);
     if (text.trim()) return text.trim();
-  }
+  } catch { /* ignore */ }
   return "";
 }
 
@@ -404,18 +391,17 @@ function appendForwardBlock(
   };
 }
 
-/** 若 payload 含合并转发，拉取并追加到 content */
 export async function enrichQuotedPayloadWithForward(
-  ipc: IpcClient | null | undefined,
+  client: { getForwardMsg(resId: string, fileName?: string): Promise<unknown[]> } | null | undefined,
   payload: QuotedMessagePayload,
-  ipcRaw?: unknown,
+  rawData?: unknown,
 ): Promise<QuotedMessagePayload> {
-  if (!ipc || hasMergedForwardBlock(payload)) return payload;
+  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,
@@ -423,7 +409,7 @@ export async function enrichQuotedPayloadWithForward(
   ].filter((v, i, a): v is string => !!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()}`;
     return appendForwardBlock(payload, block);

package/src/icqq-agent-deps.ts

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

package/src/icqq-endpoint-commands.ts

@@ -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';
@@ -15,11 +6,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）';
@@ -28,7 +19,7 @@ export const icqqEndpointCommands = createEndpointCommands({
       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/src/icqq-guild.ts

@@ -2,15 +2,12 @@
  * ICQQ guild (QQ 频道) catalog sync, inbound normalize, Console channel list.
  */
 import { toCanonicalSegments, type MessageSegment } from "zhin.js";
-import { Actions, type IpcGuildMessageEventData } from "./protocol.js";
+import type { GuildMessageEventData } from "./protocol.js";
 import { parseCqMessage } from "./cq-message.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 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 {
@@ -31,7 +28,7 @@ export interface NormalizedIcqqGuildInbound {
   content: MessageSegment[];
   rawMessage: string;
   timestampMs: number;
-  raw: IpcGuildMessageEventData;
+  raw: GuildMessageEventData;
 }
 
 export class IcqqGuildCatalog {
@@ -43,25 +40,19 @@ export class IcqqGuildCatalog {
     this.guilds.clear();
   }
 
-  async syncAll(ipc: IcqqGuildRpc): Promise<void> {
-    const listResp = await ipc.request(Actions.GUILD_LIST);
-    if (!listResp.ok) return;
-
-    const guildRows = Array.isArray(listResp.data) ? listResp.data : [];
+  async syncAll(client: IcqqGuildClient): Promise<void> {
+    const guildRows = client.getGuildList();
     for (const row of guildRows) {
-      const rec = row as Record<string, unknown>;
-      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 as Record<string, unknown>;
-        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,
@@ -72,7 +63,7 @@ export class IcqqGuildCatalog {
     }
   }
 
-  upsertFromInbound(data: IpcGuildMessageEventData): void {
+  upsertFromInbound(data: GuildMessageEventData): void {
     const guild_id = String(data.guild_id ?? "");
     const channel_id = String(data.channel_id ?? "");
     if (!guild_id || !channel_id) return;
@@ -119,12 +110,12 @@ export class IcqqGuildCatalog {
   }
 }
 
-export function isIcqqGuildIpcEvent(eventName: string | undefined): boolean {
+export function isIcqqGuildEvent(eventName: string | undefined): boolean {
   return typeof eventName === "string" && eventName.startsWith("message.guild");
 }
 
 export function normalizeIcqqGuildInboundMessage(
-  data: IpcGuildMessageEventData & Record<string, unknown>,
+  data: GuildMessageEventData & Record<string, unknown>,
 ): NormalizedIcqqGuildInbound | null {
   if (data.type !== "guild") return null;
   const guildId = String(data.guild_id ?? "");

package/src/icqq-inbound.ts

@@ -1,5 +1,5 @@
 /**
- * icqq 守护进程 IPC 入站事件归一化（post_type / message_type / message 段）
+ * icqq 入站事件归一化（post_type / message_type / message 段）
  */
 import { Message, toCanonicalSegments, type MessageSegment, type QuotedMessagePayload } from "zhin.js";
 import { parseCqMessage, icqqMediaRefFromString } from "./cq-message.js";
@@ -7,13 +7,13 @@ import { extractForwardResidFromJsonElement } from "./forward-msg.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;
@@ -32,7 +32,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;
@@ -40,7 +40,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;
@@ -87,19 +87,19 @@ 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;
 }
 
 const DEDUPE_TTL_MS = 120_000;
 
 const ICQQ_GROUP_ROLES = new Set<GroupRole>(["owner", "admin", "member"]);
 
-/** 从 IPC sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
+/** 从 sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
 export function parseIcqqSenderGroupRole(
   sender: { role?: unknown } | undefined,
 ): GroupRole | undefined {
@@ -148,15 +148,15 @@ function isMessagePostType(postType: unknown): boolean {
   return postType.startsWith("message.");
 }
 
-/** 从 IPC 事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
-export function unwrapIcqqIpcEventPayload(event: {
+/** 从事件壳中取出 OneBot/icqq 载荷（兼容 data 嵌套或字段在根级） */
+export function unwrapIcqqEventPayload(event: {
   data?: unknown;
   [key: string]: unknown;
 }): unknown {
   const nested = event.data;
   if (nested && typeof nested === "object" && !Array.isArray(nested)) {
     const d = nested as Record<string, unknown>;
-    if (isRecognizedIcqqIpcPayload(d)) {
+    if (isRecognizedIcqqPayload(d)) {
       return nested;
     }
     for (const key of ["data", "detail", "payload", "event"]) {
@@ -168,13 +168,13 @@ 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: Record<string, unknown>): boolean {
+function isRecognizedIcqqPayload(d: Record<string, unknown>): boolean {
   const pt = d.post_type;
   if (typeof pt === "string") {
     if (
@@ -216,7 +216,7 @@ export function resolveIcqqInboundUserId(
 
 export function isIcqqMessagePostType(
   data: unknown,
-): data is IcqqIpcMessageEvent {
+): data is IcqqMessageEvent {
   if (!data || typeof data !== "object") return false;
   const d = data as Record<string, unknown>;
   if (isMessagePostType(d.post_type)) return true;
@@ -232,14 +232,14 @@ export function isIcqqMessagePostType(
 }
 
 export function shouldSkipSelfInboundMessage(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): boolean {
   if (data.self_id == null || data.user_id == null) return false;
   return Number(data.self_id) === Number(data.user_id);
 }
 
 /** 群临时会话私聊：icqq message_type=private & sub_type=group */
-export function isIcqqGroupTempPrivateMessage(data: IcqqIpcMessageEvent): boolean {
+export function isIcqqGroupTempPrivateMessage(data: IcqqMessageEvent): boolean {
   const messageType =
     data.message_type ??
     (data.type === "group" || data.type === "private" ? data.type : undefined);
@@ -250,7 +250,7 @@ export function isIcqqGroupTempPrivateMessage(data: IcqqIpcMessageEvent): boolea
 }
 
 export function resolveChannelFromIcqqMessage(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): {
   channelType: "group" | "private";
   channelId: string;
@@ -287,7 +287,7 @@ export function resolveChannelFromIcqqMessage(
 }
 
 export function resolveIcqqInboundMessageId(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
   channelId: string,
 ): { id: string; source: "message_id" | "msg_id" | "seq" | "synthetic" } {
   if (data.message_id != null && String(data.message_id) !== "") {
@@ -485,7 +485,7 @@ function looksLikeIcqqMessageSource(value: unknown): value is IcqqMessageSource
   return !!resolveQuoteIdFromIcqqSource(value);
 }
 
-/** IPC 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
+/** 载荷可能把 source 嵌在 data / event 等字段，深度查找 */
 export function findIcqqNestedMessageSource(
   root: unknown,
   maxDepth = MAX_SOURCE_WALK_DEPTH,
@@ -590,16 +590,16 @@ export function quotedPayloadFromIcqqSource(
   };
 }
 
-/** 从 IPC 事件顶层字段解析引用 message_id（与 message 段互补） */
+/** 从事件顶层字段解析引用 message_id（与 message 段互补） */
 export function resolveIcqqQuoteIdFromEvent(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): string | undefined {
   const fromSource =
     resolveQuoteIdFromIcqqSource(data.source) ??
     resolveQuoteIdFromIcqqSource(findIcqqNestedMessageSource(data));
   if (fromSource) return fromSource;
 
-  const ext = data as IcqqIpcMessageEvent & Record<string, unknown>;
+  const ext = data as IcqqMessageEvent & Record<string, unknown>;
   const candidates = [
     ext.reply,
     ext.quoted_message_id,
@@ -634,7 +634,7 @@ function mergeReplyFromRawMessage(
 
 function mergeReplyFromSource(
   content: MessageSegment[],
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): MessageSegment[] {
   if (Message.quoteIdFromContent(content)) return content;
   const quoteId =
@@ -648,7 +648,7 @@ function mergeReplyFromSource(
 }
 
 export function resolveInboundContent(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): MessageSegment[] {
   const fromElements = icqqElementsToSegments(data.message);
   const raw = data.raw_message ?? "";
@@ -664,10 +664,10 @@ export function resolveInboundContent(
 }
 
 export function normalizeIcqqInboundMessage(
-  data: IcqqIpcMessageEvent,
+  data: IcqqMessageEvent,
 ): NormalizedIcqqInbound | null {
   if (!isIcqqMessagePostType(data)) return null;
-  const ext = data as IcqqIpcMessageEvent & Record<string, unknown>;
+  const ext = data as IcqqMessageEvent & Record<string, unknown>;
   const userIdNum = resolveIcqqInboundUserId(ext);
   if (userIdNum == null) return null;
   const { channelType, channelId, channelParentGroupId } = resolveChannelFromIcqqMessage(data);

package/src/icqq-inbox.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 {
@@ -107,7 +99,7 @@ export function buildIcqqInboxNoticeRow(
  * friend 列表项 type 语义即好友请求；group 列表项 type 为 add/invite（记 sub_type）。
  */
 export function buildIcqqSystemRequestRow(
-  message: IpcSystemMessage,
+  message: SystemMessage,
   kind: 'friend' | 'group',
   base: IcqqInboxBase,
 ): Record<string, unknown> | null {

package/src/icqqjs-icqq.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Fallback types when `@icqqjs/icqq` peer is not installed.
+ * Prefer package types when the real dependency is present.
+ */
+declare module '@icqqjs/icqq' {
+  export interface Config extends Record<string, unknown> {
+    sign_api_addr?: string;
+    ver?: string;
+    platform?: number;
+    auto_server?: boolean;
+    autoReconnect?: boolean;
+  }
+
+  export type Sendable = string | Record<string, unknown> | unknown[];
+
+  export interface ParsedGroupMessageId {
+    group_id: number;
+    user_id: number;
+    seq: number;
+    rand: number;
+    time: number;
+    pktnum: number;
+  }
+
+  export function parseGroupMessageId(msgid: string): ParsedGroupMessageId;
+
+  export interface GroupHandle {
+    setReaction(seq: number, emoji: string): Promise<unknown>;
+    delReaction(seq: number, reactionId: string): Promise<unknown>;
+  }
+
+  export interface FriendInfo {
+    user_id: number;
+    nickname: string;
+    remark?: string;
+  }
+
+  export interface GroupInfo {
+    group_id: number;
+    group_name: string;
+  }
+
+  export interface GroupMemberInfo {
+    user_id: number;
+    nickname?: string;
+    card?: string;
+    role?: string;
+  }
+
+  export class Client {
+    uin: number;
+    fl: Map<number, FriendInfo>;
+    gl: Map<number, GroupInfo>;
+    config: Config;
+    dir?: string;
+    status?: number;
+
+    constructor(uin?: number | Config, config?: Config);
+
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener?: (...args: unknown[]) => void): this;
+    emit(event: string, ...args: unknown[]): boolean;
+
+    login(password?: string | number): Promise<void>;
+    logout?(keepalive?: boolean): Promise<void>;
+    terminate(): void;
+
+    sendPrivateMsg(userId: number, message: Sendable): Promise<{ message_id?: unknown }>;
+    sendGroupMsg(groupId: number, message: Sendable): Promise<{ message_id?: unknown }>;
+    sendTempMsg(groupId: number, userId: number, message: Sendable): Promise<{ message_id?: unknown }>;
+    sendGuildMsg(guildId: string, channelId: string, message: Sendable): Promise<{ message_id?: unknown }>;
+
+    deleteMsg(messageId: string): Promise<boolean>;
+    getSystemMsg(): Promise<unknown[]>;
+    setFriendAddRequest(flag: string, approve: boolean, remark?: string): Promise<boolean>;
+    setGroupAddRequest(flag: string, approve: boolean, reason?: string): Promise<boolean>;
+    deleteFriend(userId: number): Promise<boolean>;
+    setGroupKick(groupId: number, userId: number): Promise<boolean>;
+    setGroupBan(groupId: number, userId: number, duration: number): Promise<boolean>;
+    setGroupAdmin(groupId: number, userId: number, enabled: boolean): Promise<boolean>;
+    getGroupMemberList(groupId: number): Promise<Map<number, GroupMemberInfo>>;
+
+    getGuildList(): Array<{ guild_id: string; guild_name: string }>;
+    getChannelList(guildId: string): Array<{ guild_id: string; channel_id: string; channel_name: string }>;
+
+    pickGroup(groupId: number): GroupHandle;
+  }
+}

package/src/index.ts

@@ -4,24 +4,18 @@ export {
   formatOutboundBody,
   icqqInboundConversation,
   icqqOutboundTarget,
-  resolveIcqqConfig,
+  type ActionResult,
   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,
+  IcqqEndpoint,
   type IcqqEndpointOptions,
   type IcqqInboxHooks,
-  type IcqqIpcTransport,
 } from './endpoint.js';
 
 export * from './types.js';
@@ -34,7 +28,6 @@ export {
   type IcqqAgentEndpoint,
 } from './icqq-agent-deps.js';
 
-export { IpcClient } from './ipc-client.js';
 export {
   resolveIcqqInboundMessageId,
 } from './icqq-inbound.js';

package/src/outbound-media.ts

@@ -34,24 +34,19 @@ function spoolBase64ToFile(
   return filePath;
 }
 
-/**
- * 出站媒体模式：file=本机落盘后 CQ [image:path]（与 icqq 同机时可用）；
- * base64=保留 MediaRef base64，CQ 编码为 [image:base64://...] 经 IPC 交给守护进程解码（异机 RPC 默认）。
- */
 export function resolveIcqqOutboundMediaMode(
-  config: Pick<IcqqEndpointConfig, "rpc" | "outboundMedia">,
+  config: Pick<IcqqEndpointConfig, "outboundMedia">,
 ): IcqqOutboundMediaMode {
   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: SendContent,