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/data/album.ts

@@ -0,0 +1,212 @@
+/**
+ * 群相册列表请求参数接口
+ */
+export interface AlbumListRequest {
+  qun_id: string;
+  attach_info: string;
+  seq: number;
+  request_time_line: {
+    request_invoke_time: string;
+  };
+  album_id: string;
+  lloc: string;
+  batch_id: string;
+}
+
+/**
+ * 创建群相册列表请求参数
+ * @param qunId 群号
+ * @param albumId 相册ID
+ * @param seq 请求序列号，默认值为0
+ * @returns 请求参数对象
+ */
+export function createAlbumListRequest (
+  qunId: string,
+  albumId: string,
+  seq: number = 0
+): AlbumListRequest {
+  return {
+    qun_id: qunId,
+    attach_info: '',
+    seq,
+    request_time_line: {
+      request_invoke_time: '0',
+    },
+    album_id: albumId,
+    lloc: '',
+    batch_id: '',
+  };
+}
+
+/**
+ * 相册媒体项请求接口
+ */
+export interface AlbumMediaFeed {
+  cell_common: {
+    time: string;
+  };
+  cell_user_info: {
+    user: {
+      uin: string;
+    };
+  };
+  cell_media: {
+    album_id: string;
+    batch_id: string;
+    media_items: Array<{
+      image: {
+        lloc: string;
+      };
+    }>;
+  };
+}
+
+/**
+ * 创建相册媒体请求参数
+ * @param uin 用户QQ号
+ * @param albumId 相册ID
+ * @param lloc
+ * @returns 媒体请求参数对象
+ */
+export function createAlbumMediaFeed (
+  uin: string,
+  albumId: string,
+  lloc: string
+): AlbumMediaFeed {
+  return {
+    cell_common: {
+      time: '',
+    },
+    cell_user_info: {
+      user: {
+        uin,
+      },
+    },
+    cell_media: {
+      album_id: albumId,
+      batch_id: '',
+      media_items: [{
+        image: {
+          lloc,
+        },
+      }],
+    },
+  };
+}
+/**
+ * 相册评论内容接口
+ */
+export interface AlbumCommentContent {
+  type: number;
+  content: string;
+  who: number;
+  uid: string;
+  name: string;
+  url: string;
+}
+
+/**
+ * 相册评论请求接口
+ */
+export interface AlbumCommentReplyContent {
+  client_key: number;
+  content: AlbumCommentContent[];
+  user: {
+    uin: string;
+  };
+}
+export enum RichMsgType {
+  KRICHMSGTYPEPLAINTEXT,
+  KRICHMSGTYPEAT,
+  KRICHMSGTYPEURL,
+  KRICHMSGTYPEMEDIA,
+}
+
+/**
+ * 创建相册评论请求参数
+ * @param uin 用户QQ号
+ * @param content 评论内容
+ * @param client_key 客户端鉴权密钥
+ * @returns 评论请求参数对象
+ */
+export function createAlbumCommentRequest (
+  uin: string,
+  content: string,
+  client_key: number
+): AlbumCommentReplyContent {
+  return {
+    client_key,
+    // 暂时只支持纯文本吧
+    content: [{
+      type: RichMsgType.KRICHMSGTYPEPLAINTEXT,
+      content,
+      who: 0,
+      uid: '',
+      name: '',
+      url: '',
+    }],
+    user: {
+      uin,
+    },
+  };
+}
+
+export interface AlbumFeedLikePublish {
+  cell_common: {
+    time: number;
+    feed_id: string;
+  };
+  cell_user_info: {
+    user: {
+      uin: string;
+    };
+  };
+  cell_media: {
+    album_id: string;
+    batch_id: string | number;
+    media_items?: {
+      type: number;
+      image: {
+        lloc: string;
+        sloc: string;
+      };
+    }[];
+  };
+  cell_qun_info: {
+    qun_id: string;
+  };
+}
+
+/**
+ * 创建相册动态发布请求参数
+ * @param qunId 群号
+ * @param uin 用户QQ号
+ * @param albumId 相册ID
+ * @param batchId 批次ID
+ * @returns 动态发布请求参数对象
+ */
+export function createAlbumFeedPublish (
+  qunId: string,
+  uin: string,
+  albumId: string,
+  batchId: string
+) {
+  return {
+    cell_common: {
+      time: Date.now(),
+      feed_id: `422_0_${batchId}`, // 需要补全feed_id
+    },
+    cell_user_info: {
+      user: {
+        uin,
+      },
+    },
+    cell_media: {
+      album_id: albumId,
+      batch_id: batchId,
+    },
+    cell_qun_info: {
+      qun_id: qunId,
+    },
+  };
+}