健康数据字段参考
机台管理页面的健康检查是一个时间点快照。字段可能为空、延迟或因账号权限而隐藏。本文只解释网页可见的安全字段，不记录敏感凭据、内部地址或未公开通信细节。
快照外层
| 页面字段 | 类型 | 含义 |
|---|---|---|
online | boolean | 最近一次状态是否在线 |
message | string | 面向管理员的状态说明 |
reported_at | string | 最近一次上报时间 |
data | object | 详细健康数据，可能为空 |
刷新按钮只会请求新的快照，不会修复机台。看到旧时间时，先区分“没有新上报”和“请求失败”。
时间与版本
详细数据可能包含：
timestamp：健康数据生成时间；sideload.branch：当前侧载分支；- 订单中当前版本和项目状态。
不同字段的时间来源可能不同，客户端应显示字段名称和时间，不要强行合并为一个时间。
HTTP 检查项
每个 HTTP 检查项包含：
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 检查名称 |
success | boolean | 是否成功 |
ping_ms | number | 往返耗时，单位毫秒 |
error_msg | string? | 失败原因 |
网页对成功项显示绿色状态和延迟；失败项可以点击展开错误消息。延迟高不一定代表失败，失败也不一定是永久故障。
TCP 检查项
TCP 检查项字段与 HTTP 检查相同，但只说明端口层面的连通性：
- TCP 成功不代表应用层登录成功；
- TCP 失败时先检查路由、端口和上游网络；
- 多项同时失败更像网络路径问题；
- 只有单项失败时，记录检查名称后联系管理员。
机器资源
CPU、内存和运行时间
页面可能显示 CPU 使用率、内存使用、RAM 使用和系统运行时间。建议查看趋势：
- 刷新一次记录基线；
- 在下载、安装和空闲状态分别记录；
- 区分短暂峰值和持续高占用；
- 不要只凭一次快照决定重启。
网络信息
页面可能显示：
- 本地 IP；
- 网关 IP；
- 公网 IP；
- 网络状态。
这些值属于环境信息。公开反馈只需说明“本地/网关/公网检查是否成功”，不要直接粘贴完整地址。
磁盘信息
每个磁盘项目可能包含：
| 字段 | 类型 | 含义 |
|---|---|---|
drive_letter | string | 盘符 |
total_gb | number | 总容量 |
free_gb | number | 剩余容量 |
read_speed | number | 读取速度 |
write_speed | number | 写入速度 |
空间不足时，优先清理管理员确认的旧订单或缓存；不要直接删除未知目录。读写速度低时避免同时截图、下载和安装。
网络速度
| 字段 | 类型 | 含义 |
|---|---|---|
download_speed | number | 下载速度 |
upload_speed | number | 上传速度 |
速度是采样值，不是带宽承诺。大型订单等待时，要同时看磁盘写入和订单进度。
订单健康
总体字段
| 字段 | 类型 | 含义 |
|---|---|---|
total_orders | number | 订单总数 |
completed_orders | number | 已完成订单数 |
pending_orders | number | 待处理订单数 |
current_order | string | 当前订单名称 |
current_item | string | 当前安装项 |
current_status | string | 当前处理状态 |
download_progress | number | 当前下载进度 |
order_details | array | 项目级进度列表 |
项目级字段
| 字段 | 类型 | 含义 |
|---|---|---|
name | string | 安装项名称 |
status | string | 当前状态 |
progress | number | 项目进度 |
rf_state | number | 服务返回的状态编号 |
rf_state_desc | string | 状态编号的可读说明 |
客户端应优先显示 rf_state_desc；未知状态编号不能直接当作成功或失败，应显示“未知状态”并保留原编号给管理员。
安装路径统计
如果页面显示安装路径统计，每项包含 path 和 count：
path是统计目标路径；count是文件/目录数量或服务返回的统计文本；- 它不是目录内容列表；
- 路径包含机台信息，截图前应遮挡。
状态组合判断
在线但 HTTP 失败
说明机台可能仍然可达，但应用服务检查失败。先看失败项详情，再验证登录和订单页面。
离线但最近时间很新
可能是当前请求拿到的状态与页面缓存不同。刷新一次，确认浏览器没有显示旧页面。
下载进度为 100% 但状态仍等待
检查发布时间、其它分包和安装项状态。100% 可能只代表当前项目下载完成，不代表整个订单已经发布。
磁盘空间足够但安装失败
检查路径权限、Hash、文件名、镜像密码和映射配置，不要只看剩余空间。
反馈时的安全格式
可以提供：机台本地别名、时间、在线状态、失败项名称、延迟、进度和错误摘要。不要提供：完整 IP、密码、访问码、Token、镜像密码、原始网络文本或完整截图。