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/message/converter.ts

@@ -0,0 +1,173 @@
+import {
+  ChatType,
+  ElementType,
+  MessageElement,
+  Peer,
+  RawMessage,
+} from '@/snowcat-core/types/msg';
+import {
+  SendArkElement,
+  SendFaceElement,
+  SendFileElement,
+  SendMarkdownElement,
+  SendMarketFaceElement,
+  SendMultiForwardMsgElement,
+  SendPicElement,
+  SendPttElement,
+  SendReplyElement,
+  SendTextElement,
+  SendVideoElement,
+} from '@/snowcat-core/types/element';
+import {
+  IPacketMsgElement,
+  PacketMsgAtElement,
+  PacketMsgFaceElement,
+  PacketMsgFileElement,
+  PacketMsgLightAppElement,
+  PacketMsgMarkDownElement,
+  PacketMsgMarkFaceElement,
+  PacketMsgPicElement,
+  PacketMsgPttElement,
+  PacketMsgReplyElement,
+  PacketMsgTextElement,
+  PacketMsgVideoElement,
+  PacketMultiMsgElement,
+} from '@/snowcat-core/packet/message/element';
+import { PacketMsg, PacketSendMsgElement } from '@/snowcat-core/packet/message/message';
+import { NapProtoDecodeStructType } from 'snowcat-protobuf';
+import { Elem } from '@/snowcat-core/packet/transformer/proto';
+
+const SupportedElementTypes = [
+  ElementType.TEXT,
+  ElementType.PIC,
+  ElementType.REPLY,
+  ElementType.FACE,
+  ElementType.MFACE,
+  ElementType.VIDEO,
+  ElementType.FILE,
+  ElementType.PTT,
+  ElementType.ARK,
+  ElementType.MARKDOWN,
+  ElementType.MULTIFORWARD,
+];
+
+type SendMessageTypeElementMap = {
+  [ElementType.TEXT]: SendTextElement,
+  [ElementType.PIC]: SendPicElement,
+  [ElementType.FILE]: SendFileElement,
+  [ElementType.PTT]: SendPttElement,
+  [ElementType.VIDEO]: SendVideoElement,
+  [ElementType.FACE]: SendFaceElement,
+  [ElementType.REPLY]: SendReplyElement,
+  [ElementType.ARK]: SendArkElement,
+  [ElementType.MFACE]: SendMarketFaceElement,
+  [ElementType.MULTIFORWARD]: SendMultiForwardMsgElement,
+  [ElementType.MARKDOWN]: SendMarkdownElement,
+};
+
+type ElementToPacketMsgConverters = {
+  [K in keyof SendMessageTypeElementMap]: (
+    sendElement: MessageElement
+  ) => IPacketMsgElement<SendMessageTypeElementMap[K]>;
+};
+
+export type rawMsgWithSendMsg = {
+  senderUin: number;
+  senderUid?: string;
+  senderName: string;
+  groupId?: number;
+  time: number;
+  msg: PacketSendMsgElement[]
+};
+
+// TODO: make it become adapter?
+export class PacketMsgConverter {
+  private isValidElementType (type: ElementType): type is keyof ElementToPacketMsgConverters {
+    return SupportedElementTypes.includes(type);
+  }
+
+  private readonly rawToPacketMsgConverters: ElementToPacketMsgConverters = {
+    [ElementType.TEXT]: (element) => {
+      if (element.textElement?.atType) {
+        return new PacketMsgAtElement(element as SendTextElement);
+      }
+      return new PacketMsgTextElement(element as SendTextElement);
+    },
+    [ElementType.PIC]: (element) => {
+      return new PacketMsgPicElement(element as SendPicElement);
+    },
+    [ElementType.REPLY]: (element) => {
+      return new PacketMsgReplyElement(element as SendReplyElement);
+    },
+    [ElementType.FACE]: (element) => {
+      return new PacketMsgFaceElement(element as SendFaceElement);
+    },
+    [ElementType.MFACE]: (element) => {
+      return new PacketMsgMarkFaceElement(element as SendMarketFaceElement);
+    },
+    [ElementType.VIDEO]: (element) => {
+      return new PacketMsgVideoElement(element as SendVideoElement);
+    },
+    [ElementType.FILE]: (element) => {
+      return new PacketMsgFileElement(element as SendFileElement);
+    },
+    [ElementType.PTT]: (element) => {
+      return new PacketMsgPttElement(element as SendPttElement);
+    },
+    [ElementType.ARK]: (element) => {
+      return new PacketMsgLightAppElement(element as SendArkElement);
+    },
+    [ElementType.MARKDOWN]: (element) => {
+      return new PacketMsgMarkDownElement(element as SendMarkdownElement);
+    },
+    [ElementType.MULTIFORWARD]: (element) => {
+      return new PacketMultiMsgElement(element as SendMultiForwardMsgElement);
+    },
+  };
+
+  rawMsgWithSendMsgToPacketMsg (msg: rawMsgWithSendMsg): PacketMsg {
+    return {
+      senderUid: msg.senderUid ?? '',
+      senderUin: msg.senderUin,
+      senderName: msg.senderName,
+      groupId: msg.groupId,
+      time: msg.time,
+      msg: msg.msg.map((element) => {
+        if (!this.isValidElementType(element.elementType)) return null;
+        return this.rawToPacketMsgConverters[element.elementType](element as MessageElement);
+      }).filter((e) => e !== null),
+    };
+  }
+
+  rawMsgToPacketMsg (msg: RawMessage, ctxPeer: Peer): PacketMsg {
+    return {
+      seq: +msg.msgSeq,
+      groupId: ctxPeer.chatType === ChatType.KCHATTYPEGROUP ? +msg.peerUid : undefined,
+      senderUid: msg.senderUid,
+      senderUin: +msg.senderUin,
+      senderName: msg.sendMemberName && msg.sendMemberName !== ''
+        ? msg.sendMemberName
+        : msg.sendNickName && msg.sendNickName !== ''
+          ? msg.sendNickName
+          : 'QQ用户',
+      time: +msg.msgTime,
+      msg: msg.elements.map((element) => {
+        if (!this.isValidElementType(element.elementType)) return null;
+        return this.rawToPacketMsgConverters[element.elementType](element);
+      }).filter((e) => e !== null),
+    };
+  }
+
+  packetMsgToRaw (msg: NapProtoDecodeStructType<typeof Elem>[]): [MessageElement, NapProtoDecodeStructType<typeof Elem> | null][] {
+    const converters = [PacketMsgTextElement.parseElement,
+      PacketMsgAtElement.parseElement, PacketMsgReplyElement.parseElement,
+      PacketMsgVideoElement.parseElement, PacketMsgPicElement.parseElement];
+    return msg.map((element) => {
+      for (const converter of converters) {
+        const result = converter(element);
+        if (result) return result;
+      }
+      return null;
+    }).filter((e) => e !== null);
+  }
+}