@alemonjs/qq-bot 2.1.33 → 2.1.35

package/lib/sends.js

@@ -1,599 +1,577 @@
-import { readFileSync } from 'fs';
-import { createResult, ResultCode, logger } from 'alemonjs';
-import axios from 'axios';
-import { dataEnumToText, markdownToText, buttonsToText } from './format.js';
-import { getQQBotConfig } from './config.js';
+import { getQQBotConfig } from "./config.js";
+import { buttonsToText, dataEnumToText, markdownToText } from "./format.js";
+import { ResultCode, createResult, logger } from "alemonjs";
+import { readFileSync } from "fs";
+import axios from "axios";
 
+//#region src/sends.ts
+/** QQ Bot 平台按钮限制：最多 5 行，每行最多 5 个按钮 */
 const MAX_BUTTON_ROWS = 5;
 const MAX_BUTTONS_PER_ROW = 5;
+/**
+* QQ-Bot 按钮样式（render_data.style）：
+* 0 灰色线框 / 1 蓝色线框 / 3 红框 / 4 蓝底白字
+*/
 const BUTTON_STYLE_MAP = {
-    gray: 0,
-    blue: 1,
-    red: 3,
-    'blue-fill': 4
+	gray: 0,
+	blue: 1,
+	red: 3,
+	"blue-fill": 4
 };
