docs: 补充故障接口扫描数量返回

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. 报警预览保持历史列表
 
 页面：