@lanmers/wecom-openclaw-plugin 1.0.12

package/dist/src/channel.d.ts

@@ -0,0 +1,3 @@
+import { type ChannelPlugin } from "openclaw/plugin-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+export declare const wecomPlugin: ChannelPlugin<ResolvedWeComAccount>;

package/dist/src/const.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 企业微信渠道常量定义
+ */
+/**
+ * 企业微信渠道 ID
+ */
+export declare const CHANNEL_ID: "wecom";
+/**
+ * 企业微信 WebSocket 命令枚举
+ */
+export declare enum WeComCommand {
+    /** 认证订阅 */
+    SUBSCRIBE = "aibot_subscribe",
+    /** 心跳 */
+    PING = "ping",
+    /** 企业微信推送消息 */
+    AIBOT_CALLBACK = "aibot_callback",
+    /** clawdbot 响应消息 */
+    AIBOT_RESPONSE = "aibot_response"
+}
+/** 图片下载超时时间（毫秒） */
+export declare const IMAGE_DOWNLOAD_TIMEOUT_MS = 30000;
+/** 文件下载超时时间（毫秒） */
+export declare const FILE_DOWNLOAD_TIMEOUT_MS = 60000;
+/** 消息发送超时时间（毫秒） */
+export declare const REPLY_SEND_TIMEOUT_MS = 15000;
+/** 消息处理总超时时间（毫秒） */
+export declare const MESSAGE_PROCESS_TIMEOUT_MS: number;
+/** WebSocket 心跳间隔（毫秒） */
+export declare const WS_HEARTBEAT_INTERVAL_MS = 30000;
+/** WebSocket 最大重连次数 */
+export declare const WS_MAX_RECONNECT_ATTEMPTS = 100;
+/** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
+export declare const MESSAGE_STATE_TTL_MS: number;
+/** messageStates Map 清理间隔（毫秒） */
+export declare const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60000;
+/** messageStates Map 最大条目数 */
+export declare const MESSAGE_STATE_MAX_SIZE = 500;
+/** "思考中"流式消息占位内容 */
+export declare const THINKING_MESSAGE = "<think></think>";
+/** 仅包含图片时的消息占位符 */
+export declare const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+/** 仅包含文件时的消息占位符 */
+export declare const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+/** 获取 MCP 配置的 WebSocket 命令 */
+export declare const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
+/** MCP 配置拉取超时时间（毫秒） */
+export declare const MCP_CONFIG_FETCH_TIMEOUT_MS = 15000;
+/** 默认媒体大小上限（MB） */
+export declare const DEFAULT_MEDIA_MAX_MB = 5;
+/** 文本分块大小上限 */
+export declare const TEXT_CHUNK_LIMIT = 4000;
+/** 图片大小上限（字节）：10MB */
+export declare const IMAGE_MAX_BYTES: number;
+/** 视频大小上限（字节）：10MB */
+export declare const VIDEO_MAX_BYTES: number;
+/** 语音大小上限（字节）：2MB */
+export declare const VOICE_MAX_BYTES: number;
+/** 文件大小上限（字节）：20MB */
+export declare const FILE_MAX_BYTES: number;
+/** 文件绝对上限（字节）：超过此值无法发送，等于 FILE_MAX_BYTES */
+export declare const ABSOLUTE_MAX_BYTES: number;
+/** 上传分片大小（字节，Base64 编码前）：512KB */
+export declare const UPLOAD_CHUNK_SIZE: number;

package/dist/src/dm-policy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 企业微信 DM（私聊）访问控制模块
+ *
+ * 负责私聊策略检查、配对流程
+ */
+import type { RuntimeEnv } from "openclaw/plugin-sdk";
+import type { WSClient, WsFrame } from "@wecom/aibot-node-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+/**
+ * DM Policy 检查结果
+ */
+export interface DmPolicyCheckResult {
+    /** 是否允许继续处理消息 */
+    allowed: boolean;
+    /** 是否已发送配对消息（仅在 pairing 模式下） */
+    pairingSent?: boolean;
+}
+/**
+ * 检查 DM Policy 访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export declare function checkDmPolicy(params: {
+    senderId: string;
+    isGroup: boolean;
+    account: ResolvedWeComAccount;
+    wsClient: WSClient;
+    frame: WsFrame;
+    runtime: RuntimeEnv;
+}): Promise<DmPolicyCheckResult>;

package/dist/src/group-policy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 企业微信群组访问控制模块
+ *
+ * 负责群组策略检查（groupPolicy、群组白名单、群内发送者白名单）
+ */
+import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+/**
+ * 群组策略检查结果
+ */
+export interface GroupPolicyCheckResult {
+    /** 是否允许继续处理消息 */
+    allowed: boolean;
+}
+/**
+ * 检查群组策略访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export declare function checkGroupPolicy(params: {
+    chatId: string;
+    senderId: string;
+    account: ResolvedWeComAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+}): GroupPolicyCheckResult;
+/**
+ * 检查发送者是否在允许列表中（通用）
+ */
+export declare function isSenderAllowed(senderId: string, allowFrom: string[]): boolean;

