SnowCat 雪猫底层全源码：NapCat 4.18.28 底座 + SnowLuma 能力移植 + V8 通道适配 9.9.37

26 包 monorepo（TS 全源码）：
- snowcat-core: NT 内核 API 封装 + listener（含 9.9.37 六回调适配）+ Packet 发包
- snowcat-onebot: OneBot v11 全动作 + MCP Streamable HTTP 适配器 + 稳定线
- snowcat-webui-frontend/backend: 雪猫控制台（React+HeroUI）
- snowcat-shell: 单文件 bundle 出口（vite inlineDynamicImports）
- snowcat-native: napi2native / MoeHoo / ffmpeg / pty 运行时
- 56 项 SnowLuma 独门动作移植（qzone 全家桶/群相册/装扮/闪照/收藏）
- 工具件: 解包器/启动器/便携制作器/doctor

GitHub 关联已全量指向 DandanLLab/SnowCatQQ

packages/snowcat-core/packet/transformer/message/DownloadForwardMsg.ts

@@ -0,0 +1,33 @@
+import * as proto from '@/snowcat-core/packet/transformer/proto';
+import { NapProtoMsg } from 'snowcat-protobuf';
+import { OidbPacket, PacketBufBuilder, PacketTransformer } from '@/snowcat-core/packet/transformer/base';
+
+class DownloadForwardMsg extends PacketTransformer<typeof proto.RecvLongMsgResp> {
+  build (uid: string, resId: string): OidbPacket {
+    const req = new NapProtoMsg(proto.RecvLongMsgReq).encode({
+      info: {
+        uid: {
+          uid,
+        },
+        resId,
+        acquire: true,
+      },
+      settings: {
+        field1: 2,
+        field2: 0,
+        field3: 0,
+        field4: 0,
+      },
+    });
+    return {
+      cmd: 'trpc.group.long_msg_interface.MsgService.SsoRecvLongMsg',
+      data: PacketBufBuilder(req),
+    };
+  }
+
+  parse (data: Buffer) {
+    return new NapProtoMsg(proto.RecvLongMsgResp).decode(data);
+  }
+}
+
+export default new DownloadForwardMsg();

packages/snowcat-core/packet/transformer/message/FetchC2CMessage.ts

@@ -0,0 +1,23 @@
+import * as proto from '@/snowcat-core/packet/transformer/proto';
+import { NapProtoMsg } from 'snowcat-protobuf';
+import { OidbPacket, PacketBufBuilder, PacketTransformer } from '@/snowcat-core/packet/transformer/base';
+
+class FetchC2CMessage extends PacketTransformer<typeof proto.SsoGetC2cMsgResponse> {
+  build (targetUid: string, startSeq: number, endSeq: number): OidbPacket {
+    const req = new NapProtoMsg(proto.SsoGetC2cMsg).encode({
+      friendUid: targetUid,
+      startSequence: startSeq,
+      endSequence: endSeq,
+    });
+    return {
+      cmd: 'trpc.msg.register_proxy.RegisterProxy.SsoGetC2cMsg',
+      data: PacketBufBuilder(req),
+    };
+  }
+
+  parse (data: Buffer) {
+    return new NapProtoMsg(proto.SsoGetC2cMsgResponse).decode(data);
+  }
+}
+
+export default new FetchC2CMessage();

packages/snowcat-core/packet/transformer/message/FetchGroupMessage.ts

@@ -0,0 +1,26 @@
+import * as proto from '@/snowcat-core/packet/transformer/proto';
+import { NapProtoMsg } from 'snowcat-protobuf';
+import { OidbPacket, PacketBufBuilder, PacketTransformer } from '@/snowcat-core/packet/transformer/base';
+
+class FetchGroupMessage extends PacketTransformer<typeof proto.SsoGetGroupMsgResponse> {
+  build (groupUin: number, startSeq: number, endSeq: number): OidbPacket {
+    const req = new NapProtoMsg(proto.SsoGetGroupMsg).encode({
+      info: {
+        groupUin,
+        startSequence: startSeq,
+        endSequence: endSeq,
+      },
+      direction: true,
+    });
+    return {
+      cmd: 'trpc.msg.register_proxy.RegisterProxy.SsoGetGroupMsg',
+      data: PacketBufBuilder(req),
+    };
+  }
+
+  parse (data: Buffer) {
+    return new NapProtoMsg(proto.SsoGetGroupMsgResponse).decode(data);
+  }
+}
+
+export default new FetchGroupMessage();

packages/snowcat-core/packet/transformer/message/UploadForwardMsg.ts

