@alemonjs/qq-bot 2.1.33 → 2.1.34

package/dist/index.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!DOCTYPE html>
 <html lang="en" id="__gui">
   <head>
     <meta charset="UTF-8" />

package/lib/config.d.ts

@@ -1,20 +1,45 @@
-import { Options as sdkOptions } from './sdk/typing';
-export declare const platform = "qq-bot";
-export declare const platformFullName = "@alemonjs/qq-bot";
-export type Options = {
-    master_key?: string[];
-    master_id?: string[];
-    markdownToText?: boolean;
-    hideUnsupported?: boolean | number;
-    bots?: Record<string, Omit<sdkOptions, 'app_id'> & {
-        app_id?: string;
-    }>;
-    default_bot?: string;
-} & sdkOptions;
-export declare const getQQBotConfig: () => Options;
-export declare const getQQBotBots: () => {
-    bots: Map<string, sdkOptions>;
-    defaultBot?: string;
+import { Options as Options$1 } from "./sdk/typing.js";
+//#region src/config.d.ts
+declare const platform = "qq-bot";
+declare const platformFullName = "@alemonjs/qq-bot";
+type Options = {
+  /**
+   * 主人-用户KEY
+   */
+  master_key?: string[];
+  /**
+   * 主人-用户ID
+   */
+  master_id?: string[];
+  /**
+   * 将 Markdown 降级为纯文本发送
+   * 部分机器人不支持 Markdown 消息类型，开启后 Markdown 和按钮将转为可读纯文本
+   * @default false
+   */
+  markdownToText?: boolean;
+  /**
+   * 隐藏不支持的消息类型
+   * - true 或 1：一级隐藏，不可读占位符（[视频]、[音频]等）被置空，可读内容保留
+   * - 2：二级隐藏，按钮仅显示指令数据，链接仅显示 URL
+   * - 3：三级隐藏，按钮和链接的 data 也不保留，完全隐藏
+   * - 4：四级隐藏，不进行任何转换，直接丢弃
+   * @default false
+   */
+  hideUnsupported?: boolean | number;
+  /** Multi-bot mode. Keys are BotId/AppId; each child overrides common options. */
+  bots?: Record<string, Omit<Options$1, 'app_id'> & {
+    app_id?: string;
+  }>;
+  /** Required for proactive actions without BotId when more than one bot is configured. */
+  default_bot?: string;
+} & Options$1;
+declare const getQQBotConfig: () => Options;
+/** Converts legacy single-bot configuration into the same representation as multi-bot mode. */
+declare const getQQBotBots: () => {
+  bots: Map<string, Options$1>;
+  defaultBot?: string;
 };
-export declare const getIdentity: (UserId: string) => readonly [boolean, string];
-export declare const getMaster: (UserId: string) => readonly [boolean, string];
+declare const getIdentity: (UserId: string) => readonly [boolean, string];
+declare const getMaster: (UserId: string) => readonly [boolean, string];
+//#endregion
+export { Options, getIdentity, getMaster, getQQBotBots, getQQBotConfig, platform, platformFullName };

package/lib/config.js

@@ -1,45 +1,49 @@
-import { getConfigValue, isMaster, createUserHashKey } from 'alemonjs';
+import { createUserHashKey, getConfigValue, isMaster } from "alemonjs";
 
-const platform = 'qq-bot';
-const platformFullName = '@alemonjs/qq-bot';
+//#region src/config.ts
+const platform = "qq-bot";
+const platformFullName = "@alemonjs/qq-bot";
 const getQQBotConfig = () => {
-    const value = getConfigValue() || {};
-    const commonValue = value[platform] || {};
-    const bagValue = value[platformFullName] || {};
-    return { ...commonValue, ...bagValue };
+	const value = getConfigValue() || {};
+	const commonValue = value["qq-bot"] || {};
+	const bagValue = value["@alemonjs/qq-bot"] || {};
+	return {
+		...commonValue,
+		...bagValue
+	};
 };
+/** Converts legacy single-bot configuration into the same representation as multi-bot mode. */
 const getQQBotBots = () => {
-    const config = getQQBotConfig();
-    const { bots: configuredBots, default_bot, master_id: _masterId, master_key: _masterKey, markdownToText: _markdown, hideUnsupported: _hide, ...common } = config;
-    const bots = new Map();
-    if (configuredBots && Object.keys(configuredBots).length) {
-        for (const [botId, value] of Object.entries(configuredBots)) {
-            if (value.app_id && value.app_id !== botId)
-                throw new Error(`qq-bot bots.${botId}.app_id must match its map key`);
-            if (!value.secret)
-                throw new Error(`qq-bot bots.${botId}.secret is required`);
-            bots.set(botId, { ...common, ...value, app_id: botId, secret: value.secret });
-        }
-    }
-    else if (config.app_id && config.secret) {
-        bots.set(config.app_id, common);
-    }
-    if (bots.size > 1 && !default_bot)
-        throw new Error('qq-bot.default_bot is required when multiple bots are configured');
-    if (default_bot && !bots.has(default_bot))
-        throw new Error(`qq-bot.default_bot ${default_bot} is not configured`);
-    return { bots, defaultBot: default_bot || (bots.size === 1 ? bots.keys().next().value : undefined) };
+	const config = getQQBotConfig();
+	const { bots: configuredBots, default_bot, master_id: _masterId, master_key: _masterKey, markdownToText: _markdown, hideUnsupported: _hide, ...common } = config;
+	const bots = /* @__PURE__ */ new Map();
+	if (configuredBots && Object.keys(configuredBots).length) for (const [botId, value] of Object.entries(configuredBots)) {
+		if (value.app_id && value.app_id !== botId) throw new Error(`qq-bot bots.${botId}.app_id must match its map key`);
+		if (!value.secret) throw new Error(`qq-bot bots.${botId}.secret is required`);
+		bots.set(botId, {
+			...common,
+			...value,
+			app_id: botId,
+			secret: value.secret
+		});
+	}
+	else if (config.app_id && config.secret) bots.set(config.app_id, common);
+	if (bots.size > 1 && !default_bot) throw new Error("qq-bot.default_bot is required when multiple bots are configured");
+	if (default_bot && !bots.has(default_bot)) throw new Error(`qq-bot.default_bot ${default_bot} is not configured`);
+	return {
+		bots,
+		defaultBot: default_bot || (bots.size === 1 ? bots.keys().next().value : void 0)
+	};
 };
 const getIdentity = (UserId) => {
-    const isMasterUser = UserId ? isMaster(UserId, platform) : false;
-    const UserKey = createUserHashKey({
-        Platform: platform,
-        UserId
-    });
-    return [isMasterUser, UserKey];
+	return [UserId ? isMaster(UserId, platform) : false, createUserHashKey({
+		Platform: platform,
+		UserId
+	})];
 };
 const getMaster = (UserId) => {
-    return getIdentity(UserId);
+	return getIdentity(UserId);
 };
 
-export { getIdentity, getMaster, getQQBotBots, getQQBotConfig, platform, platformFullName };
+//#endregion
+export { getIdentity, getMaster, getQQBotBots, getQQBotConfig, platform, platformFullName };

package/lib/desktop.d.ts

@@ -1 +1,4 @@
-export declare const activate: (context: any) => void;
+//#region src/desktop.d.ts
+declare const activate: (context: any) => void;
+//#endregion
+export { activate };

package/lib/desktop.js

@@ -1,60 +1,56 @@
-import { readFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { getConfig, getConfigValue } from 'alemonjs';
-import { getQQBotRegistry } from './index.websoket.js';
+import { getQQBotRegistry } from "./index.websoket.js";
+import { getConfig, getConfigValue } from "alemonjs";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 
-const __dirname$1 = dirname(fileURLToPath(import.meta.url));
-const activate = context => {
-    const webView = context.createSidebarWebView(context);
-    context.onCommand('open.qq-bot', () => {
-        const dir = join(__dirname$1, '../', 'dist', 'index.html');
-        const scriptReg = /<script.*?src="(.+?)".*?>/;
-        const styleReg = /<link.*?rel="stylesheet".*?href="(.+?)".*?>/;
-        const iconReg = /<link.*?rel="icon".*?href="(.+?)".*?>/g;
-        const styleUri = context.createExtensionDir(join(__dirname$1, '../', 'dist', 'assets', 'index.css'));
-        const scriptUri = context.createExtensionDir(join(__dirname$1, '../', 'dist', 'assets', 'index.js'));
-        const html = readFileSync(dir, 'utf-8')
-            .replace(iconReg, '')
-            .replace(scriptReg, `<script type="module" crossorigin src="${scriptUri}"></script>`)
-            .replace(styleReg, `<link rel="stylesheet" crossorigin href="${styleUri}">`);
-        webView.loadWebView(html);
-    });
-    webView.onMessage(data => {
-        try {
-            if (data.type === 'qq-bot.form.save') {
-                const { bots_json: _botsJson, ...db } = data.data;
-                const config = getConfig();
-                const value = config.value ?? {};
-                value['qq-bot'] = {
-                    ...db,
-                    master_key: db.master_key?.split(',') ?? null,
-                    master_id: db.master_id?.split(',') ?? null
-                };
-                config.saveValue(value);
-                context.notification('QQ Bot 配置保存成功～');
-            }
-            else if (data.type === 'qq-bot.init') {
-                let config = getConfigValue();
-                if (!config) {
-                    config = {};
-                }
-                webView.postMessage({
-                    type: 'qq-bot.init',
-                    data: config['qq-bot'] ?? {}
-                });
-            }
-            else if (data.type === 'qq-bot.status') {
-                webView.postMessage({
-                    type: 'qq-bot.status',
-                    data: getQQBotRegistry()?.getConnectionStatus() ?? { Platform: 'qq-bot', state: 'stopped', bots: [] }
-                });
-            }
-        }
-        catch (e) {
-            console.error(e);
-        }
-    });
+//#region src/desktop.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const activate = (context) => {
+	const webView = context.createSidebarWebView(context);
+	context.onCommand("open.qq-bot", () => {
+		const dir = join(__dirname, "../", "dist", "index.html");
+		const scriptReg = /<script.*?src="(.+?)".*?>/;
+		const styleReg = /<link.*?rel="stylesheet".*?href="(.+?)".*?>/;
+		const iconReg = /<link.*?rel="icon".*?href="(.+?)".*?>/g;
+		const styleUri = context.createExtensionDir(join(__dirname, "../", "dist", "assets", "index.css"));
+		const scriptUri = context.createExtensionDir(join(__dirname, "../", "dist", "assets", "index.js"));
+		const html = readFileSync(dir, "utf-8").replace(iconReg, "").replace(scriptReg, `<script type="module" crossorigin src="${scriptUri}"><\/script>`).replace(styleReg, `<link rel="stylesheet" crossorigin href="${styleUri}">`);
+		webView.loadWebView(html);
+	});
+	webView.onMessage((data) => {
+		try {
+			if (data.type === "qq-bot.form.save") {
+				const { bots_json: _botsJson, ...db } = data.data;
+				const config = getConfig();
+				const value = config.value ?? {};
+				value["qq-bot"] = {
+					...db,
+					master_key: db.master_key?.split(",") ?? null,
+					master_id: db.master_id?.split(",") ?? null
+				};
+				config.saveValue(value);
+				context.notification("QQ Bot 配置保存成功～");
+			} else if (data.type === "qq-bot.init") {
+				let config = getConfigValue();
+				if (!config) config = {};
+				webView.postMessage({
+					type: "qq-bot.init",
+					data: config["qq-bot"] ?? {}
+				});
+			} else if (data.type === "qq-bot.status") webView.postMessage({
+				type: "qq-bot.status",
+				data: getQQBotRegistry()?.getConnectionStatus() ?? {
+					Platform: "qq-bot",
+					state: "stopped",
+					bots: []
+				}
+			});
+		} catch (e) {
+			console.error(e);
+		}
+	});
 };
 
-export { activate };
+//#endregion
+export { activate };

package/lib/format.d.ts

@@ -1,5 +1,26 @@
-import type { DataEnums, DataMarkDown } from 'alemonjs';
-export declare const markdownToText: (items: DataMarkDown["value"], hideUnsupported?: boolean | number) => string;
-export declare const buttonsToText: (rows: any[]) => string;
-export declare const markdownRawToText: (raw: string, hideUnsupported?: boolean | number) => string;
-export declare const dataEnumToText: (item: DataEnums, hideUnsupported?: boolean | number) => string;
+import { DataEnums, DataMarkDown } from "alemonjs";
+//#region src/format.d.ts
+/**
+ * 将结构化 Markdown 子元素数组转为可读纯文本
+ */
+declare const markdownToText: (items: DataMarkDown['value'], hideUnsupported?: boolean | number) => string;
+/**
+ * 将按钮组转为可读纯文本
+ */
+declare const buttonsToText: (rows: any[]) => string;
+/**
+ * 将原始 Markdown 字符串转为可读纯文本
+ * QQ Bot 不支持原始 Markdown 直接渲染，需要降级
+ */
+declare const markdownRawToText: (raw: string, hideUnsupported?: boolean | number) => string;
+/**
+ * 将 DataEnums 数组中不被原生处理的类型降级为文本
+ *
+ * qq-bot 原生支持: Text, Mention, Link, Image, ImageFile, ImageURL,
+ *                  Markdown, BT.group
+ * qq-bot 内部扩展: ButtonTemplate, Ark.list, Ark.Card, Ark.BigCard
+ * 其余类型降级为文本
+ */
+declare const dataEnumToText: (item: DataEnums, hideUnsupported?: boolean | number) => string;
+//#endregion
+export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };

package/lib/format.js

@@ -1,110 +1,93 @@
+//#region src/format.ts
+/**
+* 将结构化 Markdown 子元素数组转为可读纯文本
+*/
 const markdownToText = (items, hideUnsupported) => {
-    if (Number(hideUnsupported) >= 4) {
-        return '';
-    }
-    return items
-        .map(item => {
-        switch (item.type) {
-            case 'MD.text':
-                return item.value;
-            case 'MD.title':
-                return hideUnsupported ? `${item.value}\n` : `【${item.value}】\n`;
-            case 'MD.subtitle':
-                return hideUnsupported ? `${item.value}\n` : `〖${item.value}〗\n`;
-            case 'MD.bold':
-            case 'MD.italic':
-            case 'MD.italicStar':
-            case 'MD.strikethrough':
-                return item.value;
-            case 'MD.link': {
-                const v = item.value;
-                if (Number(hideUnsupported) >= 3) {
-                    return '';
-                }
-                return Number(hideUnsupported) >= 2 ? v.url : `${v.text}( ${v.url} )`;
-            }
-            case 'MD.image':
-                return hideUnsupported ? '' : '[图片]';
-            case 'MD.list':
-                return (item.value
-                    .map(li => {
-                    if (typeof li.value === 'object') {
-                        return `${li.value.index}. ${li.value.text ?? ''}`;
-                    }
-                    return `· ${li.value}`;
-                })
-                    .join('\n') + '\n');
-            case 'MD.blockquote':
-                return `> ${item.value}\n`;
-            case 'MD.divider':
-                return hideUnsupported ? '' : '————————\n';
-            case 'MD.newline':
-                return '\n';
-            case 'MD.code':
-                return item.value;
-            case 'MD.mention':
-                if (item.value === 'everyone') {
-                    return '@全体成员';
-                }
-                return `@${item.value ?? ''}`;
-            case 'MD.content':
-                return item.value;
-            case 'MD.button':
-                if (Number(hideUnsupported) >= 3) {
-                    return '';
-                }
-                if (Number(hideUnsupported) >= 2) {
-                    return item.options?.data || String(item.value);
-                }
-                return hideUnsupported ? String(item.value) : `[${item.value}]`;
-            default:
-                return String(item?.value ?? '');
-        }
-    })
-        .join('');
+	if (Number(hideUnsupported) >= 4) return "";
+	return items.map((item) => {
+		switch (item.type) {
+			case "MD.text": return item.value;
+			case "MD.title": return hideUnsupported ? `${item.value}\n` : `【${item.value}】\n`;
+			case "MD.subtitle": return hideUnsupported ? `${item.value}\n` : `〖${item.value}〗\n`;
+			case "MD.bold":
+			case "MD.italic":
+			case "MD.italicStar":
+			case "MD.strikethrough": return item.value;
+			case "MD.link": {
+				const v = item.value;
+				if (Number(hideUnsupported) >= 3) return "";
+				return Number(hideUnsupported) >= 2 ? v.url : `${v.text}( ${v.url} )`;
+			}
+			case "MD.image": return hideUnsupported ? "" : "[图片]";
+			case "MD.list": return item.value.map((li) => {
+				if (typeof li.value === "object") return `${li.value.index}. ${li.value.text ?? ""}`;
+				return `· ${li.value}`;
+			}).join("\n") + "\n";
+			case "MD.blockquote": return `> ${item.value}\n`;
+			case "MD.divider": return hideUnsupported ? "" : "————————\n";
+			case "MD.newline": return "\n";
+			case "MD.code": return item.value;
+			case "MD.mention":
+				if (item.value === "everyone") return "@全体成员";
+				return `@${item.value ?? ""}`;
+			case "MD.content": return item.value;
+			case "MD.button":
+				if (Number(hideUnsupported) >= 3) return "";
+				if (Number(hideUnsupported) >= 2) return item.options?.data || String(item.value);
+				return hideUnsupported ? String(item.value) : `[${item.value}]`;
+			default: return String(item?.value ?? "");
+		}
+	}).join("");
 };
+/**
+* 将按钮组转为可读纯文本
+*/
 const buttonsToText = (rows) => {
-    return rows.map((row) => row.value.map((btn) => `[${btn.value}]`).join(' ')).join('\n');
+	return rows.map((row) => row.value.map((btn) => `[${btn.value}]`).join(" ")).join("\n");
 };
+/**
+* 将原始 Markdown 字符串转为可读纯文本
+* QQ Bot 不支持原始 Markdown 直接渲染，需要降级
+*/
 const markdownRawToText = (raw, hideUnsupported) => {
-    if (Number(hideUnsupported) >= 4) {
-        return '';
-    }
-    let text = raw;
-    text = text.replace(/!\[([^\]]*)\]\([^)]*\)/g, hideUnsupported ? '' : '[图片]');
-    text = text.replace(/\[([^\]]*)\]\(([^)]*)\)/g, Number(hideUnsupported) >= 2 ? '$2' : '$1');
-    text = text.replace(/^#{1,6}\s+/gm, '');
-    text = text.replace(/(\*{3}|_{3})([^*_]+)\1/g, '$2');
-    text = text.replace(/(\*{2}|_{2})([^*_]+)\1/g, '$2');
-    text = text.replace(/(?<!\*)\*(?!\*)([^*]+)(?<!\*)\*(?!\*)/g, '$1');
-    text = text.replace(/(?<!_)_(?!_)([^_]+)(?<!_)_(?!_)/g, '$1');
-    text = text.replace(/~~([^~]+)~~/g, '$1');
-    text = text.replace(/`([^`]+)`/g, '$1');
-    text = text.replace(/```[\s\S]*?```/g, match => {
-        return match.replace(/```\w*\n?/g, '').trim();
-    });
-    text = text.replace(/^>\s+/gm, '');
-    text = text.replace(/^[-*_]{3,}\s*$/gm, hideUnsupported ? '' : '————————');
-    text = text.replace(/^[\s]*[-*+]\s+/gm, '· ');
-    text = text.replace(/^[\s]*(\d+)\.\s+/gm, '$1. ');
-    return text;
+	if (Number(hideUnsupported) >= 4) return "";
+	let text = raw;
+	text = text.replace(/!\[([^\]]*)\]\([^)]*\)/g, hideUnsupported ? "" : "[图片]");
+	text = text.replace(/\[([^\]]*)\]\(([^)]*)\)/g, Number(hideUnsupported) >= 2 ? "$2" : "$1");
+	text = text.replace(/^#{1,6}\s+/gm, "");
+	text = text.replace(/(\*{3}|_{3})([^*_]+)\1/g, "$2");
+	text = text.replace(/(\*{2}|_{2})([^*_]+)\1/g, "$2");
+	text = text.replace(/(?<!\*)\*(?!\*)([^*]+)(?<!\*)\*(?!\*)/g, "$1");
+	text = text.replace(/(?<!_)_(?!_)([^_]+)(?<!_)_(?!_)/g, "$1");
+	text = text.replace(/~~([^~]+)~~/g, "$1");
+	text = text.replace(/`([^`]+)`/g, "$1");
+	text = text.replace(/```[\s\S]*?```/g, (match) => {
+		return match.replace(/```\w*\n?/g, "").trim();
+	});
+	text = text.replace(/^>\s+/gm, "");
+	text = text.replace(/^[-*_]{3,}\s*$/gm, hideUnsupported ? "" : "————————");
+	text = text.replace(/^[\s]*[-*+]\s+/gm, "· ");
+	text = text.replace(/^[\s]*(\d+)\.\s+/gm, "$1. ");
+	return text;
 };
