> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ridergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 优先级模型

> 限制配置文件、优先级和有效限制的工作原理

位置和充电桩的限制通过**优先级时间窗配置文件**进行控制,这些配置文件在位置、充电桩和集群端点之间共享。

## 优先级级别

* 优先级范围为 **0(最低)到 10(最高)**,与 OCPP 充电配置文件堆栈级别采用相同的约定。
* 每个目标(一个位置,或一个充电桩连接器)最多可拥有 **11 个配置文件** —— 每个优先级级别一个 —— 每个配置文件都有自己的 `[startTime, endTime)` 时间窗。
* 为某个目标提交一个已存在优先级的新配置文件将**替换**现有的配置文件。

## 有效限制

在任意时刻,**有效限制**是当前**窗口处于活动状态的最高优先级配置文件**(`startTime <= now < endTime`)的 `limitKw`。

如果当前没有处于活动状态的配置文件:

* **位置**将回退到 `permanentLimitKw`(通过 `PUT /locations/{locationId}/limit` 设置)。
* **充电桩**没有回退机制 —— 在活动窗口之外,该连接器不会被优先级锁定,而是由常规的负载管理进行管理。

## 自动应用/还原

配置文件会在其 `startTime`/`endTime` 自动应用或还原 —— 一旦创建了配置文件,**无需进一步调用 API**。

配置文件记录在过期后**不会被删除**,因此可以通过 `GET /locations/{locationId}/limits` 和 `GET /organizations/limits` 查询完整的配置文件历史记录。

## 状态值

每个配置文件都会报告一个计算得出的 `status`:

| Status      | 含义                           |
| ----------- | ---------------------------- |
| `SCHEDULED` | `now < startTime` —— 尚未激活    |
| `ACTIVE`    | `startTime <= now < endTime` |
| `EXPIRED`   | `now >= endTime`             |

## 充电桩级锁定

`POST /chargers/{controllerUuid}/connectors/{connectorId}/schedules` 为单个连接器创建一个配置文件。在 **ACTIVE** 状态下,该连接器被视为优先级锁定:它将被排除在常规负载管理之外,并以不受限的方式运行,最高可达 `limitKw` —— 仅当整个位置超出其电网限制时,才会作为最后手段对其进行限流(但永远不会低于其 6A 下限)。

## 集群

[集群](/zh/api-reference/energy-management/apply-cluster-schedule)将多个位置归并到一个可选的总 kW 上限之下。当集群的总用电量将超过 `limitKw` 时,每个成员位置的有效限制将按比例缩减:

```
scale = min(1, clusterLimitKw / sum(memberLocationLimits))
locationEffectiveLimit = locationSetLimitKw * scale
```

`POST /clusters/{clusterId}/schedules` 会一次性将一个 `LimitProfileRequest` 应用到集群中的所有位置。