# mirai-example

**Repository Path**: CandyPop/mirai-example

## Basic Information

- **Project Name**: mirai-example
- **Description**: 对mirai开源仓库的简单整合
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-24
- **Last Updated**: 2025-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一个简单的整合

[官方仓库](https://github.com/mamoe/mirai)

心血来潮想弄一个QQ的机器人，然后找到这样的框架，在登录的时候遇到些问题，在官方的帖子里翻了翻，以及对应启动控制台的错误信息自己做了一些调整，做了这样一个整合的包，大家可以直接down下来直接用，我这里简单介绍一下如何使用。

#### 登录

登录的步骤我们需要前往这个仓库，下载一个app，你问我为什么要下这个app，我也不知道，这是日志提示的需要我去下，安装后，点开是这个界面。

[扫码APP](https://github.com/KasukuSakura/mirai-login-solver-sakura)

![img](./img/d1ac17eb18b1a39be8e614fe8d94a924.jpg)

考虑到并不是所有人都能科学上网，我将这个apk放到仓库，你可以down下来直接用，名字叫这个

```
apk-release.apk
```

完成后，我们在mcl的控制台输入以下命令

```
login qq账号 qq密码 ANDROID_PAD
```

![1742820154892](./img/1742820154892.png)

接着使用你下载好的扫码app扫码登录

![1742820249339](./img/1742820249339.png)

![1742820274505](./img/1742820274505.png)

![1742820352250](./img/1742820352250.png)

![1742820398165](./img/1742820398165.png)

这样就完成登录了，我这个目前只是完成了登录操作，后面就是api的使用，然后我这个是没有安装http模块，大家可以依靠根据需求自行安装。



#### 问题解决依据

[如何解决签名服务器问题](https://mirai.mamoe.net/topic/2673/qsign-9-0-55-9-0-95-%E5%85%AC%E7%9B%8A-api%E5%8F%91%E5%B8%83?lang=zh-CN&page=1)



觉得解决你的问题就点个赞吧

# Mirai Console Loader

[![GitHub release](https://img.shields.io/github/v/release/itxtech/mirai-console-loader?label=stable)](https://github.com/iTXTech/mirai-console-loader/releases)
[![Maven Central](https://img.shields.io/maven-central/v/org.itxtech/mcl)](https://repo.maven.apache.org/maven2/org/itxtech/mcl/)
[![MiraiForum](https://img.shields.io/badge/post-on%20MiraiForum-yellow)](https://mirai.mamoe.net/topic/177)

模块化、轻量级且支持完全自定义的 [mirai](https://github.com/mamoe/mirai) 加载器。

开发者请参见 [MCL 开发文档](docs/README.md)。

## 简介

`iTX Technologies Mirai Console Loader`（下简称`MCL`）采用模块化设计，包含以下几个基础模块：

* `Module` 模块管理器，用于加载和执行模块，`MCL`的主要功能均由模块实现。模块执行有各个阶段，详见开发文档。
* `Config` 配置文件模块，用于配置的持久化。
* `Package` 包管理器。
* `Downloader` 下载器模块，用于下载文件，并实时返回进度。
* `Logger` 日志模块，用于向控制台输出日志。

## [`MCL` 命令行文档](cli.md)

该文档将教会您如何`安装插件`，`禁用和启用脚本`，`修改包的更新频道`等操作。

## 使用 `iTXTech MCL`

### 一键安装

[iTXTech MCL Installer](https://github.com/iTXTech/mcl-installer) 能在所有操作系统上一键安装 `iTXTech MCL`。

### 手动安装

1. 安装 Java 运行时（版本必须 >= 11）
2. 从 [Releases](https://github.com/iTXTech/mirai-console-loader/releases) 下载最新版本的`MCL`
3. 解压到某处
4. 在命令行中执行`.\mcl`以启动`MCL`

#### 在`*nix`下通过命令行安装

```bash
mkdir mcl
cd mcl
wget https://github.com/iTXTech/mirai-console-loader/releases/download/v2.1.1/mcl-2.1.1.zip
unzip mcl-2.1.1.zip
chmod +x mcl
./mcl
```

## `Mirai Repo` 列表

* [iTXTech](https://repo.itxtech.org) - **默认** - Cloudflare Pages
* [Mamoe](https://mcl.repo.mamoe.net) - GitHub Pages
* [GitHub](https://github.com/project-mirai/mirai-repo-mirror) - 源仓库

## `Maven Repo` 列表

* [Maven Central](https://repo1.maven.org/maven2/) - `Maven Central`上游
* [Aliyun](https://maven.aliyun.com/repository/public) - **默认**，阿里云`Maven`镜像，国内访问速度快
* [HuaweiCloud](https://mirrors.huaweicloud.com/repository/maven) - 华为云`Maven`镜像，阿里云不可用时的备选方案

## 安装`MCL Module`扩展组件

1. 在 `mcl` 运行目录下新建 `modules` 目录
2. 将 目标Jar 放入该目录
3. ~~编辑 `config.json` 中 `module_packages` 字段，添加入 `jar文件名（不带扩展名）:包名`~~ 

新版 MCL Module 加载将使用 Java SPI Service 的加载方式，不需要再配置 `module_packages` 字段

## `MCL` 默认支持 `Mirai 2.11` 及以上插件格式

若需要默认使用旧版插件格式，请移除`config.json`的`archiveSuffix`中的`.mirai2.jar`字段。

## 开源许可证

    iTXTech Mirai Console Loader
    Copyright (C) 2020-2022 iTX Technologies
    
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.
    
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.
    
    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.