refactor(*): 代码质量治理 - 收敛接口客户端、模型职责与异步计费巡检

web/src/services/api/request.ts

@@ -1,5 +1,30 @@
+import axios from "axios";
+
 export type ApiParams = Record<string, string | string[] | number | number[] | undefined>;
 
+export type BackendEnvelope<T> = {
+    code: number;
+    data: T;
+    msg: string;
+};
+
+// 所有后端 JSON 请求共用同一实例，避免认证、Base URL 和错误语义在模块间漂移。
+export const apiBaseURL = import.meta.env.VITE_CANVAS_BACKEND_URL || "/api";
+export const apiClient = axios.create({ baseURL: apiBaseURL, withCredentials: true });
+
+export async function request<T>(promise: Promise<{ data: BackendEnvelope<T> }>) {
+    try {
+        const response = await promise;
+        if (response.data.code !== 0) throw new Error(response.data.msg || "请求失败");
+        return response.data.data;
+    } catch (error) {
+        if (axios.isAxiosError<BackendEnvelope<unknown>>(error)) {
+            throw new Error(error.response?.data?.msg || error.message || "请求失败");
+        }
+        throw error;
+    }
+}
+
 export function compactApiParams(params: ApiParams) {
     return Object.fromEntries(Object.entries(params).filter(([, value]) => value !== "" && value !== undefined && (!Array.isArray(value) || value.length > 0))) as ApiParams;
 }