refactor(backend): update handlers, utilities and core modules after models restructure

src/api/handlers/base/chat_handler_base.py

@@ -263,7 +263,10 @@ class ChatHandlerBase(BaseMessageHandler, ABC):
         mapping = await mapper.get_mapping(source_model, provider_id)
 
         if mapping and mapping.model:
-            mapped_name = str(mapping.model.provider_model_name)
+            # 使用 select_provider_model_name 支持别名功能
+            # 传入 api_key.id 作为 affinity_key，实现相同用户稳定选择同一别名
+            affinity_key = self.api_key.id if self.api_key else None
+            mapped_name = mapping.model.select_provider_model_name(affinity_key)
             logger.debug(f"[Chat] 模型映射: {source_model} -> {mapped_name}")
             return mapped_name
 

src/api/handlers/base/cli_handler_base.py

@@ -190,14 +190,17 @@ class CliMessageHandlerBase(BaseMessageHandler):
         """
         获取模型映射后的实际模型名
 
-        按优先级查找：映射 → 别名 → 直接匹配 GlobalModel
+        查找逻辑：
+        1. 直接通过 GlobalModel.name 匹配
+        2. 查找该 Provider 的 Model 实现
+        3. 使用 provider_model_name / provider_model_aliases 选择最终名称
 
         Args:
-            source_model: 用户请求的模型名（可能是别名）
+            source_model: 用户请求的模型名（必须是 GlobalModel.name）
             provider_id: Provider ID
 
         Returns:
-            映射后的 provider_model_name，如果没有找到映射则返回 None
+            映射后的 Provider 模型名，如果没有找到映射则返回 None
         """
         from src.services.model.mapper import ModelMapperMiddleware
 
@@ -207,7 +210,10 @@ class CliMessageHandlerBase(BaseMessageHandler):
         logger.debug(f"[CLI] _get_mapped_model: source={source_model}, provider={provider_id[:8]}..., mapping={mapping}")
 
         if mapping and mapping.model:
-            mapped_name = str(mapping.model.provider_model_name)
+            # 使用 select_provider_model_name 支持别名功能
+            # 传入 api_key.id 作为 affinity_key，实现相同用户稳定选择同一别名
+            affinity_key = self.api_key.id if self.api_key else None
+            mapped_name = mapping.model.select_provider_model_name(affinity_key)
             logger.debug(f"[CLI] 模型映射: {source_model} -> {mapped_name} (provider={provider_id[:8]}...)")
             return mapped_name
 

src/api/handlers/base/parsers.py

@@ -5,7 +5,7 @@
 不再经过 Protocol 抽象层。
 """
 
-from typing import Any, Dict, Optional, Tuple
+from typing import Any, Dict, Optional, Tuple, Type
 
 from src.api.handlers.base.response_parser import (
     ParsedChunk,
@@ -60,7 +60,7 @@ def _check_nested_error(response: Dict[str, Any]) -> Tuple[bool, Optional[Dict[s
 class OpenAIResponseParser(ResponseParser):
     """OpenAI 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         from src.api.handlers.openai.stream_parser import OpenAIStreamParser
 
         self._parser = OpenAIStreamParser()
@@ -146,7 +146,7 @@ class OpenAIResponseParser(ResponseParser):
         if choices:
             message = choices[0].get("message", {})
             content = message.get("content")
-            if content:
+            if isinstance(content, str):
                 return content
         return ""
 
@@ -158,7 +158,7 @@ class OpenAIResponseParser(ResponseParser):
 class OpenAICliResponseParser(OpenAIResponseParser):
     """OpenAI CLI 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.name = "OPENAI_CLI"
         self.api_format = "OPENAI_CLI"
@@ -167,7 +167,7 @@ class OpenAICliResponseParser(OpenAIResponseParser):
 class ClaudeResponseParser(ResponseParser):
     """Claude 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         from src.api.handlers.claude.stream_parser import ClaudeStreamParser
 
         self._parser = ClaudeStreamParser()
@@ -291,7 +291,7 @@ class ClaudeResponseParser(ResponseParser):
 class ClaudeCliResponseParser(ClaudeResponseParser):
     """Claude CLI 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.name = "CLAUDE_CLI"
         self.api_format = "CLAUDE_CLI"
@@ -300,7 +300,7 @@ class ClaudeCliResponseParser(ClaudeResponseParser):
 class GeminiResponseParser(ResponseParser):
     """Gemini 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         from src.api.handlers.gemini.stream_parser import GeminiStreamParser
 
         self._parser = GeminiStreamParser()
@@ -443,20 +443,20 @@ class GeminiResponseParser(ResponseParser):
 
         使用增强的错误检测逻辑，支持嵌套在 chunks 中的错误
         """
-        return self._parser.is_error_event(response)
+        return bool(self._parser.is_error_event(response))
 
 
 class GeminiCliResponseParser(GeminiResponseParser):
     """Gemini CLI 格式响应解析器"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.name = "GEMINI_CLI"
         self.api_format = "GEMINI_CLI"
 
 
 # 解析器注册表
-_PARSERS = {
+_PARSERS: Dict[str, Type[ResponseParser]] = {
     "CLAUDE": ClaudeResponseParser,
     "CLAUDE_CLI": ClaudeCliResponseParser,
     "OPENAI": OpenAIResponseParser,
@@ -498,6 +498,5 @@ __all__ = [
     "GeminiResponseParser",
     "GeminiCliResponseParser",
     "get_parser_for_format",
-    "get_parser_from_protocol",
     "is_cli_format",
 ]