配置 API

@dataclass
class AppConfig:
    version: str
    theme: str
    layout: LayoutConfig
    modules: List[ModuleConfig]

@dataclass
class LayoutConfig:
    columns: int = 1  # 列数 (1-3)
    width: str = "default"  # "default", "narrow", "wide"
    show_nav: bool = True  # 是否显示导航栏
    column_config: List[ColumnConfig] = None  # 每列的配置

@dataclass
class ColumnConfig:
    width: str = "normal"  # "narrow" 或 "normal"
    modules: List[str] = None  # 要在此列中显示的模块 ID 列表

@dataclass
class ModuleConfig:
    id: str
    enabled: bool = True
    collapsed: bool = False
    config: dict = None

def load_config() -> AppConfig:
    """
    从文件加载配置或在不存在时创建默认配置。

    此函数尝试从系统特定的配置目录加载用户配置。
    如果不存在配置文件，它会使用默认配置模板创建一个。

    返回
    -------
    config : AppConfig
        包含版本、主题、布局和模块设置的应用程序配置对象。
    """

def save_config(config: AppConfig) -> None:
    """
    将配置保存到文件。

    参数
    ----------
    config : AppConfig
        要保存的应用程序配置对象。
    """

def get_config_dir():
    """
    获取系统特定的配置目录。

    返回
    -------
    config_dir : pathlib.Path
        基于操作系统的配置目录路径。

    说明
    -----
    配置目录按以下方式确定：
    - Windows: %APPDATA%\\ModularDashboard
    - macOS/Linux: ~/.config/ModularDashboard
    - 其他系统: ./config (备用)
    """