Class ScenarioManager

backend/scenario.py:94–259

序列化当前仿真资源配置为可保存的场景对象，并支持从场景还原。 ``save`` / ``load`` 操作仅操作资源数量配置（地面站、LEO 卫星）， 不保存正在进行中的传输请求或实时仿真状态（快照功能由独立的 snapshot 模块负责）。

class ScenarioManager:
    """序列化当前仿真资源配置为可保存的场景对象，并支持从场景还原。

    ``save`` / ``load`` 操作仅操作资源数量配置（地面站、LEO 卫星），
    不保存正在进行中的传输请求或实时仿真状态（快照功能由独立的 snapshot 模块负责）。
    """

    @staticmethod
    def save(engine: Any, name: str = "") -> Dict[str, Any]:
        """将引擎当前资源配置序列化为场景字典。

        Parameters
        ----------
        engine:
            ``SimulationEngine`` 实例。
        name:
            场景名称（可选，便于人类识别）。

        Returns
        -------
        dict
            符合 Scenario Schema 的字典，可直接序列化为 JSON 或 YAML。
        """
        return {
            "version": SCENARIO_VERSION,
            "name": name or "unnamed",
            "saved_at": datetime.now(tz=timezone.utc).isoformat(),
            "ground_station_count": len(engine.ground_stations),
            "leo_satellite_count": len(engine.leo_satellites),
            "geo_relay_count": len(engine.geo_relays),
            "data_types": list(engine.DATA_TYPES.keys()) if hasattr(engine, "DATA_TYPES") else [],
        }

    @staticmethod
    def load(engine: Any, data: Dict[str, Any]) -> Dict[str, Any]:
        """从场景字典恢复引擎资源配置。

        只恢复可在运行时动态调整的资源数量（地面站、LEO 卫星）。

        Parameters
        ----------
        engine:
            ``SimulationEngine`` 实例。
        data:
            符合 Scenario Schema 的字典（由 :meth:`save` 生成或导入）。

        Returns
        -------
        dict
            包含恢复结果摘要的字典。
        """
        errors = ScenarioManager.validate(data)
        if errors:
            raise ValueError("场景数据非法: " + "; ".join(errors))

        changes: List[str] = []

        gs_count = data.get("ground_station_count")