+/**
+* 将 DataEnums 数组中不被原生处理的类型降级为文本
+*
+* qq-bot 原生支持: Text, Mention, Link, Image, ImageFile, ImageURL,
+*                  Markdown, BT.group
+* qq-bot 内部扩展: ButtonTemplate, Ark.list, Ark.Card, Ark.BigCard
+* 其余类型降级为文本
+*/
 const dataEnumToText = (item, hideUnsupported) => {
-    if (Number(hideUnsupported) >= 4) {
-        return '';
-    }
-    switch (item.type) {
-        case 'MarkdownOriginal':
-            return markdownRawToText(String(item.value), hideUnsupported);
-        case 'Attachment':
-            return hideUnsupported ? '' : `[附件${item.options?.filename ? ': ' + item.options.filename : ''}]`;
-        case 'Audio':
-            return hideUnsupported ? '' : '[音频]';
-        case 'Video':
-            return hideUnsupported ? '' : '[视频]';
-        default:
-            return '';
-    }
+	if (Number(hideUnsupported) >= 4) return "";
+	switch (item.type) {
+		case "MarkdownOriginal": return markdownRawToText(String(item.value), hideUnsupported);
+		case "Attachment": return hideUnsupported ? "" : `[附件${item.options?.filename ? ": " + item.options.filename : ""}]`;
+		case "Audio": return hideUnsupported ? "" : "[音频]";
+		case "Video": return hideUnsupported ? "" : "[视频]";
+		default: return "";
+	}
 };
 
-export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };
+//#endregion
+export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };