Skip to content

机器人管理

概述

机器人管理模块负责管理平台中的所有QQ机器人,支持机器人的增删改查、状态监控和启停控制。

功能特性

1. 机器人列表

  • 展示所有机器人的基本信息
  • 显示机器人当前状态(在线/离线/待启动)
  • 支持按条件筛选(框架类型、状态)

2. 添加机器人

  • 支持多种框架类型(NapCat、SnowLuma)
  • 配置机器人基本信息
  • 设置启用状态

3. 状态管理

  • 实时监控机器人心跳
  • 自动检测离线状态
  • 记录上线/下线时间

4. 启停控制

  • 支持动态启动机器人
  • 支持优雅停止机器人
  • 项目启动时自动加载启用的机器人

使用示例

添加机器人

json
POST /api/bot
{
  "botId": "123456789",
  "frameType": "NAPCAT",
  "nickname": "我的机器人",
  "enabled": true
}

查询机器人列表

json
GET /api/bot?pageNum=1&pageSize=10
{
  "code": 200,
  "data": {
    "records": [...],
    "total": 10,
    "size": 10,
    "current": 1
  }
}

启动机器人

json
PUT /api/bot/{botId}/start
{
  "code": 200,
  "message": "启动成功"
}