feat(admin): 存储管理 - 新增资源只读查询、统计与预览

Adapted from ddcat-ai/open-ai-canvas#339

Original commit: fcdbe2aa833f31f683f709b7f409a0534ed78e20

Refs #339

Co-authored-by: 宇熙 <101980758+yuxiwl@users.noreply.github.com>

web/src/services/api/admin-storage.ts

@@ -0,0 +1,84 @@
+import { apiBaseURL, apiClient, compactApiParams, request } from "@/services/api/request";
+
+export type AdminStorageResource = {
+    id: string;
+    userId: string;
+    userName: string;
+    kind: "image" | "video" | "audio" | "file" | string;
+    status: "pending" | "ready" | "failed" | "deleted" | string;
+    provider: string;
+    bucket?: string;
+    objectKey: string;
+    mimeType: string;
+    size: number;
+    physicalBytes: number;
+    width: number;
+    height: number;
+    durationMs: number;
+    fileUrl: string;
+    createdAt: string;
+    updatedAt: string;
+};
+
+export type AdminResourcePage = {
+    items: AdminStorageResource[];
+    total: number;
+    page: number;
+    limit: number;
+};
+
+export type AdminStorageDimensionStat = {
+    count: number;
+    logicalBytes: number;
+    physicalBytes: number;
+};
+
+export type AdminStorageStats = {
+    resourceCount: number;
+    readyCount: number;
+    logicalBytes: number;
+    physicalBytes: number;
+    localBytes: number;
+    remoteBytes: number;
+    byKind: Array<AdminStorageDimensionStat & { kind: string }>;
+    byProvider: Array<AdminStorageDimensionStat & { provider: string }>;
+};
+
+export type AdminResourceQuery = {
+    keyword?: string;
+    kind?: string;
+    status?: string;
+    provider?: string;
+    userId?: string;
+    page?: number;
+    limit?: number;
+};
+
+export async function listAdminResources(query: AdminResourceQuery, signal?: AbortSignal) {
+    return request<AdminResourcePage>(apiClient.get("/admin/resources", { params: compactApiParams(query), signal }));
+}
+
+export async function getAdminStorageStats(signal?: AbortSignal) {
+    const result = await request<{ stats: AdminStorageStats }>(apiClient.get("/admin/storage/stats", { signal }));
+    return result.stats;
+}
+
+export function adminResourceFileUrl(id: string, download = false) {
+    const base = String(apiBaseURL).replace(/\/+$/, "");
+    return `${base}/admin/resources/${encodeURIComponent(id)}/file${download ? "?download=1" : ""}`;
+}
+
+export async function downloadAdminResource(resource: AdminStorageResource) {
+    const response = await fetch(adminResourceFileUrl(resource.id, true), { credentials: "include" });
+    if (!response.ok) {
+        let message = "下载资源失败";
+        try {
+            const body = (await response.json()) as { msg?: string };
+            if (body.msg) message = body.msg;
+        } catch {
+            // 文件接口失败时不保证返回 JSON。
+        }
+        throw new Error(message);
+    }
+    return response.blob();
+}