"""
通用单例模式基类
"""
from typing import Any, Optional, Type, TypeVar

T = TypeVar('T')

class Singleton:
    """
    一个通用的单例基类

    任何继承自该类的子类都将自动成为单例。
    它通过重写 __new__ 方法来确保每个类只有一个实例。
    同时，它处理了重复初始化的问题，确保 __init__ 方法只在第一次实例化时被调用。
    """
    _instance: Optional[Any] = None
    _initialized: bool = False

    def __new__(cls: Type[T], *args: Any, **kwargs: Any) -> T:
        """
        创建或返回现有的实例

        Args:
            *args: 传递给构造函数的位置参数
            **kwargs: 传递给构造函数的关键字参数

        Returns:
            T: 单例实例
        """
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance

    def __init__(self) -> None:
        """
        确保初始化逻辑只执行一次
        """
        if self._initialized:
            return
        self._initialized = True