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-onebot/action/go-cqhttp/UploadGroupFile.ts

@@ -0,0 +1,65 @@
+import { OneBotAction } from '@/snowcat-onebot/action/OneBotAction';
+import { ActionName } from '@/snowcat-onebot/action/router';
+import { ChatType, Peer, ElementType } from 'snowcat-core/types';
+import fs from 'fs';
+import { uriToLocalFile } from 'snowcat-common/src/file';
+import { SendMessageContext } from '@/snowcat-onebot/api';
+import { Static, Type } from '@sinclair/typebox';
+import { GoCQHTTPActionsExamples } from '../example/GoCQHTTPActionsExamples';
+
+export const GoCQHTTPUploadGroupFilePayloadSchema = Type.Object({
+  group_id: Type.String({ description: '群号' }),
+  file: Type.String({ description: '资源路径或URL' }),
+  name: Type.String({ description: '文件名' }),
+  folder: Type.Optional(Type.String({ description: '父目录 ID' })),
+  folder_id: Type.Optional(Type.String({ description: '父目录 ID (兼容性字段)' })), // 临时扩展
+  upload_file: Type.Boolean({ default: true, description: '是否执行上传' }),
+});
+
+export type GoCQHTTPUploadGroupFilePayload = Static<typeof GoCQHTTPUploadGroupFilePayloadSchema>;
+
+export const GoCQHTTPUploadGroupFileReturnSchema = Type.Object({
+  file_id: Type.Union([Type.String(), Type.Null()], { description: '文件 ID' }),
+});
+
+export type GoCQHTTPUploadGroupFileResponse = Static<typeof GoCQHTTPUploadGroupFileReturnSchema>;
+
+export default class GoCQHTTPUploadGroupFile extends OneBotAction<GoCQHTTPUploadGroupFilePayload, GoCQHTTPUploadGroupFileResponse> {
+  override actionName = ActionName.GoCQHTTP_UploadGroupFile;
+  override payloadSchema = GoCQHTTPUploadGroupFilePayloadSchema;
+  override returnSchema = GoCQHTTPUploadGroupFileReturnSchema;
+  override actionSummary = '上传群文件';
+  override actionDescription = '上传资源路径或URL指定的文件到指定群聊的文件系统中';
+  override actionTags = ['Go-CQHTTP'];
+  override payloadExample = GoCQHTTPActionsExamples.UploadGroupFile.payload;
+  override returnExample = GoCQHTTPActionsExamples.UploadGroupFile.response;
+
+  async _handle (payload: GoCQHTTPUploadGroupFilePayload): Promise<GoCQHTTPUploadGroupFileResponse> {
+    let file = payload.file;
+    if (fs.existsSync(file)) {
+      file = `file://${file}`;
+    }
+    const downloadResult = await uriToLocalFile(this.core.SnowCatTempPath, file);
+    const peer: Peer = {
+      chatType: ChatType.KCHATTYPEGROUP,
+      peerUid: payload.group_id.toString(),
+    };
+    if (!downloadResult.success) {
+      throw new Error(downloadResult.errMsg);
+    }
+    const msgContext: SendMessageContext = {
+      peer,
+      deleteAfterSentFiles: [],
+    };
+    const sendFileEle = await this.obContext.apis.FileApi.createValidSendFileElement(msgContext, downloadResult.path, payload.name, payload.folder ?? payload.folder_id, payload.upload_file, downloadResult.isLocal);
+    if (!downloadResult.isLocal) {
+      msgContext.deleteAfterSentFiles.push(downloadResult.path);
+    }
+    const returnMsg = await this.obContext.apis.MsgApi.sendMsgWithOb11UniqueId(peer, [sendFileEle], msgContext.deleteAfterSentFiles);
+
+    const fileElement = returnMsg.elements.find(ele => ele.elementType === ElementType.FILE);
+    return {
+      file_id: fileElement?.fileElement?.fileUuid || null,
+    };
+  }
+}