openclaw-plugin-yuanbao 2.8.0 → 2.9.0

package/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
     "id": "openclaw-plugin-yuanbao",
     "name": "元宝 Bot",
     "description": "Tencent YuanBao intelligent bot channel plugin",
-    "version": "2.8.0",
+    "version": "2.9.0",
     "channels": [
         "yuanbao"
     ],

package/dist/src/channel.js

@@ -1,16 +1,19 @@
 import { DEFAULT_ACCOUNT_ID, deleteAccountFromConfigSection, setAccountEnabledInConfigSection, } from 'openclaw/plugin-sdk/core';
 import { formatPairingApproveHint } from 'openclaw/plugin-sdk/mattermost';
-import { listYuanbaoAccountIds, resolveDefaultYuanbaoAccountId, resolveYuanbaoAccount } from './accounts.js';
+import { listYuanbaoAccountIds, resolveDefaultYuanbaoAccountId, resolveYuanbaoAccount, } from './accounts.js';
 import { yuanbaoConfigSchema } from './config-schema.js';
 import { yuanbaoOnboardingAdapter } from './onboarding.js';
 import { createLog } from './logger.js';
 import { yuanbaoSetupAdapter } from './setup.js';
-import { startYuanbaoWsGateway, getActiveWsClient } from './yuanbao-server/ws/index.js';
+import { startYuanbaoWsGateway, getActiveWsClient, } from './yuanbao-server/ws/index.js';
 import { getYuanbaoRuntime } from './runtime.js';
-import { sendYuanbaoMessage, sendYuanbaoGroupMessage } from './message-handler/index.js';
-import { initOutboundQueue, destroyOutboundQueue, getOutboundQueue } from './outbound-queue.js';
+import { sendYuanbaoMessage, sendYuanbaoGroupMessage, } from './message-handler/index.js';
+import { initOutboundQueue, destroyOutboundQueue, getOutboundQueue, } from './outbound-queue.js';
 import { ChatType, getGroupCode, parseTarget } from './targets.js';
