openclaw-plugin-yuanbao 2.8.0 → 2.9.1

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.1",
     "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/custom.js

@@ -23,14 +23,16 @@ export const customHandler = {
                     resData.isAtBot = isAtBotSelf;
                 }
                 createLog('custom').info('@消息', { text: customContent?.text, userId: customContent?.user_id, isAtBot: resData.isAtBot });
-                if (!isAtBotSelf && customContent?.user_id) {
+                if (customContent?.user_id) {
                     resData.mentions.push({
                         userId: customContent.user_id,
                         text: customContent.text || '',
                     });
                 }
-                const result = !isAtBotSelf && customContent.text ? customContent.text : undefined;
-                return result;
+                if (isAtBotSelf && customContent.text) {
+                    resData.botUsername = customContent.text.replace(/^@/, '');
+                }
+                return customContent.text || undefined;
             }
             catch { }
         }

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/handlers/types.d.ts

@@ -37,6 +37,7 @@ export type ExtractTextFromMsgBodyResult = {
     isAtBot: boolean;
     medias: MediaItem[];
     mentions: MentionItem[];
+    botUsername?: string;
 };
 export type OutboundContentItem = {
     type: 'text';