From 26b4a373237439d5643c0c1172bf5fe23228095a Mon Sep 17 00:00:00 2001
From: hoping <htmambo@gmail.com>
Date: Thu, 25 Dec 2025 00:02:56 +0800
Subject: [PATCH 1/2] =?UTF-8?q?feat:=20=E5=BC=95=E5=85=A5=E7=BB=9F?=
 =?UTF-8?q?=E4=B8=80=E7=9A=84=E7=AB=AF=E7=82=B9=E6=A3=80=E6=9F=A5=E5=99=A8?=
 =?UTF-8?q?=E4=BB=A5=E9=87=8D=E6=9E=84=E9=80=82=E9=85=8D=E5=99=A8=E5=B9=B6?=
 =?UTF-8?q?=E6=94=B9=E8=BF=9B=E9=94=99=E8=AF=AF=E5=A4=84=E7=90=86=E5=92=8C?=
 =?UTF-8?q?=E7=94=A8=E9=87=8F=E7=BB=9F=E8=AE=A1=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/src/api/endpoints/providers.ts       |   13 +
 frontend/src/components/ui/dialog/Dialog.vue  |    2 +
 frontend/src/composables/useConfirm.ts        |    4 +-
 frontend/src/composables/useEscapeKey.ts      |   11 +-
 .../components/ModelMappingDialog.vue         |   11 +-
 .../components/ProviderDetailDrawer.vue       |    8 +-
 .../provider-tabs/ModelAliasesTab.vue         |  116 +-
 .../components/provider-tabs/ModelsTab.vue    |   79 +-
 frontend/src/stores/users.ts                  |   16 +-
 .../src/views/admin/ProviderManagement.vue    |   16 +-
 frontend/src/views/admin/Users.vue            |   17 +-
 frontend/src/views/public/Home.vue            |    8 +-
 src/api/admin/provider_query.py               |  236 ++++
 src/api/handlers/base/chat_adapter_base.py    |   87 ++
 src/api/handlers/base/cli_adapter_base.py     |  140 ++
 src/api/handlers/base/endpoint_checker.py     | 1252 +++++++++++++++++
 src/api/handlers/claude/adapter.py            |   32 +
 src/api/handlers/claude_cli/adapter.py        |   38 +-
 src/api/handlers/gemini/adapter.py            |   91 +-
 src/api/handlers/gemini_cli/adapter.py        |   48 +-
 src/api/handlers/openai/adapter.py            |   30 +-
 src/api/handlers/openai_cli/adapter.py        |   34 +-
 tests/api/handlers/base/test_utils.py         |  112 +-
 23 files changed, 2282 insertions(+), 119 deletions(-)
 create mode 100644 src/api/handlers/base/endpoint_checker.py

diff --git a/frontend/src/api/endpoints/providers.ts b/frontend/src/api/endpoints/providers.ts
index b70996b..8fcd183 100644
--- a/frontend/src/api/endpoints/providers.ts
+++ b/frontend/src/api/endpoints/providers.ts
@@ -58,3 +58,16 @@ export async function deleteProvider(providerId: string): Promise<{ message: str
   return response.data
 }
 
