|
@@ -1,17 +1,12 @@
|
|
|
----
|
|
|
|
|
-name: tou-template-scheduling
|
|
|
|
|
-description: 编写、校验并保存 FranklinWH 的 TOU(分时电价)调度模板,用于 EMS 调度配置。当用户需要构建、编辑、理解或上传 TOU 电价模板时使用——包括时段策略、光伏/负载优先级、充放电功率限制、省/市选择等。涵盖 updateOrSaveIotTouTemplate 请求体以及 MCP 工具 service_tou_template_*。
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-# FranklinWH TOU 调度模板
|
|
|
|
|
|
|
+# TOU 电价模板:构建、字段与规则(`service_tou_template_*`)
|
|
|
|
|
|
|
|
-用于构建并保存 EMS 调度(TOU)模板。一个模板 = 基础信息 + 一个或多个「季节/日类型」策略;每个策略 = 覆盖一整天的时段列表。它对应云端 `updateOrSaveIotTouTemplate` 接口和设备侧 355/357 调度协议。
|
|
|
|
|
-
|
|
|
|
|
-参考资料(完整协议与字段语义):
|
|
|
|
|
-`__WIKI_DOCS__/Software/ScriptingForSchedulingConfiguration.md`
|
|
|
|
|
|
|
+用于构建并保存 EMS 调度(TOU)模板。一个模板 = 基础信息 + 一个或多个「季节/日类型」策略;每个策略 = 覆盖一整天的时段列表。对应云端 `updateOrSaveIotTouTemplate` 接口和设备侧 355/357 调度协议。
|
|
|
|
|
|
|
|
|
|
+协议原文(完整语义):`__WIKI_DOCS__/Software/ScriptingForSchedulingConfiguration.md`
|
|
|
字段权威定义(Go DTO):`service/dto/fwhTestTouTemplateDTO.go`
|
|
字段权威定义(Go DTO):`service/dto/fwhTestTouTemplateDTO.go`
|
|
|
|
|
|
|
|
|
|
+> 只读查询与基本流程见主 SKILL.md 第 8 节。本文件是**写入/构建**时的字段字典与规则。
|
|
|
|
|
+
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## MCP 工具
|
|
## MCP 工具
|
|
@@ -25,7 +20,7 @@ description: 编写、校验并保存 FranklinWH 的 TOU(分时电价)调度
|
|
|
| `service_tou_template_save` | 新增/更新模板,返回 templateId**【写操作】** | `test`(当前仅支持) |
|
|
| `service_tou_template_save` | 新增/更新模板,返回 templateId**【写操作】** | `test`(当前仅支持) |
|
|
|
| `service_tou_template_cites` | 查询某国家下的省/市列表 | `test`(当前仅支持) |
|
|
| `service_tou_template_cites` | 查询某国家下的省/市列表 | `test`(当前仅支持) |
|
|
|
|
|
|
|
|
-save 与 cites 目前仅支持 `test`。读操作默认走 `pro`,需要读测试环境时传 `env:"test"`。
|
|
|
|
|
|
|
+save 与 cites 目前仅支持 `test`。读操作默认走 `pro`,需要读测试环境时传 `env:"test"`。`cites` 查某国家省/市时需传 `country_id` 且 `type:1`;都不传则返回国家列表。
|
|
|
|
|
|
|
|
典型流程:`cites`(拿 countryId/provinceId)→ 构建 payload → `save` → `detail` 校验。
|
|
典型流程:`cites`(拿 countryId/provinceId)→ 构建 payload → `save` → `detail` 校验。
|
|
|
|
|
|
|
@@ -33,7 +28,7 @@ save 与 cites 目前仅支持 `test`。读操作默认走 `pro`,需要读测
|
|
|
|
|
|
|
|
## 请求体结构(`service_tou_template_save` 的 `payload`)
|
|
## 请求体结构(`service_tou_template_save` 的 `payload`)
|
|
|
|
|
|
|
|
-顶层结构(`FwhTestUpdateOrSaveTouTemplatePayload`):
|
|
|
|
|
|
|
+`payload` 是**字符串化的 JSON**。顶层结构(`FwhTestUpdateOrSaveTouTemplatePayload`):
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -233,13 +228,13 @@ save 与 cites 目前仅支持 `test`。读操作默认走 `pro`,需要读测
|
|
|
5. **新增 vs 更新**:`template.templateId` 留空为新增;填入 ID 为更新。
|
|
5. **新增 vs 更新**:`template.templateId` 留空为新增;填入 ID 为更新。
|
|
|
6. **写操作走 `test`**:`service_tou_template_save` 仅支持 `env:"test"`。保存前先与用户确认(会修改服务器数据)。保存后用 `service_tou_template_detail`(带 `env:"test"`)校验。
|
|
6. **写操作走 `test`**:`service_tou_template_save` 仅支持 `env:"test"`。保存前先与用户确认(会修改服务器数据)。保存后用 `service_tou_template_detail`(带 `env:"test"`)校验。
|
|
|
7. 执行写操作前,需要和用户确认最终写入或更新的信息,确认后才能调用 `service_tou_template_save` 创建或更新
|
|
7. 执行写操作前,需要和用户确认最终写入或更新的信息,确认后才能调用 `service_tou_template_save` 创建或更新
|
|
|
-8. 不确定某国家的 `provinceId` 时,先调用 `service_tou_template_cites` 传 `country_id`。
|
|
|
|
|
|
|
+8. 不确定某国家的 `provinceId` 时,先调用 `service_tou_template_cites` 传 `country_id`(且 `type:1`)。
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## 示例流程:构建一个标准自发自用模板
|
|
## 示例流程:构建一个标准自发自用模板
|
|
|
|
|
|
|
|
-1. `service_tou_template_cites { "country_id": 3 }` → 选出 `provinceId`。
|
|
|
|
|
|
|
+1. `service_tou_template_cites { "env":"test", "country_id": 3, "type": 1 }` → 选出 `provinceId`。
|
|
|
2. 构建一个策略(「每天」类型:`ccociateType:1`、`ccociateSn:""`、`dayType:3`、`dayName:"Every day"`),用策略 D(`solarPriority:"1,3,2"`,`loadPriority:"1,3,2"`)铺一整天单一时段,或拆成 off/mid/on-peak 多个时段。若需区分工作日与周末/节假日,则改用成对策略(见「日类型配套逻辑」)。
|
|
2. 构建一个策略(「每天」类型:`ccociateType:1`、`ccociateSn:""`、`dayType:3`、`dayName:"Every day"`),用策略 D(`solarPriority:"1,3,2"`,`loadPriority:"1,3,2"`)铺一整天单一时段,或拆成 off/mid/on-peak 多个时段。若需区分工作日与周末/节假日,则改用成对策略(见「日类型配套逻辑」)。
|
|
|
3. `service_tou_template_save { "env":"test", "payload": "<json>" }` → 记下返回的 `templateId`。
|
|
3. `service_tou_template_save { "env":"test", "payload": "<json>" }` → 记下返回的 `templateId`。
|
|
|
4. `service_tou_template_detail { "env":"test", "id": <templateId> }` 确认结果。
|
|
4. `service_tou_template_detail { "env":"test", "id": <templateId> }` 确认结果。
|