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/SetGroupPortrait.ts

@@ -0,0 +1,57 @@
+import { OneBotAction } from '@/snowcat-onebot/action/OneBotAction';
+import { ActionName } from '@/snowcat-onebot/action/router';
+import { checkFileExistV2, uriToLocalFile } from 'snowcat-common/src/file';
+import { Static, Type } from '@sinclair/typebox';
+import fs from 'node:fs/promises';
+import { GoCQHTTPActionsExamples } from '../example/GoCQHTTPActionsExamples';
+
+export const SetGroupPortraitPayloadSchema = Type.Object({
+  file: Type.String({ description: '头像文件路径或 URL' }),
+  group_id: Type.String({ description: '群号' }),
+});
+
+export type SetGroupPortraitPayload = Static<typeof SetGroupPortraitPayloadSchema>;
+
+const ReturnSchema = Type.Object({
+  result: Type.Number(),
+  errMsg: Type.String(),
+}, { description: '设置结果' });
+
+export type ReturnType = Static<typeof ReturnSchema>;
+
+export default class SetGroupPortrait extends OneBotAction<SetGroupPortraitPayload, ReturnType> {
+  override actionName = ActionName.SetGroupPortrait;
+  override payloadSchema = SetGroupPortraitPayloadSchema;
+  override returnSchema = ReturnSchema;
+  override actionSummary = '设置群头像';
+  override actionDescription = '修改指定群聊的头像';
+  override actionTags = ['Go-CQHTTP'];
+  override payloadExample = GoCQHTTPActionsExamples.SetGroupPortrait.payload;
+  override returnExample = GoCQHTTPActionsExamples.SetGroupPortrait.response;
+
+  async _handle (payload: SetGroupPortraitPayload): Promise<ReturnType> {
+    const { path, success, isLocal } = (await uriToLocalFile(this.core.SnowCatTempPath, payload.file));
+    if (!success) {
+      throw new Error(`头像${payload.file}设置失败,file字段可能格式不正确`);
+    }
+    if (path) {
+      await checkFileExistV2(path, 5000); // 文件不存在QQ会崩溃，需要提前判断
+      const ret = await this.core.apis.GroupApi.setGroupAvatar(payload.group_id.toString(), path);
+      if (!isLocal) fs.unlink(path).catch(() => { });
+      if (!ret) {
+        throw new Error(`头像${payload.file}设置失败,api无返回`);
+      }
+      if (Number(ret.result) === 1004022) {
+        throw new Error(`头像${payload.file}设置失败，文件可能不是图片格式或权限不足`);
+      } else if (Number(ret.result) !== 0) {
+        throw new Error(`头像${payload.file}设置失败,未知的错误,${ret.result}:${ret.errMsg}`);
+      }
+      return {
+        result: Number(ret.result),
+        errMsg: ret.errMsg,
+      };
+    } else {
+      throw new Error(`头像${payload.file}设置失败,无法获取头像,文件可能不存在`);
+    }
+  }
+}