@napuketto/loader 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,11 @@
+# @napuketto/loader
+
+NapukettoQQ 引导组件——**自建宿主**：标准 Node + stub QQNT.dll 直接 `dlopen` `wrapper.node` 并启动 kernel，不拉起 QQ、不注入。
+
+- **launcher** — 装配环境变量 + PATH 前置 stub + spawn 标准 node
+- **locate-qq** — 定位 QQ 安装与版本
+- **host** — 自建宿主入口（self-host / session / login / protocols / bootstrap / smoke）
+
+## 注意
+
+`native/` 为 Git Submodule（private 仓库 `Oppenheymu/NapukettoQQ-Native`），含 stub QQNT.dll 源码与编译产物。clone 后需 `git submodule update --init --recursive`。

package/dist/host/self-host.cjs

@@ -1,6 +1,134 @@
-let node_path = require("node:path");
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 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_os = require("node:os");
+//#region src/instance-lock.ts
+/**
+* instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）
+*
+* 背景（实测）：同一账号数据目录（~/.napuketto/<uin>）只能被一个实例持有——
+* QQ 原生层（MMKV / 登录单例 / 数据库）有锁，第二个实例抢不到锁会卡在
+* loginService.initConfig 之后无响应（挂起）。此前 create-napukettoqq 生成的
+* 副本实例常驻占锁，导致用户后续启动全部卡死。
+*
+* 方案：以数据目录为粒度加锁文件 `<dataDir>/instance.lock`（JSON 内容：
+* pid / startedAt / cmdline 摘要）。启动前 checkInstanceLock：
+*   - 锁不存在 → 可启动（然后 acquireInstanceLock 写入）
+*   - 锁存在但 PID 已死 → 崩溃残留，自动清理（rm + 重新获取）
+*   - 锁存在且 PID 存活 → 已被占用，拒绝启动（返回占用 PID 供提示）
+*
+* 退出清理：进程正常退出时 releaseInstanceLock 删除锁文件；崩溃/强杀残留
+* 由下次启动的「PID 存活检测」兜底（PID 已死 → 残留视为过期）。
+*
+* 放置说明：放 loader 而非 kernel——self-host.cjs 是 rolldown 内联 bundle
+* （只内联 src/host/ 依赖树），静态 import kernel 会留 external 缺口；
+* 放 loader 则 self-host（内联）与 cli（@napuketto/loader 导入）双入口可用。
+*/
+/** 锁文件名（置于数据目录内）。 */
+const INSTANCE_LOCK_FILE = "instance.lock";
+/**
+* 检测指定数据目录是否已被其他实例占用。
+*
+* @param dataDir 数据目录（账号级，如 ~/.napuketto/3567141148）
+*/
+function checkInstanceLock(dataDir) {
+	const lockPath = (0, node_path.join)(dataDir, INSTANCE_LOCK_FILE);
+	let info = null;
+	try {
+		info = JSON.parse((0, node_fs.readFileSync)(lockPath, "utf-8"));
+	} catch {
+		return {
+			occupied: false,
+			pid: null,
+			lockPath
+		};
+	}
+	if (typeof info.pid !== "number" || Number.isNaN(info.pid) || info.pid <= 0) return {
+		occupied: false,
+		pid: null,
+		lockPath
+	};
+	let alive = false;
+	try {
+		node_process.default.kill(info.pid, 0);
+		alive = true;
+	} catch {
+		alive = false;
+	}
+	if (!alive) return {
+		occupied: false,
+		pid: null,
+		lockPath
+	};
+	return {
+		occupied: true,
+		pid: info.pid,
+		lockPath
+	};
+}
+/**
+* 获取数据目录锁。占用（其他实例存活）返回 false；成功或清理残留后返回 true。
+* 幂等：本进程已持有则直接返回 true（不重复写）。
+*/
+function acquireInstanceLock(dataDir, cmdline) {
+	const { occupied, pid, lockPath } = checkInstanceLock(dataDir);
+	if (occupied) {
+		if (pid === node_process.default.pid) return true;
+		return false;
+	}
+	const info = {
+		pid: node_process.default.pid,
+		startedAt: Date.now(),
+		...cmdline !== void 0 && cmdline !== "" ? { cmdline } : {}
+	};
+	try {
+		(0, node_fs.rmSync)(lockPath, { force: true });
+		(0, node_fs.writeFileSync)(lockPath, JSON.stringify(info), "utf-8");
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* 释放数据目录锁（正常退出时调用）。仅当持有者是本进程时才删除，
+* 避免误删新持有者的锁（PID 复用 / 快速重启场景）。
+*/
+function releaseInstanceLock(dataDir) {
+	const lockPath = (0, node_path.join)(dataDir, INSTANCE_LOCK_FILE);
+	try {
+		if (JSON.parse((0, node_fs.readFileSync)(lockPath, "utf-8")).pid === node_process.default.pid) (0, node_fs.rmSync)(lockPath, { force: true });
+	} catch {}
+}
+/** 注册进程退出清理（SIGINT/SIGTERM/exit 均触发；崩溃强杀由残留检测兜底）。 */
+function registerLockCleanup(dataDir) {
+	node_process.default.on("exit", () => {
+		releaseInstanceLock(dataDir);
+	});
+}
+//#endregion
 //#region src/host/env.ts
 /**
 * env.ts：引导进程环境变量访问层（2026-08-07 阶段 2）。
@@ -60,6 +188,17 @@ function log(msg) {
 function errMsg(e) {
 	return `${e?.message ?? e}`;
 }
+/**
+* 逐条处理消息回调参数（onRecvMsg 为消息数组——2026-08-07 运行时实证；
+* 兼容单条对象，过滤无效项）。
+*/
+function forEachRawMessage(msgs, handler) {
+	const list = Array.isArray(msgs) ? msgs : [msgs];
+	for (const msg of list) {
+		if (!msg || typeof msg !== "object") continue;
+		handler(msg);
+	}
+}
 function createState() {
 	return {
 		wrapperExports: null,
@@ -112,26 +251,99 @@ async function doLogin(core, opts) {
 	}
 }
 //#endregion
-//#region src/host/protocols.ts
+//#region src/host/load-config.ts
 /**
-* protocols.ts：协议装配（登录成功后）。
-* 2026-08-07 阶段 2：由 runtime/boot-protocols.js TS 化（零语义改动）。
-* 动态 import adapter/network 入口，装配 OB11 适配器。
-* 依赖 launcher 注入的 NAPUTO_ADAPTER_ENTRY / NAPUTO_NETWORK_ENTRY。
-*/
-/**
-* 终端 ANSI 颜色（消息日志颜色分层，2026-08-07 用户定稿）：
-* `loader | 接收 <- 群聊` 灰色（背景噪音）/ `[会话]` 青色 / `[发送者]` 绿色 / 内容默认色。
-* 仅 console 版嵌入；boot 文件日志用纯文本版（log），不污染文件。
+* 协议配置段读取（从 protocols.ts 拆分，2026-08-08 FTA 优化）
+*
+* 全局 TOML 配置（<项目根>/napuketto.toml，2026-08-07 用户拍板：配置文件放项目根）：
+* 读 [onebot11] / [satori] 段，装配时 zod 校验后作 seed。路径优先级：NAPKETTO_CONFIG
+* （launcher 注入）> 装配链自身探测（kernel.resolveConfigPath）> NAPUTO_CFG_DIR 兜底
+* （旧行为兼容）。（ConfigBase seed 模式：load() 直接用内存值，不再读写独立协议文件）
 */
+/** 读取全局 TOML 的协议段（读取失败用默认空段，不阻塞装配）。 */
+function loadProtocolSections(kernel) {
+	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;
+	} catch (e) {
+		log(`bootstrap: 全局配置读取失败（用默认 ob11/satori 配置）: ${errMsg(e)}`);
+	}
+	return {
+		cfgFile,
+		ob11Section,
+		satoriSection
+	};
+}
+//#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;
+}
 /**
-* 登录成功后装配协议：kernel 各 Api + network 广播 + OB11 适配器。
+* 消息日志订阅（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。
+*/
+/**
+* 登录成功后装配协议：kernel 各 Api + network 广播 + OB11 / Satori 适配器。
 */
 async function startProtocols(kernel, ctx, loginResult) {
 	const logger = kernel.createLogger?.({
@@ -147,8 +359,10 @@ async function startProtocols(kernel, ctx, loginResult) {
 	try {
 		const network = await import(`file://${networkEntry.replace(/\\/g, "/")}`);
 		const onebot11Entry = adapterEntry.replace(/index\.mjs$/, "onebot11/index.mjs");
+		const satoriEntry = adapterEntry.replace(/index\.mjs$/, "satori/index.mjs");
 		const coreEntry = adapterEntry.replace(/index\.mjs$/, "core/index.mjs");
 		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) {
@@ -157,44 +371,7 @@ async function startProtocols(kernel, ctx, loginResult) {
 		}
 		const channel = new kernel.NTEventChannel("Msg");
 		new kernel.MsgBridge(session, channel).register();
-		channel.on("Msg/onRecvMsg", (msgs) => {
-			const list = Array.isArray(msgs) ? msgs : [msgs];
-			for (const msg of list) {
-				if (!msg || typeof msg !== "object") continue;
-				try {
-					let rendered = "";
-					for (const el of kernel.toCanonicalElements(msg)) if (el.type === "text") rendered += el.text;
-					else if (el.type === "at") {
-						const name = el.display ?? (el.target === "all" ? "全体" : el.target);
-						rendered += `@${name}`;
-					} else if (el.type === "face") rendered += "[表情]";
-					else if (el.type === "image") rendered += "[图片]";
-					else if (el.type === "voice") rendered += "[语音]";
-					else if (el.type === "video") rendered += "[视频]";
-					else if (el.type === "reply") rendered += "[回复]";
-					else if (el.type === "file") rendered += `[文件${el.name ?? ""}]`;
-					else if (el.type === "forward") rendered += "[合并转发]";
-					else if (el.type === "json") rendered += "[json]";
-					else if (el.type === "xml") rendered += "[xml]";
-					if (rendered === "") rendered = "[空消息/媒体]";
-					const isGroup = msg.chatType === kernel.ChatType.GROUP;
-					const kind = isGroup ? "群聊" : "私聊";
-					const peerUin = String(msg.peerUin ?? "");
-					const senderUin = String(msg.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);
-				}
-			}
-		});
+		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) });
@@ -212,15 +389,7 @@ async function startProtocols(kernel, ctx, loginResult) {
 		const profileLikeApi = new kernel.ProfileLikeApi(session);
 		const webApi = new kernel.WebApi({ getCookies: (domain) => ticketApi.getCookies(domain, loginResult.uin) });
 		const broadcaster = new network.EventBroadcaster();
-		let ob11Section = {};
-		const cfgFile = env.NAPKETTO_CONFIG || (0, node_path.join)(env.NAPUTO_CFG_DIR || ".", "napuketto.toml");
-		try {
-			const raw = (0, node_fs.readFileSync)(cfgFile, "utf8");
-			const parsed = kernel.parseToml(raw);
-			if (parsed && typeof parsed["onebot11"] === "object" && parsed["onebot11"] !== null) ob11Section = parsed["onebot11"];
-		} catch (e) {
-			log(`bootstrap: 全局配置读取失败（用默认 ob11 配置）: ${errMsg(e)}`);
-		}
+		const { cfgFile, ob11Section, satoriSection } = loadProtocolSections(kernel);
 		const ob11Config = new adapterCore.ProtocolConfig({
 			path: cfgFile,
 			schema: adapter.ob11ConfigSchema,
@@ -265,6 +434,30 @@ async function startProtocols(kernel, ctx, loginResult) {
 			groupCache
 		}).start();
 		log("bootstrap: onebot11 adapter started");
+		const satoriCacheDir = typeof satoriSection["cacheDir"] === "string" && satoriSection["cacheDir"] !== "" ? satoriSection["cacheDir"] : (0, node_path.join)(env.NAPUTO_CFG_DIR || ".", "cache");
+		const satoriConfig = new adapterCore.ProtocolConfig({
+			path: cfgFile,
+			schema: satoriAdapter.satoriConfigSchema,
+			defaults: satoriAdapter.satoriConfigSchema.parse({}),
+			seed: satoriAdapter.satoriConfigSchema.parse(satoriSection)
+		});
+		await new satoriAdapter.NapukettoSatoriAdapter({
+			config: satoriConfig,
+			broadcaster,
+			msgChannel: channel,
+			msgApi,
+			groupApi,
+			groupNotifyApi,
+			friendApi,
+			profileApi,
+			self: {
+				uin: loginResult.uin,
+				nickname: loginResult.nick
+			},
+			cacheDir: satoriCacheDir,
+			groupCache
+		}).start();
+		log("bootstrap: satori adapter started");
 	} catch (e) {
 		log(`bootstrap: 协议装配失败: ${errMsg(e)}`);
 	}
@@ -434,6 +627,10 @@ function parseSmokeTarget(envPeer, selfUin) {
 		uin: selfUin
 	};
 }
+/** 提取消息纯文本（text 元素拼接，onRecvMsg 与落库核对共用）。 */
+function extractTexts(kernel, msg) {
+	return kernel.toCanonicalElements(msg).filter((el) => el.type === "text").map((el) => el.text).join("");
+}
 /** uin → uid（c2c 目标用；group 直接拿群号作 peerUid）。 */
 async function resolvePeerUid(kernel, ctx, target, selfUid) {
 	const groupApi = new kernel.GroupApi(ctx.session);
@@ -471,18 +668,16 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 	let received = 0;
 	let receivedText = "";
 	channel.on("Msg/onRecvMsg", (msgs) => {
-		const list = Array.isArray(msgs) ? msgs : [msgs];
-		for (const msg of list) {
-			if (!msg || typeof msg !== "object") continue;
+		forEachRawMessage(msgs, (m) => {
 			received += 1;
 			try {
-				const texts = kernel.toCanonicalElements(msg).filter((el) => el.type === "text").map((el) => el.text).join("");
+				const texts = extractTexts(kernel, m);
 				if (texts) receivedText = texts;
 			} catch (e) {
 				log(`smoke: onRecvMsg 解析失败: ${errMsg(e)}`);
 			}
-			log(`smoke: 📥 onRecvMsg 收到 #${received}（msgId=${msg.msgId ?? "?"} seq=${msg.msgSeq ?? "?"} text="${receivedText}"）`);
-		}
+			log(`smoke: 📥 onRecvMsg 收到 #${received}（msgId=${m.msgId ?? "?"} seq=${m.msgSeq ?? "?"} text="${receivedText}"）`);
+		});
 	});
 	const msgApi = new kernel.MsgApi(session);
 	const peer = await resolvePeerUid(kernel, ctx, target, loginResult.uid);
@@ -504,10 +699,7 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 		const recent = await msgApi.fetchMessages(peer, { count: 10 });
 		landed = recent.some((m) => m.msgId === sentMsgId || m.msgSeq === sentMsgId);
 		log(`smoke: 落库验证: 最近 ${recent.length} 条${landed ? " ✅ 含刚发消息" : " ❌ 未找到（可能同步延迟）"}`);
-		if (!landed) for (const m of recent.slice(0, 3)) {
-			const texts = kernel.toCanonicalElements(m).filter((el) => el.type === "text").map((el) => el.text).join("");
-			log(`smoke:   最近消息 msgId=${m.msgId} seq=${m.msgSeq} text="${texts}"`);
-		}
+		if (!landed) for (const m of recent.slice(0, 3)) log(`smoke:   最近消息 msgId=${m.msgId} seq=${m.msgSeq} text="${extractTexts(kernel, m)}"`);
 	} catch (e) {
 		log(`smoke: 落库验证失败: ${errMsg(e)}`);
 	}
@@ -522,6 +714,146 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 	return ok;
 }
 //#endregion
+//#region src/host/bootstrap-core.ts
+/**
+* bootstrap-core.ts：NapukettoCore 装配路径（从 bootstrap.ts 拆分，2026-08-08 FTA 优化）。
+*
+* NapukettoCore.create → attachWrapper → 登录（pickLoginAccount + doLogin）→
+* session 替换/激活 → 就绪等待 → 冒烟自检 → 协议装配 → 探测模式。
+*/
+/** 探测：create() 与捕获的 QQ session 关系（确认 create() 是否干扰 QQ）。 */
+function probeCreatedSession(state, ctx) {
+	try {
+		const S2 = state.wrapperExports?.["NodeIQQNTWrapperSession"];
+		const created = S2 && typeof S2.create === "function" ? S2.create() : null;
+		log(`BOOT: create()===qqSession? ${created === state.qqSession} | create()===ctx.session? ${created === ctx.session} | qqSession===ctx.session? ${state.qqSession === ctx.session}`);
+		const sess = created;
+		const svc = sess && typeof sess.getMsgService === "function" ? sess.getMsgService() : null;
+		const qs = state.qqSession;
+		log(`BOOT: create().getMsgService=${svc !== null && svc !== void 0 ? "ready" : "null"} qqSession.getMsgService=${qs && typeof qs.getMsgService === "function" && qs.getMsgService() !== null && qs.getMsgService() !== void 0 ? "ready" : "null"}`);
+	} catch (e) {
+		log(`BOOT: create() 探测失败: ${errMsg(e)}`);
+	}
+}
+/** 登录参数（NAPUTO_QUICK_UIN 强制指定 / ref 目标 / 默认）。 */
+function buildLoginOpts(Appid, forcedUin, ref) {
+	const quickUin = forcedUin ?? ref.targetUin;
+	return {
+		appid: Appid,
+		initTimeoutMs: 2e4,
+		...quickUin !== void 0 ? { quickUin } : {}
+	};
+}
+/** V2 登录后替换 session：优先 QQ 主 session，其次 vehicle 单例表；自建宿主例外。 */
+function replaceSession(kernel, core, state, ctx) {
+	if (env.NAPUTO_SELF_HOST === "1") return null;
+	const chosen = pickBestSession(collectCandidateSessions(state, kernel, ctx));
+	if (chosen && chosen.s !== ctx.session) {
+		core.setSession(chosen.s);
+		log(`bootstrap: 已替换 session（来源=${chosen.tag}，msgSvc=${isSessionUsable(chosen.s) ? "READY" : "null"}）`);
+	} else if (chosen) log(`bootstrap: 候选 session 与 ctx.session 相同（${chosen.tag}）`);
+	else log("bootstrap: 无有效候选 session（保留 kernel 自建 session）");
+	return chosen;
+}
+/**
+* 激活目标 session（先 init 后 startupSession.start，HANDOVER-V6 三要素）。
+* 自建宿主无候选时对 kernel 自建 session 走 NapCat 激活。
+*/
+async function activateSession(kernel, state, ctx, chosen, loginResult, Appid, bootEnv) {
+	const activateTarget = chosen ?? {
+		s: ctx.session,
+		tag: "kernel 自建 session"
+	};
+	if (!activateTarget.s || isSessionUsable(activateTarget.s)) return;
+	log(`bootstrap: 激活 session（${activateTarget.tag}，先 init 后 startupSession.start）...`);
+	try {
+		const qqDataRoot = typeof kernel.resolveQqUserDataRoot === "function" ? kernel.resolveQqUserDataRoot(state.wrapperExports) : null;
+		const accountPath = qqDataRoot && typeof kernel.resolveQqGlobalPath === "function" ? kernel.resolveQqGlobalPath(qqDataRoot) : bootEnv.dataDir || ".";
+		const sessionConfig = kernel.buildSessionConfig({
+			appid: Appid,
+			fullVersion: bootEnv.qqVersion || "",
+			selfUin: loginResult.uin,
+			selfUid: loginResult.uid,
+			accountPath,
+			downloadPath: (0, node_path.join)(accountPath, "NapCat", "temp")
+		});
+		const listener = kernel.createLifecycleSessionListener();
+		await kernel.initAndStartSession(ctx, sessionConfig, listener, { timeoutMs: 2e4 });
+		log("bootstrap: 激活 session init + start 完成");
+	} catch (initErr) {
+		log(`bootstrap: 激活 session init 失败: ${errMsg(initErr)}`);
+	}
+}
+/** 等 session 就绪（getMsgService 非 null）——init 完成后才有。 */
+async function waitSessionReady(kernel, ctx) {
+	try {
+		await kernel.waitSessionReady(ctx, { timeoutMs: 3e4 });
+		log("bootstrap: QQ session 就绪（getMsgService 可用）");
+	} catch (readyErr) {
+		log(`bootstrap: 等待 session 就绪失败: ${errMsg(readyErr)}`);
+	}
+}
+/** P2-1 收发消息冒烟自检（NAPUTO_SMOKE=1）：MsgBridge + MsgApi 真发/收一条。 */
+async function runSmokeIfEnabled(kernel, ctx, loginResult) {
+	if (env.NAPUTO_SMOKE !== "1") return;
+	try {
+		log(`bootstrap: 冒烟自检${await runSmokeTest(kernel, ctx, loginResult) ? "通过" : "未完全通过"}（见上文 smoke 日志）`);
+	} catch (smokeErr) {
+		log(`bootstrap: 冒烟自检异常: ${errMsg(smokeErr)}`);
+	}
+}
+/** 探测模式（NAPUTO_PROBE=1）：立即探测 + 35s 后晚探测（napuketto-probe-late.json）。 */
+function runProbePhase(kernel, ctx) {
+	if (env.NAPUTO_PROBE !== "1" || typeof kernel.probeRuntime !== "function") return;
+	try {
+		const probe = kernel.probeRuntime(ctx);
+		log(`bootstrap: probe done, session=${probe.session ? "ok" : "null"}, services=${Object.keys(probe.services ?? {}).length}`);
+		setTimeout(() => {
+			try {
+				if (typeof kernel.probeRuntime !== "function") return;
+				const late = kernel.probeRuntime(ctx, "napuketto-probe-late.json");
+				log(`bootstrap: probe-late done, session=${late.session ? "ok" : "null"}, services=${Object.keys(late.services ?? {}).length}`);
+			} catch (e2) {
+				log(`bootstrap: probe-late error: ${errMsg(e2)}`);
+			}
+		}, 35e3);
+	} catch (e) {
+		log(`bootstrap: probe error: ${errMsg(e)}`);
+	}
+}
+/** NapukettoCore 装配路径：create → attachWrapper → 登录 → 激活 → 协议 → 探测。 */
+async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
+	const coreCtor = kernel.NapukettoCore;
+	if (coreCtor === void 0) return;
+	const core = coreCtor.create({
+		paths: { dataRoot: bootEnv.dataDir },
+		logLevel: "info"
+	});
+	const ctx = core.attachWrapper(state.wrapperExports, { ...bootEnv });
+	log(`bootstrap: attachWrapper OK, engine=${typeof ctx.engine}, session=${ctx.session !== null}`);
+	probeCreatedSession(state, ctx);
+	startSessionProbe(state, ctx);
+	probeSessionMethods(ctx);
+	if (typeof core.login !== "function") {
+		log("bootstrap: kernel core missing login fn");
+		return;
+	}
+	const forcedUin = env.NAPUTO_QUICK_UIN;
+	const ref = { targetUin: void 0 };
+	await pickLoginAccount(kernel, ctx, ref, forcedUin);
+	const loginResult = await doLogin(core, buildLoginOpts(Appid, forcedUin, ref));
+	if (loginResult === null) {
+		log("bootstrap: 登录失败，引导中止");
+		return;
+	}
+	log(`bootstrap: 登录成功 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);
+	await runSmokeIfEnabled(kernel, ctx, loginResult);
+	await startProtocols(kernel, ctx, loginResult);
+	runProbePhase(kernel, ctx);
+}
+//#endregion
 //#region src/host/bootstrap.ts
 /**
 * bootstrap.ts：kernel 引导核心（import kernel → 装配 → 登录 → session 替换 → 协议装配）。
@@ -532,6 +864,7 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 *  - 登录流程（选账号 / 快速登录 / QR 回退）→ login.ts
 *  - session 选择 / 探测 / 就绪 → session.ts
 *  - 协议装配 → protocols.ts；冒烟自检 → smoke.ts
+* 2026-08-08 FTA 优化：NapukettoCore 装配路径 → bootstrap-core.ts（本文件留入口 + fallback）。
 *
 * session 来源（2026-08-07 实测结论；V1 Proxy 捕获与 vehicle 载具已归档 archive/）：
 *  登录成功后按优先级取 session：
@@ -540,6 +873,52 @@ async function runSmokeTest(kernel, ctx, loginResult) {
 *    ② get() / qqSession（V1 兼容）
 *  取到后 core.setSession 替换 → waitSessionReady 确认 getMsgService READY。
 */
+/** ⭐ appid 动态解析（2026-08-06 P2-0 实测：硬编码 537237765 在 9.9.33 扫码失败
+* 「请下载最新版」；major.node 解析的 537376818 成功）。自研，参考 NapCat 思路。 */
+function resolveAppid(kernel, bootEnv) {
+	return typeof kernel.parseAppidFromMajor === "function" && bootEnv.wrapperPath && kernel.parseAppidFromMajor((0, node_path.join)((0, node_path.dirname)(bootEnv.wrapperPath), "major.node")) || typeof kernel.resolveAppidQua === "function" && kernel.resolveAppidQua(bootEnv.qqVersion || "").appid || "537237765";
+}
+/** 回退：旧装配路径（startNapuketto + 手工 lifecycle）。 */
+async function bootstrapFallback(kernel, state, bootEnv, Appid) {
+	log("bootstrap: kernel has no NapukettoCore, falling back");
+	const ctx = kernel.startNapuketto?.({
+		wrapperExports: state.wrapperExports,
+		env: { ...bootEnv }
+	});
+	if (ctx === void 0) {
+		log("bootstrap: startNapuketto 不可用");
+		return;
+	}
+	log(`bootstrap: startNapuketto OK, engine=${typeof ctx.engine}, session=${ctx.session !== null}`);
+	if (typeof kernel.quickLogin === "function" && typeof kernel.initAndStartSession === "function") {
+		if (typeof kernel.buildLoginConfig === "function" && ctx.loginService) {
+			const loginCfg = kernel.buildLoginConfig(Appid, bootEnv.qqVersion || "", bootEnv.dataDir || ".");
+			if (typeof ctx.loginService.initConfig === "function") {
+				ctx.loginService.initConfig(loginCfg);
+				log("bootstrap: loginService.initConfig OK");
+			}
+		}
+		const loginResult = await kernel.quickLogin(ctx, {});
+		log(`bootstrap: quickLogin OK, uin=${loginResult.uin}, uid=${loginResult.uid}`);
+		const sessionConfig = kernel.buildSessionConfig({
+			appid: Appid,
+			fullVersion: bootEnv.qqVersion || "",
+			selfUin: loginResult.uin,
+			selfUid: loginResult.uid,
+			accountPath: bootEnv.dataDir || ".",
+			downloadPath: (0, node_path.join)(bootEnv.dataDir || ".", "temp")
+		});
+		const listener = kernel.createLifecycleSessionListener();
+		await kernel.initAndStartSession(ctx, sessionConfig, listener, { timeoutMs: 2e4 });
+		log("bootstrap: session init + startNT OK!");
+	} else log("bootstrap: kernel missing lifecycle fns (quickLogin/initAndStartSession)");
+	if (env.NAPUTO_PROBE === "1" && typeof kernel.probeRuntime === "function") try {
+		const probe = kernel.probeRuntime(ctx);
+		log(`bootstrap: probe done, session=${probe.session ? "ok" : "null"}, services=${Object.keys(probe.services ?? {}).length}`);
+	} catch (e) {
+		log(`bootstrap: probe error: ${errMsg(e)}`);
+	}
+}
 /** 核心引导：import kernel → 装配 → 登录 → 替换 session → 等待就绪 → 协议装配。 */
 async function bootstrap(state) {
 	const kernelEntry = env.NAPUTO_KERNEL_ENTRY;
@@ -555,148 +934,15 @@ async function bootstrap(state) {
 			return;
 		}
 		const bootEnv = {
-			qqVersion: env.NAPUTO_QQ_VERSION,
-			dataDir: env.NAPUTO_CFG_DIR,
-			wrapperPath: env.NAPUTO_WRAPPER_PATH
+			qqVersion: env.NAPUTO_QQ_VERSION || "",
+			dataDir: env.NAPUTO_CFG_DIR || "",
+			wrapperPath: env.NAPUTO_WRAPPER_PATH || ""
 		};
-		const Appid = typeof kernel.parseAppidFromMajor === "function" && bootEnv.wrapperPath && kernel.parseAppidFromMajor((0, node_path.join)((0, node_path.dirname)(bootEnv.wrapperPath), "major.node")) || typeof kernel.resolveAppidQua === "function" && kernel.resolveAppidQua(bootEnv.qqVersion || "").appid || "537237765";
+		const Appid = resolveAppid(kernel, bootEnv);
 		log(`bootstrap: appid=${Appid}（wrapper=${bootEnv.wrapperPath}）`);
 		try {
-			if (kernel.NapukettoCore !== void 0) {
-				const core = kernel.NapukettoCore.create({
-					paths: { dataRoot: bootEnv.dataDir },
-					logLevel: "info"
-				});
-				const ctx = core.attachWrapper(state.wrapperExports, bootEnv);
-				log(`bootstrap: attachWrapper OK, engine=${typeof ctx.engine}, session=${ctx.session !== null}`);
-				try {
-					const S2 = state.wrapperExports?.["NodeIQQNTWrapperSession"];
-					const created = S2 && typeof S2.create === "function" ? S2.create() : null;
-					log(`BOOT: create()===qqSession? ${created === state.qqSession} | create()===ctx.session? ${created === ctx.session} | qqSession===ctx.session? ${state.qqSession === ctx.session}`);
-					const sess = created;
-					const svc = sess && typeof sess.getMsgService === "function" ? sess.getMsgService() : null;
-					const qs = state.qqSession;
-					log(`BOOT: create().getMsgService=${svc !== null && svc !== void 0 ? "ready" : "null"} qqSession.getMsgService=${qs && typeof qs.getMsgService === "function" && qs.getMsgService() !== null && qs.getMsgService() !== void 0 ? "ready" : "null"}`);
-				} catch (e) {
-					log(`BOOT: create() 探测失败: ${errMsg(e)}`);
-				}
-				startSessionProbe(state, ctx);
-				probeSessionMethods(ctx);
-				let loginResult = null;
-				if (typeof core.login === "function") {
-					const forcedUin = env.NAPUTO_QUICK_UIN;
-					const ref = { targetUin: void 0 };
-					await pickLoginAccount(kernel, ctx, ref, forcedUin);
-					loginResult = await doLogin(core, {
-						appid: Appid,
-						initTimeoutMs: 2e4,
-						...forcedUin ? { quickUin: forcedUin } : ref.targetUin !== void 0 ? { quickUin: ref.targetUin } : {}
-					});
-					if (loginResult === null) {
-						log("bootstrap: 登录失败，引导中止");
-						return;
-					}
-					log(`bootstrap: 登录成功 uin=${loginResult.uin} uid=${loginResult.uid} nick=${loginResult.nick}`);
-					const isSelfHost = env.NAPUTO_SELF_HOST === "1";
-					let chosen = null;
-					if (!isSelfHost) chosen = pickBestSession(collectCandidateSessions(state, kernel, ctx));
-					if (chosen && chosen.s !== ctx.session) {
-						core.setSession(chosen.s);
-						log(`bootstrap: 已替换 session（来源=${chosen.tag}，msgSvc=${isSessionUsable(chosen.s) ? "READY" : "null"}）`);
-					} else if (chosen) log(`bootstrap: 候选 session 与 ctx.session 相同（${chosen.tag}）`);
-					else log("bootstrap: 无有效候选 session（保留 kernel 自建 session）");
-					const activateTarget = chosen ?? {
-						s: ctx.session,
-						tag: "kernel 自建 session"
-					};
-					if (activateTarget.s && !isSessionUsable(activateTarget.s)) {
-						log(`bootstrap: 激活 session（${activateTarget.tag}，先 init 后 startupSession.start）...`);
-						try {
-							const qqDataRoot = typeof kernel.resolveQqUserDataRoot === "function" ? kernel.resolveQqUserDataRoot(state.wrapperExports) : null;
-							const accountPath = qqDataRoot && typeof kernel.resolveQqGlobalPath === "function" ? kernel.resolveQqGlobalPath(qqDataRoot) : bootEnv.dataDir || ".";
-							const sessionConfig = kernel.buildSessionConfig({
-								appid: Appid,
-								fullVersion: bootEnv.qqVersion || "",
-								selfUin: loginResult.uin,
-								selfUid: loginResult.uid,
-								accountPath,
-								downloadPath: (0, node_path.join)(accountPath, "NapCat", "temp")
-							});
-							const listener = kernel.createLifecycleSessionListener();
-							await kernel.initAndStartSession(ctx, sessionConfig, listener, { timeoutMs: 2e4 });
-							log("bootstrap: 激活 session init + start 完成");
-						} catch (initErr) {
-							log(`bootstrap: 激活 session init 失败: ${errMsg(initErr)}`);
-						}
-					}
-					try {
-						await kernel.waitSessionReady(ctx, { timeoutMs: 3e4 });
-						log("bootstrap: QQ session 就绪（getMsgService 可用）");
-					} catch (readyErr) {
-						log(`bootstrap: 等待 session 就绪失败: ${errMsg(readyErr)}`);
-					}
-					if (env.NAPUTO_SMOKE === "1" && loginResult !== null) try {
-						log(`bootstrap: 冒烟自检${await runSmokeTest(kernel, ctx, loginResult) ? "通过" : "未完全通过"}（见上文 smoke 日志）`);
-					} catch (smokeErr) {
-						log(`bootstrap: 冒烟自检异常: ${errMsg(smokeErr)}`);
-					}
-				} else log("bootstrap: kernel core missing login fn");
-				if (loginResult !== null) await startProtocols(kernel, ctx, loginResult);
-				if (env.NAPUTO_PROBE === "1" && typeof kernel.probeRuntime === "function") try {
-					const probe = kernel.probeRuntime(ctx);
-					log(`bootstrap: probe done, session=${probe.session ? "ok" : "null"}, services=${Object.keys(probe.services ?? {}).length}`);
-					setTimeout(() => {
-						try {
-							if (typeof kernel.probeRuntime !== "function") return;
-							const late = kernel.probeRuntime(ctx, "napuketto-probe-late.json");
-							log(`bootstrap: probe-late done, session=${late.session ? "ok" : "null"}, services=${Object.keys(late.services ?? {}).length}`);
-						} catch (e2) {
-							log(`bootstrap: probe-late error: ${errMsg(e2)}`);
-						}
-					}, 35e3);
-				} catch (e) {
-					log(`bootstrap: probe error: ${errMsg(e)}`);
-				}
-			} else {
-				log("bootstrap: kernel has no NapukettoCore, falling back");
-				const ctx = kernel.startNapuketto?.({
-					wrapperExports: state.wrapperExports,
-					env: bootEnv
-				});
-				if (ctx === void 0) {
-					log("bootstrap: startNapuketto 不可用");
-					return;
-				}
-				log(`bootstrap: startNapuketto OK, engine=${typeof ctx.engine}, session=${ctx.session !== null}`);
-				if (typeof kernel.quickLogin === "function" && typeof kernel.initAndStartSession === "function") {
-					if (typeof kernel.buildLoginConfig === "function" && ctx.loginService) {
-						const loginCfg = kernel.buildLoginConfig(Appid, bootEnv.qqVersion || "", bootEnv.dataDir || ".");
-						if (typeof ctx.loginService.initConfig === "function") {
-							ctx.loginService.initConfig(loginCfg);
-							log("bootstrap: loginService.initConfig OK");
-						}
-					}
-					const loginResult = await kernel.quickLogin(ctx, {});
-					log(`bootstrap: quickLogin OK, uin=${loginResult.uin}, uid=${loginResult.uid}`);
-					const sessionConfig = kernel.buildSessionConfig({
-						appid: Appid,
-						fullVersion: bootEnv.qqVersion || "",
-						selfUin: loginResult.uin,
-						selfUid: loginResult.uid,
-						accountPath: bootEnv.dataDir || ".",
-						downloadPath: (0, node_path.join)(bootEnv.dataDir || ".", "temp")
-					});
-					const listener = kernel.createLifecycleSessionListener();
-					await kernel.initAndStartSession(ctx, sessionConfig, listener, { timeoutMs: 2e4 });
-					log("bootstrap: session init + startNT OK!");
-				} else log("bootstrap: kernel missing lifecycle fns (quickLogin/initAndStartSession)");
-				if (env.NAPUTO_PROBE === "1" && typeof kernel.probeRuntime === "function") try {
-					const probe = kernel.probeRuntime(ctx);
-					log(`bootstrap: probe done, session=${probe.session ? "ok" : "null"}, services=${Object.keys(probe.services ?? {}).length}`);
-				} catch (e) {
-					log(`bootstrap: probe error: ${errMsg(e)}`);
-				}
-			}
+			if (kernel.NapukettoCore !== void 0) await bootstrapWithCore(kernel, state, bootEnv, Appid);
+			else await bootstrapFallback(kernel, state, bootEnv, Appid);
 		} catch (e) {
 			log(`bootstrap: lifecycle error: ${errMsg(e)}`);
 		}
@@ -732,6 +978,16 @@ async function bootstrap(state) {
 const state = createState();
 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;
+if (lockDataDir) {
+	if (!acquireInstanceLock(lockDataDir)) {
+		const { pid: holderPid } = checkInstanceLock(lockDataDir);
+		log(`[self-host] ❌ 数据目录已被其他实例占用（pid=${holderPid ?? "?"}），退出；同一账号数据目录仅允许一个实例，请先停止已有实例`);
+		process.exit(1);
+	}
+	registerLockCleanup(lockDataDir);
+	log(`[self-host] ✅ 已获取数据目录锁（${lockDataDir}）`);
+} else log("[self-host] ⚠️ NAPUTO_CFG_DIR 未设置，跳过单实例锁");
 const wrapperPath = env.NAPUTO_WRAPPER_PATH;
 if (!wrapperPath) {
 	log("[self-host] NAPUTO_WRAPPER_PATH 未设置，退出");

package/dist/index.d.mts

@@ -1,4 +1,65 @@
 import { StdioOptions, spawn } from "node:child_process";
+//#region src/instance-lock.d.ts
+/**
+ * instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）
+ *
+ * 背景（实测）：同一账号数据目录（~/.napuketto/<uin>）只能被一个实例持有——
+ * QQ 原生层（MMKV / 登录单例 / 数据库）有锁，第二个实例抢不到锁会卡在
+ * loginService.initConfig 之后无响应（挂起）。此前 create-napukettoqq 生成的
+ * 副本实例常驻占锁，导致用户后续启动全部卡死。
+ *
+ * 方案：以数据目录为粒度加锁文件 `<dataDir>/instance.lock`（JSON 内容：
+ * pid / startedAt / cmdline 摘要）。启动前 checkInstanceLock：
+ *   - 锁不存在 → 可启动（然后 acquireInstanceLock 写入）
+ *   - 锁存在但 PID 已死 → 崩溃残留，自动清理（rm + 重新获取）
+ *   - 锁存在且 PID 存活 → 已被占用，拒绝启动（返回占用 PID 供提示）
+ *
+ * 退出清理：进程正常退出时 releaseInstanceLock 删除锁文件；崩溃/强杀残留
+ * 由下次启动的「PID 存活检测」兜底（PID 已死 → 残留视为过期）。
+ *
+ * 放置说明：放 loader 而非 kernel——self-host.cjs 是 rolldown 内联 bundle
+ * （只内联 src/host/ 依赖树），静态 import kernel 会留 external 缺口；
+ * 放 loader 则 self-host（内联）与 cli（@napuketto/loader 导入）双入口可用。
+ */
+/** 锁文件名（置于数据目录内）。 */
+declare const INSTANCE_LOCK_FILE = "instance.lock";
+/** 锁文件内容。 */
+interface InstanceLockInfo {
+  /** 持有实例的进程 PID。 */
+  pid: number;
+  /** 获取锁的时间（epoch ms）。 */
+  startedAt: number;
+  /** 命令行摘要（诊断用，可选）。 */
+  cmdline?: string;
+}
+/** 数据目录锁检查结果。 */
+interface InstanceLockCheck {
+  /** 是否被其他实例占用。 */
+  occupied: boolean;
+  /** 占用进程 PID（occupied=true 时有效）。 */
+  pid: number | null;
+  /** 锁文件完整路径（提示/清理用）。 */
+  lockPath: string;
+}
+/**
+ * 检测指定数据目录是否已被其他实例占用。
+ *
+ * @param dataDir 数据目录（账号级，如 ~/.napuketto/3567141148）
+ */
+declare function checkInstanceLock(dataDir: string): InstanceLockCheck;
+/**
+ * 获取数据目录锁。占用（其他实例存活）返回 false；成功或清理残留后返回 true。
+ * 幂等：本进程已持有则直接返回 true（不重复写）。
+ */
+declare function acquireInstanceLock(dataDir: string, cmdline?: string): boolean;
+/**
+ * 释放数据目录锁（正常退出时调用）。仅当持有者是本进程时才删除，
+ * 避免误删新持有者的锁（PID 复用 / 快速重启场景）。
+ */
+declare function releaseInstanceLock(dataDir: string): void;
+/** 注册进程退出清理（SIGINT/SIGTERM/exit 均触发；崩溃强杀由残留检测兜底）。 */
+declare function registerLockCleanup(dataDir: string): void;
+//#endregion
 //#region src/locate-qq.d.ts
 /** QQ 安装目录探测结果。 */
 interface QqInstallInfo {
@@ -95,5 +156,5 @@ declare const ENV: {
   readonly QUICK_UIN: "NAPUTO_QUICK_UIN";
 };
 //#endregion
-export { ENV, type LaunchOptions, type LaunchResult, type QqInstallInfo, defaultStubDir, launchSelfHost, locateQqPath, resolveQqInstall };
+export { ENV, INSTANCE_LOCK_FILE, type InstanceLockCheck, type InstanceLockInfo, type LaunchOptions, type LaunchResult, type QqInstallInfo, acquireInstanceLock, checkInstanceLock, defaultStubDir, launchSelfHost, locateQqPath, registerLockCleanup, releaseInstanceLock, resolveQqInstall };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/locate-qq.ts","../src/launcher.ts"],"mappings":";;;UAuDiB;;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;;;;;;;;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"}

package/dist/index.mjs

@@ -1,8 +1,112 @@
-import { execFileSync, spawn } from "node:child_process";
-import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import process from "node:process";
+import { execFileSync, spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
+//#region src/instance-lock.ts
+/**
+* instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）
+*
+* 背景（实测）：同一账号数据目录（~/.napuketto/<uin>）只能被一个实例持有——
+* QQ 原生层（MMKV / 登录单例 / 数据库）有锁，第二个实例抢不到锁会卡在
+* loginService.initConfig 之后无响应（挂起）。此前 create-napukettoqq 生成的
+* 副本实例常驻占锁，导致用户后续启动全部卡死。
+*
+* 方案：以数据目录为粒度加锁文件 `<dataDir>/instance.lock`（JSON 内容：
+* pid / startedAt / cmdline 摘要）。启动前 checkInstanceLock：
+*   - 锁不存在 → 可启动（然后 acquireInstanceLock 写入）
+*   - 锁存在但 PID 已死 → 崩溃残留，自动清理（rm + 重新获取）
+*   - 锁存在且 PID 存活 → 已被占用，拒绝启动（返回占用 PID 供提示）
+*
+* 退出清理：进程正常退出时 releaseInstanceLock 删除锁文件；崩溃/强杀残留
+* 由下次启动的「PID 存活检测」兜底（PID 已死 → 残留视为过期）。
+*
+* 放置说明：放 loader 而非 kernel——self-host.cjs 是 rolldown 内联 bundle
+* （只内联 src/host/ 依赖树），静态 import kernel 会留 external 缺口；
+* 放 loader 则 self-host（内联）与 cli（@napuketto/loader 导入）双入口可用。
+*/
+/** 锁文件名（置于数据目录内）。 */
+const INSTANCE_LOCK_FILE = "instance.lock";
+/**
+* 检测指定数据目录是否已被其他实例占用。
+*
+* @param dataDir 数据目录（账号级，如 ~/.napuketto/3567141148）
+*/
+function checkInstanceLock(dataDir) {
+	const lockPath = join(dataDir, INSTANCE_LOCK_FILE);
+	let info = null;
+	try {
+		info = JSON.parse(readFileSync(lockPath, "utf-8"));
+	} catch {
+		return {
+			occupied: false,
+			pid: null,
+			lockPath
+		};
+	}
+	if (typeof info.pid !== "number" || Number.isNaN(info.pid) || info.pid <= 0) return {
+		occupied: false,
+		pid: null,
+		lockPath
+	};
+	let alive = false;
+	try {
+		process.kill(info.pid, 0);
+		alive = true;
+	} catch {
+		alive = false;
+	}
+	if (!alive) return {
+		occupied: false,
+		pid: null,
+		lockPath
+	};
+	return {
+		occupied: true,
+		pid: info.pid,
+		lockPath
+	};
+}
+/**
+* 获取数据目录锁。占用（其他实例存活）返回 false；成功或清理残留后返回 true。
+* 幂等：本进程已持有则直接返回 true（不重复写）。
+*/
+function acquireInstanceLock(dataDir, cmdline) {
+	const { occupied, pid, lockPath } = checkInstanceLock(dataDir);
+	if (occupied) {
+		if (pid === process.pid) return true;
+		return false;
+	}
+	const info = {
+		pid: process.pid,
+		startedAt: Date.now(),
+		...cmdline !== void 0 && cmdline !== "" ? { cmdline } : {}
+	};
+	try {
+		rmSync(lockPath, { force: true });
+		writeFileSync(lockPath, JSON.stringify(info), "utf-8");
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* 释放数据目录锁（正常退出时调用）。仅当持有者是本进程时才删除，
+* 避免误删新持有者的锁（PID 复用 / 快速重启场景）。
+*/
+function releaseInstanceLock(dataDir) {
+	const lockPath = join(dataDir, INSTANCE_LOCK_FILE);
+	try {
+		if (JSON.parse(readFileSync(lockPath, "utf-8")).pid === process.pid) rmSync(lockPath, { force: true });
+	} catch {}
+}
+/** 注册进程退出清理（SIGINT/SIGTERM/exit 均触发；崩溃强杀由残留检测兜底）。 */
+function registerLockCleanup(dataDir) {
+	process.on("exit", () => {
+		releaseInstanceLock(dataDir);
+	});
+}
+//#endregion
 //#region src/launcher.ts
 /**
 * launcher：自建宿主引导（2026-08-07 唯一路线）——spawn 标准 node 跑 self-host.cjs。
@@ -154,6 +258,6 @@ function resolveQqInstall(qqPath) {
 	};
 }
 //#endregion
-export { ENV, defaultStubDir, launchSelfHost, locateQqPath, resolveQqInstall };
+export { ENV, INSTANCE_LOCK_FILE, acquireInstanceLock, checkInstanceLock, defaultStubDir, launchSelfHost, locateQqPath, registerLockCleanup, releaseInstanceLock, resolveQqInstall };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/launcher.ts","../src/locate-qq.ts"],"sourcesContent":["/**\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    /** 自建宿主入口（默认 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,qBAAqB;;;;;;AA2BlC,SAAgB,kBAAkB,SAAoC;CAClE,MAAM,WAAW,KAAK,SAAS,kBAAkB;CACjD,IAAI,OAAgC;CACpC,IAAI;EACA,OAAO,KAAK,MAAM,aAAa,UAAU,OAAO,CAAC;CACrD,QAAQ;EAEJ,OAAO;GAAE,UAAU;GAAO,KAAK;GAAM;EAAS;CAClD;CACA,IAAI,OAAO,KAAK,QAAQ,YAAY,OAAO,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,GACtE,OAAO;EAAE,UAAU;EAAO,KAAK;EAAM;CAAS;CAGlD,IAAI,QAAQ;CACZ,IAAI;EACA,QAAQ,KAAK,KAAK,KAAK,CAAC;EACxB,QAAQ;CACZ,QAAQ;EACJ,QAAQ;CACZ;CACA,IAAI,CAAC,OAED,OAAO;EAAE,UAAU;EAAO,KAAK;EAAM;CAAS;CAElD,OAAO;EAAE,UAAU;EAAM,KAAK,KAAK;EAAK;CAAS;AACrD;;;;;AAMA,SAAgB,oBAAoB,SAAiB,SAA2B;CAC5E,MAAM,EAAE,UAAU,KAAK,aAAa,kBAAkB,OAAO;CAC7D,IAAI,UAAU;EAEV,IAAI,QAAQ,QAAQ,KAChB,OAAO;EAEX,OAAO;CACX;CAEA,MAAM,OAAyB;EAC3B,KAAK,QAAQ;EACb,WAAW,KAAK,IAAI;EACpB,GAAI,YAAY,KAAA,KAAa,YAAY,KAAK,EAAE,QAAQ,IAAI,CAAC;CACjE;CACA,IAAI;EACA,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;EAChC,cAAc,UAAU,KAAK,UAAU,IAAI,GAAG,OAAO;EACrD,OAAO;CACX,QAAQ;EACJ,OAAO;CACX;AACJ;;;;;AAMA,SAAgB,oBAAoB,SAAuB;CACvD,MAAM,WAAW,KAAK,SAAS,kBAAkB;CACjD,IAAI;EAEA,IADa,KAAK,MAAM,aAAa,UAAU,OAAO,CAC/C,CAAC,CAAC,QAAQ,QAAQ,KACrB,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;CAExC,QAAQ,CAER;AACJ;;AAGA,SAAgB,oBAAoB,SAAuB;CACvD,QAAQ,GAAG,cAAc;EACrB,oBAAoB,OAAO;CAC/B,CAAC;AACL;;;;;;;;;;;;AClHA,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;;;;;;;;;;AAuDxD,SAAgB,eAAe,SAAsC;CACjE,MAAM,eACF,QAAQ,iBAAiB,KAAK,WAAW,MAAM,QAAQ,QAAQ,eAAe;CAClF,IAAI,CAAC,WAAW,YAAY,GACxB,MAAM,IAAI,MACN,qBAAqB,aAAa,4CACtC;CAMJ,MAAM,OAAO,QAAQ,WAAW,eAAe;CAC/C,IAAI,CAAC,WAAW,KAAK,MAAM,UAAU,CAAC,GAClC,MAAM,IAAI,MACN,sBAAsB,KAAK,sFAE/B;CAGJ,MAAM,MAAM,eAAe,OAAO;CAKlC,IAAI,UAHgB;EAAC;EAAM,QAAQ,QAAQ,GAAG,WAAW;EAAG,QAAQ,IAAI,WAAW;CAAE,CAAC,CACjF,QAAQ,MAAM,MAAM,KAAA,KAAa,MAAM,EAAE,CAAC,CAC1C,KAAK,GACc;CACxB,IAAI,IAAI,YAAY;CAKpB,IAAI,QAAQ,QAAQ,KAAA,GAChB,UAAU,QAAQ,KAAK,EAAE,WAAW,KAAK,CAAC;CAU9C,OAAO;EAAE,OARK,MAAM,QAAQ,UAAU,CAAC,YAAY,GAAG;GAElD,GAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC;GACxD;GACA,OAAO,QAAQ,SAAS;GACxB,aAAa;EACjB,CAEa;EAAG,YAAY;CAAa;AAC7C;;;;;AAMA,SAAgB,iBAAyB;CACrC,OAAO,KAAK,WAAW,MAAM,UAAU,SAAS,eAAe;AACnE;;AAGA,SAAS,eAAe,SAAgD;CAEpE,MAAM,MAAM,QAAQ,QAAQ,MAAM;CAClC,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;CAElC,MAAM,MAA8B;EAChC,GAAG,QAAQ;GACV,IAAI,UAAU,QAAQ,GAAG;GACzB,IAAI,eAAe,QAAQ,QAAQ,WAAW;GAC9C,IAAI,UAAU;GACd,IAAI,aAAa,QAAQ,GAAG;GAC5B,IAAI,eAAe,QAAQ,GAAG;CACnC;CACA,IAAI,QAAQ,aAAa,MACrB,IAAI,IAAI,aAAa;CAEzB,IAAI,QAAQ,iBAAiB,KAAA,GACzB,IAAI,IAAI,iBAAiB,QAAQ,QAAQ,YAAY;CAEzD,IAAI,QAAQ,iBAAiB,KAAA,GACzB,IAAI,IAAI,iBAAiB,QAAQ,QAAQ,YAAY;CAEzD,IAAI,QAAQ,eAAe,KAAA,GACvB,IAAI,IAAI,eAAe,QAAQ,QAAQ,UAAU;CAErD,IAAI,QAAQ,aAAa,KAAA,GACrB,IAAI,IAAI,aAAa,QAAQ;CAEjC,OAAO;AACX;;AAGA,MAAa,MAAM;CACf,SAAS;CACT,cAAc;CACd,SAAS;CACT,YAAY;CACZ,cAAc;;CAEd,WAAW;;CAEX,UAAU;;CAEV,eAAe;;CAEf,eAAe;;CAEf,aAAa;;CAEb,WAAW;AACf;;;;;;;ACtKA,MAAM,eAAe;;AAGrB,SAAS,oBAAmC;CACxC,IAAI;EAQA,MAAM,MAPM,aAAa,OAAO;GAC5B;GACA;GACA;GACA;EACJ,CAAC,CAAC,CAAC,SACS,CAAC,CAAC,MAAM,YACR,CAAC,GAAG;EAChB,IAAI,QAAQ,KAAA,GAAW;GAEnB,MAAM,MAAM,IAAI,WAAW,MAAK,EAAE,CAAC,CAAC,MAAM,GAAG,IAAI,YAAY,IAAI,CAAC;GAClE,MAAM,KAAK,KAAK,KAAK,QAAQ;GAC7B,IAAI,WAAW,EAAE,GACb,OAAO;EAEf;CACJ,QAAQ,CAER;CACA,OAAO;AACX;;AAGA,SAAS,uBAAsC;CAC3C,MAAM,eAAe,QAAQ,IAAI,mBAAmB;CACpD,MAAM,aAAa;EACf;EACA;EACA,KAAK,cAAc,YAAY,WAAW,QAAQ,QAAQ;EAE1D;CACJ;CACA,KAAK,MAAM,KAAK,YACZ,IAAI,WAAW,CAAC,GACZ,OAAO;CAGf,OAAO;AACX;;AAeA,SAAgB,eAAuB;CACnC,MAAM,SAAS,kBAAkB;CACjC,IAAI,QACA,OAAO;CAEX,MAAM,YAAY,qBAAqB;CACvC,IAAI,WACA,OAAO;CAEX,MAAM,IAAI,MAAM,2CAA2C;AAC/D;;AAGA,SAAgB,iBAAiB,QAAgC;CAC7D,MAAM,KAAK,UAAU,QAAQ,IAAI,qBAAqB,aAAa;CACnE,MAAM,aAAa,GAAG,MAAM,GAAG,GAAG,YAAY,IAAI,CAAC;CACnD,MAAM,cAAc,KAAK,YAAY,UAAU;CAC/C,IAAI,CAAC,WAAW,WAAW,GACvB,MAAM,IAAI,MAAM,eAAe,aAAa;CAMhD,MAAM,CAAC,SAJU,YAAY,WAAW,CAAC,CACpC,QAAQ,MAAM,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAC3D,KAAK,CAAC,CACN,QACkB;CACvB,IAAI,UAAU,KAAA,GACV,MAAM,IAAI,MAAM,cAAc,aAAa;CAE/C,MAAM,cAAc,KAAK,aAAa,OAAO,aAAa,OAAO,cAAc;CAC/E,IAAI,CAAC,WAAW,WAAW,GACvB,MAAM,IAAI,MAAM,qBAAqB,aAAa;CAEtD,OAAO;EAAE,QAAQ;EAAI;EAAY,SAAS;EAAO;CAAY;AACjE"}

package/package.json

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