From 761d991327beef70d3fe85c2a30ec9df86b1aa8d Mon Sep 17 00:00:00 2001
From: wangqiyang <wqy00163@163.com>
Date: Thu, 23 Jul 2026 13:53:18 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E6=95=85=E9=9A=9C?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E6=89=AB=E6=8F=8F=E6=95=B0=E9=87=8F=E8=BF=94?=
 =?UTF-8?q?=E5=9B=9E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/requirements/realtime_fault_display.md | 58 +++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/docs/requirements/realtime_fault_display.md b/docs/requirements/realtime_fault_display.md
index fac4521..7019ea5 100644
--- a/docs/requirements/realtime_fault_display.md
+++ b/docs/requirements/realtime_fault_display.md
@@ -191,6 +191,31 @@ for i := 0; i < 10; i++ {
 
 没有配置时默认 `10`，但现场可以按实际回路数量调整。
 
+后端实时接口需要返回当前实际参与扫描的设备数，便于前端展示和现场核对当前扫描范围。
+
+建议字段：
+
+```json
+{
+  "scan_device_count": 4
+}
+```
+
+字段含义：
+
+| 字段 | 说明 |
+| --- | --- |
+| `scan_device_count` | 本次按配置实际参与 0x17 轮询的设备/回路数量 |
+
+如果后续需要区分“参与扫描数量”和“成功读取数量”，可以再增加：
+
+```json
+{
+  "scan_device_count": 4,
+  "scan_success_count": 3
+}
+```
+
 ## 后端改动点
 
 ### 1. 调整 0x17 数据解析
@@ -251,6 +276,22 @@ internal/module/m9zTtyApi/read.go
 
 每个回路建议增加字段：
 
+```json
+{
+  "scan_device_count": 4,
+  "Loops": [
+    {
+      "has_fault": true,
+      "fault_msg": "回路1短路故障",
+      "fault_code": "01",
+      "faults": []
+    }
+  ]
+}
+```
+
+其中每个回路对象包含：
+
 ```json
 {
   "has_fault": true,
@@ -260,6 +301,8 @@ internal/module/m9zTtyApi/read.go
 }
 ```
 
+顶层 `scan_device_count` 表示当前后端实际参与扫描的设备/回路数量。
+
 同时把实时监控中的回路电流改为直接使用 0x17 的回路总电流字段，不再累加子模块电流。
 
 ### 4. 实时写入报警历史
@@ -302,6 +345,14 @@ for i := 0; i < loopCount; i++ {
 
 `loopCount` 从配置读取，未配置默认 10。
 
+实时接口返回值需要带上当前扫描数量：
+
+```json
+{
+  "scan_device_count": 10
+}
+```
+
 涉及位置：
 
 ```text
@@ -354,12 +405,19 @@ internal/module/m9zTtyApi/cron.go
 读取字段：
 
 ```text
+scan_device_count
 Loops[].has_fault
 Loops[].fault_msg
 Loops[].fault_code
 Loops[].faults
 ```
 
+前端可在当前故障区域或调试信息中展示当前扫描数量，例如：
+
+```text
+当前扫描设备数：4
+```
+
 ### 3. 报警预览保持历史列表
 
 页面：