feat(frontend): 新增 API 错误类型定义，优化错误处理

- 新增 api-error.ts 定义标准错误类型和工具函数
- 重构 error.ts 和 errorParser.ts 使用新类型
- 更新 api client 的类型定义

frontend/src/utils/error.ts

@@ -2,19 +2,10 @@
  * 从后端响应中提取错误消息
  * 后端统一返回格式: {"error": {"type": "...", "message": "..."}}
  */
-export function extractErrorMessage(error: any, defaultMessage = '操作失败'): string {
-  // 优先从响应中提取错误消息
-  if (error.response?.data?.error?.message) {
-    return error.response.data.error.message
-  }
+import { type ApiError, isApiError, getErrorMessage as _getErrorMessage } from '@/types/api-error'
 
-  // 如果是网络错误或其他异常
-  if (error.message) {
-    return error.message
-  }
-
-  // 返回默认消息
-  return defaultMessage
+export function extractErrorMessage(error: unknown, defaultMessage = '操作失败'): string {
+  return _getErrorMessage(error, defaultMessage)
 }
 
 /**
@@ -38,8 +29,8 @@ export type ErrorType = typeof ErrorType[keyof typeof ErrorType]
 /**
  * 从后端响应中提取错误类型
  */
-export function extractErrorType(error: any): ErrorType | null {
-  if (error.response?.data?.error?.type) {
+export function extractErrorType(error: unknown): ErrorType | null {
+  if (isApiError(error) && error.response?.data?.error?.type) {
     return error.response.data.error.type as ErrorType
   }
   return null
@@ -48,6 +39,10 @@ export function extractErrorType(error: any): ErrorType | null {
 /**
  * 检查是否为特定类型的错误
  */
-export function isErrorType(error: any, type: ErrorType): boolean {
+export function isErrorType(error: unknown, type: ErrorType): boolean {
   return extractErrorType(error) === type
-}
+}
+
+// 重新导出类型
+export type { ApiError }
+export { isApiError }

frontend/src/utils/errorParser.ts

@@ -2,6 +2,8 @@
  * 解析 API 错误响应，提取友好的错误信息
  */
 
+import { isApiError } from '@/types/api-error'
+
 /**
  * Pydantic 验证错误项
  */
@@ -9,7 +11,7 @@ interface ValidationError {
   loc: (string | number)[]
   msg: string
   type: string
-  ctx?: Record<string, any>
+  ctx?: Record<string, unknown>
 }
 
 /**
@@ -138,11 +140,14 @@ function formatValidationError(error: ValidationError): string {
  * @param defaultMessage 默认错误信息
  * @returns 格式化的错误信息
  */
-export function parseApiError(err: any, defaultMessage: string = '操作失败'): string {
+export function parseApiError(err: unknown, defaultMessage: string = '操作失败'): string {
   if (!err) return defaultMessage
 
   // 处理网络错误
-  if (!err.response) {
+  if (!isApiError(err) || !err.response) {
+    if (err instanceof Error) {
+      return err.message || defaultMessage
+    }
     return '无法连接到服务器，请检查网络连接'
   }
 
@@ -169,8 +174,8 @@ export function parseApiError(err: any, defaultMessage: string = '操作失败')
   // 3. 处理对象错误
   if (typeof detail === 'object') {
     // 可能是自定义错误对象
-    if (detail.message) {
-      return detail.message
+    if ((detail as Record<string, unknown>).message) {
+      return String((detail as Record<string, unknown>).message)
     }
     // 尝试 JSON 序列化
     try {
@@ -186,7 +191,7 @@ export function parseApiError(err: any, defaultMessage: string = '操作失败')
 /**
  * 解析并提取第一个错误信息（用于简短提示）
  */
-export function parseApiErrorShort(err: any, defaultMessage: string = '操作失败'): string {
+export function parseApiErrorShort(err: unknown, defaultMessage: string = '操作失败'): string {
   const fullError = parseApiError(err, defaultMessage)
 
   // 如果有多行错误，只取第一行