@karinjs/adapter-qqbot 2.2.1 → 3.0.1

package/dist/apps/cleanup.d.ts

@@ -1,5 +1,9 @@
 //#region src/apps/cleanup.d.ts
-/** 每 10 分钟清理一次过期的 getMsg/getHistoryMsg 本地缓存。 */
-declare const clearMessageCache: import("node-karin").Task | undefined;
+/**
+ * 每 10 分钟清理一次过期的 getMsg/getHistoryMsg 本地缓存与 file_info 上传缓存。
+ *
+ * file_info 上传缓存不依赖 messageCache 开关，因此任务始终注册。
+ */
+declare const clearMessageCache: import("node-karin").Task;
 //#endregion
 export { clearMessageCache };

package/dist/apps/cleanup.js

@@ -1,22 +1,17 @@
-import { n as config } from "../config-B_Gc9JKZ.js";
-import { t as getMessageStore } from "../message-Dt4QkDYn.js";
+import { t as getMessageStore } from "../message-CVJVFAGR.js";
 import karin from "node-karin";
 
 //#region src/apps/cleanup.ts
 /**
-* 判断是否有任意 QQBot 配置开启消息缓存。
+* 每 10 分钟清理一次过期的 getMsg/getHistoryMsg 本地缓存与 file_info 上传缓存。
 *
-* @returns true 表示需要注册消息缓存清理任务。
+* file_info 上传缓存不依赖 messageCache 开关，因此任务始终注册。
 */
-const enabledMessageCache = () => {
-	return config().some((item) => item.messageCache.enable);
-};
-/** 每 10 分钟清理一次过期的 getMsg/getHistoryMsg 本地缓存。 */
-const clearMessageCache = enabledMessageCache() ? karin.task("qqbot 适配器消息缓存清理", "*/10 * * * *", async () => await getMessageStore().cleanupExpired(), {
+const clearMessageCache = karin.task("qqbot 适配器消息缓存清理", "*/10 * * * *", async () => await getMessageStore().cleanupExpired(), {
 	name: "qqbot 适配器消息缓存清理任务",
 	log: false,
 	type: "skip"
-}) : void 0;
+});
 
 //#endregion
 export { clearMessageCache };

package/dist/apps/login.d.ts

@@ -1,18 +1,4 @@
 //#region src/apps/login.d.ts
-/**
- * #QQ登录 指令
- *
- * 仅主人可用。匹配 `#QQ登录` 或 `#qqlogin`（大小写均可）。
- * 必须带 `#` 前缀。
- *
- * 流程：
- * 1. 立即回复"开始扫码"
- * 2. 触发扫码授权流程
- * 3. 每次生成新二维码 → 把 PNG 图片回复给触发者
- * 4. 授权成功 → 回复结果，watch 回调自动初始化 bot
- *
- * ⚠ 注意：扫码授权会刷新该 appId 的 secret，旧 secret 立即失效
- */
-declare const qqLogin: import("node-karin").Command<keyof import("node-karin").MessageEventMap>;
+declare const QQBotLogin: import("node-karin").Command<keyof import("node-karin").MessageEventMap>;
 //#endregion
-export { qqLogin };
+export { QQBotLogin };

package/dist/apps/login.js

@@ -1,106 +1,159 @@
-import { m as log } from "../config-B_Gc9JKZ.js";
-import { n as runQrOnboard } from "../onboard-BXQ1cG8h.js";
+import { i as getDefaultConfig, n as config } from "../config-D1_LqrcJ.js";
 import karin, { segment } from "node-karin";
+import qrcode from "qrcode";
+import axios from "node-karin/axios";
+import crypto from "node:crypto";
 