package/dist/src/interface.d.ts

@@ -0,0 +1,154 @@
+/**
+ * 企业微信渠道类型定义
+ */
+import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+import { WeComCommand } from "./const.js";
+/**
+ * Monitor 配置选项
+ */
+export type WeComMonitorOptions = {
+    account: ResolvedWeComAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+    abortSignal?: AbortSignal;
+};
+/**
+ * 消息状态
+ */
+export interface MessageState {
+    accumulatedText: string;
+    /** 流式回复的 streamId，用于保持同一个流式回复使用相同的 streamId */
+    streamId?: string;
+    /** 是否有用户可见的文本内容（不包括 <think>...</think> 标签） */
+    hasText?: boolean;
+    /** 是否已成功发送过媒体文件 */
+    hasMedia?: boolean;
+    /** 是否有媒体发送失败（权限不足、文件过大等） */
+    hasMediaFailed?: boolean;
+    /** 媒体发送失败时的纯文本错误摘要（用于替换 thinking 流展示给用户） */
+    mediaErrorSummary?: string;
+    /** deliver 回调是否被调用过（用于区分"核心无回复"和"核心回复了空内容"） */
+    deliverCalled?: boolean;
+}
+/**
+ * WebSocket 请求消息基础格式
+ */
+export interface WeComRequest {
+    cmd: string;
+    headers: {
+        req_id: string;
+    };
+    body: any;
+}
+/**
+ * WebSocket 响应消息格式
+ */
+export interface WeComResponse {
+    headers: {
+        req_id: string;
+    };
+    errcode: number;
+    errmsg: string;
+}
+/**
+ * 企业微信认证请求
+ */
+export interface WeComSubscribeRequest extends WeComRequest {
+    cmd: WeComCommand.SUBSCRIBE;
+    body: {
+        secret: string;
+        bot_id: string;
+    };
+}
+/**
+ * 企业微信推送消息格式
+ */
+export interface WeComCallbackMessage {
+    cmd: WeComCommand.AIBOT_CALLBACK;
+    headers: {
+        req_id: string;
+    };
+    body: {
+        msgid: string;
+        aibotid: string;
+        chatid: string;
+        chattype: "single" | "group";
+        from: {
+            userid: string;
+        };
+        response_url: string;
+        msgtype: "text" | "image" | "voice" | "video" | "file" | "stream" | "mixed";
+        text?: {
+            content: string;
+        };
+        image?: {
+            /** 图片 URL（通过 URL 方式接收图片时） */
+            url?: string;
+            /** 图片 base64 数据（直接传输时） */
+            base64?: string;
+            md5?: string;
+        };
+        /** 图文混排消息 */
+        mixed?: {
+            msg_item: Array<{
+                msgtype: "text" | "image";
+                text?: {
+                    content: string;
+                };
+                image?: {
+                    url?: string;
+                    base64?: string;
+                    md5?: string;
+                };
+            }>;
+        };
+        quote?: {
+            msgtype: string;
+            text?: {
+                content: string;
+            };
+            image?: {
+                url?: string;
+                aeskey?: string;
+            };
+            file?: {
+                url?: string;
+                aeskey?: string;
+            };
+        };
+        stream?: {
+            id: string;
+        };
+    };
+}
+/**
+ * 企业微信响应消息格式
+ */
+export interface WeComResponseMessage extends WeComRequest {
+    cmd: WeComCommand.AIBOT_RESPONSE;
+    body: {
+        msgtype: "stream" | "text" | "markdown";
+        stream?: {
+            id: string;
+            finish: boolean;
+            content: string;
+            msg_item?: Array<{
+                msgtype: "image" | "file";
+                image?: {
+                    base64: string;
+                    md5: string;
+                };
+            }>;
+            feedback?: {
+                id: string;
+            };
+        };
+        text?: {
+            content: string;
+        };
+        markdown?: {
+            content: string;
+        };
+    };
+}

package/dist/src/mcp/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP 模块统一导出
+ */
+export { createWeComMcpTool } from "./tool.js";
+export { sendJsonRpc, clearCategoryCache, McpRpcError, McpHttpError, type McpToolInfo } from "./transport.js";
+export { cleanSchemaForGemini } from "./schema.js";

