fix: 添加 from __future__ import annotations 修复运行时类型错误

原 PR 将 Optional[X] 改为 X | None 后，如果 X 在 TYPE_CHECKING 块中导入，
会导致运行时 NameError。添加 future annotations 使类型注解延迟求值。

影响文件：
- src/services/auth/service.py
- src/core/api_format/utils.py
- src/core/api_format/detection.py
- 及其他 15 个使用 TYPE_CHECKING 的文件

src/api/base/pipeline.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import time
 from enum import Enum
 from typing import TYPE_CHECKING, Any

src/api/handlers/base/base_handler.py

@@ -25,6 +25,8 @@
     ) -> JSONResponse: ...
 """
 
+from __future__ import annotations
+
 
 import asyncio
 import time

src/api/handlers/base/cli_handler_base.py

@@ -10,6 +10,8 @@ CLI Message Handler 通用基类
 3. 简化新格式接入 - 只需实现 ResponseParser 和少量钩子方法
 """
 
+from __future__ import annotations
+
 import asyncio
 import codecs
 import json

src/api/handlers/base/stream_context.py

@@ -8,6 +8,8 @@
 - 请求/响应数据
 """
 
+from __future__ import annotations
+
 import time
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any

src/api/handlers/base/utils.py

@@ -2,6 +2,8 @@
 Handler 基础工具函数
 """
 
+from __future__ import annotations
+
 
 import json
 from typing import TYPE_CHECKING, Any

src/core/api_format/conversion/compatibility.py

@@ -10,6 +10,8 @@
    - data_format_id 不同 -> 需要转换，检查全局开关 + 端点配置 + 转换器能力
 """
 
+from __future__ import annotations
+
 
 import logging
 from typing import TYPE_CHECKING

src/core/api_format/detection.py

@@ -4,6 +4,8 @@ API 格式检测
 提供从请求头、响应内容等检测 API 格式的函数。
 """
 
+from __future__ import annotations
+
 
 from typing import TYPE_CHECKING
 

src/core/api_format/utils.py

@@ -4,6 +4,7 @@ API 格式工具函数
 提供格式判断、规范化等工具函数，供整个项目使用。
 """
 
+from __future__ import annotations
 
 from typing import TYPE_CHECKING
 

src/core/modules/base.py

@@ -4,6 +4,8 @@
 包含模块元数据、定义和状态的数据结构
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass, field
 from enum import Enum
 from typing import TYPE_CHECKING, Any

src/middleware/plugin_middleware.py

@@ -6,6 +6,8 @@
 以避免 Starlette 已知的流式响应兼容性问题。
 """
 
+from __future__ import annotations
+
 import hashlib
 import time
 from typing import TYPE_CHECKING

src/modules/ldap/__init__.py

@@ -4,6 +4,8 @@ LDAP 认证模块
 提供 LDAP/Active Directory 用户认证支持
 """
 
+from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 from src.core.modules.base import (

src/modules/oauth/__init__.py

@@ -4,6 +4,8 @@ OAuth 认证模块
 提供可配置的 OAuth 登录/绑定能力。
 """
 
+from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 from src.core.modules.base import (

src/services/auth/oauth/base.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from abc import ABC, abstractmethod
 from typing import TYPE_CHECKING
 from urllib.parse import urlencode, urlparse, urlunparse

src/services/auth/oauth/providers/linuxdo.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING, Any
 
 from src.core.logger import logger

src/services/auth/service.py

@@ -2,6 +2,7 @@
 认证服务
 """
 
+from __future__ import annotations
 
 import hashlib
 import secrets

src/services/cache/aware_scheduler.py

@@ -28,6 +28,8 @@
    - 失效缓存亲和性，避免重复选择故障资源
 """
 
+from __future__ import annotations
+
 
 import hashlib
 import random

src/services/provider/transport.py

@@ -6,6 +6,8 @@
 - URL 脱敏（用于日志记录）
 """
 
+from __future__ import annotations
+
 import re
 from typing import TYPE_CHECKING, Any
 from urllib.parse import urlencode

src/services/rate_limit/adaptive_reservation.py

@@ -10,6 +10,8 @@
 3. 置信度计算：综合考虑连续成功次数、429冷却时间、调整历史稳定性
 """
 
+from __future__ import annotations
+
 import statistics
 from dataclasses import dataclass, field
 from datetime import datetime, timezone