GUI-Agent/SystemTest-Controller/README.md

SystemTest-Controller

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

一键启动

PowerShell:

.\start_controller.ps1

CMD:

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