feat: Add group album upload utilities and refactor API && close #1116

Introduces src/core/data/webapi.ts with utilities for chunked group album uploads, including session creation and chunk management. Refactors NTQQWebApi in webapi.ts to use these utilities, adds getAlbumList and uploadImageToQunAlbum methods, and improves upload logic for efficiency and maintainability.

src/onebot/action/extends/GetQunAlbumList.ts

@@ -0,0 +1,18 @@
+
+import { OneBotAction } from '@/onebot/action/OneBotAction';
+import { ActionName } from '@/onebot/action/router';
+import { Static, Type } from '@sinclair/typebox';
+const SchemaData = Type.Object({
+    group_id: Type.String()
+});
+
+type Payload = Static<typeof SchemaData>;
+
+export class GetQunAlbumList extends OneBotAction<Payload, unknown> {
+    override actionName = ActionName.GetQunAlbumList;
+    override payloadSchema = SchemaData;
+
+    async _handle(payload: Payload) {
+        return await this.core.apis.WebApi.getAlbumList(payload.group_id);
+    }
+}

src/onebot/action/extends/UploadImageToQunAlbum.ts

@@ -0,0 +1,31 @@
+import { uriToLocalFile } from '@/common/file';
+import { OneBotAction } from '@/onebot/action/OneBotAction';
+import { ActionName } from '@/onebot/action/router';
+import { Static, Type } from '@sinclair/typebox';
+import { existsSync } from 'node:fs';
+import { unlink } from 'node:fs/promises';
+
+const SchemaData = Type.Object({
+    group_id: Type.String(),
+    album_id: Type.String(),
+    album_name: Type.String(),
+    file: Type.String()
+});
+
+type Payload = Static<typeof SchemaData>;
+
+export class UploadImageToQunAlbum extends OneBotAction<Payload, unknown> {
+    override actionName = ActionName.UploadImageToQunAlbum;
+    override payloadSchema = SchemaData;
+
+    async _handle(payload: Payload) {
+        const downloadResult = await uriToLocalFile(this.core.NapCatTempPath, payload.file);
+        try {
+            return await this.core.apis.WebApi.uploadImageToQunAlbum(payload.group_id, payload.album_id, payload.album_name, downloadResult.path);
+        } finally {
+            if (downloadResult.path && existsSync(downloadResult.path)) {
+                await unlink(downloadResult.path);
+            }
+        }
+    }
+}

src/onebot/action/index.ts

@@ -124,10 +124,14 @@ import { GetGroupDetailInfo } from './group/GetGroupDetailInfo';
 import GetGroupAddRequest from './extends/GetGroupAddRequest';
 import { GetCollectionList } from './extends/GetCollectionList';
 import { SetGroupTodo } from './packet/SetGroupTodo';
+import { GetQunAlbumList } from './extends/GetQunAlbumList';
+import { UploadImageToQunAlbum } from './extends/UploadImageToQunAlbum';
 
 export function createActionMap(obContext: NapCatOneBot11Adapter, core: NapCatCore) {
 
     const actionHandlers = [
+        new GetQunAlbumList(obContext, core),
+        new UploadImageToQunAlbum(obContext, core),
         new SetGroupTodo(obContext, core),
         new GetGroupDetailInfo(obContext, core),
         new SetGroupKickMembers(obContext, core),

src/onebot/action/router.ts

@@ -10,6 +10,8 @@ export interface InvalidCheckResult {
 }
 
 export const ActionName = {
+    UploadImageToQunAlbum: 'upload_image_to_qun_album',
+    GetQunAlbumList: 'get_qun_album_list',
     SetGroupTodo: 'set_group_todo',
     SetGroupKickMembers: 'set_group_kick_members',
     SetGroupRobotAddOption: 'set_group_robot_add_option',