"""图片相关共用模型。"""

from typing import Optional

from pydantic import BaseModel, Field


class ImagePath(BaseModel):
    """文章注解类型：图片路径描述，用于 image_similar、load_image 等。"""

    path: str = Field(..., min_length=1, description="图片路径，不可空")
    path_type: Optional[str] = Field(
        default=None,
        description="路径类型，可空；如 filepath / url / oss_file",
    )