@youdu/openclaw-youdu 2026.5.8-3 → 2026.5.9

package/dist/src/channel.js

@@ -4,6 +4,7 @@ import { TEXT_CHUNK_LIMIT, CHANNEL_ID, DEFAULT_DM_POLICY } from './const.js';
 import { youduSetupAdapter, youduSetupWizard } from './onboarding.js';
 import { DEFAULT_ACCOUNT_ID, formatPairingApproveHint } from './openclaw-compat.js';
 import { getYouDuRuntime } from './runtime.js';
+import { sendYouDuMediaMessage, sendYouDuTextMessage } from './message-sender.js';
 
 /*
 * Licensed under the MIT License.
@@ -147,6 +148,26 @@ const youduPlugin = {
         deliveryMode: "gateway",
         chunker: (text, limit) => getYouDuRuntime().channel.text.chunkMarkdownText(text, limit),
         textChunkLimit: TEXT_CHUNK_LIMIT,
+        sendText: async ({ to, text, accountId }) => {
+            return sendYouDuTextMessage({
+                to,
+                text,
+                accountId,
+            });
+        },
+        sendMedia: async ({ cfg, to, text, mediaUrl, mediaLocalRoots, accountId }) => {
+            if (!mediaUrl) {
+                throw new Error("No media URL provided");
+            }
+            return sendYouDuMediaMessage({
+                cfg,
+                to,
+                text,
+                mediaUrl,
+                mediaLocalRoots,
+                accountId,
+            });
+        },
     },
     status: {
         defaultRuntime: {

package/dist/src/media.d.ts

@@ -3,7 +3,7 @@ import type { ResolvedYouDuAccount, YouDuConfig } from './utils.js';
 import { WSClient, WsFrame } from "./sdk/ws-client";
 import { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 export declare namespace Youdu {
-    const RequestTimeoutMs = 30000;
+    const requestTimeoutMs = 30000;
     type MediaKind = 'image' | 'file' | 'audio' | 'video';
     interface MediaBody {
         mediaId?: string;
@@ -34,8 +34,26 @@ export declare namespace Youdu {
         headers: IncomingHttpHeaders;
         body: Buffer;
     }
+    interface UploadMediaResponse {
+        kind?: string;
+        mediaId?: string;
+        name?: string;
+        contentType?: string;
+        size?: number;
+        width?: number;
+        height?: number;
+        duration?: number;
+        data?: {
+            mediaId?: string;
+            name?: string;
+            contentType?: string;
+            size?: number;
+            width?: number;
+            height?: number;
+            duration?: number;
+        };
+    }
 }
-export declare const YouDuRequestTimeoutMs = 30000;
 export declare function inferInboundMessageText(body: {
     text?: {
         content?: string;
@@ -49,6 +67,7 @@ export declare function inferInboundMessageText(body: {
     video?: Youdu.MediaBody;
 }): string;
 export declare function extractInboundMedia(body: {
+    msgType?: string;
     media?: Array<Youdu.MediaBody & {
         kind?: string;
     }>;
@@ -73,3 +92,8 @@ export declare function downloadInboundMedia(params: {
     config: YouDuConfig;
     token?: string;
 }): Promise<Array<Youdu.DownloadedInboundMedia>>;
+/**
+ * 统一构建有度发送媒体时可访问的本地路径白名单。
+ * 这样无论是回复链路还是官方 message send 链路，都能走同一套目录规则。
+ */
+export declare function resolveYouDuMediaLocalRoots(config?: YouDuConfig): Promise<string[]>;

package/dist/src/media.js

@@ -1,17 +1,18 @@
-import { loadOutboundMediaFromUrl } from './openclaw-compat.js';
+import { getDefaultMediaLocalRoots, resolveStateDir, loadOutboundMediaFromUrl } from './openclaw-compat.js';
 import * as path from 'path';
 import * as https from 'node:https';
 import { getYouDuRuntime } from './runtime.js';
