# SystemTest-Controller

P0-01 主控端最小可用实现，使用 Python 标准库提供 HTTP API、SQLite 状态库和静态面板。

## 一键启动

PowerShell:

```powershell
.\start_controller.ps1
```

CMD:

```bat
start_controller.bat
```

默认地址与 `Agent-S-Controller/start_agent_controller.bat` 保持一致：

- Health: `http://127.0.0.1:8001/health`
- Panel: `http://127.0.0.1:8001/`

启动成功后会自动打开 Web 面板；如需关闭自动弹出，设置 `CONTROLLER_NO_BROWSER=1`。

## 配置

复制 `.env.example` 为 `.env` 后可调整：

- `CONTROLLER_HOST`: 默认 `0.0.0.0`
- `CONTROLLER_PORT`: 默认 `8001`
- `CONTROLLER_PUBLIC_BASE_URL`: 被控端访问主控的 URL
- `CONTROLLER_DEPLOYMENT_MODE`: 主控部署形态标识，默认 `script`
- `CONTROLLER_DATABASE`: SQLite 数据库路径
- `AGENT_STALE_AFTER_SECONDS`: 被控端超过该秒数无心跳后显示为 `offline`，默认 `5`
- `CONTROLLER_NO_BROWSER`: 设为 `1` 时不自动打开浏览器

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

- 启动时读取 `.env`
- 启动前检查数据库、端口、静态面板文件
- `/health` 返回健康状态和部署形态
- `/` 可访问静态面板
- 提供被控端注册、心跳、领任务 API