@@ -0,0 +1,47 @@
+import zlib from 'node:zlib';
+import * as proto from '@/snowcat-core/packet/transformer/proto';
+import { NapProtoMsg } from 'snowcat-protobuf';
+import { OidbPacket, PacketBufBuilder, PacketTransformer } from '@/snowcat-core/packet/transformer/base';
+import { PacketMsg } from '@/snowcat-core/packet/message/message';
+
+class UploadForwardMsg extends PacketTransformer<typeof proto.SendLongMsgResp> {
+  build (selfUid: string, msg: PacketMsg[], groupUin: number = 0): OidbPacket {
+    const msgBody = this.msgBuilder.buildFakeMsg(selfUid, msg);
+    const longMsgResultData = new NapProtoMsg(proto.LongMsgResult).encode(
+      {
+        action: [{
+          actionCommand: 'MultiMsg',
+          actionData: {
+            msgBody,
+          },
+        }],
+      }
+    );
+    const payload = zlib.gzipSync(Buffer.from(longMsgResultData));
+    const req = new NapProtoMsg(proto.SendLongMsgReq).encode(
+      {
+        info: {
+          type: groupUin === 0 ? 1 : 3,
+          uid: {
+            uid: groupUin === 0 ? selfUid : groupUin.toString(),
+          },
+          groupUin,
+          payload,
+        },
+        settings: {
+          field1: 4, field2: 1, field3: 7, field4: 0,
+        },
+      }
+    );
+    return {
+      cmd: 'trpc.group.long_msg_interface.MsgService.SsoSendLongMsg',
+      data: PacketBufBuilder(req),
+    };
+  }
+
+  parse (data: Buffer) {
+    return new NapProtoMsg(proto.SendLongMsgResp).decode(data);
+  }
+}
+
+export default new UploadForwardMsg();

packages/snowcat-core/packet/transformer/message/UploadForwardMsgV2.ts

@@ -0,0 +1,52 @@
+import zlib from 'node:zlib';
+import * as proto from '@/snowcat-core/packet/transformer/proto';
+import { NapProtoEncodeStructType, NapProtoMsg } from 'snowcat-protobuf';
+import { OidbPacket, PacketBufBuilder, PacketTransformer } from '@/snowcat-core/packet/transformer/base';
+import { PacketMsg } from '@/snowcat-core/packet/message/message';
+
+export interface UploadForwardMsgParams {
+  actionCommand: string;
+  actionMsg?: PacketMsg[];
+  actionMsgBody?: NapProtoEncodeStructType<typeof proto.PushMsgBody>[];
+}
+class UploadForwardMsgV2 extends PacketTransformer<typeof proto.SendLongMsgResp> {
+  build (selfUid: string, msg: UploadForwardMsgParams[], groupUin: number = 0): OidbPacket {
+    const reqdata = msg.map((item) => ({
+      actionCommand: item.actionCommand,
+      actionData: {
+        msgBody: item.actionMsgBody ?? this.msgBuilder.buildFakeMsg(selfUid, item.actionMsg ?? []),
+      },
+    }));
+    const longMsgResultData = new NapProtoMsg(proto.LongMsgResult).encode(
+      {
+        action: reqdata,
+      }
+    );
+    const payload = zlib.gzipSync(Buffer.from(longMsgResultData));
+    const req = new NapProtoMsg(proto.SendLongMsgReq).encode(
+      {
+        info: {
+          type: groupUin === 0 ? 1 : 3,
+          uid: {
+            uid: groupUin === 0 ? selfUid : groupUin.toString(),
+          },
+          groupUin,
+          payload,
+        },
+        settings: {
+          field1: 4, field2: 1, field3: 7, field4: 0,
+        },
+      }
+    );
+    return {
+      cmd: 'trpc.group.long_msg_interface.MsgService.SsoSendLongMsg',
+      data: PacketBufBuilder(req),
+    };
+  }
+
+  parse (data: Buffer) {
+    return new NapProtoMsg(proto.SendLongMsgResp).decode(data);
+  }
+}
+
+export default new UploadForwardMsgV2();

packages/snowcat-core/packet/transformer/message/index.ts

@@ -0,0 +1,5 @@
+export { default as UploadForwardMsg } from './UploadForwardMsg';
+export { default as FetchGroupMessage } from './FetchGroupMessage';
+export { default as FetchC2CMessage } from './FetchC2CMessage';
+export { default as DownloadForwardMsg } from './DownloadForwardMsg';
+export { default as UploadForwardMsgV2 } from './UploadForwardMsgV2';