from typing import Optional, List from datetime import datetime from pydantic import BaseModel, Field class PluginPublishRequest(BaseModel): name: str = Field(..., description="插件唯一英文标识,如: tls_plugin") version: str = Field(..., description="版本号,如: 1.0.1") display_name: Optional[str] = Field("", description="插件中文展示名") description: Optional[str] = Field("", description="插件功能描述") download_url: Optional[str] = Field(None, description="已有文件下载地址") sha256: Optional[str] = Field("", description="文件 SHA256 校验和") changelog: Optional[str] = Field(None, description="本次版本更新日志") set_as_latest: bool = Field(True, description="是否立即将该版本设为插件最新版本") class PluginPublishOut(BaseModel): plugin_id: int name: str version: str download_url: str sha256: str class PluginOut(BaseModel): id: int name: str display_name: str filename: str latest_version: str description: str status: int created_at: Optional[datetime] = None updated_at: Optional[datetime] = None class Config: from_attributes = True class PluginListResponse(BaseModel): list: List[PluginOut] total: int class PluginVersionOut(BaseModel): id: int version: str download_url: str sha256: str changelog: Optional[str] = None created_at: Optional[datetime] = None class Config: from_attributes = True class PluginDetailOut(BaseModel): id: int name: str display_name: str filename: str latest_version: str description: str status: int versions: List[PluginVersionOut] = [] class Config: from_attributes = True class PluginUpdate(BaseModel): display_name: Optional[str] = Field(None, description="插件展示名") description: Optional[str] = Field(None, description="功能描述") status: Optional[int] = Field(None, description="状态: 1-启用, 0-停用") class PluginSwitchVersion(BaseModel): plugin_id: int = Field(..., description="插件ID") version: str = Field(..., description="切换的目标版本号") class PluginUpgradeDispatch(BaseModel): target_node: str = Field("all", description="'all' 表示全量广播,或指定特定节点 node_id 如 'node01'") plugins: List[str] = Field(default_factory=list, description="指定升级的插件英文名列表;传空数组 [] 表示对所有启用的插件下发最新版") class PluginLatestItemOut(BaseModel): name: str display_name: str filename: str version: str description: str download_url: str sha256: str changelog: Optional[str] = None