Method validate

backend/scenario.py:175–208

校验场景字典的结构合法性。 Parameters ---------- data: 待校验的对象。 Returns ------- list[str] 错误描述列表；空列表表示合法。

(data: Any)

    @staticmethod
    def validate(data: Any) -> List[str]:
        """校验场景字典的结构合法性。

        Parameters
        ----------
        data:
            待校验的对象。

        Returns
        -------
        list[str]
            错误描述列表；空列表表示合法。
        """
        errors: List[str] = []
        if not isinstance(data, dict):
            return ["顶层结构必须为对象（dict）"]

        version = data.get("version")
        if version is None:
            errors.append("缺少 'version' 字段")
        elif str(version) != SCENARIO_VERSION:
            errors.append(f"版本不兼容: 期望 '{SCENARIO_VERSION}'，收到 '{version}'")

        for field, expected_type in [
            ("ground_station_count", int),
            ("leo_satellite_count", int),
        ]:
            val = data.get(field)
            if val is None:
                errors.append(f"缺少必填字段 '{field}'")
            elif not isinstance(val, int) or val < 0:
                errors.append(f"字段 '{field}' 必须为非负整数，收到: {val!r}")

        return errors

    # ── 序列化辅助 ──────────────────────────────────────────────────────────