mioki 0.13.0 → 0.15.0

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_package = require('./package-BHgI99iP.cjs');
+const require_package = require('./package-49Rgph2M.cjs');
 let node_fs = require("node:fs");
 node_fs = require_package.__toESM(node_fs);
 let node_util = require("node:util");
@@ -790,12 +790,20 @@ var config_exports = /* @__PURE__ */ require_package.__exportAll({
 	isInPm2: () => isInPm2,
 	isOwner: () => isOwner,
 	isOwnerOrAdmin: () => isOwnerOrAdmin,
+	normalizeNapCatConfig: () => normalizeNapCatConfig,
 	readMiokiConfig: () => readMiokiConfig,
 	readPackageJson: () => readPackageJson,
 	updateBotCWD: () => updateBotCWD,
 	updateBotConfig: () => updateBotConfig,
 	writePackageJson: () => writePackageJson
 });
+function isSingleNapCatConfig(config) {
+	return !Array.isArray(config);
+}
+function normalizeNapCatConfig(config) {
+	if (isSingleNapCatConfig(config)) return [config];
+	return config;
+}
 /**
 * 机器人根目录
 */
@@ -811,7 +819,10 @@ function readMiokiConfig() {
 	const config = readPackageJson().mioki;
 	if (!config) throw new Error(`无法在 package.json 中找到 mioki 配置，请确认 package.json 文件中是否包含 mioki 字段`);
 	if (!config.napcat) throw new Error(`mioki 配置中缺少 napcat 字段，请补全后重试`);
-	return readPackageJson().mioki;
+	return {
+		...config,
+		napcat: normalizeNapCatConfig(config.napcat)
+	};
 }
 /**
 * `mioki` 框架相关配置
@@ -1212,9 +1223,132 @@ function addService(name, service, cover = true) {
 function bindBot(bot, func) {
 	return (...args) => func(bot, ...args);
 }
+/**
+* 去重器
+* 处理多个 bot 在相同场景下，同一事件只处理一次
+*/
+var Deduplicator = class {
+	processedEvents = /* @__PURE__ */ new Set();
+	maxSize = 1e3;
+	/**
+	* 获取事件类型键
+	*/
+	getEventTypeKey(e) {
+		const { post_type } = e;
+		if (post_type === "message") return `msg:${e.message_type}`;
+		if (post_type === "request") {
+			if (e.request_type === "friend") return "req:friend";
+			return `req:group:${e.sub_type ?? "unknown"}`;
+		}
+		if (post_type === "notice") {
+			if (e.notice_type === "group") return `notice:group:${e.sub_type}`;
+			return `notice:${e.notice_type}:${e.sub_type}`;
+		}
+		return "unknown";
+	}
+	getGroupMessageKey(e) {
+		const groupId = e.group_id ?? "_";
+		const userId = e.user_id ?? "_";
+		const time = e.time ?? "_";
+		const raw = e.raw_message ?? "_";
+		return `msg:group:${groupId}:${userId}:${time}:${node_crypto.default.createHash("md5").update(raw).digest("hex")}`;
+	}
+	getNoticeGroupKey(e) {
+		return `${this.getEventTypeKey(e)}:${e.group_id ?? "_"}:${e.user_id ?? "_"}:${"operator_id" in e ? e.operator_id ?? "_" : "_"}:${"target_id" in e ? e.target_id ?? "_" : "_"}:${e.sub_type ?? "_"}:${"action_type" in e ? e.action_type ?? "_" : "_"}:${"duration" in e ? e.duration ?? "_" : "_"}:${e.time ?? "_"}`;
+	}
+	getRequestKey(e) {
+		const typeKey = this.getEventTypeKey(e);
+		const userId = e.user_id ?? "_";
+		const groupId = "group_id" in e ? e.group_id ?? "_" : "_";
+		const time = e.time ?? "_";
+		const comment = e.comment ?? "_";
+		return `${typeKey}:${userId}:${groupId}:${time}:${comment ? node_crypto.default.createHash("md5").update(comment).digest("hex") : "_"}`;
+	}
+	/**
+	* 生成事件唯一键
+	*/
+	getKey(e) {
+		const typeKey = this.getEventTypeKey(e);
+		if (typeKey === "msg:group") return this.getGroupMessageKey(e);
+		if (typeKey.startsWith("notice:group:")) return this.getNoticeGroupKey(e);
+		if (typeKey.startsWith("req:")) return this.getRequestKey(e);
+		return "";
+	}
+	/**
+	* 检查事件是否已处理过
+	* @param event
+	* @param scope
+	*/
+	isProcessed(event, scope) {
+		const key = scope ? `${this.getKey(event)}:${scope}` : this.getKey(event);
+		return this.processedEvents.has(key);
+	}
+	/**
+	* 标记事件为已处理
+	* @param event
+	* @param scope 需与 isProcessed 一致
+	*/
+	markProcessed(event, scope) {
+		const key = scope ? `${this.getKey(event)}:${scope}` : this.getKey(event);
+		if (this.processedEvents.size >= this.maxSize) {
+			const first = this.processedEvents.values().next();
+			if (!first.done) this.processedEvents.delete(first.value);
+		}
+		this.processedEvents.add(key);
+	}
+};
+/**
+* 消息去重器
+* @deprecated 请使用 Deduplicator，它支持更多事件类型
+*/
+var MessageDeduplicator = class extends Deduplicator {
+	isProcessed(event) {
+		return super.isProcessed(event);
+	}
+	markProcessed(event) {
+		super.markProcessed(event);
+	}
+};
+const deduplicator = new Deduplicator();
 const runtimePlugins = /* @__PURE__ */ new Map();
 const buildRemovedActions = (bot) => Object.fromEntries(Object.entries(actions_exports).map(([k, v]) => [k, bindBot(bot, v)]));
 /**
+* 检查事件是否是群消息事件
+*/
+function isGroupMessageEvent(event) {
+	return event?.post_type === "message" && event?.message_type === "group";
+}
+/**
+* 检查事件是否是私聊消息事件
+*/
+function isPrivateMessageEvent(event) {
+	return event?.post_type === "message" && event?.message_type === "private";
+}
+/**
+* 检查事件是否是消息事件
+*/
+function isMessageEvent(event) {
+	return isGroupMessageEvent(event) || isPrivateMessageEvent(event);
+}
+/**
+* 检查事件是否是请求事件
+*/
+function isRequestEvent(event) {
+	return event?.post_type === "request";
+}
+/**
+* 检查事件是否是群通知事件
+*/
+function isGroupNoticeEvent(event) {
+	return event?.post_type === "notice" && event?.notice_type === "group";
+}
+/**
+* 检查事件是否需要去重
+*/
+function isDeduplicableEvent(event) {
+	return isMessageEvent(event) || isRequestEvent(event) || isGroupNoticeEvent(event);
+}
+/**
 * 定义一个 Mioki 插件
 * @param plugin Mioki 插件对象
 * @returns Mioki 插件对象
@@ -1236,55 +1370,83 @@ function getAbsPluginDir(defaultDir = "plugins") {
 	const cwd = BOT_CWD.value;
 	return node_path.default.join(cwd, botConfig.plugins_dir || defaultDir);
 }
-async function enablePlugin(bot, plugin, type = "external") {
+async function enablePlugin(bots, plugin, type = "external") {
 	const typeDesc = type === "builtin" ? "内置" : "用户";
 	const pluginName = plugin.name || "null";
 	const { name = pluginName, version: version$1 = "null", description = "-", setup = () => {} } = plugin;
+	if (!bots[0]) throw new Error("没有可用的 bot 实例");
 	try {
 		const start$1 = node_process.hrtime.bigint();
 		const clears = /* @__PURE__ */ new Set();
 		const userClears = /* @__PURE__ */ new Set();