package/dist/src/mcp/schema.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Schema 清洗模块
+ *
+ * 负责内联 $ref/$defs 引用并移除 Gemini 不支持的 JSON Schema 关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+/**
+ * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+export declare function cleanSchemaForGemini(schema: unknown): unknown;

package/dist/src/mcp/tool.d.ts

@@ -0,0 +1,55 @@
+/**
+ * wecom_mcp — 模拟 MCP 调用的 Agent Tool
+ *
+ * 通过 MCP Streamable HTTP 传输协议调用企业微信 MCP Server，
+ * 提供 list（列出所有工具）和 call（调用工具）两个操作。
+ *
+ * 在 skills 中的使用方式：
+ *   wecom_mcp list <category>
+ *   wecom_mcp call <category> <method> '<jsonArgs>'
+ *
+ * 示例：
+ *   wecom_mcp list contact
+ *   wecom_mcp call contact getContact '{}'
+ */
+/**
+ * 创建 wecom_mcp Agent Tool 定义
+ */
+export declare function createWeComMcpTool(): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            accountId: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                description: string;
+            };
+            args: {
+                type: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(_toolCallId: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/mcp/transport.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MCP Streamable HTTP 传输层模块
+ *
+ * 负责:
+ * - MCP JSON-RPC over HTTP 通信（发送请求、解析响应）
+ * - Streamable HTTP session 生命周期管理（initialize 握手 → Mcp-Session-Id 维护 → 失效重建）
+ * - 自动检测无状态 Server：如果 initialize 响应未返回 Mcp-Session-Id，
+ *   则标记为无状态模式，后续请求跳过握手和 session 管理
+ * - SSE 流式响应解析
+ * - MCP 配置运行时缓存（通过 WSClient 拉取 URL 并缓存在内存中）
+ */
+/**
+ * MCP JSON-RPC 错误
+ *
+ * 携带服务端返回的 JSON-RPC error.code，
+ * 用于上层按错误码进行差异化处理（如特定错误码触发缓存清理）。
+ */
+export declare class McpRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+/**
+ * MCP HTTP 错误
+ *
+ * 携带 HTTP 状态码，用于精确判断 session 失效（404）等场景，
+ * 避免通过字符串匹配 "404" 导致的误判。
+ */
+export declare class McpHttpError extends Error {
+    readonly statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+/**
+ * 清理指定品类的所有 MCP 缓存（配置、会话、无状态标记）
+ *
+ * 当 MCP Server 返回特定错误码时调用，确保下次请求重新拉取配置并重建会话。
+ *
+ * @param category - MCP 品类名称
+ * @param accountId - 账户 ID（可选，用于清理特定账户的缓存）
+ */
+export declare function clearCategoryCache(category: string, accountId?: string): void;
+/** tools/list 返回的工具描述 */
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * 发送 JSON-RPC 请求到 MCP Server（Streamable HTTP 协议）
+ *
+ * 自动管理 session 生命周期：
+ * - 无状态 Server：跳过 session 管理，直接发送请求
+ * - 有状态 Server：首次调用先执行 initialize 握手，session 失效（404）时自动重建并重试
+ *
+ * @param category - MCP 品类名称
+ * @param method - JSON-RPC 方法名
+ * @param params - JSON-RPC 参数
+ * @param accountId - 账户 ID（可选，默认使用 DEFAULT_ACCOUNT_ID）
+ * @returns JSON-RPC result
+ */
+export declare function sendJsonRpc(category: string, method: string, params?: Record<string, unknown>, accountId?: string): Promise<unknown>;

package/dist/src/mcp-config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP 配置拉取与持久化模块
+ *
+ * 负责:
+ * - 通过 WSClient 发送 aibot_get_mcp_config 请求
+ * - 解析服务端响应,提取 MCP 配置(url、type、is_authed)
+ * - 将配置写入 openclaw.plugin.json 的 wecomMcp 字段
+ */
+import { type WSClient } from "@wecom/aibot-node-sdk";
+import type { RuntimeEnv } from "openclaw/plugin-sdk";
+import type { McpConfigBody } from "./interface.js";
+/**
+ * 通过 WSClient 发送 aibot_get_mcp_config 命令,获取 MCP 配置
+ *
+ * @param wsClient - 已认证的 WSClient 实例
+ * @returns MCP 配置(url、type、is_authed)
+ * @throws 响应错误码非 0 或缺少 url 字段时抛出错误
+ */
+export declare function fetchMcpConfig(wsClient: WSClient): Promise<McpConfigBody>;
+/**
+ * 拉取 MCP 配置并持久化到 openclaw.plugin.json
+ *
+ * 认证成功后调用。失败仅记录日志,不影响 WebSocket 消息正常收发。
+ *
+ * @param wsClient - 已认证的 WSClient 实例
+ * @param accountId - 账户 ID(用于日志)
+ * @param runtime - 运行时环境(用于日志)
+ */
+export declare function fetchAndSaveMcpConfig(wsClient: WSClient, accountId: string, runtime: RuntimeEnv): Promise<void>;

package/dist/src/media-handler.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 企业微信媒体（图片）下载和保存模块
+ *
+ * 负责下载、检测格式、保存图片到本地，包含超时保护
+ */
+import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { WSClient } from "@wecom/aibot-node-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+/**
+ * 下载并保存所有图片到本地，每张图片的下载带超时保护
+ */
+export declare function downloadAndSaveImages(params: {
+    imageUrls: string[];
+    imageAesKeys?: Map<string, string>;
+    account: ResolvedWeComAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+    wsClient: WSClient;
+}): Promise<Array<{
+    path: string;
+    contentType?: string;
+}>>;
+/**
+ * 下载并保存所有文件到本地，每个文件的下载带超时保护
+ */
+export declare function downloadAndSaveFiles(params: {
+    fileUrls: string[];
+    fileAesKeys?: Map<string, string>;
+    account: ResolvedWeComAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+    wsClient: WSClient;
+}): Promise<Array<{
+    path: string;
+    contentType?: string;
+}>>;

package/dist/src/media-uploader.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 企业微信出站媒体上传工具模块
+ *
+ * 负责：
+ * - 从 mediaUrl 加载文件 buffer（远程 URL 或本地路径均支持）
+ * - 检测 MIME 类型并映射为企微媒体类型
+ * - 文件大小检查与降级策略
+ */
+import type { WeComMediaType, WSClient, WsFrameHeaders } from "@wecom/aibot-node-sdk";
+/** 媒体文件解析结果 */
+export interface ResolvedMedia {
+    /** 文件数据 */
+    buffer: Buffer;
+    /** 检测到的 MIME 类型 */
+    contentType: string;
+    /** 文件名（从 URL 提取或默认生成） */
+    fileName: string;
+}
+/** 文件大小检查结果 */
+export interface FileSizeCheckResult {
+    /** 最终确定的企微媒体类型（可能被降级） */
+    finalType: WeComMediaType;
+    /** 是否需要拒绝（超过绝对限制） */
+    shouldReject: boolean;
+    /** 拒绝原因（仅 shouldReject=true 时有值） */
+    rejectReason?: string;
+    /** 是否发生了降级 */
+    downgraded: boolean;
+    /** 降级说明（仅 downgraded=true 时有值） */
+    downgradeNote?: string;
+}
+/**
+ * 根据 MIME 类型检测企微媒体类型
+ *
+ * @param mimeType - MIME 类型字符串
+ * @returns 企微媒体类型
+ */
+export declare function detectWeComMediaType(mimeType: string): WeComMediaType;
+/**
+ * 从 mediaUrl 加载媒体文件
+ *
+ * 支持远程 URL（http/https）和本地路径（file:// 或绝对路径），
+ * 利用 openclaw plugin-sdk 的 loadOutboundMediaFromUrl 统一处理。
+ *
+ * @param mediaUrl - 媒体文件的 URL 或本地路径
+ * @param mediaLocalRoots - 允许读取本地文件的安全白名单目录
+ * @returns 解析后的媒体文件信息
+ */
+export declare function resolveMediaFile(mediaUrl: string, mediaLocalRoots?: readonly string[]): Promise<ResolvedMedia>;
+/**
+ * 检查文件大小并执行降级策略
+ *
+ * 降级规则：
+ * - voice 非 AMR 格式 → 降级为 file（企微后台仅支持 AMR）
+ * - image 超过 10MB → 降级为 file
+ * - video 超过 10MB → 降级为 file
+ * - voice 超过 2MB → 降级为 file
+ * - file 超过 20MB → 拒绝发送
+ *
+ * @param fileSize - 文件大小（字节）
+ * @param detectedType - 检测到的企微媒体类型
+ * @param contentType - 文件的 MIME 类型（用于语音格式校验）
+ * @returns 大小检查结果
+ */
+export declare function applyFileSizeLimits(fileSize: number, detectedType: WeComMediaType, contentType?: string): FileSizeCheckResult;
+/** uploadAndSendMedia 的参数 */
+export interface UploadAndSendMediaOptions {
+    /** WSClient 实例 */
+    wsClient: WSClient;
+    /** 媒体文件的 URL 或本地路径 */
+    mediaUrl: string;
+    /** 目标会话 ID（用于 aibot_send_msg 主动发送） */
+    chatId: string;
+    /** 允许读取本地文件的安全白名单目录 */
+    mediaLocalRoots?: readonly string[];
+    /** 日志函数 */
+    log?: (...args: any[]) => void;
+    /** 错误日志函数 */
+    errorLog?: (...args: any[]) => void;
+}
+/** uploadAndSendMedia 的返回结果 */
+export interface UploadAndSendMediaResult {
+    /** 是否发送成功 */
+    ok: boolean;
+    /** 发送后返回的 messageId */
+    messageId?: string;
+    /** 最终的企微媒体类型 */
+    finalType?: WeComMediaType;
+    /** 是否被拒绝（文件过大） */
+    rejected?: boolean;
+    /** 拒绝原因 */
+    rejectReason?: string;
+    /** 是否发生了降级 */
+    downgraded?: boolean;
+    /** 降级说明 */
+    downgradeNote?: string;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 公共媒体上传+发送流程
+ *
+ * 统一处理：resolveMediaFile → detectType → sizeCheck → uploadMedia → sendMediaMessage
+ * 媒体消息统一走 aibot_send_msg 主动发送，避免多文件场景下 reqId 只能用一次的问题。
+ * channel.ts 的 sendMedia 和 monitor.ts 的 deliver 回调都使用此函数。
+ */
+export declare function uploadAndSendMedia(options: UploadAndSendMediaOptions): Promise<UploadAndSendMediaResult>;
+/** uploadAndReplyMedia 的参数 */
+export interface UploadAndReplyMediaOptions {
+    /** WSClient 实例 */
+    wsClient: WSClient;
+    /** 媒体文件的 URL 或本地路径 */
+    mediaUrl: string;
+    /** 原始 WebSocket 帧（用于 aibot_respond_msg 被动回复，携带 req_id） */
+    frame: WsFrameHeaders;
+    /** 允许读取本地文件的安全白名单目录 */
+    mediaLocalRoots?: readonly string[];
+    /** 日志函数 */
+    log?: (...args: any[]) => void;
+    /** 错误日志函数 */
+    errorLog?: (...args: any[]) => void;
+}
+/**
+ * 被动回复媒体上传+发送流程
+ *
+ * 统一处理：resolveMediaFile → detectType → sizeCheck → uploadMedia → replyMedia
+ * 通过 aibot_respond_msg 被动回复通道发送媒体消息，可以覆盖之前的 THINKING_MESSAGE。
+ *
+ * 适用场景：回包只有媒体没有文本时，第一个媒体文件用此方法发送以清理 thinking 状态。
+ */
+export declare function uploadAndReplyMedia(options: UploadAndReplyMediaOptions): Promise<UploadAndSendMediaResult>;

package/dist/src/message-parser.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 企业微信消息内容解析模块
+ *
+ * 负责从 WsFrame 中提取文本、图片、引用等内容
+ */
+export interface MessageBody {
+    msgid: string;
+    aibotid?: string;
+    chatid?: string;
+    chattype: "single" | "group";
+    from: {
+        userid: string;
+    };
+    response_url?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        url?: string;
+        aeskey?: string;
+    };
+    voice?: {
+        content?: string;
+    };
+    mixed?: {
+        msg_item: Array<{
+            msgtype: "text" | "image";
+            text?: {
+                content: string;
+            };
+            image?: {
+                url?: string;
+                aeskey?: string;
+            };
+        }>;
+    };
+    file?: {
+        url?: string;
+        aeskey?: string;
+    };
+    quote?: {
+        msgtype: string;
+        text?: {
+            content: string;
+        };
+        voice?: {
+            content: string;
+        };
+        image?: {
+            url?: string;
+            aeskey?: string;
+        };
+        file?: {
+            url?: string;
+            aeskey?: string;
+        };
+    };
+}
+export interface ParsedMessageContent {
+    textParts: string[];
+    imageUrls: string[];
+    imageAesKeys: Map<string, string>;
+    fileUrls: string[];
+    fileAesKeys: Map<string, string>;
+    quoteContent: string | undefined;
+}
+/**
+ * 解析消息内容（支持单条消息、图文混排和引用消息）
+ * @returns 提取的文本数组、图片URL数组和引用消息内容
+ */
+export declare function parseMessageContent(body: MessageBody): ParsedMessageContent;