@napuketto/loader 0.0.37 → 0.0.39

package/dist/host/self-host.cjs

@@ -793,6 +793,63 @@ const IpcMessageSchema = zod.z.discriminatedUnion("type", [
 	IpcControlMessageSchema
 ]);
 //#endregion
+//#region src/host/ipc/json-safe.ts
+/**
+* json-safe.ts：IPC 出站负载 JSON 安全化（2026-10-24）。
+*
+* `JSON.stringify` 对 Map/Set 内容全丢（Map → `{}`、Set → `[]`）：
+* kernel 事件 args（RawMessage.videoElement.thumbPath `Map<0, path>`）与
+* 动作结果（如 GroupApi.uinToUid 的 `Map<qq, uid>`）跨进程后全部退化为
+* 空对象——koishi 插件侧读 `thumbPath.get(0)` 直接 TypeError，整条视频
+* 消息事件分派失败（2026-10-24 线上报）。编码前深规整：
+*  - Map → 平面对象（Object.fromEntries，数字 key 变字符串 key）
+*  - Set → 数组
+*  - 普通对象/数组递归；非普通对象（Date/Buffer/类实例）原样交 stringify
+*    （与既有行为一致，不引入新语义）
+* 幂等：已规整的负载再跑一遍结果不变。
+*/
+function toJsonSafe(value, ancestors = []) {
+	if (value === null || typeof value !== "object") return value;
+	if (ancestors.includes(value)) return;
+	const nested = [...ancestors, value];
+	if (value instanceof Map) return toJsonSafe(Object.fromEntries(value), nested);
+	if (value instanceof Set) return Array.from(value, (item) => toJsonSafe(item, nested));
+	if (Array.isArray(value)) return value.map((item) => toJsonSafe(item, nested));
+	const proto = Object.getPrototypeOf(value);
+	if (proto !== Object.prototype && proto !== null) return value;
+	const out = {};
+	for (const [key, val] of Object.entries(value)) {
+		const safe = toJsonSafe(val, nested);
+		if (safe !== void 0) out[key] = safe;
+	}
+	return out;
+}
+//#endregion
+//#region src/host/ipc/ipc-codec.ts
+/**
+* ipc-codec.ts：IPC 消息编解码（JSON 行协议，与 koishi 插件侧 src/ipc/codec.ts 对齐）。
+*
+* 每行一条 JSON 消息，`\n` 结尾。解码用 IpcMessageSchema.safeParse 校验：
+* 非法行 / 空行 / v 不匹配 / type 未知 / payload 形状非法 → null，调用方忽略，
+* 不崩通道。
+*/
+/** 编码为 JSON 行（追加换行）。Map/Set 先规整为可序列化形态（见 json-safe.ts）。 */
+function encodeIpcMessage(message) {
+	return `${JSON.stringify(toJsonSafe(message))}\n`;
+}
+/** 解码一行 JSON；非法行/空行/形状不合法返回 null。 */
+function decodeIpcMessage(line) {
+	const trimmed = line.trim();
+	if (trimmed === "") return null;
+	try {
+		const parsed = JSON.parse(trimmed);
+		const result = IpcMessageSchema.safeParse(parsed);
+		return result.success ? result.data : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/host/ipc/ipc-sender.ts
 /**
 * ipc-sender.ts：IPC 消息发送封装（self-host 子进程 → koishi 插件）。
@@ -814,7 +871,7 @@ function enableIpc() {
 function sendIpc(message) {
 	if (!enabled) return;
 	try {
-		process.stdout.write(`${JSON.stringify(message)}\n`);
+		process.stdout.write(encodeIpcMessage(message));
 	} catch {}
 }
 /** 引导状态（booting/dlopening/logging/sessioning/ready/failed）。 */
@@ -956,27 +1013,6 @@ function attachIpcServices(actions, services) {
 	};
 }
 //#endregion
-//#region src/host/ipc/ipc-codec.ts
-/**
-* ipc-codec.ts：IPC 消息编解码（JSON 行协议，与 koishi 插件侧 src/ipc/codec.ts 对齐）。
-*
-* 每行一条 JSON 消息，`\n` 结尾。解码用 IpcMessageSchema.safeParse 校验：
-* 非法行 / 空行 / v 不匹配 / type 未知 / payload 形状非法 → null，调用方忽略，
-* 不崩通道。
-*/
-/** 解码一行 JSON；非法行/空行/形状不合法返回 null。 */
-function decodeIpcMessage(line) {
-	const trimmed = line.trim();
-	if (trimmed === "") return null;
-	try {
-		const parsed = JSON.parse(trimmed);
-		const result = IpcMessageSchema.safeParse(parsed);
-		return result.success ? result.data : null;
-	} catch {
-		return null;
-	}
-}
-//#endregion
 //#region src/host/ipc/ipc-ob11.ts
 /**
 * ipc-ob11.ts：OB11 动作容器 IPC 桥（NAPUTO_IPC=1 可选装配，2026-08-27）。

package/native/build/stub-test-env/NOTICE.md

@@ -0,0 +1,32 @@
+# NOTICE — 本目录的 QQNT.dll 是自研符号转发 stub，非腾讯原始二进制
+
+本文件（约 70 KB）由 NapukettoQQ 项目自研编译，用于「标准 Node + stub 转发」的自建宿主
+模式：让 wrapper.node 在纯 Node 环境下经 process.dlopen 加载。它不是、也不包含腾讯 QQ
+客户端的 QQNT.dll——官方组件为数十 MB 的完整客户端二进制，本目录不含任何腾讯代码字节。
+
+## 成分
+
+- 99 个导出中 97 个为 PE Export Forwarder，转发到 node.exe 的既有实现；符号名为
+  Node-API（`napi_*`）、libuv（`uv_*`）与 V8 的公开接口名（Node.js 为 OpenJS 基金会
+  MIT 许可项目），另含 1 个别名 `qq_magic_napi_register`（转发至 node.exe 的
+  `napi_module_register`）。
+- 2 个自研空实现：`IsEnvironmentStopping` / `PerfTrace`（见本仓库 `stub/stub-qqnt.cpp`，
+  各数行）。
+- 符号清单来自对 wrapper.node PE 导入表的分析（互操作接口事实）。文件命名为
+  `QQNT.dll` 是 Windows PE 加载器按导入表模块名解析的机械要求。
+
+## 来源与边界
+
+- 编译源为本仓库（闭源）`stub/stub-qqnt.cpp` + `stub/stub-qqnt.def`
+  （llvm-mingw：`clang++ -shared stub-qqnt.cpp stub-qqnt.def -o QQNT.dll`）。
+- 运行形态：独立 DLL 置于 PATH 前置目录，不修改 QQ 安装目录任何文件、不注入官方进程。
+- 本目录随 npm 包 `@napuketto/loader` 的 `files` 字段分发。
+
+---
+
+This directory ships a self-authored PE export-forwarding stub (≈70 KB) compiled by the
+NapukettoQQ project. It is not, and contains no code from, Tencent's original QQNT.dll. 97 of
+its 99 exports are forwarders to node.exe (Node-API / libuv / V8 public symbols); the
+remaining 2 are trivial stubs written in this repository. The symbol list is derived from the
+PE import table of wrapper.node (interoperability facts), and the file must be named
+QQNT.dll to satisfy the Windows PE loader's module-name resolution.

package/package.json

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