-		const logger$1 = bot.logger.withDefaults({
-			tag: `plugin:${name}`,
-			args: [name]
-		});
-		const context = {
-			bot,
-			segment: bot.segment,
-			getCookie: bot.getCookie.bind(bot),
-			...utils_exports,
-			...config_exports,
-			...buildRemovedActions(bot),
-			logger: logger$1,
-			services,
-			clears: userClears,
-			addService: (name$1, service, cover) => {
-				const remove = addService(name$1, service, cover);
-				clears.add(remove);
-				return remove;
-			},
-			handle: (eventName, handler) => {
-				logger$1.debug(`Registering event handler for event: ${String(eventName)}`);
-				bot.on(eventName, handler);
-				const unsubscribe = () => {
-					logger$1.debug(`Unregistering event handler for event: ${String(eventName)}`);
-					bot.off(eventName, handler);
-				};
-				clears.add(unsubscribe);
-				return unsubscribe;
-			},
-			cron: (cronExpression, handler) => {
-				logger$1.debug(`Scheduling cron job: ${cronExpression}`);
-				const job = node_cron.default.schedule(cronExpression, (now) => handler(context, now));
-				const clear = () => {
-					logger$1.debug(`Stopping cron job: ${cronExpression}`);
-					job.stop();
-				};
-				clears.add(clear);
-				return job;
-			}
+		const logger$1 = logger.withDefaults({ tag: `plugin:${name}` });
+		const createContext = (bot) => {
+			return {
+				bot,
+				bots,
+				self_id: bot.bot_id,
+				segment: bot.segment,
+				getCookie: bot.getCookie.bind(bot),
+				...utils_exports,
+				...config_exports,
+				...buildRemovedActions(bot),
+				logger: logger$1,
+				services,
+				clears: userClears,
+				deduplicator,
+				addService: (name$1, service, cover) => {
+					const remove = addService(name$1, service, cover);
+					clears.add(remove);
+					return remove;
+				},
+				handle: (eventName, handler, options = {}) => {
+					logger$1.debug(`Registering event handler for event: ${String(eventName)}`);
+					const { deduplicate = true } = options;
+					const dedupeScope = `${name}:${String(eventName)}:${node_crypto.default.randomUUID()}`;
+					const unsubscribes = [];
+					for (const bot$1 of bots) {
+						const wrappedHandler = (e) => {
+							if (isPrivateMessageEvent(e)) {
+								if (e.self_id !== bot$1.bot_id) return;
+							}
+							const senderUserId = e.user_id;
+							const senderOperatorId = e.operator_id;
+							const isFromConnectedBot = senderUserId && bots.some((b) => b.bot_id === senderUserId);
+							const isFromConnectedBotOperator = senderOperatorId && bots.some((b) => b.bot_id === senderOperatorId);
+							if (isFromConnectedBot || isFromConnectedBotOperator) return;
+							if (deduplicate && isDeduplicableEvent(e)) {
+								if (deduplicator.isProcessed(e, dedupeScope)) return;
+								deduplicator.markProcessed(e, dedupeScope);
+							}
+							handler(e);
+						};
+						bot$1.on(eventName, wrappedHandler);
+						const unsubscribe = () => {
+							logger$1.debug(`Unregistering event handler for event: ${String(eventName)}`);
+							bot$1.off(eventName, wrappedHandler);
+						};
+						unsubscribes.push(unsubscribe);
+					}
+					const clearAll = () => {
+						unsubscribes.forEach((fn) => fn());
+					};
+					clears.add(clearAll);
+					return clearAll;
+				},
+				cron: (cronExpression, handler) => {
+					logger$1.debug(`Scheduling cron job: ${cronExpression}`);
+					const job = node_cron.default.schedule(cronExpression, (now) => handler(createContext(bot), now));
+					const clear = () => {
+						logger$1.debug(`Stopping cron job: ${cronExpression}`);
+						job.stop();
+					};
+					clears.add(clear);
+					return job;
+				}
+			};
 		};
-		clears.add(await setup(context) || (() => {}));
+		const mainContext = createContext(bots[0]);
+		clears.add(await setup(mainContext) || (() => {}));
 		runtimePlugins.set(name, {
 			name,
 			type,
@@ -1303,7 +1465,7 @@ async function enablePlugin(bot, plugin, type = "external") {
 		});
 		const end = node_process.hrtime.bigint();
 		const time = Math.round(Number(end - start$1)) / 1e6;
-		bot.logger.info(`- 启用插件 ${consola_utils.colors.yellow(`[${typeDesc}]`)} ${consola_utils.colors.yellow(`${name}@${version$1}`)} => 耗时 ${consola_utils.colors.green(time.toFixed(2))} 毫秒`);
+		logger$1.info(`- 启用插件 ${consola_utils.colors.yellow(`[${typeDesc}]`)} ${consola_utils.colors.yellow(`${name}@${version$1}`)} => 耗时 ${consola_utils.colors.green(time.toFixed(2))} 毫秒`);
 	} catch (e) {
 		throw new Error(`启用插件 ${consola_utils.colors.yellow(`[${typeDesc}]`)} ${consola_utils.colors.yellow(`${name}@${version$1}`)} 失败: ${e?.message}`);
 	}
@@ -1329,18 +1491,12 @@ const ArchMap = {
 	arm64: "arm64",
 	x64: "x64"
 };
-async function getMiokiStatus(bot) {
+async function getMiokiStatus(bots) {
 	const osType = node_os.default.type();
 	const osArch = node_os.default.arch();
 	const isInUnix = ["Linux", "Darwin"].includes(osType);
 	const arch = ArchMap[osArch] || osArch;
-	const [osInfo, localPlugins, versionInfo, friendList, groupList] = await Promise.all([
-		systeminformation.default.osInfo(),
-		findLocalPlugins(),
-		bot.getVersionInfo(),
-		bot.getFriendList(),
-		bot.getGroupList()
-	]);
+	const [osInfo, localPlugins] = await Promise.all([systeminformation.default.osInfo(), findLocalPlugins()]);
 	const pluginCount = localPlugins.length + BUILTIN_PLUGINS.length;
 	const system = isInUnix ? {
 		name: osInfo.distro,
@@ -1354,27 +1510,58 @@ async function getMiokiStatus(bot) {
 	const rssMem = process.memoryUsage.rss();
 	const nodeVersion = process.versions.node;
 	const cpu = getCpuInfo();
-	return {
-		bot: {
-			uin: bot.uin,
+	const botStatuses = [];
+	let totalSend = 0;
+	let totalReceive = 0;
+	let mainVersionInfo = {
+		app_version: "unknown",
+		protocol_version: "unknown"
+	};
+	for (const bot of bots) try {
+		const [versionInfo, friendList, groupList] = await Promise.all([
+			bot.getVersionInfo(),
+			bot.getFriendList(),
+			bot.getGroupList()
+		]);
+		mainVersionInfo = versionInfo;
+		botStatuses.push({
+			uin: bot.bot_id,
 			nickname: bot.nickname,
+			name: bot.name,
 			friends: friendList.length,
-			groups: groupList.length
-		},
+			groups: groupList.length,
+			send: bot.stat.send.group + bot.stat.send.private,
+			receive: bot.stat.recv.group + bot.stat.recv.private
+		});
+		totalSend += bot.stat.send.group + bot.stat.send.private;
+		totalReceive += bot.stat.recv.group + bot.stat.recv.private;
+	} catch (err) {
+		botStatuses.push({
+			uin: bot.bot_id,
+			nickname: bot.nickname,
+			name: bot.name,
+			friends: 0,
+			groups: 0,
+			send: 0,
+			receive: 0
+		});
+	}
+	return {
+		bots: botStatuses,
 		plugins: {
 			enabled: runtimePlugins.size,
 			total: pluginCount
 		},
 		stats: {
 			uptime: process.uptime() * 1e3,
-			send: bot.stat.send.group + bot.stat.send.private,
-			receive: bot.stat.recv.group + bot.stat.recv.private
+			send: totalSend,
+			receive: totalReceive
 		},
 		versions: {
 			node: nodeVersion,
 			mioki: require_package.version,
-			napcat: versionInfo.app_version,
-			protocol: versionInfo.protocol_version
+			napcat: mainVersionInfo.app_version,
+			protocol: mainVersionInfo.protocol_version
 		},
 		system: {
 			name: system.name || "N/A",
@@ -1404,16 +1591,16 @@ async function getMiokiStatus(bot) {
 	};
 }
 async function formatMiokiStatus(status) {
-	const { bot, plugins, stats, system, disk, cpu, memory, versions } = status;
+	const { bots, plugins, stats, system, disk, cpu, memory, versions } = status;
 	const diskValid = disk.total > 0 && disk.free >= 0;
 	const diskDesc = `${disk.percent}%-${(0, filesize.filesize)(disk.used, { round: 1 })}/${(0, filesize.filesize)(disk.total, { round: 1 })}`;
 	return `
 〓 🟢 mioki 状态 〓
-👤 ${bot.nickname}
-🆔 ${bot.uin}
-📋 ${localNum(bot.friends)} 好友 / ${localNum(bot.groups)} 群
+${bots.map((bot, index) => {
+		return `👤 ${bot.name ? `[${bot.name}] ` : ""}${bot.nickname} (${bot.uin})\n   📋 ${localNum(bot.friends)} 好友 / ${localNum(bot.groups)} 群 / 📮 收 ${localNum(bot.receive)} 发 ${localNum(bot.send)}`;
+	}).join("\n")}
 🧩 启用了 ${localNum(plugins.enabled)} 个插件，共 ${localNum(plugins.total)} 个
-📮 收 ${localNum(stats.receive)} 条，发 ${localNum(stats.send)} 条
+📮 总计: 收 ${localNum(stats.receive)} 条，发 ${localNum(stats.send)} 条
 🚀 ${(0, filesize.filesize)(memory.rss.used, { round: 1 })}/${memory.percent}%
 ⏳ 已运行 ${(0, pretty_ms.default)(stats.uptime, {
 		hideYear: true,
@@ -1497,7 +1684,7 @@ const core = definePlugin({
 		const displayPrefix = prefix.replace(/\\\\/g, "\\");
 		const statusAdminOnly = ctx.botConfig.status_permission === "admin-only";
 		let statusFormatter = (status) => formatMiokiStatus(status);
-		ctx.addService("getMiokiStatus", () => getMiokiStatus(ctx.bot));
+		ctx.addService("getMiokiStatus", () => getMiokiStatus(ctx.bots));
 		ctx.addService("formatMiokiStatus", (status) => formatMiokiStatus(status));
 		ctx.addService("customFormatMiokiStatus", (formatter) => statusFormatter = formatter);
 		ctx.handle("message", (e) => ctx.runWithErrorHandler(async () => {
@@ -1505,7 +1692,7 @@ const core = definePlugin({
 			if (!cmdPrefix.test(text$1)) return;
 			if (statusAdminOnly && !ctx.hasRight(e)) return;
 			if (text$1.replace(cmdPrefix, "") === "状态") {
-				const status = await statusFormatter(await getMiokiStatus(ctx.bot));
+				const status = await statusFormatter(await getMiokiStatus(ctx.bots));
 				await e.reply(status);
 				return;
 			}
@@ -1570,10 +1757,10 @@ const core = definePlugin({
 								const plugin = await ctx.jiti.import(pluginPath, { default: true });
 								if (plugin.name !== target) {
 									const tip = `[插件目录名称: ${target}] 和插件代码中设置的 [name: ${plugin.name}] 不一致，可能导致重载异常，请修改后重启。`;
-									ctx.bot.logger.warn(tip);
+									ctx.logger.warn(tip);
 									ctx.noticeMainOwner(tip);
 								}
-								await enablePlugin(ctx.bot, plugin);
+								await enablePlugin(ctx.bots, plugin);
 							} catch (err) {
 								await e.reply(`插件 ${target} 启用失败：${err?.message || "未知错误"}`, true);
 								return;
@@ -1599,7 +1786,7 @@ const core = definePlugin({
 								break;
 							}
 							await ctx.updateBotConfig((c) => c.plugins = ctx.botConfig.plugins.filter((name) => name !== target));
-							ctx.bot.logger.info(`禁用插件 => ${target}`);
+							ctx.logger.info(`禁用插件 => ${target}`);
 							await e.reply(`插件 ${target} 已禁用`, true);
 							break;
 						}
@@ -1621,10 +1808,10 @@ const core = definePlugin({
 								const importedPlugin = await ctx.jiti.import(pluginPath, { default: true });
 								if (importedPlugin.name !== target) {
 									const tip = `插件目录名称: ${target} 和插件代码中设置的 name: ${importedPlugin.name} 不一致，可能导致重载异常，请修改后重启。`;
-									ctx.bot.logger.warn(tip);
+									ctx.logger.warn(tip);
 									ctx.noticeMainOwner(tip);
 								}
-								await enablePlugin(ctx.bot, importedPlugin);
+								await enablePlugin(ctx.bots, importedPlugin);
 							} catch (err) {
 								await e.reply(err?.message, true);
 								await ctx.updateBotConfig((c) => c.plugins = c.plugins.filter((name) => name !== target));
@@ -1737,7 +1924,7 @@ const core = definePlugin({
 					break;
 				case "退出":
 					await e.reply("またね～", true);
-					ctx.bot.logger.info("接收到退出指令，即将退出... 如需自动重启，请使用 pm2 部署。");
+					ctx.logger.info("接收到退出指令，即将退出... 如需自动重启，请使用 pm2 部署。");
 					process.exit(0);
 			}
 		}, e));
@@ -1751,6 +1938,120 @@ const BUILTIN_PLUGINS = [core_default];
 
 //#endregion
 //#region src/start.ts
+const connectedBots = /* @__PURE__ */ new Map();
+async function connectBot(config, index) {
+	const { protocol = "ws", port = 3001, host = "localhost", token = "", name } = config;
+	const botName = name || `Bot${index + 1}`;
+	const wsUrl = consola_utils.colors.green(`${protocol}://${host}:${port}${token ? "?access_token=***" : ""}`);
+	logger.info(`>>> 正在连接 ${consola_utils.colors.cyan(botName)}: ${wsUrl}`);
+	const napcat = new napcat_sdk.NapCat({
+		token,
+		protocol,
+		host,
+		port,
+		logger
+	});
+	return new Promise((resolve) => {
+		napcat.on("ws.close", () => {
+			logger.warn(`${consola_utils.colors.yellow(botName)} WS 连接已关闭`);
+		});
+		napcat.on("ws.error", (err) => {
+			logger.error(`${consola_utils.colors.red(botName)} WS 连接错误: ${err}`);
+		});
+		napcat.once("napcat.connected", ({ user_id, nickname, app_name, app_version }) => {
+			logger.info(`已连接到 ${consola_utils.colors.cyan(botName)}: ${consola_utils.colors.green(`${app_name}-v${app_version} ${nickname}(${user_id})`)}`);
+			if (connectedBots.has(user_id)) {
+				const existingBot = connectedBots.get(user_id);
+				if (existingBot.name) logger.warn(`${consola_utils.colors.yellow(botName)} (${user_id}) 与 ${consola_utils.colors.yellow(existingBot.name)} (${user_id}) QQ 号重复，将跳过`);
+				napcat.close();
+				resolve(null);
+				return;
+			}
+			const extendedNapCat = napcat;
+			extendedNapCat.bot_id = user_id;
+			extendedNapCat.app_name = app_name;
+			extendedNapCat.app_version = app_version;
+			extendedNapCat.name = botName;
+			resolve(extendedNapCat);
+		});
+		napcat.run().catch((err) => {
+			logger.error(`${consola_utils.colors.red(botName)} 连接失败: ${err.message}`);
+			resolve(null);
+		});
+	});
+}
+async function setupPlugins(napcat, bots) {
+	const plugin_dir = getAbsPluginDir();
+	const mainBot = napcat;
+	ensurePluginDir();
+	const plugins = botConfig.plugins.map((p) => ({
+		dirName: p,
+		absPath: node_path.default.resolve(plugin_dir, p)
+	})).filter((p) => {
+		if (!node_fs.default.existsSync(p.absPath)) {
+			mainBot.logger.warn(`插件 ${consola_utils.colors.red(p.dirName)} 不存在，已忽略`);
+			return false;
+		}
+		return true;
+	});
+	const failedImportPlugins = [];
+	const promises = plugins.map(async ({ absPath, dirName }) => {
+		try {
+			const plugin = await jiti$1.import(absPath, { default: true });
+			if (plugin.name !== dirName) {
+				const tip = `插件目录名 [${consola_utils.colors.yellow(dirName)}] 和插件声明的 name [${consola_utils.colors.yellow(plugin.name)}] 不一致，可能导致重载异常，请修改一致后重启。`;
+				mainBot.logger.warn(tip);
+				noticeMainOwner(mainBot, tip);
+			}
+			return plugin;
+		} catch (e) {
+			const err = stringifyError(e);
+			failedImportPlugins.push([dirName, err]);
+			return null;
+		}
+	});
+	const start$1 = node_process.hrtime.bigint();
+	const sortedUserPlugins = (await Promise.all(promises)).filter(Boolean).toSorted((prev, next) => (prev.priority ?? 100) - (next.priority ?? 100));
+	if (failedImportPlugins.length) {
+		const tip = `${consola_utils.colors.red(failedImportPlugins.length)} 个插件加载失败: \n\n${failedImportPlugins.map(([dirName, err]) => `${dirName}: ${err}`).join("\n\n")}`;
+		mainBot.logger.warn(tip);
+		noticeMainOwner(mainBot, tip);
+	}
+	const pluginGroups = /* @__PURE__ */ new Map();
+	for (const plugin of sortedUserPlugins) {
+		const priority = plugin.priority ?? 100;
+		if (!pluginGroups.has(priority)) pluginGroups.set(priority, []);
+		pluginGroups.get(priority).push(plugin);
+	}
+	const sortedGroups = Array.from(pluginGroups.entries()).toSorted(([a], [b]) => a - b);
+	const failedEnablePlugins = [];
+	try {
+		mainBot.logger.info(`>>> 加载内置插件: ${BUILTIN_PLUGINS.map((p) => consola_utils.colors.cyan(p.name)).join(", ")}`);
+		await Promise.all(BUILTIN_PLUGINS.map((p) => enablePlugin(bots, p, "builtin")));
+		mainBot.logger.info(`>>> 加载用户插件: ${sortedGroups.map(([priority, plugins$1]) => `优先级 ${consola_utils.colors.yellow(priority)} (${plugins$1.map((p) => consola_utils.colors.cyan(p.name)).join(", ")})`).join("，")}`);
+		for (const [_, plugins$1] of sortedGroups) await Promise.all(plugins$1.map(async (p) => {
+			try {
+				await enablePlugin(bots, p, "external");
+			} catch (e) {
+				failedEnablePlugins.push([p.name, stringifyError(e)]);
+			}
+		}));
+	} catch (e) {
+		mainBot.logger.error(e?.message);
+		await noticeMainOwner(mainBot, e?.message).catch(() => {
+			mainBot.logger.error("发送插件启用失败通知失败");
+		});
+	}
+	const end = node_process.hrtime.bigint();
+	const costTime = Math.round(Number(end - start$1)) / 1e6;
+	const failedCount = failedImportPlugins.length + failedEnablePlugins.length;
+	const failedInfo = failedCount > 0 ? `${consola_utils.colors.red(failedCount)} 个失败 (导入 ${consola_utils.colors.red(failedImportPlugins.length)}，启用 ${consola_utils.colors.red(failedEnablePlugins.length)})` : "";
+	mainBot.logger.info(`成功加载了 ${consola_utils.colors.green(runtimePlugins.size)} 个插件，${failedInfo ? failedInfo : ""}总耗时 ${consola_utils.colors.green(costTime.toFixed(2))} 毫秒`);
+	mainBot.logger.info(consola_utils.colors.green(`mioki v${require_package.version} 启动完成，向机器人发送「${consola_utils.colors.magentaBright(`${botConfig.prefix}帮助`)}」查看消息指令`));
+	if (botConfig.online_push) await noticeMainOwner(mainBot, `✅ mioki v${require_package.version} 已就绪`).catch((err) => {
+		mainBot.logger.error(`发送就绪通知失败: ${stringifyError(err)}`);
+	});
+}
 async function start(options = {}) {
 	const { cwd = process.cwd() } = options;
 	if (cwd !== BOT_CWD.value) updateBotCWD(node_path.default.resolve(cwd));
@@ -1769,117 +2070,67 @@ async function start(options = {}) {
 	logger.info(`${consola_utils.colors.dim("插件目录: ")}${consola_utils.colors.blue(plugin_dir)}`);
 	logger.info(`${consola_utils.colors.dim("配置文件: ")}${consola_utils.colors.blue(`${BOT_CWD.value}/package.json`)}`);
 	logger.info(consola_utils.colors.dim("=".repeat(40)));
-	const { protocol = "ws", port = 3001, host = "localhost", token = "" } = botConfig.napcat || {};
-	const wsUrl = consola_utils.colors.green(`${protocol}://${host}:${port}${token ? "?access_token=***" : ""}`);
-	logger.info(`>>> 正在连接 NapCat 实例: ${wsUrl}`);
-	const napcat = new napcat_sdk.NapCat({
-		token,
-		protocol,
-		host,
-		port,
-		logger
-	});
-	napcat.on("ws.close", () => {
-		logger.error("WS 连接失败，请确保 token 配置正确且 NapCat 实例正常运行");
+	const napcatConfigs = botConfig.napcat;
+	if (napcatConfigs.length === 0) {
+		logger.warn("未配置任何 NapCat 实例，框架将以无实例模式启动");
+		logger.info(consola_utils.colors.green(`mioki v${require_package.version} 启动完成，向机器人发送「${consola_utils.colors.magentaBright(`${botConfig.prefix}帮助`)}」查看消息指令`));
+		return;
+	}
+	const seenEndpoints = /* @__PURE__ */ new Set();
+	const duplicateConfigs = [];
+	for (const config of napcatConfigs) {
+		const { protocol = "ws", host = "localhost", port = 3001 } = config;
+		const endpoint = `${protocol}://${host}:${port}`;
+		if (seenEndpoints.has(endpoint)) duplicateConfigs.push(`${config.name || "未命名"} (${endpoint})`);
+		else seenEndpoints.add(endpoint);
+	}
+	if (duplicateConfigs.length > 0) {
+		logger.error(`检测到重复的 NapCat 实例配置:`);
+		duplicateConfigs.forEach((dup) => logger.error(`  - ${dup}`));
+		logger.error("请检查配置文件，确保每个实例的 host:port 组合唯一");
 		process.exit(1);
-	});
-	napcat.on("napcat.connected", async ({ user_id, nickname, app_name, app_version }) => {
-		logger.info(`已连接到 NapCat 实例: ${consola_utils.colors.green(`${app_name}-v${app_version} ${nickname}(${user_id})`)}`);
-		process.title = `mioki v${require_package.version} ${app_name}-v${app_version}-${user_id}`;
-		let lastNoticeTime = 0;
+	}
+	logger.info(consola_utils.colors.dim("=".repeat(40)));
+	logger.info(`>>> 正在连接 ${napcatConfigs.length} 个 NapCat 实例...`);
+	const bots = (await Promise.all(napcatConfigs.map((config, index) => connectBot(config, index)))).filter((b) => b !== null);
+	if (bots.length === 0) {
+		logger.error("所有 NapCat 实例连接失败，框架无法启动");
+		process.exit(1);
+	}
+	for (const bot of bots) connectedBots.set(bot.bot_id, bot);
+	if (bots.length < napcatConfigs.length) logger.warn(`${consola_utils.colors.yellow(napcatConfigs.length - bots.length)} 个 NapCat 实例连接失败`);
+	const botNames = bots.map((b) => `${b.name}(${b.bot_id})`).join(", ");
+	logger.info(consola_utils.colors.green(`成功连接 ${bots.length} 个实例: ${botNames}`));
+	logger.info(consola_utils.colors.dim("=".repeat(40)));
+	const mainBot = bots[0];
+	process.title = `mioki v${require_package.version} ${bots.map((b) => `${b.bot_id}`).join(", ")}`;
+	let lastNoticeTime = 0;
+	for (const bot of bots) {
 		process.on("uncaughtException", async (err) => {
 			const msg = stringifyError(err);
-			napcat.logger.error(`uncaughtException, 出错了: ${msg}`);
+			bot.logger.error(`uncaughtException, 出错了: ${msg}`);
 			if (botConfig.error_push) {
 				if (Date.now() - lastNoticeTime < 1e3) return;
 				lastNoticeTime = Date.now();
-				await noticeMainOwner(napcat, `mioki 发生未捕获异常:\n\n${msg}`).catch(() => {
-					napcat.logger.error("发送未捕获异常通知失败");
+				await noticeMainOwner(mainBot, `mioki 发生未捕获异常:\n\n${msg}`).catch(() => {
+					mainBot.logger.error("发送未捕获异常通知失败");
 				});
 			}
 		});
 		process.on("unhandledRejection", async (err) => {
 			const msg = stringifyError(err);
-			napcat.logger.error(`unhandledRejection, 出错了: ${msg}`);
+			bot.logger.error(`unhandledRejection, 出错了: ${msg}`);
 			if (botConfig.error_push) {
 				if (Date.now() - lastNoticeTime < 1e3) return;
 				lastNoticeTime = Date.now();
 				const date = (/* @__PURE__ */ new Date()).toLocaleString();
-				await noticeMainOwner(napcat, `【${date}】\n\nmioki 发生未处理异常:\n\n${msg}`).catch(() => {
-					napcat.logger.error("发送未处理异常通知失败");
+				await noticeMainOwner(mainBot, `【${date}】\n\nmioki 发生未处理异常:\n\n${msg}`).catch(() => {
+					mainBot.logger.error("发送未处理异常通知失败");
 				});
 			}
 		});
-		ensurePluginDir();
-		const plugins = botConfig.plugins.map((p) => ({
-			dirName: p,
-			absPath: node_path.default.resolve(plugin_dir, p)
-		})).filter((p) => {
-			if (!node_fs.default.existsSync(p.absPath)) {
-				napcat.logger.warn(`插件 ${consola_utils.colors.red(p.dirName)} 不存在，已忽略`);
-				return false;
-			}
-			return true;
-		});
-		const failedImportPlugins = [];
-		const promises = plugins.map(async ({ absPath, dirName }) => {
-			try {
-				const plugin = await jiti$1.import(absPath, { default: true });
-				if (plugin.name !== dirName) {
-					const tip = `插件目录名 [${consola_utils.colors.yellow(dirName)}] 和插件声明的 name [${consola_utils.colors.yellow(plugin.name)}] 不一致，可能导致重载异常，请修改一致后重启。`;
-					napcat.logger.warn(tip);
-					noticeMainOwner(napcat, tip);
-				}
-				return plugin;
-			} catch (e) {
-				const err = stringifyError(e);
-				failedImportPlugins.push([dirName, err]);
-				return null;
-			}
-		});
-		const start$1 = node_process.hrtime.bigint();
-		const sortedUserPlugins = (await Promise.all(promises)).filter(Boolean).toSorted((prev, next) => (prev.priority ?? 100) - (next.priority ?? 100));
-		if (failedImportPlugins.length) {
-			const tip = `${consola_utils.colors.red(failedImportPlugins.length)} 个插件加载失败: \n\n${failedImportPlugins.map(([dirName, err]) => `${dirName}: ${err}`).join("\n\n")}`;
-			napcat.logger.warn(tip);
-			noticeMainOwner(napcat, tip);
-		}
-		const pluginGroups = /* @__PURE__ */ new Map();
-		for (const plugin of sortedUserPlugins) {
-			const priority = plugin.priority ?? 100;
-			if (!pluginGroups.has(priority)) pluginGroups.set(priority, []);
-			pluginGroups.get(priority).push(plugin);
-		}
-		const sortedGroups = Array.from(pluginGroups.entries()).toSorted(([a], [b]) => a - b);
-		const failedEnablePlugins = [];
-		try {
-			napcat.logger.info(`>>> 加载内置插件: ${BUILTIN_PLUGINS.map((p) => consola_utils.colors.cyan(p.name)).join(", ")}`);
-			await Promise.all(BUILTIN_PLUGINS.map((p) => enablePlugin(napcat, p, "builtin")));
-			napcat.logger.info(`>>> 加载用户插件: ${sortedGroups.map(([priority, plugins$1]) => `优先级 ${consola_utils.colors.yellow(priority)} (${plugins$1.map((p) => consola_utils.colors.cyan(p.name)).join(", ")})`).join("，")}`);
-			for (const [_, plugins$1] of sortedGroups) await Promise.all(plugins$1.map(async (p) => {
-				try {
-					await enablePlugin(napcat, p, "external");
-				} catch (e) {
-					failedEnablePlugins.push([p.name, stringifyError(e)]);
-				}
-			}));
-		} catch (e) {
-			napcat.logger.error(e?.message);
-			await noticeMainOwner(napcat, e?.message).catch(() => {
-				napcat.logger.error("发送插件启用失败通知失败");
-			});
-		}
-		const end = node_process.hrtime.bigint();
-		const costTime = Math.round(Number(end - start$1)) / 1e6;
-		const failedCount = failedImportPlugins.length + failedEnablePlugins.length;
-		const failedInfo = failedCount > 0 ? `${consola_utils.colors.red(failedCount)} 个失败 (导入 ${consola_utils.colors.red(failedImportPlugins.length)}，启用 ${consola_utils.colors.red(failedEnablePlugins.length)})` : "";
-		napcat.logger.info(`成功加载了 ${consola_utils.colors.green(runtimePlugins.size)} 个插件，${failedInfo ? failedInfo : ""}总耗时 ${consola_utils.colors.green(costTime.toFixed(2))} 毫秒`);
-		napcat.logger.info(consola_utils.colors.green(`mioki v${require_package.version} 启动完成，向机器人发送「${consola_utils.colors.magentaBright(`${botConfig.prefix}帮助`)}」查看消息指令`));
-		if (botConfig.online_push) await noticeMainOwner(napcat, `✅ mioki v${require_package.version} 已就绪`).catch((err) => {
-			napcat.logger.error(`发送就绪通知失败: ${stringifyError(err)}`);
-		});
-	});
-	await napcat.run();
+	}
+	await setupPlugins(mainBot, bots);
 }
 
 //#endregion
@@ -1888,6 +2139,8 @@ exports.BOT_CWD = BOT_CWD;
 exports.BUILTIN_PLUGINS = BUILTIN_PLUGINS;
 exports.CORE_PLUGINS = CORE_PLUGINS;
 exports.ChromeUA = ChromeUA;
+exports.Deduplicator = Deduplicator;
+exports.MessageDeduplicator = MessageDeduplicator;
 exports.START_TIME = START_TIME;
 exports.SystemMap = SystemMap;
 exports.addService = addService;
@@ -1914,6 +2167,7 @@ Object.defineProperty(exports, 'colors', {
     return consola_utils.colors;
   }
 });
+exports.connectedBots = connectedBots;
 exports.createCmd = createCmd;
 exports.createDB = createDB;
 exports.createForwardMsg = createForwardMsg;
@@ -1930,6 +2184,7 @@ Object.defineProperty(exports, 'dedent', {
     return dedent.default;
   }
 });
+exports.deduplicator = deduplicator;
 exports.definePlugin = definePlugin;
 exports.enablePlugin = enablePlugin;
 exports.ensureBuffer = ensureBuffer;
@@ -2000,6 +2255,7 @@ Object.defineProperty(exports, 'mri', {
   }
 });
 exports.noNullish = noNullish;
+exports.normalizeNapCatConfig = normalizeNapCatConfig;
 exports.noticeAdmins = noticeAdmins;
 exports.noticeFriends = noticeFriends;
 exports.noticeGroups = noticeGroups;