# qqbot

**Repository Path**: xiaobenmao/qqbot

## Basic Information

- **Project Name**: qqbot
- **Description**: 这是一个QQ机器人，拥有强大的自定义功能（插件系统）(A bot for QQ)
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-12
- **Last Updated**: 2025-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QQ机器人
## 介绍
- 这个QQ机器人拥有插件系统，可以轻松扩展
- 语言：C++23

## 依赖
### 前置依赖
- [cpp-httplib](https://github.com/yhirose/cpp-httplib)
- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp)
- [asio](https://github.com/chriskohlhoff/asio)
- [openssl](https://github.com/openssl/openssl)
### 导入
- 在[CMakeLists.txt](./CMakeLists.txt)里面进行编辑然后再编译

## 功能
### QQ机器人插件系统
#### 创建插件
- 此机器人只有一个框架，用于插件扩展，所有指令（除了基本的help等基础指令）都是通过插件加入  
- 插件类  
```cpp
#pragma once

#include <string>

#include "command.h"
#include "permission.h"

namespace qqbot
{
	struct PluginInfo
	{
		//插件名称
		std::string name;

		//插件作者名
		std::string author;

		//插件版本
		std::string version;
	};

	class CppPlugin
	{
	public:
		//禁止复制，只能移动
		CppPlugin() = default;
		CppPlugin(const CppPlugin&) = delete;
		~CppPlugin() = default;

		CppPlugin& operator =(const CppPlugin&) = delete;

		//插件加载
		virtual void onLoad()
		{
		}

		//插件启动
		virtual void onEnable()
		{
		}

		//插件关闭
		virtual void onDisable()
		{
		}

	public:
		//插件信息
		PluginInfo pluginInfo;

	private:

	};
}

```

- 插件例子[groupOperator.h](./plugin/groupOperator.h)  
```cpp
#include <httplib.h>
#include <Json.h>
#include <vector>
#include <string>

//最基本的三个库
#include "cppPlugin.h"
#include "pluginLibrary.h"
#include "network.h"

namespace GroupOperator
{
    class GroupOperatorPlugin : public qqbot::CppPlugin //继承插件类
    {
    public:
        GroupOperatorPlugin()
        {
            qqbot::CppPlugin::pluginInfo.author = "quqiOnfree";            //作者名
            qqbot::CppPlugin::pluginInfo.name = "GroupOperator群组管理插件";//插件名称
            qqbot::CppPlugin::pluginInfo.version = "0.0.1";                //插件版本
        }

        ~GroupOperatorPlugin() = default;

        virtual void onLoad()
        {
            //这里是插件加载之前执行
        }

        virtual void onEnable()
        {
            //这里是插件加载完成时启动执行

            //添加指令
            qqbot::ServerInfo::getCommander().addCommand("kick",//命令名称
                [this](long long groupID,
                    long long senderID,
                    const std::string& commandName,
                    std::vector<std::string> Args)              //lambda表达式或符合格式的函数
                {
                    //...
                },
                "kick userid true/false",       //命令格式
                "踢出群成员"                    //命令作用解释
                );

            //设置权限
            qqbot::ServerInfo::getPermission().setGroupDefaultPermission("kick", false);
            //true是普通用户可以访问，false是管理员可以访问
            //这个可以在配置文件里面进行编辑
        }
    };
}


```
#### 加载插件  
需要在[register.cpp](./register/register.cpp)加入一些代码
```cpp
//导入插件
#include "pluginName.h" //插件名

namespace qqbot
{
	//修改此函数
	void Register::init()
	{
		//添加插件（以GroupOperator为例）
		//this->addPlugin(std::make_shared<插件命名空间::插件类>());
		this->addPlugin(std::make_shared<GroupOperator::GroupOperatorPlugin>());
	}
	
	//省略下面代码
	//...
}

```
## 开发此qqbot
### qqbot的各种系统及API
- 权限系统 [Permission System](./doc/permission.md)
- 命令系统 [Command System](./doc/command.md)
- 插件系统 [Plugin System](./doc/plugin.md)