Function fetch_by_catnr

backend/physics/tle_source.py:273–307

按 NORAD 卫星编号（CATNR）拉取 TLE 条目。 参数 ---- catnr : int NORAD 卫星目录编号（如 25544 为 ISS）。 force_refresh : bool 强制刷新，忽略缓存。 返回 ---- list of TleEntry 通常包含 0 或 1 条记录。

(catnr: int, force_refresh: bool = False)

def fetch_by_catnr(catnr: int, force_refresh: bool = False) -> List[TleEntry]:
    """按 NORAD 卫星编号（CATNR）拉取 TLE 条目。

    参数
    ----
    catnr : int
        NORAD 卫星目录编号（如 25544 为 ISS）。
    force_refresh : bool
        强制刷新，忽略缓存。

    返回
    ----
    list of TleEntry
        通常包含 0 或 1 条记录。
    """
    group_key = f"catnr_{catnr}"

    if not force_refresh and _cache_is_fresh(group_key):
        cached = _read_cache(group_key)
        if cached:
            return _parse_tle_text(cached)

    url = f"https://celestrak.org/SOCRATES/query.php?FORMAT=TLE&CATNR={catnr}"
    try:
        raw_text = _http_get(url, timeout=_FETCH_TIMEOUT)
        if raw_text and raw_text.strip():
            _write_cache(group_key, raw_text)
            return _parse_tle_text(raw_text)
    except Exception as exc:
        logger.warning("Celestrak CATNR 拉取失败: catnr=%d, error=%s", catnr, exc)

    cached = _read_cache(group_key)
    if cached:
        return _parse_tle_text(cached)
    return []


def _http_get(url: str, timeout: int = 15) -> str: