karin-plugin-adapter-all 0.0.0-stage → 1.2.0

package/dist/icqq-BR8miqDV.js

@@ -0,0 +1,1771 @@
+import { n as emitLoginEvent, r as BaseBot, t as clearLoginState } from "./server.js";
+import path from "node:path";
+import { contactFriend, contactGroup, contactGroupTemp, createFriendMessage, createGroupAdminChangedNotice, createGroupApplyRequest, createGroupInviteRequest, createGroupMemberAddNotice, createGroupMemberBanNotice, createGroupMemberDelNotice, createGroupMessage, createGroupMessageReactionNotice, createGroupPokeNotice, createGroupRecallNotice, createGroupTempMessage, createPrivateApplyRequest, createPrivatePokeNotice, createPrivateRecallNotice, karinPathData, logger, segment, senderFriend, senderGroup, senderGroupTemp } from "node-karin";
+import fs from "node:fs";
+import { createClient, genDmMessageId, genGroupMessageId, parseDmMessageId, parseGroupMessageId, segment as segment$1 } from "icqq";
+import icqqPkg from "icqq/package.json" with { type: "json" };
+
+//#region src/adapters/icqq/convert.ts
+/** 从收到的消息构造 karin Contact (供会话级 API 使用, 转发节点转换场景传 ForwardMessage 兜底私聊) */
+function contactOf(message) {
+	const msg = message;
+	if (msg.message_type === "group") {
+		return {
+			scene: "group",
+			peer: String(message.group_id ?? message.user_id),
+			subId: {},
+			name: ""
+		};
+	}
+	return {
+		scene: "friend",
+		peer: String(message.from_id ?? message.user_id),
+		subId: {},
+		name: ""
+	};
+}
+/** resid 归属场景缓存: 合并转发 resid 解包依赖群/私聊上下文, 收侧记录以便 getForwardMsg 选择正确的会话对象 */
+const residScene = new Map();
+/** 记录 resid 场景 (容量 500, 淘汰最旧) */
+function rememberResidScene(resId, contact) {
+	if (!resId) return;
+	residScene.set(resId, {
+		scene: contact.scene === "group" ? "group" : "friend",
+		peer: contact.peer
+	});
+	if (residScene.size > 500) {
+		const first = residScene.keys().next().value;
+		if (first) residScene.delete(first);
+	}
+}
+/** 查询 resid 归属场景 */
+function getResidScene(resId) {
+	return residScene.get(resId);
+}
+/**
+* 把 icqq 元素的消息 id(群/私聊 cqhttp 字符串) 解析成可引用的 Quotable
+* 用于 Karin reply 段 → icqq 引用回复
+*/
+const parseQuotable = (messageId) => {
+	try {
+		if (messageId.includes("group")) {
+			const info = parseGroupMessageId(messageId);
+			return {
+				user_id: info.user_id,
+				time: info.time,
+				seq: info.seq,
+				rand: info.rand,
+				message: ""
+			};
+		}
+		const info = parseDmMessageId(messageId);
+		return {
+			user_id: info.user_id,
+			time: info.time,
+			seq: info.seq,
+			rand: info.rand,
+			message: ""
+		};
+	} catch {
+		return undefined;
+	}
+};
+/** 根据消息上下文 + 引用信息生成 Karin reply 所需的 cqhttp message_id */
+const encodeQuoteMsgId = (message, q) => {
+	if (message.message_type === "group") {
+		return genGroupMessageId(message.group_id, q.user_id, q.seq, q.rand, q.time);
+	}
+	return genDmMessageId(q.user_id, q.seq, q.rand, q.time);
+};
+/** icqq 收到的消息 转 Karin Elements */
+async function AdapterConvertKarin$1(message, bot) {
+	const elements = [];
+	const source = message.source;
+	if (source) {
+		elements.push(segment.reply(encodeQuoteMsgId(message, source)));
+	}
+	for (const i of message.message) {
+		switch (i.type) {
+			case "text":
+				elements.push(segment.text(i.text));
+				break;
+			case "at":
+				if (i.qq === "all") {
+					elements.push(segment.at("all"));
+				} else {
+					elements.push(segment.at(String(i.qq), i.text));
+				}
+				break;
+			case "face":
+			case "sface":
+				elements.push(segment.face(i.id));
+				break;
+			case "image":
+				elements.push(segment.image(i.url || String(i.file), {
+					width: i.width,
+					height: i.height,
+					summary: i.summary
+				}));
+				break;
+			case "record": {
+				let url = i.url || "";
+				if (!url && i.fid) {
+					try {
+						url = await bot.getRecordUrl(contactOf(message), i) || "";
+					} catch {}
+				}
+				elements.push(segment.record(url || String(i.file)));
+				break;
+			}
+			case "video": {
+				let url = "";
+				if (i.fid) {
+					try {
+						url = await bot.getVideoUrl(contactOf(message), i) || "";
+					} catch {}
+				}
+				elements.push(segment.video(url || String(i.file), {
+					width: i.width,
+					height: i.height,
+					name: i.name
+				}));
+				break;
+			}
+			case "flash":
+				elements.push(segment.image(i.url || String(i.file)));
+				break;
+			case "json":
+				elements.push(segment.json(typeof i.data === "string" ? i.data : JSON.stringify(i.data)));
+				break;
+			case "xml":
+				elements.push(segment.xml(String(i.data ?? "")));
+				break;
+			case "markdown":
+				elements.push(segment.markdown(i.content));
+				break;
+			case "reply":
+				elements.push(segment.reply(i.id));
+				break;
+			case "quote": {
+				const mid = encodeQuoteMsgId(message, i);
+				elements.push(segment.reply(mid));
+				break;
+			}
+			case "file": {
+				if (i.fid) {
+					const msg = message;
+					const scene = msg.message_type === "private" ? "friend" : "group";
+					const peer = scene === "friend" ? String(msg.from_id ?? msg.user_id) : String(msg.group_id ?? msg.user_id);
+					const contact = scene === "friend" ? {
+						scene: "friend",
+						peer,
+						subId: {},
+						name: ""
+					} : {
+						scene: "group",
+						peer,
+						subId: {},
+						name: ""
+					};
+					const url = await bot.getFileUrl(contact, String(i.fid));
+					elements.push(segment.file(url, {
+						fid: String(i.fid),
+						name: i.name || "",
+						size: i.size
+					}));
+				} else {
+					elements.push(segment.text(`[文件 ${i.name || ""}]`));
+				}
+				break;
+			}
+			case "long_msg":
+			case "multimsg": {
+				const resId = String(i.resid);
+				rememberResidScene(resId, contactOf(message));
+				elements.push(segment.longMsg(resId));
+				break;
+			}
+			case "poke":
+				elements.push(segment.text(`[戳一戳 ${i.text || ""}]`));
+				break;
+			case "rps":
+				elements.push(segment.text("[猜拳]"));
+				break;
+			case "dice":
+				elements.push(segment.text("[骰子]"));
+				break;
+			case "share":
+				elements.push(segment.text(`[分享 ${i.title || ""}]`));
+				break;
+			case "location":
+				elements.push(segment.text(`[位置 ${i.address || ""}]`));
+				break;
+			case "bface":
+			case "mirai":
+			case "button":
+			case "bubble":
+			case "forum":
+			default: elements.push(segment.text(JSON.stringify(i)));
+		}
+	}
+	return elements;
+}
+/**
+* data: URL 统一转 `base64://` scheme。
+* icqq 的 uri 仅支持 http(s):// file:// base64:// 三种格式
+*/
+const normalizeUri = (uri) => {
+	const match = /^data:[^;,]*;base64,(.+)$/s.exec(uri);
+	return match ? `base64://${match[1]}` : uri;
+};
+async function KarinConvertAdapter$1(data) {
+	const message = [];
+	let source;
+	for (const i of data) {
+		switch (i.type) {
+			case "text":
+				message.push(i.text);
+				break;
+			case "at":
+				if (i.targetId === "all" || String(i.targetId) === "all") {
+					message.push(segment$1.at("all"));
+				} else {
+					message.push(segment$1.at(Number(i.targetId)));
+				}
+				break;
+			case "face":
+				message.push(segment$1.face(i.id));
+				break;
+			case "reply":
+				source = parseQuotable(i.messageId) || source;
+				break;
+			case "image":
+				message.push(segment$1.image(normalizeUri(i.file)));
+				break;
+			case "record":
+				message.push(segment$1.record(normalizeUri(i.file)));
+				break;
+			case "video":
+				message.push(segment$1.video(normalizeUri(i.file)));
+				break;
+			case "file":
+				message.push({
+					type: "file",
+					file: normalizeUri(i.file),
+					name: i.name || ""
+				});
+				break;
+			case "json":
+				message.push(segment$1.json(parseJson(i.data)));
+				break;
+			case "xml":
+				message.push(segment$1.xml(i.data));
+				break;
+			case "markdown":
+				message.push(segment$1.markdown(i.markdown));
+				break;
+			case "marketFace":
+				message.push(segment$1.face(Number(i.id)));
+				break;
+			default: message.push(JSON.stringify(i));
+		}
+	}
+	return {
+		message,
+		source
+	};
+}
+/** icqq 的 json 元素 data 需要对象, Karin 传的是字符串 */
+const parseJson = (data) => {
+	try {
+		return JSON.parse(data);
+	} catch {
+		return data;
+	}
+};
+
+//#endregion
+//#region src/adapters/icqq/event.ts
+/** 消息事件 (client.on('message') 懒加载全部消息) */
+async function dispatchMessage(e, bot) {
+	if (e.message_type === "group") {
+		await handleGroupMessage(e, bot);
+	} else if (e.message_type === "private") {
+		await handlePrivateMessage(e, bot);
+	} else {
+		bot.logger("debug", `[消息] 忽略不支持的消息类型: ${e.message_type}`);
+	}
+}
+/** 群消息 → Karin 群消息事件 */
+async function handleGroupMessage(e, bot) {
+	const contact = contactGroup(String(e.group_id), e.group_name);
+	const s = e.sender;
+	const sender = senderGroup(String(s.user_id), s.role, s.nickname, s.sex, s.age, s.card, undefined, s.level, s.title);
+	const elements = await AdapterConvertKarin$1(e, bot);
+	createGroupMessage({
+		time: e.time,
+		eventId: e.message_id,
+		rawEvent: e,
+		srcReply: (element) => bot.sendMsg(contact, element),
+		bot,
+		messageId: e.message_id,
+		messageSeq: e.seq,
+		elements,
+		contact,
+		sender
+	});
+}
+/** 私聊消息 → Karin 好友消息 / 群临时会话消息 */
+async function handlePrivateMessage(e, bot) {
+	const elements = await AdapterConvertKarin$1(e, bot);
+	if (e.sub_type === "friend") {
+		const contact = contactFriend(String(e.from_id), e.sender.nickname);
+		const sender = senderFriend(String(e.from_id), e.sender.nickname);
+		createFriendMessage({
+			time: e.time,
+			eventId: e.message_id,
+			rawEvent: e,
+			srcReply: (element) => bot.sendMsg(contact, element),
+			bot,
+			messageId: e.message_id,
+			messageSeq: e.seq,
+			elements,
+			contact,
+			sender
+		});
+	} else if (e.sub_type === "group" || e.sub_type === "other") {
+		const groupId = e.sender.group_id;
+		if (!groupId) {
+			bot.logger("debug", `[消息] 临时会话缺少群号, 忽略: ${e.message_id}`);
+			return;
+		}
+		const contact = contactGroupTemp(String(groupId), String(e.from_id));
+		const sender = senderGroupTemp(String(e.from_id));
+		createGroupTempMessage({
+			time: e.time,
+			eventId: e.message_id,
+			rawEvent: e,
+			srcReply: (element) => bot.sendMsg(contact, element),
+			bot,
+			messageId: e.message_id,
+			messageSeq: e.seq,
+			elements,
+			contact,
+			sender
+		});
+	}
+}
+/** 通知事件 (client.on('notice')) */
+async function dispatchNotice(e, bot) {
+	const time = Date.now();
+	if (e.notice_type === "friend") {
+		switch (e.sub_type) {
+			case "recall": {
+				const ev = e;
+				const userId = String(ev.user_id);
+				const contact = contactFriend(userId);
+				createPrivateRecallNotice({
+					time: Date.now(),
+					eventId: `notice:${ev.message_id}`,
+					rawEvent: e,
+					contact,
+					sender: senderFriend(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					bot,
+					content: {
+						operatorId: String(ev.operator_id),
+						messageId: ev.message_id || "",
+						tips: ""
+					}
+				});
+				break;
+			}
+			case "poke": {
+				const ev = e;
+				const userId = String(ev.operator_id);
+				const contact = contactFriend(userId);
+				createPrivatePokeNotice({
+					time,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					bot,
+					contact,
+					sender: senderFriend(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						operatorId: userId,
+						targetId: String(ev.target_id),
+						action: ev.action,
+						actionImage: "",
+						suffix: ev.suffix
+					}
+				});
+				break;
+			}
+			case "increase":
+				bot.logger("info", `[通知] 新增好友: ${e.user_id} (${e.nickname})`);
+				break;
+			case "decrease":
+				bot.logger("info", `[通知] 好友减少: ${e.user_id} (${e.nickname})`);
+				break;
+			default: bot.logger("debug", `[通知] 未知好友通知: ${JSON.stringify(e)}`);
+		}
+		return;
+	}
+	if (e.notice_type === "group") {
+		const contact = contactGroup(String(e.group_id), e.group?.name);
+		switch (e.sub_type) {
+			case "increase": {
+				const ev = e;
+				const userId = String(ev.user_id);
+				createGroupMemberAddNotice({
+					bot,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					time,
+					contact,
+					sender: senderGroup(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						operatorId: String(ev.user_id),
+						targetId: userId,
+						type: "approve"
+					}
+				});
+				break;
+			}
+			case "decrease": {
+				const ev = e;
+				const userId = String(ev.user_id);
+				const operatorId = String(ev.operator_id);
+				createGroupMemberDelNotice({
+					bot,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					time,
+					contact,
+					sender: senderGroup(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						operatorId,
+						targetId: userId,
+						type: operatorId === userId ? "leave" : ev.dismiss ? "kickBot" : "kick"
+					}
+				});
+				break;
+			}
+			case "recall": {
+				const ev = e;
+				createGroupRecallNotice({
+					time: Date.now(),
+					eventId: `notice:${ev.message_id}`,
+					rawEvent: e,
+					contact,
+					sender: senderGroup(String(ev.operator_id)),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					bot,
+					content: {
+						operatorId: String(ev.operator_id),
+						messageId: ev.message_id || "",
+						targetId: String(ev.user_id),
+						tip: ""
+					}
+				});
+				break;
+			}
+			case "admin": {
+				const ev = e;
+				createGroupAdminChangedNotice({
+					bot,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					time,
+					contact,
+					sender: senderGroup(String(ev.user_id)),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						targetId: String(ev.user_id),
+						isAdmin: ev.set
+					}
+				});
+				break;
+			}
+			case "ban": {
+				const ev = e;
+				const userId = String(ev.user_id);
+				createGroupMemberBanNotice({
+					bot,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					time,
+					contact,
+					sender: senderGroup(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						operatorId: String(ev.operator_id),
+						targetId: userId,
+						duration: ev.duration,
+						isBan: ev.duration > 0
+					}
+				});
+				break;
+			}
+			case "poke": {
+				const ev = e;
+				const userId = String(ev.operator_id);
+				createGroupPokeNotice({
+					time,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					bot,
+					contact,
+					sender: senderGroup(userId),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						operatorId: userId,
+						targetId: String(ev.target_id),
+						action: ev.action,
+						actionImage: "",
+						suffix: ev.suffix
+					}
+				});
+				break;
+			}
+			case "reaction": {
+				const ev = e;
+				createGroupMessageReactionNotice({
+					bot,
+					eventId: `notice:${time}`,
+					rawEvent: e,
+					time,
+					contact,
+					sender: senderGroup(String(ev.user_id)),
+					srcReply: (element) => bot.sendMsg(contact, element),
+					content: {
+						count: 1,
+						faceId: Number(ev.id),
+						isSet: ev.set,
+						messageId: bot.encodeQuoteMsgId(String(ev.group_id), ev.seq)
+					}
+				});
+				break;
+			}
+			case "sign": {
+				const ev = e;
+				bot.logger("info", `[通知] 群签到: ${ev.nickname} (${ev.sign_text})`);
+				break;
+			}
+			case "transfer": {
+				const ev = e;
+				bot.logger("info", `[通知] 群转让: ${ev.operator_id} → ${ev.user_id}`);
+				break;
+			}
+			default: bot.logger("debug", `[通知] 未知群通知: ${JSON.stringify(e)}`);
+		}
+		return;
+	}
+	bot.logger("debug", `[通知] 未知通知: ${JSON.stringify(e)}`);
+}
+/** 申请事件 (client.on('request')) */
+async function dispatchRequest(e, bot) {
+	const time = Date.now();
+	if (e.request_type === "friend") {
+		const ev = e;
+		const userId = String(ev.user_id);
+		const contact = contactFriend(userId);
+		createPrivateApplyRequest({
+			bot,
+			time,
+			contact,
+			rawEvent: e,
+			subEvent: "friendApply",
+			eventId: `request:${ev.flag}`,
+			sender: senderFriend(userId, ev.nickname),
+			srcReply: (element) => bot.sendMsg(contact, element),
+			content: {
+				applierId: userId,
+				message: ev.comment,
+				flag: ev.flag
+			}
+		});
+		return;
+	}
+	if (e.request_type === "group") {
+		const contact = contactGroup(String(e.group_id), e.group_name);
+		if (e.sub_type === "invite") {
+			const ev = e;
+			const inviterId = String(ev.user_id);
+			createGroupInviteRequest({
+				bot,
+				time,
+				contact,
+				rawEvent: e,
+				subEvent: "groupInvite",
+				eventId: `request:${ev.flag}`,
+				sender: senderGroup(inviterId, ev.role),
+				srcReply: (element) => bot.sendMsg(contact, element),
+				content: {
+					inviterId,
+					flag: ev.flag
+				}
+			});
+		} else {
+			const ev = e;
+			const applierId = String(ev.user_id);
+			createGroupApplyRequest({
+				bot,
+				time,
+				contact,
+				rawEvent: e,
+				subEvent: "groupApply",
+				eventId: `request:${ev.flag}`,
+				sender: senderGroup(applierId, "unknown", ev.nickname),
+				srcReply: (element) => bot.sendMsg(contact, element),
+				content: {
+					applierId,
+					inviterId: ev.inviter_id ? String(ev.inviter_id) : "",
+					reason: ev.comment,
+					flag: ev.flag,
+					groupId: String(ev.group_id)
+				}
+			});
+		}
+		return;
+	}
+	bot.logger("debug", `[申请] 未知申请: ${JSON.stringify(e)}`);
+}
+
+//#endregion
+//#region src/adapters/icqq/index.ts
+/**
+* icqq 协议适配器: 库直连 QQ(安卓/iPad/Watch等) 协议,
+* 支持 fast(快速登录) / password(密码登录) / qrcode(扫码登录, 需 Watch 平台)。
+* 断线由 icqq 内置 reconn_interval 自动重连, 无需适配器自行处理。
+*/
+var IcqqBot = class extends BaseBot {
+	/** icqq 客户端 */
+	super;
+	/** 兼容 BaseBot.stop 的 raw (覆写 stop, 不调用其 close) */
+	raw;
+	/** 是否已绑定事件 (重连时幂等) */
+	#eventsBound = false;
+	/** 是否已主动停止 (停止后不再自动重连) */
+	#stopped = false;
+	/** 连接起始时间 */
+	#startTime = 0;
+	/** 连接时长计时器 */
+	#connectTimeTimer = null;
+	/** 登录等待 Promise 的 resolver */
+	#loginResolve = null;
+	#loginReject = null;
+	/** 登录结果 (start 中等待) */
+	#loginDone = Promise.resolve();
+	/** 是否已上线 (用于区分登录期错误与会话期异常) */
+	#online = false;
+	/** 滑块已触发 (多通道只跑一轮) */
+	#sliderDone = false;
+	/** 滑块 ticket 已提交 (多通道互斥) */
+	#sliderSubmitted = false;
+	/** 登录超时计时器 (滑块/设备/登录验证环节会重置) */
+	#loginTimer = null;
+	/** 被踢下线后的延迟重连计时器 */
+	#loginRetryTimer = null;
+	/** 最近一次签名服务报错详情 (internal.verbose 暂存, 由登录错误统一打印, 避免日志多行) */
+	#lastQsignError = "";
+	/** icqq 数据目录: 统一存放在 Karin 数据根 `@karinjs/data/icqq` (不可配置) */
+	get #dataDir() {
+		return path.join(karinPathData, "icqq");
+	}
+	constructor(cfg) {
+		super(cfg);
+		const clientConfig = {
+			data_dir: this.#dataDir,
+			log_level: "off",
+			ignore_self: true,
+			reconn_interval: 5
+		};
+		if (cfg.platform) clientConfig.platform = cfg.platform;
+		if (cfg.ver) clientConfig.ver = cfg.ver;
+		if (cfg.sign_api_addr) clientConfig.sign_api_addr = cfg.sign_api_addr;
+		this.super = createClient(clientConfig);
+		this.raw = this.super;
+		this.adapter.name = "ICQQ";
+		this.adapter.version = icqqPkg.version;
+		this.adapter.platform = "qq";
+		this.adapter.standard = "icqq";
+		this.adapter.protocol = "icqq";
+		this.adapter.communication = "webSocketClient";
+	}
+	/** 幂等的 for setGroupQQ 登录等待用 */
+	__registerBot() {
+		this.register();
+	}
+	/** 断开时注销 Bot */
+	__unregisterBot() {
+		this.unregister();
+	}
+	/** 打印当前 Bot 专属日志 */
+	logger(level, ...args) {
+		logger.bot(level, this.account.selfId, ...args);
+	}
+	/** 上报登录验证事件到 WebUI (SSE 推送到网页面板) */
+	#emit(type, title, extra = {}) {
+		const uin = String(this.cfg.uin ?? this.super?.uin ?? "");
+		emitLoginEvent(uin, {
+			type,
+			title,
+			...extra
+		});
+	}
+	/** 直通 icqq API */
+	async sendApi(action, params) {
+		const method = this.super[action];
+		if (typeof method === "function") return method.apply(this.super, Array.isArray(params) ? params : [params]);
+		throw new Error(`icqq 客户端无该方法: ${action}`);
+	}
+	/**
+	* 设备锁/登录验证完成后的手动续登 (供 server HTTP 端点调用):
+	* icqq 的设备锁(system.login.device)没有自动回调, 用户在网页/手机QQ完成验证后
+	* 必须重新调用 login() 让服务端重新校验设备, 验证通过则直接上线。
+	*/
+	async continueLogin() {
+		return this.#relogin();
+	}
+	/** 生成群引用消息 id (reaction 等缺少 rand 的场景) */
+	encodeQuoteMsgId(groupId, seq) {
+		return genGroupMessageId(Number(groupId), 0, seq, 0, Math.floor(Date.now() / 1e3), 0);
+	}
+	/** 解析消息对象 → Karin MessageResponse */
+	async #toMessageResponse(m) {
+		const msg = m;
+		const userId = String(msg.sender?.user_id ?? msg.from_id ?? m.user_id);
+		const nickname = String(msg.sender?.nickname ?? msg.nickname ?? "");
+		const isGroup = msg.message_type === "group";
+		const contact = isGroup ? {
+			scene: "group",
+			peer: String(msg.group_id),
+			name: msg.group_name,
+			subId: {}
+		} : {
+			scene: "friend",
+			peer: String(msg.from_id ?? m.user_id),
+			name: "",
+			subId: {}
+		};
+		const sender = {
+			role: msg.sender?.role ?? "unknown",
+			userId,
+			nick: nickname,
+			name: nickname,
+			card: msg.sender?.card,
+			level: msg.sender?.level,
+			title: msg.sender?.title,
+			sex: msg.sender?.sex
+		};
+		return {
+			time: m.time,
+			messageId: msg.message_id || `${m.seq}-${msg.rand ?? 0}`,
+			messageSeq: m.seq,
+			contact,
+			sender,
+			elements: await AdapterConvertKarin$1(m, this)
+		};
+	}
+	/** 绑定客户端事件 (幂等) */
+	#bindEvents() {
+		if (this.#eventsBound) return;
+		this.#eventsBound = true;
+		const client = this.super;
+		client.on("internal.verbose", (msg, level) => {
+			if (Number(level) !== 2) return;
+			const s = String(msg ?? "");
+			if (/\[qsign\]/.test(s) || /签名api异常/.test(s)) {
+				this.#lastQsignError = s;
+			} else {
+				this.logger("error", `[icqq] ${s}`);
+			}
+		});
+		client.on("message", (e) => {
+			dispatchMessage(e, this).catch((err) => this.logger("error", `消息处理错误: ${err.message}`));
+		});
+		client.on("notice", (e) => {
+			dispatchNotice(e, this).catch((err) => this.logger("error", `通知处理错误: ${err.message}`));
+		});
+		client.on("request", (e) => {
+			dispatchRequest(e, this).catch((err) => this.logger("error", `申请处理错误: ${err.message}`));
+		});
+		client.on("system.online", () => this.#onOnline());
+		client.on("system.offline", () => this.#onOffline());
+		client.on("system.offline.kickoff", (e) => {
+			this.#online = false;
+			this.logger("warn", `[登出] 被服务器踢下线: ${e?.message || ""}`);
+			this.__unregisterBot();
+			this.#scheduleRelogin();
+		});
+		client.on("system.login.qrcode", (e) => this.#onQrcode(e.image));
+		client.on("system.login.slider", (e) => {
+			this.#resetLoginTimeout();
+			this.#onSlider(e?.url);
+		});
+		client.on("system.login.device", (e) => {
+			this.#resetLoginTimeout();
+			const nt = Boolean(this.super?.useNTLogin);
+			const phone = nt ? "" : e?.phone ? String(e?.phone) : "";
+			this.#emit("device", "需要设备锁验证", {
+				message: nt ? "NT 协议设备锁验证, 请在浏览器打开链接完成, 完成后点击「我已验证, 继续登录」" : phone ? `手机号: ${phone}` : "请在浏览器打开链接完成新设备验证, 完成后点击「我已验证, 继续登录」",
+				url: e?.url,
+				phone
+			});
+			this.logger("warn", `[登录] 需要设备锁验证: ${e?.url}${nt ? " (NT 协议, 仅网页验证, 完成后需手动重新登录)" : phone ? ` (手机号: ${phone})` : " (无可用手机号, 需网页验证, 完成后需手动重新登录)"}`);
+			if (!nt && phone) this.logger("warn", `[登录] 可调用 sendApi('sendSmsCode') 发送短信后 sendApi('submitSmsCode', ['验证码']) 继续`);
+		});
+		client.on("system.login.auth", (e) => this.#onAuth(e));
+		client.on("system.login.error", (e) => {
+			this.#emit("failed", "登录失败", { message: `${e?.message ?? e?.code}` });
+			this.logger("error", `[登录] 登录失败: ${e?.message ?? e?.code}`);
+			if (this.#online) {
+				this.logger("warn", `[登录] 已在线, 忽略该登录错误 (等待 icqq 自动重连)`);
+				return;
+			}
+			this.#loginReject?.(new Error(`登录失败: ${e?.message ?? e?.code}`));
+		});
+	}
+	/** 上线: 刷新账号信息 + 注册 + 开启连接计时 */
+	#onOnline() {
+		const uin = String(this.super.uin || this.cfg.uin || "");
+		this.#online = true;
+		this.account = {
+			uin,
+			uid: uin,
+			selfId: uin,
+			name: this.super.nickname || uin,
+			avatar: `https://q1.qlogo.cn/g?b=qq&s=0&nk=${uin}`,
+			subId: {}
+		};
+		this.#startTime = Date.now();
+		if (this.#connectTimeTimer) clearInterval(this.#connectTimeTimer);
+		this.#connectTimeTimer = setInterval(() => {
+			this.adapter.connectTime = Date.now() - this.#startTime;
+		}, 1e3);
+		this.__registerBot();
+		this.#emit("online", "登录成功", { message: this.super.nickname || uin });
+		this.logger("info", `登录成功: ${uin}`);
+		this.#loginResolve?.();
+		this.#loginResolve = null;
+	}
+	/** 掉线: 注销 + 停连接计时 (自动重连由 icqq 内部处理) */
+	#onOffline() {
+		this.#online = false;
+		this.__unregisterBot();
+		this.#emit("offline", "连接已断开");
+		if (this.#connectTimeTimer) {
+			clearInterval(this.#connectTimeTimer);
+			this.#connectTimeTimer = null;
+		}
+		if (!this.#stopped) {
+			this.logger("warn", "[连接] 已掉线, icqq 将自动重连");
+		}
+	}
+	/** 收到登录二维码: 写到本地文件方便扫码 */
+	#onQrcode(image) {
+		const dirPath = this.#dataDir;
+		const file = path.join(dirPath, `icqq-qrcode.png`);
+		try {
+			fs.mkdirSync(dirPath, { recursive: true });
+			fs.writeFileSync(file, image);
+			this.logger("warn", `[登录] 请用手机QQ扫码登录, 二维码已保存: ${file}`);
+		} catch (err) {
+			this.logger("error", `[登录] 二维码保存失败: ${err.message}`);
+		}
+	}
+	/**
+	* 需要滑动验证: 按配置选择验证方式 (参考 TRSS Yunzai-ICQQ-Plugin 的半自动化方案)
+	*  - auto: 全通道并行, 任一通道拿到 ticket 即提交
+	*  - gt / txhelper / manual: 只走指定通道
+	*/
+	#onSlider(url) {
+		if (this.#sliderDone) return;
+		this.#sliderDone = true;
+		const c = this.super;
+		if (c.useNTLogin) {
+			this.#emit("progress", "正在准备滑动验证...");
+			this.logger("warn", `[登录] NT 协议滑动验证: ${url}`);
+			this.#sliderViaCapNT(url);
+			return;
+		}
+		const mode = this.cfg.sliderMode || "gt";
+		this.#emit("slider", `需要滑动验证 (方式: ${mode})`, { url });
+		this.logger("warn", `[登录] 需要滑动验证 (方式: ${mode}): ${url}`);
+		switch (mode) {
+			case "txhelper":
+				this.#sliderViaTxHelper(url);
+				return;
+			case "manual":
+				this.#sliderViaTicketFile();
+				return;
+			default: this.#sliderViaGT(url);
+		}
+	}
+	/**
+	* NT 协议滑动验证专用通道 (对齐 TRSS Yunzai-ICQQ-Plugin):
+	* 先检测候选渲染域名可达性 (captcha.928100.xyz 现役 / CapNT.928100.xyz 旧域名),
+	* 用首个可达域名渲染腾讯下发的 NT 验证链接完成滑动,
+	* 客户端双端点轮询 ticket + randstr 后提交.
+	* 注: 渲染站当前把 ticket 提交到 captcha-api-cf.928100.xyz (Cloudflare 后端),
+	* captcha-nt-api.928100.xyz (EdgeOne 后端) 为旧渲染站使用, 两片数据不互通, 故全部轮询.
+	*/
+	async #sliderViaCapNT(url) {
+		const uin = String(this.cfg.uin ?? "");
+		const gf = globalThis.fetch;
+		if (typeof gf !== "function") {
+			this.logger("warn", `[登录] 请打开链接完成滑动验证: ${url}`);
+			return;
+		}
+		const apiBases = ["https://captcha-api-cf.928100.xyz", "https://captcha-nt-api.928100.xyz"];
+		const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+		const getTicket = async () => {
+			for (const base of apiBases) {
+				try {
+					const res = await (await gf(`${base}/?key=${uin}`)).json();
+					if (res && typeof res === "object") return res;
+				} catch {}
+			}
+			return null;
+		};
+		try {
+			for (let i = 0; i < 20; i++) {
+				const res = await getTicket();
+				if (res?.status === "0" || res?.ticket) break;
+				await sleep(3e3);
+			}
+			const pickRenderBase = async () => {
+				const hosts = ["https://captcha.928100.xyz", "https://CapNT.928100.xyz"];
+				for (const base of hosts) {
+					try {
+						const ctrl = new AbortController();
+						const timer = setTimeout(() => ctrl.abort(), 5e3);
+						try {
+							const r = await gf(base, {
+								method: "GET",
+								redirect: "follow",
+								signal: ctrl.signal
+							});
+							if (r && typeof r.status === "number" && r.status >= 200 && r.status < 500) return base;
+						} finally {
+							clearTimeout(timer);
+						}
+					} catch {}
+				}
+				return null;
+			};
+			let capUrl = url;
+			try {
+				const base = await pickRenderBase();
+				const query = new URL(url).searchParams.toString();
+				capUrl = base ? `${base}?${query}` : url;
+				if (!base) this.logger("warn", "[登录] CapNT 渲染服务均不可达, 直接使用腾讯下发原链接");
+			} catch {}
+			this.#emit("slider", "需要滑动验证 (NT 协议)", {
+				message: "请点击打开链接，在新窗口完成滑动",
+				url: capUrl
+			});
+			this.logger("warn", `[登录] 请打开链接完成滑动验证: ${capUrl}`);
+			let ticket = null;
+			for (let i = 0; i < 60; i++) {
+				await sleep(3e3);
+				const res = await getTicket();
+				if (res?.ticket) {
+					ticket = res.randstr ? `${res.ticket},${res.randstr}` : res.ticket;
+					break;
+				}
+			}
+			if (ticket) await this.#submitSlider(ticket);
+			else {
+				this.#emit("timeout", "滑动验证超时", { message: "点击「重新上线」可再次尝试" });
+				this.logger("warn", "[登录] 滑动验证超时, 可重新上线再试");
+			}
+		} catch (err) {
+			this.#emit("failed", "滑动验证失败", { message: err?.message ?? err });
+			this.logger("error", `[登录] NT 滑动验证失败: ${err?.message ?? err}`);
+		}
+	}
+	/** 通道2: 网页反代(WS) — 浏览器页面内的验证码请求经 GT 服务转发到本端代发, 兼容新式验证链接 */
+	async #sliderViaGTProxy(api, sliderUrl) {
+		let ws;
+		try {
+			const mod = await import("ws");
+			ws = new mod.WebSocket(api);
+		} catch {
+			return false;
+		}
+		const opened = await new Promise((resolve) => {
+			const timer = setTimeout(() => {
+				try {
+					ws?.terminate?.();
+				} catch {}
+				resolve(false);
+			}, 1e4);
+			ws.on("open", () => {
+				clearTimeout(timer);
+				resolve(true);
+			});
+			ws.on("error", () => {
+				clearTimeout(timer);
+				resolve(false);
+			});
+			ws.on("close", () => {
+				clearTimeout(timer);
+				resolve(false);
+			});
+		});
+		if (!opened) return false;
+		this.logger("warn", `[登录] 请打开完成滑动: ${api}`);
+		this.#emit("slider", "需要滑动验证 (GT 网页反代)", {
+			message: "请点击打开链接，在新窗口完成滑动",
+			url: api
+		});
+		ws.send(JSON.stringify({
+			type: "register",
+			payload: { url: sliderUrl }
+		}));
+		return await new Promise((resolve) => {
+			let done = false;
+			const timeout = setTimeout(() => close(), 18e4);
+			const close = (ok = false) => {
+				if (done) return;
+				done = true;
+				clearTimeout(timeout);
+				try {
+					ws.terminate?.();
+				} catch {}
+				resolve(ok);
+			};
+			ws.on("message", async (raw) => {
+				let data;
+				try {
+					data = JSON.parse(raw.toString());
+				} catch {
+					return;
+				}
+				switch (data?.type) {
+					case "ticket": {
+						const ticket = data.payload?.ticket;
+						if (ticket) {
+							this.logger("info", "[登录] 已获取ticket");
+							await this.#submitSlider(ticket);
+							close(true);
+						}
+						break;
+					}
+					case "handle": {
+						const { url: hUrl, ...opts } = data.payload ?? {};
+						const gf = globalThis.fetch;
+						if (!hUrl || typeof gf !== "function") break;
+						try {
+							const req = await gf(hUrl, opts);
+							data.payload = {
+								result: Buffer.from(await req.arrayBuffer()).toString("base64"),
+								headers: Object.fromEntries(req.headers.entries?.() ?? [])
+							};
+							ws.send(JSON.stringify(data));
+						} catch {}
+						break;
+					}
+					default: break;
+				}
+			});
+			ws.on("close", () => close());
+			ws.on("error", () => close());
+		});
+	}
+	/** 通道2: GT 网页验证 — 注册滑块链接, 浏览器访问服务端页面完成滑动, 轮询获取 ticket */
+	async #sliderViaGT(url) {
+		const gf = globalThis.fetch;
+		if (typeof gf !== "function") return;
+		const uin = String(this.cfg.uin ?? "");
+		const api = `https://GT.928100.xyz/captcha/slider?key=${uin}`;
+		if (await this.#sliderViaGTProxy(api, url)) return;
+		try {
+			await gf(api, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ url })
+			});
+		} catch {
+			return;
+		}
+		this.logger("warn", `[登录] 请打开完成滑动: ${api}`);
+		this.#emit("slider", "需要滑动验证 (GT 网页)", {
+			message: "请点击打开链接，在新窗口完成滑动",
+			url: api
+		});
+		for (let i = 0; i < 60; i++) {
+			await new Promise((r) => setTimeout(r, 3e3));
+			try {
+				const res = await (await gf(api, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({ submit: uin })
+				})).json();
+				const body = res?.data && typeof res.data === "object" ? res.data : res;
+				if (body?.ticket) {
+					const ticket = body.randstr ? `${body.ticket},${body.randstr}` : body.ticket;
+					this.logger("info", "[登录] 已获取ticket");
+					return this.#submitSlider(ticket);
+				}
+			} catch {}
+		}
+	}
+	/** 通道1: txhelper 请求码 — 浏览器输入请求码完成滑动, 轮询原链接获取 ticket */
+	async #sliderViaTxHelper(url) {
+		const gf = globalThis.fetch;
+		if (typeof gf !== "function") return;
+		const helpUrl = url.replace("ssl.captcha.qq.com", "txhelper.glitch.me");
+		try {
+			const code = (await (await gf(helpUrl)).text()).trim();
+			if (!code || /^https?:/i.test(code) || code.length > 32) return;
+			this.logger("warn", `[登录] 请在 txhelper.glitch.me 输入请求码: ${code}`);
+			this.#emit("slider", "需要滑动验证 (txhelper)", {
+				message: `请在 txhelper.glitch.me 输入请求码: ${code}`,
+				url: helpUrl
+			});
+			for (let i = 0; i < 60; i++) {
+				await new Promise((r) => setTimeout(r, 3e3));
+				const res = (await (await gf(helpUrl)).text()).trim();
+				if (res && res !== code) return this.#submitSlider(res);
+			}
+		} catch {}
+	}
+	/** 通道3: 手动兜底 — 轮询等待 ticket 文件 (用户完成验证后将 ticket,randstr 写入) */
+	async #sliderViaTicketFile() {
+		const dirPath = this.#dataDir;
+		const file = path.join(dirPath, "slider.ticket");
+		this.logger("warn", `[登录] 完成后将 ticket 写入: ${file}`);
+		this.#emit("slider", "需要滑动验证 (手动)", { message: `验证完成后将 ticket,randstr 写入: ${file}` });
+		for (let i = 0; i < 100; i++) {
+			await new Promise((r) => setTimeout(r, 2e3));
+			try {
+				if (!fs.existsSync(file)) continue;
+				const ticket = fs.readFileSync(file, "utf-8").trim();
+				if (!ticket) continue;
+				fs.rmSync(file, { force: true });
+				return this.#submitSlider(ticket);
+			} catch {}
+		}
+	}
+	/** 重置登录超时计时 (滑块/设备/登录验证环节等待较久时调用, 避免被超时打断) */
+	#resetLoginTimeout(ms = 6e5) {
+		if (this.#loginTimer) clearTimeout(this.#loginTimer);
+		this.#loginTimer = setTimeout(() => {
+			this.#loginTimer = null;
+			if (this.#loginResolve) {
+				this.#loginResolve = null;
+				this.#loginReject?.(new Error("登录超时"));
+			}
+		}, ms).unref?.();
+	}
+	/**
+	* 被踢下线/登录失效后延迟手动重连 (icqq 的 kickoff 不会自动重连):
+	* 延迟避免刚被踢就立刻撞上服务器风控; 重新 login 由 icqq 内部走 token → 密码降级,
+	* 若再次触发设备锁/滑块验证会由对应事件处理并推送到 WebUI 继续引导。
+	*/
+	#scheduleRelogin(delayMs = 5e3) {
+		if (this.#stopped) return;
+		if (this.#loginRetryTimer) clearTimeout(this.#loginRetryTimer);
+		this.#loginRetryTimer = setTimeout(() => {
+			this.#loginRetryTimer = null;
+			const c = this.super;
+			if (typeof c.login !== "function" || c.isOnline()) return;
+			const uin = this.cfg.uin !== undefined && this.cfg.uin !== "" ? Number(this.cfg.uin) : undefined;
+			this.logger("warn", `[登录] 被踢下线, ${delayMs / 1e3}秒后尝试重新登录...`);
+			const p = this.cfg.password ? c.login(uin, this.cfg.password) : c.login(uin);
+			if (p?.catch) p.catch((err) => this.logger("error", `[登录] 重新登录失败: ${err?.message ?? err}`));
+		}, delayMs).unref?.();
+	}
+	/** system.login.auth — 设备/登录验证自动化 (流程同 TRSS: 928100.xyz 验证服务) */
+	async #onAuth(e) {
+		this.#resetLoginTimeout();
+		const uin = String(this.cfg.uin ?? "");
+		const gf = globalThis.fetch;
+		if (typeof gf !== "function") {
+			this.logger("warn", `[登录] 需要登录验证: ${e?.url}`);
+			return;
+		}
+		const api = (path) => `https://captcha-api.928100.xyz/${path}?uin=${uin}`;
+		const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+		const authUrl = `https://Auth.928100.xyz?uin=${uin}`;
+		this.#emit("auth", "需要登录验证", {
+			message: "请点击打开链接，在新窗口完成验证",
+			url: authUrl
+		});
+		this.logger("warn", `[登录] 请打开链接完成登录验证: ${authUrl}`);
+		const checkStatus = async () => {
+			for (let i = 0; i < 60; i++) {
+				try {
+					const res = await (await gf(api("get-verify-status"))).json();
+					if (res?.status === 1) return true;
+					if (res?.status !== 0) this.logger("warn", `[登录] 验证错误: ${JSON.stringify(res)}`);
+				} catch (err) {
+					this.logger("error", `[登录] 验证请求错误: ${err?.message ?? err}`);
+				}
+				await sleep(5e3);
+			}
+			return false;
+		};
+		try {
+			const res = await (await gf(api("query-bound-phone"))).json();
+			if (res?.retcode === 0) {
+				this.logger("info", "[登录] 存在设备缓存, 正在验证...");
+				if (await checkStatus()) return this.#relogin();
+				return this.#authFail();
+			}
+		} catch (err) {
+			this.logger("warn", `[登录] 查询设备缓存失败: ${err?.message ?? err}`);
+		}
+		let ticket;
+		for (let i = 0; i < 60; i++) {
+			try {
+				const res = await (await gf(api("get-ticket"))).json();
+				if (res?.status === 0 && res.data?.ticket && res.data?.randstr) {
+					ticket = res.data;
+					break;
+				}
+				if (res?.status !== 1) this.logger("warn", `[登录] ticket 错误: ${JSON.stringify(res)}`);
+			} catch (err) {
+				this.logger("error", `[登录] ticket 请求错误: ${err?.message ?? err}`);
+			}
+			await sleep(5e3);
+		}
+		if (!ticket) return this.#authFail("ticket 验证超时");
+		const sig = decodeURIComponent(String(e?.url ?? "")).match(/sig=([^&]+)/)?.[1];
+		const payload = {
+			version: this.super.apk?.ver,
+			sig,
+			ticket: ticket.ticket,
+			randstr: ticket.randstr,
+			guid: e?.device?.guid,
+			qimei: e?.device?.qimei,
+			appid: e?.device?.subappid
+		};
+		this.logger("info", "[登录] 上传设备信息");
+		for (let i = 0; i < 5; i++) {
+			try {
+				const res = await (await gf(api("upload-qqInfo"), {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(payload)
+				})).json();
+				if (res?.status === 0) {
+					this.#emit("progress", "设备信息上传成功", { message: "正在等待验证结果..." });
+					this.logger("info", "[登录] 设备信息上传成功, 正在验证...");
+					if (await checkStatus()) return this.#relogin();
+					return this.#authFail();
+				}
+				this.logger("warn", `[登录] 设备信息错误: ${JSON.stringify(res)}`);
+			} catch (err) {
+				this.logger("error", `[登录] 设备信息上传错误: ${err?.message ?? err}`);
+			}
+			await sleep(5e3);
+		}
+		return this.#authFail("设备信息上传超时");
+	}
+	/** 登录验证通过后重新登录 */
+	async #relogin() {
+		const uin = this.cfg.uin !== undefined && this.cfg.uin !== "" ? Number(this.cfg.uin) : undefined;
+		this.#emit("relogin", "验证已通过", { message: "正在重新登录..." });
+		try {
+			await this.super.login(uin, this.cfg.password);
+			this.logger("info", "[登录] 验证已通过, 重新登录中...");
+		} catch (err) {
+			this.logger("warn", `[登录] 重新登录失败: ${err?.message ?? err}`);
+		}
+	}
+	/** 登录验证流程失败 */
+	#authFail(reason = "登录验证超时") {
+		this.#emit("failed", "登录验证失败", { message: reason });
+		this.logger("warn", `[登录] ${reason}`);
+		this.#loginReject?.(new Error(reason));
+	}
+	/** 提交滑块 ticket (多通道互斥, 成功后其余通道自动放弃) */
+	async #submitSlider(ticket) {
+		if (this.#sliderSubmitted) return;
+		this.#sliderSubmitted = true;
+		try {
+			await this.super.submitSlider(ticket);
+			this.#emit("submit", "滑动验证已通过", { message: "正在继续登录..." });
+			this.logger("info", "[登录] 已提交滑动验证, 正在继续登录...");
+		} catch (err) {
+			this.#sliderSubmitted = false;
+			this.logger("error", `[登录] 滑动验证提交失败: ${err?.message ?? err}`);
+			this.#loginReject?.(new Error(`滑动验证提交失败: ${err?.message ?? err}`));
+		}
+	}
+	/** 启动: 绑定事件 + 登录 */
+	async start() {
+		if (this.#stopped) this.#stopped = false;
+		this.#bindEvents();
+		if (this.super.isOnline()) {
+			this.#onOnline();
+			return;
+		}
+		const uin = this.cfg.uin !== undefined && this.cfg.uin !== "" ? Number(this.cfg.uin) : undefined;
+		const password = this.cfg.password;
+		const loginType = this.cfg.loginType || (password ? "password" : uin ? "fast" : "qrcode");
+		this.#loginDone = new Promise((resolve, reject) => {
+			this.#loginResolve = resolve;
+			this.#loginReject = reject;
+			this.#resetLoginTimeout();
+		});
+		try {
+			this.#lastQsignError = "";
+			const loginTask = (async () => {
+				if (loginType === "password") {
+					if (!uin || !password) throw new Error("密码登录需要配置 uin 和 password");
+					await this.super.login(uin, password);
+				} else if (loginType === "fast") {
+					if (!uin) throw new Error("快速登录需要配置 uin");
+					await this.super.login(uin);
+				} else {
+					if (this.cfg.platform && this.cfg.platform !== 3) {
+						this.logger("warn", "[登录] 扫码登录建议使用 Watch 平台 (platform=3)");
+					}
+					await this.super.login();
+				}
+			})();
+			this.logger("info", `[登录] 正在登录 ${uin ?? "(扫码)"} (${loginType})...`);
+			const hangGuard = new Promise((_, reject) => {
+				const timer = setTimeout(() => reject(new Error("登录请求无响应超时")), 6e4);
+				timer.unref?.();
+			});
+			await Promise.race([loginTask, hangGuard]);
+		} catch (err) {
+			if (err?.code === -90 || /签名api/.test(String(err?.message ?? ""))) {
+				const detail = err?.stack ?? (err && typeof err === "object" ? JSON.stringify(err) : String(err ?? ""));
+				const qsign = this.#lastQsignError ? ` | ${this.#lastQsignError}` : "";
+				this.logger("error", `[登录] 签名api异常: ${detail}${qsign}`);
+			}
+			if (this.#loginTimer) {
+				clearTimeout(this.#loginTimer);
+				this.#loginTimer = null;
+			}
+			throw err;
+		}
+		await this.#loginDone;
+	}
+	/** 停止: 登出并注销 (热更新/停用时调用) */
+	async stop() {
+		this.#stopped = true;
+		if (this.#loginRetryTimer) {
+			clearTimeout(this.#loginRetryTimer);
+			this.#loginRetryTimer = null;
+		}
+		this.unregister();
+		clearLoginState(String(this.cfg.uin ?? this.super?.uin ?? ""));
+		if (this.#connectTimeTimer) {
+			clearInterval(this.#connectTimeTimer);
+			this.#connectTimeTimer = null;
+		}
+		try {
+			await this.super.logout();
+		} catch {}
+	}
+	async sendMsg(contact, elements) {
+		const result = {
+			messageId: "",
+			time: 0,
+			rawData: {},
+			message_id: "",
+			messageTime: 0
+		};
+		const { message, source } = await KarinConvertAdapter$1(elements);
+		let ret;
+		if (contact.scene === "group") {
+			ret = await this.super.sendGroupMsg(Number(contact.peer), message, source);
+		} else if (contact.scene === "friend") {
+			ret = await this.super.sendPrivateMsg(Number(contact.peer), message, source);
+		} else if (contact.scene === "groupTemp") {
+			ret = await this.super.sendPrivateMsg(Number(contact.peer), message, source);
+		} else {
+			throw new Error(`不支持的场景: ${contact.scene}`);
+		}
+		result.messageId = ret.message_id;
+		result.time = ret.time;
+		result.rawData = ret;
+		result.message_id = ret.message_id;
+		result.messageTime = ret.time;
+		return result;
+	}
+	async sendForwardMsg(contact, elements, _options) {
+		const userId = Number(this.account.selfId) || 0;
+		const nickname = this.account.name;
+		const nodes = [];
+		for (const v of elements) {
+			const nodeUserId = v.subType === "fake" ? Number(v.userId) : userId;
+			const nodeNickname = v.subType === "fake" ? v.nickname : nickname;
+			if (v.subType === "fake") {
+				const { message } = await KarinConvertAdapter$1(v.message);
+				nodes.push(segment$1.fake(nodeUserId, message, nodeNickname));
+			} else {
+				try {
+					const msgs = await this.getForwardMsg(v.messageId);
+					const first = msgs[0];
+					const { message } = first ? await KarinConvertAdapter$1(first.elements) : { message: [""] };
+					nodes.push(segment$1.fake(nodeUserId, message, nodeNickname));
+				} catch {
+					nodes.push(segment$1.fake(nodeUserId, [""], nodeNickname));
+				}
+			}
+		}
+		if (nodes.length === 0) throw new Error("合并转发内容为空");
+		const result = {
+			messageId: "",
+			forwardId: ""
+		};
+		const ret = contact.scene === "friend" ? await this.super.sendPrivateMsg(Number(contact.peer), nodes) : await this.super.sendGroupMsg(Number(contact.peer), nodes);
+		result.messageId = ret.message_id;
+		return result;
+	}
+	async recallMsg(contact, messageId) {
+		await this.super.deleteMsg(messageId);
+	}
+	async getMsg(Contact, messageId) {
+		const mid = typeof Contact === "string" ? Contact : messageId;
+		const m = await this.super.getMsg(mid);
+		if (!m) throw new Error(`消息不存在: ${mid}`);
+		return await this.#toMessageResponse(m);
+	}
+	async getHistoryMsg(contact, startMsgSeq, count) {
+		const result = [];
+		if (contact.scene === "group") {
+			const seq = typeof startMsgSeq === "string" ? parseSeq(startMsgSeq) : startMsgSeq;
+			const msgs = await this.super.pickGroup(Number(contact.peer)).getChatHistory(seq > 0 ? seq : undefined, count);
+			for (const m of msgs) result.push(await this.#toMessageResponse(m));
+		} else {
+			const seq = typeof startMsgSeq === "string" ? parseSeq(startMsgSeq) : startMsgSeq;
+			const msgs = await this.super.pickFriend(Number(contact.peer)).getChatHistory(seq > 0 ? seq : undefined, count);
+			for (const m of msgs) result.push(await this.#toMessageResponse(m));
+		}
+		return result;
+	}
+	async getForwardMsg(resId) {
+		const scene = getResidScene(resId);
+		const msgs = scene ? await (scene.scene === "group" ? this.super.pickGroup(Number(scene.peer)) : this.super.pickFriend(Number(scene.peer))).getForwardMsg(resId) : await this.super.getForwardMsg(resId);
+		const result = [];
+		for (const m of msgs) {
+			result.push(await this.#toMessageResponse(m));
+		}
+		return result;
+	}
+	async setMsgReaction(contact, messageId, faceId, isSet) {
+		if (contact.scene !== "group") throw new Error("仅支持群聊设置表情回应");
+		const info = parseMessageId(messageId);
+		if (!info) throw new Error(`无法解析消息 id: ${messageId}`);
+		const group = this.super.pickGroup(info.group_id);
+		if (isSet) await group.setReaction(info.seq, String(faceId));
+		else await group.delReaction(info.seq, String(faceId));
+	}
+	async groupKickMember(groupId, targetId, rejectAddRequest, _kickReason) {
+		await this.super.setGroupKick(Number(groupId), Number(targetId), rejectAddRequest);
+	}
+	async setGroupMute(groupId, targetId, duration) {
+		await this.super.setGroupBan(Number(groupId), Number(targetId), duration);
+	}
+	async setGroupAllMute(groupId, isBan) {
+		await this.super.setGroupWholeBan(Number(groupId), isBan);
+	}
+	/** 发送群公告 (karin 无标准接口, icqq SDK Group.announce, 需管理员权限) */
+	async groupAnnounce(groupId, content) {
+		return this.super.pickGroup(Number(groupId)).announce(content);
+	}
+	async setGroupAdmin(groupId, targetId, isAdmin) {
+		await this.super.setGroupAdmin(Number(groupId), Number(targetId), isAdmin);
+	}
+	async setGroupMemberCard(groupId, targetId, card) {
+		await this.super.setGroupCard(Number(groupId), Number(targetId), card);
+	}
+	async setGroupName(groupId, groupName) {
+		await this.super.setGroupName(Number(groupId), groupName);
+	}
+	async setGroupQuit(groupId, isDismiss) {
+		const info = await this.super.getGroupMemberInfo(Number(groupId), Number(this.account.selfId || 0));
+		if (info && info.role === "owner" && !isDismiss) return;
+		await this.super.setGroupLeave(Number(groupId));
+	}
+	async setGroupMemberTitle(groupId, targetId, title) {
+		await this.super.setGroupSpecialTitle(Number(groupId), Number(targetId), title);
+	}
+	async getGroupInfo(groupId, noCache) {
+		const info = await this.super.getGroupInfo(Number(groupId), noCache);
+		let admins = [];
+		try {
+			for (const [uid, m] of await this.super.getGroupMemberList(Number(groupId), noCache)) {
+				if (m.role === "owner" || m.role === "admin") {
+					admins.push({
+						userId: String(uid),
+						name: m.card || m.nickname,
+						role: m.role
+					});
+				}
+			}
+		} catch {}
+		return {
+			groupId: String(info.group_id),
+			groupName: info.group_name,
+			maxMemberCount: info.max_member_count,
+			memberCount: info.member_count,
+			admins,
+			avatar: `https://p.qlogo.cn/gh/${groupId}/${groupId}/640`
+		};
+	}
+	async getGroupList(_refresh) {
+		const groups = [];
+		for (const [gid, info] of this.super.getGroupList()) {
+			groups.push({
+				groupId: String(gid),
+				groupName: info.group_name,
+				maxMemberCount: info.max_member_count,
+				memberCount: info.member_count,
+				admins: [],
+				avatar: `https://p.qlogo.cn/gh/${gid}/${gid}/0`
+			});
+		}
+		return groups;
+	}
+	async getGroupMemberInfo(groupId, targetId, refresh) {
+		const m = await this.super.getGroupMemberInfo(Number(groupId), Number(targetId), refresh);
+		return {
+			userId: String(m.user_id),
+			role: m.role,
+			nick: m.nickname,
+			age: m.age ?? 0,
+			uniqueTitle: m.title,
+			card: m.card,
+			joinTime: m.join_time,
+			lastActiveTime: m.last_sent_time,
+			level: m.level,
+			shutUpTime: m.shutup_time || undefined,
+			sex: m.sex,
+			sender: {
+				userId: String(m.user_id),
+				nick: m.nickname,
+				name: m.nickname,
+				role: m.role,
+				card: m.card,
+				level: m.level,
+				title: m.title
+			}
+		};
+	}
+	async getGroupMemberList(groupId, refresh) {
+		const map = await this.super.getGroupMemberList(Number(groupId), refresh);
+		const info = [];
+		for (const [uid, m] of map) {
+			info.push({
+				userId: String(uid),
+				role: m.role,
+				nick: m.nickname,
+				age: m.age ?? 0,
+				uniqueTitle: m.title,
+				card: m.card,
+				joinTime: m.join_time,
+				lastActiveTime: m.last_sent_time,
+				level: m.level,
+				shutUpTime: m.shutup_time || undefined,
+				sex: m.sex,
+				sender: {
+					userId: String(uid),
+					nick: m.nickname,
+					name: m.nickname,
+					role: m.role,
+					card: m.card,
+					level: m.level,
+					title: m.title
+				}
+			});
+		}
+		return info;
+	}
+	async getGroupHighlights(_groupId, _page, _pageSize) {
+		return [];
+	}
+	async setGroupHighlights(groupId, messageId, create) {
+		if (create) {
+			await this.super.setEssenceMessage(messageId);
+		} else {
+			await this.super.removeEssenceMessage(messageId);
+		}
+	}
+	async getStrangerInfo(targetId) {
+		const info = await this.super.pickUser(Number(targetId)).getSimpleInfo();
+		return {
+			userId: String(info.user_id),
+			nick: info.nickname,
+			qid: "",
+			remark: "",
+			level: 0,
+			age: info.age,
+			sex: info.sex
+		};
+	}
+	async getFriendList(_refresh) {
+		const info = [];
+		for (const [uid, f] of this.super.getFriendList()) {
+			info.push({
+				userId: String(uid),
+				nick: f.nickname,
+				qid: "",
+				remark: f.remark,
+				sex: f.sex
+			});
+		}
+		return info;
+	}
+	async sendLike(targetId, count) {
+		await this.super.sendLike(Number(targetId), count);
+	}
+	async getAvatarUrl(userId, size) {
+		return `https://q1.qlogo.cn/g?b=qq&s=${size || 0}&nk=${userId}`;
+	}
+	async getGroupAvatarUrl(groupId, size, _history) {
+		return `https://p.qlogo.cn/gh/${groupId}/${groupId}/${size || 0}`;
+	}
+	async pokeUser(contact, targetId, count = 1) {
+		let pokeFunc;
+		if (contact.scene === "group") pokeFunc = () => this.super.sendGroupPoke(Number(contact.peer), Number(targetId));
+		if (contact.scene === "friend") pokeFunc = () => this.super.sendGroupPoke(Number(this.super.uin || this.cfg.uin), Number(targetId)).then(() => true);
+		if (!pokeFunc) throw new Error(`不支持的场景: ${contact.scene}`);
+		for (let i = 0; i < count; i++) await pokeFunc();
+		return true;
+	}
+	async setFriendApplyResult(requestId, isApprove, remark) {
+		await this.super.setFriendAddRequest(requestId, isApprove, remark);
+	}
+	async setGroupApplyResult(requestId, isApprove, denyReason) {
+		await this.super.setGroupAddRequest(requestId, isApprove, denyReason);
+	}
+	async setInvitedJoinGroupResult(requestId, isApprove) {
+		await this.super.setGroupAddRequest(requestId, isApprove);
+	}
+	async getFileUrl(contact, fileId) {
+		if (contact.scene === "group") {
+			const res = await this.super.pickGroup(Number(contact.peer)).getFileUrl(fileId);
+			return res;
+		}
+		const res = await this.super.pickFriend(Number(contact.peer)).getFileUrl(fileId);
+		return res;
+	}
+	/** 获取视频播放地址 (NT 视频由会话接口自行解码 protobuf 载荷, 普通视频用 fid+md5) */
+	async getVideoUrl(contact, elem) {
+		if (elem.nt) {
+			const target = contact.scene === "group" ? this.super.pickGroup(Number(contact.peer)) : this.super.pickFriend(Number(contact.peer));
+			return target.getNTVideoUrl(elem);
+		}
+		if (!elem.fid || !elem.md5) return null;
+		return this.super.getVideoUrl(String(elem.fid), Buffer.from(String(elem.md5), "base64"));
+	}
+	/** 获取语音播放地址 (带 fid 走会话 NT 接口, 否则用收侧自带 url) */
+	async getRecordUrl(contact, elem) {
+		const target = contact.scene === "group" ? this.super.pickGroup(Number(contact.peer)) : this.super.pickFriend(Number(contact.peer));
+		return await target.getPttUrl(elem) ?? null;
+	}
+	async uploadFile(contact, file, name, folder) {
+		if (contact.scene === "group") {
+			await this.super.pickGroup(Number(contact.peer)).uploadFile(file, folder ?? "/", name);
+		} else {
+			await this.super.pickFriend(Number(contact.peer)).sendFile(file, name);
+		}
+	}
+	async uploadGroupFile(groupId, file, name) {
+		await this.super.pickGroup(Number(groupId)).uploadFile(file, "/", name || "");
+		return true;
+	}
+	async delGroupFile(groupId, fileId) {
+		await this.super.pickGroup(Number(groupId)).fs.rm(fileId);
+		return true;
+	}
+	async getGroupFileList(groupId, folderId) {
+		const fs = this.super.pickGroup(Number(groupId)).fs;
+		const list = await fs.dir(folderId || "/", 0, 100);
+		return {
+			files: list.filter((v) => !v.is_dir).map((v) => ({
+				fid: v.fid,
+				name: v.name,
+				size: v.size ?? 0,
+				uploadTime: v.create_time,
+				expireTime: v.duration ?? 0,
+				modifyTime: v.modify_time,
+				downloadCount: v.download_times ?? 0,
+				uploadId: String(v.user_id ?? ""),
+				uploadName: "",
+				sha1: v.sha1 ?? "",
+				sha3: "",
+				md5: v.md5 ?? ""
+			})),
+			folders: list.filter((v) => v.is_dir).map((v) => ({
+				id: v.fid,
+				name: v.name,
+				fileCount: v.file_count ?? 0,
+				createTime: v.create_time,
+				creatorId: String(v.user_id ?? ""),
+				creatorName: ""
+			}))
+		};
+	}
+	async createGroupFolder(groupId, name) {
+		const stat = await this.super.pickGroup(Number(groupId)).fs.mkdir(name);
+		return {
+			id: stat.fid,
+			usedSpace: "0"
+		};
+	}
+	async renameGroupFolder(groupId, folderId, name) {
+		await this.super.pickGroup(Number(groupId)).fs.rename(folderId, name);
+		return true;
+	}
+	async delGroupFolder(groupId, folderId) {
+		await this.super.pickGroup(Number(groupId)).fs.rm(folderId);
+		return true;
+	}
+	async getCookies(domain) {
+		return { cookie: this.super.getCookies(domain) };
+	}
+	async getCredentials(domain) {
+		const cookies = (await this.getCookies(domain)).cookie;
+		const token = (await this.getCSRFToken()).token;
+		return {
+			cookies,
+			csrf_token: token
+		};
+	}
+	async getCSRFToken() {
+		const token = this.super.getCsrfToken();
+		return { token: Number.isFinite(token) ? token : 0 };
+	}
+	async setAvatar(uri) {
+		await this.super.setPortrait(uri);
+	}
+};
+/** 从 cqhttp message_id 解析 seq */
+const parseSeq = (messageId) => {
+	const q = parseQuotable(messageId);
+	return q?.seq ?? 0;
+};
+/** 解析 cqhttp message_id → { group_id, seq } (仅供群场景) */
+const parseMessageId = (messageId) => {
+	try {
+		const info = parseGroupMessageId(messageId);
+		return {
+			group_id: info.group_id,
+			seq: info.seq
+		};
+	} catch {
+		return undefined;
+	}
+};
+/** icqq 协议 bot 工厂 */
+const createIcqqBot = (cfg) => {
+	return new IcqqBot(cfg);
+};
+
+//#endregion
+export { createIcqqBot };