-//#region src/apps/login.ts
+//#region src/core/qrcode/session.ts
+const BASEURL = "q.qq.com";
+const headers = {
+	"Content-Type": "application/json",
+	Accept: "application/json"
+};
+/** 生成随机密钥 */
+const RandomKey = () => {
+	return crypto.randomBytes(32).toString("base64");
+};
 /**
-* #QQ登录 指令
-*
-* 仅主人可用。匹配 `#QQ登录` 或 `#qqlogin`（大小写均可）。
-* 必须带 `#` 前缀。
-*
-* 流程：
-* 1. 立即回复"开始扫码"
-* 2. 触发扫码授权流程
-* 3. 每次生成新二维码 → 把 PNG 图片回复给触发者
-* 4. 授权成功 → 回复结果，watch 回调自动初始化 bot
-*
-* ⚠ 注意：扫码授权会刷新该 appId 的 secret，旧 secret 立即失效
+* 解密密钥
+* @param encryptedBase64
+* @param keyBase64
+* @returns
 */
-/** 互斥锁：避免并发扫码 */
-let busy = false;
+const decryptSecret = (encryptedBase64, keyBase64) => {
+	const key = Buffer.from(keyBase64, "base64");
+	const data = Buffer.from(encryptedBase64, "base64");
+	const IV = data.subarray(0, 12);
+	const authtag = data.subarray(data.length - 16);
+	const ciphertext = data.subarray(12, data.length - 16);
+	const decipher = crypto.createDecipheriv("aes-256-gcm", key, IV);
+	decipher.setAuthTag(authtag);
+	return Buffer.concat([decipher.update(ciphertext), decipher.final()]).toString("utf8");
+};
 /**
-* 判断触发 #QQ登录 的上游是否为 Karin 控制台适配器。
-* Console 适配器无法直接在聊天窗口展示二维码图片，因此需要额外打印终端二维码。
+* 创建绑定任务
+* @param timeout 超时时间
 */