+/** 解析按钮样式：支持样式名与数字（含数字字符串），默认灰框 0 */
 const resolveButtonStyle = (style) => {
-    if (typeof style === 'number') {
-        return style;
-    }
-    if (typeof style === 'string') {
-        if (BUTTON_STYLE_MAP[style] !== undefined) {
-            return BUTTON_STYLE_MAP[style];
-        }
-        if (style.trim() !== '' && !Number.isNaN(Number(style))) {
-            return Number(style);
-        }
-    }
-    return 0;
+	if (typeof style === "number") return style;
+	if (typeof style === "string") {
+		if (BUTTON_STYLE_MAP[style] !== void 0) return BUTTON_STYLE_MAP[style];
+		if (style.trim() !== "" && !Number.isNaN(Number(style))) return Number(style);
+	}
+	return 0;
 };
 const createButtonsData = (rows, startId = 0) => {
-    let id = startId;
-    const clippedRows = rows.slice(0, MAX_BUTTON_ROWS);
-    return {
-        rows: clippedRows.map(row => ({
-            buttons: row.value.slice(0, MAX_BUTTONS_PER_ROW).map(button => {
-                const value = button.value;
-                const options = button.options;
-                id++;
-                const typing = options?.type ?? 'command';
-                const typeMap = { command: 2, link: 0, call: 1 };
-                const rowData = options?.rawData ?? {};
-                const data = options?.data;
-                const modal = options?.modal ??
-                    (typeof data === 'object' && data
-                        ? {
-                            content: data.click,
-                            confirmText: data.confirm,
-                            cancelText: data.cancel
-                        }
-                        : undefined);
-                const action = {
-                    type: typeMap[typing],
-                    permission: {
-                        type: typeof options.permission?.type === 'undefined' ? 2 : options?.permission?.type,
-                        specify_user_ids: options?.permission?.userIds,
-                        specify_role_ids: options?.permission?.roleIds
-                    },
-                    unsupport_tips: options?.toolTip ?? '',
-                    data: typeof data === 'string' ? data : '',
-                    at_bot_show_channel_list: options?.atBotShowChannelList ?? false,
-                    enter: options?.autoEnter ?? false,
-                    reply: options?.reply ?? false,
-                    anchor: options?.anchor ?? 0,
-                    click_limit: options?.clickLimit
-                };
-                if (modal) {
-                    action.modal = {
-                        content: modal.content ?? '是否确认操作?',
-                        confirm_text: modal.confirmText ?? '是',
-                        cancel_text: modal.cancelText ?? '否'
-                    };
-                }
-                return {
-                    id: String(id),
-                    render_data: {
-                        label: value,
-                        visited_label: value,
-                        style: resolveButtonStyle(options?.style)
-                    },
-                    action,
-                    ...rowData
-                };
-            })
-        })),
-        nextId: id
-    };
+	let id = startId;
+	return {
+		rows: rows.slice(0, MAX_BUTTON_ROWS).map((row) => ({ buttons: row.value.slice(0, MAX_BUTTONS_PER_ROW).map((button) => {
+			const value = button.value;
+			const options = button.options;
+			id++;
+			const typing = options?.type ?? "command";
+			const typeMap = {
+				command: 2,
+				link: 0,
+				call: 1
+			};
+			const rowData = options?.rawData ?? {};
+			const data = options?.data;
+			const modal = options?.modal ?? (typeof data === "object" && data ? {
+				content: data.click,
+				confirmText: data.confirm,
+				cancelText: data.cancel
+			} : void 0);
+			const action = {
+				type: typeMap[typing],
+				permission: {
+					type: typeof options.permission?.type === "undefined" ? 2 : options?.permission?.type,
+					specify_user_ids: options?.permission?.userIds,
+					specify_role_ids: options?.permission?.roleIds
+				},
+				unsupport_tips: options?.toolTip ?? "",
+				data: typeof data === "string" ? data : "",
+				at_bot_show_channel_list: options?.atBotShowChannelList ?? false,
+				enter: options?.autoEnter ?? false,
+				reply: options?.reply ?? false,
+				anchor: options?.anchor ?? 0,
+				click_limit: options?.clickLimit
+			};
+			if (modal) action.modal = {
+				content: modal.content ?? "是否确认操作?",
+				confirm_text: modal.confirmText ?? "是",
+				cancel_text: modal.cancelText ?? "否"
+			};
+			return {
+				id: String(id),
+				render_data: {
+					label: value,
+					visited_label: value,
+					style: resolveButtonStyle(options?.style)
+				},
+				action,
+				...rowData
+			};
+		}) })),
+		nextId: id
+	};
 };
 const createArkCardData = (value) => ({
-    template_id: 24,
-    kv: [
-        { key: '#DESC#', value: value.decs },
-        { key: '#PROMPT#', value: value.prompt },
-        { key: '#TITLE#', value: value.title },
-        { key: '#METADESC#', value: value.metadecs },
-        { key: '#IMG#', value: value.cover },
-        { key: '#LINK#', value: value.link },
-        { key: '#SUBTITLE#', value: value.subtitle }
-    ]
+	template_id: 24,
+	kv: [
+		{
+			key: "#DESC#",
+			value: value.decs
+		},
+		{
+			key: "#PROMPT#",
+			value: value.prompt
+		},
+		{
+			key: "#TITLE#",
+			value: value.title
+		},
+		{
+			key: "#METADESC#",
+			value: value.metadecs
+		},
+		{
+			key: "#IMG#",
+			value: value.cover
+		},
+		{
+			key: "#LINK#",
+			value: value.link
+		},
+		{
+			key: "#SUBTITLE#",
+			value: value.subtitle
+		}
+	]
 });
 const createArkBigCardData = (value) => ({
-    template_id: 37,
-    kv: [
-        { key: '#PROMPT#', value: value.prompt },
-        { key: '#METATITLE#', value: value.title },
-        { key: '#METASUBTITLE#', value: value.subtitle },
-        { key: '#METACOVER#', value: value.cover },
-        { key: '#METAURL#', value: value.link }
-    ]
+	template_id: 37,
+	kv: [
+		{
+			key: "#PROMPT#",
+			value: value.prompt
+		},
+		{
+			key: "#METATITLE#",
+			value: value.title
+		},
+		{
+			key: "#METASUBTITLE#",
+			value: value.subtitle
+		},
+		{
+			key: "#METACOVER#",
+			value: value.cover
+		},
+		{
+			key: "#METAURL#",
+			value: value.link
+		}
+	]
 });
 const createArkListData = (value) => {
-    const [tip, data] = value;
-    return {
-        template_id: 23,
-        kv: [
-            { key: '#DESC#', value: tip.value.desc },
-            { key: '#PROMPT#', value: tip.value.prompt },
-            {
-                key: '#LIST#',
-                obj: data.value.map(item => {
-                    const v = item.value;
-                    if (typeof v === 'string') {
-                        return { obj_kv: [{ key: 'desc', value: v }] };
-                    }
-                    return {
-                        obj_kv: [
-                            { key: 'desc', value: v.title },
-                            { key: 'link', value: v.link }
-                        ]
-                    };
-                })
-            }
-        ]
-    };
+	const [tip, data] = value;
+	return {
+		template_id: 23,
+		kv: [
+			{
+				key: "#DESC#",
+				value: tip.value.desc
+			},
+			{
+				key: "#PROMPT#",
+				value: tip.value.prompt
+			},
+			{
+				key: "#LIST#",
+				obj: data.value.map((item) => {
+					const v = item.value;
+					if (typeof v === "string") return { obj_kv: [{
+						key: "desc",
+						value: v
+					}] };
+					return { obj_kv: [{
+						key: "desc",
+						value: v.title
+					}, {
+						key: "link",
+						value: v.link
+					}] };
+				})
+			}
+		]
+	};
 };
 const mdFormatters = {
-    'MD.title': value => `# ${value} `,
-    'MD.subtitle': value => `## ${value} `,
-    'MD.text': value => `${value} `,
-    'MD.bold': value => `**${value}** `,
-    'MD.divider': () => '\n***\n',
-    'MD.italic': value => `__${value}__ `,
-    'MD.italicStar': value => `*${value}* `,
-    'MD.strikethrough': value => `~~${value}~~ `,
-    'MD.blockquote': value => `\n> ${value} `,
-    'MD.newline': () => '\n',
-    'MD.link': value => {
-        if (!value?.text && !value?.url) {
-            return '';
-        }
-        if (!value?.text || !value?.url) {
-            return `<${value?.url ?? value?.text}> `;
-        }
-        return `[🔗${value?.text}](${value?.url}) `;
-    },
-    'MD.image': (value, options) => `\n![text #${options?.width || 208}px #${options?.height || 320}px](${value})\n`,
-    'MD.mention': (value, options) => {
-        const { belong } = options || {};
-        if (belong === 'channel') {
-            return '';
-        }
-        if (belong === 'user') {
-            return `<qqbot-at-user id="${value}" />`;
-        }
-        if (value === 'everyone') {
-            return '<qqbot-at-everyone />';
-        }
-        return `<qqbot-at-user id="${value}" />`;
-    },
-    'MD.content': value => `${value}`,
-    'MD.button': (title, options) => {
-        const { data, autoEnter } = options || {};
-        if (autoEnter) {
-            return `<qqbot-cmd-enter text="${data}" show="${title}" />`;
-        }
-        return `<qqbot-cmd-input text="${data}" show="${title}" />`;
-    }
+	"MD.title": (value) => `# ${value} `,
+	"MD.subtitle": (value) => `## ${value} `,
+	"MD.text": (value) => `${value} `,
+	"MD.bold": (value) => `**${value}** `,
+	"MD.divider": () => "\n***\n",
+	"MD.italic": (value) => `__${value}__ `,
+	"MD.italicStar": (value) => `*${value}* `,
+	"MD.strikethrough": (value) => `~~${value}~~ `,
+	"MD.blockquote": (value) => `\n> ${value} `,
+	"MD.newline": () => "\n",
+	"MD.link": (value) => {
+		if (!value?.text && !value?.url) return "";
+		if (!value?.text || !value?.url) return `<${value?.url ?? value?.text}> `;
+		return `[🔗${value?.text}](${value?.url}) `;
+	},
+	"MD.image": (value, options) => `\n![text #${options?.width || 208}px #${options?.height || 320}px](${value})\n`,
+	"MD.mention": (value, options) => {
+		const { belong } = options || {};
+		if (belong === "channel") return "";
+		if (belong === "user") return `<qqbot-at-user id="${value}" />`;
+		if (value === "everyone") return "<qqbot-at-everyone />";
+		return `<qqbot-at-user id="${value}" />`;
+	},
+	"MD.content": (value) => `${value}`,
+	"MD.button": (title, options) => {
+		const { data, autoEnter } = options || {};
+		if (autoEnter) return `<qqbot-cmd-enter text="${data}" show="${title}" />`;
+		return `<qqbot-cmd-input text="${data}" show="${title}" />`;
+	}
 };
 const createMarkdownText = (data) => {
-    return data
-        .map(mdItem => {
-        if (mdFormatters[mdItem.type]) {
-            return mdFormatters[mdItem.type](mdItem?.value, mdItem?.options);
-        }
-        if (mdItem.type === 'MD.list' && typeof mdItem.value !== 'string') {
-            const listStr = mdItem.value.map(listItem => {
-                return typeof listItem.value === 'object' ? `\n${listItem.value.index}. ${listItem.value.text}` : `\n- ${listItem.value}`;
-            });
-            return `${listStr.join('')}\n`;
-        }
-        if (mdItem.type === 'MD.code') {
-            const language = mdItem?.options?.language || '';
-            return `\n\`\`\`${language}\n${mdItem.value}\n\`\`\`\n`;
-        }
-        return String(mdItem['value'] || '');
-    })
-        .join('');
+	return data.map((mdItem) => {
+		if (mdFormatters[mdItem.type]) return mdFormatters[mdItem.type](mdItem?.value, mdItem?.options);
+		if (mdItem.type === "MD.list" && typeof mdItem.value !== "string") return `${mdItem.value.map((listItem) => {
+			return typeof listItem.value === "object" ? `\n${listItem.value.index}. ${listItem.value.text}` : `\n- ${listItem.value}`;
+		}).join("")}\n`;
+		if (mdItem.type === "MD.code") return `\n\`\`\`${mdItem?.options?.language || ""}\n${mdItem.value}\n\`\`\`\n`;
+		return String(mdItem["value"] || "");
+	}).join("");
 };
 const formatMention = (item, mode) => {
-    if (mode === 'guild-direct') {
-        return '';
-    }
-    const value = item.value;
-    const isEmptyMention = value === 'everyone' || value === 'all' || value === '' || typeof value !== 'string';
-    if (mode === 'guild-public') {
-        if (isEmptyMention) {
-            return '@everyone';
-        }
-        if (item.options?.belong === 'user') {
-            return `<@!${value}>`;
-        }
-        if (item.options?.belong === 'channel') {
-            return `<#${value}>`;
-        }
-        return '';
-    }
-    if (isEmptyMention) {
-        return '';
-    }
-    if (item.options?.belong === 'user') {
-        return `<@${value}>`;
-    }
-    return '';
+	if (mode === "guild-direct") return "";
+	const value = item.value;
+	const isEmptyMention = value === "everyone" || value === "all" || value === "" || typeof value !== "string";
+	if (mode === "guild-public") {
+		if (isEmptyMention) return "@everyone";
+		if (item.options?.belong === "user") return `<@!${value}>`;
+		if (item.options?.belong === "channel") return `<#${value}>`;
+		return "";
+	}
+	if (isEmptyMention) return "";
+	if (item.options?.belong === "user") return `<@${value}>`;
+	return "";
 };
