Method compare

backend/store.py:296–402

对两个场景的决策指标进行对比，返回差值分析报告。 Parameters ---------- name_a: 场景 A 的名称（通常为基线）。 name_b: 场景 B 的名称（通常为待对比场景）。 Returns ------- dict :: { "scenario_a": {"name": ..., "saved_at": ...},

(self, name_a: str, name_b: str)

        return ScenarioManager.load(engine, scene_dict)

    def compare(self, name_a: str, name_b: str) -> Dict[str, Any]:
        """对两个场景的决策指标进行对比，返回差值分析报告。

        Parameters
        ----------
        name_a:
            场景 A 的名称（通常为基线）。
        name_b:
            场景 B 的名称（通常为待对比场景）。

        Returns
        -------
        dict
            ::

                {
                  "scenario_a": {"name": ..., "saved_at": ...},
                  "scenario_b": {"name": ..., "saved_at": ...},
                  "resource_diff": {
                      "gs_count": {"a": int, "b": int, "delta": int},
                      "leo_count": {"a": int, "b": int, "delta": int},
                  },
                  "metrics": {
                      "<field>": {
                          "label": str,
                          "a": float, "b": float,
                          "delta": float,           # b - a
                          "delta_pct": float | None # (b-a)/a*100, None if a==0
                      },
                      ...
                  },
                  "summary": str  # 人类可读的简短结论
                }

        Raises
        ------
        KeyError
            任一场景不存在时抛出。
        """
        rec_a = self.load_scenario(name_a)
        rec_b = self.load_scenario(name_b)
        if rec_a is None:
            raise KeyError(f"场景 '{name_a}' 不存在")
        if rec_b is None:
            raise KeyError(f"场景 '{name_b}' 不存在")

        metrics_a = rec_a.get("run_stats", {}).get("decision_metrics", {})
        metrics_b = rec_b.get("run_stats", {}).get("decision_metrics", {})

        # 逐指标计算差值
        metrics_report: Dict[str, Any] = {}
        for field in COMPARE_METRIC_FIELDS:
            val_a = float(metrics_a.get(field, 0.0))
            val_b = float(metrics_b.get(field, 0.0))
            delta = round(val_b - val_a, 6)
            delta_pct: Optional[float] = None
            if val_a != 0.0:
                delta_pct = round((val_b - val_a) / abs(val_a) * 100, 2)