Nexus/docs/changelog/2026-06-07-server-status-field-fix.md

2026-06-07 — 服务器列表状态显示「未知」修复

摘要

API 返回 is_online 但未填充前端所需的 status 字段，导致已在线 Agent 在服务器页/仪表盘仍显示「未知」。

动机

用户升级「机器人」Agent 后生产 Redis/MySQL 均显示在线，UI 仍为未知。

变更

文件	说明
server/api/servers.py	_derive_server_status、_apply_heartbeat_overlay；列表/详情 API 返回 status: online|offline|unknown

迁移 / 重启

仅需重启 API。

验证

pytest tests/test_server_status_field.py -q
# 登录后 GET /api/servers/ → items[].status 为 online/offline/unknown