对比两个命名场景的决策指标，返回差值分析报告。 查询参数： ``a=<场景名称A>``（必填） ``b=<场景名称B>``（必填） 响应示例:: {"code": 0, "data": { "scenario_

返回当前内存中保存的场景（若有）；否则返回空。

固定 seed=42 的场景引擎夹具（用于回归测试）。 - 使用与黄金快照生成时相同的参数（seed=42, gs=5, leo=4） - 不启动后台线程，可通过手动步进推进仿真时间 - 每次请求前重置 TransmissionRequest ID 计数器保证可复现性

导出最近一次保存的场景为 JSON 或 YAML 文件。 查询参数：``format=json``（默认）或 ``format=yaml``

从上传的 JSON 或 YAML 文本导入场景并立即还原到引擎。 Content-Type: application/json → JSON 解析 Content-Type: application/x-yaml 或其他 → YAML 解析 同时接受 multipart

将最近一次保存的内存场景恢复到仿真引擎。 引擎的地面站数量和 LEO 卫星数量将被调整为场景记录值。

将当前仿真资源配置保存为场景对象并驻留内存。 可选 JSON 体：``{"name": "我的场景"}``

将场景库中指定场景的资源配置应用到仿真引擎（切换场景）。

删除场景库中指定名称的场景。

列出场景库中全部命名场景的摘要（不含完整统计）。 响应示例:: {"code": 0, "data": [ {"id": 1, "name": "基准", "saved_at": "2024-...", "is_baseline": true,

将当前仿真资源配置与运行统计快照保存到场景库（按名称 upsert）。 请求体（JSON）:: {"name": "场景名称"} # name 必填，最长 128 字符 响应返回完整场景记录。

将指定场景设为基线（用于对比参考）。

提供固定种子、不启动后台线程的引擎夹具（供外部测试复用）���

返回 {method, ground_station, relay, relay2, rate} 或 None。

* Submit a new transmission request via the typed API client. * Returns the result object from the backend.

* Update the ground-station pool size.

* Update the LEO satellite constellation size.

Update the API base URL and immediately refresh all data.

* Show a toast-style notice message that auto-clears after 4.2 seconds. * Calling this again before the timer fires resets the timer.

Select a new playback speed multiplier.

Switch the active panel view.

将内存中的快照以 JSON 文件形式下载。

从上传的 JSON 文件导入快照并立即恢复仿真状态。 Content-Type: application/json → JSON 解析 同时接受 multipart/form-data 中的 ``file`` 字段（前端文件上传）。

将最���一次保存的快照恢复到仿真引擎，进入回放模式。 回放模式下主仿真循环暂停，/api/data 返回快照时刻的态势数据。 调用 /api/snapshot/resume 可退出回放模式，重启仿真。

退出回放模式，重启主仿真循环。

拍摄当前仿真状态快照并保存至内存。 可选 JSON 体：``{"label": "回放点A"}`` 返回快照摘要（不含完整请求列��以减小响应体积）。

返回当前快照与回放状态摘要。

SSE 实时推送端点（GET /api/v1/stream）。 以 ``text/event-stream`` 格式持续推送两类 SSE 事件： * ``snapshot`` – 每 2 秒推送一次完整态势快照（卫星位置、资源、请求列表） * ``event``

太阳同步轨道（高度 700 km，倾角 97.4°，圆轨道）。

* Start background polling. Safe to call multiple times — creates at most * one timer. Performs an immediate refresh before starting the interval.

返回当前波束状态摘要。

已推进 60 秒仿真时间的引擎实例（建立初始状态）。

Stop background polling and clear the timer.

每次测试使用独立的内存 SQLite 场景库。

高权重：提交固定类型（TASK_CMD/高优先级）的请求。

低权重：提交低优先级请求，压力测试下预期会被拒绝。

中权重：提交随机类型请求，覆盖多种数据类型。

提交传输请求

Swagger UI 文档站。

* Resolve a dot-separated key path against the active locale's messages. * Falls back to `zh` if the key is missing in the current locale. * Returns

每次提交 N 个合法请求，accepted + rejected 之和等于 total_requests 增量。 每个 hypothesis 样本使用新引擎，避免跨样本状态积累导致计数偏差。

accepted + rejected ≤ total（不含进行中的传输）。

所有数据类型各提交 20 次，无任何异常。

每次 submit_request 都应返回结果（不会静默丢失）。

所有线程均能在超时前完成（无死锁）。

在若干时间步长上，高度始终为正（卫星未进入大气层）。

圆轨道各时刻高度应在合理范围内（WGS-84 椭球导致极点高度略高于赤道，偏差 < 25000 m）。

check_geo_visibility 仅依赖地心角（纬经度），高度字段不影响结果。

赤道上地心角 = 79° < 80°，应可见。

赤道上地心角 = 81° > 80°，不应可见。

赤道上地心角 = 90° 远超 80°，不可见。

对跖点（赤道 0° 与 180°），地心角 = 180°。

对跖点（角度 = 180°），不可见。

临界倾角 63.4° ��近地点幅角进动速率应接近 0（2 - 5/2 sin²i = 0）。

t=creation_time 时，价值等于 base_value（dt=0，exp(0)=1）。

已有槽占用 base_used 带宽，再查询 extra 使总量超上限时，check 返回 False。 注意：ResourceManager 的带宽冲突检测仅在存在重叠槽时触发（循环遍历）， 因此本测试确保 pool 中至少有一个已预约槽（base_used >=

空池中查询带宽 < 上限时，check 返回可用。

ContentTask 的 base_value 应与 DATA_TYPES[data_type]['base_value'] 一致。

Ka 天线卫星在近距离应返回正速率。

标准配置下多跳中继应返回正速率。

基本中继链路应返回正速率。

X 天线卫星在近距离应返回正速率。

1000 次地心角计算的吞吐量。

对跖点（最大地心角 180°）边界情形。

同一点（地心角应为 0）边界情形。

ContentTask 的 beta 应与 DATA_TYPES[data_type]['beta'] 一致。

bool 是 int 的子类，但业务上应被拒绝。

中继速率受限于两段链路中较慢的一段（瓶颈逻辑）。

多跳速率不超过任何单段的速率（三段瓶颈约束）。