团队协作统一数据接口规范

def predict_power(yaw_angle: float, wind_speed: float) -> tuple[float, float]:
    """
    前向代理模型功率预测接口
    输入:
      yaw_angle: 上游偏航角 (deg, [-30, 30])
      wind_speed: 来流风速 (m/s, [6, 12])
    输出:
      (P1, P2): 上下游风机功率 (kW)
    """
    return p1_kw, p2_kw

def find_yaw_for_target(target_power: float, wind_speed: float) -> dict:
    """
    目标功率逆向跟踪求解接口
    输入:
      target_power: 调度下达期望总功率 (kW)
      wind_speed: 当前环境风速 (m/s)
    输出:
      {'best_yaw': float, 'actual_power': float, 'error_pct': float}
    """
    return result_dict

// 1. 前向功率预测
const { p1, p2, ptot, outOfRange } = window.SURROGATE.predict_power(yaw, u);
if (outOfRange) {
  console.warn('输入参数超出有效标定区间');
}

// 2. 目标功率闭环逆向跟踪
const { yaw, ptot, error, reachable } = window.SURROGATE.find_yaw_for_target(target, u);
if (!reachable) {
  // 触发前端越界保护与警告横幅
  showWarningNotification('请求功率超出物理极值');
}