feat(system): 完成客户端自定义与系统设置

新增管理端客户端自定义标签页、公开与管理端系统设置接口、文件存储设置持久化、数据库迁移、契约类型和 OpenAPI 文档。

apps/web/src/App.tsx

@@ -2,6 +2,8 @@ import { useEffect, useMemo, useRef, useState, type FormEvent } from 'react';
 import type {
   BaseModelCatalogItem,
   CatalogProvider,
+  ClientCustomizationSettings,
+  ClientCustomizationSettingsUpdateRequest,
   FileStorageChannel,
   FileStorageSettings,
   FileStorageSettingsUpdateRequest,
@@ -52,6 +54,7 @@ import {
   deleteTenant,
   deleteUserGroup,
   GatewayApiError,
+  getClientCustomizationSettings,
   getHealth,
   listFileStorageChannels,
   getCurrentUser,
@@ -92,6 +95,7 @@ import {
   type HealthResponse,
   updateAccessRule,
   updateApiKeyScopes,
+  updateClientCustomizationSettings,
   updateFileStorageChannel,
   updateFileStorageSettings,
   updateGatewayUser,
@@ -153,6 +157,7 @@ type DataKey =
   | 'playgroundModels'
   | 'modelCatalog'
   | 'networkProxyConfig'
+  | 'clientCustomizationSettings'
   | 'fileStorageChannels'
   | 'fileStorageSettings'
   | 'platforms'
@@ -201,6 +206,7 @@ export function App() {
   });
   const [playgroundModels, setPlaygroundModels] = useState<PlatformModel[]>([]);
   const [networkProxyConfig, setNetworkProxyConfig] = useState<GatewayNetworkProxyConfig | null>(null);
+  const [clientCustomizationSettings, setClientCustomizationSettings] = useState<ClientCustomizationSettings | null>(null);
   const [fileStorageChannels, setFileStorageChannels] = useState<FileStorageChannel[]>([]);
   const [fileStorageSettings, setFileStorageSettings] = useState<FileStorageSettings | null>(null);
   const [providers, setProviders] = useState<CatalogProvider[]>([]);
@@ -321,6 +327,7 @@ export function App() {
     auditLogs,
     apiKeys,
     baseModels,
+    clientCustomizationSettings,
     currentUser,
     currentUserGroups,
     fileStorageChannels,
@@ -344,7 +351,7 @@ export function App() {
     users,
     walletAccounts,
     walletTransactions,
-  }), [accessRules, apiKeys, auditLogs, baseModels, currentUser, currentUserGroups, fileStorageChannels, fileStorageSettings, modelCatalog, modelRateLimits, modelRateLimitsUpdatedAt, models, networkProxyConfig, platforms, pricingRuleSets, pricingRules, providers, rateLimitWindows, runnerPolicy, runtimePolicySets, taskResult, tasks, tenants, userGroups, users, walletAccounts, walletTransactions]);
+  }), [accessRules, apiKeys, auditLogs, baseModels, clientCustomizationSettings, currentUser, currentUserGroups, fileStorageChannels, fileStorageSettings, modelCatalog, modelRateLimits, modelRateLimitsUpdatedAt, models, networkProxyConfig, platforms, pricingRuleSets, pricingRules, providers, rateLimitWindows, runnerPolicy, runtimePolicySets, taskResult, tasks, tenants, userGroups, users, walletAccounts, walletTransactions]);
 
   async function refresh(nextToken = token) {
     await ensureRouteData(nextToken, true);
@@ -424,6 +431,9 @@ export function App() {
       case 'networkProxyConfig':
         setNetworkProxyConfig(await getNetworkProxyConfig(nextToken));
         return;
+      case 'clientCustomizationSettings':
+        setClientCustomizationSettings(await getClientCustomizationSettings(nextToken));
+        return;
       case 'fileStorageChannels':
         setFileStorageChannels((await listFileStorageChannels(nextToken)).items);
         return;
@@ -952,6 +962,21 @@ export function App() {
     }
   }
 
+  async function saveClientCustomizationSettings(input: ClientCustomizationSettingsUpdateRequest) {
+    setCoreState('loading');
+    setCoreMessage('');
+    try {
+      const settings = await updateClientCustomizationSettings(token, input);
+      setClientCustomizationSettings(settings);
+      setCoreState('ready');
+      setCoreMessage('客户端自定义设置已更新。');
+    } catch (err) {
+      setCoreState('error');
+      setCoreMessage(err instanceof Error ? err.message : '更新客户端自定义设置失败');
+      throw err;
+    }
+  }
+
   async function removeFileStorageChannel(channelId: string) {
     setCoreState('loading');
     setCoreMessage('');
@@ -1233,6 +1258,7 @@ export function App() {
             onSaveAccessRule={saveAccessRule}
             onSaveFileStorageChannel={saveFileStorageChannel}
             onSaveFileStorageSettings={saveFileStorageSettings}
+            onSaveClientCustomizationSettings={saveClientCustomizationSettings}
             onSaveTenant={saveTenant}
             onSaveUser={saveUser}
             onRechargeUserWalletBalance={rechargeUserWallet}
@@ -1452,7 +1478,7 @@ function dataKeysForRoute(
     case 'accessRules':
       return ['accessRules', 'userGroups', 'platforms', 'models'];
     case 'systemSettings':
-      return ['fileStorageSettings', 'fileStorageChannels'];
+      return ['clientCustomizationSettings', 'fileStorageSettings', 'fileStorageChannels'];
     default:
       return [];
   }