# SystemTest-Agent

P0-02 被控端最小可用实现，首次启动向主控注册并保存 token，后续启动使用本地 token 发送 Bearer 心跳并轮询任务。

## 一键启动

PowerShell:

```powershell
.\start_agent.ps1
```

CMD:

```bat
start_agent.bat
```

默认会在局域网内自动发现 `8001/8000` 端口上的主控。也可以手工指定主控地址：

```powershell
.\start_agent.ps1 -ControllerUrl http://<controller-lan-ip>:8001
```

```bat
start_agent.bat http://<controller-lan-ip>:8001
```

如果在另一台局域网设备上双击后窗口闪退，常见原因是：

- 该设备访问不到主控机的 `8001` 端口，需放行主控机防火墙或手工传入 `http://<主控机局域网IP>:8001`
- 该设备没有安装 Python 3，或 `python/py` 不在 PATH
- 被控本地服务端口 `18081` 已被占用

新版 `start_agent.bat` 遇到这些错误会暂停并显示原因。

默认被控本地服务端口与 `Agent-S-main/bridge_config.yaml` 的 `log_web_port` 保持一致：

- Local health: `http://127.0.0.1:18081/health`
- 环境变量：`AGENT_LOCAL_SERVICE_PORT=18081`

## 状态持久化

首次注册成功后写入 `data/agent_state.json`：

- `agent_id`
- `public_id`
- `token`
- `registered_at`
- `controller_url`

重启时如果该文件存在且机器标识一致，被控端不会重复注册，会直接用 Bearer token 发送心跳和领任务请求。

## 部署形态

`AGENT_DEPLOYMENT_TYPE=auto` 时自动判断物理机/虚拟机；也可显式设置：

- `physical_machine`
- `virtual_machine`
- `box_physical`
- `box_virtual`

## 已完成的 P0-02 验收点

- 首次启动自动注册
- token 保存到本地状态文件
- 后续启动不重复注册
- 心跳和领任务请求使用 `Authorization: Bearer <token>`
- 注册与心跳上报物理机/虚拟机部署形态