+/** 从消息数据中提取文本内容 */
 const extractContent = (val, mode) => {
-    const nativeTypes = new Set([
-        'Mention',
-        'Text',
-        'Link',
-        'Image',
-        'ImageFile',
-        'ImageURL',
-        'Audio',
-        'Video',
-        'Attachment',
-        'Markdown',
-        'MarkdownOriginal',
-        'BT.group',
-        'ButtonTemplate',
-        'Ark.list',
-        'Ark.Card',
-        'Ark.BigCard'
-    ]);
-    const nativeText = val
-        .filter(item => item.type === 'Mention' || item.type === 'Text' || item.type === 'Link')
-        .map(item => {
-        if (item.type === 'Link') {
-            return `[${item.value}](${item?.options?.link})`;
-        }
-        if (item.type === 'Mention') {
-            return formatMention(item, mode);
-        }
-        if (item.type === 'Text') {
-            return item.value;
-        }
-        return '';
-    })
-        .join('');
-    const config = getQQBotConfig();
-    const hide = config.hideUnsupported;
-    const fallbackText = val
-        .filter(item => !nativeTypes.has(item.type))
-        .map(item => dataEnumToText(item, hide))
-        .filter(Boolean)
-        .join('\n');
-    return [nativeText, fallbackText].filter(Boolean).join('\n');
+	const nativeTypes = /* @__PURE__ */ new Set([
+		"Mention",
+		"Text",
+		"Link",
+		"Image",
+		"ImageFile",
+		"ImageURL",
+		"Audio",
+		"Video",
+		"Attachment",
+		"Markdown",
+		"MarkdownOriginal",
+		"BT.group",
+		"ButtonTemplate",
+		"Ark.list",
+		"Ark.Card",
+		"Ark.BigCard"
+	]);
+	const nativeText = val.filter((item) => item.type === "Mention" || item.type === "Text" || item.type === "Link").map((item) => {
+		if (item.type === "Link") return `[${item.value}](${item?.options?.link})`;
+		if (item.type === "Mention") return formatMention(item, mode);
+		if (item.type === "Text") return item.value;
+		return "";
+	}).join("");
+	const hide = getQQBotConfig().hideUnsupported;
+	return [nativeText, val.filter((item) => !nativeTypes.has(item.type)).map((item) => dataEnumToText(item, hide)).filter(Boolean).join("\n")].filter(Boolean).join("\n");
 };
