读取磁盘信息（server data disk）#

验证状态：存在关键缺口，不可作为完整契约发布。Web 发送与应答消费已源码核验；采集服务器侧 data/v1 服务源码不在本工作区，字段全集与服务端校验缺证。 适用基线：源码归纳 @ 2026-09-14

用途与场景#

读取采集服务器的物理磁盘列表（分区状态、系统/数据盘、容量、启停与排序），用于磁盘信息展示页与磁盘设置页的初始回显。本页是 server/{deviceNo}/data/v1/disk 读取命令的唯一操作正本；写操作见启用/禁用磁盘分区与触发磁盘服务刷新。

使用位置#

页面/功能	说明
磁盘设置页回显	订阅应答式请求（replyMethod get）；首读失败 3 秒重试；刷新服务后倒计时结束再读
磁盘信息展示页	直接发布；同一命令、reply 命名空间为 .../information/disk

对应 inventory operationId：mqtt-get-server-var-data-v1-disk-58acedb6、mqtt-module-server-var-data-v1-disk-6b64bf06（同一命令的两个调用点）。

端点#

MQTT 请求 server/{deviceNo}/data/v1/disk（Web → Broker → 采集服务器直连，应答按 reply topic 回流；中心网关不消费）— 读取采集服务器物理磁盘列表（分区状态、容量、启停与排序）。

通道口径：该 topic 不在中心消费/发布点清单内（网关默认订阅清单无 server/+/data/#，见MQTT 主题清单 · 服务端订阅面）；应答回流、凭据与 QoS 等 wire 约定见MQTT 连接与消息边界。

请求形态 JSON 对象 {id, reply, params:{}}（无 sub 成员），Web 固定发送空 params。

动线与完成判据#

层级	判据
发布完成	publishAsync Promise 成功
请求关联	应答到达专用 reply topic 即消费；不校验 id 回显；无超时
业务完成	data 非空即视为读取成功并停止 3 秒重试；重启服务倒计时期间暂停读取

错误与边界#

• Web 消费代码无失败分支；服务器错误应答形态缺证。首读失败以 3 秒间隔无限重试。
• MQTT 族公共边界见MQTT 连接与消息边界。

调用关系与资源清理#

• 写链路：启用/禁用磁盘分区修改 enabled/orderNum 后服务器会在读数中置 modified=true，页面据此提示触发磁盘服务刷新。
• 应答订阅依赖会话级通配订阅；页面卸载仅摘除处理器并清空发送队列。

已知缺口#

1. 采集服务器侧服务源码不在本工作区：字段全集（含未消费字段）、size/used 单位权威定义、错误应答形态缺证。
2. modified 的语义（Web UI 推断为"需重启生效"）无服务器侧依据。
3. Broker ACL、服务器订阅证据与部署环境一致性待部署核验。