-import { DEFAULT_MEDIA_MAX_SIZE, DOWNLOAD_MEDIA_URL, HTTP_SCHEME, PORT, UPLOAD_MEDIA_URL } from './const.js';
+import { UPLOAD_MEDIA_URL, DEFAULT_MEDIA_MAX_SIZE, DOWNLOAD_MEDIA_URL, HTTP_SCHEME, PORT } from './const.js';
 import { sendYouDuMediaReply } from './message-sender.js';
 import { buildYouDuTlsConnectOptions } from './tls.js';
+import os from 'os';
 
 /*
 * Licensed under the MIT License.
 */
 var Youdu;
 (function (Youdu) {
-    Youdu.RequestTimeoutMs = 30000;
+    Youdu.requestTimeoutMs = 30000;
 })(Youdu || (Youdu = {}));
 function getMediaAuthHeaders(token) {
     const headers = {};
@@ -77,8 +78,8 @@ function request(url, options) {
             });
         });
         req.on("error", reject);
-        req.setTimeout(Youdu.RequestTimeoutMs, () => {
-            req.destroy(new Error(`Youdu request timed out after ${Youdu.RequestTimeoutMs}ms`));
+        req.setTimeout(Youdu.requestTimeoutMs, () => {
+            req.destroy(new Error(`Youdu request timed out after ${Youdu.requestTimeoutMs}ms`));
         });
         if (options.body) {
             req.write(options.body);
@@ -102,6 +103,10 @@ function fallbackFileNameFromUrl(mediaUrl) {
 }
 function kindFromContentType(contentType) {
     const normalized = String(contentType ?? '').toLowerCase();
+    // SVG 更适合作为文件发送，避免被客户端按图片类型处理后无法正常展示或接收。
+    if (normalized === 'image/svg+xml') {
+        return 'file';
+    }
     if (normalized.startsWith('image/')) {
         return 'image';
     }
@@ -125,6 +130,15 @@ function kindLabel(kind) {
             return '[文件]';
     }
 }
+function readUploadedMediaField(payload, key) {
+    // 兼容两种上传返回格式：
+    // 1. 当前协议文档里的根级字段；
+    // 2. 旧实现里包在 data 下的字段。
+    if (payload[key] !== undefined && payload[key] !== null) {
+        return payload[key];
+    }
+    return payload.data?.[key];
+}
 function inferInboundMessageText(body) {
     const text = body.text?.content?.trim();
     if (text) {
@@ -139,6 +153,24 @@ function inferInboundMessageText(body) {
 }
 function extractInboundMedia(body) {
     const items = [];
+    // 某些回调里 media[] 只有 mediaId/name/size，没有显式 kind，
+    // 这里根据顶层 msgType 或具名媒体节点做一次回退推断。
+    const fallbackKindFromBody = (() => {
+        const normalizedMsgType = String(body.msgType ?? "").toLowerCase();
+        if (normalizedMsgType === "image" || body.image?.mediaId) {
+            return "image";
+        }
+        if (normalizedMsgType === "audio" || body.audio?.mediaId) {
+            return "audio";
+        }
+        if (normalizedMsgType === "video" || body.video?.mediaId) {
+            return "video";
+        }
+        if (normalizedMsgType === "file" || body.file?.mediaId) {
+            return "file";
+        }
+        return undefined;
+    })();
     const push = (kind, node) => {
         if (!node?.mediaId) {
             return;
@@ -163,6 +195,10 @@ function extractInboundMedia(body) {
             push(kind, media);
             continue;
         }
+        if (!kind && fallbackKindFromBody) {
+            push(fallbackKindFromBody, media);
+            continue;
+        }
         push('file', media);
     }
     if (items.length > 0) {
@@ -215,21 +251,21 @@ async function uploadOutboundMedia(params) {
         if (response.statusCode >= 400) {
             throw new Error(`upload media failed: ${response.statusCode} ${response.body.toString("utf8")}`);
         }
+        // 上传接口返回成功后，统一抽取 mediaId 和媒体元数据，供 send_msg/respond_msg 复用。
         const payload = JSON.parse(response.body.toString("utf8"));
-        const data = payload?.data ?? {};
-        const mediaId = String(data.mediaId ?? '');
+        const mediaId = String(readUploadedMediaField(payload, "mediaId") ?? "");
         if (!mediaId) {
             throw new Error('upload media failed: mediaId is missing');
         }
         return {
             kind,
             mediaId: mediaId,
-            name: String(data.name ?? fileName),
-            size: Number(data.size ?? media.buffer.length),
-            width: Number(data.width ?? 0) || undefined,
-            height: Number(data.height ?? 0) || undefined,
-            duration: Number(data.duration ?? 0) || undefined,
-            contentType: String(data.contentType ?? media.contentType ?? ''),
+            name: String(readUploadedMediaField(payload, "name") ?? fileName),
+            size: Number(readUploadedMediaField(payload, "size") ?? media.buffer.length),
+            width: Number(readUploadedMediaField(payload, "width") ?? 0) || undefined,
+            height: Number(readUploadedMediaField(payload, "height") ?? 0) || undefined,
+            duration: Number(readUploadedMediaField(payload, "duration") ?? 0) || undefined,
+            contentType: String(readUploadedMediaField(payload, "contentType") ?? media.contentType ?? ''),
         };
     }
     catch (error) {
@@ -248,13 +284,13 @@ function buildMediaMessageBody(media) {
     };
     switch (media.kind) {
         case 'image':
-            return { msgtype: 'image', image: payload };
+            return { msgType: 'image', image: payload };
         case 'audio':
-            return { msgtype: 'audio', audio: payload };
+            return { msgType: 'audio', audio: payload };
         case 'video':
-            return { msgtype: 'video', video: payload };
+            return { msgType: 'video', video: payload };
         default:
-            return { msgtype: 'file', file: payload };
+            return { msgType: 'file', file: payload };
     }
 }
 async function downloadInboundMedia(params) {
@@ -291,5 +327,24 @@ async function downloadInboundMedia(params) {
     }
     return mediaList;
 }
+/**
+ * 统一构建有度发送媒体时可访问的本地路径白名单。
+ * 这样无论是回复链路还是官方 message send 链路，都能走同一套目录规则。
+ */
+async function resolveYouDuMediaLocalRoots(config) {
+    const defaults = await getDefaultMediaLocalRoots();
+    const roots = new Set();
+    for (const root of defaults) {
+        roots.add(path.resolve(root));
+    }
+    roots.add(path.resolve(resolveStateDir()));
+    if (config?.mediaLocalRoots) {
+        for (const root of config.mediaLocalRoots) {
+            const resolved = path.resolve(root.replace(/^~(?=\/|$)/, os.homedir()));
+            roots.add(resolved);
+        }
+    }
+    return Array.from(roots);
+}
 
-export { Youdu, buildMediaMessageBody, downloadInboundMedia, extractInboundMedia, inferInboundMessageText, uploadAndSendMedia, uploadOutboundMedia };
+export { Youdu, buildMediaMessageBody, downloadInboundMedia, extractInboundMedia, inferInboundMessageText, resolveYouDuMediaLocalRoots, uploadAndSendMedia, uploadOutboundMedia };

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

@@ -1,6 +1,6 @@
 import { RuntimeEnv } from 'openclaw/plugin-sdk/runtime-env';
-import { WSClient, WsFrame } from './sdk/ws-client';
 import { type Youdu } from "./media";
+import { WSClient, WsFrame } from './sdk/ws-client';
 /**
  * 发送 YouDu 回复
  */
@@ -16,3 +16,30 @@ export declare function sendYouDuMediaReply(params: {
     mediaAttachment: Youdu.InboundMediaAttachment;
     runtime: RuntimeEnv;
 }): Promise<void>;
+/**
+ * 主动发送有度文本消息。
+ */
+export declare function sendYouDuTextMessage(params: {
+    to: string;
+    text: string;
+    accountId?: string | null;
+}): Promise<{
+    channel: string;
+    messageId: string;
+    chatId: string;
+}>;
+/**
+ * 主动发送有度媒体消息。
+ */
+export declare function sendYouDuMediaMessage(params: {
+    cfg: any;
+    to: string;
+    mediaUrl: string;
+    text?: string;
+    mediaLocalRoots?: readonly string[];
+    accountId?: string | null;
+}): Promise<{
+    channel: string;
+    messageId: string;
+    chatId: string;
+}>;

package/dist/src/message-sender.js

@@ -1,4 +1,8 @@
-import { buildMediaMessageBody } from './media.js';
+import { DEFAULT_ACCOUNT_ID } from './openclaw-compat.js';
+import { getDirectChatTarget, getYouDuWebSocket } from './state-manager.js';
+import { CHANNEL_ID } from './const.js';
+import { resolveYouDuMediaLocalRoots, uploadOutboundMedia, buildMediaMessageBody } from './media.js';
+import { resolveYouDuAccount } from './utils.js';
 
 /*
 * Licensed under the MIT License.
@@ -10,7 +14,7 @@ async function sendYouDuReply(params) {
     const { wsClient, frame, text, runtime } = params;
     try {
         await wsClient.reply(frame, {
-            msgtype: 'text',
+            msgType: 'text',
             text: { content: text },
         });
     }
@@ -31,5 +35,76 @@ async function sendYouDuMediaReply(params) {
         throw err;
     }
 }
+function getOutboundWsClient(accountId) {
+    const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+    const wsClient = getYouDuWebSocket(resolvedAccountId);
+    if (!wsClient) {
+        throw new Error(`WSClient not connected for account ${resolvedAccountId}`);
+    }
+    return wsClient;
+}
+function resolveOutboundChatId(target, accountId) {
+    const normalizedTarget = target.replace(new RegExp(`^${CHANNEL_ID}:`, "i"), "").trim();
+    if (/^\d+$/.test(normalizedTarget)) {
+        return normalizedTarget;
+    }
+    const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+    // 私聊主动发送优先复用运行期学习到的 account -> chatId 映射，
+    // 这样 message send 可以直接使用账号字符串作为目标。
+    const rememberedChatId = getDirectChatTarget(resolvedAccountId, normalizedTarget);
+    if (rememberedChatId) {
+        return rememberedChatId;
+    }
+    throw new Error(`Unknown YouDu direct target: ${normalizedTarget}. Send a message from that account to the bot first so the plugin can learn its numeric chatId.`);
+}
+/**
+ * 主动发送有度文本消息。
+ */
+async function sendYouDuTextMessage(params) {
+    const { to, text, accountId } = params;
+    const chatId = resolveOutboundChatId(to, accountId);
+    const wsClient = getOutboundWsClient(accountId);
+    const ack = await wsClient.sendMessage(chatId, {
+        msgType: "text",
+        text: { content: text },
+    });
+    return {
+        channel: CHANNEL_ID,
+        messageId: ack.headers?.reqId ?? `youdu-${Date.now()}`,
+        chatId,
+    };
+}
+/**
+ * 主动发送有度媒体消息。
+ */
+async function sendYouDuMediaMessage(params) {
+    const { cfg, to, mediaUrl, text, mediaLocalRoots, accountId } = params;
+    const chatId = resolveOutboundChatId(to, accountId);
+    const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+    const wsClient = getOutboundWsClient(resolvedAccountId);
+    const account = resolveYouDuAccount(cfg);
+    const effectiveMediaLocalRoots = mediaLocalRoots && mediaLocalRoots.length > 0
+        ? [...mediaLocalRoots]
+        : await resolveYouDuMediaLocalRoots(account.config);
+    // 先走 CGI 上传拿到 mediaId，再通过 send_msg 发送正式媒体消息。
+    const mediaAttachment = await uploadOutboundMedia({
+        account,
+        mediaUrl,
+        mediaLocalRoots: effectiveMediaLocalRoots,
+        token: wsClient.getToken(),
+    });
+    if (text?.trim()) {
+        await wsClient.sendMessage(chatId, {
+            msgType: "text",
+            text: { content: text.trim() },
+        });
+    }
+    const ack = await wsClient.sendMessage(chatId, buildMediaMessageBody(mediaAttachment));
+    return {
+        channel: CHANNEL_ID,
+        messageId: ack.headers?.reqId ?? `youdu-${Date.now()}`,
+        chatId,
+    };
+}
 
-export { sendYouDuMediaReply, sendYouDuReply };
+export { sendYouDuMediaMessage, sendYouDuMediaReply, sendYouDuReply, sendYouDuTextMessage };

package/dist/src/monitor.d.ts

@@ -6,17 +6,17 @@ import { type Youdu } from './media.js';
  * 消息体类型（待用户完善）
  */
 export interface YouDuMessageBody {
-    msgid: string;
-    chattype: 'single' | 'group';
-    chatid: string;
+    msgId: string;
+    chatType: 'single' | 'group';
+    chatId: string;
     from: {
         userId: string;
         account: string;
         name?: string;
     };
-    create_time?: number;
-    response_url?: string;
-    msgtype: string;
+    createTime?: number;
+    responseUrl?: string;
+    msgType: string;
     text?: {
         content: string;
     };

package/dist/src/monitor.js

@@ -3,15 +3,12 @@ import { getYouDuRuntime } from './runtime.js';
 import { resolveYouDuAccount } from './utils.js';
 import { WS_MAX_RECONNECT_ATTEMPTS, WS_HEARTBEAT_INTERVAL_MS, PORT, THINKING_MESSAGE, MESSAGE_PROCESS_TIMEOUT_MS, CHANNEL_ID, MEDIA_IMAGE_PLACEHOLDER, MEDIA_DOCUMENT_PLACEHOLDER } from './const.js';
 import { buildYouDuTlsConnectOptions } from './tls.js';
-import { cleanupAccount, startMessageStateCleanup, setYouDuWebSocket, stopMessageStateCleanup, setMessageState, deleteMessageState } from './state-manager.js';
+import { cleanupAccount, startMessageStateCleanup, setYouDuWebSocket, stopMessageStateCleanup, rememberDirectChatTarget, setMessageState, deleteMessageState } from './state-manager.js';
 import { checkDmPolicy } from './dm-policy.js';
 import { checkGroupPolicy } from './group-policy.js';
-import { extractInboundMedia, inferInboundMessageText, downloadInboundMedia, uploadAndSendMedia } from './media.js';
+import { extractInboundMedia, inferInboundMessageText, downloadInboundMedia, uploadAndSendMedia, resolveYouDuMediaLocalRoots } from './media.js';
 import { sendYouDuReply } from './message-sender.js';
 import { generateReqId } from './sdk/ws-utils.js';
-import path__default from 'path';
-import os from 'os';
-import { getDefaultMediaLocalRoots, resolveStateDir } from './openclaw-compat.js';
 
 /*
 * Licensed under the MIT License.
@@ -23,8 +20,8 @@ function buildMessageContext(frame, account, config, text, mediaList) {
     const senderAccount = String(body.from.account).trim();
     const senderName = String(body.from.name ?? "").trim();
     const senderDisplay = senderName ? `${senderAccount} (${senderName})` : senderAccount;
-    const chatId = body.chatid || senderAccount;
-    const chatType = body.chattype === 'group' ? 'group' : 'direct';
+    const chatId = body.chatId || senderAccount;
+    const chatType = body.chatType === 'group' ? 'group' : 'direct';
     const route = core.channel.routing.resolveAgentRoute({
         cfg: config,
         channel: CHANNEL_ID,
@@ -49,7 +46,7 @@ function buildMessageContext(frame, account, config, text, mediaList) {
         Body: messageBody,
         RawBody: messageBody,
         CommandBody: messageBody,
-        MessageSid: body.msgid,
+        MessageSid: body.msgId,
         From: chatType === 'group' ? `${CHANNEL_ID}:group:${chatId}` : `${CHANNEL_ID}:${senderId}`,
         To: `${CHANNEL_ID}:${chatId}`,
         SenderId: senderId,
@@ -58,14 +55,14 @@ function buildMessageContext(frame, account, config, text, mediaList) {
         AccountId: account.accountId,
         ChatType: chatType,
         ConversationLabel: fromLabel,
-        Timestamp: Date.now(),
+        Timestamp: body.createTime || Date.now(),
         Provider: CHANNEL_ID,
         Surface: CHANNEL_ID,
         OriginatingChannel: CHANNEL_ID,
         OriginatingTo: `${CHANNEL_ID}:${chatId}`,
         YouDuFrame: frame,
         CommandAuthorized: true,
-        ResponseUrl: body.response_url,
+        ResponseUrl: body.responseUrl,
         ReqId: frame.headers.reqId,
         MediaPath: mediaList[0]?.path,
         MediaType: mediaList[0]?.contentType,
@@ -83,11 +80,14 @@ function buildMessageContext(frame, account, config, text, mediaList) {
 async function processYouDuMessage(params) {
     const { frame, account, config, runtime, wsClient } = params;
     const body = frame.body;
-    const chatId = body.chatid;
+    const chatId = body.chatId;
     const youduAccount = String(body.from.account).trim();
-    const chatType = body.chattype === 'group' ? 'group' : 'direct';
-    const messageId = body.msgid;
+    const chatType = body.chatType === 'group' ? 'group' : 'direct';
+    const messageId = body.msgId;
     const youduConfig = resolveYouDuAccount(config).config;
+    if (chatType === "direct" && chatId && youduAccount) {
+        rememberDirectChatTarget(account.accountId, youduAccount, chatId);
+    }
     let text = '';
     const inboundMedia = extractInboundMedia(body);
     text = inferInboundMessageText(body);
@@ -335,23 +335,7 @@ function createSdkLogger(runtime, accountId) {
     };
 }
 async function getExtendedMediaLocalRoots(config) {
-    // 从兼容层获取默认白名单（内部已处理低版本 SDK 的 fallback）
-    const defaults = await getDefaultMediaLocalRoots();
-    const roots = [...defaults];
-    const stateDir = path__default.resolve(resolveStateDir());
-    if (!roots.includes(stateDir)) {
-        roots.push(stateDir);
-    }
-    // 合并用户在 YouDu 中配置的自定义路径
-    if (config?.mediaLocalRoots) {
-        for (const r of config.mediaLocalRoots) {
-            const resolved = path__default.resolve(r.replace(/^~(?=\/|$)/, os.homedir()));
-            if (!roots.includes(resolved)) {
-                roots.push(resolved);
-            }
-        }
-    }
-    return roots;
+    return resolveYouDuMediaLocalRoots(config);
 }
 /**
  * 监听 YouDu WebSocket 连接（主函数）

package/dist/src/sdk/ws-client.d.ts

@@ -14,6 +14,7 @@ export declare class WSClient extends EventEmitter {
     connect(): this;
     disconnect(): void;
     reply(frame: WsFrame, body: any, cmd?: string): Promise<WsFrame>;
+    sendMessage(chatId: string, body: any): Promise<WsFrame>;
     getToken(): string;
 }
 export type { Logger, WsFrame, WSClientOptions, WSClientEventMap, } from "./types";

package/dist/src/sdk/ws-client.js

@@ -1,7 +1,7 @@
 import { EventEmitter } from 'events';
 import { WsConnectionManager } from './ws-manager.js';
-import { DefaultLogger } from './ws-utils.js';
-export { WsCmd, WsErrCode } from './ws-utils.js';
+import { DefaultLogger, generateReqId, WsCmd } from './ws-utils.js';
+export { WsErrCode } from './ws-utils.js';
 
 /*
 * Licensed under the MIT License.
@@ -72,9 +72,13 @@ class WSClient extends EventEmitter {
         const reqId = frame.headers?.reqId || "";
         return this.wsManager.sendReply(reqId, body, cmd);
     }
+    sendMessage(chatId, body) {
+        const reqId = generateReqId(WsCmd.SEND_MSG);
+        return this.wsManager.sendReply(reqId, { chatId, ...body }, WsCmd.SEND_MSG);
+    }
     getToken() {
         return this.wsManager.getToken();
     }
 }
 
-export { DefaultLogger, WSClient };
+export { DefaultLogger, WSClient, WsCmd };

package/dist/src/sdk/ws-manager.js

@@ -106,11 +106,11 @@ class WsConnectionManager extends EventEmitter {
                     cmd: WsCmd.CALLBACK,
                     headers: { reqId: generateReqId("raw_text") },
                     body: {
-                        msgid: `msg_${Date.now()}`,
-                        chatid: "default_chat",
-                        chattype: "single",
+                        msgId: `msg_${Date.now()}`,
+                        chatId: "default_chat",
+                        chatType: "single",
                         from: { userid: "default_user" },
-                        msgtype: "text",
+                        msgType: "text",
                         text: { content: raw },
                     },
                 };

package/dist/src/state-manager.d.ts

@@ -22,6 +22,14 @@ export declare function setYouDuWebSocket(accountId: string, wsClient: WSClient)
  * 获取账户的 WebSocket 客户端
  */
 export declare function getYouDuWebSocket(accountId: string): WSClient | null;
+/**
+ * 记录私聊账号对应的数值 chatId。
+ */
+export declare function rememberDirectChatTarget(accountId: string, account: string, chatId: string): void;
+/**
+ * 读取私聊账号对应的数值 chatId。
+ */
+export declare function getDirectChatTarget(accountId: string, account: string): string | undefined;
 /**
  * 设置消息状态
  */

package/dist/src/state-manager.js

@@ -9,6 +9,8 @@ const wsClients = new Map();
 const messageStates = new Map();
 /** chatId 到 reqId 的映射 */
 const reqIdStore = new Map();
+/** 私聊账号到数值 chatId 的运行时映射 */
+const directChatStore = new Map();
 /** 清理定时器 */
 let cleanupTimer = null;
 /**
@@ -21,6 +23,33 @@ function setYouDuWebSocket(accountId, wsClient) {
     }
     wsClients.set(accountId, wsClient);
 }
+/**
+ * 获取账户的 WebSocket 客户端
+ */
+function getYouDuWebSocket(accountId) {
+    return wsClients.get(accountId) ?? null;
+}
+/**
+ * 记录私聊账号对应的数值 chatId。
+ */
+function rememberDirectChatTarget(accountId, account, chatId) {
+    const normalizedAccount = String(account).trim().toLowerCase();
+    const normalizedChatId = String(chatId).trim();
+    if (!normalizedAccount || !normalizedChatId) {
+        return;
+    }
+    directChatStore.set(`${accountId}:${normalizedAccount}`, normalizedChatId);
+}
+/**
+ * 读取私聊账号对应的数值 chatId。
+ */
+function getDirectChatTarget(accountId, account) {
+    const normalizedAccount = String(account).trim().toLowerCase();
+    if (!normalizedAccount) {
+        return undefined;
+    }
+    return directChatStore.get(`${accountId}:${normalizedAccount}`);
+}
 /**
  * 设置消息状态
  */
@@ -78,6 +107,11 @@ async function cleanupAccount(accountId, expectedClient) {
             reqIdStore.delete(key);
         }
     }
+    for (const key of directChatStore.keys()) {
+        if (key.startsWith(`${accountId}:`)) {
+            directChatStore.delete(key);
+        }
+    }
 }
 
-export { cleanupAccount, deleteMessageState, setMessageState, setYouDuWebSocket, startMessageStateCleanup, stopMessageStateCleanup };
+export { cleanupAccount, deleteMessageState, getDirectChatTarget, getYouDuWebSocket, rememberDirectChatTarget, setMessageState, setYouDuWebSocket, startMessageStateCleanup, stopMessageStateCleanup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdu/openclaw-youdu",
-  "version": "2026.5.8-3",
+  "version": "2026.5.9",
   "type": "module",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",