"""Shared cache key helpers for embedding inputs.
  
  Current canonical raw-key format:

  - text (TEI/BGE): ``embed:norm1:<text>`` / ``embed:norm0:<text>``
  - image (CLIP):   ``embed:norm1:<url>``  / ``embed:norm0:<url>``
  - clip_text (CN-CLIP 文本，与图同空间): ``clip_mm:norm1:<text>`` / ``clip_mm:norm0:<text>``

  
  `RedisEmbeddingCache` adds the configured key prefix and optional namespace on top.
  """

  
  from __future__ import annotations
  
  
  def build_text_cache_key(text: str, *, normalize: bool) -> str:
      normalized_text = str(text or "").strip()

      return f"embed:norm{1 if normalize else 0}:{normalized_text}"

  
  
  def build_image_cache_key(url: str, *, normalize: bool) -> str:
      normalized_url = str(url or "").strip()

      return f"embed:norm{1 if normalize else 0}:{normalized_url}"

  
  
  def build_clip_text_cache_key(text: str, *, normalize: bool) -> str:
      """CN-CLIP / multimodal text (same vector space as /embed/image)."""
      normalized_text = str(text or "").strip()
      return f"clip_mm:norm{1 if normalize else 0}:{normalized_text}"