fix: 修复 mypy 类型检查错误并升级到 Python 3.14

主要变更：
- 修复 1483 个 mypy 类型检查错误
- 添加缺失的类型注解 (Any, Callable, Session 等)
- 修复隐式 Optional 类型 (param: Type = None -> param: Type | None = None)
- 修复 __new__ 单例模式返回类型
- 添加 type: ignore 注释处理第三方库类型问题
- 更新 pyproject.toml 依赖到 Python 3.14 兼容版本
- 更新 mypy/black 配置为 Python 3.14

src/api/admin/models/catalog.py

@@ -4,6 +4,7 @@
 基于 GlobalModel 的聚合视图
 """
 
+from typing import Any
 from dataclasses import dataclass
 
 from fastapi import APIRouter, Depends, Request
@@ -13,6 +14,7 @@ from src.api.base.admin_adapter import AdminApiAdapter
 from src.api.base.pipeline import ApiRequestPipeline
 from src.database import get_db
 from src.models.database import GlobalModel, Model
+from src.api.base.context import ApiRequestContext
 from src.models.pydantic_models import (
     ModelCapabilities,
     ModelCatalogItem,
@@ -59,7 +61,7 @@ class AdminGetModelCatalogAdapter(AdminApiAdapter):
     2. Model 表提供关联提供商和价格
     """
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         db: Session = context.db
 
         # 1. 获取所有活跃的 GlobalModel

src/api/admin/models/global_models.py

@@ -4,9 +4,12 @@ GlobalModel Admin API
 提供 GlobalModel 的 CRUD 操作接口
 """
 
+from __future__ import annotations
+
+from typing import Any
 from dataclasses import dataclass
 
-from fastapi import APIRouter, Depends, Query, Request
+from fastapi import APIRouter, Depends, Query, Request, Response
 from sqlalchemy.orm import Session
 
 from src.api.base.admin_adapter import AdminApiAdapter
@@ -26,6 +29,7 @@ from src.models.pydantic_models import (
     ModelCatalogProviderDetail,
 )
 from src.services.model.global_model import GlobalModelService
+from src.api.base.context import ApiRequestContext
 
 router = APIRouter(prefix="/global", tags=["Admin - Global Models"])
 pipeline = ApiRequestPipeline()
@@ -154,12 +158,12 @@ async def update_global_model(
     return await pipeline.run(adapter=adapter, http_request=request, db=db, mode=adapter.mode)
 
 
-@router.delete("/{global_model_id}", status_code=204)
+@router.delete("/{global_model_id}", status_code=204, response_class=Response)
 async def delete_global_model(
     request: Request,
     global_model_id: str,
     db: Session = Depends(get_db),
-):
+) -> Response:
     """
     删除 GlobalModel
 
@@ -174,7 +178,7 @@ async def delete_global_model(
     """
     adapter = AdminDeleteGlobalModelAdapter(global_model_id=global_model_id)
     await pipeline.run(adapter=adapter, http_request=request, db=db, mode=adapter.mode)
-    return None
+    return Response(status_code=204)
 
 
 @router.post(
@@ -256,7 +260,7 @@ class AdminListGlobalModelsAdapter(AdminApiAdapter):
     is_active: bool | None
     search: str | None
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         from sqlalchemy import func
 
         from src.models.database import Model
@@ -302,7 +306,7 @@ class AdminGetGlobalModelAdapter(AdminApiAdapter):
 
     global_model_id: str
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         global_model = GlobalModelService.get_global_model(context.db, self.global_model_id)
         stats = GlobalModelService.get_global_model_stats(context.db, self.global_model_id)
 
@@ -320,7 +324,7 @@ class AdminCreateGlobalModelAdapter(AdminApiAdapter):
 
     payload: GlobalModelCreate
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         from src.core.exceptions import InvalidRequestException
         from src.core.model_permissions import validate_and_extract_model_mappings
 
@@ -359,7 +363,7 @@ class AdminUpdateGlobalModelAdapter(AdminApiAdapter):
     global_model_id: str
     payload: GlobalModelUpdate
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         from src.core.exceptions import InvalidRequestException
         from src.core.model_permissions import validate_and_extract_model_mappings
 
@@ -418,7 +422,7 @@ class AdminDeleteGlobalModelAdapter(AdminApiAdapter):
 
     global_model_id: str
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         # 使用行级锁获取 GlobalModel 信息，防止并发操作导致的竞态条件
         # 设置 2 秒锁超时，允许短暂等待而非立即失败
         from sqlalchemy import text
@@ -467,7 +471,7 @@ class AdminBatchAssignToProvidersAdapter(AdminApiAdapter):
     global_model_id: str
     payload: BatchAssignToProvidersRequest
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         result = GlobalModelService.batch_assign_to_providers(
             db=context.db,
             global_model_id=self.global_model_id,
@@ -492,7 +496,7 @@ class AdminGetGlobalModelProvidersAdapter(AdminApiAdapter):
 
     global_model_id: str
 
-    async def handle(self, context):  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> Any:  # type: ignore[override]
         from sqlalchemy.orm import joinedload
 
         from src.models.database import Model

src/api/admin/models/routing.py

@@ -8,6 +8,8 @@ GlobalModel 请求链路预览 API
 - Key 的并发配置和健康状态
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 
 from fastapi import APIRouter, Depends, Request
@@ -30,6 +32,7 @@ from src.models.database import (
     ProviderEndpoint,
 )
 from src.services.cache.aware_scheduler import CacheAwareScheduler
+from src.api.base.context import ApiRequestContext
 from src.services.system.config import SystemConfigService
 
 router = APIRouter(prefix="/global", tags=["Admin - Global Models"])
@@ -204,7 +207,7 @@ class AdminGetModelRoutingPreviewAdapter(AdminApiAdapter):
 
     global_model_id: str
 
-    async def handle(self, context) -> ModelRoutingPreviewResponse:  # type: ignore[override]
+    async def handle(self, context: ApiRequestContext) -> ModelRoutingPreviewResponse:  # type: ignore[override]
         db = context.db
 
         # 获取 GlobalModel