Tolan/backend/shop_item_image_utils.py

"""商品图片：列表缩略图 image_name vs 场景网格 render_image_name。"""
from __future__ import annotations

from typing import Any, Mapping


def scene_image_name_from_shop_row(row: Mapping[str, Any] | None) -> str:
    """场景/槽位快照使用的 OSS 文件名：优先 render_image_name，否则 image_name。"""
    if not row:
        return ""
    alt = (row.get("render_image_name") or "").strip()
    if alt:
        return alt
    return str(row.get("image_name") or "")