Method take

backend/snapshot.py:64–107

对仿真引擎当前状态拍快照。 Parameters ---------- engine: ``SimulationEngine`` 实例。 label: 可选的快照标签，便于人类识别（例如场景名称或事件描述）。 Returns ------- dict 快照字典，包含 current_time、请求列表、资源占用与统计数据。

(engine: Any, label: str = "")

    @staticmethod
    def take(engine: Any, label: str = "") -> Dict[str, Any]:
        """对仿真引擎当前状态拍快照。

        Parameters
        ----------
        engine:
            ``SimulationEngine`` 实例。
        label:
            可选的快照标签，便于人类识别（例如场景名称或事件描述）。

        Returns
        -------
        dict
            快照字典，包含 current_time、请求列表、资源占用与统计数据。
        """
        from backend.core import TransmissionRequest  # 避免循环导入

        with engine.lock:
            # 序列化进行中的请求
            active_requests = [req.to_dict() for req in engine.transmission_requests]
            # 序列化历史请求
            history_requests = [req.to_dict() for req in engine.request_history]

            # 深拷贝资源占用状态（嵌套容器）
            resource_usage = copy.deepcopy(dict(engine.resource_usage))
            resource_time_pool = copy.deepcopy(dict(engine._resources.time_pool))

            # 深拷贝统计数据
            stats = copy.deepcopy(engine.stats)

            snapshot = {
                "version": SNAPSHOT_VERSION,
                "saved_at": datetime.now(tz=timezone.utc).isoformat(),
                "label": label or "",
                "current_time": engine.current_time,
                "id_counter": TransmissionRequest._id_counter,
                "transmission_requests": active_requests,
                "request_history": history_requests,
                "resource_usage": resource_usage,
                "resource_time_pool": resource_time_pool,
                "stats": stats,
            }

        return snapshot

    # ── 从快照恢复 ──────────────────────────────────────────────────────────────