+/**
+* notice 事件中平台支持以 event_id 被动回复的 tag
+* （群聊：GROUP_ADD_ROBOT / GROUP_MSG_RECEIVE；单聊：C2C_MSG_RECEIVE / FRIEND_ADD）
+*/
+const NOTICE_EVENT_REPLY_TAGS = /* @__PURE__ */ new Set([
+	"GROUP_ADD_ROBOT",
+	"GROUP_MSG_RECEIVE",
+	"C2C_MSG_RECEIVE",
+	"FRIEND_ADD"
+]);
+/** 构建 baseParams（event_id 或 msg_id） */
 const buildBaseParams = (tag, messageId, interactionTag) => {
-    if (tag === interactionTag) {
-        return { event_id: messageId };
-    }
-    return { msg_id: messageId };
+	if (tag && NOTICE_EVENT_REPLY_TAGS.has(tag) || tag === interactionTag) return { event_id: messageId };
+	return { msg_id: messageId };
 };
+/** 构建 Markdown 和按钮参数 */
 const buildMdAndButtonsParams = (val) => {
-    const items = val.filter(item => item.type === 'Markdown' || item.type === 'MarkdownOriginal' || item.type === 'BT.group' || item.type === 'ButtonTemplate');
-    if (items.length === 0) {
-        return null;
-    }
-    const params = {};
-    let keyboardExtra;
-    for (const item of items) {
-        if (item.type === 'ButtonTemplate') {
-            if (item?.value) {
-                params['keyboard'] = { id: item.value };
-            }
-        }
-        else if (item.type === 'BT.group' && typeof item?.value !== 'string') {
-            const groupOptions = item?.options ?? {};
-            if (groupOptions.smallButton || groupOptions.rawData) {
-                keyboardExtra = {
-                    smallButton: keyboardExtra?.smallButton || groupOptions.smallButton,
-                    rawData: groupOptions.rawData
-                };
-            }
-            if (params['keyboard']?.content?.rows) {
-                const existingRows = params['keyboard'].content.rows;
-                const currentId = params['keyboard'].content.nextId ?? existingRows.length;
-                const remaining = MAX_BUTTON_ROWS - existingRows.length;
-                if (remaining > 0) {
-                    const { rows: newRows, nextId } = createButtonsData(item.value.slice(0, remaining), currentId);
-                    existingRows.push(...newRows);
-                    params['keyboard'].content.nextId = nextId;
-                }
-            }
-            else {
-                const result = createButtonsData(item.value);
-                params['keyboard'] = { content: result };
-            }
-        }
-        else if (item.type === 'Markdown' && typeof item?.value !== 'string') {
-            const content = createMarkdownText(item.value);
-            if (content) {
-                if (params['markdown']?.content) {
-                    params['markdown'].content += content;
-                }
-                else {
-                    params['markdown'] = { content };
-                }
-            }
-        }
-        else if (item.type === 'MarkdownOriginal' && typeof item?.value === 'string') {
-            if (params['markdown']?.content) {
-                params['markdown'].content += '\n' + item.value;
-            }
-            else {
-                params['markdown'] = { content: item.value };
-            }
-        }
-    }
-    if (keyboardExtra && params['keyboard']?.content) {
-        if (keyboardExtra.smallButton) {
-            params['keyboard'].content.style = { font_size: 'small' };
-        }
-        if (keyboardExtra.rawData) {
-            Object.assign(params['keyboard'].content, keyboardExtra.rawData);
-        }
-    }
-    if (params['keyboard']?.content?.nextId !== undefined) {
-        delete params['keyboard'].content.nextId;
-    }
-    return params;
+	const items = val.filter((item) => item.type === "Markdown" || item.type === "MarkdownOriginal" || item.type === "BT.group" || item.type === "ButtonTemplate");
+	if (items.length === 0) return null;
+	const params = {};
+	let keyboardExtra;
+	for (const item of items) if (item.type === "ButtonTemplate") {
+		if (item?.value) params["keyboard"] = { id: item.value };
+	} else if (item.type === "BT.group" && typeof item?.value !== "string") {
+		const groupOptions = item?.options ?? {};
+		if (groupOptions.smallButton || groupOptions.rawData) keyboardExtra = {
+			smallButton: keyboardExtra?.smallButton || groupOptions.smallButton,
+			rawData: groupOptions.rawData
+		};
+		if (params["keyboard"]?.content?.rows) {
+			const existingRows = params["keyboard"].content.rows;
+			const currentId = params["keyboard"].content.nextId ?? existingRows.length;
+			const remaining = MAX_BUTTON_ROWS - existingRows.length;
+			if (remaining > 0) {
+				const { rows: newRows, nextId } = createButtonsData(item.value.slice(0, remaining), currentId);
+				existingRows.push(...newRows);
+				params["keyboard"].content.nextId = nextId;
+			}
+		} else params["keyboard"] = { content: createButtonsData(item.value) };
+	} else if (item.type === "Markdown" && typeof item?.value !== "string") {
+		const content = createMarkdownText(item.value);
+		if (content) {
+			if (params["markdown"]?.content) params["markdown"].content += content;
+			else params["markdown"] = { content };
+		}
+	} else if (item.type === "MarkdownOriginal" && typeof item?.value === "string") {
+		if (params["markdown"]?.content) params["markdown"].content += "\n" + item.value;
+		else params["markdown"] = { content: item.value };
+	}
+	if (keyboardExtra && params["keyboard"]?.content) {
+		if (keyboardExtra.smallButton) params["keyboard"].content.style = { font_size: "small" };
+		if (keyboardExtra.rawData) Object.assign(params["keyboard"].content, keyboardExtra.rawData);
+	}
+	if (params["keyboard"]?.content?.nextId !== void 0) delete params["keyboard"].content.nextId;
+	return params;
 };