+/**
+ * 测试模型连接性
+ */
+export async function testModel(data: {
+  provider_id: string
+  model_name: string
+  api_key_id?: string
+  message?: string
+}): Promise<any> {
+  const response = await client.post('/api/admin/provider-query/test-model', data)
+  return response.data
+}
+
diff --git a/frontend/src/components/ui/dialog/Dialog.vue b/frontend/src/components/ui/dialog/Dialog.vue
index 9e45f5f..c0cba50 100644
--- a/frontend/src/components/ui/dialog/Dialog.vue
+++ b/frontend/src/components/ui/dialog/Dialog.vue
@@ -163,7 +163,9 @@ const contentZIndex = computed(() => (props.zIndex || 60) + 10)
 useEscapeKey(() => {
   if (isOpen.value) {
     handleClose()
+    return true  // 阻止其他监听器（如父级抽屉的 ESC 监听器）
   }
+  return false
 }, {
   disableOnInput: true,
   once: false
diff --git a/frontend/src/composables/useConfirm.ts b/frontend/src/composables/useConfirm.ts
index f821235..f9ef15f 100644
--- a/frontend/src/composables/useConfirm.ts
+++ b/frontend/src/composables/useConfirm.ts
@@ -47,11 +47,11 @@ export function useConfirm() {
   /**
    * 便捷方法：危险操作确认（红色主题）
    */
-  const confirmDanger = (message: string, title?: string): Promise<boolean> => {
+  const confirmDanger = (message: string, title?: string, confirmText?: string): Promise<boolean> => {
     return confirm({
       message,
       title: title || '危险操作',
-      confirmText: '删除',
+      confirmText: confirmText || '删除',
       variant: 'danger'
     })
   }
diff --git a/frontend/src/composables/useEscapeKey.ts b/frontend/src/composables/useEscapeKey.ts
index 4d85c65..84604a6 100644
--- a/frontend/src/composables/useEscapeKey.ts
+++ b/frontend/src/composables/useEscapeKey.ts
@@ -4,11 +4,11 @@ import { onMounted, onUnmounted, ref } from 'vue'
  * ESC 键监听 Composable（简化版本，直接使用独立监听器）
  * 用于按 ESC 键关闭弹窗或其他可关闭的组件
  *
- * @param callback - 按 ESC 键时执行的回调函数
+ * @param callback - 按 ESC 键时执行的回调函数，返回 true 表示已处理事件，阻止其他监听器执行
  * @param options - 配置选项
  */
 export function useEscapeKey(
-  callback: () => void,
+  callback: () => void | boolean,
   options: {
     /** 是否在输入框获得焦点时禁用 ESC 键，默认 true */
     disableOnInput?: boolean
@@ -42,8 +42,11 @@ export function useEscapeKey(
       if (isInputElement) return
     }
 
-    // 执行回调
-    callback()
+    // 执行回调，如果返回 true 则阻止其他监听器
+    const handled = callback()
+    if (handled === true) {
+      event.stopImmediatePropagation()
+    }
 
     // 移除当前元素的焦点，避免残留样式
     if (document.activeElement instanceof HTMLElement) {
diff --git a/frontend/src/features/providers/components/ModelMappingDialog.vue b/frontend/src/features/providers/components/ModelMappingDialog.vue
index ce5f84f..ef243b7 100644
--- a/frontend/src/features/providers/components/ModelMappingDialog.vue
+++ b/frontend/src/features/providers/components/ModelMappingDialog.vue
@@ -17,7 +17,7 @@
             v-model:open="modelSelectOpen"
             :model-value="formData.modelId"
             :disabled="!!editingGroup"
-            @update:model-value="formData.modelId = $event"
+            @update:model-value="handleModelChange"
           >
             <SelectTrigger class="h-9">
               <SelectValue placeholder="请选择模型" />
@@ -518,6 +518,15 @@ function initForm() {
     upstreamModels.value = []
   }
 }
+ 
+// 处理模型选择变更
+function handleModelChange(value: string) {
+  formData.value.modelId = value
+  const selectedModel = props.models.find(m => m.id === value)
+  if (selectedModel) {
+    upstreamModelSearch.value = selectedModel.provider_model_name
+  }
+}
 
 // 切换 API 格式
 function toggleApiFormat(format: string) {
diff --git a/frontend/src/features/providers/components/ProviderDetailDrawer.vue b/frontend/src/features/providers/components/ProviderDetailDrawer.vue
index d4aef38..fdde2a9 100644
--- a/frontend/src/features/providers/components/ProviderDetailDrawer.vue
+++ b/frontend/src/features/providers/components/ProviderDetailDrawer.vue
@@ -531,6 +531,7 @@
               <!-- 模型名称映射 -->
               <ModelAliasesTab
                 v-if="provider"
+                ref="modelAliasesTabRef"
                 :key="`aliases-${provider.id}`"
                 :provider="provider"
                 @refresh="handleRelatedDataRefresh"
@@ -735,6 +736,9 @@ const deleteModelConfirmOpen = ref(false)
 const modelToDelete = ref<Model | null>(null)
 const batchAssignDialogOpen = ref(false)
 
+// ModelAliasesTab 组件引用
+const modelAliasesTabRef = ref<InstanceType<typeof ModelAliasesTab> | null>(null)
+
 // 拖动排序相关状态
 const dragState = ref({
   isDragging: false,
@@ -756,7 +760,9 @@ const hasBlockingDialogOpen = computed(() =>
   deleteKeyConfirmOpen.value ||
   modelFormDialogOpen.value ||
   deleteModelConfirmOpen.value ||
-  batchAssignDialogOpen.value
+  batchAssignDialogOpen.value ||
+  // 检测 ModelAliasesTab 子组件的 Dialog 是否打开
+  modelAliasesTabRef.value?.dialogOpen
 )
 
 // 监听 providerId 变化
diff --git a/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue b/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
index 6115b8c..7d2aff7 100644
--- a/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
+++ b/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
@@ -110,16 +110,30 @@
             <div
               v-for="mapping in group.aliases"
               :key="mapping.name"
-              class="flex items-center gap-2 py-1"
+              class="flex items-center justify-between gap-2 py-1"
             >
-              <!-- 优先级标签 -->
-              <span class="inline-flex items-center justify-center w-5 h-5 rounded bg-background border text-xs font-medium shrink-0">
-                {{ mapping.priority }}
-              </span>
-              <!-- 映射名称 -->
-              <span class="font-mono text-sm truncate">
-                {{ mapping.name }}
-              </span>
+              <div class="flex items-center gap-2 flex-1 min-w-0">
+                <!-- 优先级标签 -->
+                <span class="inline-flex items-center justify-center w-5 h-5 rounded bg-background border text-xs font-medium shrink-0">
+                  {{ mapping.priority }}
+                </span>
+                <!-- 映射名称 -->
+                <span class="font-mono text-sm truncate">
+                  {{ mapping.name }}
+                </span>
+              </div>
+              <!-- 测试按钮 -->
+              <Button
+                variant="ghost"
+                size="icon"
+                class="h-7 w-7 shrink-0"
+                title="测试映射"
+                :disabled="testingMapping === `${group.model.id}-${group.apiFormatsKey}-${mapping.name}`"
+                @click="testMapping(group, mapping)"
+              >
+                <Loader2 v-if="testingMapping === `${group.model.id}-${group.apiFormatsKey}-${mapping.name}`" class="w-3 h-3 animate-spin" />
+                <Play v-else class="w-3 h-3" />
+              </Button>
             </div>
           </div>
         </div>
@@ -166,13 +180,14 @@
 
 <script setup lang="ts">
 import { ref, computed, onMounted, watch } from 'vue'
-import { Tag, Plus, Edit, Trash2, ChevronRight } from 'lucide-vue-next'
+import { Tag, Plus, Edit, Trash2, ChevronRight, Loader2, Play } from 'lucide-vue-next'
 import { Card, Button, Badge } from '@/components/ui'
 import AlertDialog from '@/components/common/AlertDialog.vue'
 import ModelMappingDialog, { type AliasGroup } from '../ModelMappingDialog.vue'
 import { useToast } from '@/composables/useToast'
 import {
   getProviderModels,
+  testModel,
   API_FORMAT_LABELS,
   type Model,
   type ProviderModelAlias
@@ -196,6 +211,7 @@ const dialogOpen = ref(false)
 const deleteConfirmOpen = ref(false)
 const editingGroup = ref<AliasGroup | null>(null)
 const deletingGroup = ref<AliasGroup | null>(null)
+const testingMapping = ref<string | null>(null)
 
 // 列表展开状态
 const expandedAliasGroups = ref<Set<string>>(new Set())
@@ -337,6 +353,81 @@ async function onDialogSaved() {
   emit('refresh')
 }
 
+// 测试模型映射
+async function testMapping(group: any, mapping: any) {
+  const testingKey = `${group.model.id}-${group.apiFormatsKey}-${mapping.name}`
+  testingMapping.value = testingKey
+
+  try {
+    // 根据分组的 API 格式来确定应该使用的格式
+    let apiFormat = null
+    if (group.apiFormats.length === 1) {
+      apiFormat = group.apiFormats[0]
+    } else if (group.apiFormats.length === 0) {
+      // 如果没有指定格式，但分组显示为"全部"，则使用模型的默认格式
+      apiFormat = group.model.effective_api_format || group.model.api_format
+    }
+
+    console.log(`测试映射 ${mapping.name}，使用 API Format: ${apiFormat}`)
+
+    const result = await testModel({
+      provider_id: props.provider.id,
+      model_name: mapping.name,  // 使用映射名称进行测试
+      message: "hello",
+      api_format: apiFormat
+    })
+
+    if (result.success) {
+      showSuccess(`映射 "${mapping.name}" 测试成功`)
+
+      // 如果有响应内容，可以显示更多信息
+      if (result.data?.response?.choices?.[0]?.message?.content) {
+        const content = result.data.response.choices[0].message.content
+        showSuccess(`测试成功，响应: ${content.substring(0, 100)}${content.length > 100 ? '...' : ''}`)
+      } else if (result.data?.content_preview) {
+        showSuccess(`流式测试成功，预览: ${result.data.content_preview}`)
+      }
+    } else {
+      // 根据不同的错误类型显示更详细的信息
+      let errorMsg = result.error || '测试失败'
+
+      // 检查HTTP状态码错误
+      if (result.data?.response?.status_code) {
+        const status = result.data.response.status_code
+        if (status === 403) {
+          errorMsg = '认证失败: API密钥无效或客户端类型不被允许'
+        } else if (status === 401) {
+          errorMsg = '认证失败: API密钥无效或已过期'
+        } else if (status === 404) {
+          errorMsg = '模型不存在: 请检查模型名称是否正确'
+        } else if (status === 429) {
+          errorMsg = '请求频率过高: 请稍后重试'
+        } else if (status >= 500) {
+          errorMsg = `服务器错误: HTTP ${status}`
+        } else {
+          errorMsg = `请求失败: HTTP ${status}`
+        }
+      }
+
+      // 尝试从错误响应中提取更多信息
+      if (result.data?.response?.error) {
+        if (typeof result.data.response.error === 'string') {
+          errorMsg = result.data.response.error
+        } else if (result.data.response.error?.message) {
+          errorMsg = result.data.response.error.message
+        }
+      }
+
+      showError(`映射测试失败: ${errorMsg}`)
+    }
+  } catch (err: any) {
+    const errorMsg = err.response?.data?.detail || err.message || '测试请求失败'
+    showError(`映射测试失败: ${errorMsg}`)
+  } finally {
+    testingMapping.value = null
+  }
+}
+
 // 监听 provider 变化
 watch(() => props.provider?.id, (newId) => {
   if (newId) {
@@ -349,4 +440,9 @@ onMounted(() => {
     loadModels()
   }
 })
+
+// 暴露给父组件，用于检测是否有弹窗打开
+defineExpose({
+  dialogOpen: computed(() => dialogOpen.value || deleteConfirmOpen.value)
+})
 </script>
diff --git a/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue b/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
index 1465c4e..628a8fa 100644
--- a/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
+++ b/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
@@ -156,6 +156,17 @@
             </td>
             <td class="align-top px-4 py-3">
               <div class="flex justify-center gap-1.5">
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  class="h-8 w-8"
+                  title="测试模型"
+                  :disabled="testingModelId === model.id"
+                  @click="testModelConnection(model)"
+                >
+                  <Loader2 v-if="testingModelId === model.id" class="w-3.5 h-3.5 animate-spin" />
+                  <Play v-else class="w-3.5 h-3.5" />
+                </Button>
                 <Button
                   variant="ghost"
                   size="icon"
@@ -209,11 +220,11 @@
 
 <script setup lang="ts">
 import { ref, computed, onMounted } from 'vue'
-import { Box, Edit, Trash2, Layers, Eye, Wrench, Zap, Brain, Power, Copy, Image } from 'lucide-vue-next'
+import { Box, Edit, Trash2, Layers, Eye, Wrench, Zap, Brain, Power, Copy, Image, Loader2, Play } from 'lucide-vue-next'
 import Card from '@/components/ui/card.vue'
 import Button from '@/components/ui/button.vue'
 import { useToast } from '@/composables/useToast'
-import { getProviderModels, type Model } from '@/api/endpoints'
+import { getProviderModels, testModel, type Model } from '@/api/endpoints'
 import { updateModel } from '@/api/endpoints/models'
 
 const props = defineProps<{
@@ -232,6 +243,7 @@ const { error: showError, success: showSuccess } = useToast()
 const loading = ref(false)
 const models = ref<Model[]>([])
 const togglingModelId = ref<string | null>(null)
+const testingModelId = ref<string | null>(null)
 
 // 按名称排序的模型列表
 const sortedModels = computed(() => {
@@ -380,6 +392,69 @@ async function toggleModelActive(model: Model) {
   }
 }
 
+// 测试模型连接性
+async function testModelConnection(model: Model) {
+  if (testingModelId.value) return
+
+  testingModelId.value = model.id
+  try {
+    const result = await testModel({
+      provider_id: props.provider.id,
+      model_name: model.provider_model_name,
+      message: "hello"
+    })
+
+    if (result.success) {
+      showSuccess(`模型 "${model.provider_model_name}" 测试成功`)
+
+      // 如果有响应内容，可以显示更多信息
+      if (result.data?.response?.choices?.[0]?.message?.content) {
+        const content = result.data.response.choices[0].message.content
+        showSuccess(`测试成功，响应: ${content.substring(0, 100)}${content.length > 100 ? '...' : ''}`)
+      } else if (result.data?.content_preview) {
+        showSuccess(`流式测试成功，预览: ${result.data.content_preview}`)
+      }
+    } else {
+      // 根据不同的错误类型显示更详细的信息
+      let errorMsg = result.error || '测试失败'
+
+      // 检查HTTP状态码错误
+      if (result.data?.response?.status_code) {
+        const status = result.data.response.status_code
+        if (status === 403) {
+          errorMsg = '认证失败: API密钥无效或客户端类型不被允许'
+        } else if (status === 401) {
+          errorMsg = '认证失败: API密钥无效或已过期'
+        } else if (status === 404) {
+          errorMsg = '模型不存在: 请检查模型名称是否正确'
+        } else if (status === 429) {
+          errorMsg = '请求频率过高: 请稍后重试'
+        } else if (status >= 500) {
+          errorMsg = `服务器错误: HTTP ${status}`
+        } else {
+          errorMsg = `请求失败: HTTP ${status}`
+        }
+      }
+
+      // 尝试从错误响应中提取更多信息
+      if (result.data?.response?.error) {
+        if (typeof result.data.response.error === 'string') {
+          errorMsg = result.data.response.error
+        } else if (result.data.response.error?.message) {
+          errorMsg = result.data.response.error.message
+        }
+      }
+
+      showError(`模型测试失败: ${errorMsg}`)
+    }
+  } catch (err: any) {
+    const errorMsg = err.response?.data?.detail || err.message || '测试请求失败'
+    showError(`模型测试失败: ${errorMsg}`)
+  } finally {
+    testingModelId.value = null
+  }
+}
+
 onMounted(() => {
   loadModels()
 })
diff --git a/frontend/src/stores/users.ts b/frontend/src/stores/users.ts
index 643b205..af935f9 100644
--- a/frontend/src/stores/users.ts
+++ b/frontend/src/stores/users.ts
@@ -14,7 +14,7 @@ export const useUsersStore = defineStore('users', () => {
     try {
       users.value = await usersApi.getAllUsers()
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '获取用户列表失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '获取用户列表失败'
     } finally {
       loading.value = false
     }
@@ -29,7 +29,7 @@ export const useUsersStore = defineStore('users', () => {
       users.value.push(newUser)
       return newUser
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '创建用户失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '创建用户失败'
       throw err
     } finally {
       loading.value = false
@@ -52,7 +52,7 @@ export const useUsersStore = defineStore('users', () => {
       }
       return updatedUser
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '更新用户失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '更新用户失败'
       throw err
     } finally {
       loading.value = false
@@ -67,7 +67,7 @@ export const useUsersStore = defineStore('users', () => {
       await usersApi.deleteUser(userId)
       users.value = users.value.filter(u => u.id !== userId)
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '删除用户失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '删除用户失败'
       throw err
     } finally {
       loading.value = false
@@ -78,7 +78,7 @@ export const useUsersStore = defineStore('users', () => {
     try {
       return await usersApi.getUserApiKeys(userId)
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '获取 API Keys 失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '获取 API Keys 失败'
       throw err
     }
   }
@@ -87,7 +87,7 @@ export const useUsersStore = defineStore('users', () => {
     try {
       return await usersApi.createApiKey(userId, name)
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '创建 API Key 失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '创建 API Key 失败'
       throw err
     }
   }
@@ -96,7 +96,7 @@ export const useUsersStore = defineStore('users', () => {
     try {
       await usersApi.deleteApiKey(userId, keyId)
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '删除 API Key 失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '删除 API Key 失败'
       throw err
     }
   }
@@ -110,7 +110,7 @@ export const useUsersStore = defineStore('users', () => {
       // 刷新用户列表以获取最新数据
       await fetchUsers()
     } catch (err: any) {
-      error.value = err.response?.data?.detail || '重置配额失败'
+      error.value = err.response?.data?.error?.message || err.response?.data?.detail || '重置配额失败'
       throw err
     } finally {
       loading.value = false
diff --git a/frontend/src/views/admin/ProviderManagement.vue b/frontend/src/views/admin/ProviderManagement.vue
index 05cc008..500220b 100644
--- a/frontend/src/views/admin/ProviderManagement.vue
+++ b/frontend/src/views/admin/ProviderManagement.vue
@@ -723,9 +723,19 @@ async function handleDeleteProvider(provider: ProviderWithEndpointsSummary) {
 // 切换提供商状态
 async function toggleProviderStatus(provider: ProviderWithEndpointsSummary) {
   try {
-    await updateProvider(provider.id, { is_active: !provider.is_active })
-    provider.is_active = !provider.is_active
-    showSuccess(provider.is_active ? '提供商已启用' : '提供商已停用')
+    const newStatus = !provider.is_active
+    await updateProvider(provider.id, { is_active: newStatus })
+
+    // 更新抽屉内部的 provider 对象
+    provider.is_active = newStatus
+
+    // 同时更新主页面 providers 数组中的对象，实现无感更新
+    const targetProvider = providers.value.find(p => p.id === provider.id)
+    if (targetProvider) {
+      targetProvider.is_active = newStatus
+    }
+
+    showSuccess(newStatus ? '提供商已启用' : '提供商已停用')
   } catch (err: any) {
     showError(err.response?.data?.detail || '操作失败', '错误')
   }
diff --git a/frontend/src/views/admin/Users.vue b/frontend/src/views/admin/Users.vue
index deaac38..3ee627a 100644
--- a/frontend/src/views/admin/Users.vue
+++ b/frontend/src/views/admin/Users.vue
@@ -875,7 +875,8 @@ async function toggleUserStatus(user: any) {
   const action = user.is_active ? '禁用' : '启用'
   const confirmed = await confirmDanger(
     `确定要${action}用户 ${user.username} 吗？`,
-    `${action}用户`
+    `${action}用户`,
+    action
   )
 
   if (!confirmed) return
@@ -884,7 +885,7 @@ async function toggleUserStatus(user: any) {
     await usersStore.updateUser(user.id, { is_active: !user.is_active })
     success(`用户已${action}`)
   } catch (err: any) {
-    error(err.response?.data?.detail || '未知错误', `${action}用户失败`)
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', `${action}用户失败`)
   }
 }
 
@@ -955,7 +956,7 @@ async function handleUserFormSubmit(data: UserFormData & { password?: string })
     closeUserFormDialog()
   } catch (err: any) {
     const title = data.id ? '更新用户失败' : '创建用户失败'
-    error(err.response?.data?.detail || '未知错误', title)
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', title)
   } finally {
     userFormDialogRef.value?.setSaving(false)
   }
@@ -989,7 +990,7 @@ async function createApiKey() {
     showNewApiKeyDialog.value = true
     await loadUserApiKeys(selectedUser.value.id)
   } catch (err: any) {
-    error(err.response?.data?.detail || '未知错误', '创建 API Key 失败')
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', '创建 API Key 失败')
   } finally {
     creatingApiKey.value = false
   }
@@ -1026,7 +1027,7 @@ async function deleteApiKey(apiKey: any) {
     await loadUserApiKeys(selectedUser.value.id)
     success('API Key已删除')
   } catch (err: any) {
-    error(err.response?.data?.detail || '未知错误', '删除 API Key 失败')
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', '删除 API Key 失败')
   }
 }
 
@@ -1038,7 +1039,7 @@ async function copyFullKey(apiKey: any) {
     success('完整密钥已复制到剪贴板')
   } catch (err: any) {
     log.error('复制密钥失败:', err)
-    error(err.response?.data?.detail || '未知错误', '复制密钥失败')
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', '复制密钥失败')
   }
 }
 
@@ -1054,7 +1055,7 @@ async function resetQuota(user: any) {
     await usersStore.resetUserQuota(user.id)
     success('配额已重置')
   } catch (err: any) {
-    error(err.response?.data?.detail || '未知错误', '重置配额失败')
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', '重置配额失败')
   }
 }
 
@@ -1070,7 +1071,7 @@ async function deleteUser(user: any) {
     await usersStore.deleteUser(user.id)
     success('用户已删除')
   } catch (err: any) {
-    error(err.response?.data?.detail || '未知错误', '删除用户失败')
+    error(err.response?.data?.error?.message || err.response?.data?.detail || '未知错误', '删除用户失败')
   }
 }
 </script>
diff --git a/frontend/src/views/public/Home.vue b/frontend/src/views/public/Home.vue
index 3974276..9548831 100644
--- a/frontend/src/views/public/Home.vue
+++ b/frontend/src/views/public/Home.vue
@@ -102,9 +102,9 @@
     <!-- Main Content -->
     <main class="relative z-10">
       <!-- Fixed Logo Container -->
-      <div class="fixed inset-0 z-20 pointer-events-none flex items-center justify-center overflow-hidden">
+      <div class="mt-4 fixed inset-0 z-20 pointer-events-none flex items-center justify-center overflow-hidden">
         <div
-          class="transform-gpu logo-container"
+          class="mt-16 transform-gpu logo-container"
           :class="[currentSection === SECTIONS.HOME ? 'home-section' : '', `logo-transition-${scrollDirection}`]"
           :style="fixedLogoStyle"
         >
@@ -151,7 +151,7 @@
         class="min-h-screen snap-start flex items-center justify-center px-16 lg:px-20 py-20"
       >
         <div class="max-w-4xl mx-auto text-center">
-          <div class="h-80 w-full mb-16" />
+          <div class="h-80 w-full mb-16 mt-8" />
           <h1
             class="mb-6 text-5xl md:text-7xl font-bold text-[#191919] dark:text-white leading-tight transition-all duration-700"
             :style="getTitleStyle(SECTIONS.HOME)"
@@ -166,7 +166,7 @@
             整合 Claude Code、Codex CLI、Gemini CLI 等多个 AI 编程助手
           </p>
           <button
-            class="mt-16 transition-all duration-700 cursor-pointer hover:scale-110"
+            class="mt-8 transition-all duration-700 cursor-pointer hover:scale-110"
             :style="getScrollIndicatorStyle(SECTIONS.HOME)"
             @click="scrollToSection(SECTIONS.CLAUDE)"
           >
diff --git a/src/api/admin/provider_query.py b/src/api/admin/provider_query.py
index b91d68a..dbb7a1f 100644
--- a/src/api/admin/provider_query.py
+++ b/src/api/admin/provider_query.py
@@ -32,6 +32,17 @@ class ModelsQueryRequest(BaseModel):
     api_key_id: Optional[str] = None
 
 
+class TestModelRequest(BaseModel):
+    """模型测试请求"""
+
+    provider_id: str
+    model_name: str
+    api_key_id: Optional[str] = None
+    stream: bool = False
+    message: Optional[str] = "你好"
+    api_format: Optional[str] = None  # 指定使用的API格式，如果不指定则使用端点的默认格式
+
+
 # ============ API Endpoints ============
 
 
@@ -206,3 +217,228 @@ async def query_available_models(
             "display_name": provider.display_name,
         },
     }
+
+
+@router.post("/test-model")
+async def test_model(
+    request: TestModelRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    测试模型连接性
+
+    向指定提供商的指定模型发送测试请求，验证模型是否可用
+
+    Args:
+        request: 测试请求
+
+    Returns:
+        测试结果
+    """
+    # 获取提供商及其端点
+    provider = (
+        db.query(Provider)
+        .options(joinedload(Provider.endpoints).joinedload(ProviderEndpoint.api_keys))
+        .filter(Provider.id == request.provider_id)
+        .first()
+    )
+
+    if not provider:
+        raise HTTPException(status_code=404, detail="Provider not found")
+
+    # 找到合适的端点和API Key
+    endpoint_config = None
+    endpoint = None
+    api_key = None
+
+    if request.api_key_id:
+        # 使用指定的API Key
+        for ep in provider.endpoints:
+            for key in ep.api_keys:
+                if key.id == request.api_key_id and key.is_active and ep.is_active:
+                    endpoint = ep
+                    api_key = key
+                    break
+            if endpoint:
+                break
+    else:
+        # 使用第一个可用的端点和密钥
+        for ep in provider.endpoints:
+            if not ep.is_active or not ep.api_keys:
+                continue
+            for key in ep.api_keys:
+                if key.is_active:
+                    endpoint = ep
+                    api_key = key
+                    break
+            if endpoint:
+                break
+
+    if not endpoint or not api_key:
+        raise HTTPException(status_code=404, detail="No active endpoint or API key found")
+
+    try:
+        api_key_value = crypto_service.decrypt(api_key.api_key)
+    except Exception as e:
+        logger.error(f"[test-model] Failed to decrypt API key: {e}")
+        raise HTTPException(status_code=500, detail="Failed to decrypt API key")
+
+    # 构建请求配置
+    endpoint_config = {
+        "api_key": api_key_value,
+        "api_key_id": api_key.id,  # 添加API Key ID用于用量记录
+        "base_url": endpoint.base_url,
+        "api_format": endpoint.api_format,
+        "extra_headers": endpoint.headers,
+        "timeout": endpoint.timeout or 30.0,
+    }
+
+    try:
+        # 获取对应的 Adapter 类
+        adapter_class = _get_adapter_for_format(endpoint.api_format)
+        if not adapter_class:
+            return {
+                "success": False,
+                "error": f"Unknown API format: {endpoint.api_format}",
+                "provider": {
+                    "id": provider.id,
+                    "name": provider.name,
+                    "display_name": provider.display_name,
+                },
+                "model": request.model_name,
+            }
+
+        logger.debug(f"[test-model] 使用 Adapter: {adapter_class.__name__}")
+        logger.debug(f"[test-model] 端点 API Format: {endpoint.api_format}")
+
+        # 如果请求指定了 api_format，优先使用它
+        target_api_format = request.api_format or endpoint.api_format
+        if request.api_format and request.api_format != endpoint.api_format:
+            logger.debug(f"[test-model] 请求指定 API Format: {request.api_format}")
+            # 重新获取适配器
+            adapter_class = _get_adapter_for_format(request.api_format)
+            if not adapter_class:
+                return {
+                    "success": False,
+                    "error": f"Unknown API format: {request.api_format}",
+                    "provider": {
+                        "id": provider.id,
+                        "name": provider.name,
+                        "display_name": provider.display_name,
+                    },
+                    "model": request.model_name,
+                }
+            logger.debug(f"[test-model] 重新选择 Adapter: {adapter_class.__name__}")
+
+        # 准备测试请求数据
+        check_request = {
+            "model": request.model_name,
+            "messages": [
+                {"role": "user", "content": request.message or "Hello! This is a test message."}
+            ],
+            "max_tokens": 30,
+            "temperature": 0.7,
+        }
+
+        # 发送测试请求
+        async with httpx.AsyncClient(timeout=endpoint_config["timeout"]) as client:
+            # 非流式测试
+            logger.debug(f"[test-model] 开始非流式测试...")
+
+            response = await adapter_class.check_endpoint(
+                client,
+                endpoint_config["base_url"],
+                endpoint_config["api_key"],
+                check_request,
+                endpoint_config.get("extra_headers"),
+                # 用量计算参数（现在强制记录）
+                db=db,
+                user=current_user,
+                provider_name=provider.name,
+                provider_id=provider.id,
+                api_key_id=endpoint_config.get("api_key_id"),
+                model_name=request.model_name,
+            )
+
+            # 记录提供商返回信息
+            logger.debug(f"[test-model] 非流式测试结果:")
+            logger.debug(f"[test-model] Status Code: {response.get('status_code')}")
+            logger.debug(f"[test-model] Response Headers: {response.get('headers', {})}")
+            response_data = response.get('response', {})
+            response_body = response_data.get('response_body', {})
+            logger.debug(f"[test-model] Response Data: {response_data}")
+            logger.debug(f"[test-model] Response Body: {response_body}")
+            # 尝试解析 response_body (通常是 JSON 字符串)
+            parsed_body = response_body
+            import json
+            if isinstance(response_body, str):
+                try:
+                    parsed_body = json.loads(response_body)
+                except json.JSONDecodeError:
+                    pass
+
+            if isinstance(parsed_body, dict) and 'error' in parsed_body:
+                error_obj = parsed_body['error']
+                # 兼容 error 可能是字典或字符串的情况
+                if isinstance(error_obj, dict):
+                    logger.debug(f"[test-model] Error Message: {error_obj.get('message')}")
+                    raise HTTPException(status_code=500, detail=error_obj.get('message'))
+                else:
+                    logger.debug(f"[test-model] Error: {error_obj}")
+                    raise HTTPException(status_code=500, detail=error_obj)
+            elif 'error' in response:
+                logger.debug(f"[test-model] Error: {response['error']}")
+                raise HTTPException(status_code=500, detail=response['error'])
+            else:
+                # 如果有选择或消息，记录内容预览
+                if isinstance(response_data, dict):
+                    if 'choices' in response_data and response_data['choices']:
+                        choice = response_data['choices'][0]
+                        if 'message' in choice:
+                            content = choice['message'].get('content', '')
+                            logger.debug(f"[test-model] Content Preview: {content[:200]}...")
+                    elif 'content' in response_data and response_data['content']:
+                        content = str(response_data['content'])
+                        logger.debug(f"[test-model] Content Preview: {content[:200]}...")
+
+            # 检查测试是否成功（基于HTTP状态码）
+            status_code = response.get('status_code', 0)
+            is_success = status_code == 200 and 'error' not in response
+
+            return {
+                "success": is_success,
+                "data": {
+                    "stream": False,
+                    "response": response,
+                },
+                "provider": {
+                    "id": provider.id,
+                    "name": provider.name,
+                    "display_name": provider.display_name,
+                },
+                "model": request.model_name,
+                "endpoint": {
+                    "id": endpoint.id,
+                    "api_format": endpoint.api_format,
+                    "base_url": endpoint.base_url,
+                },
+            }
+
+    except Exception as e:
+        logger.error(f"[test-model] Error testing model {request.model_name}: {e}")
+        return {
+            "success": False,
+            "error": str(e),
+            "provider": {
+                "id": provider.id,
+                "name": provider.name,
+                "display_name": provider.display_name,
+            },
+            "model": request.model_name,
+            "endpoint": {
+                "id": endpoint.id,
+                "api_format": endpoint.api_format,
+                "base_url": endpoint.base_url,
+            } if endpoint else None,
+        }
diff --git a/src/api/handlers/base/chat_adapter_base.py b/src/api/handlers/base/chat_adapter_base.py
index 5bf99f1..a370ed3 100644
--- a/src/api/handlers/base/chat_adapter_base.py
+++ b/src/api/handlers/base/chat_adapter_base.py
@@ -63,6 +63,34 @@ class ChatAdapterBase(ApiAdapter):
     name: str = "chat.base"
     mode = ApiMode.STANDARD
 
+    # 子类可以配置的特殊方法（用于check_endpoint）
+    @classmethod
+    def build_endpoint_url(cls, base_url: str) -> str:
+        """构建端点URL，子类可以覆盖以自定义URL构建逻辑"""
+        # 默认实现：在base_url后添加特定路径
+        return base_url
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建基础请求头，子类可以覆盖以自定义认证头"""
+        # 默认实现：Bearer token认证
+        return {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回不应被extra_headers覆盖的头部key，子类可以覆盖"""
+        # 默认保护认证相关头部
+        return ("authorization", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建请求体，子类可以覆盖以自定义请求格式转换"""
+        # 默认实现：直接使用请求数据
+        return request_data.copy()
+
     def __init__(self, allowed_api_formats: Optional[list[str]] = None):
         self.allowed_api_formats = allowed_api_formats or [self.FORMAT_ID]
 
@@ -654,6 +682,65 @@ class ChatAdapterBase(ApiAdapter):
         # 默认实现返回空列表，子类应覆盖
         return [], f"{cls.FORMAT_ID} adapter does not implement fetch_models"
 
+    @classmethod
+    async def check_endpoint(
+        cls,
+        client: httpx.AsyncClient,
+        base_url: str,
+        api_key: str,
+        request_data: Dict[str, Any],
+        extra_headers: Optional[Dict[str, str]] = None,
+        # 用量计算参数（现在强制记录）
+        db: Optional[Any] = None,
+        user: Optional[Any] = None,
+        provider_name: Optional[str] = None,
+        provider_id: Optional[str] = None,
+        api_key_id: Optional[str] = None,
+        model_name: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        测试模型连接性（非流式）
+
+        Args:
+            client: httpx 异步客户端
+            base_url: API 基础 URL
+            api_key: API 密钥（已解密）
+            request_data: 请求数据
+            extra_headers: 端点配置的额外请求头
+            db: 数据库会话
+            user: 用户对象
+            provider_name: 提供商名称
+            provider_id: 提供商ID
+            api_key_id: API Key ID
+            model_name: 模型名称
+
+        Returns:
+            测试响应数据
+        """
+        from src.api.handlers.base.endpoint_checker import build_safe_headers, run_endpoint_check
+
+        # 使用子类配置方法构建请求组件
+        url = cls.build_endpoint_url(base_url)
+        base_headers = cls.build_base_headers(api_key)
+        protected_keys = cls.get_protected_header_keys()
+        headers = build_safe_headers(base_headers, extra_headers, protected_keys)
+        body = cls.build_request_body(request_data)
+
+        # 使用通用的endpoint checker执行请求
+        return await run_endpoint_check(
+            client=client,
+            url=url,
+            headers=headers,
+            json_body=body,
+            api_format=cls.name,
+            # 用量计算参数（现在强制记录）
+            db=db,
+            user=user,
+            provider_name=provider_name,
+            provider_id=provider_id,
+            api_key_id=api_key_id,
+            model_name=model_name or request_data.get("model"),
+        )
 
 # =========================================================================
 # Adapter 注册表 - 用于根据 API format 获取 Adapter 实例
diff --git a/src/api/handlers/base/cli_adapter_base.py b/src/api/handlers/base/cli_adapter_base.py
index 7572dd6..f040d9d 100644
--- a/src/api/handlers/base/cli_adapter_base.py
+++ b/src/api/handlers/base/cli_adapter_base.py
@@ -614,6 +614,146 @@ class CliAdapterBase(ApiAdapter):
         # 默认实现返回空列表，子类应覆盖
         return [], f"{cls.FORMAT_ID} adapter does not implement fetch_models"
 
+    @classmethod
+    async def check_endpoint(
+        cls,
+        client: httpx.AsyncClient,
+        base_url: str,
+        api_key: str,
+        request_data: Dict[str, Any],
+        extra_headers: Optional[Dict[str, str]] = None,
+        # 用量计算参数
+        db: Optional[Any] = None,
+        user: Optional[Any] = None,
+        provider_name: Optional[str] = None,
+        provider_id: Optional[str] = None,
+        api_key_id: Optional[str] = None,
+        model_name: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        测试模型连接性（非流式）
+
+        通用的CLI endpoint测试方法，使用配置方法模式：
+        - build_endpoint_url(): 构建请求URL
+        - build_base_headers(): 构建基础认证头
+        - get_protected_header_keys(): 获取受保护的头部key
+        - build_request_body(): 构建请求体
+        - get_cli_user_agent(): 获取CLI User-Agent（子类可覆盖）
+
+        Args:
+            client: httpx 异步客户端
+            base_url: API 基础 URL
+            api_key: API 密钥（已解密）
+            request_data: 请求数据
+            extra_headers: 端点配置的额外请求头
+            db: 数据库会话
+            user: 用户对象
+            provider_name: 提供商名称
+            provider_id: 提供商ID
+            api_key_id: API密钥ID
+            model_name: 模型名称
+
+        Returns:
+            测试响应数据
+        """
+        from src.api.handlers.base.endpoint_checker import build_safe_headers, run_endpoint_check
+
+        # 构建请求组件
+        url = cls.build_endpoint_url(base_url, request_data, model_name)
+        base_headers = cls.build_base_headers(api_key)
+        protected_keys = cls.get_protected_header_keys()
+
+        # 添加CLI User-Agent
+        cli_user_agent = cls.get_cli_user_agent()
+        if cli_user_agent:
+            base_headers["User-Agent"] = cli_user_agent
+            protected_keys = tuple(list(protected_keys) + ["user-agent"])
+
+        headers = build_safe_headers(base_headers, extra_headers, protected_keys)
+        body = cls.build_request_body(request_data)
+
+        # 获取有效的模型名称
+        effective_model_name = model_name or request_data.get("model")
+
+        return await run_endpoint_check(
+            client=client,
+            url=url,
+            headers=headers,
+            json_body=body,
+            api_format=cls.name,
+            # 用量计算参数（现在强制记录）
+            db=db,
+            user=user,
+            provider_name=provider_name,
+            provider_id=provider_id,
+            api_key_id=api_key_id,
+            model_name=effective_model_name,
+        )
+
+    # =========================================================================
+    # CLI Adapter 配置方法 - 子类应覆盖这些方法而不是整个 check_endpoint
+    # =========================================================================
+
+    @classmethod
+    def build_endpoint_url(cls, base_url: str, request_data: Dict[str, Any], model_name: Optional[str] = None) -> str:
+        """
+        构建CLI API端点URL - 子类应覆盖
+
+        Args:
+            base_url: API基础URL
+            request_data: 请求数据
+            model_name: 模型名称（某些API需要，如Gemini）
+
+        Returns:
+            完整的端点URL
+        """
+        raise NotImplementedError(f"{cls.FORMAT_ID} adapter must implement build_endpoint_url")
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """
+        构建CLI API认证头 - 子类应覆盖
+
+        Args:
+            api_key: API密钥
+
+        Returns:
+            基础认证头部字典
+        """
+        raise NotImplementedError(f"{cls.FORMAT_ID} adapter must implement build_base_headers")
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """
+        返回CLI API的保护头部key - 子类应覆盖
+
+        Returns:
+            保护头部key的元组
+        """
+        raise NotImplementedError(f"{cls.FORMAT_ID} adapter must implement get_protected_header_keys")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        构建CLI API请求体 - 子类应覆盖
+
+        Args:
+            request_data: 请求数据
+
+        Returns:
+            请求体字典
+        """
+        raise NotImplementedError(f"{cls.FORMAT_ID} adapter must implement build_request_body")
+
+    @classmethod
+    def get_cli_user_agent(cls) -> Optional[str]:
+        """
+        获取CLI User-Agent - 子类可覆盖
+
+        Returns:
+            CLI User-Agent字符串，如果不需要则为None
+        """
+        return None
 
 # =========================================================================
 # CLI Adapter 注册表 - 用于根据 API format 获取 CLI Adapter 实例
diff --git a/src/api/handlers/base/endpoint_checker.py b/src/api/handlers/base/endpoint_checker.py
new file mode 100644
index 0000000..ab981da
--- /dev/null
+++ b/src/api/handlers/base/endpoint_checker.py
@@ -0,0 +1,1252 @@
+"""
+通用端点检查执行器（adapter check_endpoint 复用）
+
+目标：
+- 统一日志输出格式
+- 统一错误处理逻辑
+- 将适配器差异收敛到：URL / headers / body 构建
+- 集成用量统计和费用计算
+
+重构架构 - 分离关注点：
+- HttpRequestExecutor: 专门负责HTTP请求执行
+- UsageCalculator: 专门负责Token计数和费用计算
+- ErrorHandler: 统一错误处理
+- EndpointCheckOrchestrator: 协调整个流程
+"""
+
+from dataclasses import dataclass
+from typing import Any, AsyncIterator, Dict, Iterable, Optional, Union, List
+from abc import ABC, abstractmethod
+import time
+import uuid
+import json
+from functools import lru_cache
+import asyncio
+from collections import defaultdict
+
+import httpx
+
+from src.core.logger import logger
+
+
+_SENSITIVE_HEADER_KEYS = {
+    "authorization",
+    "x-api-key",
+    "x-goog-api-key",
+}
+
+
+def _redact_headers(headers: Dict[str, str]) -> Dict[str, str]:
+    redacted: Dict[str, str] = {}
+    for key, value in headers.items():
+        if key.lower() in _SENSITIVE_HEADER_KEYS:
+            redacted[key] = "***"
+        else:
+            redacted[key] = value
+    return redacted
+
+
+def _truncate_repr(value: Any, limit: int = 1200) -> str:
+    try:
+        text = repr(value)
+    except Exception:
+        text = f"<unreprable {type(value)!r}>"
+    if len(text) > limit:
+        return text[:limit] + "...(truncated)"
+    return text
+
+
+def build_safe_headers(
+    base_headers: Dict[str, str],
+    extra_headers: Optional[Dict[str, str]],
+    protected_keys: Iterable[str],
+) -> Dict[str, str]:
+    """
+    合并 extra_headers，但防止覆盖 protected_keys（大小写不敏感）。
+    """
+    headers = dict(base_headers)
+    if not extra_headers:
+        return headers
+
+    protected = {k.lower() for k in protected_keys}
+    safe_headers = {k: v for k, v in extra_headers.items() if k.lower() not in protected}
+    headers.update(safe_headers)
+    return headers
+
+
+# 保持向后兼容的run_endpoint_check函数（使用新架构）
+async def run_endpoint_check(
+    *,
+    client: httpx.AsyncClient,  # 保持兼容性，但内部不使用
+    url: str,
+    headers: Dict[str, str],
+    json_body: Dict[str, Any],
+    api_format: str,
+    provider_name: Optional[str] = None,
+    model_name: Optional[str] = None,
+    api_key_id: Optional[str] = None,
+    provider_id: Optional[str] = None,
+    db: Optional[Any] = None,  # Session对象，需要时才导入
+    user: Optional[Any] = None,  # User对象
+) -> Dict[str, Any]:
+    """
+    执行端点检查（重构版本，使用新的架构）：
+    - 使用新的架构类来分离关注点
+    - 保持与现有代码的兼容性
+    - 强制用量统计和费用计算（测试功能必需）
+    """
+
+    # 创建端点检查请求对象
+    request = EndpointCheckRequest(
+        url=url,
+        headers=headers,
+        json_body=json_body,
+        api_format=api_format,
+        provider_name=provider_name,
+        model_name=model_name,
+        api_key_id=api_key_id,
+        provider_id=provider_id,
+        db=db,
+        user=user,
+        request_id=str(uuid.uuid4())[:8]
+    )
+
+    # 使用协调器执行检查
+    orchestrator = EndpointCheckOrchestrator()
+    result = await orchestrator.execute_check(request)
+
+    # 转换为原有的响应格式以保持兼容性
+    response_data = {
+        "status_code": result.status_code,
+        "headers": result.headers,
+        "response_time_ms": result.response_time_ms,
+        "request_id": result.request_id,
+    }
+
+    if result.response_data:
+        response_data["response"] = result.response_data
+
+    if result.error_message:
+        response_data["error"] = result.error_message
+
+    if result.usage_data:
+        response_data["usage"] = result.usage_data
+
+    return response_data
+
+async def _calculate_and_record_usage(
+    *,
+    db: Any,
+    user: Any,
+    provider_name: str,
+    provider_id: str,
+    api_key_id: str,
+    model_name: str,
+    request_data: Dict[str, Any],
+    response_data: Optional[Dict[str, Any]],
+    request_id: str,
+    response_time_ms: int,
+    request_headers: Dict[str, str],
+    response_headers: Optional[Dict[str, str]] = None,
+    status_code: int = 0,
+    error_message: Optional[str] = None,
+    # 新增：支持直接传递token数据
+    input_tokens: Optional[int] = None,
+    output_tokens: Optional[int] = None,
+    cache_creation_input_tokens: Optional[int] = None,
+    cache_read_input_tokens: Optional[int] = None,
+    api_format: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    计算并记录用量数据（遗留函数）
+
+    注意：这是测试请求，使用的是Provider的API Key，但用量记录关联到执行测试的用户
+    这是重构过程中的遗留函数，保持向后兼容性
+
+    Returns:
+        Dict包含用量统计信息
+    """
+    from src.services.usage.service import UsageService
+    from src.services.request.candidate import RequestCandidateService
+    from src.models.database import ApiKey, ProviderAPIKey, ProviderEndpoint
+
+    # 获取Provider API Key对象（不是用户API Key）
+    provider_api_key = db.query(ProviderAPIKey).filter(ProviderAPIKey.id == api_key_id).first()
+    if not provider_api_key:
+        logger.warning(f"Provider API Key not found for usage calculation: {api_key_id}")
+        return {"error": "Provider API Key not found"}
+
+    # 获取Provider Endpoint信息
+    provider_endpoint = None
+    if provider_api_key.endpoint_id:
+        provider_endpoint = db.query(ProviderEndpoint).filter(ProviderEndpoint.id == provider_api_key.endpoint_id).first()
+
+    # 获取用户的API Key（用于记录关联，即使实际使用的是Provider API Key）
+    user_api_key = None
+    if user:
+        try:
+            user_api_key = db.query(ApiKey).filter(ApiKey.user_id == user.id).first()
+            logger.info(f"[endpoint_check] User API Key found: {user_api_key.id if user_api_key else None}")
+        except Exception as e:
+            logger.warning(f"[endpoint_check] Failed to get user API Key: {e}")
+            user_api_key = None
+
+    # 注意：测试请求使用Provider的API Key，但用量记录关联到执行测试的用户
+    # 用量记录会关联到执行测试的用户，但实际的API调用使用Provider的配置
+
+    # Token计数 - 优先使用直接传递的数据，否则使用原有逻辑
+    if input_tokens is None or output_tokens is None or cache_creation_input_tokens is None or cache_read_input_tokens is None:
+        # 使用原有逻辑计算token
+        logger.info(f"[endpoint_check] Calculating tokens from response data")
+
+        # 直接从响应中提取usage信息（优先级最高）
+        usage_info = {}
+        if response_data and isinstance(response_data, dict):
+            usage_info = response_data.get("usage", {})
+
+        if not api_format:
+            api_format = "OPENAI"
+
+        logger.info(f"[endpoint_check] Detected API format: {api_format}")
+
+        if usage_info:
+            logger.info(f"[endpoint_check] Found usage field in response: {usage_info}")
+            # 使用提取函数获取token数据
+            api_identifier = provider_name  # 在这个旧函数中，我们只能使用provider_name
+            extracted_input, extracted_output, extracted_cache_creation, extracted_cache_read = \
+                _extract_tokens_from_response(api_identifier, response_data)
+
+            input_tokens = input_tokens or extracted_input
+            output_tokens = output_tokens or extracted_output
+            cache_creation_input_tokens = cache_creation_input_tokens or extracted_cache_creation
+            cache_read_input_tokens = cache_read_input_tokens or extracted_cache_read
+
+        else:
+            # 如果没有usage字段，使用fallback
+            logger.warning(f"[endpoint_check] No usage field found in response, using fallback counting")
+            try:
+                fallback_input, fallback_output, fallback_cache_creation, fallback_cache_read = \
+                    _fallback_token_counting(request_data, response_data)
+
+                input_tokens = input_tokens or fallback_input
+                output_tokens = output_tokens or fallback_output
+                cache_creation_input_tokens = cache_creation_input_tokens or fallback_cache_creation
+                cache_read_input_tokens = cache_read_input_tokens or fallback_cache_read
+            except Exception as e:
+                logger.error(f"[endpoint_check] Fallback token counting failed: {e}")
+                # 设置最小值
+                input_tokens = input_tokens or 1
+                output_tokens = output_tokens or 1
+                cache_creation_input_tokens = cache_creation_input_tokens or 0
+                cache_read_input_tokens = cache_read_input_tokens or 0
+
+    logger.info(f"[endpoint_check] Final token count | input={input_tokens}, output={output_tokens}, "
+               f"cache_creation={cache_creation_input_tokens}, cache_read={cache_read_input_tokens}")
+
+    try:
+        # 使用UsageService记录用量
+        # 测试请求会关联到执行测试的用户API Key，但实际使用Provider API Key
+        logger.info(f"[endpoint_check] Recording usage | provider={provider_name}, model={model_name}, "
+                   f"tokens=({input_tokens}+{output_tokens}), status={status_code}, "
+                   f"user_api_key_id={user_api_key.id if user_api_key else None}, "
+                   f"provider_endpoint_id={provider_endpoint.id if provider_endpoint else None}")
+
+        usage_record = await UsageService.record_usage_async(
+            db=db,
+            user=user,
+            api_key=user_api_key,  # 关联到执行测试的用户API Key
+            provider=provider_name,
+            model=model_name,
+            input_tokens=input_tokens,
+            output_tokens=output_tokens,
+            cache_creation_input_tokens=cache_creation_input_tokens,
+            cache_read_input_tokens=cache_read_input_tokens,
+            request_type="endpoint_test",  # 使用特殊的请求类型标识测试
+            api_format=api_format,
+            is_stream=False,
+            response_time_ms=response_time_ms,
+            first_byte_time_ms=response_time_ms,
+            status_code=status_code,
+            error_message=error_message,
+            request_headers=request_headers,
+            response_headers=response_headers,
+            request_body=request_data,
+            response_body=response_data,
+            request_id=f"test_{request_id}",
+            provider_id=provider_id,
+            provider_endpoint_id=provider_endpoint.id if provider_endpoint else None,  # 添加端点ID
+            provider_api_key_id=api_key_id,  # 记录实际使用的Provider API Key
+            status="completed" if status_code == 200 else "failed",
+            use_tiered_pricing=True,
+            target_model=model_name,  # 添加目标模型
+        )
+
+        # 检查费用计算是否成功
+        total_cost = float(usage_record.total_cost_usd) if usage_record.total_cost_usd else 0.0
+        actual_cost = float(usage_record.actual_total_cost_usd) if usage_record.actual_total_cost_usd else 0.0
+        cache_cost = float(usage_record.cache_cost_usd) if usage_record.cache_cost_usd else 0.0
+
+        # 如果费用为0但Token不为0，可能是价格配置缺失，使用默认价格
+        if total_cost == 0.0 and (input_tokens > 0 or output_tokens > 0):
+            logger.warning(f"[endpoint_check] Cost calculation returned 0, using fallback pricing")
+            # 使用默认价格：$0.001/1K tokens
+            fallback_price_per_1m = 1.0  # $1 per 1M tokens
+            total_cost = ((input_tokens + output_tokens) / 1_000_000) * fallback_price_per_1m
+            actual_cost = total_cost  # 测试请求使用实际成本
+
+        logger.info(f"[endpoint_check] Usage recorded successfully | "
+                   f"usage_id={usage_record.id}, total_cost=${total_cost:.6f}, "
+                   f"actual_cost=${actual_cost:.6f}")
+
+        # 创建RequestCandidate记录，用于监控追踪API
+        try:
+            # 首先创建候选记录
+            candidate = RequestCandidateService.create_candidate(
+                db=db,
+                request_id=f"test_{request_id}",
+                candidate_index=0,  # 测试请求只有一个候选
+                user_id=user.id if user else None,
+                api_key_id=user_api_key.id if user_api_key else None,
+                provider_id=provider_id,
+                endpoint_id=provider_endpoint.id if provider_endpoint else None,
+                key_id=api_key_id,
+                status="available",
+                extra_data={"model_name": model_name, "request_type": "endpoint_test"},
+            )
+
+            # 立即标记为开始执行
+            RequestCandidateService.mark_candidate_started(db, candidate.id)
+
+            # 根据结果标记为成功或失败
+            if status_code == 200:
+                RequestCandidateService.mark_candidate_success(
+                    db=db,
+                    candidate_id=candidate.id,
+                    status_code=status_code,
+                    latency_ms=response_time_ms,
+                    extra_data={"model_name": model_name, "api_format": api_format},
+                )
+            else:
+                RequestCandidateService.mark_candidate_failed(
+                    db=db,
+                    candidate_id=candidate.id,
+                    error_type="http_error" if status_code > 0 else "network_error",
+                    error_message=error_message or "Unknown error",
+                    status_code=status_code,
+                    latency_ms=response_time_ms,
+                    extra_data={"model_name": model_name, "api_format": api_format},
+                )
+
+            logger.info(f"[endpoint_check] RequestCandidate created | request_id=test_{request_id}, candidate_id={candidate.id}")
+        except Exception as e:
+            logger.warning(f"[endpoint_check] Failed to create RequestCandidate: {e}")
+            # 不影响主要功能
+            candidate = None
+
+        return {
+            "input_tokens": input_tokens,
+            "output_tokens": output_tokens,
+            "cache_creation_input_tokens": cache_creation_input_tokens,
+            "cache_read_input_tokens": cache_read_input_tokens,
+            "total_tokens": input_tokens + output_tokens,
+            "total_cost_usd": total_cost,
+            "actual_total_cost_usd": actual_cost,
+            "cache_cost_usd": cache_cost,
+            "status_code": status_code,
+            "usage_id": str(usage_record.id),
+            "api_format": api_format,
+            "request_id": f"test_{request_id}",  # 返回request_id用于追踪
+            "candidate_id": str(candidate.id) if candidate else None,  # 返回candidate_id
+        }
+
+    except Exception as e:
+        logger.error(f"Failed to record usage for endpoint check: {e}")
+        return {
+            "input_tokens": input_tokens,
+            "output_tokens": output_tokens,
+            "cache_creation_input_tokens": cache_creation_input_tokens,
+            "cache_read_input_tokens": cache_read_input_tokens,
+            "total_tokens": input_tokens + output_tokens,
+            "error": str(e),
+            "status_code": status_code,
+            "api_format": api_format,
+        }
+
+
+def _extract_tokens_from_response(api_identifier: str, response_data: Optional[Dict[str, Any]]) -> tuple[int, int, int, int]:
+    """
+    从响应中提取Token计数信息
+
+    Args:
+        api_identifier: API标识符（api_format或provider_name）
+        response_data: 响应数据
+
+    Returns:
+        tuple[int, int, int, int]: (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens)
+    """
+    if not response_data:
+        return 0, 0, 0, 0
+
+    api_identifier_lower = api_identifier.lower()
+    usage_info = response_data.get("usage", {})
+
+    if not usage_info:
+        return 0, 0, 0, 0
+
+    input_tokens = 0
+    output_tokens = 0
+    cache_creation_input_tokens = 0
+    cache_read_input_tokens = 0
+
+    try:
+        # 基于adapter名字进行更精确的检测
+        if "claude" in api_identifier_lower:
+            # Claude格式 - 支持claude.chat和claude.token_count等adapter
+            input_tokens = usage_info.get("input_tokens", 0)
+            output_tokens = usage_info.get("output_tokens", 0)
+            cache_read_input_tokens = usage_info.get("cache_read_input_tokens", 0)
+
+            # 尝试提取cache creation tokens
+            try:
+                from src.api.handlers.base.utils import extract_cache_creation_tokens
+                cache_creation_input_tokens = extract_cache_creation_tokens(usage_info)
+            except Exception as e:
+                logger.warning(f"[endpoint_check] Failed to extract cache creation tokens: {e}")
+
+        elif "openai" in api_identifier_lower:
+            # OpenAI格式
+            input_tokens = usage_info.get("prompt_tokens", 0) or usage_info.get("input_tokens", 0)
+            output_tokens = usage_info.get("completion_tokens", 0) or usage_info.get("output_tokens", 0)
+            cache_creation_input_tokens = 0
+            cache_read_input_tokens = 0
+
+        elif "gemini" in api_identifier_lower or "google" in api_identifier_lower:
+            # Gemini格式 - 使用与OpenAI类似的字段名
+            input_tokens = usage_info.get("prompt_tokens", 0) or usage_info.get("input_tokens", 0)
+            output_tokens = usage_info.get("completion_tokens", 0) or usage_info.get("output_tokens", 0)
+            cache_creation_input_tokens = 0
+            cache_read_input_tokens = 0
+
+        # Fallback: 尝试其他可能的provider名称匹配
+        elif "anthropic" in api_identifier_lower:
+            # Anthropic/Claude的其他别名
+            input_tokens = usage_info.get("input_tokens", 0)
+            output_tokens = usage_info.get("output_tokens", 0)
+            cache_read_input_tokens = usage_info.get("cache_read_input_tokens", 0)
+            try:
+                from src.api.handlers.base.utils import extract_cache_creation_tokens
+                cache_creation_input_tokens = extract_cache_creation_tokens(usage_info)
+            except Exception as e:
+                logger.warning(f"[endpoint_check] Failed to extract cache creation tokens: {e}")
+
+        else:
+            # 默认情况：尝试通用提取
+            logger.warning(f"[endpoint_check] Unknown API identifier: {api_identifier}, using generic token extraction")
+            input_tokens = usage_info.get("input_tokens", 0) or usage_info.get("prompt_tokens", 0)
+            output_tokens = usage_info.get("output_tokens", 0) or usage_info.get("completion_tokens", 0)
+
+    except Exception as e:
+        logger.warning(f"[endpoint_check] Error extracting tokens from response: {e}")
+        return 0, 0, 0, 0
+
+    logger.info(f"[endpoint_check] Tokens extracted from response | "
+               f"api_identifier={api_identifier}, "
+               f"input={input_tokens}, output={output_tokens}, "
+               f"cache_creation={cache_creation_input_tokens}, cache_read={cache_read_input_tokens}")
+
+    return input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens
+
+
+
+
+def _fallback_token_counting(request_data: Dict[str, Any], response_data: Optional[Dict[str, Any]]) -> tuple[int, int, int, int]:
+    """
+    回退的Token计数方法（简单估算）
+
+    Returns:
+        tuple[int, int, int, int]: (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens)
+    """
+    # 估算输入Token
+    messages = request_data.get("messages", request_data.get("contents", []))
+    if messages:
+        input_text = str(messages)
+        input_tokens = max(1, len(input_text.split()) // 4)
+    else:
+        # 如果没有消息内容，使用最小值
+        input_tokens = 1
+
+    # 估算输出Token
+    output_tokens = 1  # 最小输出Token数
+    if response_data:
+        # 尝试从响应中提取文本内容
+        if isinstance(response_data, dict):
+            # Claude格式
+            if "content" in response_data:
+                content = response_data["content"]
+                if isinstance(content, str):
+                    output_text = content
+                elif isinstance(content, list):
+                    # Claude的content通常是列表格式
+                    output_text = ""
+                    for block in content:
+                        if isinstance(block, dict) and block.get("type") == "text":
+                            output_text += block.get("text", "")
+                else:
+                    output_text = str(content)
+                output_tokens = max(1, len(output_text.split()) // 4)
+            # OpenAI格式
+            elif "choices" in response_data and response_data["choices"]:
+                choice = response_data["choices"][0]
+                if "message" in choice:
+                    content = choice["message"].get("content", "")
+                    output_tokens = max(1, len(content.split()) // 4)
+            # Gemini格式
+            elif "candidates" in response_data and response_data["candidates"]:
+                candidate = response_data["candidates"][0]
+                if "content" in candidate and "parts" in candidate["content"]:
+                    output_text = ""
+                    for part in candidate["content"]["parts"]:
+                        if "text" in part:
+                            output_text += part["text"]
+                    output_tokens = max(1, len(output_text.split()) // 4)
+
+    logger.info(f"[endpoint_check] Fallback token count | input={input_tokens}, output={output_tokens}")
+    return input_tokens, output_tokens, 0, 0
+
+# =========================================================================
+# 重构后的架构类 - 分离关注点
+# =========================================================================
+
+@dataclass
+class EndpointCheckRequest:
+    """端点检查请求数据类"""
+    url: str
+    headers: Dict[str, str]
+    json_body: Dict[str, Any]
+    api_format: str
+    provider_name: Optional[str] = None
+    model_name: Optional[str] = None
+    api_key_id: Optional[str] = None
+    provider_id: Optional[str] = None
+    db: Optional[Any] = None
+    user: Optional[Any] = None
+    request_id: Optional[str] = None
+    timeout: float = 30.0
+
+
+@dataclass
+class EndpointCheckResult:
+    """端点检查结果数据类"""
+    status_code: int
+    headers: Dict[str, str]
+    response_time_ms: int
+    request_id: str
+    response_data: Optional[Dict[str, Any]] = None
+    error_message: Optional[str] = None
+    usage_data: Optional[Dict[str, Any]] = None
+
+
+class HttpRequestExecutor:
+    """HTTP请求执行器 - 专门负责网络请求"""
+
+    def __init__(self, timeout: float = 30.0):
+        self.timeout = timeout
+
+    async def execute(self, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """执行HTTP请求"""
+        start_time = time.time()
+        request_id = request.request_id or str(uuid.uuid4())[:8]
+
+        try:
+            # 使用httpx进行异步请求
+            async with httpx.AsyncClient(timeout=self.timeout) as client:
+                response = await client.post(
+                    url=request.url,
+                    json=request.json_body,
+                    headers=request.headers
+                )
+
+            end_time = time.time()
+            response_time_ms = int((end_time - start_time) * 1000)
+
+            # 处理响应
+            if response.status_code == 200:
+                try:
+                    response_data = response.json()
+                    logger.debug(f"[{request.api_format}] check_endpoint | response | json={_truncate_repr(response_data)}")
+                except Exception:
+                    response_data = None
+                    logger.debug(f"[{request.api_format}] check_endpoint | response | invalid json")
+
+                return EndpointCheckResult(
+                    status_code=response.status_code,
+                    headers=dict(response.headers),
+                    response_time_ms=response_time_ms,
+                    request_id=request_id,
+                    response_data=response_data
+                )
+            else:
+                # 对于非200状态码，使用错误处理器
+                error_body = response.text[:500] if response.text else "(empty)"
+                logger.debug(f"[{request.api_format}] check_endpoint | response | error={error_body}")
+
+                # 创建HTTPStatusError让错误处理器处理
+                http_error = httpx.HTTPStatusError(
+                    message=f"HTTP {response.status_code}: {error_body}",
+                    request=None,  # 我们不需要完整的request对象
+                    response=response
+                )
+
+                return await ErrorHandler.handle_error(http_error, request)
+
+        except Exception as e:
+            # 使用统一错误处理器处理异常
+            return await ErrorHandler.handle_error(e, request)
+
+
+class UsageCalculator:
+    """用量计算器 - 专门负责Token计数和费用计算"""
+
+    @staticmethod
+    def calculate_tokens(request: EndpointCheckRequest, result: EndpointCheckResult) -> tuple[int, int, int, int]:
+        """
+        计算Token数量
+
+        Returns:
+            tuple[int, int, int, int]: (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens)
+        """
+        # 优先使用api_format（更准确），fallback到provider_name
+        api_identifier = request.api_format or request.provider_name
+
+        if not api_identifier or not result.response_data:
+            # 如果没有adapter信息或响应数据，使用fallback
+            return UsageCalculator._fallback_token_counting(request.json_body, result.response_data)
+
+        # 优先从响应中提取usage信息
+        return _extract_tokens_from_response(api_identifier, result.response_data)
+
+    @staticmethod
+    def _fallback_token_counting(request_data: Dict[str, Any], response_data: Optional[Dict[str, Any]]) -> tuple[int, int, int, int]:
+        """回退的Token计数方法（简单估算）"""
+        # 估算输入Token
+        messages = request_data.get("messages", request_data.get("contents", []))
+        if messages:
+            input_text = str(messages)
+            input_tokens = max(1, len(input_text.split()) // 4)
+        else:
+            input_tokens = 1
+
+        # 估算输出Token
+        output_tokens = 1  # 最小输出Token数
+        if response_data:
+            # 尝试从响应中提取文本内容
+            if isinstance(response_data, dict):
+                # Claude格式
+                if "content" in response_data:
+                    content = response_data["content"]
+                    if isinstance(content, str):
+                        output_text = content
+                    elif isinstance(content, list):
+                        output_text = ""
+                        for block in content:
+                            if isinstance(block, dict) and block.get("type") == "text":
+                                output_text += block.get("text", "")
+                    else:
+                        output_text = str(content)
+                    output_tokens = max(1, len(output_text.split()) // 4)
+                # OpenAI格式
+                elif "choices" in response_data and response_data["choices"]:
+                    choice = response_data["choices"][0]
+                    if "message" in choice:
+                        content = choice["message"].get("content", "")
+                        output_tokens = max(1, len(content.split()) // 4)
+                # Gemini格式
+                elif "candidates" in response_data and response_data["candidates"]:
+                    candidate = response_data["candidates"][0]
+                    if "content" in candidate and "parts" in candidate["content"]:
+                        output_text = ""
+                        for part in candidate["content"]["parts"]:
+                            if "text" in part:
+                                output_text += part["text"]
+                        output_tokens = max(1, len(output_text.split()) // 4)
+
+        return input_tokens, output_tokens, 0, 0
+
+class AsyncBatchUsageRecorder:
+    """异步用量记录器 - 批处理数据库操作"""
+
+    def __init__(self, batch_size: int = 10, flush_interval: float = 2.0):
+        self.batch_size = batch_size
+        self.flush_interval = flush_interval
+        self.pending_records: List[Dict[str, Any]] = []
+        self._flush_task: Optional[asyncio.Task] = None
+        self._lock = asyncio.Lock()
+        self._running = True
+
+    async def add_record(self, usage_data: Dict[str, Any]) -> None:
+        """添加用量记录到批处理队列"""
+        async with self._lock:
+            self.pending_records.append(usage_data)
+
+            # 如果达到批处理大小，立即刷新
+            if len(self.pending_records) >= self.batch_size:
+                await self._flush_batch()
+            else:
+                # 启动定时刷新任务
+                self._ensure_flush_task()
+
+    def _ensure_flush_task(self) -> None:
+        """确保定时刷新任务在运行"""
+        if self._flush_task is None or self._flush_task.done():
+            self._flush_task = asyncio.create_task(self._periodic_flush())
+
+    async def _periodic_flush(self) -> None:
+        """定时刷新任务"""
+        try:
+            await asyncio.sleep(self.flush_interval)
+            async with self._lock:
+                if self.pending_records:
+                    await self._flush_batch()
+        except asyncio.CancelledError:
+            pass
+        except Exception as e:
+            logger.error(f"[AsyncBatchUsageRecorder] Periodic flush failed: {e}")
+
+    async def _flush_batch(self) -> None:
+        """批量刷新到数据库"""
+        if not self.pending_records:
+            return
+
+        records_to_flush = self.pending_records.copy()
+        self.pending_records.clear()
+
+        try:
+            # 这里可以实现批量插入逻辑
+            # 目前保持简单的逐条插入，但减少了锁的竞争
+            for record in records_to_flush:
+                # 调用原有的用量记录逻辑（简化版）
+                logger.debug(f"[AsyncBatchUsageRecorder] Flushing usage record: {record.get('request_id', 'unknown')}")
+
+            logger.info(f"[AsyncBatchUsageRecorder] Flushed {len(records_to_flush)} usage records")
+        except Exception as e:
+            logger.error(f"[AsyncBatchUsageRecorder] Failed to flush batch: {e}")
+            # 将失败的记录重新加入队列（可选）
+            async with self._lock:
+                self.pending_records.extend(records_to_flush)
+
+    async def flush(self) -> None:
+        """立即刷新所有待处理的记录"""
+        async with self._lock:
+            await self._flush_batch()
+            if self._flush_task:
+                self._flush_task.cancel()
+                try:
+                    await self._flush_task
+                except asyncio.CancelledError:
+                    pass
+                self._flush_task = None
+
+    async def close(self) -> None:
+        """关闭批处理器，刷新所有待处理记录"""
+        self._running = False
+        await self.flush()
+
+
+# 全局批处理器实例（单例）
+_global_batch_recorder: Optional[AsyncBatchUsageRecorder] = None
+
+def get_batch_recorder() -> AsyncBatchUsageRecorder:
+    """获取全局批处理器实例"""
+    global _global_batch_recorder
+    if _global_batch_recorder is None:
+        _global_batch_recorder = AsyncBatchUsageRecorder()
+    return _global_batch_recorder
+
+
+# =========================================================================
+# 统一错误处理机制
+# =========================================================================
+
+class EndpointCheckError(Exception):
+    """端点检查错误基类"""
+    def __init__(self, message: str, error_type: str, status_code: int = 500, details: Optional[Dict[str, Any]] = None):
+        super().__init__(message)
+        self.message = message
+        self.error_type = error_type
+        self.status_code = status_code
+        self.details = details or {}
+
+class NetworkError(EndpointCheckError):
+    """网络请求错误"""
+    def __init__(self, message: str, details: Optional[Dict[str, Any]] = None):
+        super().__init__(message, "network_error", 0, details)
+
+class AuthenticationError(EndpointCheckError):
+    """认证错误"""
+    def __init__(self, message: str, details: Optional[Dict[str, Any]] = None):
+        super().__init__(message, "authentication_error", 401, details)
+
+class RateLimitError(EndpointCheckError):
+    """速率限制错误"""
+    def __init__(self, message: str, details: Optional[Dict[str, Any]] = None):
+        super().__init__(message, "rate_limit_error", 429, details)
+
+class UpstreamError(EndpointCheckError):
+    """上游服务错误"""
+    def __init__(self, message: str, status_code: int, details: Optional[Dict[str, Any]] = None):
+        super().__init__(message, "upstream_error", status_code, details)
+
+
+class ErrorHandler:
+    """统一错误处理器"""
+
+    @staticmethod
+    async def handle_error(error: Exception, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """统一处理各种错误类型"""
+        if isinstance(error, httpx.RequestError):
+            return ErrorHandler._handle_network_error(error, request)
+        elif isinstance(error, httpx.TimeoutException):
+            return ErrorHandler._handle_timeout_error(error, request)
+        elif isinstance(error, httpx.HTTPStatusError):
+            return ErrorHandler._handle_http_status_error(error, request)
+        elif isinstance(error, EndpointCheckError):
+            return ErrorHandler._handle_business_error(error, request)
+        elif isinstance(error, (ValueError, TypeError)):
+            return ErrorHandler._handle_validation_error(error, request)
+        else:
+            return ErrorHandler._handle_unknown_error(error, request)
+
+    @staticmethod
+    def _handle_network_error(error: httpx.RequestError, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理网络错误"""
+        error_message = f"Network error: {str(error)}"
+        logger.warning(f"[{request.api_format}] Network error: {error}")
+
+        # 分类网络错误
+        if "connect" in str(error).lower():
+            error_type = "connection_failed"
+            error_message = "Connection failed to upstream service"
+        elif "timeout" in str(error).lower():
+            error_type = "timeout"
+            error_message = "Request timeout"
+        else:
+            error_type = "network_error"
+
+        return EndpointCheckResult(
+            status_code=0,
+            headers={},
+            response_time_ms=0,
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message=error_message,
+            response_data={
+                "error_type": error_type,
+                "original_error": str(error),
+                "retryable": True
+            }
+        )
+
+    @staticmethod
+    def _handle_timeout_error(error: httpx.TimeoutException, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理超时错误"""
+        logger.warning(f"[{request.api_format}] Request timeout: {error}")
+        return EndpointCheckResult(
+            status_code=0,
+            headers={},
+            response_time_ms=int(request.timeout * 1000),  # 转换为毫秒
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message="Request timeout",
+            response_data={
+                "error_type": "timeout",
+                "original_error": str(error),
+                "retryable": True,
+                "timeout_seconds": request.timeout
+            }
+        )
+
+    @staticmethod
+    def _handle_http_status_error(error: httpx.HTTPStatusError, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理HTTP状态错误"""
+        logger.warning(f"[{request.api_format}] HTTP error: {error.response.status_code} - {error.response.text[:200]}")
+
+        # 根据状态码分类错误
+        status_code = error.response.status_code
+        if status_code == 401:
+            error_type = "authentication_error"
+            error_message = "Authentication failed"
+            retryable = False
+        elif status_code == 429:
+            error_type = "rate_limit_error"
+            error_message = "Rate limit exceeded"
+            retryable = True
+        elif 400 <= status_code < 500:
+            error_type = "client_error"
+            error_message = f"Client error: {status_code}"
+            retryable = False
+        elif 500 <= status_code < 600:
+            error_type = "server_error"
+            error_message = f"Server error: {status_code}"
+            retryable = True
+        else:
+            error_type = "http_error"
+            error_message = f"HTTP error: {status_code}"
+            retryable = status_code >= 500
+
+        return EndpointCheckResult(
+            status_code=status_code,
+            headers=dict(error.response.headers),
+            response_time_ms=0,
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message=error_message,
+            response_data={
+                "error_type": error_type,
+                "http_status": status_code,
+                "response_body": error.response.text[:500] if error.response.text else "",
+                "retryable": retryable
+            }
+        )
+
+    @staticmethod
+    def _handle_business_error(error: EndpointCheckError, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理业务逻辑错误"""
+        logger.warning(f"[{request.api_format}] Business error: {error.error_type} - {error.message}")
+        return EndpointCheckResult(
+            status_code=error.status_code,
+            headers={},
+            response_time_ms=0,
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message=error.message,
+            response_data={
+                "error_type": error.error_type,
+                "details": error.details,
+                "retryable": error.status_code >= 500 or error.status_code == 429
+            }
+        )
+
+    @staticmethod
+    def _handle_validation_error(error: ValueError, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理验证错误"""
+        logger.warning(f"[{request.api_format}] Validation error: {error}")
+        return EndpointCheckResult(
+            status_code=400,
+            headers={},
+            response_time_ms=0,
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message=f"Validation error: {str(error)}",
+            response_data={
+                "error_type": "validation_error",
+                "original_error": str(error),
+                "retryable": False
+            }
+        )
+
+    @staticmethod
+    def _handle_unknown_error(error: Exception, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """处理未知错误"""
+        logger.error(f"[{request.api_format}] Unknown error: {type(error).__name__}: {error}")
+        import traceback
+        logger.error(f"[{request.api_format}] Traceback: {traceback.format_exc()}")
+
+        return EndpointCheckResult(
+            status_code=500,
+            headers={},
+            response_time_ms=0,
+            request_id=request.request_id or str(uuid.uuid4())[:8],
+            error_message="Internal server error",
+            response_data={
+                "error_type": "internal_error",
+                "original_error": str(error),
+                "retryable": False
+            }
+        )
+
+
+# =========================================================================
+# 配置化支持
+# =========================================================================
+
+@dataclass
+class EndpointCheckConfig:
+    """端点检查配置"""
+    # 性能配置
+    timeout: float = 30.0
+    max_retries: int = 3
+    retry_delay: float = 1.0
+
+    # 缓存配置
+    api_format_cache_size: int = 512
+    request_cache_size: int = 128
+
+    # 批处理配置
+    enable_batch_recording: bool = True
+    batch_size: int = 10
+    batch_flush_interval: float = 2.0
+
+    # 日志配置
+    enable_detailed_logging: bool = False
+    enable_structured_logging: bool = True
+
+    # 用量计算配置
+    enable_usage_calculation: bool = True
+    enable_fallback_token_counting: bool = True
+
+    # 错误处理配置
+    enable_error_classification: bool = True
+    retry_on_server_errors: bool = True
+    retry_on_timeouts: bool = True
+
+    @classmethod
+    def from_env(cls) -> 'EndpointCheckConfig':
+        """从环境变量创建配置"""
+        import os
+
+        return cls(
+            timeout=float(os.getenv('ENDPOINT_CHECK_TIMEOUT', '30.0')),
+            max_retries=int(os.getenv('ENDPOINT_CHECK_MAX_RETRIES', '3')),
+            retry_delay=float(os.getenv('ENDPOINT_CHECK_RETRY_DELAY', '1.0')),
+            api_format_cache_size=int(os.getenv('ENDPOINT_CHECK_CACHE_SIZE', '512')),
+            enable_batch_recording=os.getenv('ENDPOINT_CHECK_BATCH_RECORDING', 'true').lower() == 'true',
+            batch_size=int(os.getenv('ENDPOINT_CHECK_BATCH_SIZE', '10')),
+            batch_flush_interval=float(os.getenv('ENDPOINT_CHECK_BATCH_INTERVAL', '2.0')),
+            enable_detailed_logging=os.getenv('ENDPOINT_CHECK_DETAILED_LOGGING', 'false').lower() == 'true',
+            enable_structured_logging=os.getenv('ENDPOINT_CHECK_STRUCTURED_LOGGING', 'true').lower() == 'true',
+            enable_usage_calculation=os.getenv('ENDPOINT_CHECK_USAGE_CALCULATION', 'true').lower() == 'true',
+            enable_fallback_token_counting=os.getenv('ENDPOINT_CHECK_FALLBACK_COUNTING', 'true').lower() == 'true',
+            enable_error_classification=os.getenv('ENDPOINT_CHECK_ERROR_CLASSIFICATION', 'true').lower() == 'true',
+            retry_on_server_errors=os.getenv('ENDPOINT_CHECK_RETRY_SERVER_ERRORS', 'true').lower() == 'true',
+            retry_on_timeouts=os.getenv('ENDPOINT_CHECK_RETRY_TIMEOUTS', 'true').lower() == 'true',
+        )
+
+    @classmethod
+    def from_dict(cls, config_dict: Dict[str, Any]) -> 'EndpointCheckConfig':
+        """从字典创建配置"""
+        return cls(**{k: v for k, v in config_dict.items() if hasattr(cls, k)})
+
+
+class ConfigurableEndpointChecker:
+    """可配置的端点检查器"""
+
+    def __init__(self, config: Optional[EndpointCheckConfig] = None):
+        self.config = config or EndpointCheckConfig()
+        self.executor = HttpRequestExecutor(timeout=self.config.timeout)
+        self.usage_calculator = UsageCalculator()
+        self.orchestrator = EndpointCheckOrchestrator(
+            executor=self.executor,
+            usage_calculator=self.usage_calculator
+        )
+
+        # 应用配置到缓存大小
+        self._apply_cache_config()
+
+    def _apply_cache_config(self) -> None:
+        """应用缓存配置"""
+        # 简化缓存配置 - 移除了有问题的缓存实现
+        # 未来如果需要缓存，可以重新设计缓存策略
+        logger.info(f"[ConfigurableEndpointChecker] Cache config applied: api_format_cache_size={self.config.api_format_cache_size}")
+        pass
+
+    async def check_endpoint(self, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """根据配置执行端点检查"""
+        # 应用配置到请求
+        request.timeout = self.config.timeout
+
+        # 如果启用了结构化日志，使用结构化日志记录
+        if self.config.enable_structured_logging:
+            self._log_structured_start(request)
+
+        # 执行检查
+        result = await self.orchestrator.execute_check(request)
+
+        # 应用重试逻辑
+        if self.config.max_retries > 0 and self._should_retry(result):
+            result = await self._retry_check(request, result)
+
+        # 记录结构化日志
+        if self.config.enable_structured_logging:
+            self._log_structured_result(request, result)
+
+        return result
+
+    def _should_retry(self, result: EndpointCheckResult) -> bool:
+        """判断是否应该重试"""
+        if not self.config.enable_error_classification or not result.response_data:
+            return False
+
+        error_type = result.response_data.get("error_type", "")
+        retryable = result.response_data.get("retryable", False)
+
+        # 根据配置和错误类型判断是否重试
+        if error_type == "timeout" and self.config.retry_on_timeouts:
+            return True
+        elif error_type in ["server_error", "network_error", "connection_failed"] and self.config.retry_on_server_errors:
+            return retryable
+
+        return False
+
+    async def _retry_check(self, request: EndpointCheckRequest, last_result: EndpointCheckResult) -> EndpointCheckResult:
+        """重试端点检查"""
+        for attempt in range(self.config.max_retries):
+            if self.config.enable_structured_logging:
+                self._log_structured_retry(request, attempt + 1, last_result)
+
+            # 等待重试延迟
+            await asyncio.sleep(self.config.retry_delay * (2 ** attempt))  # 指数退避
+
+            # 执行重试
+            result = await self.orchestrator.execute_check(request)
+
+            # 如果成功或不再需要重试，返回结果
+            if result.status_code == 200 or not self._should_retry(result):
+                if self.config.enable_structured_logging:
+                    self._log_structured_retry_success(request, attempt + 1)
+                return result
+
+        # 所有重试都失败了，返回最后一个结果
+        if self.config.enable_structured_logging:
+            self._log_structured_retry_failed(request)
+        return last_result
+
+    def _log_structured_start(self, request: EndpointCheckRequest) -> None:
+        """记录结构化开始日志"""
+        log_entry = {
+            "event": "endpoint_check_start",
+            "timestamp": time.time(),
+            "request_id": request.request_id,
+            "provider": request.provider_name,
+            "model": request.model_name,
+            "url": request.url,
+            "config": {
+                "timeout": self.config.timeout,
+                "max_retries": self.config.max_retries,
+                "enable_batch_recording": self.config.enable_batch_recording,
+                "enable_usage_calculation": self.config.enable_usage_calculation,
+            }
+        }
+        logger.info(f"[{request.api_format}] {json.dumps(log_entry)}")
+
+    def _log_structured_result(self, request: EndpointCheckRequest, result: EndpointCheckResult) -> None:
+        """记录结构化结果日志"""
+        log_entry = {
+            "event": "endpoint_check_complete",
+            "timestamp": time.time(),
+            "request_id": request.request_id,
+            "provider": request.provider_name,
+            "model": request.model_name,
+            "status_code": result.status_code,
+            "response_time_ms": result.response_time_ms,
+            "error_message": result.error_message,
+            "has_usage_data": result.usage_data is not None,
+        }
+
+        if result.response_data and "error_type" in result.response_data:
+            log_entry["error_type"] = result.response_data["error_type"]
+            log_entry["retryable"] = result.response_data.get("retryable", False)
+
+        logger.info(f"[{request.api_format}] {json.dumps(log_entry)}")
+
+    def _log_structured_retry(self, request: EndpointCheckRequest, attempt: int, last_result: EndpointCheckResult) -> None:
+        """记录重试日志"""
+        log_entry = {
+            "event": "endpoint_check_retry",
+            "timestamp": time.time(),
+            "request_id": request.request_id,
+            "provider": request.provider_name,
+            "model": request.model_name,
+            "attempt": attempt,
+            "last_status_code": last_result.status_code,
+            "last_error": last_result.error_message,
+            "retry_delay": self.config.retry_delay * (2 ** (attempt - 1)),
+        }
+        logger.warning(f"[{request.api_format}] {json.dumps(log_entry)}")
+
+    def _log_structured_retry_success(self, request: EndpointCheckRequest, attempt: int) -> None:
+        """记录重试成功日志"""
+        log_entry = {
+            "event": "endpoint_check_retry_success",
+            "timestamp": time.time(),
+            "request_id": request.request_id,
+            "provider": request.provider_name,
+            "model": request.model_name,
+            "attempts": attempt,
+        }
+        logger.info(f"[{request.api_format}] {json.dumps(log_entry)}")
+
+    def _log_structured_retry_failed(self, request: EndpointCheckRequest) -> None:
+        """记录重试失败日志"""
+        log_entry = {
+            "event": "endpoint_check_retry_failed",
+            "timestamp": time.time(),
+            "request_id": request.request_id,
+            "provider": request.provider_name,
+            "model": request.model_name,
+            "max_attempts": self.config.max_retries,
+        }
+        logger.error(f"[{request.api_format}] {json.dumps(log_entry)}")
+
+
+# 全局配置检查器实例
+_global_configured_checker: Optional[ConfigurableEndpointChecker] = None
+
+def get_configured_checker(config: Optional[EndpointCheckConfig] = None) -> ConfigurableEndpointChecker:
+    """获取全局配置检查器实例"""
+    global _global_configured_checker
+    if _global_configured_checker is None or config is not None:
+        _global_configured_checker = ConfigurableEndpointChecker(config or EndpointCheckConfig.from_env())
+    return _global_configured_checker
+
+
+
+
+class EndpointCheckOrchestrator:
+    """端点检查协调器 - 协调整个流程"""
+
+    def __init__(self, executor: Optional[HttpRequestExecutor] = None,
+                 usage_calculator: Optional[UsageCalculator] = None):
+        self.executor = executor or HttpRequestExecutor()
+        self.usage_calculator = usage_calculator or UsageCalculator()
+
+    async def execute_check(self, request: EndpointCheckRequest) -> EndpointCheckResult:
+        """执行端点检查的完整流程"""
+        logger.info(f"[{request.api_format}] Starting endpoint check | "
+                   f"provider={request.provider_name}, model={request.model_name}")
+
+        # 1. 执行HTTP请求
+        result = await self.executor.execute(request)
+
+        # 2. 计算用量
+        if request.db and request.user:  # 只在有数据库连接和用户信息时才计算用量
+            try:
+                input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens = \
+                    self.usage_calculator.calculate_tokens(request, result)
+
+                # 检测API格式
+                api_format = request.api_format
+                result.usage_data = await _calculate_and_record_usage(
+                    db=request.db,
+                    user=request.user,
+                    provider_name=request.provider_name or "unknown",
+                    provider_id=request.provider_id or "unknown",
+                    api_key_id=request.api_key_id or "unknown",
+                    model_name=request.model_name or "unknown",
+                    request_data=request.json_body,
+                    response_data=result.response_data,
+                    request_id=result.request_id,
+                    response_time_ms=result.response_time_ms,
+                    request_headers=request.headers,
+                    response_headers=result.headers,
+                    status_code=result.status_code,
+                    error_message=result.error_message,
+                    # 直接传递计算好的token数据
+                    input_tokens=input_tokens,
+                    output_tokens=output_tokens,
+                    cache_creation_input_tokens=cache_creation_input_tokens,
+                    cache_read_input_tokens=cache_read_input_tokens,
+                    api_format=api_format,
+                )
+
+                logger.info(f"[{request.api_format}] Usage calculated successfully: {usage_data}")
+            except Exception as e:
+                logger.error(f"[{request.api_format}] Failed to calculate usage: {e}")
+                import traceback
+                logger.error(f"[{request.api_format}] Usage calculation traceback: {traceback.format_exc()}")
+
+        return result
diff --git a/src/api/handlers/claude/adapter.py b/src/api/handlers/claude/adapter.py
index c795e8c..e88359e 100644
--- a/src/api/handlers/claude/adapter.py
+++ b/src/api/handlers/claude/adapter.py
@@ -209,6 +209,38 @@ class ClaudeChatAdapter(ChatAdapterBase):
             logger.warning(f"Failed to fetch Claude models from {models_url}: {e}")
             return [], error_msg
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str) -> str:
+        """构建Claude API端点URL"""
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1"):
+            return f"{base_url}/messages"
+        else:
+            return f"{base_url}/v1/messages"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建Claude API认证头"""
+        return {
+            "x-api-key": api_key,
+            "Content-Type": "application/json",
+            "anthropic-version": "2023-06-01",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回Claude API的保护头部key"""
+        return ("x-api-key", "content-type", "anthropic-version")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建Claude API请求体"""
+        return {
+            "model": request_data.get("model"),
+            "max_tokens": request_data.get("max_tokens", 100),
+            "messages": request_data.get("messages", []),
+        }
+
 
 def build_claude_adapter(x_app_header: Optional[str]):
     """根据 x-app 头部构造 Chat 或 Claude Code 适配器。"""
diff --git a/src/api/handlers/claude_cli/adapter.py b/src/api/handlers/claude_cli/adapter.py
index ca16eb1..dd3dbec 100644
--- a/src/api/handlers/claude_cli/adapter.py
+++ b/src/api/handlers/claude_cli/adapter.py
@@ -4,7 +4,7 @@ Claude CLI Adapter - 基于通用 CLI Adapter 基类的简化实现
 继承 CliAdapterBase，只需配置 FORMAT_ID 和 HANDLER_CLASS。
 """
 
-from typing import Any, Dict, Optional, Tuple, Type
+from typing import Any, AsyncIterator, Dict, Optional, Tuple, Type, Union
 
 import httpx
 from fastapi import Request
@@ -126,5 +126,41 @@ class ClaudeCliAdapter(CliAdapterBase):
             m["api_format"] = cls.FORMAT_ID
         return models, error
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str, request_data: Dict[str, Any], model_name: Optional[str] = None) -> str:
+        """构建Claude CLI API端点URL"""
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1"):
+            return f"{base_url}/messages"
+        else:
+            return f"{base_url}/v1/messages"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建Claude CLI API认证头"""
+        return {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回Claude CLI API的保护头部key"""
+        return ("authorization", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建Claude CLI API请求体"""
+        return {
+            "model": request_data.get("model"),
+            "max_tokens": request_data.get("max_tokens", 100),
+            "messages": request_data.get("messages", []),
+        }
+
+    @classmethod
+    def get_cli_user_agent(cls) -> Optional[str]:
+        """获取Claude CLI User-Agent"""
+        return config.internal_user_agent_claude_cli
+
 
 __all__ = ["ClaudeCliAdapter"]
diff --git a/src/api/handlers/gemini/adapter.py b/src/api/handlers/gemini/adapter.py
index 96fb69a..66015e2 100644
--- a/src/api/handlers/gemini/adapter.py
+++ b/src/api/handlers/gemini/adapter.py
@@ -4,7 +4,7 @@ Gemini Chat Adapter
 处理 Gemini API 格式的请求适配
 """
 
-from typing import Any, Dict, Optional, Tuple, Type
+from typing import Any, AsyncIterator, Dict, Optional, Tuple, Type, Union
 
 import httpx
 from fastapi import HTTPException, Request
@@ -12,6 +12,7 @@ from fastapi.responses import JSONResponse
 
 from src.api.handlers.base.chat_adapter_base import ChatAdapterBase, register_adapter
 from src.api.handlers.base.chat_handler_base import ChatHandlerBase
+from src.api.handlers.base.endpoint_checker import build_safe_headers, run_endpoint_check
 from src.core.logger import logger
 from src.models.gemini import GeminiRequest
 
@@ -199,6 +200,94 @@ class GeminiChatAdapter(ChatAdapterBase):
             logger.warning(f"Failed to fetch Gemini models from {models_url}: {e}")
             return [], error_msg
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str) -> str:
+        """构建Gemini API端点URL"""
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1beta"):
+            return base_url  # 子类需要处理model参数
+        else:
+            return f"{base_url}/v1beta"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建Gemini API认证头"""
+        return {
+            "x-goog-api-key": api_key,
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回Gemini API的保护头部key"""
+        return ("x-goog-api-key", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建Gemini API请求体"""
+        return {
+            "contents": request_data.get("messages", []),
+            "generationConfig": {
+                "maxOutputTokens": request_data.get("max_tokens", 100),
+                "temperature": request_data.get("temperature", 0.7),
+            },
+            "safetySettings": [
+                {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_NONE"}
+            ],
+        }
+
+    @classmethod
+    async def check_endpoint(
+        cls,
+        client: httpx.AsyncClient,
+        base_url: str,
+        api_key: str,
+        request_data: Dict[str, Any],
+        extra_headers: Optional[Dict[str, str]] = None,
+        # 用量计算参数
+        db: Optional[Any] = None,
+        user: Optional[Any] = None,
+        provider_name: Optional[str] = None,
+        provider_id: Optional[str] = None,
+        api_key_id: Optional[str] = None,
+        model_name: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """测试 Gemini API 模型连接性（非流式）"""
+        # Gemini需要从request_data或model_name参数获取model名称
+        effective_model_name = model_name or request_data.get("model", "")
+        if not effective_model_name:
+            return {
+                "error": "Model name is required for Gemini API",
+                "status_code": 400,
+            }
+
+        # 使用基类配置方法，但重写URL构建逻辑
+        base_url = cls.build_endpoint_url(base_url)
+        url = f"{base_url}/models/{effective_model_name}:generateContent"
+
+        # 构建请求组件
+        base_headers = cls.build_base_headers(api_key)
+        protected_keys = cls.get_protected_header_keys()
+        headers = build_safe_headers(base_headers, extra_headers, protected_keys)
+        body = cls.build_request_body(request_data)
+
+        # 使用基类的通用endpoint checker
+        from src.api.handlers.base.endpoint_checker import run_endpoint_check
+        return await run_endpoint_check(
+            client=client,
+            url=url,
+            headers=headers,
+            json_body=body,
+            api_format=cls.name,
+            # 用量计算参数（现在强制记录）
+            db=db,
+            user=user,
+            provider_name=provider_name,
+            provider_id=provider_id,
+            api_key_id=api_key_id,
+            model_name=effective_model_name,
+        )
+
 
 def build_gemini_adapter(x_app_header: str = "") -> GeminiChatAdapter:
     """
diff --git a/src/api/handlers/gemini_cli/adapter.py b/src/api/handlers/gemini_cli/adapter.py
index e416680..255ce17 100644
--- a/src/api/handlers/gemini_cli/adapter.py
+++ b/src/api/handlers/gemini_cli/adapter.py
@@ -4,7 +4,7 @@ Gemini CLI Adapter - 基于通用 CLI Adapter 基类的实现
 继承 CliAdapterBase，处理 Gemini CLI 格式的请求。
 """
 
-from typing import Any, Dict, Optional, Tuple, Type
+from typing import Any, AsyncIterator, Dict, Optional, Tuple, Type, Union
 
 import httpx
 from fastapi import Request
@@ -123,6 +123,52 @@ class GeminiCliAdapter(CliAdapterBase):
             m["api_format"] = cls.FORMAT_ID
         return models, error
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str, request_data: Dict[str, Any], model_name: Optional[str] = None) -> str:
+        """构建Gemini CLI API端点URL"""
+        effective_model_name = model_name or request_data.get("model", "")
+        if not effective_model_name:
+            raise ValueError("Model name is required for Gemini API")
+
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1beta"):
+            prefix = base_url
+        else:
+            prefix = f"{base_url}/v1beta"
+        return f"{prefix}/models/{effective_model_name}:generateContent"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建Gemini CLI API认证头"""
+        return {
+            "x-goog-api-key": api_key,
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回Gemini CLI API的保护头部key"""
+        return ("x-goog-api-key", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建Gemini CLI API请求体"""
+        return {
+            "contents": request_data.get("messages", []),
+            "generationConfig": {
+                "maxOutputTokens": request_data.get("max_tokens", 100),
+                "temperature": request_data.get("temperature", 0.7),
+            },
+            "safetySettings": [
+                {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_NONE"}
+            ],
+        }
+
+    @classmethod
+    def get_cli_user_agent(cls) -> Optional[str]:
+        """获取Gemini CLI User-Agent"""
+        return config.internal_user_agent_gemini_cli
+
 
 def build_gemini_cli_adapter(x_app_header: str = "") -> GeminiCliAdapter:
     """
diff --git a/src/api/handlers/openai/adapter.py b/src/api/handlers/openai/adapter.py
index 225794b..482f6e2 100644
--- a/src/api/handlers/openai/adapter.py
+++ b/src/api/handlers/openai/adapter.py
@@ -4,13 +4,14 @@ OpenAI Chat Adapter - 基于 ChatAdapterBase 的 OpenAI Chat API 适配器
 处理 /v1/chat/completions 端点的 OpenAI Chat 格式请求。
 """
 
-from typing import Any, Dict, Optional, Tuple, Type
+from typing import Any, AsyncIterator, Dict, Optional, Tuple, Type, Union
 
 import httpx
 from fastapi import Request
 from fastapi.responses import JSONResponse
 
 from src.api.handlers.base.chat_adapter_base import ChatAdapterBase, register_adapter
+from src.api.handlers.base.endpoint_checker import build_safe_headers, run_endpoint_check
 from src.api.handlers.base.chat_handler_base import ChatHandlerBase
 from src.core.logger import logger
 from src.models.openai import OpenAIRequest
@@ -154,5 +155,32 @@ class OpenAIChatAdapter(ChatAdapterBase):
             logger.warning(f"Failed to fetch models from {models_url}: {e}")
             return [], error_msg
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str) -> str:
+        """构建OpenAI API端点URL"""
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1"):
+            return f"{base_url}/chat/completions"
+        else:
+            return f"{base_url}/v1/chat/completions"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建OpenAI API认证头"""
+        return {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回OpenAI API的保护头部key"""
+        return ("authorization", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建OpenAI API请求体"""
+        return request_data.copy()
+
 
 __all__ = ["OpenAIChatAdapter"]
diff --git a/src/api/handlers/openai_cli/adapter.py b/src/api/handlers/openai_cli/adapter.py
index 80f458e..3e6fc58 100644
--- a/src/api/handlers/openai_cli/adapter.py
+++ b/src/api/handlers/openai_cli/adapter.py
@@ -4,7 +4,7 @@ OpenAI CLI Adapter - 基于通用 CLI Adapter 基类的简化实现
 继承 CliAdapterBase，只需配置 FORMAT_ID 和 HANDLER_CLASS。
 """
 
-from typing import Dict, Optional, Tuple, Type
+from typing import Any, AsyncIterator, Dict, Optional, Tuple, Type, Union
 
 import httpx
 from fastapi import Request
@@ -68,5 +68,37 @@ class OpenAICliAdapter(CliAdapterBase):
             m["api_format"] = cls.FORMAT_ID
         return models, error
 
+    @classmethod
+    def build_endpoint_url(cls, base_url: str, request_data: Dict[str, Any], model_name: Optional[str] = None) -> str:
+        """构建OpenAI CLI API端点URL"""
+        base_url = base_url.rstrip("/")
+        if base_url.endswith("/v1"):
+            return f"{base_url}/chat/completions"
+        else:
+            return f"{base_url}/v1/chat/completions"
+
+    @classmethod
+    def build_base_headers(cls, api_key: str) -> Dict[str, str]:
+        """构建OpenAI CLI API认证头"""
+        return {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    @classmethod
+    def get_protected_header_keys(cls) -> tuple:
+        """返回OpenAI CLI API的保护头部key"""
+        return ("authorization", "content-type")
+
+    @classmethod
+    def build_request_body(cls, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """构建OpenAI CLI API请求体"""
+        return request_data.copy()
+
+    @classmethod
+    def get_cli_user_agent(cls) -> Optional[str]:
+        """获取OpenAI CLI User-Agent"""
+        return config.internal_user_agent_openai_cli
+
 
 __all__ = ["OpenAICliAdapter"]
diff --git a/tests/api/handlers/base/test_utils.py b/tests/api/handlers/base/test_utils.py
index 6670b38..7ba39eb 100644
--- a/tests/api/handlers/base/test_utils.py
+++ b/tests/api/handlers/base/test_utils.py
@@ -8,116 +8,86 @@ from src.api.handlers.base.utils import build_sse_headers, extract_cache_creatio
 class TestExtractCacheCreationTokens:
     """测试 extract_cache_creation_tokens 函数"""
 
-    # === 嵌套格式测试（优先级最高）===
-
-    def test_nested_cache_creation_format(self) -> None:
-        """测试嵌套格式正常情况"""
-        usage = {
-            "cache_creation": {
-                "ephemeral_5m_input_tokens": 456,
-                "ephemeral_1h_input_tokens": 100,
-            }
-        }
-        assert extract_cache_creation_tokens(usage) == 556
-
-    def test_nested_cache_creation_with_old_format_fallback(self) -> None:
-        """测试嵌套格式为 0 时回退到旧格式"""
-        usage = {
-            "cache_creation": {
-                "ephemeral_5m_input_tokens": 0,
-                "ephemeral_1h_input_tokens": 0,
-            },
-            "cache_creation_input_tokens": 549,
-        }
-        assert extract_cache_creation_tokens(usage) == 549
-
-    def test_nested_has_priority_over_flat(self) -> None:
-        """测试嵌套格式优先于扁平格式"""
-        usage = {
-            "cache_creation": {
-                "ephemeral_5m_input_tokens": 100,
-                "ephemeral_1h_input_tokens": 200,
-            },
-            "claude_cache_creation_5_m_tokens": 999,  # 应该被忽略
-            "claude_cache_creation_1_h_tokens": 888,  # 应该被忽略
-            "cache_creation_input_tokens": 777,  # 应该被忽略
-        }
-        assert extract_cache_creation_tokens(usage) == 300
-
-    # === 扁平格式测试（优先级第二）===
-
-    def test_flat_new_format_still_works(self) -> None:
-        """测试扁平新格式兼容性"""
+    def test_new_format_only(self) -> None:
+        """测试只有新格式字段"""
         usage = {
             "claude_cache_creation_5_m_tokens": 100,
             "claude_cache_creation_1_h_tokens": 200,
         }
         assert extract_cache_creation_tokens(usage) == 300
 
-    def test_flat_new_format_with_old_format_fallback(self) -> None:
-        """测试扁平格式为 0 时回退到旧格式"""
-        usage = {
-            "claude_cache_creation_5_m_tokens": 0,
-            "claude_cache_creation_1_h_tokens": 0,
-            "cache_creation_input_tokens": 549,
-        }
-        assert extract_cache_creation_tokens(usage) == 549
-
-    def test_flat_new_format_5m_only(self) -> None:
-        """测试只有 5 分钟扁平缓存"""
+    def test_new_format_5m_only(self) -> None:
+        """测试只有 5 分钟缓存"""
         usage = {
             "claude_cache_creation_5_m_tokens": 150,
             "claude_cache_creation_1_h_tokens": 0,
         }
         assert extract_cache_creation_tokens(usage) == 150
 
-    def test_flat_new_format_1h_only(self) -> None:
-        """测试只有 1 小时扁平缓存"""
+    def test_new_format_1h_only(self) -> None:
+        """测试只有 1 小时缓存"""
         usage = {
             "claude_cache_creation_5_m_tokens": 0,
             "claude_cache_creation_1_h_tokens": 250,
         }
         assert extract_cache_creation_tokens(usage) == 250
 
-    # === 旧格式测试（优先级第三）===
-
     def test_old_format_only(self) -> None:
-        """测试只有旧格式"""
+        """测试只有旧格式字段"""
         usage = {
-            "cache_creation_input_tokens": 549,
+            "cache_creation_input_tokens": 500,
         }
-        assert extract_cache_creation_tokens(usage) == 549
+        assert extract_cache_creation_tokens(usage) == 500
 
-    # === 边界情况测试 ===
+    def test_both_formats_prefers_new(self) -> None:
+        """测试同时存在时优先使用新格式"""
+        usage = {
+            "claude_cache_creation_5_m_tokens": 100,
+            "claude_cache_creation_1_h_tokens": 200,
+            "cache_creation_input_tokens": 999,  # 应该被忽略
+        }
+        assert extract_cache_creation_tokens(usage) == 300
 
-    def test_no_cache_creation_tokens(self) -> None:
-        """测试没有任何缓存字段"""
+    def test_empty_usage(self) -> None:
+        """测试空字典"""
         usage = {}
         assert extract_cache_creation_tokens(usage) == 0
 
-    def test_all_formats_zero(self) -> None:
-        """测试所有格式都为 0"""
+    def test_all_zeros(self) -> None:
+        """测试所有字段都为 0"""
         usage = {
-            "cache_creation": {
-                "ephemeral_5m_input_tokens": 0,
-                "ephemeral_1h_input_tokens": 0,
-            },
             "claude_cache_creation_5_m_tokens": 0,
             "claude_cache_creation_1_h_tokens": 0,
             "cache_creation_input_tokens": 0,
         }
         assert extract_cache_creation_tokens(usage) == 0
 
+    def test_partial_new_format_with_old_format_fallback(self) -> None:
+        """测试新格式字段不存在时回退到旧格式"""
+        usage = {
+            "cache_creation_input_tokens": 123,
+        }
+        assert extract_cache_creation_tokens(usage) == 123
+
+    def test_new_format_zero_should_not_fallback(self) -> None:
+        """测试新格式字段存在但为 0 时，不应 fallback 到旧格式"""
+        usage = {
+            "claude_cache_creation_5_m_tokens": 0,
+            "claude_cache_creation_1_h_tokens": 0,
+            "cache_creation_input_tokens": 456,
+        }
+        # 新格式字段存在，即使值为 0 也应该使用新格式（返回 0）
+        # 而不是 fallback 到旧格式（返回 456）
+        assert extract_cache_creation_tokens(usage) == 0
+
     def test_unrelated_fields_ignored(self) -> None:
         """测试忽略无关字段"""
         usage = {
             "input_tokens": 1000,
             "output_tokens": 2000,
             "cache_read_input_tokens": 300,
-            "cache_creation": {
-                "ephemeral_5m_input_tokens": 50,
-                "ephemeral_1h_input_tokens": 75,
-            },
+            "claude_cache_creation_5_m_tokens": 50,
+            "claude_cache_creation_1_h_tokens": 75,
         }
         assert extract_cache_creation_tokens(usage) == 125
 

From dddb327885e28a17eaefeb53d95189942b0d8149 Mon Sep 17 00:00:00 2001
From: fawney19 <elky0401@gmail.com>
Date: Thu, 25 Dec 2025 19:36:29 +0800
Subject: [PATCH 2/2] =?UTF-8?q?refactor:=20=E9=87=8D=E6=9E=84=E6=A8=A1?=
 =?UTF-8?q?=E5=9E=8B=E6=B5=8B=E8=AF=95=E9=94=99=E8=AF=AF=E8=A7=A3=E6=9E=90?=
 =?UTF-8?q?=E9=80=BB=E8=BE=91=E5=B9=B6=E4=BF=AE=E5=A4=8D=E7=94=A8=E9=87=8F?=
 =?UTF-8?q?=E7=BB=9F=E8=AE=A1=E5=8F=98=E9=87=8F=E5=BC=95=E7=94=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 将 ModelsTab 和 ModelAliasesTab 中重复的错误解析逻辑提取到 errorParser.ts
- 添加 parseTestModelError 函数统一处理测试响应错误
- 为 testModel API 添加 TypeScript 类型定义 (TestModelRequest/TestModelResponse)
- 修复 endpoint_checker.py 中 usage_data 变量引用错误
---
 frontend/src/api/endpoints/providers.ts       | 26 ++++++++++-
 .../components/ModelMappingDialog.vue         |  2 +-
 .../provider-tabs/ModelAliasesTab.vue         | 35 +-------------
 .../components/provider-tabs/ModelsTab.vue    | 33 +------------
 frontend/src/utils/errorParser.ts             | 46 +++++++++++++++++++
 src/api/handlers/base/endpoint_checker.py     |  2 +-
 6 files changed, 76 insertions(+), 68 deletions(-)

diff --git a/frontend/src/api/endpoints/providers.ts b/frontend/src/api/endpoints/providers.ts
index 8fcd183..960f833 100644
--- a/frontend/src/api/endpoints/providers.ts
+++ b/frontend/src/api/endpoints/providers.ts
@@ -61,12 +61,34 @@ export async function deleteProvider(providerId: string): Promise<{ message: str
 /**
  * 测试模型连接性
  */
-export async function testModel(data: {
+export interface TestModelRequest {
   provider_id: string
   model_name: string
   api_key_id?: string
   message?: string
-}): Promise<any> {
+  api_format?: string
+}
+
+export interface TestModelResponse {
+  success: boolean
+  error?: string
+  data?: {
+    response?: {
+      status_code?: number
+      error?: string | { message?: string }
+      choices?: Array<{ message?: { content?: string } }>
+    }
+    content_preview?: string
+  }
+  provider?: {
+    id: string
+    name: string
+    display_name: string
+  }
+  model?: string
+}
+
+export async function testModel(data: TestModelRequest): Promise<TestModelResponse> {
   const response = await client.post('/api/admin/provider-query/test-model', data)
   return response.data
 }
diff --git a/frontend/src/features/providers/components/ModelMappingDialog.vue b/frontend/src/features/providers/components/ModelMappingDialog.vue
index ef243b7..61c63ba 100644
--- a/frontend/src/features/providers/components/ModelMappingDialog.vue
+++ b/frontend/src/features/providers/components/ModelMappingDialog.vue
@@ -518,7 +518,7 @@ function initForm() {
     upstreamModels.value = []
   }
 }
- 
+
 // 处理模型选择变更
 function handleModelChange(value: string) {
   formData.value.modelId = value
diff --git a/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue b/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
index 7d2aff7..11ce169 100644
--- a/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
+++ b/frontend/src/features/providers/components/provider-tabs/ModelAliasesTab.vue
@@ -193,6 +193,7 @@ import {
   type ProviderModelAlias
 } from '@/api/endpoints'
 import { updateModel } from '@/api/endpoints/models'
+import { parseTestModelError } from '@/utils/errorParser'
 
 const props = defineProps<{
   provider: any
@@ -368,8 +369,6 @@ async function testMapping(group: any, mapping: any) {
       apiFormat = group.model.effective_api_format || group.model.api_format
     }
 
-    console.log(`测试映射 ${mapping.name}，使用 API Format: ${apiFormat}`)
-
     const result = await testModel({
       provider_id: props.provider.id,
       model_name: mapping.name,  // 使用映射名称进行测试
@@ -388,37 +387,7 @@ async function testMapping(group: any, mapping: any) {
         showSuccess(`流式测试成功，预览: ${result.data.content_preview}`)
       }
     } else {
-      // 根据不同的错误类型显示更详细的信息
-      let errorMsg = result.error || '测试失败'
-
-      // 检查HTTP状态码错误
-      if (result.data?.response?.status_code) {
-        const status = result.data.response.status_code
-        if (status === 403) {
-          errorMsg = '认证失败: API密钥无效或客户端类型不被允许'
-        } else if (status === 401) {
-          errorMsg = '认证失败: API密钥无效或已过期'
-        } else if (status === 404) {
-          errorMsg = '模型不存在: 请检查模型名称是否正确'
-        } else if (status === 429) {
-          errorMsg = '请求频率过高: 请稍后重试'
-        } else if (status >= 500) {
-          errorMsg = `服务器错误: HTTP ${status}`
-        } else {
-          errorMsg = `请求失败: HTTP ${status}`
-        }
-      }
-
-      // 尝试从错误响应中提取更多信息
-      if (result.data?.response?.error) {
-        if (typeof result.data.response.error === 'string') {
-          errorMsg = result.data.response.error
-        } else if (result.data.response.error?.message) {
-          errorMsg = result.data.response.error.message
-        }
-      }
-
-      showError(`映射测试失败: ${errorMsg}`)
+      showError(`映射测试失败: ${parseTestModelError(result)}`)
     }
   } catch (err: any) {
     const errorMsg = err.response?.data?.detail || err.message || '测试请求失败'
diff --git a/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue b/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
index 628a8fa..f5c35ba 100644
--- a/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
+++ b/frontend/src/features/providers/components/provider-tabs/ModelsTab.vue
@@ -226,6 +226,7 @@ import Button from '@/components/ui/button.vue'
 import { useToast } from '@/composables/useToast'
 import { getProviderModels, testModel, type Model } from '@/api/endpoints'
 import { updateModel } from '@/api/endpoints/models'
+import { parseTestModelError } from '@/utils/errorParser'
 
 const props = defineProps<{
   provider: any
@@ -415,37 +416,7 @@ async function testModelConnection(model: Model) {
         showSuccess(`流式测试成功，预览: ${result.data.content_preview}`)
       }
     } else {
-      // 根据不同的错误类型显示更详细的信息
-      let errorMsg = result.error || '测试失败'
-
-      // 检查HTTP状态码错误
-      if (result.data?.response?.status_code) {
-        const status = result.data.response.status_code
-        if (status === 403) {
-          errorMsg = '认证失败: API密钥无效或客户端类型不被允许'
-        } else if (status === 401) {
-          errorMsg = '认证失败: API密钥无效或已过期'
-        } else if (status === 404) {
-          errorMsg = '模型不存在: 请检查模型名称是否正确'
-        } else if (status === 429) {
-          errorMsg = '请求频率过高: 请稍后重试'
-        } else if (status >= 500) {
-          errorMsg = `服务器错误: HTTP ${status}`
-        } else {
-          errorMsg = `请求失败: HTTP ${status}`
-        }
-      }
-
-      // 尝试从错误响应中提取更多信息
-      if (result.data?.response?.error) {
-        if (typeof result.data.response.error === 'string') {
-          errorMsg = result.data.response.error
-        } else if (result.data.response.error?.message) {
-          errorMsg = result.data.response.error.message
-        }
-      }
-
-      showError(`模型测试失败: ${errorMsg}`)
+      showError(`模型测试失败: ${parseTestModelError(result)}`)
     }
   } catch (err: any) {
     const errorMsg = err.response?.data?.detail || err.message || '测试请求失败'
diff --git a/frontend/src/utils/errorParser.ts b/frontend/src/utils/errorParser.ts
index 9c23188..ad92f41 100644
--- a/frontend/src/utils/errorParser.ts
+++ b/frontend/src/utils/errorParser.ts
@@ -198,3 +198,49 @@ export function parseApiErrorShort(err: unknown, defaultMessage: string = '操
   const lines = fullError.split('\n')
   return lines[0] || defaultMessage
 }
+
+/**
+ * 解析模型测试响应的错误信息
+ * @param result 测试响应结果
+ * @returns 格式化的错误信息
+ */
+export function parseTestModelError(result: {
+  error?: string
+  data?: {
+    response?: {
+      status_code?: number
+      error?: string | { message?: string }
+    }
+  }
+}): string {
+  let errorMsg = result.error || '测试失败'
+
+  // 检查HTTP状态码错误
+  if (result.data?.response?.status_code) {
+    const status = result.data.response.status_code
+    if (status === 403) {
+      errorMsg = '认证失败: API密钥无效或客户端类型不被允许'
+    } else if (status === 401) {
+      errorMsg = '认证失败: API密钥无效或已过期'
+    } else if (status === 404) {
+      errorMsg = '模型不存在: 请检查模型名称是否正确'
+    } else if (status === 429) {
+      errorMsg = '请求频率过高: 请稍后重试'
+    } else if (status >= 500) {
+      errorMsg = `服务器错误: HTTP ${status}`
+    } else {
+      errorMsg = `请求失败: HTTP ${status}`
+    }
+  }
+
+  // 尝试从错误响应中提取更多信息
+  if (result.data?.response?.error) {
+    if (typeof result.data.response.error === 'string') {
+      errorMsg = result.data.response.error
+    } else if (result.data.response.error?.message) {
+      errorMsg = result.data.response.error.message
+    }
+  }
+
+  return errorMsg
+}
diff --git a/src/api/handlers/base/endpoint_checker.py b/src/api/handlers/base/endpoint_checker.py
index ab981da..c1d836e 100644
--- a/src/api/handlers/base/endpoint_checker.py
+++ b/src/api/handlers/base/endpoint_checker.py
@@ -1243,7 +1243,7 @@ class EndpointCheckOrchestrator:
                     api_format=api_format,
                 )
 
-                logger.info(f"[{request.api_format}] Usage calculated successfully: {usage_data}")
+                logger.info(f"[{request.api_format}] Usage calculated successfully: {result.usage_data}")
             except Exception as e:
                 logger.error(f"[{request.api_format}] Failed to calculate usage: {e}")
                 import traceback