From c04a601335cb7d08a652927cef5a91dc5d8b38cf Mon Sep 17 00:00:00 2001
From: wangqiyang <wqy00163@163.com>
Date: Thu, 23 Jul 2026 13:50:58 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E5=BD=93=E5=89=8D?=
 =?UTF-8?q?=E6=95=85=E9=9A=9C=E5=88=B7=E6=96=B0=E6=8C=89=E9=92=AE=E9=9C=80?=
 =?UTF-8?q?=E6=B1=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/docs/requirements/realtime_fault_display.md b/docs/requirements/realtime_fault_display.md
index 6b24ea8..fac4521 100644
--- a/docs/requirements/realtime_fault_display.md
+++ b/docs/requirements/realtime_fault_display.md
@@ -86,6 +86,25 @@ AddTaskByFunc("ScanM9z", "ScanM9z", "@every 10m", m9zTtyApi.ScanM9z)
 当前无故障
 ```
 
+建议在该区域增加一个手动刷新按钮：
+
+```text
+刷新当前故障
+```
+
+按钮用途：
+
+1. 现场人员可以立即重新读取当前故障，不必等待下一次自动刷新
+2. 调试和验收时可以快速确认故障是否已恢复
+3. 当通信短暂异常或页面刚恢复时，可以主动刷新当前状态
+
+交互建议：
+
+1. 点击后调用实时监控接口重新读取当前故障
+2. 按钮请求期间显示 loading 或禁用，避免连续点击造成串口请求堆积
+3. 刷新成功后更新当前故障区域
+4. 刷新失败时提示“当前故障刷新失败”或保留原状态并显示错误提示
+
 每条故障建议包含：
 
 | 字段 | 说明 |
@@ -314,6 +333,16 @@ internal/module/m9zTtyApi/cron.go
 当前无故障
 ```
 
+当前故障区域需要提供手动刷新按钮：
+
+```text
+刷新当前故障
+```
+
+点击后重新调用 `/m9z/getDeviceStatus2`，只刷新实时监控状态和当前故障显示，不需要弹确认框。
+
+按钮请求期间应显示 loading 或禁用，避免连续点击造成重复串口请求。
+
 ### 2. 适配实时接口字段
 
 调用接口：
@@ -359,7 +388,7 @@ Loops[].faults
 2. 后端改 `/m9z/getDeviceStatus2` 返回当前故障
 3. 后端增加实时写入历史和去重
 4. 后端增加 `loopCount` 配置
-5. 前端实时监控页增加当前故障区域
+5. 前端实时监控页增加当前故障区域和“刷新当前故障”按钮
 6. 前端适配接口字段
 7. 联调真实 0x17 报文：`01`、`02`、`04 01`、`04 02`、`04 03`