Function get_cache_status

backend/physics/tle_source.py:324–373

返回本地 TLE 缓存目录的状态摘要。 返回 ---- dict 包含以下字段： - ``cache_dir`` (str): 缓存目录绝对路径 - ``entries`` (list): 每个缓存文件的摘要列表 - ``total_groups`` (int): 缓存的星座/分组总数 - ``total_tles`` (int): 缓存的 TLE 条目总数

()

# ---------------------------------------------------------------------------

def get_cache_status() -> dict:
    """返回本地 TLE 缓存目录的状态摘要。

    返回
    ----
    dict
        包含以下字段：

        - ``cache_dir`` (str): 缓存目录绝对路径
        - ``entries`` (list): 每个缓存文件的摘要列表
        - ``total_groups`` (int): 缓存的星座/分组总数
        - ``total_tles`` (int): 缓存的 TLE 条目总数
    """
    _ensure_cache_dir()
    entries = []
    total_tles = 0

    for meta_file in sorted(CACHE_DIR.glob("*.meta.json")):
        try:
            meta = json.loads(meta_file.read_text(encoding="utf-8"))
            group = meta.get("group", meta_file.stem.replace(".meta", ""))
            fetched_at = meta.get("fetched_at", "")
            entry_count = int(meta.get("entry_count", 0))
            fetched_at_unix = float(meta.get("fetched_at_unix", 0))
            age_seconds = int(time.time() - fetched_at_unix)
            is_fresh = age_seconds < _CACHE_MAX_AGE_SECONDS

            cache_file = _cache_path(group)
            file_size = cache_file.stat().st_size if cache_file.exists() else 0

            entries.append({
                "group": group,
                "fetched_at": fetched_at,
                "age_seconds": age_seconds,
                "is_fresh": is_fresh,
                "entry_count": entry_count,
                "file_size_bytes": file_size,
                "cache_file": str(cache_file),
            })
            total_tles += entry_count
        except Exception as exc:
            logger.debug("读取缓存元数据失败: %s, error=%s", meta_file, exc)

    return {
        "cache_dir": str(CACHE_DIR),
        "entries": entries,
        "total_groups": len(entries),
        "total_tles": total_tles,
        "cache_ttl_seconds": _CACHE_MAX_AGE_SECONDS,
    }


def inject_tle_into_constellation(