@alemonjs/qq-bot 2.1.34 → 2.1.36

package/README.md

@@ -116,7 +116,7 @@ export default async () => {
 
 ### 流程
 
-1. 启动适配器（默认 WebSocket 模式），终端输出授权二维码与链接，并在**运行目录**保存二维码图片（`qqbot-login-qr.png`，二维码刷新时自动覆盖）；
+1. 启动适配器（默认 WebSocket 模式），通过 CBP 输出授权二维码与链接；二维码图片由 CBP/UI 统一处理；
 2. 使用**手机 QQ**（开放平台上该机器人的管理者账号）扫描二维码（终端直接扫，或打开保存的图片扫），并在页面中确认授权；
 3. 适配器自动轮询授权结果，平台下发的凭证在本地解密（AES-256-GCM，密钥不落盘）；
 4. `app_id` 与 `secret` 自动写入 `alemon.config.yaml` 的 `qq-bot` 节（保留文件中已有的注释与原格式），随后立即连接，无需重启。
@@ -131,13 +131,13 @@ export default async () => {
 
 ### 说明
 
-| 事项     | 说明                                                                                             |
-| -------- | ------------------------------------------------------------------------------------------------ |
-| 触发条件 | 配置中未填写 `app_id`/`secret`，且未配置 `bots`（WebSocket 模式）                                |
-| 二维码   | 终端出码 + 图片保存到运行目录（`qqbot-login-qr.png`），过期自动刷新（最多 3 次），总超时 10 分钟 |
-| 凭证安全 | AppSecret 全程密文传输、本地解密，密钥仅存内存不落盘                                             |
-| 失败处理 | 超时 / 刷新次数用尽 / 授权取消时跳过连接并输出日志，可重启重试或手动配置                         |
-| Webhook  | Webhook 模式（配置 `route`/`port`/`ws`）不触发扫码流程，需自行填写完整配置                       |
+| 事项     | 说明                                                                       |
+| -------- | -------------------------------------------------------------------------- |
+| 触发条件 | 配置中未填写 `app_id`/`secret`，且未配置 `bots`（WebSocket 模式）          |
+| 二维码   | CBP 统一输出，过期自动刷新（最多 3 次），总超时 10 分钟                    |
+| 凭证安全 | AppSecret 全程密文传输、本地解密，密钥仅存内存不落盘                       |
+| 失败处理 | 超时 / 刷新次数用尽 / 授权取消时跳过连接并输出日志，可重启重试或手动配置   |
+| Webhook  | Webhook 模式（配置 `route`/`port`/`ws`）不触发扫码流程，需自行填写完整配置 |
 
 ---
 

package/lib/format.d.ts

@@ -1,5 +1,7 @@
 import { DataEnums, DataMarkDown } from "alemonjs";
 //#region src/format.d.ts
+/** 群聊、私聊和频道共用有序正文；提及等原生文本由发送上下文提供。 */
+declare const formatQQContent: (items: DataEnums[], renderNative: (item: DataEnums) => string, plain?: boolean, hideUnsupported?: boolean | number) => string;
 /**
  * 将结构化 Markdown 子元素数组转为可读纯文本
  */
@@ -22,5 +24,6 @@ declare const markdownRawToText: (raw: string, hideUnsupported?: boolean | numbe
  * 其余类型降级为文本
  */
 declare const dataEnumToText: (item: DataEnums, hideUnsupported?: boolean | number) => string;
+declare const createMarkdownText: (data: DataMarkDown['value']) => string;
 //#endregion
-export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };
+export { buttonsToText, createMarkdownText, dataEnumToText, formatQQContent, markdownRawToText, markdownToText };

package/lib/format.js

@@ -1,10 +1,32 @@
+import { joinMarkdownParts, renderMarkdownBlockquote } from "alemonjs/markdown";
+
 //#region src/format.ts
+/** 群聊、私聊和频道共用有序正文；提及等原生文本由发送上下文提供。 */
+const formatQQContent = (items, renderNative, plain = false, hideUnsupported) => {
+	return items.map((item) => {
+		if (item.type === "Markdown") return plain ? markdownToText(item.value, hideUnsupported) : createMarkdownText(item.value);
+		if (item.type === "MarkdownOriginal") {
+			const text = plain ? markdownRawToText(item.value, hideUnsupported) : item.value;
+			return text ? `\n\n${text}\n\n` : "";
+		}
+		if (item.type === "BT.group") {
+			if (!plain || Number(hideUnsupported) >= 4) return "";
+			const text = item.value.map((row) => row.value.map((button) => {
+				if (Number(hideUnsupported) >= 3) return "";
+				if (Number(hideUnsupported) >= 2) return button.options?.data || button.value;
+				return hideUnsupported ? button.value : `[${button.value}]`;
+			}).filter(Boolean).join(" ")).filter(Boolean).join("\n");
+			return text ? `\n\n${text}\n\n` : "";
+		}
+		return renderNative(item);
+	}).join("");
+};
 /**
 * 将结构化 Markdown 子元素数组转为可读纯文本
 */
 const markdownToText = (items, hideUnsupported) => {
 	if (Number(hideUnsupported) >= 4) return "";
-	return items.map((item) => {
+	return joinMarkdownParts(items, items.map((item) => {
 		switch (item.type) {
 			case "MD.text": return item.value;
 			case "MD.title": return hideUnsupported ? `${item.value}\n` : `【${item.value}】\n`;
@@ -16,6 +38,7 @@ const markdownToText = (items, hideUnsupported) => {
 			case "MD.link": {
 				const v = item.value;
 				if (Number(hideUnsupported) >= 3) return "";
+				if (!v.url) return v.text;
 				return Number(hideUnsupported) >= 2 ? v.url : `${v.text}( ${v.url} )`;
 			}
 			case "MD.image": return hideUnsupported ? "" : "[图片]";
@@ -23,7 +46,7 @@ const markdownToText = (items, hideUnsupported) => {
 				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.blockquote": return renderMarkdownBlockquote(item.value, (children) => markdownToText(children, hideUnsupported));
 			case "MD.divider": return hideUnsupported ? "" : "————————\n";
 			case "MD.newline": return "\n";
 			case "MD.code": return item.value;
@@ -37,7 +60,7 @@ const markdownToText = (items, hideUnsupported) => {
 				return hideUnsupported ? String(item.value) : `[${item.value}]`;
 			default: return String(item?.value ?? "");
 		}
-	}).join("");
+	}));
 };
 /**
 * 将按钮组转为可读纯文本
@@ -88,6 +111,47 @@ const dataEnumToText = (item, hideUnsupported) => {
 		default: return "";
 	}
 };
+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) => renderMarkdownBlockquote(value, createMarkdownText),
+	"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 (value === "everyone") return "<qqbot-at-everyone />";
+		if (belong === "user") return `<qqbot-at-user id="${value}" />`;
+		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 joinMarkdownParts(data, 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"] || "");
+	}));
+};
 
 //#endregion
-export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };
+export { buttonsToText, createMarkdownText, dataEnumToText, formatQQContent, markdownRawToText, markdownToText };

package/lib/index.websoket.js

@@ -31,7 +31,7 @@ const bootstrap = async () => {
 	activeRegistry = registry;
 	if (!hasConfiguredCredentials()) {
 		logger.info("[qq-bot] 未检测到 app_id/secret 配置，进入扫码登录流程");
-		const result = await qrLogin({ onQRCode: (qrBuffer, url, _qrImagePath, loginId, refresh) => {
+		const result = await qrLogin({ onQRCode: (qrBuffer, url, loginId, refresh) => {
 			loginStatus = {
 				state: "awaiting_qrcode",
 				type: "qrcode",

package/lib/sdk/qr-auth.d.ts

@@ -35,14 +35,14 @@ type QRLoginOptions = {
   pollInterval?: number;
   /** 注入门户请求（测试用） */
   request?: PortalRequest;
-  /** 二维码生成回调（默认同时终端出码并保存图片到运行目录） */
-  onQRCode?: (qrBuffer: Buffer, url: string, qrImagePath: string | undefined, loginId: string, refresh: number) => void | Promise<void>;
+  /** 二维码生成回调；图片由回调方或 CBP 统一处理，不在适配器运行目录落盘 */
+  onQRCode?: (qrBuffer: Buffer, url: string, loginId: string, refresh: number) => void | Promise<void>;
   /** 状态变化回调 */
   onStatus?: (message: string) => void | Promise<void>;
 };
 /**
  * 扫码登录流程：
- * 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+ * 创建绑定任务 → 生成二维码并通过回调交给 CBP/UI → 轮询授权结果 → 解密 AppSecret。
  * 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
  */
 declare const qrLogin: (options?: QRLoginOptions) => Promise<QRLoginResult | null>;

package/lib/sdk/qr-auth.js

@@ -2,7 +2,7 @@ import { getConfig, logger } from "alemonjs";
 import axios from "axios";
 import { createDecipheriv, randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { dirname } from "node:path";
 import QRCode from "qrcode";
 import YAML from "yaml";
 
@@ -51,7 +51,7 @@ const buildConnectUrl = (taskId) => {
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
 * 扫码登录流程：
-* 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+* 创建绑定任务 → 生成二维码并通过回调交给 CBP/UI → 轮询授权结果 → 解密 AppSecret。
 * 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
 */
 const qrLogin = async (options = {}) => {
@@ -70,7 +70,6 @@ const qrLogin = async (options = {}) => {
 			return null;
 		}
 		const url = buildConnectUrl(taskId);
-		let qrImagePath = null;
 		let qrBuffer = null;
 		try {
 			qrBuffer = await QRCode.toBuffer(url, {
@@ -78,12 +77,10 @@ const qrLogin = async (options = {}) => {
 				width: 320,
 				margin: 2
 			});
-			qrImagePath = join(process.cwd(), "qqbot-login-qr.png");
-			writeFileSync(qrImagePath, qrBuffer);
 		} catch (err) {
-			logger.warn(`[qq-bot] 二维码图片保存失败：${err?.message ?? err}`);
+			logger.warn(`[qq-bot] 二维码生成失败：${err?.message ?? err}`);
 		}
-		if (qrBuffer && onQRCode) await onQRCode(qrBuffer, url, qrImagePath ?? void 0, taskId, refresh);
+		if (qrBuffer && onQRCode) await onQRCode(qrBuffer, url, taskId, refresh);
 		await onStatus?.("请使用手机 QQ 扫描二维码并确认授权");
 		logger.warn("[qq-bot] 注意：扫码授权完成后平台将重置机器人密钥，旧密钥会立即失效；若该机器人已在其他实例中运行，请更新其配置");
 		while (Date.now() < deadline) {

package/lib/sends.js

@@ -1,5 +1,5 @@
 import { getQQBotConfig } from "./config.js";
-import { buttonsToText, dataEnumToText, markdownToText } from "./format.js";
+import { createMarkdownText, dataEnumToText, formatQQContent } from "./format.js";
 import { ResultCode, createResult, logger } from "alemonjs";
 import { readFileSync } from "fs";
 import axios from "axios";
@@ -172,47 +172,6 @@ const createArkListData = (value) => {
 		]
 	};
 };
-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}" />`;
-	}
-};
-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") 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;
@@ -373,16 +332,7 @@ const resolveMediaUrl = async (media, uploadMedia) => {
 	}
 };
 /** 移除富媒体占位符（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 stripMediaPlaceholders = (text) => text.replace(/\[附件[^\]]*\]/g, "").replace(/\[音频\]/g, "").replace(/\[视频\]/g, "").trim();
 /** Open API 通用发送逻辑（群组 / C2C） */
 const sendOpenApiMessage = async (content, val, baseParams, uploadMedia, sendMessage, label, options) => {
 	const config = getQQBotConfig();
@@ -392,7 +342,7 @@ const sendOpenApiMessage = async (content, val, baseParams, uploadMedia, sendMes
 		const fileInfo = await resolveMediaUrl(media, uploadMedia);
 		if (!fileInfo) return [createResult(ResultCode.Fail, "媒体上传失败", null)];
 		const res = await sendMessage({
-			content: stripMediaPlaceholders(flattenMdToText(content, val)),
+			content: stripMediaPlaceholders(formatQQContent(val, (item) => extractContent([item], "group"), true, config.hideUnsupported)),
 			media: { file_info: fileInfo },
 			msg_type: 7,
 			...baseParams
@@ -404,7 +354,7 @@ const sendOpenApiMessage = async (content, val, baseParams, uploadMedia, sendMes
 		return [];
 	}
 	if (mdToText) {
-		const textContent = flattenMdToText(content, val);
+		const textContent = formatQQContent(val, (item) => extractContent([item], "group"), true, config.hideUnsupported);
 		if (textContent) {
 			const res = await sendMessage({
 				content: textContent,
@@ -417,7 +367,7 @@ const sendOpenApiMessage = async (content, val, baseParams, uploadMedia, sendMes
 	}
 	const mdParams = buildMdAndButtonsParams(val);
 	if (mdParams) {
-		if (mdParams.markdown?.content && content) mdParams.markdown.content = content + "\n" + mdParams.markdown.content;
+		if (mdParams.markdown?.content) mdParams.markdown.content = formatQQContent(val, (item) => extractContent([item], "group"));
 		const res = await sendMessage({
 			content,
 			msg_type: 2,
@@ -463,14 +413,14 @@ const resolveImageBuffer = async (images) => {
 	return null;
 };
 /** Guild API 通用发送逻辑（频道公聊 / 频道私聊） */
-const sendGuildMessage = async (content, val, baseParams, sendMessage, label) => {
+const sendGuildMessage = async (content, val, baseParams, sendMessage, label, mode) => {
 	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),
+			content: formatQQContent(val, (item) => extractContent([item], mode), true, config.hideUnsupported),
 			...baseParams
 		}, imageBuffer);
 		return [createResult(ResultCode.Ok, label, { id: res?.id })];
@@ -480,7 +430,7 @@ const sendGuildMessage = async (content, val, baseParams, sendMessage, label) =>
 		return [];
 	}
 	if (mdToText) {
-		const textContent = flattenMdToText(content, val);
+		const textContent = formatQQContent(val, (item) => extractContent([item], mode), true, config.hideUnsupported);
 		if (textContent) {
 			const res = await sendMessage({
 				content: textContent,
@@ -492,7 +442,7 @@ const sendGuildMessage = async (content, val, baseParams, sendMessage, label) =>
 	}
 	const mdParams = buildMdAndButtonsParams(val);
 	if (mdParams) {
-		if (mdParams.markdown?.content && content) mdParams.markdown.content = content + "\n" + mdParams.markdown.content;
+		if (mdParams.markdown?.content) mdParams.markdown.content = formatQQContent(val, (item) => extractContent([item], mode));
 		const res = await sendMessage({
 			content: "",
 			...mdParams,
@@ -549,7 +499,7 @@ 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");
+		return await sendGuildMessage(content, val, baseParams, (data, buf) => client.dmsMessages(event.UserId, data, buf), "client.dmsMessage", "guild-direct");
 	} catch (err) {
 		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
 	}
@@ -561,7 +511,7 @@ 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");
+		return await sendGuildMessage(content, val, baseParams, (data, buf) => client.channelsMessages(event.ChannelId, data, buf), "client.channelsMessagesPost", "guild-public");
 	} catch (err) {
 		return [createResult(ResultCode.Fail, err?.response?.data ?? err?.message ?? err, null)];
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alemonjs/qq-bot",
-  "version": "2.1.34",
+  "version": "2.1.36",
   "description": "QQ官方平台",
   "author": "lemonade",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "yaml": "^2.5.1"
   },
   "peerDependencies": {
-    "alemonjs": "^2.1.0-alpha.15"
+    "alemonjs": "^2.1.108"
   },
   "types": "lib",
   "exports": {
@@ -97,5 +97,5 @@
     "type": "git",
     "url": "https://github.com/lemonade-lab/alemonjs.git"
   },
-  "gitHead": "8e6c0d91889ff7926fc7bc58ac8dc664c8f721ea"
+  "gitHead": "a4d4fded0874b070e356e6a83b06bd3e474f9133"
 }