@napuketto/loader 0.0.26 → 0.0.27

package/dist/host/self-host.cjs

@@ -741,6 +741,16 @@ function replayStatus() {
 		payload: lastStatus
 	});
 }
+/** 最近一次 status 的 phase（从未发送过为 null）。
+* 引导失败决策用：判断「是否已发过更具体的 failed」，避免通用 failed 覆盖具体错误码。 */
+function lastIpcStatusPhase() {
+	return lastStatus?.phase ?? null;
+}
+/** 引导未完成时是否补发通用 failed：仅 IPC 模式且最近一条不是 failed
+* （已发过带具体错误码的 failed 时不覆盖，如登录失败的 NOT_LOGIN）。 */
+function shouldSendGenericBootFailed(ipcMode, lastPhase) {
+	return ipcMode && lastPhase !== "failed";
+}
 /** 登录状态（QR 状态机 idle/waiting_scan/scanned/logged_in/failed）。 */
 function sendLogin(state, selfInfo, message) {
 	sendIpc({
@@ -1349,7 +1359,13 @@ async function createKernelServices(kernel, ctx, loginResult) {
 *    kernel 服务），返回 KernelServices 由 bootstrap 装配 ipc-server。
 *  - 非 IPC（cli pnpm start）：照旧装配 OB11/Satori 网络传输。
 */
-/** 登录成功后装配协议：IPC 模式返回 kernel 服务（供 ipc-server），否则装配 OB11/Satori。 */
+/**
+* 登录成功后装配协议：IPC 模式返回 kernel 服务（供 ipc-server），否则装配 OB11/Satori。
+*
+* 返回 null = 服务未装配（session 缺失 / OB11/Satori 装配失败）——调用方据此判
+* 引导失败。env 未注入 adapter/network 入口时「跳过装配」仍返回服务（合法运行形态，
+* 如纯 kernel 探测），不算失败。
+*/
 async function startProtocols(kernel, ctx, loginResult) {
 	const services = await createKernelServices(kernel, ctx, loginResult);
 	if (services === null) return null;
@@ -1361,6 +1377,7 @@ async function startProtocols(kernel, ctx, loginResult) {
 		await assembleOb11AndSatori(kernel, services, loginResult);
 	} catch (e) {
 		log(`bootstrap: 协议装配失败: ${errMsg(e)}`);
+		return null;
 	}
 	return services;
 }
@@ -1778,10 +1795,12 @@ function runProbePhase(kernel, ctx) {
 		log(`bootstrap: probe error: ${errMsg(e)}`);
 	}
 }
-/** NapukettoCore 装配路径：create → attachWrapper → 登录 → 激活 → 协议 → 探测。 */
+/** NapukettoCore 装配路径：create → attachWrapper → 登录 → 激活 → 协议 → 探测。
+* @returns 引导是否完整完成（协议服务装配成功 = true；登录失败/服务装配失败等
+*   静默收敛为 false，具体原因见 napuketto-boot.log）。 */
 async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
 	const coreCtor = kernel.NapukettoCore;
-	if (coreCtor === void 0) return;
+	if (coreCtor === void 0) return false;
 	const core = coreCtor.create({
 		paths: { dataRoot: bootEnv.dataDir },
 		logLevel: "info",
@@ -1802,7 +1821,7 @@ async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
 	probeSessionMethods(ctx);
 	if (typeof core.login !== "function") {
 		log("bootstrap: kernel core missing login fn");
-		return;
+		return false;
 	}
 	const forcedUin = env.NAPUTO_QUICK_UIN;
 	const ref = { targetUin: void 0 };
@@ -1815,7 +1834,7 @@ async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
 			code: "NOT_LOGIN",
 			message: "登录失败"
 		});
-		return;
+		return false;
 	}
 	log(`bootstrap: 登录成功 uin=${loginResult.uin} uid=${loginResult.uid} nick=${loginResult.nick}`);
 	if (env.NAPUTO_IPC === "1") sendLogin("logged_in", {
@@ -1828,11 +1847,16 @@ async function bootstrapWithCore(kernel, state, bootEnv, Appid) {
 	if (env.NAPUTO_IPC === "1") sendStatus("sessioning");
 	await runSmokeIfEnabled(kernel, ctx, loginResult);
 	const services = await startProtocols(kernel, ctx, loginResult);
-	if (env.NAPUTO_IPC === "1" && services !== null && ipcActions !== null) {
+	if (services === null) {
+		log("bootstrap: 协议服务装配失败，引导中止");
+		return false;
+	}
+	if (env.NAPUTO_IPC === "1" && ipcActions !== null) {
 		attachIpcServices(ipcActions, services);
 		await attachOb11IpcBridge(ipcActions, services);
 	}
 	runProbePhase(kernel, ctx);
+	return true;
 }
 //#endregion
 //#region src/host/core/bootstrap.ts
@@ -1867,11 +1891,11 @@ function resolveAppid(kernel, bootEnv) {
 	}
 	throw new Error("无法从 major.node 解析 appid，请确认 wrapper.node/major.node 完整，或更新 qq-releases.json");
 }
-/** 快速登录 + session 初始化（kernel lifecycle 路径；生命周期方法缺失则跳过）。 */
+/** 快速登录 + session 初始化（kernel lifecycle 路径）。生命周期方法缺失 → false（无登录态，引导不完整）。 */
 async function quickLoginAndStartSession(kernel, ctx, Appid, bootEnv) {
 	if (typeof kernel.quickLogin !== "function" || typeof kernel.initAndStartSession !== "function") {
 		log("bootstrap: kernel missing lifecycle fns (quickLogin/initAndStartSession)");
-		return;
+		return false;
 	}
 	if (typeof kernel.buildLoginConfig === "function" && ctx.loginService) {
 		const loginCfg = kernel.buildLoginConfig(Appid, bootEnv.qqVersion || "", bootEnv.dataDir || ".");
@@ -1895,6 +1919,7 @@ async function quickLoginAndStartSession(kernel, ctx, Appid, bootEnv) {
 	const listener = kernel.createLifecycleSessionListener();
 	await kernel.initAndStartSession(ctx, sessionConfig, listener, { timeoutMs: 2e4 });
 	log("bootstrap: session init + startNT OK!");
+	return true;
 }
 /** 冒烟探测（NAPUTO_PROBE=1 时运行）。 */
 async function probeRuntime(kernel, ctx) {
@@ -1906,7 +1931,7 @@ async function probeRuntime(kernel, ctx) {
 		log(`bootstrap: probe error: ${errMsg(e)}`);
 	}
 }
-/** 回退：旧装配路径（startNapuketto + 手工 lifecycle）。 */
+/** 回退：旧装配路径（startNapuketto + 手工 lifecycle）。返回引导是否完整完成。 */
 async function bootstrapFallback(kernel, state, bootEnv, Appid) {
 	log("bootstrap: kernel has no NapukettoCore, falling back");
 	const ctx = kernel.startNapuketto?.({
@@ -1915,25 +1940,31 @@ async function bootstrapFallback(kernel, state, bootEnv, Appid) {
 	});
 	if (ctx === void 0) {
 		log("bootstrap: startNapuketto 不可用");
-		return;
+		return false;
 	}
 	log(`bootstrap: startNapuketto OK, engine=${typeof ctx.engine}, session=${ctx.session !== null}`);
-	await quickLoginAndStartSession(kernel, ctx, Appid, bootEnv);
+	const loggedIn = await quickLoginAndStartSession(kernel, ctx, Appid, bootEnv);
 	await probeRuntime(kernel, ctx);
+	return loggedIn;
 }
-/** 核心引导：import kernel → 装配 → 登录 → 替换 session → 等待就绪 → 协议装配。 */
+/**
+* 核心引导：import kernel → 装配 → 登录 → 替换 session → 等待就绪 → 协议装配。
+* @returns 引导是否完整完成（IPC 模式 = 协议服务装配成功；各失败路径静默收敛为
+*   false 而非抛错，具体原因记录在 NAPUTO_CFG_DIR 下 napuketto-boot.log——
+*   调用方 self-host 依此决定 ready/failed 与进程去留）。
+*/
 async function bootstrap(state) {
 	const kernelEntry = env.NAPUTO_KERNEL_ENTRY;
 	if (!kernelEntry) {
 		log("bootstrap: NAPUTO_KERNEL_ENTRY not set");
-		return;
+		return false;
 	}
 	try {
 		const kernel = await import(`file://${kernelEntry.replace(/\\/g, "/")}`);
 		log(`bootstrap: kernel imported, keys: ${Object.keys(kernel).join(", ")}`);
 		if (typeof kernel.startNapuketto !== "function" && typeof kernel.NapukettoCore !== "function") {
 			log("bootstrap: kernel 无 startNapuketto/NapukettoCore 导出");
-			return;
+			return false;
 		}
 		const bootEnv = {
 			qqVersion: env.NAPUTO_QQ_VERSION || "",
@@ -1943,13 +1974,15 @@ async function bootstrap(state) {
 		try {
 			const Appid = resolveAppid(kernel, bootEnv);
 			log(`bootstrap: appid=${Appid}（wrapper=${bootEnv.wrapperPath}）`);
-			if (kernel.NapukettoCore !== void 0) await bootstrapWithCore(kernel, state, bootEnv, Appid);
-			else await bootstrapFallback(kernel, state, bootEnv, Appid);
+			if (kernel.NapukettoCore !== void 0) return await bootstrapWithCore(kernel, state, bootEnv, Appid);
+			return await bootstrapFallback(kernel, state, bootEnv, Appid);
 		} catch (e) {
 			log(`bootstrap: lifecycle error: ${errMsg(e)}`);
+			return false;
 		}
 	} catch (e) {
 		log(`bootstrap: import kernel failed: ${errMsg(e)}`);
+		return false;
 	}
 }
 //#endregion
@@ -2047,7 +2080,13 @@ try {
 log("[self-host] 调 bootstrap(state) ...");
 (async () => {
 	try {
-		await bootstrap(state);
+		if (!await bootstrap(state)) {
+			if (shouldSendGenericBootFailed(ipcMode, lastIpcStatusPhase())) sendStatus("failed", "bootstrap 未完成", {
+				code: "UNKNOWN",
+				message: "bootstrap 未完成，详见 napuketto-boot.log"
+			});
+			process.exit(1);
+		}
 		log("[self-host] bootstrap 完成");
 		if (ipcMode) sendStatus("ready");
 	} catch (e) {

package/package.json

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