chore: 升级到 Python 3.14 并现代化代码

- 升级 Docker 基础镜像从 Python 3.12 到 3.14
- 更新 pyproject.toml 支持 Python 3.13/3.14
- 移除 Python 3.8/3.9/3.10/3.11 分类器
- 更新 black 和 mypy 配置目标版本
- 将 get_event_loop() 替换为 get_running_loop() 加上 RuntimeError 处理
- 简化 compute_cost_sync 中的 asyncio.run 使用
- Dict/List/Tuple/Set → dict/list/tuple/set (PEP 585)
- Optional[T] → T | None (PEP 604)
- Union[A, B] → A | B (PEP 604)
- 移除废弃的 typing 导入
- 移除不必要的字符串引号注解

src/api/handlers/claude/adapter.py

@@ -4,7 +4,7 @@ Claude Chat Adapter - 基于 ChatAdapterBase 的 Claude Chat API 适配器
 处理 /v1/messages 端点的 Claude Chat 格式请求。
 """
 
-from typing import Any, Dict, Optional, Tuple, Type
+from typing import Any
 
 import httpx
 from fastapi import HTTPException, Request
@@ -25,9 +25,9 @@ class ClaudeCapabilityDetector:
 
     @staticmethod
     def detect_from_headers(
-        headers: Dict[str, str],
-        request_body: Optional[Dict[str, Any]] = None,
-    ) -> Dict[str, bool]:
+        headers: dict[str, str],
+        request_body: dict[str, Any] | None = None,
+    ) -> dict[str, bool]:
         """
         从 Claude 请求头检测能力需求
 
@@ -38,7 +38,7 @@ class ClaudeCapabilityDetector:
             headers: 请求头字典
             request_body: 请求体（Claude 不使用，保留用于接口统一）
         """
-        requirements: Dict[str, bool] = {}
+        requirements: dict[str, bool] = {}
 
         # 使用统一的大小写不敏感获取
         beta_header = get_header_value(headers, "anthropic-beta")
@@ -61,21 +61,21 @@ class ClaudeChatAdapter(ChatAdapterBase):
     name = "claude.chat"
 
     @property
-    def HANDLER_CLASS(self) -> Type[ChatHandlerBase]:
+    def HANDLER_CLASS(self) -> type[ChatHandlerBase]:
         """延迟导入 Handler 类避免循环依赖"""
         from src.api.handlers.claude.handler import ClaudeChatHandler
 
         return ClaudeChatHandler
 
-    def __init__(self, allowed_api_formats: Optional[list[str]] = None):
+    def __init__(self, allowed_api_formats: list[str] | None = None):
         super().__init__(allowed_api_formats or ["CLAUDE"])
         logger.info(f"[{self.name}] 初始化Chat模式适配器 | API格式: {self.allowed_api_formats}")
 
     def detect_capability_requirements(
         self,
-        headers: Dict[str, str],
-        request_body: Optional[Dict[str, Any]] = None,
-    ) -> Dict[str, bool]:
+        headers: dict[str, str],
+        request_body: dict[str, Any] | None = None,
+    ) -> dict[str, bool]:
         """检测 Claude 请求中隐含的能力需求"""
         return ClaudeCapabilityDetector.detect_from_headers(headers)
 
@@ -124,7 +124,7 @@ class ClaudeChatAdapter(ChatAdapterBase):
             )
         return request
 
-    def _build_audit_metadata(self, _payload: Dict[str, Any], request_obj) -> Dict[str, Any]:
+    def _build_audit_metadata(self, _payload: dict[str, Any], request_obj) -> dict[str, Any]:
         """构建 Claude Chat 特定的审计元数据"""
         role_counts: dict[str, int] = {}
         for message in request_obj.messages:
@@ -153,8 +153,8 @@ class ClaudeChatAdapter(ChatAdapterBase):
         client: httpx.AsyncClient,
         base_url: str,
         api_key: str,
-        extra_headers: Optional[Dict[str, str]] = None,
-    ) -> Tuple[list, Optional[str]]:
+        extra_headers: dict[str, str] | None = None,
+    ) -> tuple[list, str | None]:
         """查询 Claude API 支持的模型列表"""
         headers = cls.build_headers_with_extra(api_key, extra_headers)
 
@@ -201,7 +201,7 @@ class ClaudeChatAdapter(ChatAdapterBase):
     # build_request_body 使用基类实现，通过 format_conversion_registry 自动转换 OPENAI -> CLAUDE
 
 
-def build_claude_adapter(x_app_header: Optional[str]):
+def build_claude_adapter(x_app_header: str | None):
     """根据 x-app 头部构造 Chat 或 Claude Code 适配器。"""
     if x_app_header and x_app_header.lower() == "cli":
         from src.api.handlers.claude_cli.adapter import ClaudeCliAdapter
@@ -216,7 +216,7 @@ class ClaudeTokenCountAdapter(ApiAdapter):
     name = "claude.token_count"
     mode = ApiMode.STANDARD
 
-    def extract_api_key(self, request: Request) -> Optional[str]:
+    def extract_api_key(self, request: Request) -> str | None:
         """从请求中提取 API 密钥 (x-api-key 或 Authorization: Bearer)"""
         # 优先检查 x-api-key
         api_key = request.headers.get("x-api-key")

src/api/handlers/claude/handler.py

@@ -5,7 +5,7 @@ Claude Chat Handler - 基于通用 Chat Handler 基类的简化实现
 代码量从原来的 ~1470 行减少到 ~120 行。
 """
 
