PHPackages                             blankqwq/mirai-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. blankqwq/mirai-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

blankqwq/mirai-sdk
==================

a sdk for mirai

2211PHP

Since Dec 31Pushed 3y ago1 watchersCompare

[ Source](https://github.com/blankqwq/mirai-sdk)[ Packagist](https://packagist.org/packages/blankqwq/mirai-sdk)[ RSS](/packages/blankqwq-mirai-sdk/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel mirai sdk
=================

[](#laravel-mirai-sdk)

> 用于在`laravel`开发[`mirai`](https://github.com/mamoe/mirai) 机器人后端

### 开发中

[](#开发中)

> 目前为测试版,所以更新较为频繁。

所有功能完成后发布的v1.0.0

大部分完成后发布v0.x.0

- Mirai 消息类型
- Mirai 事件类型
- 良好的IDE提示
- 请求翻译成对应类
- Mirai-http-adaptor
    - http
    - websocket
- 状态事件路由
    - 单独一个插件
    - 完善功能
- GoCq适配

> ### 快速开始
>
> [](#快速开始)

安装

```
composer require blankqwq/mirai-sdk:dev-master -vvv

```

创建配置文件 `config/mirai.php`

```
use Blankqwq\Mirai\Drivers\Mirai\Http;
return [
    'default' => 'http', // 使用的驱动
    'debug'=>true,      // 日志记录
    'host' => 'localhost:8080', // adaptor地址
    'verify' => '', // 校验码
    'tty' => 7200, // session过期时间
    'account' => [
        'qq号', // qq号，可以为多个
    ],
    'drivers' => [ // 驱动列表,非必填(不建议设置,除非有自定义需求)
        'http' => Http::class,
    ],
    'guzzleConfig'=>[

    ]
]
```

> 简单示例

使用默认qq进行拍一拍

```
use Blankqwq\Mirai\Mirai;
..

Mirai::session()->sendNudge($sender['id'], $group['id']);

..
```

指定某qq进行拍一拍

```
use Blankqwq\Mirai\Mirai;

..

$qq='1234567890';
Mirai::session($qq)->sendNudge($sender['id'], $group['id']);
..
```

若为拍一拍目标为机器人时，机器人也进行拍一拍

```
$eventOrMessage = \Blankqwq\Mirai\Translate::get($request);
if ($event instanceof NudgeEvent) {
    Log::info('success_event', [$currentQQ,$event]);
   if ($event->target==$currentQQ){
        Mirai::session()->sendNudge($event->fromId,$event->subject['id'],$event->subject['kind']);
   }
}
```

发送群组消息

```
  $mirai->sendGroupMsg($qq,new MessageGroup(new Text(Arr::random(['没有了~','被玩坏了！','再问我要给你一拳','干哈，爷就是没有','？还来']))));
```

发送给好友

```
$mirai->sendFriendMsg(
        $qq->subject['id'], // 此处为qq
        new MessageGroup(new Text(Arr::random(['没有了~','被玩坏了！','再问我要给你一拳','干哈，爷就是没有','？还来'])))
    );
```

多消息类型

```
$imageMessage= new \Blankqwq\Mirai\Message\MessageItem\Image();
$imageMessage->setBase64(''));  // base64编码
$imageMessage->setUrl('http://..'); // 图片地址
$at = new \Blankqwq\Mirai\Message\MessageItem\At('qq号');
new MessageGroup($at,new Text(),new Image($imageMessage),...);
```

更多内容请查阅文档

API
---

[](#api)

采用小驼峰命名

> 参考[`project-mirai/mirai-api-http`](https://github.com/project-mirai/mirai-api-http)Adaptor文档

事件匹配

```
Translate::match($request,NudgeEvent::class,function($event){
    // 事件执行的回调

});
```

参与贡献
----

[](#参与贡献)

鸣谢
--

[](#鸣谢)

[`mirai`](https://github.com/mamoe/mirai)
[`project-mirai/mirai-api-http`](https://github.com/project-mirai/mirai-api-http)
[`MiraiGo`](https://github.com/Mrs4s/MiraiGo)
[`Mrs4s/go-cqhttp`](https://github.com/Mrs4s/go-cqhttp)

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity23

Early-stage or recently created project

 Bus Factor1

Top contributor holds 87.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1ad02fe5922d334a408f7ab3795fd0f4fbffd2fb436d66997c3ed2479e1c9b97?d=identicon)[blankqwq](/maintainers/blankqwq)

---

Top Contributors

[![blankqwq](https://avatars.githubusercontent.com/u/35186126?v=4)](https://github.com/blankqwq "blankqwq (35 commits)")[![vitechliu](https://avatars.githubusercontent.com/u/13018940?v=4)](https://github.com/vitechliu "vitechliu (4 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

laravelmiraiphpqqqqbot

### Embed Badge

![Health badge](/badges/blankqwq-mirai-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/blankqwq-mirai-sdk/health.svg)](https://phpackages.com/packages/blankqwq-mirai-sdk)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)