# qq-robot

**Repository Path**: dinghangLoop_admin/qq-robot

## Basic Information

- **Project Name**: qq-robot
- **Description**: qq机器人
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 44
- **Created**: 2021-07-13
- **Last Updated**: 2021-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# qq-robot

#### 介绍

qq机器人，使用基础框架：https://github.com/mamoe/mirai  
文档地址：https://docs.mirai.mamoe.net  
推荐一个spring boot启动脚本：https://gitee.com/billdowney/spring-boot-script

#### 软件架构

采用插件式处理消息，可无限扩展插件，需要jdk1.8以上，maven3，暂时没有添加数据库相关操作，qq登录采用调用接口的方式，由于没有页面，所以直接采用knife4j的界面去调接口。  
用户和群隔离开，每个群单独一个启动的配置，所有用户私聊一个启动配置。  
系统管理相关命令都在【系统管理插件】里，部分命令必须配置了root管理员才能使用，对应配置：project.qq-robot.root-manage-qq（例如开关群管理权限）

#### 安装教程

1.  下载源码，更新maven包
2.  启动类：com.billdowney.qq.robot.StartUpApplication
3.  默认文档地址：http://127.0.0.1:8282/qq-root/doc.html
4.  由于其中用到了别人的api服务，需要修改application.yml中的配置：project.qq-robot.alapi-token、project.qq-robot.kate-api-token

#### 使用说明

1.  文档地址：机器人接口->启动机器人，输入登录的qq号和密码登录账号
2.  文档地址：机器人接口->机器人状态，可查看当前所有登录qq的状态，输入qq号查看指定的qq号状态
3.  文档地址：机器人接口->停止机器人，可直接退出所有的qq号，输入qq号退出指定的qq
4.  命令：#插件详情 系统管理插件，可查看当前所有管理员才能执行的命令，用于管理系统
5.  所有内置插件在com.billdowney.qq.robot.plugins.provide包里
6.  命令：#插件列表，可查看当前所有内置插件状态
7.  命令：#插件详情 {插件名称}，可查看对应插件简介以及使用方式

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request