-from typing import Any, Dict, Optional
+from typing import Any
 
 from src.api.handlers.base.chat_handler_base import ChatHandlerBase
 from src.api.handlers.base.utils import extract_cache_creation_tokens
@@ -25,8 +25,8 @@ class ClaudeChatHandler(ChatHandlerBase):
 
     def extract_model_from_request(
         self,
-        request_body: Dict[str, Any],
-        path_params: Optional[Dict[str, Any]] = None,  # noqa: ARG002
+        request_body: dict[str, Any],
+        path_params: dict[str, Any] | None = None,  # noqa: ARG002
     ) -> str:
         """
         从请求中提取模型名 - Claude 格式实现
@@ -45,9 +45,9 @@ class ClaudeChatHandler(ChatHandlerBase):
 
     def apply_mapped_model(
         self,
-        request_body: Dict[str, Any],
+        request_body: dict[str, Any],
         mapped_model: str,
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """
         将映射后的模型名应用到请求体
 
@@ -90,7 +90,7 @@ class ClaudeChatHandler(ChatHandlerBase):
 
         return request
 
-    def _extract_usage(self, response: Dict) -> Dict[str, int]:
+    def _extract_usage(self, response: dict) -> dict[str, int]:
         """
         从 Claude 响应中提取 token 使用情况
 
@@ -108,7 +108,7 @@ class ClaudeChatHandler(ChatHandlerBase):
             "cache_read_input_tokens": usage.get("cache_read_input_tokens", 0),
         }
 
-    def _normalize_response(self, response: Dict[str, Any]) -> Dict[str, Any]:
+    def _normalize_response(self, response: dict[str, Any]) -> dict[str, Any]:
         """
         规范化 Claude 响应
 

src/api/handlers/claude/stream_parser.py

@@ -4,10 +4,9 @@ Claude SSE 流解析器
 解析 Claude Messages API 的 Server-Sent Events 流。
 """
 
-from __future__ import annotations
 
 import json
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from src.api.handlers.base.utils import extract_cache_creation_tokens
 
@@ -43,7 +42,7 @@ class ClaudeStreamParser:
     DELTA_TEXT = "text_delta"
     DELTA_INPUT_JSON = "input_json_delta"
 
-    def parse_chunk(self, chunk: bytes | str) -> List[Dict[str, Any]]:
+    def parse_chunk(self, chunk: bytes | str) -> list[dict[str, Any]]:
         """
         解析 SSE 数据块
 
@@ -58,10 +57,10 @@ class ClaudeStreamParser:
         else:
             text = chunk
 
-        events: List[Dict[str, Any]] = []
+        events: list[dict[str, Any]] = []
         lines = text.strip().split("\n")
 
-        current_event_type: Optional[str] = None
+        current_event_type: str | None = None
 
         for line in lines:
             line = line.strip()
@@ -96,7 +95,7 @@ class ClaudeStreamParser:
 
         return events
 
-    def parse_line(self, line: str) -> Optional[Dict[str, Any]]:
+    def parse_line(self, line: str) -> dict[str, Any] | None:
         """
         解析单行 SSE 数据
 
@@ -117,7 +116,7 @@ class ClaudeStreamParser:
         except json.JSONDecodeError:
             return None
 
-    def is_done_event(self, event: Dict[str, Any]) -> bool:
+    def is_done_event(self, event: dict[str, Any]) -> bool:
         """
         判断是否为结束事件
 
@@ -130,7 +129,7 @@ class ClaudeStreamParser:
         event_type = event.get("type")
         return event_type in (self.EVENT_MESSAGE_STOP, "__done__")
 
-    def is_error_event(self, event: Dict[str, Any]) -> bool:
+    def is_error_event(self, event: dict[str, Any]) -> bool:
         """
         判断是否为错误事件
 
@@ -142,7 +141,7 @@ class ClaudeStreamParser:
         """
         return event.get("type") == self.EVENT_ERROR
 
-    def get_event_type(self, event: Dict[str, Any]) -> Optional[str]:
+    def get_event_type(self, event: dict[str, Any]) -> str | None:
         """
         获取事件类型
 
@@ -155,7 +154,7 @@ class ClaudeStreamParser:
         event_type = event.get("type")
         return str(event_type) if event_type is not None else None
 
-    def extract_text_delta(self, event: Dict[str, Any]) -> Optional[str]:
+    def extract_text_delta(self, event: dict[str, Any]) -> str | None:
         """
         从 content_block_delta 事件中提取文本增量
 
@@ -175,7 +174,7 @@ class ClaudeStreamParser:
 
         return None
 
-    def extract_usage(self, event: Dict[str, Any]) -> Optional[Dict[str, int]]:
+    def extract_usage(self, event: dict[str, Any]) -> dict[str, int] | None:
         """
         从事件中提取 token 使用量
 
@@ -212,7 +211,7 @@ class ClaudeStreamParser:
 
         return None
 
-    def extract_message_id(self, event: Dict[str, Any]) -> Optional[str]:
+    def extract_message_id(self, event: dict[str, Any]) -> str | None:
         """
         从 message_start 事件中提取消息 ID
 
@@ -229,7 +228,7 @@ class ClaudeStreamParser:
         msg_id = message.get("id")
         return str(msg_id) if msg_id is not None else None
 
-    def extract_stop_reason(self, event: Dict[str, Any]) -> Optional[str]:
+    def extract_stop_reason(self, event: dict[str, Any]) -> str | None:
         """
         从 message_delta 事件中提取停止原因