+/** 构建 Ark 参数 */
 const buildArkParams = (val) => {
-    const items = val.filter(item => item.type === 'Ark.BigCard' || item.type === 'Ark.Card' || item.type === 'Ark.list');
-    if (items.length === 0) {
-        return null;
-    }
-    const params = {};
-    for (const item of items) {
-        if (item.type === 'Ark.Card' && typeof item?.value !== 'string') {
-            params['ark'] = createArkCardData(item.value);
-        }
-        else if (item.type === 'Ark.BigCard' && typeof item?.value !== 'string') {
-            params['ark'] = createArkBigCardData(item.value);
-        }
-        else if (item.type === 'Ark.list' && typeof item?.value !== 'string') {
-            params['ark'] = createArkListData(item.value);
-        }
-    }
-    return params;
+	const items = val.filter((item) => item.type === "Ark.BigCard" || item.type === "Ark.Card" || item.type === "Ark.list");
+	if (items.length === 0) return null;
+	const params = {};
+	for (const item of items) if (item.type === "Ark.Card" && typeof item?.value !== "string") params["ark"] = createArkCardData(item.value);
+	else if (item.type === "Ark.BigCard" && typeof item?.value !== "string") params["ark"] = createArkBigCardData(item.value);
+	else if (item.type === "Ark.list" && typeof item?.value !== "string") params["ark"] = createArkListData(item.value);
+	return params;
 };
+/**
+* 富媒体类型 → QQ file_type 映射
+* 1 图片 / 2 视频 / 3 语音 / 4 文件
+*/
 const MEDIA_FILE_TYPE = {
-    Image: 1,
-    ImageFile: 1,
-    ImageURL: 1,
-    Video: 2,
-    Audio: 3,
-    Attachment: 4
+	Image: 1,
+	ImageFile: 1,
+	ImageURL: 1,
+	Video: 2,
+	Audio: 3,
+	Attachment: 4
 };
+/** 过滤富媒体数据（图片/视频/音频/文件） */
 const filterMedia = (val) => {
-    return val.filter(item => MEDIA_FILE_TYPE[item.type] !== undefined);
+	return val.filter((item) => MEDIA_FILE_TYPE[item.type] !== void 0);
 };
+/** 过滤图片数据（仅图片，频道路径使用） */
 const filterImages = (val) => {
-    return val.filter(item => item.type === 'Image' || item.type === 'ImageFile' || item.type === 'ImageURL');
+	return val.filter((item) => item.type === "Image" || item.type === "ImageFile" || item.type === "ImageURL");
 };
+/** 将媒体数据解析为 base64（支持 URL / file:// / base64:// / buffer:// / Buffer / 裸 base64） */
 const resolveFileData = async (item) => {
-    if (item.type === 'ImageURL') {
-        return await axios.get(item.value, { responseType: 'arraybuffer' }).then(res => Buffer.from(res.data, 'binary').toString('base64'));
-    }
-    if (item.type === 'ImageFile') {
-        return readFileSync(item.value, 'base64');
-    }
-    const value = item.value;
-    if (typeof value === 'string') {
-        if (value.startsWith('https://') || value.startsWith('http://')) {
-            return await axios.get(value, { responseType: 'arraybuffer' }).then(res => Buffer.from(res.data, 'binary').toString('base64'));
-        }
-        if (value.startsWith('buffer://')) {
-            return value.replace('buffer://', '');
-        }
-        if (value.startsWith('file://')) {
-            return readFileSync(value.replace('file://', ''), 'base64');
-        }
-        if (value.startsWith('base64://')) {
-            return value.replace('base64://', '');
-        }
-        return value;
-    }
-    if (Buffer.isBuffer(value)) {
-        return value.toString('base64');
-    }
-    return undefined;
+	if (item.type === "ImageURL") return await axios.get(item.value, { responseType: "arraybuffer" }).then((res) => Buffer.from(res.data, "binary").toString("base64"));
+	if (item.type === "ImageFile") return readFileSync(item.value, "base64");
+	const value = item.value;
+	if (typeof value === "string") {
+		if (value.startsWith("https://") || value.startsWith("http://")) return await axios.get(value, { responseType: "arraybuffer" }).then((res) => Buffer.from(res.data, "binary").toString("base64"));
+		if (value.startsWith("buffer://")) return value.replace("buffer://", "");
+		if (value.startsWith("file://")) return readFileSync(value.replace("file://", ""), "base64");
+		if (value.startsWith("base64://")) return value.replace("base64://", "");
+		return value;
+	}
+	if (Buffer.isBuffer(value)) return value.toString("base64");
 };
