# QQBot群管插件

**Repository Path**: xiowo/QQBot-GroupAdmin-Plugin

## Basic Information

- **Project Name**: QQBot群管插件
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QQBot-GroupAdmin-Plugin

QQBot 专用群管插件，提供入群申请处理、禁言管理、消息撤回、成员进退群通知与转发、以及可视化的开关管理面板。依赖 QQBot 全量权限，仅作用于 `QQBot` 适配器下的群聊。

## 安装插件

- 在Yunzai根目录下执行以下指令并重启Yunzai即可:
```
git clone https://gitee.com/wind-trace-typ/QQBot-GroupAdmin-Plugin.git ./plugins/QQBot-GroupAdmin-Plugin
```
## 辅助插件

- [QQBot-Plugin](https://gitee.com/wind-trace-typ/Yunzai-QQBot-Plugin) 此插件必装，用于提供群管插件所需的核心接口功能

- [QQBot-WebAdapter](https://gitee.com/wind-trace-typ/QQBot-Web-Adapter) 此插件可选，用于提供群管插件的可视化开关管理面板


## 功能一览

### 入群申请
- `#入群申请列表`：查看当前群待审核的入群申请（含申请来源、验证消息、风险提示、一键同意/拒绝）。
- `#同意入群申请 <申请ID>` / `#拒绝入群申请 <申请ID>`：审批入群申请。
- 受「入群申请功能」开关控制，与「入群申请通知」开关相互独立。

### 禁言管理
- `#禁言 @用户 <时长>`：如 `#禁言 @用户 10分钟`，支持中文数字（十/二十/半等）。最多禁言 30 天。
- `#解除禁言 @用户` 或 `#解禁 <openid>`：解除指定成员禁言。
- `#群禁言列表`：查看本群被禁言成员及剩余时长，可单点解禁。
- `#一键解禁`：解除本群全体禁言。

### 消息撤回 （当前使用体验很差所以未将msgid映射存储功能同步到仓库，即使开启撤回功能，也无法撤回）
- `#撤回` + 引用消息：撤回被引用的消息（需开启撤回功能且具相应权限，若无管理则只能撤回自己的消息）。

### 自动通知（群内）
- 入群申请提醒
- 机器人进退群提醒
- 新成员入群提醒
- 成员退群提醒

### 转发通知（主人私聊）
- 入群申请转发主人
- 退群转发主人

### 开关管理
- `#群管开关列表`：按权限展示当前开关状态，附 inlinecmd 一键开关按钮。
  - 主人：查看/切换全部开关。
  - 群主/管理员：仅查看/切换本群通知类开关。
- `#QQBot群管帮助`：按权限展示操作菜单。

## 开关体系

开关分为三类，各自有独立的总闸：

| 分类 | 总闸 | 说明 |
| ---- | ---- | ---- |
| 通知 | `global`（通知总闸） | 控制所有群内通知（用户进退群、入群申请、机器人进退） |
| 功能 | `globalFunc`（功能总闸） | 控制所有群管功能（撤回、禁言、帮助、入群申请功能） |
| 转发 | `forwardGlobal`（转发总闸） | 控制转发主人的通知，**独立于通知总闸** |

`isEnabled(type, groupId)` 的校验逻辑：对应分类总闸开启 + 自身开关开启 + 本群未单独关闭。

开关键（含默认值）：

| 键 | 默认 | 分类 | 说明 |
| -- | ---- | ---- | ---- |
| `global` | true | 通知 | 通知总闸 |
| `memberIncrease` | true | 通知 | 用户进群通知 |
| `memberDecrease` | true | 通知 | 用户退群通知 |
| `joinRequest` | true | 通知 | 入群申请通知 |
| `bot` | true | 通知 | 机器人进退群通知 |
| `globalFunc` | true | 功能 | 功能总闸 |
| `recall` | false | 功能 | 撤回功能 |
| `mute` | true | 功能 | 禁言功能 |
| `help` | true | 功能 | 群管帮助指令 |
| `joinRequestFunc` | true | 功能 | 入群申请功能（列表/审批） |
| `forwardGlobal` | true | 转发 | 转发总闸 |
| `forwardJoinRequest` | true | 转发 | 入群申请转发主人 |
| `forwardDelete` | true | 转发 | 退群转发主人 |

配置文件位于 `config/config/switch.yaml`，缺省键会以 `SWITCH_DEFAULT` 补全。

## 设置面板

通过 QQBot Web Adapter 打开插件设置页，可：
- 可视化切换三类开关（通知 / 功能 / 转发）。
- 分别开关用户进群和用户退群通知。
- 编辑「转发接收人」：行内编辑当前 botqq 与 openid，botqq 以横幅下拉选择；支持新增（虚线框）与删除。

## 指令速查

> 转发 / 全局类指令仅主人可用；本群通知开关可由群主、管理员或主人操作。

**全局（仅主人）**
- `#群管全局开/关`：通知总闸
- `#用户进群全局开/关` / `#用户退群全局开/关` / `#入群申请全局开/关` / `#机器人进退全局开/关`
- `#群管功能开/关`：功能总闸
- `#撤回功能开/关` / `#禁言功能开/关` / `#群管帮助开/关` / `#入群申请功能开/关`
- `#转发总开关开/关`：转发总闸
- `#入群转发开/关` / `#退群转发开/关`

**本群（群主/管理/主人）**
- `#本群用户进群开/关` / `#本群用户退群开/关`
- `#本群入群申请开/关`

## 目录结构

```
QQBot-GroupAdmin-Plugin/
├── apps/                  # 指令与功能实现
│   ├── notice/            # 群内通知（加群/退群/入群申请等）
│   ├── groupJoinRequest.js
│   ├── groupSwitchList.js # #群管开关列表
│   ├── help.js
│   ├── mute.js
│   ├── noticeSwitch.js    # 开关切换指令
│   └── recallMsg.js
├── components/            # switch / config 等核心逻辑
├── constans/             # 开关元数据与体系常量
├── lib/                  # 工具函数
├── model/                # 数据模型（申请缓存、群开关、消息索引）
├── webadapter/           # 设置面板后端与前端
└── index.js
```

## 问题反馈

- [🔗内部交流群 1095352740](https://qm.qq.com/q/JxYAlbKRGy)反馈
- 邮箱459521475@qq.com反馈
- 直接提issue反馈(可能不会及时看到)