Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

优化QQ机器人讲述部分 #381

Merged
merged 3 commits into from
Feb 12, 2025
Merged

优化QQ机器人讲述部分 #381

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
df908e7
优化 Minecraft QQ 机器人介绍
virgil698 Feb 11, 2025
f0638b8
更改部分语法错误
virgil698 Feb 11, 2025
c70b274
优化部分配置
virgil698 Feb 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 1 addition & 75 deletions docs-java/advance/bot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,78 +3,4 @@ title: 机器人搭建
sidebar_position: 10
---

# 机器人搭建

## QQ 机器人

<!--## 使用已存在的机器人插件方案

:::info

一般而言，已经存在的机器人方案实现起来相对容易且功能多。

如果你不是专业开发者，非常推荐直接使用已存在的机器人插件实现。

:::-->

目前比较推荐的方案：

### [EasyBot](https://www.minebbs.com/resources/easyBot-minecraft.7918/)

> EasyBot 是一个基于 Blazor 开发的跨平台群服互通框架,旨在优化您的游戏社区体验。
> 它不仅提供了消息同步功能，还具备自定义命令、绑定管理、高级权限控制以及群组互动等多种实用特性。

- [文档](https://docs.hualib.com/) - 主页

- [自定义命令教程](https://docs.hualib.com/%E5%91%BD%E4%BB%A4%E5%88%97%E8%A1%A8.html) - 简单地通过自定义命令实现查看服务器 TPS，玩家数据等。

- [消息同步](https://docs.hualib.com/%E6%B6%88%E6%81%AF%E5%90%8C%E6%AD%A5.html) - 教程

- [图片模板](https://docs.hualib.com/market/template.html) - 概念

优点：配置简单，网页编辑器方便新手，轻量。

<details>
<summary>一些EasyBot功能的截图</summary>

#### 宣传图

![](_images/easybot.png)

#### 主页

![](_images/easybot_home.png)

#### 服务器管理

![](_images/easybot_rcon.png)

#### 玩家管理

![](_images/easybot_player.png)

</details>

### [XinxinBot 系列](https://www.minebbs.com/threads/xinxinBotapi-qq-1-8-x-1-20-x.24540/)

<!--[XinxinBotAPI MineBBS 链接](https://www.minebbs.com/threads/xinxinBotapi-qq-1-8-x-1-20-x.24540/) -->

[账号绑定](http://wiki.mcxin.cn/zh/%E6%96%B0%E9%91%AB%E6%9C%BA%E5%99%A8%E4%BA%BA%E9%99%84%E5%B1%9E%E6%95%99%E7%A8%8B/XinxinBetterBind)

[消息同步](http://wiki.mcxin.cn/zh/%E6%96%B0%E9%91%AB%E6%9C%BA%E5%99%A8%E4%BA%BA%E9%99%84%E5%B1%9E%E6%95%99%E7%A8%8B/XinxinChatSync)

优点：使用附属插件，功能更多。

缺点：配置稍复杂。

<!--### 其他方案的注意事项

如果某个方案基于 MiraiMC，请参见下文。-->

### [MiraiMC](https://github.com/DreamVoid/MiraiMC)

MiraiMC 是一款能够作为服务器插件加载的机器人框架。它非常适合仅有一个服务端，尤其是使用面板开服的 **小型服务器** 使用。
MiraiMC 的大多数排障方法和特性都与 Mirai 相同，遇到问题时你可以参考 Mirai 框架的使用文档。

MiraiMC 已添加了 [对 Overflow 的支持附属插件](https://github.com/DreamVoid/MiraiMC/issues/510)，因此你可以使用 Overflow 协助登录。
这也帮助了许多停更的基于 MiraiMC 的老机器人插件。
请见 [通用 | 群机器人](https://nitwikit.8aka.org/advance/bot)
115 changes: 100 additions & 15 deletions docs/advance/bot/framework.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,28 +3,113 @@ title: 机器人框架
sidebar_position: 1
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# 机器人框架
## NoneBot
NoneBot 是一个基于 Python 的机器人框架，支持同时接入多个平台，使用插件可实现搭建群服互通机器人。
支持的MC插件：[MCQQ](https://github.com/17TheWord/nonebot-plugin-mcqq)

框架链接：https://github.com/nonebot/nonebot2
## 第三方机器人框架

<Tabs queryString="qqbot">
<TabItem value="LLOneBot" label="LLOneBot">

| LLOneBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/LLOneBot/LLOneBot) \| [文档站](https://llonebot.github.io/zh-CN/) |
| 作者 | [LLOneBot](https://github.com/LLOneBot) |
| 介绍 | LiteLoaderQQNT 插件，实现 OneBot 11 和 Satori 协议，用于 QQ 机器人开发 |
| 下载 | [Github](https://github.com/LLOneBot/LLOneBot/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 |

</TabItem>
<TabItem value="NapCatQQ" label="NapCatQQ">

| NapCatQQ | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/NapNeko/NapCatQQ) \| [文档站](https://napneko.github.io/) |
| 作者 | [NapNeko](https://github.com/NapNeko) |
| 介绍 | NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现 |
| 下载 | [Github](https://github.com/NapNeko/NapCatQQ/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 |

</TabItem>
<TabItem value="Lagrange.OneBot" label="Lagrange.OneBot">

| Lagrange.OneBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/LagrangeDev/Lagrange.Core) \| [文档站](https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/) |
| 作者 | [LagrangeDev](https://github.com/LagrangeDev) |
| 介绍 | Lagrange.Core 是一个开源的 NTQQ 协议实现，实现了 OneBot V11 的通信协议, 可以和主流 Bot 框架进行通信 |
| 下载 | [Github](https://github.com/LagrangeDev/Lagrange.Core/releases) |

</TabItem>
<TabItem value="Overflow" label="Overflow">

| Overflow | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/MrXiaoM/overflow) \| [文档站](https://mirai.mrxiaom.top/docs/UserManual) |
| 作者 | [MrXiaoM](https://github.com/MrXiaoM) |
| 介绍 | Overflow 是 mirai-core-api 的实现，对接 OneBot 11 标准，实现 mirai 的无缝迁移 |
| 下载 | [官网下载](https://mirai.mrxiaom.top/) |

</TabItem>
</Tabs>

## 接入QQ官方接口的机器人框架

<Tabs queryString="qqbot">
<TabItem value="Gensokyo" label="Gensokyo">

| Gensokyo | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/Hoshinonyaruko/Gensokyo) |
| 作者 | [Hoshinonyaruko](https://github.com/Hoshinonyaruko) |
| 介绍 | 基于 OneBot QQ官方机器人Api Golang 原生实现 |
| 下载 | [Github](https://github.com/Hoshinonyaruko/Gensokyo/releases) |

</TabItem>
</Tabs>

## 已停止更新的机器人框架

<Tabs queryString="qqbot">
<TabItem value="Shamrock" label="Shamrock">

| Shamrock | ![](https://img.shields.io/badge/状态-停止维护-red?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/whitechi73/OpenShamrock) \| [文档站](https://whitechi73.github.io/OpenShamrock/) |
| 作者 | [whitechi73](https://github.com/whitechi73) |
| 介绍 | 基于 Lsposed（Non-Riru） 实现 Kritor 标准的 QQ 机器人框架 |
| 下载 | [Github](https://github.com/whitechi73/OpenShamrock/releases) |

## Koishi
Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架，支持同时接入多个平台。使用插件可实现搭建群服互通机器人。
</TabItem>
<TabItem value="chronocat" label="chronocat">

框架链接：https://github.com/koishijs/koishi
| chronocat | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/chrononeko/chronocat) |
| 作者 | [chrononeko](https://github.com/chrononeko) |
| 介绍 | 模块化的 Satori 框架 |
| 下载 | [Github](https://github.com/chrononeko/chronocat/releases) |

## Mirai
Mirai 是一个在全平台下运行，提供 QQ Android 协议支持的高效率机器人库。**Mirai不原生支持 QQNT**
</TabItem>
<TabItem value="go-cqhttp" label="go-cqhttp">

相对其他框架，Mirai具有较强的扩展生态。可搭配 [Overflow](https://github.com/MrXiaoM/overflow) 与其他框架以支持QQNT。
| go-cqhttp | ![](https://img.shields.io/badge/状态-停止维护-red?style=for-the-badge) \| [停更公告地址](https://github.com/Mrs4s/go-cqhttp/issues/2471) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/Mrs4s/go-cqhttp) \| [文档站](https://docs.go-cqhttp.org/) |
| 作者 | [Mrs4s](https://github.com/Mrs4s) |
| 介绍 | 基于 Mirai 以及 MiraiGo 的 OneBot Golang 原生实现 |
| 下载 | [Github](https://github.com/Mrs4s/go-cqhttp/releases) |

框架链接：https://github.com/mamoe/mirai
</TabItem>
<TabItem value="Mirai" label="Mirai">

## NapCat (推荐)
一个基于 TypeScript 构建的 Bot 框架，通过相应的启动器或者框架，主动调用 QQ Node 模块提供给客户端的接口，实现 Bot 的功能。
| Mirai | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/mamoe/mirai) \| [官方论坛](https://mirai.mamoe.net/) \| [用户手册](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md) |
| 作者 | [mamoe](https://github.com/mamoe) |
| 介绍 | mirai 是一个在全平台下运行，提供 QQ Android 协议支持的高效率机器人库 |
| 下载 | [Github](https://github.com/iTXTech/mirai-console-loader/releases) |

该框架支持 QQNT。
</TabItem>
</Tabs>

框架链接：https://github.com/NapNeko/NapCatQQ
82 changes: 74 additions & 8 deletions docs/advance/bot/general.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,84 @@
---
title: 通用机器人
title: 通用机器人程序
sidebar_position: 2
---

# 通用机器人
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

指 Serein 这类不依赖插件模组加载器的独立软件，通常是通过读取控制台和执行控制台命令实现
# 通用机器人程序

## Serein
指一个独立程序运行的 QQ 机器人程序，这些机器人程序仅只有 QQ 消息处理功能， QQ 连接需要依赖 QQ 机器人框架

待补充<!--Serein只是听说可以通过安装插件来实现机器人？-->
部分 QQ 机器人程序会依赖 Minecraft 插件来实现部分无法完成的功能。

## DLS
关于机器人框架详情请见 [通用 | 机器人框架](https://nitwikit.8aka.org/advance/bot/framework/)

类似 Serein 的自动管理控制台的一站式解决方案，几乎全部功能均依赖正则表达式匹配控制台输出的原理。目前已经适配大多数主流服务器的控制台，支持 OneBot 协议。
<Tabs queryString="tyqqbot">
<TabItem value="DLS-CQhttp" label="DLS-CQhttp">

可以阅读其 [Wiki](https://gitee.com/dlcn/dlscq/wikis/) 进行安装配置。
| DLS-CQhttp | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Gitee 仓库](https://gitee.com/dlcn/dlscq) \| [文档站](https://gitee.com/dlcn/dlscq/wikis) |
| 作者 | [21Hertz](https://gitee.com/dlcn) |
| 支持平台 | Java 版和基岩版 |
| 介绍 | 一个无图形服务端管理程序，支持大多数主流服务端，主打长期稳定，使用 OneBot11 标准接入 QQ，理论上可支持任何命令行 |
| 下载 | [Gitee](https://gitee.com/dlcn/dlscq/releases) |

</TabItem>
<TabItem value="DLS-native" label="DLS-native">

| DLS-native | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Gitee 仓库](https://gitee.com/dlcn/dlsna) \| [文档站](https://gitee.com/dlcn/dlscq/wikis/%E5%85%B6%E4%BB%96%E6%A1%86%E6%9E%B6/%E5%AE%98%E6%96%B9%E9%A2%91%E9%81%93%E6%9C%BA%E5%99%A8%E4%BA%BA) |
| 作者 | [21Hertz](https://gitee.com/dlcn) |
| 支持平台 | Java 版和基岩版 |
| 介绍 | DLS-CQhttp 的一个分支，使用 QQ开放平台API 标准接入 QQ，继承了 DLS-CQhttp 一样的易用性 |
| 下载 | [Gitee](https://gitee.com/dlcn/dlsna/releases) |

</TabItem>
<TabItem value="EasyBot" label="EasyBot">

| EasyBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [文档站](https://wiki.bioc.fun/) |
| 作者 | [MiuxuE](https://github.com/zzh4141) |
| 支持 **Java 版** | Bukkit 及其分支 |
| 介绍 | 基于 Blazor 开发的跨平台群服互通框架，使用 OneBot11 标准接入 QQ，配置较为复杂但实现效果较好 |
| 下载 | [官网下载](https://wiki.bioc.fun/down.html) |

</TabItem>
<TabItem value="Serein" label="Serein">

| Serein | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/SereinDev/Serein) \| [文档站](https://sereindev.github.io/) |
| 作者 | [SereinDev](https://github.com/SereinDev) |
| 支持平台 | Java 版和基岩版 |
| 介绍 | 本身是一个服务器管理软件，但支持使用 QQ 机器人，使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 |
| 下载 | [Github](https://github.com/SereinDev/Serein/releases) |

</TabItem>
<TabItem value="CirnoBot" label="CirnoBot">

| CirnoBot | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/summerkirakira/CirnoBot) \| [文档站](https://biaoju.site/cirnobot/) |
| 作者 | [summerkirakira](https://github.com/summerkirakira) |
| 支持 **Java 版** | Bukkit 及其分支 |
| 介绍 | 基于 NoneBot2 开发的机器人平台，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 |
| 下载 | [文档教程](https://biaoju.site/cirnobot/docs/%E7%AE%80%E5%8D%95%E4%B8%8A%E6%89%8B) |

</TabItem>
<TabItem value="Minecraft_QQBot" label="Minecraft_QQBot">

| Minecraft_QQBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) |
| --- | --- |
| 相关链接 | [Github 仓库](https://github.com/Minecraft-QQBot/BotServer) \| [文档站](https://qqbot.bugjump.xyz/) |
| 作者 | [sparkbridge](https://github.com/sparkbridge) |
| 支持 **Java 版** | Bukkit 及其分支 |
| 介绍 | 一款基于 NoneBot2 用多种方式与 Minecraft 交互的 Python QQ 机器人，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 |
| 下载 | [文档教程](https://qqbot.bugjump.xyz/%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.html) |

</TabItem>
</Tabs>
Loading