+/**
+* 通过富媒体上传获取 file_info（图片/视频/音频/文件）
+* 按 MEDIA_FILE_TYPE 自动选择 file_type，超出 10MB 的文件自动走分片上传
+*/
 const resolveMediaUrl = async (media, uploadMedia) => {
-    for (const item of media) {
-        const fileData = await resolveFileData(item);
-        if (fileData) {
-            const fileInfo = await uploadMedia({ file_type: MEDIA_FILE_TYPE[item.type] ?? 1, file_data: fileData }).then(res => res?.file_info);
-            if (fileInfo) {
-                return fileInfo;
-            }
-        }
-    }
-    return undefined;
+	for (const item of media) {
+		const fileData = await resolveFileData(item);
+		if (fileData) {
+			const fileInfo = await uploadMedia({
+				file_type: MEDIA_FILE_TYPE[item.type] ?? 1,
+				file_data: fileData
+			}).then((res) => res?.file_info);
+			if (fileInfo) return fileInfo;
+		}
+	}
 };
-const stripMediaPlaceholders = (text) => text
-    .replace(/\[附件[^\]]*\]/g, '')
-    .replace(/\[音频\]/g, '')
-    .replace(/\[视频\]/g, '')
-    .replace(/\n{2,}/g, '\n')
-    .trim();
+/** 移除富媒体占位符（dataEnumToText 降级产生的 [视频]/[音频]/[附件]） */
+const stripMediaPlaceholders = (text) => text.replace(/\[附件[^\]]*\]/g, "").replace(/\[音频\]/g, "").replace(/\[视频\]/g, "").replace(/\n{2,}/g, "\n").trim();
+/** 当 markdownToText 选项开启时，将 Markdown 和按钮降级为纯文本并追加到 content */
 const flattenMdToText = (content, val) => {
-    const mdItems = val.filter(item => item.type === 'Markdown');
-    const btnItems = val.filter(item => item.type === 'BT.group');
-    const parts = [content];
-    for (const item of mdItems) {
-        if (item.type === 'Markdown' && typeof item.value !== 'string') {
-            parts.push(markdownToText(item.value));
-        }
-    }
-    for (const item of btnItems) {
-        if (item.type === 'BT.group' && typeof item.value !== 'string') {
-            parts.push(buttonsToText(item.value));
-        }
-    }
-    return parts
-        .filter(Boolean)
-        .join('\n')
-        .replace(/^[^\S\n\r]+|[^\S\n\r]+$/g, '');
+	const mdItems = val.filter((item) => item.type === "Markdown");
+	const btnItems = val.filter((item) => item.type === "BT.group");
+	const parts = [content];
+	for (const item of mdItems) if (item.type === "Markdown" && typeof item.value !== "string") parts.push(markdownToText(item.value));
+	for (const item of btnItems) if (item.type === "BT.group" && typeof item.value !== "string") parts.push(buttonsToText(item.value));
+	return parts.filter(Boolean).join("\n").replace(/^[^\S\n\r]+|[^\S\n\r]+$/g, "");
 };
