文档：修正 10.1 不显示排查（在线/离线模拟与真屏三处都不显示；A 地址通讯 / B 元件属性 两分支 + LB 替换判定法；补通讯中断提示待办）

设计文档/开发主文件.md

@@ -366,11 +366,27 @@ XD 画板：`A_start`、`B_PID`、`C_运行1~3`、`D_点动1/2`、`E_配方1~3`
 
 ## 10. 常见问题（FAQ）
 
-### 10.1 在线模拟时位按钮/指示灯全都不显示，离线模拟却正常
+### 10.1 位按钮/指示灯整片不显示（在线模拟 / 离线模拟 / 真屏 都可能）
 
-**现象**：同一画面（如 201），离线模拟元件齐全；在线模拟只剩文字与图片，`位状态设置`/`位状态切换开关`/指示灯成片消失，且不报错。
+**现象（10-27 现场实测）**：同一画面（如 201 上料-输送2），编辑区元件齐全；**在线模拟、离线模拟、现场真屏三处都只剩文字与图片**，`位状态设置`/`位状态切换开关`/指示灯成片消失，且不报错。同工程其它页（X1Y1 初始状态、X1Y2 风淋投料等）的开关却正常。
 
-**原因**：EB Pro 只绘制**通讯成功**的设备地址元件——设备没连上，绑 PLC 地址的元件**整片不画**（不是画成 0）。在线模拟是拿 PC 上的模拟器连**真实 PLC**；离线模拟用本地模拟数据，不依赖通讯，所以全显示。
+> 早期版本本节写成「离线模拟正常、只有在线模拟缺」，**已被实测推翻**：三处表现一致，所以不能用「在线模拟要连真 PLC」单独解释。
+
+**为什么"编辑区有、运行时不画"**：EB Pro 对**地址取不到数据**的元件，运行时是**整片不绘制**（不是画成 0、也不是灰显）。因此"编辑区有、模拟和真屏都没有"= 这批元件的**地址链路没通**，或者**元件属性被设成了不显示**。
+
+**两类原因（先分叉，禁止直接改画面）**
+
+| 类别 | 具体原因 | 主要特征 |
+| --- | --- | --- |
+| **A 地址/通讯** | 设备没配/没通讯；元件绑的设备不是实际在跑的那台；块名或变量名对不上 | 同一页面里绑**本机地址（LB/LW）的元件正常**，绑 PLC 符号地址的元件整片消失 |
+| **B 元件属性** | 「安全」勾了启用 + 无权限时隐藏；可见度/显示控制绑了位；透明度/图层；元件类型当前韧体不支持 | 地址换成本机 `LB` 后**仍然不显示** |
+
+**一步判定（关键，先做这个）**
+
+把出问题页面里**任意一个**开关的地址临时改成本机地址（如 `LB-400`）→ 保存 → 编译 → 在线/离线模拟：
+
+- **能显示** → 走 A，查设备与通讯；
+- **还不显示** → 走 B，逐个对比该元件与正常页面同款元件的「安全 / 可见度 / 透明度 / 图层」属性。
 
 **本项目的高危叠加因素**
 
@@ -379,12 +395,12 @@ XD 画板：`A_start`、`B_PID`、`C_运行1~3`、`D_点动1/2`、`E_配方1~3`
 
 **已修订（10-27）**：`net-apply` 对设备 4/5 的 PLC IP 加首段判断，`v[0]==0` 时跳过写入与重连（见 `宏指令.md`）。
 
-**排查顺序**
+**A 分支排查顺序**
 
 | # | 动作 | 判据 |
 | --- | --- | --- |
 | 1 | 显示 `LW-9403`/`LW-9404`（错误码）、`LB-10100`/`LB-10400`（通讯位） | 有错误码或通讯位=0 → 没通 |
-| 2 | 把任一按钮临时改成本机地址 `LB`，再在线模拟 | 能显示 → 确认是通讯问题，不是元件属性 |
+| 2 | 设备列表核对：出问题的元件绑的是**哪台设备**，这台设备是否存在、协议/IP 是否正确 | 绑到不存在/未配置的设备 → 改绑或补配置 |
 | 3 | 13 号窗看 `RW-40~51`，填对 IP 后点「应用」 | 空值/错值即根因 |
 | 4 | PC `ping` 三台 PLC | 不通 → 网络/配置问题 |
 
@@ -394,7 +410,13 @@ XD 画板：`A_start`、`B_PID`、`C_运行1~3`、`D_点动1/2`、`E_配方1~3`
 2. 用到的 DB 取消 **「优化的块访问」**；
 3. PC 与 PLC 同网段，Windows 防火墙放行 EasyBuilder。
 
-> 现场真屏断通讯时这些元件同样不显示，属正常行为——先查通讯，不要改画面。
+> **红色地址注释不是"地址写错"的证据**：编辑区里元件上压着的那行红色小字（物件名 + 完整地址 + 删除线）是 EB Pro 的地址注释。本次 201 这批元件的地址能正常编译、下载（校验和正常），所以不要只凭红字判断地址无效——按上面的 LB 替换法分叉判断。
+>
+> 现场真屏断通讯时这些元件同样不显示，属正常行为——先查通讯，不要改画面。但**必须补一条显式提示**（见下），否则操作员看到整片空白会误以为程序坏了或按钮丢了。
+
+**通讯中断时的界面提示（待做）**
+
+当前 `LB-11963`/`LB-11964` 把系统 "Device No Response" 弹窗关掉了，通讯一断就是"静默空白"。建议在 100 号公共窗加常驻状态：读 `LB-10100`/`LB-10400`（或 `LW-9403`/`LW-9404`），断线时在页面顶部显示红条「PLC 通讯中断，按钮不可用」，或把右上角网络图标改为红/灰。
 
 ## 11. 变更记录（里程碑）
 
@@ -445,4 +467,5 @@ XD 画板：`A_start`、`B_PID`、`C_运行1~3`、`D_点动1/2`、`E_配方1~3`
 | 10-27 | 新增 7.9 阀门按钮（双电控二位五通）：独立文档 `双电控电磁阀按钮设计.md`；按钮定复归型、脉宽/互锁/超时归 PLC、状态灯读阀位记忆位 |
 | 10-27 | 新增 5.10 阀门地址段（每阀 8 位，`LB-400` 起） |
 | 10-27 | 新增 10.1 在线模拟不显示排查（设备未通讯→绑 PLC 地址的元件整片不画）；`net-apply` 加 IP 首段为 0 不覆盖、不重连的保护 |
+| 10-27 | **10.1 修正**：现场实测在线模拟、离线模拟、真屏**三处都不显示**，原「离线模拟正常」不成立；改为「A 地址/通讯 vs B 元件属性」两分支 + LB 替换一步判定法；明确红色地址注释不能当作地址错误的判据；新增「通讯中断界面提示」待办 |
 | 10-27 | `.gitignore` 改为通配：`unitouch*.cxob` / `unitouch*.debug` / `unitouch*.cmtp.bak*` |