Clear the global sliding-window rate limiter before every test.

仿真主循环

Background thread: periodically publishes a full situation snapshot. ``engine_ref_getter`` is a zero-argument callable that returns the

* 启动链路流动动画循环。 * 通过持续调用 requestRender 驱动 Cesium 在 requestRenderMode 下不断重绘， * 同时利用 PolylineGlowMaterialProperty 的自发光效果模拟数据流动感。 * 每帧递增 _li

* 启动 2 秒轮询回退（在 SSE 不可用时使用）。

* 停止链路流动动画循环（当无活跃传输链路时调用）。

顺序提交一批请求，收集所有返回结果。

在一个线程中提交 n 次请求，收集结果或异常。

⭐ 新增：校验时间窗口是否满足传输需求

当前活跃波束数。

分配��个活跃波束槽位，更新当前指向。 Parameters ---------- beam_key : str 波束唯一标识（如请求 ID 或 ``"<station>-<target>"``）。 azimu

账号密码登录，签发 access/refresh JWT。

用 refresh token 换取新的 access token。

剩余可用波束槽位数。

Current base URL (without trailing slash).

不启动后台线程的固定种子引擎，模块作用域，避免重复初始化开销。

第二个 GEO 中继星位置（多跳链路使用）。

固定 GEO 中继星位置。

Ka 天线地面站。

X 天线地面站。

固定卫星位置（lat/lon/alt）。

场景 2：RAW_IMAGE 仅直连场景引擎。 RAW_IMAGE 的 allowed_links=["direct"]，中继路径必须被忽略。 本场景验证提交后的 transmission_method 仅为 "direct" 或请求处于等待（无链路时）。

场景 3：中继带宽耗尽场景引擎。 预先手动填满 GEO 中继的带宽占用，使后续低优先级请求因 BANDWIDTH_EXCEEDED 被拒绝。

场景 1：TASK_CMD 立即接受场景引擎。 TASK_CMD 属于 immediate=True 类型，_evaluate_request 会直接返回 (True, "指令类型立即接受")。 本场景验证无需任何链路可见、立即进入 accepted 状态。

场景 4：等待超时场景引擎。 创建引擎后推进超过 max_delay 的时间，使 accepted 状态的请求触发 TIMEOUT_WAIT 拒绝。 本场景通过极短的 max_delay 快速触发超时。

高频提交 TASK_CMD 请求，制造峰值并发压力。

校验对目标 (azimuth, elevation) 的波束指向请求。 Parameters ---------- azimuth_deg : float 目标方位角（度），相对天线法线方向。 elevatio

轮询健康检查接口，监控系统在高负载下的响应能力。

轮询资源利用率接口，采集基线数据。

轮询系统信息接口，监控统计计数。

将干净引擎注入 api.app，返回 Flask test_client。 通过替换 api.simulation_engine 避免全局状态污染；测试结束后恢复原始引擎。

将干净引擎注入 api.app，返回 Flask test_client。 测试结束后恢复原始引擎，避免全局状态污染。

* 根据卫星/中继高度和最小仰角计算地面覆盖半径（米）。 * * 几何关系（球形地球）： * R_E — 地球半径 6371 km * h — 卫星高度（米） * ε — 最小仰角（度） * * 天底

* @deprecated 由 upsertLink 取代，保留仅供外部可能调用的场景兼容。 * 直接新建一个 polyline 实体（不索引，不复用）。

* @deprecated 由 updateRequestLinks 取代。

使用固定种子、不启动后台线程的引擎，适合纯功能单测。

与 engine_no_threads 相同，但以工厂默认参数创建，供需要两个独立实例的测试使用。

从请求字典中提取黄金快照所需的字段子集（排除时间戳等易变字段）。 Args: req_dict: TransmissionRequest.to_dict() 的返回值 Returns: 包含核心稳定字段的字典，用于黄金比对

从引擎统计中提取黄金快照所需的计数字段（排除浮点利用率等非确定字段）。 Args: stats: engine.stats 字典 Returns: 包含请求计数的稳定字典，用于黄金比对

返回空favicon避免404错误

注入干净引擎（seed=0, autostart=False）的 Flask test_client。 替换 api.simulation_engine 后在函数作用域内运行测试，测试结束后恢复原始引擎， 保证测试间无状态污染。适合 API 集成测试中只需 client、不需直接操

与 flask_client 相同，但同时暴露底层引擎，供需要断言引擎内部状态的测试使用。 Yields: (client, engine): Flask test_client 与对应的 SimulationEngine 实例。

从 JSON 字符串反序列化场景字典。

由 TLE 两行根数创建传播器；若 sgp4 不可用则需提供 orbital_elements 回退。

* 将仿真时刻转换为时间轴上的百分比位置。

获取所有请求（包括背景任务）- 用于资源时间线可视化

获取所有用户传输请求（不包括背景任务）