+/** Open API 通用发送逻辑（群组 / C2C） */
 const sendOpenApiMessage = async (content, val, baseParams, uploadMedia, sendMessage, label, options) => {
-    const config = getQQBotConfig();
-    const mdToText = config.markdownToText === true;
-    const media = filterMedia(val);
-    if (media.length > 0) {
-        const fileInfo = await resolveMediaUrl(media, uploadMedia);
-        if (!fileInfo) {
-            return [createResult(ResultCode.Fail, '媒体上传失败', null)];
-        }
-        const mediaContent = stripMediaPlaceholders(flattenMdToText(content, val));
-        const res = await sendMessage({
-            content: mediaContent,
-            media: { file_info: fileInfo },
-            msg_type: 7,
-            ...baseParams
-        });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    if (config.hideUnsupported === true && !content && !buildMdAndButtonsParams(val) && !buildArkParams(val)) {
-        logger.info('[qq-bot] hideUnsupported: 消息内容转换后为空，跳过发送');
-        return [];
-    }
-    if (mdToText) {
-        const textContent = flattenMdToText(content, val);
-        if (textContent) {
-            const res = await sendMessage({ content: textContent, msg_type: 0, ...baseParams });
-            return [createResult(ResultCode.Ok, label, { id: res.id })];
-        }
-        return [];
-    }
-    const mdParams = buildMdAndButtonsParams(val);
-    if (mdParams) {
-        if (mdParams.markdown?.content && content) {
-            mdParams.markdown.content = content + '\n' + mdParams.markdown.content;
-        }
-        const res = await sendMessage({ content, msg_type: 2, ...mdParams, ...baseParams, force_verify_image_resource: options?.forceVerifyImageResource });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    const arkParams = buildArkParams(val);
-    if (arkParams) {
-        const res = await sendMessage({ content, msg_type: 3, ...arkParams, ...baseParams });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    if (content) {
-        const res = await sendMessage({ content, msg_type: 0, ...baseParams });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    return [];
+	const config = getQQBotConfig();
+	const mdToText = config.markdownToText === true;
+	const media = filterMedia(val);
+	if (media.length > 0) {
+		const fileInfo = await resolveMediaUrl(media, uploadMedia);
+		if (!fileInfo) return [createResult(ResultCode.Fail, "媒体上传失败", null)];
+		const res = await sendMessage({
+			content: stripMediaPlaceholders(flattenMdToText(content, val)),
+			media: { file_info: fileInfo },
+			msg_type: 7,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	if (config.hideUnsupported === true && !content && !buildMdAndButtonsParams(val) && !buildArkParams(val)) {
+		logger.info("[qq-bot] hideUnsupported: 消息内容转换后为空，跳过发送");
+		return [];
+	}
+	if (mdToText) {
+		const textContent = flattenMdToText(content, val);
+		if (textContent) {
+			const res = await sendMessage({
+				content: textContent,
+				msg_type: 0,
+				...baseParams
+			});
+			return [createResult(ResultCode.Ok, label, { id: res.id })];
+		}
+		return [];
+	}
+	const mdParams = buildMdAndButtonsParams(val);
+	if (mdParams) {
+		if (mdParams.markdown?.content && content) mdParams.markdown.content = content + "\n" + mdParams.markdown.content;
+		const res = await sendMessage({
+			content,
+			msg_type: 2,
+			...mdParams,
+			...baseParams,
+			force_verify_image_resource: options?.forceVerifyImageResource
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	const arkParams = buildArkParams(val);
+	if (arkParams) {
+		const res = await sendMessage({
+			content,
+			msg_type: 3,
+			...arkParams,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	if (content) {
+		const res = await sendMessage({
+			content,
+			msg_type: 0,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	return [];
 };
+/** 将图片数据解析为 Buffer */
 const resolveImageBuffer = async (images) => {
-    for (const item of images) {
-        if (item.type === 'ImageURL') {
-            return await axios.get(item.value, { responseType: 'arraybuffer' }).then(res => res?.data);
-        }
-        if (item.type === 'ImageFile') {
-            return readFileSync(item.value);
-        }
-        if (typeof item.value === 'string') {
-            if (item.value.startsWith('https://') || item.value.startsWith('http://')) {
-                return await axios.get(item.value, { responseType: 'arraybuffer' }).then(res => res?.data);
-            }
-            if (item.value.startsWith('base64://')) {
-                return Buffer.from(item.value.replace('base64://', ''), 'base64');
-            }
-            if (item.value.startsWith('file://')) {
-                return readFileSync(item.value.replace('file://', ''));
-            }
-            return Buffer.from(item.value, 'base64');
-        }
-        if (Buffer.isBuffer(item.value)) {
-            return item.value;
-        }
-    }
-    return null;
+	for (const item of images) {
+		if (item.type === "ImageURL") return await axios.get(item.value, { responseType: "arraybuffer" }).then((res) => res?.data);
+		if (item.type === "ImageFile") return readFileSync(item.value);
+		if (typeof item.value === "string") {
+			if (item.value.startsWith("https://") || item.value.startsWith("http://")) return await axios.get(item.value, { responseType: "arraybuffer" }).then((res) => res?.data);
+			if (item.value.startsWith("base64://")) return Buffer.from(item.value.replace("base64://", ""), "base64");
+			if (item.value.startsWith("file://")) return readFileSync(item.value.replace("file://", ""));
+			return Buffer.from(item.value, "base64");
+		}
+		if (Buffer.isBuffer(item.value)) return item.value;
+	}
+	return null;
 };
+/** Guild API 通用发送逻辑（频道公聊 / 频道私聊） */
 const sendGuildMessage = async (content, val, baseParams, sendMessage, label) => {
-    const config = getQQBotConfig();
-    const mdToText = config.markdownToText === true;
-    const images = filterImages(val);
-    if (images.length > 0) {
-        const imageBuffer = await resolveImageBuffer(images);
-        const imgContent = flattenMdToText(content, val);
-        const res = await sendMessage({ content: imgContent, ...baseParams }, imageBuffer);
-        return [createResult(ResultCode.Ok, label, { id: res?.id })];
-    }
-    if (config.hideUnsupported && !content && !buildMdAndButtonsParams(val) && !buildArkParams(val)) {
-        logger.info('[qq-bot] hideUnsupported: 消息内容转换后为空，跳过发送');
-        return [];
-    }
-    if (mdToText) {
-        const textContent = flattenMdToText(content, val);
-        if (textContent) {
-            const res = await sendMessage({ content: textContent, ...baseParams });
-            return [createResult(ResultCode.Ok, label, { id: res?.id })];
-        }
-        return [];
-    }
-    const mdParams = buildMdAndButtonsParams(val);
-    if (mdParams) {
-        if (mdParams.markdown?.content && content) {
-            mdParams.markdown.content = content + '\n' + mdParams.markdown.content;
-        }
-        const res = await sendMessage({ content: '', ...mdParams, ...baseParams });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    const arkParams = buildArkParams(val);
-    if (arkParams) {
-        const res = await sendMessage({ content, ...arkParams, ...baseParams });
-        return [createResult(ResultCode.Ok, label, { id: res.id })];
-    }
-    if (content) {
-        const res = await sendMessage({ content, ...baseParams });
-        return [createResult(ResultCode.Ok, label, { id: res?.id })];
-    }
-    return [];
+	const config = getQQBotConfig();
+	const mdToText = config.markdownToText === true;
+	const images = filterImages(val);
+	if (images.length > 0) {
+		const imageBuffer = await resolveImageBuffer(images);
+		const res = await sendMessage({
+			content: flattenMdToText(content, val),
+			...baseParams
+		}, imageBuffer);
+		return [createResult(ResultCode.Ok, label, { id: res?.id })];
+	}
+	if (config.hideUnsupported && !content && !buildMdAndButtonsParams(val) && !buildArkParams(val)) {
+		logger.info("[qq-bot] hideUnsupported: 消息内容转换后为空，跳过发送");
+		return [];
+	}
+	if (mdToText) {
+		const textContent = flattenMdToText(content, val);
+		if (textContent) {
+			const res = await sendMessage({
+				content: textContent,
+				...baseParams
+			});
+			return [createResult(ResultCode.Ok, label, { id: res?.id })];
+		}
+		return [];
+	}
+	const mdParams = buildMdAndButtonsParams(val);
+	if (mdParams) {
+		if (mdParams.markdown?.content && content) mdParams.markdown.content = content + "\n" + mdParams.markdown.content;
+		const res = await sendMessage({
+			content: "",
+			...mdParams,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	const arkParams = buildArkParams(val);
+	if (arkParams) {
+		const res = await sendMessage({
+			content,
+			...arkParams,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res.id })];
+	}
+	if (content) {
+		const res = await sendMessage({
+			content,
+			...baseParams
+		});
+		return [createResult(ResultCode.Ok, label, { id: res?.id })];
+	}
+	return [];
 };
+/**
+* 群组消息
+*/
 const GROUP_AT_MESSAGE_CREATE = async (client, event, val, options) => {
-    const baseParams = buildBaseParams(event._tag, event.MessageId, 'INTERACTION_CREATE_GROUP');
-    const content = extractContent(val, 'group');
-    try {
-        return await sendOpenApiMessage(content, val, baseParams, data => client.postRichMediaByGroup(event.ChannelId, data), data => client.groupOpenMessages(event.ChannelId, data), 'client.groupOpenMessages', options);
-    }
-    catch (err) {
-        return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
-    }
+	const baseParams = buildBaseParams(event._tag, event.MessageId, "INTERACTION_CREATE_GROUP");
+	const content = extractContent(val, "group");
+	try {
+		return await sendOpenApiMessage(content, val, baseParams, (data) => client.postRichMediaByGroup(event.ChannelId, data), (data) => client.groupOpenMessages(event.ChannelId, data), "client.groupOpenMessages", options);
+	} catch (err) {
+		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
+	}
 };
+/**
+* 私聊消息
+*/
 const C2C_MESSAGE_CREATE = async (client, event, val, options) => {
-    const baseParams = buildBaseParams(event._tag, event.MessageId, 'INTERACTION_CREATE_C2C');
-    const content = extractContent(val, 'group');
-    try {
-        return await sendOpenApiMessage(content, val, baseParams, data => client.postRichMediaByUser(event.UserId, data), data => client.usersOpenMessages(event.UserId, data), 'client.usersOpenMessages', options);
-    }
-    catch (err) {
-        return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
-    }
+	const baseParams = buildBaseParams(event._tag, event.MessageId, "INTERACTION_CREATE_C2C");
+	const content = extractContent(val, "group");
+	try {
+		return await sendOpenApiMessage(content, val, baseParams, (data) => client.postRichMediaByUser(event.UserId, data), (data) => client.usersOpenMessages(event.UserId, data), "client.usersOpenMessages", options);
+	} catch (err) {
+		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
+	}
 };
+/**
+* 频道私聊
+*/
 const DIRECT_MESSAGE_CREATE = async (client, event, val) => {
-    const baseParams = buildBaseParams(event._tag, event.MessageId, 'INTERACTION_CREATE_GUILD');
-    const content = extractContent(val, 'guild-direct');
-    try {
-        return await sendGuildMessage(content, val, baseParams, (data, buf) => client.dmsMessages(event.UserId, data, buf), 'client.dmsMessage');
-    }
-    catch (err) {
-        return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
-    }
+	const baseParams = buildBaseParams(event._tag, event.MessageId, "INTERACTION_CREATE_GUILD");
+	const content = extractContent(val, "guild-direct");
+	try {
+		return await sendGuildMessage(content, val, baseParams, (data, buf) => client.dmsMessages(event.UserId, data, buf), "client.dmsMessage");
+	} catch (err) {
+		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
+	}
 };
+/**
+* 频道公聊
+*/
 const MESSAGE_CREATE = async (client, event, val) => {
-    const baseParams = buildBaseParams(event._tag, event.MessageId, 'INTERACTION_CREATE_GUILD');
-    const content = extractContent(val, 'guild-public');
-    try {
-        return await sendGuildMessage(content, val, baseParams, (data, buf) => client.channelsMessages(event.ChannelId, data, buf), 'client.channelsMessagesPost');
-    }
-    catch (err) {
-        return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
-    }
+	const baseParams = buildBaseParams(event._tag, event.MessageId, "INTERACTION_CREATE_GUILD");
+	const content = extractContent(val, "guild-public");
+	try {
+		return await sendGuildMessage(content, val, baseParams, (data, buf) => client.channelsMessages(event.ChannelId, data, buf), "client.channelsMessagesPost");
+	} catch (err) {
+		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
+	}
 };
+/**
+* 频道公聊 @
+*/
 const AT_MESSAGE_CREATE = (client, event, val) => {
-    return MESSAGE_CREATE(client, event, val);
+	return MESSAGE_CREATE(client, event, val);
 };
 
-export { AT_MESSAGE_CREATE, C2C_MESSAGE_CREATE, DIRECT_MESSAGE_CREATE, GROUP_AT_MESSAGE_CREATE, MESSAGE_CREATE };
+//#endregion
+export { AT_MESSAGE_CREATE, C2C_MESSAGE_CREATE, DIRECT_MESSAGE_CREATE, GROUP_AT_MESSAGE_CREATE, MESSAGE_CREATE };