# 2026-05-24 Agent 升级依赖检测 + 自动安装 + 回滚 + 版本锁定

**日期**: 2026-05-24
**动机**: upgrade-agent 只下载 agent.py 不检查/更新依赖，新版引入新 pip 包会导致服务启动失败；install.sh 依赖不锁版本，子机可能装到与中心不一致的版本
**变更摘要**:
- upgrade-agent 增加 Python 版本预检：SSH 检测 venv Python >= 3.10，不满足返回 424 + 提示手动修复
- Python 版本 OK 后自动 `pip install` 更新依赖（锁版本，与中心 requirements.txt 对齐）
- 升级前备份旧 agent.py.bak，失败自动回滚
- install.sh 依赖版本锁定：fastapi==0.115.6 uvicorn==0.34.0 httpx==0.28.1 python-multipart==0.0.19
- 升级 SSH 超时从 60s 调至 120s（pip install 首次可能较慢）

**涉及文件**: `server/api/servers.py`, `web/agent/install.sh`

**是否需迁移**: 否

**验证方式**:
- Python < 3.10 时返回 424 + 提示手动修复
- Python OK + 依赖完整时 pip install 跳过已装包，升级正常
- Python OK + 依赖缺失时 pip install 自动补装
- 升级失败时旧 agent.py 自动恢复
