@napuketto/loader 0.0.2 → 0.0.4

package/dist/host/self-host.cjs

@@ -24,6 +24,7 @@ let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_process = require("node:process");
 node_process = __toESM(node_process, 1);
+let node_readline = require("node:readline");
 let node_os = require("node:os");
 //#region src/instance-lock.ts
 /**
@@ -160,6 +161,8 @@ const env = {
 	NAPUTO_QUICK_UIN: process.env["NAPUTO_QUICK_UIN"],
 	/** 收发消息冒烟自检开关（=1 触发）。 */
 	NAPUTO_SMOKE: process.env["NAPUTO_SMOKE"],
+	/** IPC 子进程模式（=1：koishi 插件驱动——stdout 走 JSON 行协议，stdin 收 action/control）。 */
+	NAPUTO_IPC: process.env["NAPUTO_IPC"],
 	/** 冒烟目标 peer（c2c:<uin> / group:<uin>，缺省发给自己）。 */
 	NAPUTO_SMOKE_PEER: process.env["NAPUTO_SMOKE_PEER"],
 	/** 运行时探测开关（=1 触发 probeRuntime）。 */
@@ -170,6 +173,293 @@ const env = {
 	NAPKETTO_DATA: process.env["NAPKETTO_DATA"]
 };
 //#endregion
