@napuketto/kernel 0.4.0 → 0.5.1

package/dist/index.mjs

@@ -1186,7 +1186,20 @@ function toCanonicalElement(el) {
 function toCanonicalElements(msg) {
 	return msg.elements.map(toCanonicalElement);
 }
-/** canonical 元素 → NT 发送元素（text/at/face/image/voice/reply 核心五类）。 */
+/**
+* canonical json → ARK bytesData 字符串：字符串原样透传（OB11 json 段 /
+* satori 发送链给的已是卡片 JSON 文本），其余值 JSON 序列化。
+* 与接收方向 arkToCanonical 对称（bytesData 字段名 2026-10-25 真实消息实测）。
+*/
+function jsonToArkBytes(raw) {
+	if (typeof raw === "string") return raw;
+	try {
+		return JSON.stringify(raw) ?? "";
+	} catch (err) {
+		throw kernelError(`json 元素序列化失败: ${String(err)}`, "INVALID_PARAM");
+	}
+}
+/** canonical 元素 → NT 发送元素（text/at/face/image/voice/reply 核心 + json ARK 透传）。 */
 function toSendElements(elements) {
 	const out = [];
 	for (const el of elements) switch (el.type) {
@@ -1242,9 +1255,14 @@ function toSendElements(elements) {
 			});
 			break;
 		case "video": throw kernelError("视频发送需经 MsgApi 预处理（prepareVideoElement）", "INVALID_PARAM");
+		case "json":
+			out.push({
+				elementType: ElementType.ARK,
+				arkElement: { bytesData: jsonToArkBytes(el.raw) }
+			});
+			break;
 		case "file":
 		case "forward":
-		case "json":
 		case "xml":
 		case "unknown": throw kernelError(`发送元素 ${el.type} 暂不支持（P2-2 探测后补）`, "INVALID_PARAM");
 	}
@@ -4538,6 +4556,33 @@ function tryCall(obj, name) {
 		};
 	}
 }
+/** 服务 getter 判定（get*Service 命名约定）。 */
+function isServiceGetter(name) {
+	return name.startsWith("get") && name.endsWith("Service");
+}
+/** 非空服务实例计数（逐个调用 get*Service 数非空返回；候选可用度评分）。
+*  自建宿主下 QQ 主 session 未被 init，get*Service 恒 null（2026-10-31 实测
+*  napuketto-probe-late.json），kernel 自建 session 服务可用——主目标按此评分选取。 */
+function countNonNullServices(session) {
+	if (session === null || session === void 0) return 0;
+	let count = 0;
+	for (const name of listMethods(session)) {
+		if (!isServiceGetter(name)) continue;
+		const call = tryCall(session, name);
+		if (call.ok && call.value !== null && call.value !== void 0) count += 1;
+	}
+	return count;
+}
+/** 主探测目标选取：服务实例最多者优先，评分并列保持候选顺序（主 session 在前）。 */
+function pickPrimaryCandidate(candidates) {
+	let best = candidates[0];
+	for (const candidate of candidates.slice(1)) if (best !== void 0 && candidate.serviceNonNull > best.serviceNonNull) best = candidate;
+	return best ?? {
+		source: "own-create",
+		session: null,
+		serviceNonNull: 0
+	};
+}
 //#endregion
 //#region src/wrapper/probe/probe-services.ts
 /** 探测关键 export 构造器方法（get/create/getNTWrapperSession 等）。 */
