对外接口与路由

本系统对外提供 REST API 与 WebSocket，用于脚本/界面控制与实时监控。

REST（最小集合）

GET /health
GET /scenarios
POST /runs（scenario_id、strategy_id、seed、K、ΔT）
POST /runs/{run_id}/start
POST /runs/{run_id}/stop
GET /runs
GET /runs/{run_id}
GET /runs/{run_id}/metrics
GET /runs/{run_id}/traces（可分页）

WebSocket（实时）

WS /ws/runs/{run_id}：推送 step 更新、调度决策、窗口指标、节点状态

示例消息：

json

{
  "type": "metrics_update",
  "run_id": "2026-01-07_...",
  "step_id": 12,
  "t_ms": 123456,
  "metrics": {"throughput_bps": 1234, "loss_rate": 0.1, "delay_p95_ms": 900},
  "schedule": {"active_nodes": [1], "quota_frames": {"1": 2}},
  "sync": {"sync_error_ms": 15, "out_of_order": 0}
}