# 2026-06-08 — 安装 Agent 时自动生成 API Key

## 摘要

批量/单台安装 Agent 时，若服务器尚未设置 `agent_api_key`（常见于 Excel 导入），自动按 `nxs-*` 格式生成并写入数据库，不再要求先去详情页手动生成。

## 动机

用户批量安装「机器人」等 Excel 导入服务器时报错：`未设置 Agent API Key，请先在服务器详情生成`。新建/CSV 导入会自动生成密钥，Excel 导入路径遗漏，安装流程不应阻断。

## 涉及文件

- `server/application/server_batch_common.py` — `ensure_agent_api_key()`
- `server/application/services/server_batch_service.py` — 批量安装调用
- `server/api/servers.py` — 单台 `POST /{id}/install-agent` 对齐
- `tests/test_ensure_agent_api_key.py`

## 迁移 / 重启

- 无 DB 迁移
- 需重启 API

## 验证

```bash
pytest tests/test_ensure_agent_api_key.py -q
bash scripts/local_verify.sh
# 对无 agent_api_key 的服务器批量安装 → 应直接 SSH 安装，不再报 Key 未设置
```
