Files
GUI-Agent/SystemTest-Controller/README.md
T

45 lines
1.2 KiB
Markdown

# 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