@@ -4688,24 +4733,37 @@ function probeStartupChain(created) {
 /** 从 getSessionIdList 结果提取 sessionIds（Map 值或键优先）。 */
 function extractSessionIds(ids) {
 	if (!(ids.ok && ids.value instanceof Map)) return [];
-	const out = [];
-	for (const [k, v] of ids.value) out.push(typeof v === "string" ? v : String(k));
-	return out;
+	return [...ids.value].map(([k, v]) => sessionIdOfEntry(k, v));
 }
-/** 用真实 sessionId 取主 session（getNTWrapperSession(nt_x)）并记录方法面。 */
-function probeSessionById(ctx, id) {
+/** 单条 sessionIds 项（Map 值是字符串直接用，否则退化键名）。 */
+function sessionIdOfEntry(k, v) {
+	return typeof v === "string" ? v : String(k);
+}
+/** session 实例方法面（空值记 null）。 */
+function sessionFace(session) {
+	return session !== null && session !== void 0 ? {
+		methods: listMethods(session),
+		ownKeys: Object.getOwnPropertyNames(session)
+	} : null;
+}
+/** 未知异常 → 错误消息字符串。 */
+function errMsgString(e) {
+	return e instanceof Error ? e.message : String(e);
+}
+/** try getNTWrapperSession(id) → session 方法面（fn 缺失记 null，失败记 error）。 */
+function trySessionFace(ctx, id) {
 	const fn = getNTWrapperSessionFn(ctx);
 	if (fn === null) return null;
 	try {
-		const value = fn.call(ctx.exports.NodeIQQNTWrapperSession, id);
-		return value ? {
-			methods: listMethods(value),
-			ownKeys: Object.getOwnPropertyNames(value)
-		} : null;
+		return sessionFace(fn.call(ctx.exports.NodeIQQNTWrapperSession, id));
 	} catch (e) {
-		return { error: e instanceof Error ? e.message : String(e) };
+		return { error: errMsgString(e) };
 	}
 }
+/** 用真实 sessionId 取主 session（getNTWrapperSession(nt_x)）并记录方法面。 */
+function probeSessionById(ctx, id) {
+	return trySessionFace(ctx, id);
+}
 /** 兜底：候选名字 getNTWrapperSession（无 Map 数据时）。 */
 function probeByNameFallback(ctx) {
 	const candidates = [
@@ -4721,31 +4779,39 @@ function probeByNameFallback(ctx) {
 }
 /** 探测单个候选名（getNTWrapperSession(name)，记录方法面或错误）。 */
 function probeSessionByName(ctx, name) {
-	try {
-		const fn = getNTWrapperSessionFn(ctx);
-		if (fn === null) return null;
-		const value = fn.call(ctx.exports.NodeIQQNTWrapperSession, name);
-		return value ? {
-			methods: listMethods(value),
-			ownKeys: Object.getOwnPropertyNames(value)
-		} : null;
-	} catch (e) {
-		return { error: e instanceof Error ? e.message : String(e) };
-	}
+	return trySessionFace(ctx, name);
 }
-/** 探测 startup session 链路：create() → start() → getSessionIdList → getNTWrapperSession。 */
-function probeStartup(ctx) {
+/** StartupSessionWrapper 可用性判定（缺 create 方法视为不可用）。 */
+function startupWrapper(ctx) {
 	const startup = ctx.exports.NodeIQQNTStartupSessionWrapper;
-	if (startup === null || typeof startup.create !== "function") return null;
-	const out = { staticMethods: listMethods(startup) };
-	const created = tryCall(startup, "create");
-	out["create"] = created.ok ? {
+	return startup === null || typeof startup.create !== "function" ? null : startup;
+}
+/** create() 调用结果面（成功记实例方法面 + 序列化值，失败记 error）。 */
+function createFace(created) {
+	return created.ok ? {
 		methods: created.value ? listMethods(created.value) : [],
 		value: serialize(created.value)
 	} : { error: created.error };
+}
+/** create 成功时并入实例链探测结果。 */
+function assignCreatedChain(out, ctx, created) {
 	if (created.ok && created.value) Object.assign(out, probeCreatedChain(ctx, created.value));
+}
+/** 无 Map 数据时并入候选名兜底结果。 */
+function assignNameFallback(out, ctx) {
+	if (out["sessionIds"] !== void 0) return;
+	out["getNTWrapperSession"] = probeByNameFallback(ctx);
+}
+/** 探测 startup session 链路：create() → start() → getSessionIdList → getNTWrapperSession。 */
+function probeStartup(ctx) {
+	const startup = startupWrapper(ctx);
+	if (startup === null) return null;
+	const out = { staticMethods: listMethods(startup) };
+	const created = tryCall(startup, "create");
+	out["create"] = createFace(created);
+	assignCreatedChain(out, ctx, created);
 	out["enumSessionIds"] = enumerateSessionIds(ctx);
-	if (out["sessionIds"] === void 0) out["getNTWrapperSession"] = probeByNameFallback(ctx);
+	assignNameFallback(out, ctx);
 	return out;
 }
 /** 探测 create 后的实例链：start / getSessionIdList / 主 session。 */
@@ -4767,31 +4833,60 @@ function probeCreatedChain(ctx, created) {
 function findMainProbeId(sessionIds) {
 	return sessionIds.find((id) => id.startsWith("nt_")) ?? sessionIds[0];
 }
-/** 探测 session 与 service 方法（优先复用 QQ 主 session）。 */
+/** 探测 session 与 service 方法（候选中选服务实例最多者为主目标）。
+*  自建宿主下 QQ 主 session 未被 init（get*Service 恒 null，2026-10-31 实测
+*  napuketto-probe-late.json 全服务空），kernel 自建 session 已带 adapter init
+*  服务可用——主目标按 countNonNullServices 评分选取，并列保持主 session 优先。 */
 function probeSession(ctx) {
 	const out = {};
-	const session = pickProbeSession(ctx, out);
-	out["session"] = session ? {
-		methods: listMethods(session),
-		ownKeys: Object.getOwnPropertyNames(session)
-	} : null;
-	if (session !== null && session !== void 0) out["services"] = collectServiceGetters(session);
+	const candidates = collectProbeCandidates(ctx).map(scoreCandidate);
+	const primary = pickPrimaryCandidate(candidates);
+	out["sessionSource"] = primary.source;
+	out["session"] = sessionFace(primary.session);
+	if (primary.session !== null && primary.session !== void 0) out["services"] = collectServiceGetters(primary.session);
+	if (candidates.length > 1) out["sessionAlternates"] = alternateFaces(candidates, primary);
 	return out;
 }
-/** 选探测目标 session：优先 QQ 主 session（getMainSession），回退 ctx.session。 */
-function pickProbeSession(ctx, out) {
+/** 候选评分（非空服务实例数）。 */
+function scoreCandidate(candidate) {
+	return {
+		...candidate,
+		serviceNonNull: countNonNullServices(candidate.session)
+	};
+}
+/** 落选候选的概要面（方法数 + 评分，诊断用）。 */
+function alternateFaces(candidates, primary) {
+	return candidates.filter((candidate) => candidate !== primary).map((candidate) => ({
+		source: candidate.source,
+		methodCount: listMethods(candidate.session).length,
+		serviceNonNull: candidate.serviceNonNull
+	}));
+}
+/** 收集候选 session：QQ 主 session（若可得）在前 + kernel 自建 session 去重补充。 */
+function collectProbeCandidates(ctx) {
+	const candidates = [];
+	pushMainCandidate(ctx, candidates);
+	pushOwnCandidate(ctx, candidates);
+	return candidates;
+}
+/** 并入 QQ 主 session 候选（枚举失败静默跳过）。 */
+function pushMainCandidate(ctx, out) {
 	try {
 		const main = getMainSession(ctx);
-		if (main !== null) {
-			out["sessionSource"] = "mainSession(getNTWrapperSession)";
-			return main;
-		}
+		if (main !== null) out.push({
+			source: "mainSession(getNTWrapperSession)",
+			session: main
+		});
 	} catch {}
-	if (ctx.session !== null) {
-		out["sessionSource"] = "own-create";
-		return ctx.session;
-	}
-	return null;
+}
+/** 并入 kernel 自建 session 候选（与已有候选同一实例时去重）。 */
+function pushOwnCandidate(ctx, out) {
+	if (ctx.session === null) return;
+	if (out.some((candidate) => candidate.session === ctx.session)) return;
+	out.push({
+		source: "own-create",
+		session: ctx.session
+	});
 }
 /** 收集 session 的 get*Service getter 方法面与返回形状。 */
 function collectServiceGetters(session) {