+//#region src/host/ipc/ipc-actions.ts
+/**
+* 从宽松 params 构造 Peer（缺省 chatType=1 群聊）。
+* 优先 peerUid（uid 直通）；缺省时 peerUin（QQ 号）经 uinToUid 转换。
+*/
+async function toPeer(params, uinToUid) {
+	const chatType = typeof params["chatType"] === "number" ? params["chatType"] : 1;
+	const uidParam = params["peerUid"];
+	if (typeof uidParam === "string" && uidParam !== "") return {
+		chatType,
+		peerUid: uidParam
+	};
+	const uinParam = params["peerUin"];
+	if (typeof uinParam === "string" && uinParam !== "" && uinToUid !== void 0) {
+		const uid = (await uinToUid([uinParam])).get(uinParam);
+		if (uid !== void 0 && uid !== "") return {
+			chatType,
+			peerUid: uid
+		};
+		throw new Error(`uin 转 uid 失败: ${uinParam}`);
+	}
+	throw new Error("缺 peerUid（或 peerUin 且未注入 uinToUid）");
+}
+/** 构造动作表（map 顺序即注册顺序，重复动作名后注册覆盖）。 */
+function createIpcActions(ctx) {
+	const actions = /* @__PURE__ */ new Map();
+	actions.set("login.getSelf", async () => ctx.self);
+	actions.set("msg.sendMessage", async (params) => {
+		const peer = await toPeer(params, ctx.uinToUid);
+		const elements = Array.isArray(params["elements"]) ? params["elements"] : [];
+		return ctx.msgApi.sendMessage(peer, elements);
+	});
+	actions.set("msg.recallMessage", async (params) => {
+		const peer = await toPeer(params, ctx.uinToUid);
+		const msgIds = Array.isArray(params["msgIds"]) ? params["msgIds"].map(String) : [];
+		await ctx.msgApi.recallMessage(peer, msgIds);
+	});
+	actions.set("msg.fetchMessages", async (params) => {
+		const peer = await toPeer(params, ctx.uinToUid);
+		const count = typeof params["count"] === "number" ? params["count"] : 20;
+		const msgId = typeof params["msgId"] === "string" ? params["msgId"] : void 0;
+		return ctx.msgApi.fetchMessages(peer, {
+			count,
+			...msgId !== void 0 ? { msgId } : {}
+		});
+	});
+	actions.set("msg.markRead", async (params) => {
+		const peer = await toPeer(params, ctx.uinToUid);
+		await ctx.msgApi.markRead(peer);
+	});
+	actions.set("group.getGroupList", async () => {
+		return ctx.groupCache.listGroupsRefreshed();
+	});
+	actions.set("friend.getFriendList", async () => ctx.friendApi.getFriendList());
+	return actions;
+}
+/** 统一动作调用：查找动作表 → 执行 → 返回结果或错误（不抛，调用方转 result）。 */
+async function callIpcAction(actions, action, params) {
+	const handler = actions.get(action);
+	if (handler === void 0) return {
+		ok: false,
+		error: {
+			code: "NOT_FOUND",
+			message: `未知动作: ${action}`
+		}
+	};
+	try {
+		return {
+			ok: true,
+			value: await handler(params ?? {})
+		};
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		return {
+			ok: false,
+			error: {
+				code: errorCodeOf(err),
+				message
+			}
+		};
+	}
+}
+/** 宽松提取错误码（KernelError 有 string code 字段；其他错误 UNKNOWN）。 */
+function errorCodeOf(err) {
+	if (typeof err === "object" && err !== null) {
+		const code = err.code;
+		if (typeof code === "string" && code !== "") return code;
+	}
+	return "UNKNOWN";
+}
+//#endregion
+//#region src/host/ipc/ipc-types.ts
+/** 消息类型集合（解码校验用）。 */
+const IPC_MESSAGE_TYPES = /* @__PURE__ */ new Set([
+	"status",
+	"login",
+	"qr",
+	"event",
+	"result",
+	"log",
+	"ping",
+	"pong",
+	"action",
+	"control"
+]);
+//#endregion
+//#region src/host/ipc/ipc-sender.ts
+/**
+* ipc-sender.ts：IPC 消息发送封装（self-host 子进程 → koishi 插件）。
+*
+* 仅 NAPUTO_IPC=1 启用：stdout 专用于 JSON 行协议（stdin 收 action/control）。
+* 非 IPC 模式（cli pnpm start）stdout 不输出协议行，零干扰。
+*/
+/** IPC 模式开关（self-host.ts 在 env.NAPUTO_IPC=1 时 enable）。 */
+let enabled = false;
+/** 启用 IPC 发送（幂等）。 */
+function enableIpc() {
+	enabled = true;
+}
+/** 发送一条 IPC 消息（JSON 行）。失败静默（不阻塞引导）。 */
+function sendIpc(message) {
+	if (!enabled) return;
+	try {
+		process.stdout.write(`${JSON.stringify(message)}\n`);
+	} catch {}
+}
+/** 引导状态（booting/dlopening/logging/sessioning/ready/failed）。 */
+function sendStatus(phase, message, error) {
+	sendIpc({
+		v: 1,
+		type: "status",
+		payload: {
+			phase,
+			...message !== void 0 ? { message } : {},
+			...error !== void 0 ? { error } : {}
+		}
+	});
+}
+/** 登录状态（QR 状态机 idle/waiting_scan/scanned/logged_in/failed）。 */
+function sendLogin(state, selfInfo) {
+	sendIpc({
+		v: 1,
+		type: "login",
+		payload: {
+			state,
+			...selfInfo !== void 0 ? { selfInfo } : {}
+		}
+	});
+}
+/** 二维码数据（扫码登录展示用）。 */
+function sendQr(pngBase64, qrcodeUrl) {
+	sendIpc({
+		v: 1,
+		type: "qr",
+		payload: {
+			pngBase64,
+			qrcodeUrl
+		}
+	});
+}
+/** kernel 事件转发（service/name/args 原样透传，koishi 插件翻译层消费）。 */
+function sendEvent(service, name, args) {
+	sendIpc({
+		v: 1,
+		type: "event",
+		payload: {
+			service,
+			name,
+			args
+		}
+	});
+}
+/** 动作响应。 */
+function sendResult(id, payload) {
+	sendIpc({
+		v: 1,
+		type: "result",
+		id,
+		payload
+	});
+}
+/** 心跳应答（收到 ping 时回）。 */
+function sendPong() {
+	sendIpc({
+		v: 1,
+		type: "pong"
+	});
+}
+/** 心跳（定期发送，koishi 插件探活）。 */
+function sendPing() {
+	sendIpc({
+		v: 1,
+		type: "ping"
+	});
+}
+//#endregion
+//#region src/host/ipc/ipc-codec.ts
+/**
+* ipc-codec.ts：IPC 消息编解码（JSON 行协议，与 koishi 插件侧 src/ipc/codec.ts 对齐）。
+*
+* 每行一条 JSON 消息，`\n` 结尾。解码宽松：非法行 / 空行 / v 不匹配 /
+* 未知 type → null，调用方忽略，不崩通道。
+*/
+/** 类型守卫：v 匹配 + type 合法。 */
+function isIpcMessage(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return record["v"] === 1 && typeof record["type"] === "string" && IPC_MESSAGE_TYPES.has(record["type"]);
+}
+/** 解码一行 JSON；非法行/空行返回 null。 */
+function decodeIpcMessage(line) {
+	const trimmed = line.trim();
+	if (trimmed === "") return null;
+	try {
+		const parsed = JSON.parse(trimmed);
+		return isIpcMessage(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+/** 启动 IPC 服务端（stdin 接收 + 心跳）。返回停止函数。 */
+function startIpcServer(options) {
+	const heartbeatMs = options.heartbeatMs ?? 15e3;
+	const onExit = options.onExit ?? (() => process.exit(0));
+	const rl = (0, node_readline.createInterface)({
+		input: process.stdin,
+		crlfDelay: Infinity
+	});
+	rl.on("line", (line) => {
+		const message = decodeIpcMessage(line);
+		if (message === null) return;
+		switch (message.type) {
+			case "action":
+				handleAction(message.id, message.payload.action, message.payload.params, options.actions);
+				break;
+			case "control":
+				handleControl(message.payload, onExit);
+				break;
+			case "ping": sendPong();
+		}
+	});
+	const timer = setInterval(() => sendPing(), heartbeatMs);
+	return () => {
+		clearInterval(timer);
+		rl.close();
+	};
+}
+/** 动作执行 → result 响应（不抛：callIpcAction 内部兜底转错误）。 */
+async function handleAction(id, action, params, actions) {
+	sendResult(id, await callIpcAction(actions, action, params));
+}
+/** 控制指令处理（stop/restart 退出；login 预留——引导期登录由 bootstrap 内部驱动）。 */
+function handleControl(payload, onExit) {
+	if (payload.command === "stop" || payload.command === "restart") onExit();
+}
+//#endregion
+//#region src/host/ipc/ipc-bootstrap.ts
+/** 订阅事件通道 → event 消息转发（事件名 "Service/method" 拆分）。 */
+function forwardChannel(channel, stops) {
+	if (typeof channel.onAny !== "function") return;
+	const off = channel.onAny((event, ...args) => {
+		const slash = event.indexOf("/");
+		sendEvent(slash >= 0 ? event.slice(0, slash) : event, slash >= 0 ? event.slice(slash + 1) : "", args);
+	});
+	if (typeof off === "function") stops.push(off);
+}
+/** IPC 模式装配（enableIpc + 动作表 + 服务端 + 事件转发）。返回停止函数。 */
+function startIpcMode(services) {
+	enableIpc();
+	const groupApi = services.groupApi;
+	const stopServer = startIpcServer({ actions: createIpcActions({
+		msgApi: services.msgApi,
+		groupApi: services.groupApi,
+		groupCache: services.groupCache,
+		friendApi: services.friendApi,
+		self: services.self,
+		...groupApi.uinToUid !== void 0 ? { uinToUid: groupApi.uinToUid } : {}
+	}) });
+	const stops = [];
+	forwardChannel(services.channel, stops);
+	forwardChannel(services.groupChannel, stops);
+	return () => {
+		stopServer();
+		for (const stop of stops) stop();
+	};
+}
+//#endregion
 //#region src/host/util.ts
 /**
 * util.ts：引导公共工具（日志 + 共享状态）。
@@ -208,7 +498,7 @@ function createState() {
 	};
 }
 //#endregion
-//#region src/host/login.ts
+//#region src/host/core/login.ts
 /** 打印可用快速登录账号 + 返回目标账号（启动横幅）。forcedUin（cli `-q` / NAPUTO_QUICK_UIN）优先。 */
 async function pickLoginAccount(kernel, ctx, loginResultRef, forcedUin) {
 	try {
@@ -253,25 +543,37 @@ async function doLogin(core, opts) {
 //#endregion
 //#region src/host/load-config.ts
 /**
-* 协议配置段读取（从 protocols.ts 拆分，2026-08-08 FTA 优化）
+* 协议配置段读取（从 protocols.ts 拆分，2026-08-08 FTA 优化；2026-08-08 结构拍板：按账号取段）
 *
-* 全局 TOML 配置（<项目根>/napuketto.toml，2026-08-07 用户拍板：配置文件放项目根）：
-* 读 [onebot11] / [satori] 段，装配时 zod 校验后作 seed。路径优先级：NAPKETTO_CONFIG
-* （launcher 注入）> 装配链自身探测（kernel.resolveConfigPath）> NAPUTO_CFG_DIR 兜底
-* （旧行为兼容）。（ConfigBase seed 模式：load() 直接用内存值，不再读写独立协议文件）
+* 全局 TOML 配置（<项目根>/napuketto.toml）：**协议配置嵌在账号内**——
+* accounts 数组每项含 [onebot11] / [satori] 段，登录成功后按账号 uin 找到对应项，
+* 取其段作 seed（zod 校验）。路径优先级：NAPKETTO_CONFIG（launcher 注入）>
+* 装配链自身探测（kernel.resolveConfigPath）> NAPUTO_CFG_DIR 兜底（旧行为兼容）。
+* （ConfigBase seed 模式：load() 直接用内存值，不再读写独立协议文件）
 */
-/** 读取全局 TOML 的协议段（读取失败用默认空段，不阻塞装配）。 */
-function loadProtocolSections(kernel) {
+/** 账号内取协议段（宽松对象，装配时 zod 校验）。 */
+function sectionOf(account, key) {
+	const section = account[key];
+	if (section !== void 0 && section !== null && typeof section === "object") return section;
+}
+/**
+* 按登录账号 uin 读取全局 TOML 的协议段（读取失败 / 未找到账号 / 无协议段 → 空段，
+* 不阻塞装配）。uin 为登录成功后实际账号（-q 指定账号与配置不一致时以 uin 为准）。
+*/
+function loadProtocolSections(kernel, uin) {
 	const cfgFile = env.NAPKETTO_CONFIG || (0, node_path.join)(env.NAPUTO_CFG_DIR || ".", "napuketto.toml");
 	let ob11Section = {};
 	let satoriSection = {};
 	try {
 		const raw = (0, node_fs.readFileSync)(cfgFile, "utf8");
-		const parsed = kernel.parseToml(raw);
-		const ob11 = parsed["onebot11"];
-		const satori = parsed["satori"];
-		if (ob11 !== void 0 && ob11 !== null && typeof ob11 === "object") ob11Section = ob11;
-		if (satori !== void 0 && satori !== null && typeof satori === "object") satoriSection = satori;
+		const accounts = kernel.parseToml(raw)["accounts"];
+		if (Array.isArray(accounts)) {
+			const mine = accounts.find((item) => typeof item === "object" && item !== null && String(item["qq"]) === uin);
+			if (mine !== void 0) {
+				ob11Section = sectionOf(mine, "onebot11") ?? {};
+				satoriSection = sectionOf(mine, "satori") ?? {};
+			}
+		}
 	} catch (e) {
 		log(`bootstrap: 全局配置读取失败（用默认 ob11/satori 配置）: ${errMsg(e)}`);
 	}
@@ -282,74 +584,13 @@ function loadProtocolSections(kernel) {
 	};
 }
 //#endregion
-//#region src/host/msg-log.ts
-/** 终端 ANSI 颜色（消息日志颜色分层，2026-08-07 用户定稿）。 */
-const ANSI = {
-	gray: "\x1B[90m",
-	cyan: "\x1B[36m",
-	green: "\x1B[32m",
-	reset: "\x1B[0m"
-};
-/** canonical 元素 → 日志占位文本。 */
-function elementToText(el) {
-	if (el.type === "text") return el.text ?? "";
-	if (el.type === "at") return `@${el.display ?? (el.target === "all" ? "全体" : el.target)}`;
-	if (el.type === "file") return `[文件${el.name ?? ""}]`;
-	if (el.type === "forward") return "[合并转发]";
-	return `[${el.type}]`;
-}
-/** 渲染消息为单行文本（text 拼接，at/媒体元素转占位）。 */
-function renderMessage(kernel, msg) {
-	let rendered = "";
-	for (const el of kernel.toCanonicalElements(msg)) rendered += elementToText(el);
-	return rendered === "" ? "[空消息/媒体]" : rendered;
-}
-/**
-* 消息日志订阅（onRecvMsg 回调参数为消息数组——2026-08-07 运行时实证，遍历逐条打印）。
-*/
-function setupMsgLogging(kernel, channel, logger) {
-	channel.on("Msg/onRecvMsg", (msgs) => {
-		forEachRawMessage(msgs, (m) => {
-			try {
-				const raw = m;
-				const rendered = renderMessage(kernel, m);
-				const isGroup = raw.chatType === kernel.ChatType.GROUP;
-				const kind = isGroup ? "群聊" : "私聊";
-				const peerUin = String(raw.peerUin ?? "");
-				const senderUin = String(raw.senderUin ?? (peerUin || "未知"));
-				const plainTags = isGroup ? `[群${peerUin}] [用户${senderUin}]` : `[用户${senderUin}]`;
-				const coloredTags = isGroup ? `${ANSI.cyan}[群${peerUin}]${ANSI.reset} ${ANSI.green}[用户${senderUin}]${ANSI.reset}` : `${ANSI.green}[用户${senderUin}]${ANSI.reset}`;
-				const content = rendered.replace(/\n/g, "\n    ");
-				const plain = `接收 <- ${kind} ${plainTags}： ${content}`;
-				const colored = `${ANSI.gray}loader | 接收 <- ${kind}${ANSI.reset} ${coloredTags}： ${content}`;
-				log(plain);
-				logger?.info(colored);
-			} catch (e) {
-				const line2 = `接收消息（解析失败: ${errMsg(e)}）`;
-				log(line2);
-				logger?.warn(line2);
-			}
-		});
-	});
-}
-//#endregion
-//#region src/host/protocols.ts
-/**
-* protocols.ts：协议装配（登录成功后）。
-* 2026-08-07 阶段 2：由 runtime/boot-protocols.js TS 化（零语义改动）。
-* 动态 import adapter/network 入口，装配 OB11 / Satori 适配器。
-* 依赖 launcher 注入的 NAPUTO_ADAPTER_ENTRY / NAPUTO_NETWORK_ENTRY。
-*
-* 2026-08-08 FTA 优化：消息日志渲染 → msg-log.ts；TOML 配置段读取 → load-config.ts。
-*/
+//#region src/host/core/assemble-protocols.ts
 /**
-* 登录成功后装配协议：kernel 各 Api + network 广播 + OB11 / Satori 适配器。
+* assemble-protocols.ts：OB11 / Satori 协议装配（非 IPC 模式，cli pnpm start）。
+* 2026-08-08：从 protocols.ts 拆分——protocols.ts 只留入口 + IPC 分支。
 */
-async function startProtocols(kernel, ctx, loginResult) {
-	const logger = kernel.createLogger?.({
-		console: true,
-		base: { name: "loader" }
-	});
+/** 装配 OB11 + Satori 适配器（登录成功后，非 IPC 模式）。 */
+async function assembleOb11AndSatori(kernel, services, loginResult) {
 	const adapterEntry = env.NAPUTO_ADAPTER_ENTRY;
 	const networkEntry = env.NAPUTO_NETWORK_ENTRY;
 	if (!adapterEntry || !networkEntry) {
@@ -364,32 +605,9 @@ async function startProtocols(kernel, ctx, loginResult) {
 		const adapter = await import(`file://${onebot11Entry.replace(/\\/g, "/")}`);
 		const satoriAdapter = await import(`file://${satoriEntry.replace(/\\/g, "/")}`);
 		const adapterCore = await import(`file://${coreEntry.replace(/\\/g, "/")}`);
-		const session = ctx.session;
-		if (!session) {
-			log("bootstrap: session 为空，无法装配协议");
-			return;
-		}
-		const channel = new kernel.NTEventChannel("Msg");
-		new kernel.MsgBridge(session, channel).register();
-		setupMsgLogging(kernel, channel, logger);
-		const groupApi = new kernel.GroupApi(session);
-		const msgApi = new kernel.MsgApi(session);
-		const friendApi = new kernel.FriendApi(session, { uidToUin: (uids) => groupApi.uidToUin(uids) });
-		const groupChannel = new kernel.NTEventChannel("Group");
-		new kernel.GroupBridge(session, groupChannel).register();
-		const groupCache = new kernel.GroupCache({
-			channel: groupChannel,
-			groupApi
-		});
-		groupCache.register();
-		const groupNotifyApi = new kernel.GroupNotifyApi(session);
-		const ticketApi = new kernel.TicketApi(session);
-		const richMediaApi = new kernel.RichMediaApi(session);
-		const profileApi = new kernel.ProfileApi(session);
-		const profileLikeApi = new kernel.ProfileLikeApi(session);
-		const webApi = new kernel.WebApi({ getCookies: (domain) => ticketApi.getCookies(domain, loginResult.uin) });
+		const { channel, groupCache } = services;
 		const broadcaster = new network.EventBroadcaster();
-		const { cfgFile, ob11Section, satoriSection } = loadProtocolSections(kernel);
+		const { cfgFile, ob11Section, satoriSection } = loadProtocolSections(kernel, loginResult.uin);
 		const ob11Config = new adapterCore.ProtocolConfig({
 			path: cfgFile,
 			schema: adapter.ob11ConfigSchema,
@@ -400,19 +618,16 @@ async function startProtocols(kernel, ctx, loginResult) {
 			config: ob11Config,
 			broadcaster,
 			msgChannel: channel,
-			msgApi,
-			groupApi,
-			groupNotifyApi,
-			friendApi,
-			ticketApi,
-			richMediaApi,
-			profileApi,
-			profileLikeApi,
-			webApi,
-			self: {
-				uin: loginResult.uin,
-				nickname: loginResult.nick
-			},
+			msgApi: services.msgApi,
+			groupApi: services.groupApi,
+			groupNotifyApi: services.groupNotifyApi,
+			friendApi: services.friendApi,
+			ticketApi: services.ticketApi,
+			richMediaApi: services.richMediaApi,
+			profileApi: services.profileApi,
+			profileLikeApi: services.profileLikeApi,
+			webApi: services.webApi,
+			self: services.self,
 			system: {
 				appVersion: env.NAPUTO_QQ_VERSION || "unknown",
 				cleanCache: async () => {
@@ -445,15 +660,12 @@ async function startProtocols(kernel, ctx, loginResult) {
 			config: satoriConfig,
 			broadcaster,
 			msgChannel: channel,
-			msgApi,
-			groupApi,
-			groupNotifyApi,
-			friendApi,
-			profileApi,
-			self: {
-				uin: loginResult.uin,
-				nickname: loginResult.nick
-			},
+			msgApi: services.msgApi,
+			groupApi: services.groupApi,
+			groupNotifyApi: services.groupNotifyApi,
+			friendApi: services.friendApi,
+			profileApi: services.profileApi,
+			self: services.self,
 			cacheDir: satoriCacheDir,
 			groupCache
 		}).start();
@@ -463,7 +675,142 @@ async function startProtocols(kernel, ctx, loginResult) {
 	}
 }
 //#endregion
-//#region src/host/session.ts
+//#region src/host/msg-log.ts
+/** 终端 ANSI 颜色（消息日志颜色分层，2026-08-07 用户定稿）。 */
+const ANSI = {
+	gray: "\x1B[90m",
+	cyan: "\x1B[36m",
+	green: "\x1B[32m",
+	reset: "\x1B[0m"
+};
+/** canonical 元素 → 日志占位文本。 */
+function elementToText(el) {
+	if (el.type === "text") return el.text ?? "";
+	if (el.type === "at") return `@${el.display ?? (el.target === "all" ? "全体" : el.target)}`;
+	if (el.type === "file") return `[文件${el.name ?? ""}]`;
+	if (el.type === "forward") return "[合并转发]";
+	return `[${el.type}]`;
+}
+/** 渲染消息为单行文本（text 拼接，at/媒体元素转占位）。 */
+function renderMessage(kernel, msg) {
+	let rendered = "";
+	for (const el of kernel.toCanonicalElements(msg)) rendered += elementToText(el);
+	return rendered === "" ? "[空消息/媒体]" : rendered;
+}
+/**
+* 消息日志订阅（onRecvMsg 回调参数为消息数组——2026-08-07 运行时实证，遍历逐条打印）。
+*/
+function setupMsgLogging(kernel, channel, logger) {
+	channel.on("Msg/onRecvMsg", (msgs) => {
+		forEachRawMessage(msgs, (m) => {
+			try {
+				const raw = m;
+				const rendered = renderMessage(kernel, m);
+				const isGroup = raw.chatType === kernel.ChatType.GROUP;
+				const kind = isGroup ? "群聊" : "私聊";
+				const peerUin = String(raw.peerUin ?? "");
+				const senderUin = String(raw.senderUin ?? (peerUin || "未知"));
+				const plainTags = isGroup ? `[群${peerUin}] [用户${senderUin}]` : `[用户${senderUin}]`;
+				const coloredTags = isGroup ? `${ANSI.cyan}[群${peerUin}]${ANSI.reset} ${ANSI.green}[用户${senderUin}]${ANSI.reset}` : `${ANSI.green}[用户${senderUin}]${ANSI.reset}`;
+				const content = rendered.replace(/\n/g, "\n    ");
+				const plain = `接收 <- ${kind} ${plainTags}： ${content}`;
+				const colored = `${ANSI.gray}loader | 接收 <- ${kind}${ANSI.reset} ${coloredTags}： ${content}`;
+				log(plain);
+				logger?.info(colored);
+			} catch (e) {
+				const line2 = `接收消息（解析失败: ${errMsg(e)}）`;
+				log(line2);
+				logger?.warn(line2);
+			}
+		});
+	});
+}
+//#endregion
+//#region src/host/core/kernel-services.ts
+/**
+* kernel-services.ts：kernel 业务服务装配（IPC 模式与协议模式共用）。
+*
+* 登录成功后创建：消息/群事件通道 + 桥 + 缓存 + kernel 各 Api + 自身信息。
+* IPC 模式（koishi 插件）经此拿服务装配 ipc-server；非 IPC（cli）经此拿服务
+* 装配 OB11/Satori 适配器。
+*/
+/** 登录成功后创建 kernel 业务服务（channel/bridge/cache/apis）。失败返回 null。 */
+async function createKernelServices(kernel, ctx, loginResult) {
+	const logger = kernel.createLogger?.({
+		console: true,
+		base: { name: "loader" }
+	});
+	const session = ctx.session;
+	if (!session) {
+		log("bootstrap: session 为空，无法创建 kernel 服务");
+		return null;
+	}
+	const channel = new kernel.NTEventChannel("Msg");
+	new kernel.MsgBridge(session, channel).register();
+	setupMsgLogging(kernel, channel, logger);
+	const groupApi = new kernel.GroupApi(session);
+	const msgApi = new kernel.MsgApi(session);
+	const friendApi = new kernel.FriendApi(session, { uidToUin: (uids) => groupApi.uidToUin(uids) });
+	const groupChannel = new kernel.NTEventChannel("Group");
+	new kernel.GroupBridge(session, groupChannel).register();
+	const groupCache = new kernel.GroupCache({
+		channel: groupChannel,
+		groupApi
+	});
+	groupCache.register();
+	const groupNotifyApi = new kernel.GroupNotifyApi(session);
+	const ticketApi = new kernel.TicketApi(session);
+	return {
+		kernel,
+		ctx,
+		logger,
+		channel,
+		groupChannel,
+		msgApi,
+		groupApi,
+		friendApi,
+		groupCache,
+		groupNotifyApi,
+		ticketApi,
+		richMediaApi: new kernel.RichMediaApi(session),
+		profileApi: new kernel.ProfileApi(session),
+		profileLikeApi: new kernel.ProfileLikeApi(session),
+		webApi: new kernel.WebApi({ getCookies: (domain) => ticketApi.getCookies(domain, loginResult.uin) }),
+		self: {
+			uin: loginResult.uin,
+			nickname: loginResult.nick ?? ""
+		}
+	};
+}
+//#endregion
+//#region src/host/core/protocols.ts
+/**
+* protocols.ts：协议装配入口（登录成功后）。
+* 2026-08-08 重构：kernel 服务创建 → kernel-services.ts；OB11/Satori 装配 →
+* assemble-protocols.ts。本文件只留入口 + IPC 模式分支。
+*
+* 分支：
+*  - IPC 模式（NAPUTO_IPC=1，koishi 插件驱动）：跳过 OB11/Satori（插件直接消费
+*    kernel 服务），返回 KernelServices 由 bootstrap 装配 ipc-server。
+*  - 非 IPC（cli pnpm start）：照旧装配 OB11/Satori 网络传输。
+*/
+/** 登录成功后装配协议：IPC 模式返回 kernel 服务（供 ipc-server），否则装配 OB11/Satori。 */
+async function startProtocols(kernel, ctx, loginResult) {
+	const services = await createKernelServices(kernel, ctx, loginResult);
+	if (services === null) return null;
+	if (env.NAPUTO_IPC === "1") {
+		log("bootstrap: IPC 模式，跳过 OB11/Satori 装配（koishi 插件直接消费 kernel 服务）");
+		return services;
+	}
+	try {
+		await assembleOb11AndSatori(kernel, services, loginResult);
+	} catch (e) {
+		log(`bootstrap: 协议装配失败: ${errMsg(e)}`);
+	}
+	return services;
+}
+//#endregion
+//#region src/host/core/session.ts
 /** 对象有效性判断：getMsgService() 调用不抛断言（cpp_impl 已激活）。
 * 与 isSessionUsable 的区别：这里允许返回 null（未 init 但对象有效）。 */
 function isSessionObjectValid(s) {
@@ -588,7 +935,7 @@ function pickBestSession(candidates) {
 	return bestValid;
 }
 //#endregion
-//#region src/host/smoke.ts
+//#region src/host/core/smoke.ts
 /**
 * smoke.ts：P2-1 收发消息冒烟自检（NAPUTO_SMOKE=1 触发，2026-08-06）。
 * 2026-08-07 阶段 2：由 runtime/boot-smoke.js TS 化（零语义改动）。
@@ -714,7 +1061,7 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 	return ok;
 }
 //#endregion
-//#region src/host/bootstrap-core.ts
+//#region src/host/core/bootstrap-core.ts
 /**
 * bootstrap-core.ts：NapukettoCore 装配路径（从 bootstrap.ts 拆分，2026-08-08 FTA 优化）。
 *
@@ -735,14 +1082,31 @@ function probeCreatedSession(state, ctx) {
 		log(`BOOT: create() 探测失败: ${errMsg(e)}`);
 	}
 }
+/** 登录状态字面量（IPC login 消息，与 kernel LoginState 对齐）。 */
+const LOGIN_STATES = [
+	"idle",
+	"waiting_scan",
+	"scanned",
+	"logged_in",
+	"failed"
+];
+/** 宽松收窄（kernel onLoginProgress.state 是 string）。 */
+function isLoginState(value) {
+	return LOGIN_STATES.includes(value);
+}
 /** 登录参数（NAPUTO_QUICK_UIN 强制指定 / ref 目标 / 默认）。 */
 function buildLoginOpts(Appid, forcedUin, ref) {
 	const quickUin = forcedUin ?? ref.targetUin;
-	return {
+	const opts = {
 		appid: Appid,
 		initTimeoutMs: 2e4,
 		...quickUin !== void 0 ? { quickUin } : {}
 	};
+	if (env.NAPUTO_IPC === "1") opts["onLoginProgress"] = (progress) => {
+		if (progress.qr !== void 0) sendQr(progress.qr.pngBase64, progress.qr.qrcodeUrl);
+		if (isLoginState(progress.state)) sendLogin(progress.state, progress.selfInfo);
+	};
+	return opts;
 }
 /** V2 登录后替换 session：优先 QQ 主 session，其次 vehicle 单例表；自建宿主例外。 */
 function replaceSession(kernel, core, state, ctx) {
@@ -841,20 +1205,32 @@ async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
 	const forcedUin = env.NAPUTO_QUICK_UIN;
 	const ref = { targetUin: void 0 };
 	await pickLoginAccount(kernel, ctx, ref, forcedUin);
+	if (env.NAPUTO_IPC === "1") sendStatus("logging");
 	const loginResult = await doLogin(core, buildLoginOpts(Appid, forcedUin, ref));
 	if (loginResult === null) {
 		log("bootstrap: 登录失败，引导中止");
+		if (env.NAPUTO_IPC === "1") sendStatus("failed", "登录失败", {
+			code: "NOT_LOGIN",
+			message: "登录失败"
+		});
 		return;
 	}
 	log(`bootstrap: 登录成功 uin=${loginResult.uin} uid=${loginResult.uid} nick=${loginResult.nick}`);
+	if (env.NAPUTO_IPC === "1") sendLogin("logged_in", {
+		uin: loginResult.uin,
+		uid: loginResult.uid,
+		nick: loginResult.nick ?? ""
+	});
 	await activateSession(kernel, state, ctx, replaceSession(kernel, core, state, ctx), loginResult, Appid, bootEnv);
 	await waitSessionReady(kernel, ctx);
+	if (env.NAPUTO_IPC === "1") sendStatus("sessioning");
 	await runSmokeIfEnabled(kernel, ctx, loginResult);
-	await startProtocols(kernel, ctx, loginResult);
+	const services = await startProtocols(kernel, ctx, loginResult);
+	if (env.NAPUTO_IPC === "1" && services !== null) startIpcMode(services);
 	runProbePhase(kernel, ctx);
 }
 //#endregion
-//#region src/host/bootstrap.ts
+//#region src/host/core/bootstrap.ts
 /**
 * bootstrap.ts：kernel 引导核心（import kernel → 装配 → 登录 → session 替换 → 协议装配）。
 * 2026-08-07 阶段 2：由 runtime/boot-bootstrap.js TS 化（零语义改动）。
@@ -951,7 +1327,7 @@ async function bootstrap(state) {
 	}
 }
 //#endregion
-//#region src/host/self-host.ts
+//#region src/host/core/self-host.ts
 /**
 * self-host.ts：自建宿主（路线 A，NAPUTO_SELF_HOST）入口——标准 Node 进程直接运行。
 * 2026-08-07 阶段 2：由 runtime/self-host.cjs TS 化（零语义改动）。
@@ -976,6 +1352,11 @@ async function bootstrap(state) {
 *     → kernel 装配 → 登录（快速/QR）→ session（先 init 后 start）→ 冒烟 → 协议装配
 */
 const state = createState();
+const ipcMode = env.NAPUTO_IPC === "1";
+if (ipcMode) {
+	enableIpc();
+	sendStatus("booting");
+}
 log(`[self-host] 启动 @ ${(/* @__PURE__ */ new Date()).toISOString()} pid=${process.pid} node=${process.version} type=${process.type ?? "(标准 node)"}`);
 log(`[self-host] stub 目录: ${env.NAPUTO_STUB_DIR ?? "(PATH 前置，未记录)"}`);
 const lockDataDir = env.NAPUTO_CFG_DIR;
@@ -983,6 +1364,10 @@ if (lockDataDir) {
 	if (!acquireInstanceLock(lockDataDir)) {
 		const { pid: holderPid } = checkInstanceLock(lockDataDir);
 		log(`[self-host] ❌ 数据目录已被其他实例占用（pid=${holderPid ?? "?"}），退出；同一账号数据目录仅允许一个实例，请先停止已有实例`);
+		if (ipcMode) sendStatus("failed", "数据目录被占用", {
+			code: "INVALID_STATE",
+			message: `数据目录已被其他实例占用（pid=${holderPid ?? "?"}）`
+		});
 		process.exit(1);
 	}
 	registerLockCleanup(lockDataDir);
@@ -991,9 +1376,14 @@ if (lockDataDir) {
 const wrapperPath = env.NAPUTO_WRAPPER_PATH;
 if (!wrapperPath) {
 	log("[self-host] NAPUTO_WRAPPER_PATH 未设置，退出");
+	if (ipcMode) sendStatus("failed", "NAPUTO_WRAPPER_PATH 未设置", {
+		code: "INVALID_STATE",
+		message: "NAPUTO_WRAPPER_PATH 未设置，退出"
+	});
 	process.exit(1);
 }
 log(`[self-host] dlopen wrapper.node: ${wrapperPath}`);
+if (ipcMode) sendStatus("dlopening");
 try {
 	const m = { exports: {} };
 	process.dlopen(m, wrapperPath);
@@ -1001,11 +1391,19 @@ try {
 	log(`[self-host] ✅ dlopen 成功，exports ${keys.length} 个`);
 	if (!keys.includes("NodeIKernelLoginService")) {
 		log("[self-host] ❌ exports 无 NodeIKernelLoginService（stub 环境异常？）");
+		if (ipcMode) sendStatus("failed", "exports 无 NodeIKernelLoginService", {
+			code: "INVALID_STATE",
+			message: "exports 无 NodeIKernelLoginService（stub 环境异常？）"
+		});
 		process.exit(1);
 	}
 	state.wrapperExports = m.exports;
 } catch (e) {
 	log(`[self-host] ❌ dlopen 失败: ${errMsg(e)}`);
+	if (ipcMode) sendStatus("failed", "dlopen 失败", {
+		code: "UNKNOWN",
+		message: errMsg(e)
+	});
 	process.exit(1);
 }
 try {
@@ -1022,8 +1420,13 @@ log("[self-host] 调 bootstrap(state) ...");
 	try {
 		await bootstrap(state);
 		log("[self-host] bootstrap 完成");
+		if (ipcMode) sendStatus("ready");
 	} catch (e) {
 		log(`[self-host] bootstrap 失败: ${errMsg(e)}`);
+		if (ipcMode) sendStatus("failed", "bootstrap 失败", {
+			code: "UNKNOWN",
+			message: errMsg(e)
+		});
 		process.exit(1);
 	}
 })();

package/dist/index.d.mts

@@ -97,6 +97,8 @@ interface LaunchOptions {
   stubDir?: string;
   /** 强制指定快速登录账号（注入 NAPUTO_QUICK_UIN；cli `-q <uin>` 透传，2026-08-07）。 */
   quickUin?: string;
+  /** IPC 子进程模式（=1：stdout 走 JSON 行协议 + stdin 收 action/control，koishi 插件驱动）。 */
+  ipc?: boolean;
   /** 自建宿主入口（默认 dist/host/self-host.cjs）。 */
   selfHostEntry?: string;
   /**
@@ -154,6 +156,8 @@ declare const ENV: {
   readonly CONFIG_PATH: "NAPKETTO_CONFIG";
   /** 强制指定快速登录账号（cli `-q <uin>` 透传，bootstrap 登录用）。 */
   readonly QUICK_UIN: "NAPUTO_QUICK_UIN";
+  /** IPC 子进程模式（koishi 插件驱动：stdout JSON 行 + stdin action/control）。 */
+  readonly IPC: "NAPUTO_IPC";
 };
 //#endregion
 export { ENV, INSTANCE_LOCK_FILE, type InstanceLockCheck, type InstanceLockInfo, type LaunchOptions, type LaunchResult, type QqInstallInfo, acquireInstanceLock, checkInstanceLock, defaultStubDir, launchSelfHost, locateQqPath, registerLockCleanup, releaseInstanceLock, resolveQqInstall };

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/instance-lock.ts","../src/locate-qq.ts","../src/launcher.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;cA2Ba;;UAGI;;EAEb;;EAEA;;EAEA;;;UAIa;;EAEb;;EAEA;;EAEA;;;;;;;iBAQY,kBAAkB,kBAAkB;;;;;iBA+BpC,oBAAoB,iBAAiB;;;;;iBA4BrC,oBAAoB;;iBAapB,oBAAoB;;;;UCvEnB;;EAEb;;EAEA;;EAEA;;EAEA;;;iBAIY;;iBAaA,iBAAiB,kBAAkB;;;UC9DlC;;EAEb,IAAI;;EAEJ;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA;;;;;;EAMA,QAAQ;;UAGK;;EAEb,OAAO,kBAAkB;;EAEzB;;;;;;;;;;;iBAYY,eAAe,SAAS,gBAAgB;;;;;iBAiDxC;;cAqCH;WACT;WACA;WACA;WACA;WACA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/instance-lock.ts","../src/locate-qq.ts","../src/launcher.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;cA2Ba;;UAGI;;EAEb;;EAEA;;EAEA;;;UAIa;;EAEb;;EAEA;;EAEA;;;;;;;iBAQY,kBAAkB,kBAAkB;;;;;iBA+BpC,oBAAoB,iBAAiB;;;;;iBA4BrC,oBAAoB;;iBAapB,oBAAoB;;;;UCvEnB;;EAEb;;EAEA;;EAEA;;EAEA;;;iBAIY;;iBAaA,iBAAiB,kBAAkB;;;UC9DlC;;EAEb,IAAI;;EAEJ;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA;;;;;;EAMA,QAAQ;;UAGK;;EAEb,OAAO,kBAAkB;;EAEzB;;;;;;;;;;;iBAYY,eAAe,SAAS,gBAAgB;;;;;iBAiDxC;;cAwCH;WACT;WACA;WACA;WACA;WACA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA"}

package/dist/index.mjs

@@ -174,6 +174,7 @@ function buildLaunchEnv(options) {
 	if (options.networkEntry !== void 0) env[ENV.NETWORK_ENTRY] = resolve(options.networkEntry);
 	if (options.configPath !== void 0) env[ENV.CONFIG_PATH] = resolve(options.configPath);
 	if (options.quickUin !== void 0) env[ENV.QUICK_UIN] = options.quickUin;
+	if (options.ipc === true) env[ENV.IPC] = "1";
 	return env;
 }
 /** 环境变量名（self-host.cjs 与 kernel 引导读取）。 */
@@ -194,7 +195,9 @@ const ENV = {
 	/** 全局配置文件路径（项目根 napuketto.toml，boot-protocols 读取）。 */
 	CONFIG_PATH: "NAPKETTO_CONFIG",
 	/** 强制指定快速登录账号（cli `-q <uin>` 透传，bootstrap 登录用）。 */
-	QUICK_UIN: "NAPUTO_QUICK_UIN"
+	QUICK_UIN: "NAPUTO_QUICK_UIN",
+	/** IPC 子进程模式（koishi 插件驱动：stdout JSON 行 + stdin action/control）。 */
+	IPC: "NAPUTO_IPC"
 };
 //#endregion
 //#region src/locate-qq.ts

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/instance-lock.ts","../src/launcher.ts","../src/locate-qq.ts"],"sourcesContent":["/**\n * instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）\n *\n * 背景（实测）：同一账号数据目录（~/.napuketto/<uin>）只能被一个实例持有——\n * QQ 原生层（MMKV / 登录单例 / 数据库）有锁，第二个实例抢不到锁会卡在\n * loginService.initConfig 之后无响应（挂起）。此前 create-napukettoqq 生成的\n * 副本实例常驻占锁，导致用户后续启动全部卡死。\n *\n * 方案：以数据目录为粒度加锁文件 `<dataDir>/instance.lock`（JSON 内容：\n * pid / startedAt / cmdline 摘要）。启动前 checkInstanceLock：\n *   - 锁不存在 → 可启动（然后 acquireInstanceLock 写入）\n *   - 锁存在但 PID 已死 → 崩溃残留，自动清理（rm + 重新获取）\n *   - 锁存在且 PID 存活 → 已被占用，拒绝启动（返回占用 PID 供提示）\n *\n * 退出清理：进程正常退出时 releaseInstanceLock 删除锁文件；崩溃/强杀残留\n * 由下次启动的「PID 存活检测」兜底（PID 已死 → 残留视为过期）。\n *\n * 放置说明：放 loader 而非 kernel——self-host.cjs 是 rolldown 内联 bundle\n * （只内联 src/host/ 依赖树），静态 import kernel 会留 external 缺口；\n * 放 loader 则 self-host（内联）与 cli（@napuketto/loader 导入）双入口可用。\n */\n\nimport { readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport process from \"node:process\";\n\n/** 锁文件名（置于数据目录内）。 */\nexport const INSTANCE_LOCK_FILE = \"instance.lock\";\n\n/** 锁文件内容。 */\nexport interface InstanceLockInfo {\n    /** 持有实例的进程 PID。 */\n    pid: number;\n    /** 获取锁的时间（epoch ms）。 */\n    startedAt: number;\n    /** 命令行摘要（诊断用，可选）。 */\n    cmdline?: string;\n}\n\n/** 数据目录锁检查结果。 */\nexport interface InstanceLockCheck {\n    /** 是否被其他实例占用。 */\n    occupied: boolean;\n    /** 占用进程 PID（occupied=true 时有效）。 */\n    pid: number | null;\n    /** 锁文件完整路径（提示/清理用）。 */\n    lockPath: string;\n}\n\n/**\n * 检测指定数据目录是否已被其他实例占用。\n *\n * @param dataDir 数据目录（账号级，如 ~/.napuketto/3567141148）\n */\nexport function checkInstanceLock(dataDir: string): InstanceLockCheck {\n    const lockPath = join(dataDir, INSTANCE_LOCK_FILE);\n    let info: InstanceLockInfo | null = null;\n    try {\n        info = JSON.parse(readFileSync(lockPath, \"utf-8\")) as InstanceLockInfo;\n    } catch {\n        // 文件不存在 / 内容损坏 → 视为可启动（损坏锁由 acquire 覆盖）\n        return { occupied: false, pid: null, lockPath };\n    }\n    if (typeof info.pid !== \"number\" || Number.isNaN(info.pid) || info.pid <= 0) {\n        return { occupied: false, pid: null, lockPath };\n    }\n    // PID 存活判定（Windows 下 process.kill(pid, 0) 探测）\n    let alive = false;\n    try {\n        process.kill(info.pid, 0);\n        alive = true;\n    } catch {\n        alive = false;\n    }\n    if (!alive) {\n        // 崩溃残留：持有者已死，可安全接管\n        return { occupied: false, pid: null, lockPath };\n    }\n    return { occupied: true, pid: info.pid, lockPath };\n}\n\n/**\n * 获取数据目录锁。占用（其他实例存活）返回 false；成功或清理残留后返回 true。\n * 幂等：本进程已持有则直接返回 true（不重复写）。\n */\nexport function acquireInstanceLock(dataDir: string, cmdline?: string): boolean {\n    const { occupied, pid, lockPath } = checkInstanceLock(dataDir);\n    if (occupied) {\n        // 已占用：除非占用者是自己（PID 复用保护），否则拒绝\n        if (pid === process.pid) {\n            return true;\n        }\n        return false;\n    }\n    // 残留锁（持有者已死 / 无锁）：写入\n    const info: InstanceLockInfo = {\n        pid: process.pid,\n        startedAt: Date.now(),\n        ...(cmdline !== undefined && cmdline !== \"\" ? { cmdline } : {}),\n    };\n    try {\n        rmSync(lockPath, { force: true });\n        writeFileSync(lockPath, JSON.stringify(info), \"utf-8\");\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * 释放数据目录锁（正常退出时调用）。仅当持有者是本进程时才删除，\n * 避免误删新持有者的锁（PID 复用 / 快速重启场景）。\n */\nexport function releaseInstanceLock(dataDir: string): void {\n    const lockPath = join(dataDir, INSTANCE_LOCK_FILE);\n    try {\n        const info = JSON.parse(readFileSync(lockPath, \"utf-8\")) as InstanceLockInfo;\n        if (info.pid === process.pid) {\n            rmSync(lockPath, { force: true });\n        }\n    } catch {\n        // 文件不存在 / 内容损坏 → 无需清理\n    }\n}\n\n/** 注册进程退出清理（SIGINT/SIGTERM/exit 均触发；崩溃强杀由残留检测兜底）。 */\nexport function registerLockCleanup(dataDir: string): void {\n    process.on(\"exit\", () => {\n        releaseInstanceLock(dataDir);\n    });\n}\n","/**\n * launcher：自建宿主引导（2026-08-07 唯一路线）——spawn 标准 node 跑 self-host.cjs。\n *\n * 历史（V1/路线 B 事实链，已归档 archive/）：\n *  1. wrapper.node 只能在 QQ 定制版 Electron 里注册（实测纯 Node/普通 Electron 均 self-register 失败）\n *  2. QQ 是打包应用，禁 NODE_OPTIONS（实测 stderr）\n *  → 旧方案：NapukettoBootMain.exe 启动 QQ + 注入 NapukettoWinBootHook.dll（已废弃）\n *  → 现方案：stub QQNT.dll 转发宿主符号 → 标准 node 直接 dlopen wrapper.node（自建宿主）\n */\nimport { type StdioOptions, spawn } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport process from \"node:process\";\nimport { fileURLToPath } from \"node:url\";\nimport type { QqInstallInfo } from \"./locate-qq.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport interface LaunchOptions {\n    /** QQ 安装信息（qqPath/version/wrapperPath）。 */\n    qq: QqInstallInfo;\n    /** kernel 入口（.mjs，self-host.cjs 里 import）。 */\n    kernelEntry: string;\n    /** 配置目录（账号数据目录，NAPUTO_CFG_DIR）。 */\n    cfgDir: string;\n    /** 全局配置文件路径（项目根 napuketto.toml，注入 NAPKETTO_CONFIG 供装配链读取）。 */\n    configPath?: string;\n    /** adapter 入口（.mjs，协议装配用）。 */\n    adapterEntry?: string;\n    /** network 入口（.mjs，协议装配用）。 */\n    networkEntry?: string;\n    /** 自建宿主：标准 node + stub QQNT.dll 直接引导，不拉起 QQ（2026-08-07 唯一路线）。 */\n    selfHost?: boolean;\n    /** stub QQNT.dll 目录（PATH 前置，转发 napi_*、uv_* 符号到 node.exe）。 */\n    stubDir?: string;\n    /** 强制指定快速登录账号（注入 NAPUTO_QUICK_UIN；cli `-q <uin>` 透传，2026-08-07）。 */\n    quickUin?: string;\n    /** 自建宿主入口（默认 dist/host/self-host.cjs）。 */\n    selfHostEntry?: string;\n    /**\n     * 子进程工作目录（缺省继承父进程 cwd）。\n     *\n     * ⚠️ 必须指向数据根（~/.napuketto）：QQ 原生层在账号上下文就绪前会\n     * fallback 到进程 cwd 落盘（如频道库 guild1.db），不指定则污染调用方\n     * 目录（实测写入项目根，guild1.db 08-07）。cli 传 dataRoot 根治。\n     */\n    cwd?: string;\n    /**\n     * 子进程 stdio（默认 \"inherit\"）。cli 传 [\"inherit\",\"pipe\",\"pipe\"] 并接管\n     * 子进程 stdout/stderr：逐行过滤 wrapper 原生噪音（MMKV 刷屏、Node 符号\n     * 查找失败警告），其余转发——原生 printf 直写 fd 的字节无法从 JS 层拦截。\n     */\n    stdio?: StdioOptions;\n}\n\nexport interface LaunchResult {\n    /** 子进程句柄（自建宿主 node 进程）。 */\n    child: ReturnType<typeof spawn>;\n    /** 自建宿主入口路径（self-host.cjs）。 */\n    bootJsPath: string;\n}\n\n/**\n * 启动自建宿主（路线 A，2026-08-07 产品化）：spawn 标准 node 直接跑 self-host.cjs，\n * 不拉起 QQ / 不注入。\n *\n * 关键（HANDOVER-V7 技术数据）：wrapper.node 从 QQNT.dll 导入 99 符号\n * （napi_*×40 + uv_*×56 + qq_magic×1 + v8/node mangled×2）——标准 node 无这些宿主\n * 符号，必须 PATH 前置 stub QQNT.dll 目录（转发到 node.exe）+ QQ resources\\app\n * （wrapper.node 同目录依赖 DLL）才能 dlopen 成功。\n */\nexport function launchSelfHost(options: LaunchOptions): LaunchResult {\n    const selfHostPath =\n        options.selfHostEntry ?? join(__dirname, \"..\", \"dist\", \"host\", \"self-host.cjs\");\n    if (!existsSync(selfHostPath)) {\n        throw new Error(\n            `self-host.cjs 缺失: ${selfHostPath}（先运行 pnpm --filter @napuketto/loader build）`,\n        );\n    }\n\n    // stub QQNT.dll 校验（自建宿主必需：PATH 前置 stub 转发 napi_* 到 node.exe，\n    // 否则 wrapper.node dlopen 失败）。默认 loader 包内闭源 submodule native/stub-test-env，\n    // 缺失时提示 --stub-dir / NAPUTO_STUB_DIR 指定。\n    const stub = options.stubDir ?? defaultStubDir();\n    if (!existsSync(join(stub, \"QQNT.dll\"))) {\n        throw new Error(\n            `stub QQNT.dll 未找到: ${stub}（自建宿主必需：stub 转发 QQNT.dll 符号到 node.exe；` +\n                \"请用 --stub-dir 或环境变量 NAPUTO_STUB_DIR 指定 stub 目录）\",\n        );\n    }\n\n    const env = buildLaunchEnv(options);\n    // PATH 前置 stub 目录（stub QQNT.dll 转发）+ QQ resources\\app（wrapper.node 依赖 DLL）\n    const pathEntries = [stub, dirname(options.qq.wrapperPath), process.env[\"PATH\"] ?? \"\"]\n        .filter((p) => p !== undefined && p !== \"\")\n        .join(\";\");\n    env[\"PATH\"] = pathEntries;\n    env[ENV.STUB_DIR] = stub;\n\n    // 标准 node 直接跑入口（不拉起 QQ，不注入）\n    // cwd 显式指向数据根（cli 传入）：QQ 原生层 fallback 落盘（guild1.db 等）\n    // 不再污染项目根目录（实测 08-07，GPro 模块初始化早于账号上下文）。\n    if (options.cwd !== undefined) {\n        mkdirSync(options.cwd, { recursive: true });\n    }\n    const child = spawn(process.execPath, [selfHostPath], {\n        // exactOptionalPropertyTypes：未传 cwd 时不显式写入 undefined（继承父进程）\n        ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),\n        env,\n        stdio: options.stdio ?? \"inherit\",\n        windowsHide: false,\n    });\n\n    return { child, bootJsPath: selfHostPath };\n}\n\n/**\n * 默认 stub QQNT.dll 目录（loader 包内闭源 native/build/stub-test-env，开发机默认）。\n * src 与 native 同层，构建后 dist 与 native 同层——`../native` 恒正确。\n */\nexport function defaultStubDir(): string {\n    return join(__dirname, \"..\", \"native\", \"build\", \"stub-test-env\");\n}\n\n/** 装配自建宿主环境变量。 */\nfunction buildLaunchEnv(options: LaunchOptions): Record<string, string> {\n    // 配置目录兜底\n    const cfg = resolve(options.cfgDir);\n    mkdirSync(cfg, { recursive: true });\n\n    const env: Record<string, string> = {\n        ...process.env,\n        [ENV.QQ_PATH]: options.qq.qqPath,\n        [ENV.KERNEL_ENTRY]: resolve(options.kernelEntry),\n        [ENV.CFG_DIR]: cfg,\n        [ENV.QQ_VERSION]: options.qq.version,\n        [ENV.WRAPPER_PATH]: options.qq.wrapperPath,\n    };\n    if (options.selfHost === true) {\n        env[ENV.SELF_HOST] = \"1\";\n    }\n    if (options.adapterEntry !== undefined) {\n        env[ENV.ADAPTER_ENTRY] = resolve(options.adapterEntry);\n    }\n    if (options.networkEntry !== undefined) {\n        env[ENV.NETWORK_ENTRY] = resolve(options.networkEntry);\n    }\n    if (options.configPath !== undefined) {\n        env[ENV.CONFIG_PATH] = resolve(options.configPath);\n    }\n    if (options.quickUin !== undefined) {\n        env[ENV.QUICK_UIN] = options.quickUin;\n    }\n    return env;\n}\n\n/** 环境变量名（self-host.cjs 与 kernel 引导读取）。 */\nexport const ENV = {\n    QQ_PATH: \"NAPUTO_QQ_PATH\",\n    KERNEL_ENTRY: \"NAPUTO_KERNEL_ENTRY\",\n    CFG_DIR: \"NAPUTO_CFG_DIR\",\n    QQ_VERSION: \"NAPUTO_QQ_VERSION\",\n    WRAPPER_PATH: \"NAPUTO_WRAPPER_PATH\",\n    /** 自建宿主：标准 node + stub QQNT.dll 引导（self-host.cjs 分支）。 */\n    SELF_HOST: \"NAPUTO_SELF_HOST\",\n    /** stub QQNT.dll 目录（launchSelfHost 注入，self-host.cjs 诊断用）。 */\n    STUB_DIR: \"NAPUTO_STUB_DIR\",\n    /** adapter 包入口（协议装配用）。 */\n    ADAPTER_ENTRY: \"NAPUTO_ADAPTER_ENTRY\",\n    /** network 包入口（协议装配用）。 */\n    NETWORK_ENTRY: \"NAPUTO_NETWORK_ENTRY\",\n    /** 全局配置文件路径（项目根 napuketto.toml，boot-protocols 读取）。 */\n    CONFIG_PATH: \"NAPKETTO_CONFIG\",\n    /** 强制指定快速登录账号（cli `-q <uin>` 透传，bootstrap 登录用）。 */\n    QUICK_UIN: \"NAPUTO_QUICK_UIN\",\n} as const;\n","/**\n * 定位 QQ 安装目录与版本（复用 kernel wrapper-version 的探测逻辑）\n */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, readdirSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport process from \"node:process\";\n\n/** 注册表 UninstallString 查询（QQ 官方安装路径）。 */\nconst REG_QUERY_RE = /\"([^\"]+)\"/;\n\n/** 注册表 UninstallString 查询（QQ 官方安装路径）。 */\nfunction findQqViaRegistry(): string | null {\n    try {\n        const out = execFileSync(\"reg\", [\n            \"query\",\n            \"HKLM\\\\SOFTWARE\\\\WOW6432Node\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Uninstall\\\\QQ\",\n            \"/v\",\n            \"UninstallString\",\n        ]).toString();\n        const m = out.match(REG_QUERY_RE);\n        const exe = m?.[1];\n        if (exe !== undefined) {\n            // UninstallString 形如 \"C:\\...\\uninst.exe\" 或带参数\n            const dir = exe.replaceAll('\"', \"\").slice(0, exe.lastIndexOf(\"\\\\\"));\n            const qq = join(dir, \"QQ.exe\");\n            if (existsSync(qq)) {\n                return qq;\n            }\n        }\n    } catch {\n        // 注册表查询失败，走常见路径\n    }\n    return null;\n}\n\n/** 常见安装路径探测。 */\nfunction findQqViaCommonPaths(): string | null {\n    const localAppData = process.env[\"LOCALAPPDATA\"] ?? \"\";\n    const candidates = [\n        \"C:/Program Files/Tencent/QQNT/QQ.exe\",\n        \"C:/Program Files (x86)/Tencent/QQNT/QQ.exe\",\n        join(localAppData, \"Programs\", \"Tencent\", \"QQNT\", \"QQ.exe\"),\n        // 开发机目录（2026-08-07 环境事实：QQ 9.9.33-51802 在 C:\\Dev\\QQBot-Dev\\QQNT）\n        \"C:/Dev/QQBot-Dev/QQNT/QQ.exe\",\n    ];\n    for (const p of candidates) {\n        if (existsSync(p)) {\n            return p;\n        }\n    }\n    return null;\n}\n\n/** QQ 安装目录探测结果。 */\nexport interface QqInstallInfo {\n    /** QQ.exe 绝对路径。 */\n    qqPath: string;\n    /** 安装根目录。 */\n    installDir: string;\n    /** 当前版本目录名（如 9.9.31-49919）。 */\n    version: string;\n    /** wrapper.node 绝对路径。 */\n    wrapperPath: string;\n}\n\n/** 找 QQ.exe 路径。 */\nexport function locateQqPath(): string {\n    const viaReg = findQqViaRegistry();\n    if (viaReg) {\n        return viaReg;\n    }\n    const viaCommon = findQqViaCommonPaths();\n    if (viaCommon) {\n        return viaCommon;\n    }\n    throw new Error(\"未找到 QQ.exe（请先安装 QQ，或通过 NAPUTO_QQ_PATH 指定）\");\n}\n\n/** 从 QQ.exe 路径推导安装目录，并探测当前版本。 */\nexport function resolveQqInstall(qqPath?: string): QqInstallInfo {\n    const qq = qqPath ?? process.env[\"NAPUTO_QQ_PATH\"] ?? locateQqPath();\n    const installDir = qq.slice(0, qq.lastIndexOf(\"\\\\\"));\n    const versionsDir = join(installDir, \"versions\");\n    if (!existsSync(versionsDir)) {\n        throw new Error(`QQ 版本目录不存在: ${versionsDir}`);\n    }\n    const versions = readdirSync(versionsDir)\n        .filter((v) => statSync(join(versionsDir, v)).isDirectory())\n        .sort()\n        .reverse();\n    const [first] = versions;\n    if (first === undefined) {\n        throw new Error(`QQ 版本目录为空: ${versionsDir}`);\n    }\n    const wrapperPath = join(versionsDir, first, \"resources\", \"app\", \"wrapper.node\");\n    if (!existsSync(wrapperPath)) {\n        throw new Error(`未找到 wrapper.node: ${wrapperPath}`);\n    }\n    return { qqPath: qq, installDir, version: first, wrapperPath };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/instance-lock.ts","../src/launcher.ts","../src/locate-qq.ts"],"sourcesContent":["/**\n * instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）\n *\n * 背景（实测）：同一账号数据目录（~/.napuketto/<uin>）只能被一个实例持有——\n * QQ 原生层（MMKV / 登录单例 / 数据库）有锁，第二个实例抢不到锁会卡在\n * loginService.initConfig 之后无响应（挂起）。此前 create-napukettoqq 生成的\n * 副本实例常驻占锁，导致用户后续启动全部卡死。\n *\n * 方案：以数据目录为粒度加锁文件 `<dataDir>/instance.lock`（JSON 内容：\n * pid / startedAt / cmdline 摘要）。启动前 checkInstanceLock：\n *   - 锁不存在 → 可启动（然后 acquireInstanceLock 写入）\n *   - 锁存在但 PID 已死 → 崩溃残留，自动清理（rm + 重新获取）\n *   - 锁存在且 PID 存活 → 已被占用，拒绝启动（返回占用 PID 供提示）\n *\n * 退出清理：进程正常退出时 releaseInstanceLock 删除锁文件；崩溃/强杀残留\n * 由下次启动的「PID 存活检测」兜底（PID 已死 → 残留视为过期）。\n *\n * 放置说明：放 loader 而非 kernel——self-host.cjs 是 rolldown 内联 bundle\n * （只内联 src/host/ 依赖树），静态 import kernel 会留 external 缺口；\n * 放 loader 则 self-host（内联）与 cli（@napuketto/loader 导入）双入口可用。\n */\n\nimport { readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport process from \"node:process\";\n\n/** 锁文件名（置于数据目录内）。 */\nexport const INSTANCE_LOCK_FILE = \"instance.lock\";\n\n/** 锁文件内容。 */\nexport interface InstanceLockInfo {\n    /** 持有实例的进程 PID。 */\n    pid: number;\n    /** 获取锁的时间（epoch ms）。 */\n    startedAt: number;\n    /** 命令行摘要（诊断用，可选）。 */\n    cmdline?: string;\n}\n\n/** 数据目录锁检查结果。 */\nexport interface InstanceLockCheck {\n    /** 是否被其他实例占用。 */\n    occupied: boolean;\n    /** 占用进程 PID（occupied=true 时有效）。 */\n    pid: number | null;\n    /** 锁文件完整路径（提示/清理用）。 */\n    lockPath: string;\n}\n\n/**\n * 检测指定数据目录是否已被其他实例占用。\n *\n * @param dataDir 数据目录（账号级，如 ~/.napuketto/3567141148）\n */\nexport function checkInstanceLock(dataDir: string): InstanceLockCheck {\n    const lockPath = join(dataDir, INSTANCE_LOCK_FILE);\n    let info: InstanceLockInfo | null = null;\n    try {\n        info = JSON.parse(readFileSync(lockPath, \"utf-8\")) as InstanceLockInfo;\n    } catch {\n        // 文件不存在 / 内容损坏 → 视为可启动（损坏锁由 acquire 覆盖）\n        return { occupied: false, pid: null, lockPath };\n    }\n    if (typeof info.pid !== \"number\" || Number.isNaN(info.pid) || info.pid <= 0) {\n        return { occupied: false, pid: null, lockPath };\n    }\n    // PID 存活判定（Windows 下 process.kill(pid, 0) 探测）\n    let alive = false;\n    try {\n        process.kill(info.pid, 0);\n        alive = true;\n    } catch {\n        alive = false;\n    }\n    if (!alive) {\n        // 崩溃残留：持有者已死，可安全接管\n        return { occupied: false, pid: null, lockPath };\n    }\n    return { occupied: true, pid: info.pid, lockPath };\n}\n\n/**\n * 获取数据目录锁。占用（其他实例存活）返回 false；成功或清理残留后返回 true。\n * 幂等：本进程已持有则直接返回 true（不重复写）。\n */\nexport function acquireInstanceLock(dataDir: string, cmdline?: string): boolean {\n    const { occupied, pid, lockPath } = checkInstanceLock(dataDir);\n    if (occupied) {\n        // 已占用：除非占用者是自己（PID 复用保护），否则拒绝\n        if (pid === process.pid) {\n            return true;\n        }\n        return false;\n    }\n    // 残留锁（持有者已死 / 无锁）：写入\n    const info: InstanceLockInfo = {\n        pid: process.pid,\n        startedAt: Date.now(),\n        ...(cmdline !== undefined && cmdline !== \"\" ? { cmdline } : {}),\n    };\n    try {\n        rmSync(lockPath, { force: true });\n        writeFileSync(lockPath, JSON.stringify(info), \"utf-8\");\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * 释放数据目录锁（正常退出时调用）。仅当持有者是本进程时才删除，\n * 避免误删新持有者的锁（PID 复用 / 快速重启场景）。\n */\nexport function releaseInstanceLock(dataDir: string): void {\n    const lockPath = join(dataDir, INSTANCE_LOCK_FILE);\n    try {\n        const info = JSON.parse(readFileSync(lockPath, \"utf-8\")) as InstanceLockInfo;\n        if (info.pid === process.pid) {\n            rmSync(lockPath, { force: true });\n        }\n    } catch {\n        // 文件不存在 / 内容损坏 → 无需清理\n    }\n}\n\n/** 注册进程退出清理（SIGINT/SIGTERM/exit 均触发；崩溃强杀由残留检测兜底）。 */\nexport function registerLockCleanup(dataDir: string): void {\n    process.on(\"exit\", () => {\n        releaseInstanceLock(dataDir);\n    });\n}\n","/**\n * launcher：自建宿主引导（2026-08-07 唯一路线）——spawn 标准 node 跑 self-host.cjs。\n *\n * 历史（V1/路线 B 事实链，已归档 archive/）：\n *  1. wrapper.node 只能在 QQ 定制版 Electron 里注册（实测纯 Node/普通 Electron 均 self-register 失败）\n *  2. QQ 是打包应用，禁 NODE_OPTIONS（实测 stderr）\n *  → 旧方案：NapukettoBootMain.exe 启动 QQ + 注入 NapukettoWinBootHook.dll（已废弃）\n *  → 现方案：stub QQNT.dll 转发宿主符号 → 标准 node 直接 dlopen wrapper.node（自建宿主）\n */\nimport { type StdioOptions, spawn } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport process from \"node:process\";\nimport { fileURLToPath } from \"node:url\";\nimport type { QqInstallInfo } from \"./locate-qq.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport interface LaunchOptions {\n    /** QQ 安装信息（qqPath/version/wrapperPath）。 */\n    qq: QqInstallInfo;\n    /** kernel 入口（.mjs，self-host.cjs 里 import）。 */\n    kernelEntry: string;\n    /** 配置目录（账号数据目录，NAPUTO_CFG_DIR）。 */\n    cfgDir: string;\n    /** 全局配置文件路径（项目根 napuketto.toml，注入 NAPKETTO_CONFIG 供装配链读取）。 */\n    configPath?: string;\n    /** adapter 入口（.mjs，协议装配用）。 */\n    adapterEntry?: string;\n    /** network 入口（.mjs，协议装配用）。 */\n    networkEntry?: string;\n    /** 自建宿主：标准 node + stub QQNT.dll 直接引导，不拉起 QQ（2026-08-07 唯一路线）。 */\n    selfHost?: boolean;\n    /** stub QQNT.dll 目录（PATH 前置，转发 napi_*、uv_* 符号到 node.exe）。 */\n    stubDir?: string;\n    /** 强制指定快速登录账号（注入 NAPUTO_QUICK_UIN；cli `-q <uin>` 透传，2026-08-07）。 */\n    quickUin?: string;\n    /** IPC 子进程模式（=1：stdout 走 JSON 行协议 + stdin 收 action/control，koishi 插件驱动）。 */\n    ipc?: boolean;\n    /** 自建宿主入口（默认 dist/host/self-host.cjs）。 */\n    selfHostEntry?: string;\n    /**\n     * 子进程工作目录（缺省继承父进程 cwd）。\n     *\n     * ⚠️ 必须指向数据根（~/.napuketto）：QQ 原生层在账号上下文就绪前会\n     * fallback 到进程 cwd 落盘（如频道库 guild1.db），不指定则污染调用方\n     * 目录（实测写入项目根，guild1.db 08-07）。cli 传 dataRoot 根治。\n     */\n    cwd?: string;\n    /**\n     * 子进程 stdio（默认 \"inherit\"）。cli 传 [\"inherit\",\"pipe\",\"pipe\"] 并接管\n     * 子进程 stdout/stderr：逐行过滤 wrapper 原生噪音（MMKV 刷屏、Node 符号\n     * 查找失败警告），其余转发——原生 printf 直写 fd 的字节无法从 JS 层拦截。\n     */\n    stdio?: StdioOptions;\n}\n\nexport interface LaunchResult {\n    /** 子进程句柄（自建宿主 node 进程）。 */\n    child: ReturnType<typeof spawn>;\n    /** 自建宿主入口路径（self-host.cjs）。 */\n    bootJsPath: string;\n}\n\n/**\n * 启动自建宿主（路线 A，2026-08-07 产品化）：spawn 标准 node 直接跑 self-host.cjs，\n * 不拉起 QQ / 不注入。\n *\n * 关键（HANDOVER-V7 技术数据）：wrapper.node 从 QQNT.dll 导入 99 符号\n * （napi_*×40 + uv_*×56 + qq_magic×1 + v8/node mangled×2）——标准 node 无这些宿主\n * 符号，必须 PATH 前置 stub QQNT.dll 目录（转发到 node.exe）+ QQ resources\\app\n * （wrapper.node 同目录依赖 DLL）才能 dlopen 成功。\n */\nexport function launchSelfHost(options: LaunchOptions): LaunchResult {\n    const selfHostPath =\n        options.selfHostEntry ?? join(__dirname, \"..\", \"dist\", \"host\", \"self-host.cjs\");\n    if (!existsSync(selfHostPath)) {\n        throw new Error(\n            `self-host.cjs 缺失: ${selfHostPath}（先运行 pnpm --filter @napuketto/loader build）`,\n        );\n    }\n\n    // stub QQNT.dll 校验（自建宿主必需：PATH 前置 stub 转发 napi_* 到 node.exe，\n    // 否则 wrapper.node dlopen 失败）。默认 loader 包内闭源 submodule native/stub-test-env，\n    // 缺失时提示 --stub-dir / NAPUTO_STUB_DIR 指定。\n    const stub = options.stubDir ?? defaultStubDir();\n    if (!existsSync(join(stub, \"QQNT.dll\"))) {\n        throw new Error(\n            `stub QQNT.dll 未找到: ${stub}（自建宿主必需：stub 转发 QQNT.dll 符号到 node.exe；` +\n                \"请用 --stub-dir 或环境变量 NAPUTO_STUB_DIR 指定 stub 目录）\",\n        );\n    }\n\n    const env = buildLaunchEnv(options);\n    // PATH 前置 stub 目录（stub QQNT.dll 转发）+ QQ resources\\app（wrapper.node 依赖 DLL）\n    const pathEntries = [stub, dirname(options.qq.wrapperPath), process.env[\"PATH\"] ?? \"\"]\n        .filter((p) => p !== undefined && p !== \"\")\n        .join(\";\");\n    env[\"PATH\"] = pathEntries;\n    env[ENV.STUB_DIR] = stub;\n\n    // 标准 node 直接跑入口（不拉起 QQ，不注入）\n    // cwd 显式指向数据根（cli 传入）：QQ 原生层 fallback 落盘（guild1.db 等）\n    // 不再污染项目根目录（实测 08-07，GPro 模块初始化早于账号上下文）。\n    if (options.cwd !== undefined) {\n        mkdirSync(options.cwd, { recursive: true });\n    }\n    const child = spawn(process.execPath, [selfHostPath], {\n        // exactOptionalPropertyTypes：未传 cwd 时不显式写入 undefined（继承父进程）\n        ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),\n        env,\n        stdio: options.stdio ?? \"inherit\",\n        windowsHide: false,\n    });\n\n    return { child, bootJsPath: selfHostPath };\n}\n\n/**\n * 默认 stub QQNT.dll 目录（loader 包内闭源 native/build/stub-test-env，开发机默认）。\n * src 与 native 同层，构建后 dist 与 native 同层——`../native` 恒正确。\n */\nexport function defaultStubDir(): string {\n    return join(__dirname, \"..\", \"native\", \"build\", \"stub-test-env\");\n}\n\n/** 装配自建宿主环境变量。 */\nfunction buildLaunchEnv(options: LaunchOptions): Record<string, string> {\n    // 配置目录兜底\n    const cfg = resolve(options.cfgDir);\n    mkdirSync(cfg, { recursive: true });\n\n    const env: Record<string, string> = {\n        ...process.env,\n        [ENV.QQ_PATH]: options.qq.qqPath,\n        [ENV.KERNEL_ENTRY]: resolve(options.kernelEntry),\n        [ENV.CFG_DIR]: cfg,\n        [ENV.QQ_VERSION]: options.qq.version,\n        [ENV.WRAPPER_PATH]: options.qq.wrapperPath,\n    };\n    if (options.selfHost === true) {\n        env[ENV.SELF_HOST] = \"1\";\n    }\n    if (options.adapterEntry !== undefined) {\n        env[ENV.ADAPTER_ENTRY] = resolve(options.adapterEntry);\n    }\n    if (options.networkEntry !== undefined) {\n        env[ENV.NETWORK_ENTRY] = resolve(options.networkEntry);\n    }\n    if (options.configPath !== undefined) {\n        env[ENV.CONFIG_PATH] = resolve(options.configPath);\n    }\n    if (options.quickUin !== undefined) {\n        env[ENV.QUICK_UIN] = options.quickUin;\n    }\n    if (options.ipc === true) {\n        env[ENV.IPC] = \"1\";\n    }\n    return env;\n}\n\n/** 环境变量名（self-host.cjs 与 kernel 引导读取）。 */\nexport const ENV = {\n    QQ_PATH: \"NAPUTO_QQ_PATH\",\n    KERNEL_ENTRY: \"NAPUTO_KERNEL_ENTRY\",\n    CFG_DIR: \"NAPUTO_CFG_DIR\",\n    QQ_VERSION: \"NAPUTO_QQ_VERSION\",\n    WRAPPER_PATH: \"NAPUTO_WRAPPER_PATH\",\n    /** 自建宿主：标准 node + stub QQNT.dll 引导（self-host.cjs 分支）。 */\n    SELF_HOST: \"NAPUTO_SELF_HOST\",\n    /** stub QQNT.dll 目录（launchSelfHost 注入，self-host.cjs 诊断用）。 */\n    STUB_DIR: \"NAPUTO_STUB_DIR\",\n    /** adapter 包入口（协议装配用）。 */\n    ADAPTER_ENTRY: \"NAPUTO_ADAPTER_ENTRY\",\n    /** network 包入口（协议装配用）。 */\n    NETWORK_ENTRY: \"NAPUTO_NETWORK_ENTRY\",\n    /** 全局配置文件路径（项目根 napuketto.toml，boot-protocols 读取）。 */\n    CONFIG_PATH: \"NAPKETTO_CONFIG\",\n    /** 强制指定快速登录账号（cli `-q <uin>` 透传，bootstrap 登录用）。 */\n    QUICK_UIN: \"NAPUTO_QUICK_UIN\",\n    /** IPC 子进程模式（koishi 插件驱动：stdout JSON 行 + stdin action/control）。 */\n    IPC: \"NAPUTO_IPC\",\n} as const;\n","/**\n * 定位 QQ 安装目录与版本（复用 kernel wrapper-version 的探测逻辑）\n */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, readdirSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport process from \"node:process\";\n\n/** 注册表 UninstallString 查询（QQ 官方安装路径）。 */\nconst REG_QUERY_RE = /\"([^\"]+)\"/;\n\n/** 注册表 UninstallString 查询（QQ 官方安装路径）。 */\nfunction findQqViaRegistry(): string | null {\n    try {\n        const out = execFileSync(\"reg\", [\n            \"query\",\n            \"HKLM\\\\SOFTWARE\\\\WOW6432Node\\\\Microsoft\\\\Windows\\\\CurrentVersion\\\\Uninstall\\\\QQ\",\n            \"/v\",\n            \"UninstallString\",\n        ]).toString();\n        const m = out.match(REG_QUERY_RE);\n        const exe = m?.[1];\n        if (exe !== undefined) {\n            // UninstallString 形如 \"C:\\...\\uninst.exe\" 或带参数\n            const dir = exe.replaceAll('\"', \"\").slice(0, exe.lastIndexOf(\"\\\\\"));\n            const qq = join(dir, \"QQ.exe\");\n            if (existsSync(qq)) {\n                return qq;\n            }\n        }\n    } catch {\n        // 注册表查询失败，走常见路径\n    }\n    return null;\n}\n\n/** 常见安装路径探测。 */\nfunction findQqViaCommonPaths(): string | null {\n    const localAppData = process.env[\"LOCALAPPDATA\"] ?? \"\";\n    const candidates = [\n        \"C:/Program Files/Tencent/QQNT/QQ.exe\",\n        \"C:/Program Files (x86)/Tencent/QQNT/QQ.exe\",\n        join(localAppData, \"Programs\", \"Tencent\", \"QQNT\", \"QQ.exe\"),\n        // 开发机目录（2026-08-07 环境事实：QQ 9.9.33-51802 在 C:\\Dev\\QQBot-Dev\\QQNT）\n        \"C:/Dev/QQBot-Dev/QQNT/QQ.exe\",\n    ];\n    for (const p of candidates) {\n        if (existsSync(p)) {\n            return p;\n        }\n    }\n    return null;\n}\n\n/** QQ 安装目录探测结果。 */\nexport interface QqInstallInfo {\n    /** QQ.exe 绝对路径。 */\n    qqPath: string;\n    /** 安装根目录。 */\n    installDir: string;\n    /** 当前版本目录名（如 9.9.31-49919）。 */\n    version: string;\n    /** wrapper.node 绝对路径。 */\n    wrapperPath: string;\n}\n\n/** 找 QQ.exe 路径。 */\nexport function locateQqPath(): string {\n    const viaReg = findQqViaRegistry();\n    if (viaReg) {\n        return viaReg;\n    }\n    const viaCommon = findQqViaCommonPaths();\n    if (viaCommon) {\n        return viaCommon;\n    }\n    throw new Error(\"未找到 QQ.exe（请先安装 QQ，或通过 NAPUTO_QQ_PATH 指定）\");\n}\n\n/** 从 QQ.exe 路径推导安装目录，并探测当前版本。 */\nexport function resolveQqInstall(qqPath?: string): QqInstallInfo {\n    const qq = qqPath ?? process.env[\"NAPUTO_QQ_PATH\"] ?? locateQqPath();\n    const installDir = qq.slice(0, qq.lastIndexOf(\"\\\\\"));\n    const versionsDir = join(installDir, \"versions\");\n    if (!existsSync(versionsDir)) {\n        throw new Error(`QQ 版本目录不存在: ${versionsDir}`);\n    }\n    const versions = readdirSync(versionsDir)\n        .filter((v) => statSync(join(versionsDir, v)).isDirectory())\n        .sort()\n        .reverse();\n    const [first] = versions;\n    if (first === undefined) {\n        throw new Error(`QQ 版本目录为空: ${versionsDir}`);\n    }\n    const wrapperPath = join(versionsDir, first, \"resources\", \"app\", \"wrapper.node\");\n    if (!existsSync(wrapperPath)) {\n        throw new Error(`未找到 wrapper.node: ${wrapperPath}`);\n    }\n    return { qqPath: qq, installDir, version: first, wrapperPath };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napuketto/loader",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "NapukettoQQ 引导组件：自建宿主（标准 Node + stub QQNT.dll）dlopen wrapper.node 并启动 kernel，不拉起 QQ / 不注入",
   "type": "module",
   "files": [