# 2026-06-09 — 子机 Agent 批量诊断脚本

## 摘要

新增 `scripts/agent_remote_diagnose.py`：从中心侧按服务器 ID/名称/离线筛选，SSH 拉取子机 `systemctl`、脱敏 `config.json`、401/心跳错误日志、主站 `/health` 探测；并对照 Redis/MySQL 心跳。

## 动机

排查「显示离线但 SSH 可连」类问题时，需登录每台子机看 `nexus-agent` 日志；武汉颜又文案需可重复工具。

## 涉及文件

- `scripts/agent_remote_diagnose.py`
- `scripts/agent_remote_diagnose.sh`
- `tests/test_agent_remote_diagnose.py`

## 用法

```bash
bash scripts/agent_remote_diagnose.sh --id 95
bash scripts/agent_remote_diagnose.sh --name 颜又文
bash scripts/agent_remote_diagnose.sh --offline-only --limit 20 -o docs/reports/agent-offline-snapshot.md
```

需在含 `.env` 的目录执行（本地或生产 `/opt/nexus`）。

## 验证

```bash
pytest tests/test_agent_remote_diagnose.py -q
```