-import { buildMessageToolHints, yuanbaoMessageActions } from './message-tool/index.js';
+import { buildMessageToolHints, yuanbaoMessageActions, } from './message-tool/index.js';
+import { validateMediaBeforeQueue } from './media.js';
+import { yuanbaoMessagingAdapter } from './messaging-adapter.js';
+import { yuanbaoDirectoryAdapter } from './directory-adapter.js';
 function toChannelResult(result) {
     return {
         channel: 'yuanbao',
@@ -35,15 +38,32 @@ async function sendTextToTarget(account, target, text, wsClient) {
             account,
             config: {},
             core: {},
-            log: { info: () => { }, warn: () => { }, error: () => { }, verbose: () => { } },
+            log: {
+                info: () => { },
+                warn: () => { },
+                error: () => { },
+                verbose: () => { },
+            },
             wsClient,
         }
         : undefined;
     const { chatType, target: targetId } = parseTarget(target, account.accountId);
     if (chatType === ChatType.GROUP) {
-        return sendYuanbaoGroupMessage({ account, groupCode: targetId, text, fromAccount: account.botId, ctx: minCtx });
+        return sendYuanbaoGroupMessage({
+            account,
+            groupCode: targetId,
+            text,
+            fromAccount: account.botId,
+            ctx: minCtx,
+        });
     }
-    return sendYuanbaoMessage({ account, toAccount: targetId, text, fromAccount: account.botId, ctx: minCtx });
+    return sendYuanbaoMessage({
+        account,
+        toAccount: targetId,
+        text,
+        fromAccount: account.botId,
+        ctx: minCtx,
+    });
 }
 const meta = {
     id: 'yuanbao',
@@ -57,12 +77,6 @@ const meta = {
     order: 85,
     quickstartAllowFrom: true,
 };
-function normalizeYuanbaoMessagingTarget(raw) {
-    const trimmed = raw.trim();
-    if (!trimmed)
-        return undefined;
-    return trimmed.replace(/^(yuanbao):/i, '').trim() || undefined;
-}
 export const yuanbaoPlugin = {
     id: 'yuanbao',
     meta,
@@ -117,7 +131,10 @@ export const yuanbaoPlugin = {
             tokenStatus: account.configured ? 'available' : 'missing',
         }),
         resolveAllowFrom: ({ cfg, accountId }) => {
-            const account = resolveYuanbaoAccount({ cfg: cfg, accountId });
+            const account = resolveYuanbaoAccount({
+                cfg: cfg,
+                accountId,
+            });
             return (account.config.dm?.allowFrom ?? []).map(entry => String(entry));
         },
         formatAllowFrom: ({ allowFrom }) => allowFrom
@@ -129,7 +146,9 @@ export const yuanbaoPlugin = {
         resolveDmPolicy: ({ cfg, accountId, account }) => {
             const resolvedAccountId = accountId ?? account.accountId ?? DEFAULT_ACCOUNT_ID;
             const useAccountPath = Boolean(cfg.channels?.yuanbao?.accounts?.[resolvedAccountId]);
-            const basePath = useAccountPath ? `channels.yuanbao.accounts.${resolvedAccountId}.` : 'channels.yuanbao.';
+            const basePath = useAccountPath
+                ? `channels.yuanbao.accounts.${resolvedAccountId}.`
+                : 'channels.yuanbao.';
             const policy = account.config.dm?.policy ?? 'open';
             const rawAllowFrom = (account.config.dm?.allowFrom ?? []).map(entry => String(entry));
             const allowFrom = policy === 'open' && !rawAllowFrom.includes('*')
@@ -151,13 +170,8 @@ export const yuanbaoPlugin = {
     threading: {
         resolveReplyToMode: () => 'all',
     },
-    messaging: {
-        normalizeTarget: normalizeYuanbaoMessagingTarget,
-        targetResolver: {
-            looksLikeId: raw => Boolean(raw.trim()),
-            hint: '<userid> or group:<groupcode>',
-        },
-    },
+    messaging: yuanbaoMessagingAdapter,
+    directory: yuanbaoDirectoryAdapter,
     agentPrompt: {
         messageToolHints() {
             return buildMessageToolHints();
@@ -175,7 +189,9 @@ export const yuanbaoPlugin = {
         deliveryMode: 'direct',
         chunkerMode: 'markdown',
         textChunkLimit: 3000,
-        chunker: (text, limit) => getYuanbaoRuntime()?.channel.text.chunkMarkdownText(text, limit) ?? [text],
+        chunker: (text, limit) => getYuanbaoRuntime()?.channel.text.chunkMarkdownText(text, limit) ?? [
+            text,
+        ],
         sendText: async (params) => {
             const { cfg, accountId, to: _to, text } = params;
             const to = _to.replace(/^yuanbao:/, '');
@@ -184,7 +200,12 @@ export const yuanbaoPlugin = {
             slog.info('sendText', { accountId, to });
             const wsClient = getActiveWsClient(account.accountId);
             if (!wsClient) {
-                return { channel: 'yuanbao', ok: false, messageId: '', error: new Error(`WebSocket client not connected for account ${account.accountId}`) };
+                return {
+                    channel: 'yuanbao',
+                    ok: false,
+                    messageId: '',
+                    error: new Error(`WebSocket client not connected for account ${account.accountId}`),
+                };
             }
             const queueManager = getOutboundQueue(account.accountId);
             if (queueManager) {
@@ -203,18 +224,28 @@ export const yuanbaoPlugin = {
             return toChannelResult(await sendTextToTarget(account, to, text, wsClient));
         },
         sendMedia: async (params) => {
-            const { cfg, accountId, to: _to, mediaUrl, text, mediaLocalRoots } = params;
+            const { cfg, accountId, to: _to, mediaUrl, text, mediaLocalRoots, } = params;
             const to = _to.replace(/^yuanbao:/, '');
             const account = resolveYuanbaoAccount({ cfg, accountId: accountId ?? undefined });
             const slog = createLog('channel.outbound');
             const wsClient = getActiveWsClient(account.accountId);
             slog.info('sendMedia', { accountId, to, mediaUrl, text });
             if (!wsClient) {
-                return { channel: 'yuanbao', ok: false, messageId: '', error: new Error(`WebSocket client not connected for account ${account.accountId}`) };
+                return {
+                    channel: 'yuanbao',
+                    ok: false,
+                    messageId: '',
+                    error: new Error(`WebSocket client not connected for account ${account.accountId}`),
+                };
             }
             if (!mediaUrl) {
                 return { channel: 'yuanbao', ok: true, messageId: '' };
             }
+            const validationError = validateMediaBeforeQueue(mediaUrl);
+            if (validationError) {
+                slog.error(`sendMedia 前置校验失败: ${validationError}`, { accountId, to, mediaUrl });
+                return { channel: 'yuanbao', ok: false, messageId: '', error: new Error(validationError) };
+            }
             const queueManager = getOutboundQueue(account.accountId);
             if (queueManager) {
                 const { chatType, target, sessionKey } = parseTarget(to, account.accountId);
@@ -232,7 +263,12 @@ export const yuanbaoPlugin = {
                 await session.flush();
                 return { channel: 'yuanbao', ok: true, messageId: '' };
             }
-            return { channel: 'yuanbao', ok: false, messageId: '', error: new Error('No session found') };
+            return {
+                channel: 'yuanbao',
+                ok: false,
+                messageId: '',
+                error: new Error('No session found'),
+            };
         },
     },
     status: {
@@ -274,7 +310,11 @@ export const yuanbaoPlugin = {
             slog.debug('启动账号', account);
             if (!account.configured) {
                 slog.warn('yuanbao not configured; skipping');
-                ctx.setStatus({ accountId: account.accountId, running: false, configured: false });
+                ctx.setStatus({
+                    accountId: account.accountId,
+                    running: false,
+                    configured: false,
+                });
                 return;
             }
             slog.info('使用 WebSocket 模式连接');

package/dist/src/commands/upgrade/upgrade.js

@@ -5,8 +5,32 @@ const INSTALL_SCRIPT_TIMEOUT_MS = 5 * 60 * 1000;
 var MessageEnum;
 (function (MessageEnum) {
     MessageEnum["REPAIR_BOT_CONFIG_GUIDE"] = "\u274C \u5347\u7EA7\u5931\u8D25\uFF0C\u8BF7\u524D\u5F80 Bot \u7BA1\u7406\u9875\u9762\u4F7F\u7528\u300C\u4FEE\u590D Bot \u914D\u7F6E\u300D\u529F\u80FD\u4FEE\u590D\u3002";
-    MessageEnum["AUTO_UPGRADE_FAILED_FALLBACK"] = "\u274C \u5347\u7EA7\u547D\u4EE4\u6267\u884C\u5931\u8D25\uFF0C\u5143\u5B9D\u521B\u5EFA\u7684 Bot \u53EF\u524D\u5F80\u300CBot \u8BBE\u7F6E\u300D\u70B9\u51FB\u300C\u66F4\u65B0\u63D2\u4EF6\u300D\u8FDB\u884C\u5347\u7EA7\u3002";
+    MessageEnum["AUTO_UPGRADE_FAILED_FALLBACK"] = "\u274C \u5347\u7EA7\u547D\u4EE4\u6267\u884C\u5931\u8D25\uFF0C\u5143\u5B9D\u521B\u5EFA\u7684 Bot \u53EF\u524D\u5F80\u300CBot \u8BBE\u7F6E\u300D\u70B9\u51FB\u300C\u66F4\u65B0\u63D2\u4EF6\u300D\u8FDB\u884C\u5347\u7EA7\uFF0C\u975E\u5143\u5B9D\u521B\u5EFA\u7684Bot\uFF0C\u8BF7\u524D\u5F80\u5404\u81EA\u5E73\u53F0\u624B\u52A8\u66F4\u65B0\u3002";
+    MessageEnum["RATE_LIMITED"] = "\u274C \u5347\u7EA7\u5931\u8D25\uFF0C\u5F53\u524D\u670D\u52A1\u7E41\u5FD9\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002\u5143\u5B9D\u521B\u5EFA\u7684 Bot \u53EF\u524D\u5F80\u300CBot \u8BBE\u7F6E\u300D\u70B9\u51FB\u300C\u66F4\u65B0\u63D2\u4EF6\u300D\u8FDB\u884C\u5347\u7EA7\u3002";
 })(MessageEnum || (MessageEnum = {}));
+async function verifyVersionAfterFailedCommand(params) {
+    const { currentVersion, targetVersion, commandResult, commandName } = params;
+    const installedVersion = await readInstalledVersion(PLUGIN_ID);
+    const upgraded = !!installedVersion && ((targetVersion != null && installedVersion === targetVersion)
+        || (targetVersion == null && currentVersion != null && installedVersion !== currentVersion));
+    if (upgraded) {
+        log.warn(`${commandName} 安装命令执行异常，但版本已更新成功`, {
+            currentVersion,
+            targetVersion,
+            installedVersion,
+            error: commandResult.error,
+        });
+        return { upgraded: true, installedVersion };
+    }
+    log.error(`${commandName} 执行失败`, {
+        currentVersion,
+        targetVersion,
+        installedVersion: installedVersion ?? '(读取失败)',
+        error: commandResult.error,
+        rateLimited: !!commandResult.rateLimited,
+    });
+    return { upgraded: false, installedVersion, rateLimited: !!commandResult.rateLimited };
+}
 async function runSpecifiedVersionFlow(params) {
     const { targetVersion: _targetVersion, currentVersion, config, onProgress, } = params;
     const hasTargetVersion = !!_targetVersion;
@@ -85,12 +109,19 @@ async function runSpecifiedVersionFlow(params) {
         };
     }
     if (!installResult.ok) {
-        log.error('指定版本安装失败：安装步骤失败', { targetVersion, error: installResult.error });
-        return {
-            ok: false,
-            error: installResult.error ?? '插件安装失败',
-            message: MessageEnum.REPAIR_BOT_CONFIG_GUIDE,
-        };
+        const verify = await verifyVersionAfterFailedCommand({
+            currentVersion,
+            targetVersion: targetVersion ?? null,
+            commandResult: installResult,
+            commandName: 'plugins install',
+        });
+        if (!verify.upgraded) {
+            return {
+                ok: false,
+                error: installResult.error ?? '插件安装失败',
+                message: verify.rateLimited ? MessageEnum.RATE_LIMITED : MessageEnum.REPAIR_BOT_CONFIG_GUIDE,
+            };
+        }
     }
     log.info('指定版本安装流程完成', { targetVersion, hasSnapshot: !!restoreSnapshotJson });
     await onProgress?.(currentVersion
@@ -116,8 +147,23 @@ async function runRegularUpgradeFlow(params) {
         commandName: 'plugins update',
     });
     if (!updateResult.ok) {
-        log.warn('更新命令执行失败', { error: updateResult.error, ...(updateResult.stderr ? { stderr: updateResult.stderr } : {}) });
-        return { ok: false, error: updateResult.error ?? '常规升级失败' };
+        const verify = await verifyVersionAfterFailedCommand({
+            currentVersion,
+            targetVersion: latestStableVersion,
+            commandResult: updateResult,
+            commandName: 'plugins update',
+        });
+        if (verify.upgraded) {
+            await onProgress?.(latestStableVersion
+                ? `✅ 更新成功！**元宝 Bot 插件**已从 v${currentVersion} 升级至 v${latestStableVersion}`
+                : `✅ 更新成功！**元宝 Bot 插件**已更新至 v${verify.installedVersion}`);
+            return { ok: true };
+        }
+        return {
+            ok: false,
+            error: updateResult.error ?? '常规升级失败',
+            message: verify.rateLimited ? MessageEnum.RATE_LIMITED : undefined,
+        };
     }
     if (updateResult.stdout?.includes('No install record')) {
         return { ok: false, error: updateResult.error ?? '常规升级失败，需要重新安装', needToInstall: true };

package/dist/src/commands/upgrade/utils.d.ts

@@ -19,4 +19,6 @@ export declare function runOpenClawCommandWithRetry(params: {
         nextAttempt: number;
         maxAttempts: number;
     }) => Promise<void>;
-}): Promise<Awaited<ReturnType<typeof runOpenClawCommand>>>;
+}): Promise<Awaited<ReturnType<typeof runOpenClawCommand>> & {
+    rateLimited?: boolean;
+}>;

package/dist/src/commands/upgrade/utils.js

@@ -131,18 +131,16 @@ export async function isPublishedVersionOnNpm(version) {
 }
 export async function readInstalledVersion(pluginId) {
     log.info('读取已安装版本', { pluginId });
-    const result = await runOpenClawCommand(['plugins', 'list']);
+    const result = await runOpenClawCommand(['plugins', 'info', pluginId]);
     if (!result.ok) {
-        log.warn('openclaw plugins list 执行失败', { summary: result.error, ...(result.stderr ? { stderr: result.stderr } : {}) });
+        log.warn('openclaw plugins info 执行失败', { summary: result.error, ...(result.stderr ? { stderr: result.stderr } : {}) });
         return null;
     }
     for (const line of (result.stdout ?? '').split('\n')) {
-        if (line.toLowerCase().includes(pluginId.toLowerCase())) {
-            const match = line.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
-            if (match) {
-                log.info('已安装版本', { pluginId, version: match[1] });
-                return match[1];
-            }
+        const match = line.match(/^Version:\s*(\d+\.\d+\.\d+(?:-[\w.]+)?)/i);
+        if (match) {
+            log.info('已安装版本', { pluginId, version: match[1] });
+            return match[1];
         }
     }
     log.warn('未检测到已安装版本', { pluginId });
@@ -199,8 +197,12 @@ export async function runOpenClawCommandWithRetry(params) {
         if (lastResult.ok)
             return lastResult;
         const retriable = isRateLimitPluginCommandError(lastResult);
-        if (!retriable || attempt >= PLUGIN_CMD_RETRY_MAX_ATTEMPTS)
+        if (!retriable || attempt >= PLUGIN_CMD_RETRY_MAX_ATTEMPTS) {
+            if (retriable) {
+                return { ...lastResult, rateLimited: true };
+            }
             break;
+        }
         const nextAttempt = attempt + 1;
         const retryDelayMs = PLUGIN_CMD_RETRY_DELAY_MS * attempt;
         log.warn('openclaw plugin 命令触发限频，准备重试', {

package/dist/src/directory-adapter.d.ts

@@ -0,0 +1,2 @@
+import type { ChannelPlugin } from 'openclaw/plugin-sdk';
+export declare const yuanbaoDirectoryAdapter: NonNullable<ChannelPlugin<any>['directory']>;

package/dist/src/directory-adapter.js

@@ -0,0 +1,58 @@
+import { getMember } from './module/member.js';
+function toUserEntry(u) {
+    return { kind: 'user', id: u.userId, name: u.nickName };
+}
+function toGroupEntry(g) {
+    return { kind: 'group', id: g };
+}
+function applyLimit(arr, limit) {
+    return limit != null && limit > 0 ? arr.slice(0, limit) : arr;
+}
+export const yuanbaoDirectoryAdapter = {
+    async listPeers({ accountId, query, limit }) {
+        const member = getMember(accountId ?? 'default');
+        if (query?.trim()) {
+            const q = query.trim().toLowerCase();
+            const seen = new Set();
+            const entries = [];
+            const collect = (users) => {
+                for (const u of users) {
+                    if (!seen.has(u.userId) && u.nickName.toLowerCase().includes(q)) {
+                        seen.add(u.userId);
+                        entries.push(toUserEntry(u));
+                    }
+                }
+            };
+            collect(member.listC2cUsers());
+            for (const code of member.listGroupCodes()) {
+                collect(member.lookupUsers(code));
+            }
+            return applyLimit(entries, limit);
+        }
+        const seen = new Set();
+        const entries = [];
+        const collect = (users) => {
+            for (const u of users) {
+                if (!seen.has(u.userId)) {
+                    seen.add(u.userId);
+                    entries.push(toUserEntry(u));
+                }
+            }
+        };
+        collect(member.listC2cUsers());
+        for (const code of member.listGroupCodes()) {
+            collect(member.lookupUsers(code));
+        }
+        return applyLimit(entries, limit);
+    },
+    async listGroups({ accountId, limit }) {
+        const member = getMember(accountId ?? 'default');
+        const codes = member.listGroupCodes();
+        return applyLimit(codes.map(toGroupEntry), limit);
+    },
+    async listGroupMembers({ accountId, groupId, limit }) {
+        const member = getMember(accountId ?? 'default');
+        const users = await member.queryMembers(groupId);
+        return applyLimit(users.map(toUserEntry), limit);
+    },
+};

package/dist/src/media.d.ts

@@ -23,6 +23,7 @@ export declare function parseImageSize(buf: Buffer): {
     width: number;
     height: number;
 } | undefined;
+export declare function validateMediaBeforeQueue(url: string): string | null;
 export declare function downloadMediaForYuanbao(url: string, maxMb?: number, account?: ResolvedYuanbaoAccount): Promise<MediaFile>;
 export declare function uploadMediaToCos(mediaFile: MediaFile, account: ResolvedYuanbaoAccount, onProgress?: (percent: number) => void): Promise<MediaUploadResult>;
 export declare function downloadAndUploadMedia(mediaUrl: string, core: PluginRuntime, account: ResolvedYuanbaoAccount, mediaLocalRoots?: string[], onProgress?: (percent: number) => void): Promise<MediaUploadResult>;

package/dist/src/media.js

@@ -1,9 +1,10 @@
-import { createReadStream, statSync, existsSync } from 'node:fs';
+import { createReadStream, statSync, existsSync, openSync, readSync, closeSync } from 'node:fs';
 import { writeFile, mkdir } from 'node:fs/promises';
 import { tmpdir, homedir } from 'node:os';
 import path, { basename, extname, join } from 'node:path';
 import { randomBytes, createHash } from 'node:crypto';
 import { apiGetDownloadUrl, apiGetUploadInfo } from './yuanbao-server/api.js';
+import { logger } from './logger.js';
 const DEFAULT_MAX_MB = 20;
 export const IMAGE_EXTS = new Set(['.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp', '.heic', '.tiff', '.ico']);
 export function guessMimeType(filename) {
@@ -148,6 +149,134 @@ function normalizePath(s) {
     }
     return p;
 }
+function readMagicBytes(filePath, n = 16) {
+    const buf = Buffer.alloc(n);
+    const fd = openSync(filePath, 'r');
+    try {
+        const bytesRead = readSync(fd, buf, 0, n, 0);
+        return buf.subarray(0, bytesRead);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function isMagicJpeg(h) {
+    return h.length >= 3 && h[0] === 0xff && h[1] === 0xd8 && h[2] === 0xff;
+}
+function isMagicPng(h) {
+    return h.length >= 8
+        && h[0] === 0x89 && h[1] === 0x50 && h[2] === 0x4e && h[3] === 0x47
+        && h[4] === 0x0d && h[5] === 0x0a && h[6] === 0x1a && h[7] === 0x0a;
+}
+function isMagicGif(h) {
+    if (h.length < 6)
+        return false;
+    const sig = h.toString('ascii', 0, 6);
+    return sig === 'GIF87a' || sig === 'GIF89a';
+}
+function isMagicWebp(h) {
+    return h.length >= 12
+        && h.toString('ascii', 0, 4) === 'RIFF'
+        && h.toString('ascii', 8, 12) === 'WEBP';
+}
+function isMagicBmp(h) {
+    return h.length >= 2 && h[0] === 0x42 && h[1] === 0x4d;
+}
+function isMagicPdf(h) {
+    return h.length >= 4 && h.toString('ascii', 0, 4) === '%PDF';
+}
+function isMagicZip(h) {
+    return h.length >= 3 && h[0] === 0x50 && h[1] === 0x4b && (h[2] === 0x03 || h[2] === 0x05);
+}
+function getTextSnippet(h) {
+    const start = (h[0] === 0xef && h[1] === 0xbb && h[2] === 0xbf) ? 3 : 0;
+    return h.toString('utf8', start).trimStart()
+        .toLowerCase();
+}
+function isMagicHtml(h) {
+    const s = getTextSnippet(h);
+    return s.startsWith('<!doctype html')
+        || s.startsWith('<html')
+        || s.startsWith('<head')
+        || s.startsWith('<body');
+}
+function isMagicXml(h) {
+    const s = getTextSnippet(h);
+    return s.startsWith('<?xml') || s.startsWith('<svg');
+}
+function isMagicPrintableText(h) {
+    const start = (h[0] === 0xef && h[1] === 0xbb && h[2] === 0xbf) ? 3 : 0;
+    return h.length > start && h.subarray(start).every(b => b === 0x09 || b === 0x0a || b === 0x0d || (b >= 0x20 && b <= 0x7e));
+}
+function detectMagicFamily(header) {
+    if (header.length < 2)
+        return 'unknown';
+    if (isMagicJpeg(header))
+        return 'jpeg';
+    if (isMagicPng(header))
+        return 'png';
+    if (isMagicGif(header))
+        return 'gif';
+    if (isMagicWebp(header))
+        return 'webp';
+    if (isMagicBmp(header))
+        return 'bmp';
+    if (isMagicPdf(header))
+        return 'pdf';
+    if (isMagicZip(header))
+        return 'zip';
+    if (isMagicHtml(header))
+        return 'html';
+    if (isMagicXml(header))
+        return 'xml';
+    if (isMagicPrintableText(header))
+        return 'text';
+    return 'unknown';
+}
+const IMAGE_EXT_TO_EXPECTED_FAMILY = {
+    '.jpg': ['jpeg'],
+    '.jpeg': ['jpeg'],
+    '.png': ['png'],
+    '.gif': ['gif'],
+    '.webp': ['webp'],
+    '.bmp': ['bmp'],
+};
+export function validateMediaBeforeQueue(url) {
+    if (!url) {
+        return '媒体 URL 为空';
+    }
+    if (!isLocalPath(url)) {
+        return null;
+    }
+    const filePath = normalizePath(url);
+    if (!existsSync(filePath)) {
+        return `文件不存在: ${filePath}`;
+    }
+    let stat;
+    try {
+        stat = statSync(filePath);
+    }
+    catch (err) {
+        return `无法读取文件信息: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    if (stat.size === 0) {
+        return `文件内容为空（0 字节）: ${filePath}`;
+    }
+    let header;
+    try {
+        header = readMagicBytes(filePath, 16);
+    }
+    catch (err) {
+        return null;
+    }
+    const actual = detectMagicFamily(header);
+    const ext = extname(filePath).toLowerCase();
+    const expected = IMAGE_EXT_TO_EXPECTED_FAMILY[ext];
+    if (expected && !expected.includes(actual)) {
+        return `文件扩展名 ${ext} 与实际内容不符（期望 ${expected.join('/')}, 检测到 ${actual}）: ${filePath}`;
+    }
+    return null;
+}
 const MIME_TO_EXT = {
     'image/jpeg': '.jpg',
     'image/png': '.png',
@@ -357,6 +486,7 @@ export async function downloadMediasToLocalFiles(medias, account, core, log) {
     const maxBytes = account.mediaMaxMb * 1024 * 1024;
     const cacheDir = join(tmpdir(), 'yuanbao-media');
     const tasks = medias.slice(0, 20).map(async ({ url, mediaName }, i) => {
+        logger.info(`开始解析资源: ${url}`);
         const mediaFile = await downloadMediaForYuanbao(url, account.mediaMaxMb, account);
         const originalFilename = mediaName || mediaFile.filename;
         const ext = extname(originalFilename).toLowerCase();
@@ -368,7 +498,7 @@ export async function downloadMediasToLocalFiles(medias, account, core, log) {
         }
         const cachedFilePath = join(cacheDir, md5Filename);
         if (existsSync(cachedFilePath)) {
-            log.verbose(`媒体 ${i + 1}/${medias.length} 命中本地缓存，跳过保存: ${cachedFilePath}`);
+            logger.info(`媒体 ${i + 1}/${medias.length} 命中本地缓存，跳过保存: ${cachedFilePath}`);
             return { path: cachedFilePath, contentType };
         }
         if (typeof core.channel.media?.saveMediaBuffer === 'function') {
@@ -385,10 +515,10 @@ export async function downloadMediasToLocalFiles(medias, account, core, log) {
         const r = settled[i];
         if (r.status === 'fulfilled') {
             results.push(r.value);
-            log.verbose(`媒体 ${i + 1}/${medias.length} 下载完成: ${r.value.path} (${r.value.contentType})`);
+            logger.info(`媒体 ${i + 1}/${medias.length} 下载完成: ${r.value.path} (${r.value.contentType})`);
         }
         else {
-            log.warn(`媒体 ${i + 1}/${medias.length} 下载失败，跳过: ${String(r.reason)}`);
+            logger.warn(`媒体 ${i + 1}/${medias.length} 下载失败，跳过: ${String(r.reason)}`);
         }
     }
     return {

package/dist/src/message-handler/handlers/index.js

@@ -6,6 +6,7 @@ import { fileHandler } from './file.js';
 import { videoHandler } from './video.js';
 import { faceHandler } from './face.js';
 import { sanitizePipeTables } from '../../utils/markdown-table-sanitize.js';
+import { normalizeMathBlocks } from '../../utils/markdown-stream.js';
 const handlerList = [
     textHandler,
     customHandler,
@@ -76,7 +77,7 @@ function resolveAtMentions(text, groupCode, memberInst) {
 export function prepareOutboundContent(text, groupCode, memberInst) {
     if (!text)
         return [];
-    const sanitizedText = sanitizePipeTables(text);
+    const sanitizedText = sanitizePipeTables(normalizeMathBlocks(text));
     const items = [];
     if (sanitizedText.length) {
         const trailing = sanitizedText.trim();

package/dist/src/message-handler/inbound.js

@@ -128,6 +128,7 @@ async function handleC2CMessage(params) {
         return;
     }
     const { rawBody, medias } = extractTextFromMsgBody(ctx, msg.msg_body);
+    getMember(account.accountId).recordC2cUser(fromAccount, senderNickname || fromAccount);
     log.info(`收到消息 <- ${fromAccount}${senderNickname ? `(${senderNickname})` : ''}, msgKey: ${msg.msg_key}`);
     const quoteInfo = parseQuoteFromCloudCustomData(msg.cloud_custom_data);
     if (quoteInfo) {
@@ -243,7 +244,7 @@ async function handleC2CMessage(params) {
         AccountId: route.accountId,
         ChatType: 'direct',
         ConversationLabel: fromLabel,
-        SenderName: senderNickname || fromAccount,
+        SenderName: senderNickname,
         SenderId: fromAccount,
         Provider: 'yuanbao',
         Surface: 'yuanbao',
@@ -513,7 +514,7 @@ async function handleGroupMessage(params) {
         ChatType: 'group',
         ConversationLabel: groupLabel,
         GroupSubject: msg.group_name || undefined,
-        SenderName: senderNickname || fromAccount,
+        SenderName: senderNickname,
         SenderId: fromAccount,
         Provider: 'yuanbao',
         Surface: 'yuanbao',

package/dist/src/message-tool/hints.js

@@ -3,8 +3,8 @@ export function buildMessageToolHints() {
         'Sticker/react/贴纸 fully supported, no extra setup. react = sticker = 发贴纸 (NOT a message reaction). Use sticker-search then sticker/react. No bare Unicode emoji.',
         'File/image sending is supported. Use media/mediaUrls with real URLs or absolute paths, not link-only text.',
         'IMPORTANT: When sending files, always use absolute paths (e.g. /tmp/file.md). Never use relative paths like "hello.md" — they will fail.',
-        '- Proactive `send` to another user: `to="<userId>"`.',
-        '- When asked to send a DM, extract the recipient and message from the user\'s request. If either is ambiguous, ask for clarification before calling the tool.',
-        '- To find a user\'s ID, use the query_session_members tool first, then pass the resolved ID to the message tool.',
+        '(Group only) - Proactive `send` to another user: `to="<userId>"`.',
+        '(Group only) - When asked to send a DM, extract the recipient and message from the user\'s request. If either is ambiguous, ask for clarification before calling the tool.',
+        '(Group only) - To find a user\'s ID, use the query_session_members tool first, then pass the resolved ID to the message tool.',
     ];
 }

package/dist/src/messaging-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { ChannelPlugin } from 'openclaw/plugin-sdk';
+export declare function normalizeYuanbaoMessagingTarget(raw: string): string | undefined;
+export declare function yuanbaoLooksLikeId(raw: string): boolean;
+export declare const yuanbaoMessagingAdapter: ChannelPlugin<any>['messaging'];

package/dist/src/messaging-adapter.js

@@ -0,0 +1,31 @@
+export function normalizeYuanbaoMessagingTarget(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/^(yuanbao):/i, '').trim() || undefined;
+}
+export function yuanbaoLooksLikeId(raw) {
+    if (/(group:|user:|direct:|yuanbao:)/.test(raw))
+        return true;
+    try {
+        const userId = raw.split(':').pop();
+        const sourceStr = atob(userId);
+        return sourceStr.length >= 16;
+    }
+    catch {
+        return false;
+    }
+}
+export const yuanbaoMessagingAdapter = {
+    normalizeTarget: normalizeYuanbaoMessagingTarget,
+    targetResolver: {
+        looksLikeId: yuanbaoLooksLikeId,
+        hint: '<chatId|group:groupCode|direct:userId|userId>',
+    },
+    inferTargetChatType: ({ to }) => {
+        const stripped = to.replace(/^yuanbao:/i, '');
+        if (stripped.includes('group:') || /^\d{9}$/.test(stripped))
+            return 'group';
+        return 'direct';
+    },
+};

package/dist/src/module/member.d.ts

@@ -35,6 +35,7 @@ export declare class GroupMember {
     lookupUsers(groupCode: string, nameFilter?: string): UserRecord[];
     lookupUserByNickName(groupCode: string, nickName: string): UserRecord | undefined;
     hasCachedData(groupCode: string): boolean;
+    listCachedGroupCodes(): string[];
     refresh(groupCode: string): Promise<UserRecord[]>;
     queryGroupOwner(groupCode: string): Promise<GroupOwnerInfo | null>;
     queryGroupInfo(groupCode: string): Promise<GroupInfoData | null>;
@@ -50,9 +51,13 @@ export declare class Member {
     readonly session: SessionMember;
     readonly group: GroupMember;
     private yuanbaoUserIdCache;
+    private c2cUsers;
     constructor(accountId: string);
     recordUser(groupCode: string, userId: string, nickName: string): void;
+    recordC2cUser(userId: string, nickName: string): void;
+    listC2cUsers(): UserRecord[];
     queryMembers(groupCode: string, nameFilter?: string): Promise<UserRecord[]>;
+    queryUserIdsByNickName(nickName: string, groupCode?: string): Promise<string[]>;
     lookupUsers(groupCode: string, nameFilter?: string): UserRecord[];
     lookupUserByNickName(groupCode: string, nickName: string): UserRecord | undefined;
     queryGroupOwner(groupCode: string): Promise<GroupOwnerInfo | null>;

package/dist/src/module/member.js

@@ -118,6 +118,9 @@ export class GroupMember {
     hasCachedData(groupCode) {
         return this.cache.has(groupCode);
     }
+    listCachedGroupCodes() {
+        return Array.from(this.cache.keys());
+    }
     async refresh(groupCode) {
         this.cache.delete(groupCode);
         return this.getMembers(groupCode);
@@ -241,6 +244,7 @@ export class Member {
     session = new SessionMember();
     group;
     yuanbaoUserIdCache = null;
+    c2cUsers = new Map();
     constructor(accountId) {
         this.accountId = accountId;
         this.group = new GroupMember(accountId, this.session);
@@ -248,6 +252,19 @@ export class Member {
     recordUser(groupCode, userId, nickName) {
         this.session.recordUser(groupCode, userId, nickName);
     }
+    recordC2cUser(userId, nickName) {
+        if (!userId)
+            return;
+        this.c2cUsers.set(userId, {
+            userId,
+            nickName: nickName || 'unknown',
+            lastSeen: Date.now(),
+        });
+        logger.debug?.(`[member] recorded c2c user: ${nickName ?? '?'} (${userId})`);
+    }
+    listC2cUsers() {
+        return Array.from(this.c2cUsers.values()).sort((a, b) => b.lastSeen - a.lastSeen);
+    }
     async queryMembers(groupCode, nameFilter) {
         const groupMembers = await this.group.getMembers(groupCode);
         if (groupMembers.length > 0) {
@@ -261,6 +278,37 @@ export class Member {
         logger.debug?.(`[member] GroupMember empty or no match, fallback to SessionMember for group=${groupCode}`);
         return this.session.lookupUsers(groupCode, nameFilter);
     }
+    async queryUserIdsByNickName(nickName, groupCode) {
+        const filter = nickName.trim().toLowerCase();
+        const seen = new Set();
+        const results = [];
+        const collect = (users) => {
+            for (const u of users) {
+                if (!seen.has(u.userId) && u.nickName.toLowerCase().includes(filter)) {
+                    seen.add(u.userId);
+                    results.push(u.userId);
+                }
+            }
+        };
+        collect(this.listC2cUsers());
+        if (groupCode) {
+            const members = await this.group.getMembers(groupCode);
+            const source = members.length > 0 ? members : this.session.lookupUsers(groupCode);
+            collect(source);
+        }
+        else {
+            const allGroupCodes = new Set([
+                ...this.group.listCachedGroupCodes(),
+                ...this.session.listGroupCodes(),
+            ]);
+            for (const code of allGroupCodes) {
+                const groupCached = this.group.lookupUsers(code);
+                collect(groupCached.length > 0 ? groupCached : this.session.lookupUsers(code));
+            }
+        }
+        logger.debug?.(`[member] queryUserIdsByNickName: "${nickName}"${groupCode ? ` in group=${groupCode}` : ' (all sources)'} → ${results.length} hit(s)`);
+        return results;
+    }
     lookupUsers(groupCode, nameFilter) {
         const groupResults = this.group.lookupUsers(groupCode, nameFilter);
         if (groupResults.length > 0)

package/dist/src/outbound-queue.d.ts

@@ -72,18 +72,6 @@ export interface OutboundQueueConfig {
 export declare function initOutboundQueue(accountId: string, config: OutboundQueueConfig): OutboundQueueManager;
 export declare function getOutboundQueue(accountId: string): OutboundQueueManager | null;
 export declare function destroyOutboundQueue(accountId: string): void;
-export declare function endsWithTableRow(text: string): boolean;
-export declare function hasUnclosedFence(text: string): boolean;
-export declare function startsWithBlockElement(text: string): boolean;
-export declare function inferBlockSeparator(buffer: string, incoming: string): string;
-export type AtomicBlock = {
-    start: number;
-    end: number;
-    kind: 'table' | 'diagram-fence';
-};
-export declare function extractAtomicBlocks(text: string): AtomicBlock[];
-export declare function chunkMarkdownTextAtomicAware(text: string, maxChars: number, chunkFn: (text: string, max: number) => string[]): string[];
-export declare function mergeBlockStreamingFences(buffer: string, incoming: string): string;
 export interface MergeTextOptions {
     minChars: number;
     maxChars: number;

package/dist/src/outbound-queue.js

@@ -6,6 +6,7 @@ import { sendStickerYuanbao } from './sticker/sticker-sender.js';
 import { getYuanbaoRuntime } from './runtime.js';
 import { buildFileMsgBody, buildImageMsgBody, downloadAndUploadMedia, guessMimeType } from './media.js';
 import { createReplyHeartbeatController } from './module/reply-heartbeat.js';
+import { endsWithTableRow, hasUnclosedFence, inferBlockSeparator, mergeBlockStreamingFences, chunkMarkdownTextAtomicAware, } from './utils/markdown-stream.js';
 const activeManagers = new Map();
 export function initOutboundQueue(accountId, config) {
     const log = createLog('outbound-queue');
@@ -361,185 +362,6 @@ function createMergeOnFlushSession(callbacks, msgId, onComplete, log, heartbeatM
         },
     };
 }
-export function endsWithTableRow(text) {
-    const trimmed = text.trimEnd();
-    if (!trimmed)
-        return false;
-    const lastLine = trimmed.split('\n').at(-1) ?? '';
-    const line = lastLine.trim();
-    return line.startsWith('|') && line.endsWith('|');
-}
-export function hasUnclosedFence(text) {
-    let inFence = false;
-    for (const line of text.split('\n')) {
-        if (line.startsWith('```'))
-            inFence = !inFence;
-    }
-    return inFence;
-}
-export function startsWithBlockElement(text) {
-    const firstLine = (text.trimStart().split('\n')[0] ?? '').trimStart();
-    return /^#{1,6}\s/.test(firstLine)
-        || firstLine.startsWith('---')
-        || firstLine.startsWith('***')
-        || firstLine.startsWith('___')
-        || firstLine.startsWith('> ')
-        || firstLine.startsWith('```')
-        || /^[*\-+]\s/.test(firstLine)
-        || /^\d+[.)]\s/.test(firstLine)
-        || firstLine.startsWith('|');
-}
-export function inferBlockSeparator(buffer, incoming) {
-    if (hasUnclosedFence(buffer))
-        return '';
-    if (buffer.endsWith('\n\n'))
-        return '';
-    const lastLine = (buffer.trimEnd().split('\n')
-        .at(-1) ?? '').trim();
-    const firstLine = (incoming.trimStart().split('\n')[0] ?? '').trimStart();
-    if (lastLine.startsWith('|') && !firstLine.startsWith('|')
-        && firstLine.endsWith('|')) {
-        return ' ';
-    }
-    if (lastLine.startsWith('|') && firstLine.startsWith('|'))
-        return '\n';
-    if (startsWithBlockElement(incoming))
-        return '\n\n';
-    return '';
-}
-const DIAGRAM_LANGUAGES = new Set([
-    'mermaid', 'plantuml', 'sequence', 'flowchart',
-    'gantt', 'classdiagram', 'statediagram', 'erdiagram',
-    'journey', 'gitgraph', 'mindmap', 'timeline',
-]);
-export function extractAtomicBlocks(text) {
-    const blocks = [];
-    const lines = text.split('\n');
-    let offset = 0;
-    let inPlainFence = false;
-    let inDiagram = false;
-    let diagramStart = 0;
-    let tableStart = -1;
-    let tableEnd = -1;
-    let tableHasSep = false;
-    let tableLineCount = 0;
-    const isTableLine = (line) => line.trim().startsWith('|');
-    const isTableSeparator = (line) => /^\|[\s|:-]+\|$/.test(line.trim());
-    const flushTable = () => {
-        if (tableStart !== -1 && tableEnd !== -1 && (tableHasSep || tableLineCount >= 2)) {
-            blocks.push({ start: tableStart, end: tableEnd, kind: 'table' });
-        }
-        tableStart = -1;
-        tableEnd = -1;
-        tableHasSep = false;
-        tableLineCount = 0;
-    };
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const lineEnd = offset + line.length + (i < lines.length - 1 ? 1 : 0);
-        if (inPlainFence || inDiagram) {
-            if (line.startsWith('```')) {
-                if (inDiagram) {
-                    blocks.push({ start: diagramStart, end: lineEnd, kind: 'diagram-fence' });
-                    inDiagram = false;
-                }
-                else {
-                    inPlainFence = false;
-                }
-            }
-            offset = lineEnd;
-            continue;
-        }
-        if (line.startsWith('```')) {
-            flushTable();
-            const lang = line.slice(3).trim()
-                .toLowerCase();
-            if (lang && DIAGRAM_LANGUAGES.has(lang)) {
-                inDiagram = true;
-                diagramStart = offset;
-            }
-            else {
-                inPlainFence = true;
-            }
-            offset = lineEnd;
-            continue;
-        }
-        if (isTableLine(line)) {
-            if (tableStart === -1) {
-                tableStart = offset;
-                tableLineCount = 1;
-                tableHasSep = false;
-            }
-            else {
-                tableLineCount++;
-                if (!tableHasSep && tableLineCount === 2 && isTableSeparator(line)) {
-                    tableHasSep = true;
-                }
-            }
-            tableEnd = lineEnd;
-        }
-        else {
-            flushTable();
-        }
-        offset = lineEnd;
-    }
-    flushTable();
-    return blocks.sort((a, b) => a.start - b.start);
-}
-export function chunkMarkdownTextAtomicAware(text, maxChars, chunkFn) {
-    const rawChunks = chunkFn(text, maxChars);
-    if (rawChunks.length <= 1)
-        return rawChunks;
-    const atomicBlocks = extractAtomicBlocks(text);
-    if (atomicBlocks.length === 0)
-        return rawChunks;
-    const splitIndices = [];
-    let cumLen = 0;
-    for (let i = 0; i < rawChunks.length - 1; i++) {
-        cumLen += rawChunks[i].length;
-        splitIndices.push(cumLen);
-    }
-    const adjustedIndices = [];
-    let chunkWindowStart = 0;
-    for (const idx of splitIndices) {
-        const block = atomicBlocks.find(b => b.start < idx && idx < b.end);
-        if (!block) {
-            adjustedIndices.push(idx);
-            chunkWindowStart = idx;
-            continue;
-        }
-        if (block.start > chunkWindowStart) {
-            adjustedIndices.push(block.start);
-            chunkWindowStart = block.start;
-        }
-        else {
-            adjustedIndices.push(block.end);
-            chunkWindowStart = block.end;
-        }
-    }
-    const result = [];
-    let prev = 0;
-    for (const idx of adjustedIndices) {
-        if (idx > prev)
-            result.push(text.slice(prev, idx));
-        prev = idx;
-    }
-    if (prev < text.length)
-        result.push(text.slice(prev));
-    return result.filter(c => c.length > 0);
-}
-export function mergeBlockStreamingFences(buffer, incoming) {
-    const CLOSE_RE = /\n```\s*$/;
-    const OPEN_RE = /^```[^\n]*\n/;
-    const normalized = incoming.replace(/\n```\s*```[^\n]*\n/g, '\n');
-    if (CLOSE_RE.test(buffer) && OPEN_RE.test(normalized)) {
-        return `${buffer.replace(CLOSE_RE, '')}\n${normalized.replace(OPEN_RE, '')}`;
-    }
-    if (hasUnclosedFence(buffer) && OPEN_RE.test(normalized)) {
-        return `${buffer}\n${normalized.replace(OPEN_RE, '')}`;
-    }
-    return `${buffer}${normalized}`;
-}
 function createMergeTextSession(callbacks, msgId, sessionKey, onComplete, log, opts, heartbeatMeta) {
     const { sendText, sendSticker, sendMedia } = callbacks;
     const { minChars, maxChars, chunkText } = opts;

package/dist/src/utils/markdown-stream.d.ts

@@ -0,0 +1,14 @@
+export declare function endsWithTableRow(text: string): boolean;
+export declare function hasUnclosedFence(text: string): boolean;
+export declare function hasUnclosedMathBlock(text: string): boolean;
+export declare function normalizeMathBlocks(text: string): string;
+export declare function startsWithBlockElement(text: string): boolean;
+export declare function inferBlockSeparator(buffer: string, incoming: string): string;
+export declare function mergeBlockStreamingFences(buffer: string, incoming: string): string;
+export type AtomicBlock = {
+    start: number;
+    end: number;
+    kind: 'table' | 'diagram-fence';
+};
+export declare function extractAtomicBlocks(text: string): AtomicBlock[];
+export declare function chunkMarkdownTextAtomicAware(text: string, maxChars: number, chunkFn: (text: string, max: number) => string[]): string[];

package/dist/src/utils/markdown-stream.js

@@ -0,0 +1,242 @@
+export function endsWithTableRow(text) {
+    const trimmed = text.trimEnd();
+    if (!trimmed)
+        return false;
+    const lastLine = trimmed.split('\n').at(-1) ?? '';
+    const line = lastLine.trim();
+    return line.startsWith('|') && line.endsWith('|');
+}
+export function hasUnclosedFence(text) {
+    let inFence = false;
+    for (const line of text.split('\n')) {
+        if (line.startsWith('```'))
+            inFence = !inFence;
+    }
+    return inFence;
+}
+export function hasUnclosedMathBlock(text) {
+    let inFence = false;
+    let mathOpen = false;
+    for (const line of text.split('\n')) {
+        if (line.startsWith('```')) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        let idx = 0;
+        while (idx < line.length - 1) {
+            if (line[idx] === '$' && line[idx + 1] === '$') {
+                mathOpen = !mathOpen;
+                idx += 2;
+            }
+            else {
+                idx++;
+            }
+        }
+    }
+    return mathOpen;
+}
+export function normalizeMathBlocks(text) {
+    if (!text.includes('$$'))
+        return text;
+    const parts = [];
+    let inFence = false;
+    let mathOpen = false;
+    let segStart = 0;
+    for (let i = 0; i < text.length; i++) {
+        if ((i === 0 || text[i - 1] === '\n') && text.startsWith('```', i)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        if (text[i] === '$' && i + 1 < text.length && text[i + 1] === '$') {
+            if (!mathOpen) {
+                mathOpen = true;
+                parts.push(text.slice(segStart, i + 2));
+                segStart = i + 2;
+                i++;
+            }
+            else {
+                const mathContent = text.slice(segStart, i);
+                parts.push(mathContent.replace(/\n\n+/g, '\n'));
+                parts.push('$$');
+                segStart = i + 2;
+                mathOpen = false;
+                i++;
+            }
+        }
+    }
+    if (segStart < text.length) {
+        const remaining = text.slice(segStart);
+        parts.push(mathOpen ? remaining.replace(/\n\n+/g, '\n') : remaining);
+    }
+    return parts.join('');
+}
+export function startsWithBlockElement(text) {
+    const firstLine = (text.trimStart().split('\n')[0] ?? '').trimStart();
+    return /^#{1,6}\s/.test(firstLine)
+        || firstLine.startsWith('---')
+        || firstLine.startsWith('***')
+        || firstLine.startsWith('___')
+        || firstLine.startsWith('> ')
+        || firstLine.startsWith('```')
+        || /^[*\-+]\s/.test(firstLine)
+        || /^\d+[.)]\s/.test(firstLine)
+        || firstLine.startsWith('|')
+        || firstLine.startsWith('$$');
+}
+export function inferBlockSeparator(buffer, incoming) {
+    if (hasUnclosedFence(buffer))
+        return '';
+    if (hasUnclosedMathBlock(buffer))
+        return '';
+    if (buffer.endsWith('\n\n'))
+        return '';
+    const lastLine = (buffer.trimEnd().split('\n')
+        .at(-1) ?? '').trim();
+    const firstLine = (incoming.trimStart().split('\n')[0] ?? '').trimStart();
+    if (lastLine.startsWith('|') && !firstLine.startsWith('|')
+        && firstLine.endsWith('|')) {
+        return ' ';
+    }
+    if (lastLine.startsWith('|') && firstLine.startsWith('|'))
+        return '\n';
+    if (startsWithBlockElement(incoming))
+        return '\n\n';
+    return '';
+}
+export function mergeBlockStreamingFences(buffer, incoming) {
+    const CLOSE_RE = /\n```\s*$/;
+    const OPEN_RE = /^```[^\n]*\n/;
+    const normalized = incoming.replace(/\n```\s*```[^\n]*\n/g, '\n');
+    if (CLOSE_RE.test(buffer) && OPEN_RE.test(normalized)) {
+        return `${buffer.replace(CLOSE_RE, '')}\n${normalized.replace(OPEN_RE, '')}`;
+    }
+    if (hasUnclosedFence(buffer) && OPEN_RE.test(normalized)) {
+        return `${buffer}\n${normalized.replace(OPEN_RE, '')}`;
+    }
+    return `${buffer}${normalized}`;
+}
+const DIAGRAM_LANGUAGES = new Set([
+    'mermaid', 'plantuml', 'sequence', 'flowchart',
+    'gantt', 'classdiagram', 'statediagram', 'erdiagram',
+    'journey', 'gitgraph', 'mindmap', 'timeline',
+]);
+export function extractAtomicBlocks(text) {
+    const blocks = [];
+    const lines = text.split('\n');
+    let offset = 0;
+    let inPlainFence = false;
+    let inDiagram = false;
+    let diagramStart = 0;
+    let tableStart = -1;
+    let tableEnd = -1;
+    let tableHasSep = false;
+    let tableLineCount = 0;
+    const isTableLine = (line) => line.trim().startsWith('|');
+    const isTableSeparator = (line) => /^\|[\s|:-]+\|$/.test(line.trim());
+    const flushTable = () => {
+        if (tableStart !== -1 && tableEnd !== -1 && (tableHasSep || tableLineCount >= 2)) {
+            blocks.push({ start: tableStart, end: tableEnd, kind: 'table' });
+        }
+        tableStart = -1;
+        tableEnd = -1;
+        tableHasSep = false;
+        tableLineCount = 0;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineEnd = offset + line.length + (i < lines.length - 1 ? 1 : 0);
+        if (inPlainFence || inDiagram) {
+            if (line.startsWith('```')) {
+                if (inDiagram) {
+                    blocks.push({ start: diagramStart, end: lineEnd, kind: 'diagram-fence' });
+                    inDiagram = false;
+                }
+                else {
+                    inPlainFence = false;
+                }
+            }
+            offset = lineEnd;
+            continue;
+        }
+        if (line.startsWith('```')) {
+            flushTable();
+            const lang = line.slice(3).trim()
+                .toLowerCase();
+            if (lang && DIAGRAM_LANGUAGES.has(lang)) {
+                inDiagram = true;
+                diagramStart = offset;
+            }
+            else {
+                inPlainFence = true;
+            }
+            offset = lineEnd;
+            continue;
+        }
+        if (isTableLine(line)) {
+            if (tableStart === -1) {
+                tableStart = offset;
+                tableLineCount = 1;
+                tableHasSep = false;
+            }
+            else {
+                tableLineCount++;
+                if (!tableHasSep && tableLineCount === 2 && isTableSeparator(line)) {
+                    tableHasSep = true;
+                }
+            }
+            tableEnd = lineEnd;
+        }
+        else {
+            flushTable();
+        }
+        offset = lineEnd;
+    }
+    flushTable();
+    return blocks.sort((a, b) => a.start - b.start);
+}
+export function chunkMarkdownTextAtomicAware(text, maxChars, chunkFn) {
+    const rawChunks = chunkFn(text, maxChars);
+    if (rawChunks.length <= 1)
+        return rawChunks;
+    const atomicBlocks = extractAtomicBlocks(text);
+    if (atomicBlocks.length === 0)
+        return rawChunks;
+    const splitIndices = [];
+    let cumLen = 0;
+    for (let i = 0; i < rawChunks.length - 1; i++) {
+        cumLen += rawChunks[i].length;
+        splitIndices.push(cumLen);
+    }
+    const adjustedIndices = [];
+    let chunkWindowStart = 0;
+    for (const idx of splitIndices) {
+        const block = atomicBlocks.find(b => b.start < idx && idx < b.end);
+        if (!block) {
+            adjustedIndices.push(idx);
+            chunkWindowStart = idx;
+            continue;
+        }
+        if (block.start > chunkWindowStart) {
+            adjustedIndices.push(block.start);
+            chunkWindowStart = block.start;
+        }
+        else {
+            adjustedIndices.push(block.end);
+            chunkWindowStart = block.end;
+        }
+    }
+    const result = [];
+    let prev = 0;
+    for (const idx of adjustedIndices) {
+        if (idx > prev)
+            result.push(text.slice(prev, idx));
+        prev = idx;
+    }
+    if (prev < text.length)
+        result.push(text.slice(prev));
+    return result.filter(c => c.length > 0);
+}

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-plugin-yuanbao",
   "name": "元宝 Bot",
   "description": "Tencent YuanBao intelligent bot channel plugin",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "channels": [
     "yuanbao"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-plugin-yuanbao",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "type": "module",
   "description": "Tencent YuanBao intelligent bot channel plugin",
   "license": "MIT",