开关配置

概述

开关配置模块采用三层数据隔离设计，支持全局、机器人、群聊三个级别的功能开关控制。

三层开关架构

1. 全局开关

• 对所有机器人生效
• 作为默认配置
• 优先级最低

2. 机器人开关

• 对特定机器人生效
• 可覆盖全局配置
• 优先级中等

3. 群聊开关

• 对特定群聊生效
• 可覆盖机器人和全局配置
• 优先级最高

功能开关

功能	说明	默认值
mainSwitch	总开关	true
autoReply	自动回复	true
keywordMonitor	关键词监控	true
screenMonitor	刷屏监控	true

验证逻辑

系统采用逐级验证机制：

1. 检查全局开关 → 关闭则直接拒绝
2. 检查机器人开关 → 关闭则直接拒绝
3. 检查群聊开关 → 关闭则直接拒绝
4. 所有通过 → 允许执行

使用示例

获取开关配置

GET /api/switch/validate?qq=123456789&groupNum=1234567890&function=AUTO_REPLY
{
  "code": 200,
  "data": {
    "enabled": true,
    "effectiveLevel": "GROUP",
    "inherited": false
  }
}

更新群聊开关

PUT /api/switch/group
{
  "qq": "123456789",
  "groupNum": "1234567890",
  "mainSwitch": true,
  "funcAutoReply": true,
  "funcKeywordMonitor": false
}