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/extends/SetQQAvatar.ts

@@ -0,0 +1,52 @@
+import { OneBotAction } from '@/snowcat-onebot/action/OneBotAction';
+import { ActionName } from '@/snowcat-onebot/action/router';
+import fs from 'node:fs/promises';
+import { checkFileExist, uriToLocalFile } from 'snowcat-common/src/file';
+import { Static, Type } from '@sinclair/typebox';
+
+import { ExtendsActionsExamples } from '../example/ExtendsActionsExamples';
+
+const PayloadSchema = Type.Object({
+  file: Type.String({ description: '图片路径、URL或Base64' }),
+});
+
+type PayloadType = Static<typeof PayloadSchema>;
+
+const ReturnSchema = Type.Null({ description: '设置结果' });
+
+type ReturnType = Static<typeof ReturnSchema>;
+
+export default class SetAvatar extends OneBotAction<PayloadType, ReturnType> {
+  override actionName = ActionName.SetQQAvatar;
+  override payloadSchema = PayloadSchema;
+  override returnSchema = ReturnSchema;
+  override actionSummary = '设置QQ头像';
+  override actionDescription = '修改当前账号的QQ头像';
+  override actionTags = ['扩展接口'];
+  override payloadExample = ExtendsActionsExamples.SetQQAvatar.payload;
+  override returnExample = ExtendsActionsExamples.SetQQAvatar.response;
+
+  async _handle (payload: PayloadType): Promise<ReturnType> {
+    const { path, success, isLocal } = (await uriToLocalFile(this.core.SnowCatTempPath, payload.file));
+    if (!success) {
+      throw new Error(`头像${payload.file}设置失败,file字段可能格式不正确`);
+    }
+    if (path) {
+      await checkFileExist(path, 5000);// 避免崩溃
+      const ret = await this.core.apis.UserApi.setQQAvatar(path);
+      if (!isLocal) fs.unlink(path).catch(() => { });
+      if (!ret) {
+        throw new Error(`头像${payload.file}设置失败,api无返回`);
+      }
+      // log(`头像设置返回：${JSON.stringify(ret)}`)
+      if (Number(ret.result) === 1004022) {
+        throw new Error(`头像${payload.file}设置失败，文件可能不是图片格式`);
+      } else if (ret.result !== 0) {
+        throw new Error(`头像${payload.file}设置失败,未知的错误,${ret.result}:${ret.errMsg}`);
+      }
+    } else {
+      throw new Error(`头像${payload.file}设置失败,无法获取头像,文件可能不存在`);
+    }
+    return null;
+  }
+}