mioki 0.15.1 → 0.16.1

package/dist/index.d.cts

@@ -32,7 +32,6 @@ interface ExtendedNapCat extends NapCat {
   bot_id: number;
   app_name: string;
   app_version: string;
-  name?: string;
 }
 declare const connectedBots: Map<number, ExtendedNapCat>;
 declare function start(options?: StartOptions): Promise<void>;
@@ -551,7 +550,6 @@ declare const ArchMap: Record<string, string>;
 interface BotStatus {
   uin: number;
   nickname: string;
-  name?: string;
   friends: number;
   groups: number;
   send: number;
@@ -690,12 +688,21 @@ declare const deduplicator: Deduplicator;
  * Mioki 上下文对象，包含 Mioki 运行时的信息和方法
  */
 interface MiokiContext extends Services, Configs, Utils, RemoveBotParam<Actions> {
-  /** 当前处理事件的机器人实例 */
+  /**
+   * 单实例模式下：机器人实例
+   * 多实例模式下：第一个机器人实例
+   *
+   * 如果要获取指定机器人实例，请使用 ctx.getBot(id) 方法，id 通常可以从 event.self_id 获取
+   */
   bot: NapCat;
-  /** 所有已连接的机器人实例列表 */
-  bots: ExtendedNapCat[];
   /** 当前机器人 QQ 号 */
   self_id: number;
+  /** 多实例模式下：所有已连接的机器人实例列表 */
+  bots: ExtendedNapCat[];
+  /** 多实例模式下：通过 QQ 号获取机器人实例 */
+  pickBot: (id: number) => ExtendedNapCat;
+  /** 多实例模式下：需要手动传入 bot 实例的操作方法集合*/
+  actions: Actions;
   /** 消息构造器 */
   segment: NapCat['segment'];
   /** 通过域名获取 Cookies */

package/dist/index.d.mts

@@ -30,7 +30,6 @@ interface ExtendedNapCat extends NapCat {
   bot_id: number;
   app_name: string;
   app_version: string;
-  name?: string;
 }
 declare const connectedBots: Map<number, ExtendedNapCat>;
 declare function start(options?: StartOptions): Promise<void>;
@@ -549,7 +548,6 @@ declare const ArchMap: Record<string, string>;
 interface BotStatus {
   uin: number;
   nickname: string;
-  name?: string;
   friends: number;
   groups: number;
   send: number;
@@ -688,12 +686,21 @@ declare const deduplicator: Deduplicator;
  * Mioki 上下文对象，包含 Mioki 运行时的信息和方法
  */
 interface MiokiContext extends Services, Configs, Utils, RemoveBotParam<Actions> {
-  /** 当前处理事件的机器人实例 */
+  /**
+   * 单实例模式下：机器人实例
+   * 多实例模式下：第一个机器人实例
+   *
+   * 如果要获取指定机器人实例，请使用 ctx.getBot(id) 方法，id 通常可以从 event.self_id 获取
+   */
   bot: NapCat;
-  /** 所有已连接的机器人实例列表 */
-  bots: ExtendedNapCat[];
   /** 当前机器人 QQ 号 */
   self_id: number;
+  /** 多实例模式下：所有已连接的机器人实例列表 */
+  bots: ExtendedNapCat[];
+  /** 多实例模式下：通过 QQ 号获取机器人实例 */
+  pickBot: (id: number) => ExtendedNapCat;
+  /** 多实例模式下：需要手动传入 bot 实例的操作方法集合*/
+  actions: Actions;
   /** 消息构造器 */
   segment: NapCat['segment'];
   /** 通过域名获取 Cookies */

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-BiucMVzj.mjs";
-import { t as version } from "./package-75_Caljc.mjs";
+import { t as version } from "./package-Bvcr71Zp.mjs";
 import fs, { default as fs$1 } from "node:fs";
 import util from "node:util";
 import path, { default as path$1 } from "node:path";
@@ -1380,13 +1380,15 @@ async function enablePlugin(bots, plugin, type = "external") {
 		const createContext = (bot) => {
 			return {
 				bot,
-				bots,
 				self_id: bot.bot_id,
+				bots,
+				pickBot: (id) => bots.find((b) => b.bot_id === id),
 				segment: bot.segment,
 				getCookie: bot.getCookie.bind(bot),
 				...utils_exports,
 				...config_exports,
 				...buildRemovedActions(bot),
+				actions: actions_exports,
 				logger: logger$1,
 				services,
 				clears: userClears,
@@ -1524,7 +1526,6 @@ async function getMiokiStatus(bots) {
 		botStatuses.push({
 			uin: bot.bot_id,
 			nickname: bot.nickname,
-			name: bot.name,
 			friends: friendList.length,
 			groups: groupList.length,
 			send: bot.stat.send.group + bot.stat.send.private,
@@ -1536,7 +1537,6 @@ async function getMiokiStatus(bots) {
 		botStatuses.push({
 			uin: bot.bot_id,
 			nickname: bot.nickname,
-			name: bot.name,
 			friends: 0,
 			groups: 0,
 			send: 0,
@@ -1591,13 +1591,14 @@ async function formatMiokiStatus(status) {
 	const { bots, plugins, stats, system, disk, cpu, memory, versions } = status;
 	const diskValid = disk.total > 0 && disk.free >= 0;
 	const diskDesc = `${disk.percent}%-${filesize(disk.used, { round: 1 })}/${filesize(disk.total, { round: 1 })}`;
+	const botLines = bots.map((bot) => {
+		return `👤 ${bot.nickname} (${bot.uin})\n   📋 ${localNum(bot.friends)} 好友 / ${localNum(bot.groups)} 群 / 📮 收 ${localNum(bot.receive)} 发 ${localNum(bot.send)}`;
+	}).join("\n");
+	const statsLine = bots.length > 1 ? `\n📮 总计: 收 ${localNum(stats.receive)} 条，发 ${localNum(stats.send)} 条` : "";
 	return `
 〓 🟢 mioki 状态 〓
-${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)} 条
+${botLines}
+🧩 启用了 ${localNum(plugins.enabled)} 个插件，共 ${localNum(plugins.total)} 个${statsLine}
 🚀 ${filesize(memory.rss.used, { round: 1 })}/${memory.percent}%
 ⏳ 已运行 ${prettyMs(stats.uptime, {
 		hideYear: true,
@@ -1937,8 +1938,8 @@ const BUILTIN_PLUGINS = [core_default];
 //#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 { protocol = "ws", port = 3001, host = "localhost", token = "" } = config;
+	const botName = `Bot${index + 1}`;
 	const wsUrl = colors$1.green(`${protocol}://${host}:${port}${token ? "?access_token=***" : ""}`);
 	logger.info(`>>> 正在连接 ${colors$1.cyan(botName)}: ${wsUrl}`);
 	const napcat = new NapCat({
@@ -1958,8 +1959,7 @@ async function connectBot(config, index) {
 		napcat.once("napcat.connected", ({ user_id, nickname, app_name, app_version }) => {
 			logger.info(`已连接到 ${colors$1.cyan(botName)}: ${colors$1.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(`${colors$1.yellow(botName)} (${user_id}) 与 ${colors$1.yellow(existingBot.name)} (${user_id}) QQ 号重复，将跳过`);
+				logger.warn(`${colors$1.yellow(botName)} (${user_id}) 与已存在的 bot (${user_id}) QQ 号重复，将跳过`);
 				napcat.close();
 				resolve(null);
 				return;
@@ -1968,7 +1968,6 @@ async function connectBot(config, index) {
 			extendedNapCat.bot_id = user_id;
 			extendedNapCat.app_name = app_name;
 			extendedNapCat.app_version = app_version;
-			extendedNapCat.name = botName;
 			resolve(extendedNapCat);
 		});
 		napcat.run().catch((err) => {
@@ -2075,10 +2074,10 @@ async function start(options = {}) {
 	}
 	const seenEndpoints = /* @__PURE__ */ new Set();
 	const duplicateConfigs = [];
-	for (const config of napcatConfigs) {
-		const { protocol = "ws", host = "localhost", port = 3001 } = config;
+	for (let i = 0; i < napcatConfigs.length; i++) {
+		const { protocol = "ws", host = "localhost", port = 3001 } = napcatConfigs[i];
 		const endpoint = `${protocol}://${host}:${port}`;
-		if (seenEndpoints.has(endpoint)) duplicateConfigs.push(`${config.name || "未命名"} (${endpoint})`);
+		if (seenEndpoints.has(endpoint)) duplicateConfigs.push(`Bot${i + 1} (${endpoint})`);
 		else seenEndpoints.add(endpoint);
 	}
 	if (duplicateConfigs.length > 0) {
@@ -2096,7 +2095,7 @@ async function start(options = {}) {
 	}
 	for (const bot of bots) connectedBots.set(bot.bot_id, bot);
 	if (bots.length < napcatConfigs.length) logger.warn(`${colors$1.yellow(napcatConfigs.length - bots.length)} 个 NapCat 实例连接失败`);
-	const botNames = bots.map((b) => `${b.name}(${b.bot_id})`).join(", ");
+	const botNames = bots.map((b) => `${b.bot_id}`).join(", ");
 	logger.info(colors$1.green(`成功连接 ${bots.length} 个实例: ${botNames}`));
 	logger.info(colors$1.dim("=".repeat(40)));
 	const mainBot = bots[0];