34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
|
# 2026-06-12 新服务器 Agent 安装/升级提示
|
||
|
|
|
||
|
|
## 摘要
|
||
|
|
|
||
|
|
新添加的服务器不再因预生成 `agent_api_key` 误显示「离线」；列表与展开详情明确提示需安装或升级 Agent，并提供一键操作。
|
||
|
|
|
||
|
|
## 动机
|
||
|
|
|
||
|
|
用户添加服务器后 CPU/内存/心跳为空，界面无指引。根因：仅有 DB 中的 API Key 被当作「已装 Agent」，实际从未安装。
|
||
|
|
|
||
|
|
## 涉及文件
|
||
|
|
|
||
|
|
- `server/utils/agent_version.py` — `agent_is_installed`、`compute_agent_guidance`
|
||
|
|
- `server/api/servers.py` — 列表/详情返回 `agent_action*`；状态判定修正
|
||
|
|
- `frontend/src/components/servers/ServerAgentHint.vue` — 提示条（新增）
|
||
|
|
- `frontend/src/components/servers/ServerInlineDetail.vue` — 展开详情提示
|
||
|
|
- `frontend/src/pages/ServersPage.vue` — 列表「需安装/需升级」芯片、单台安装/升级
|
||
|
|
- `frontend/src/composables/servers/useServerFormDialog.ts` — 创建后 toast
|
||
|
|
- `frontend/src/types/api.ts` — 类型
|
||
|
|
- `tests/test_agent_version.py` — 单测
|
||
|
|
|
||
|
|
## 迁移 / 重启
|
||
|
|
|
||
|
|
需重启 API；前端构建部署。
|
||
|
|
|
||
|
|
## 验证
|
||
|
|
|
||
|
|
```bash
|
||
|
|
.venv/bin/pytest tests/test_agent_version.py -q
|
||
|
|
cd frontend && npm run type-check
|
||
|
|
```
|
||
|
|
|
||
|
|
添加服务器 → 状态应为「未知」→ 展开行见「尚未安装 Agent」→ 点「安装 Agent」。
|