-const isConsoleAdapter = (bot) => {
-	const selfId = String(bot.selfId || "").toLowerCase();
-	const name = String(bot.adapter.name || "").toLowerCase();
-	const protocol = String(bot.adapter.protocol || "").toLowerCase();
-	return selfId === "console" || name === "console" || name.endsWith("/console") || protocol === "console";
+const createBindTask = async (timeout = 1e4) => {
+	const url = `https://${BASEURL}/lite/create_bind_task`;
+	const key = RandomKey();
+	const { data } = await axios.post(url, { key }, {
+		headers,
+		timeout
+	});
+	if (data.retcode !== 0) throw new Error(data.msg ?? "创建绑定任务失败");
+	if (!data.data?.task_id) throw new Error("创建绑定任务失败: task_id 缺失");
+	return {
+		taskId: data.data.task_id,
+		aesKey: key
+	};
 };
 /**
-* 记录一次回复返回的消息 ID，便于扫码流程结束后清理二维码、链接等临时信息。
-* @param result 回复返回值。
-* @param messageIds 已登记的消息 ID 集合。
+* 查询绑定结果
+* @param taskId 任务id
+* @param timeout 超时时间
 */
-const trackReply = (result, messageIds) => {
-	const messageId = result?.messageId;
-	if (messageId && !messageIds.includes(messageId)) messageIds.push(messageId);
+const checkBindResult = async (taskId, timeout = 1e4) => {
+	const url = `https://${BASEURL}/lite/poll_bind_result`;
+	const { data } = await axios.post(url, { task_id: taskId }, {
+		headers,
+		timeout
+	});
+	if (data.retcode !== 0) throw new Error(data.msg ?? "查询绑定结果失败");
+	return {
+		status: data.data?.status ?? 0,
+		appId: String(data.data?.bot_appid ?? ""),
+		encryptedSecret: data.data?.bot_encrypt_secret ?? "",
+		userOpenid: data.data?.user_openid ?? void 0
+	};
 };
+/** 构建连接URL */
+const buildConnectUrl = (taskId) => `https://${BASEURL}/qqbot/openclaw/connect.html?task_id=${encodeURIComponent(taskId)}&source=karin&_wv=2`;
+
+//#endregion
+//#region src/core/qrcode/qr.ts
+const WaitingMS = 2e3;
 /**
-* 撤回扫码流程中发出的临时消息。
-* @param bot 触发登录的机器人实例。
-* @param contact 回复所在会话。
-* @param messageIds 需要撤回的消息 ID。
+* 轮询绑定结果
+* @param taskId 任务ID
+* @param key 解密密钥
+* @returns QQBot 的appid与secret
 */
-const recallTrackedReplies = async (bot, contact, messageIds) => {
-	for (const messageId of messageIds) try {
-		await bot.recallMsg(contact, messageId);
-	} catch (err) {
-		log("warn", `[扫码登录] 撤回临时消息失败: ${messageId}`, err);
+const PollBindResult = async (taskId, key) => {
+	while (true) {
+		let data;
+		try {
+			data = await checkBindResult(taskId);
+		} catch {
+			await new Promise((resolve) => setTimeout(resolve, WaitingMS));
+			continue;
+		}
+		if (data.status === 2) {
+			const secret = decryptSecret(data.encryptedSecret, key);
+			return {
+				status: data.status,
+				appId: data.appId,
+				secret
+			};
+		}
+		if (data.status === 3) return { status: data.status };
+		await new Promise((resolve) => setTimeout(resolve, WaitingMS));
 	}
-	messageIds.length = 0;
 };
-const qqLogin = karin.command(/^#(?:qq登录|qqlogin)$/i, async (e) => {
-	if (busy) {
-		await e.reply("已有扫码授权在进行中，请稍候再试");
-		return;
-	}
-	busy = true;
-	const messageIds = [];
-	/**
-	* 发送并登记扫码流程的临时回复。
-	* @param elements 回复内容。
-	*/
-	const replyAndTrack = async (elements) => {
-		const result = await e.reply(elements);
-		trackReply(result, messageIds);
-		return result;
+
+//#endregion
+//#region src/apps/login.ts
+let busy = false;
+const QQBotLogin = karin.command(/^#qqbot(登录|login)$/i, async (e) => {
+	const msgIds = [];
+	const reply = async (elements) => {
+		const res = await e.reply(elements, { at: true });
+		msgIds.push(res.messageId);
 	};
-	try {
-		await replyAndTrack([segment.text("已开始 QQ 扫码登录授权\n⚠ 扫码完成会刷新该机器人的 secret，旧 secret 立即失效")]);
-		log("info", `[扫码登录] 由用户 ${e.userId} 触发`);
-		const ok = await runQrOnboard({
-			printTerminal: isConsoleAdapter(e.bot),
-			onQr: async ({ base64, url, refresh }) => {
-				const head = refresh === 0 ? "请使用手机 QQ 扫描二维码完成授权（二维码 60s 内有效，过期会自动刷新最多 3 次）：" : `上一张二维码已过期，已自动刷新（第 ${refresh}/3 次，仍为 60s 有效期）：`;
-				try {
-					await replyAndTrack([
-						segment.text(head),
-						segment.image(base64),
-						segment.text(`或在手机 QQ 打开链接：\n${url}`)
-					]);
-				} catch (err) {
-					log("warn", "[扫码登录] 推送二维码失败:", err);
-				}
-			}
+	if (busy) return await e.reply("已有扫码授权在进行中，请稍候再试", { reply: true });
+	busy = true;
+	await reply("注意: 确认登录后将刷新 QQBot 的 AppSecret,旧的 AppSecret 将失效");
+	const task = await createBindTask();
+	const url = buildConnectUrl(task.taskId);
+	const msg = [segment.text("请使用 QQ 扫码登录")];
+	if (e.bot.adapter.protocol === "console") {
+		const qrcode$1 = await qrcode.toString(url, {
+			type: "terminal",
+			small: true
 		});
-		await recallTrackedReplies(e.bot, e.contact, messageIds);
-		if (ok) await e.reply("扫码授权成功，配置已保存，QQBot 实例正在初始化…");
-		else await e.reply("扫码授权失败或超时，请重试 #QQ登录");
-	} catch (err) {
-		log("error", "[扫码登录] 异常:", err);
-		await recallTrackedReplies(e.bot, e.contact, messageIds);
-		await e.reply("扫码授权过程中发生异常，详情见服务端日志");
-	} finally {
-		busy = false;
+		msg.push(segment.text(`\n${qrcode$1}`));
+	} else {
+		const qrcode$2 = await qrcode.toDataURL(url);
+		msg.push(segment.image(qrcode$2));
+	}
+	msg.push(segment.text(`或使用手机 QQ 打开链接登录: ${url}`));
+	await reply(msg);
+	const ok = await PollBindResult(task.taskId, task.aesKey);
+	msgIds.forEach(async (id) => {
+		await e.bot.recallMsg(e.contact, id).catch(() => {});
+	});
+	if (ok.status === 2) {
+		const list = config();
+		const idx = list.findIndex((item) => item.appId === ok.appId);
+		if (idx >= 0) {
+			list[idx].secret = ok.secret;
+			e.reply(`Bot存在,已更新[${ok.appId}]配置`, { reply: true });
+		} else {
+			const defaults = getDefaultConfig()[0];
+			list.push({
+				...defaults,
+				appId: ok.appId,
+				secret: ok.secret
+			});
+			e.reply(`[${ok.appId}] 扫码登录成功`, { reply: true });
+		}
+		return;
 	}
+	return await e.reply("二维码过期,请重新触发指令", { reply: true });
 }, {
-	name: "qqbot:login",
-	permission: "master",
-	authFailMsg: "#QQ登录 仅限主人使用"
+	perm: "master",
+	name: "QQBot 扫码登录"
 });
 
 //#endregion
-export { qqLogin };
+export { QQBotLogin };

package/dist/config-D1_LqrcJ.js

@@ -0,0 +1,196 @@
+import { common, karinPathBase, logger, requireFileSync, watch } from "node-karin";
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "node:fs";
+
+//#region src/root.ts
+/** 当前文件的绝对路径 */
+const filePath = fileURLToPath(import.meta.url);
+/** 插件包绝对路径 */
+const dirPath = path.resolve(filePath, "../..");
+/** 插件包的名称 */
+const basename = path.basename(dirPath);
+
+//#endregion
+//#region src/utils/plugin.ts
+/**
+* 读取当前插件的 package.json。
+*
+* @returns package.json 内容。
+*/
+const pkg = () => requireFileSync(`${dirPath}/package.json`);
+/** 当前插件 npm 包名，如 @karinjs/adapter-qqbot。 */
+const pluginName = pkg().name;
+/** 文件系统目录名：把 npm 包名里的 `/` 规范化为 `-`，与 Karin 框架对齐。 */
+const pluginDirName = pluginName.replace(/\//g, "-");
+
+//#endregion
+//#region src/utils/config.ts
+let cache;
+const cacheMap = {};
+/** 延迟注入，避免与 core/index.ts 循环依赖 */
+let _createBot;
+let _destroyBot;
+const bindHandlers = (createBot, destroyBot) => {
+	_createBot = createBot;
+	_destroyBot = destroyBot;
+};
+/** 配置目录：${karinPathBase}/@karinjs-adapter-qqbot/config */
+const dirConfig = `${karinPathBase}/${pluginDirName}/config`;
+const configPath = `${dirConfig}/config.json`;
+const syncCache = (data) => {
+	cache = data;
+	Object.keys(cacheMap).forEach((key) => delete cacheMap[key]);
+	data.forEach((v) => {
+		cacheMap[v.appId] = v;
+	});
+};
+/**
+* 读取配置
+*/
+const config = () => {
+	if (!fs.existsSync(configPath)) {
+		fs.mkdirSync(dirConfig, { recursive: true });
+		fs.writeFileSync(configPath, JSON.stringify([], null, 2));
+	}
+	if (cache) return cache;
+	const user = requireFileSync(configPath);
+	const result = formatConfig(user);
+	syncCache(result);
+	return result;
+};
+/**
+* 直接从磁盘读取配置，不使用内存缓存。
+*/
+const readConfigFile = () => {
+	if (!fs.existsSync(configPath)) return config();
+	return formatConfig(requireFileSync(configPath));
+};
+/**
+* 获取单 bot 配置
+*/
+const getConfig = (appid) => cacheMap[appid];
+/**
+* 写入配置
+*/
+const writeConfig = (data) => {
+	fs.mkdirSync(dirConfig, { recursive: true });
+	const normalized = formatConfig(data);
+	fs.writeFileSync(configPath, JSON.stringify(normalized, null, 2));
+	syncCache(normalized);
+};
+/**
+* 用默认值补齐用户配置
+*/
+const formatConfig = (user) => {
+	const def = getDefaultConfig()[0];
+	return user.map((item) => {
+		const { markdown, messageCache, event, ...rest } = item;
+		return {
+			...def,
+			...rest,
+			markdown: {
+				...def.markdown,
+				...markdown
+			},
+			messageCache: normalizeMessageCache(def.messageCache, messageCache),
+			event: {
+				...def.event,
+				...event
+			}
+		};
+	});
+};
+const MESSAGE_CACHE_LEVELS = [
+	"minimal",
+	"standard",
+	"full"
+];
+/**
+* 规范化消息缓存配置，非法枚举与越界数值回落默认值。
+*
+* @param def 默认消息缓存配置。
+* @param user 用户消息缓存配置。
+* @returns 补齐并夹取后的消息缓存配置。
+*/
+const normalizeMessageCache = (def, user) => {
+	const merged = {
+		...def,
+		...user
+	};
+	return {
+		enable: !!merged.enable,
+		self: !!merged.self,
+		level: MESSAGE_CACHE_LEVELS.includes(merged.level) ? merged.level : def.level,
+		ttlHours: clampNumber(merged.ttlHours, 1, 720, def.ttlHours),
+		maxRows: clampNumber(merged.maxRows, 1e3, 5e6, def.maxRows)
+	};
+};
+/**
+* 将数值夹取到闭区间；非法值返回 fallback。
+*
+* @param value 用户输入值。
+* @param min 最小值。
+* @param max 最大值。
+* @param fallback 非法时使用的默认值。
+* @returns 合法数值。
+*/
+const clampNumber = (value, min, max, fallback) => {
+	const num = Number(value);
+	if (!Number.isFinite(num)) return fallback;
+	return Math.min(Math.max(Math.trunc(num), min), max);
+};
+/**
+* 默认配置
+*/
+const getDefaultConfig = () => [{
+	appId: "",
+	secret: "",
+	qqEnable: true,
+	guildEnable: true,
+	guildMode: 0,
+	regex: [{
+		reg: "^/",
+		rep: "#"
+	}],
+	markdown: { enable: true },
+	messageCache: {
+		enable: false,
+		self: false,
+		level: "standard",
+		ttlHours: 24,
+		maxRows: 2e5
+	},
+	event: { type: 2 }
+}];
+/**
+* 监听配置文件，比较前后差异决定重建 / 销毁 bot
+*/
+setTimeout(() => {
+	watch(`${dirConfig}/config.json`, (old, now) => {
+		const oldConfig = formatConfig(old);
+		const nowConfig = formatConfig(now);
+		syncCache(nowConfig);
+		const diff = common.diffArray(oldConfig, nowConfig);
+		diff.removed.forEach((v) => _destroyBot?.(v.appId));
+		if (diff.added.length > 0) {
+			const ids = new Set(diff.added.map((v) => v.appId));
+			nowConfig.forEach((v) => {
+				if (!ids.has(v.appId)) return;
+				if (v.event.type === 0) return;
+				_createBot?.(v);
+			});
+		}
+		diff.common.forEach((curr) => {
+			const prev = oldConfig.find((c) => c.appId === curr.appId);
+			if (!prev) return;
+			if (JSON.stringify(prev) === JSON.stringify(curr)) return;
+			logger.info(`[QQ Official Bot][配置监听] 配置已变更: ${curr.appId}，重新初始化`);
+			_destroyBot?.(prev.appId);
+			if (curr.event.type !== 0) _createBot?.(curr);
+		});
+	});
+}, 2e3);
+
+//#endregion
+export { readConfigFile as a, pluginDirName as c, getDefaultConfig as i, basename as l, config as n, writeConfig as o, getConfig as r, pkg as s, bindHandlers as t };