读取采集服务器概要（serverinfo）
验证状态：存在关键缺口，不可作为完整契约发布。Web 发送与应答消费已源码核验；采集服务器侧
data/v1服务源码不在本工作区，字段全集与服务端校验缺证。 适用基线：源码归纳 @ 2026-09-14
用途与场景
读取采集服务器的运行概要：服务健康状态、版本、磁盘总量/可用与最近升级结果，用于远控首页"服务器信息"与采集服务器"通用信息"页。本页是 server/{deviceNo}/data/v1/serverinfo 读取命令的唯一操作正本；写操作与磁盘/服务/系统配置读数见本目录其余页面。
使用位置
| 页面/功能 | 角色或空间分支 |
|---|---|
| 远控首页·服务器信息（构造）、（reply 订阅） | 当前 $spaceId；$deviceNo 来自路由 |
| 采集服务器信息·通用 | 当前 $spaceId；$deviceNo 来自路由 |
对应 inventory operationId：mqtt-module-server-var-data-v1-serverinfo-7998f1d8。
端点
MQTT 请求 server/{deviceNo}/data/v1/serverinfo（Web → Broker → 采集服务器直连，应答按 reply topic 回流；中心网关不消费）— 读取采集服务器运行概要（服务健康、版本、磁盘与最近升级结果）。
通道口径：该 topic 不在中心消费/发布点清单内（网关默认订阅清单无 server/+/data/#，见MQTT 主题清单 · 服务端订阅面）；应答回流、凭据与 QoS 等 wire 约定见MQTT 连接与消息边界。
请求形态 JSON 对象 {id, reply, params:{}}（无 sub 成员），Web 固定发送空 params。
动线与完成判据
| 层级 | 判据 |
|---|---|
| 发布完成 | publishAsync Promise 成功；仅代表 Broker 发布调用完成 |
| 请求关联 | 应答到达专用 reply topic 即消费；不校验 id 回显；无超时 |
| 业务完成 | data 非空即视为读取成功并停止 3 秒重试 |
| 服务器执行 | 读取型命令无执行副作用；数据的实时性由服务器侧决定，缺证 |
错误与边界
- Web 消费代码无失败分支；服务器错误应答形态缺证。首读失败时以 3 秒间隔无限重试。
- HTTP 错误差异不适用；MQTT 族公共边界见MQTT 连接与消息边界。
调用关系与资源清理
已知缺口
- 采集服务器侧
data/v1/serverinfo服务源码不在本工作区：字段全集（Web 只消费上列 7 个）、单位权威定义、错误应答形态缺证。 - 读应答信封是否含
status（与写应答一致）缺证。 - Broker ACL、服务器订阅
server/{deviceNo}/data/#的证据与部署环境一致性待部署核验。
目录