mirai 群聊机器人插件，支持加群审批、敏感词检测撤回，支持每日定时发送，支持订阅番剧更新、UP 动态更新推送，支持发送涩图(可指定tag)、美图、风景图等，支持随机鸡汤发送，支持坎公骑冠剑会战统计、前线报道、会战报表等功能，支持在线点歌，综合多个音乐平台发送最佳音乐，支持对话聊天，支持自定义关键词回复、正则表达式匹配……更多功能正在开发。

在一些情况下，发送涩图无反应，但查看控制台日志却发送图片已经发送，这种情况可能是由于图片被腾讯 ”拦截“ 了，属于正常现象，如果这种情况频繁发生，可以先暂停使用此号，过会时间再用，否则可能会被封号。

V3.3 版本后可以选择仅发送涩图链接，这或许是个不错的选项。

配置手册：配置手册

在此项目上二次开发或共同建设：开发手册

声明：HRobot 默认将会使用**标准时间。

机器人运行必须要求 Java 运行时环境版本大于等于 11。

建议您使用 mirai-console-loader 快速启动 mirai 机器人，下载地址：Releases · iTXTech/mirai-console-loader (github.com)，下载后解压文件。

网络上有很多教程，例如：Mirai Console Loader的使用教程~ - 哔哩哔哩 (bilibili.com)

如果你是新手，不会安装 java 环境，你可以使用安装器一键安装 java 环境 和 mcl，请移步：mcl 一键安装。

如果你会使用 Docker，强烈建议你使用 Docker 运行，可参考 使用 Docker 运行

经过测试，HRobot 适配 mcl-1.2.2、mcl-1.2.1、mcl-2.1.1 版本，其他版本暂未测试，但应该都是支持的。

前往Releases · happysnaker/mirai-plugin-HRobot (github.com)选择对应版本下载插件 jar 包 plugin-SNAPSHOT.mirai.jar，将该 jar 包移动至 mcl 文件下的 plugins 文件夹下，然后无须配置任何文件，点击 mcl.cmd 即可启动机器人，注意如果你是第一次下载，你必须先启动一次 mcl.cmd 才会有 plugins 相关文件夹生成。

在 Linux 下需要在当前文件下输入 ./mcl 命令启动.

启动后在命令行中键入：login QQ账号 QQ密码 即可登录机器人，登录相关步骤请参考：登录步骤

更多信息请移步mamoe/mirai: 高效率 QQ 机器人支持库 (github.com) 和 iTXTech/mirai-console-loader: 模块化、轻量级且支持完全自定义的 mirai 加载器。 (github.com)

如果你需要砍公骑冠剑相关或更多高级功能，那么您必须配置相关信息，请移步 配置文件手册

更多功能正在开发，请 STAR 持续关注此项目

Docker 是每一位程序员必备的技能，如果你的机器上没有安装 Java 环境，强烈建议你使用 Docker 运行，这能省去绝大多数不必要的麻烦。

如果你还不会使用 docker，可参考如下步骤拉取容器并运行：

1. 第一步：拉取镜像

   # default tag latest
   docker pull happysnaker/h-robot:latest	

   自 v3.3 之后，我们会为每个 release 版本维护一个 tag，你可以使用 tag 拉取对应的版本，例如 docker pull happysnaker/h-robot:3.3，版本号详情请前往 release 页面查看。

2. 第二步：前台运行容器

   docker run --name h-robot -it happysnaker/h-robot:latest bash

   由于涉及到交互问题，我们没有为容器设置任何入口命令，因此必须要在前台运行容器。

3. 第三步：登录并配置机器人

   在终端与容器交互，你所在的目录应该是 /app 目录，容器已经下载好了 mcl 以及对应版本插件，可以直接运行。

   root@4520678a5a87:/app# ls -al
   total 644
   drwxr-xr-x  3 root root   4096 Oct  2 19:36 .
   drwxr-xr-x 68 root root   4096 Oct  2 19:51 ..
   -rw-------  1 root root  34522 Sep 19 00:47 LICENSE
   -rw-------  1 root root   3705 Sep 19 00:47 README.md
   -rwx--x--x  1 root root     71 Sep 19 00:47 mcl
   -rw-------  1 root root    153 Sep 19 00:47 mcl.cmd
   -rw-------  1 root root 595443 Sep 19 00:49 mcl.jar
   drwxr-xr-x  2 root root   4096 Oct  2 19:36 plugins

   在第一次运行 ./mcl 启动机器人后，会自动生成模板配置文件，如有需要可以进行配置。随后重新启动一次机器人，参考上述使用说明登录机器人。

   当然你可以使用 docker cp 命令复制配置文件到容器中。

在我的云服务器上，我似乎没法用 docker logs 查看对应命令，因此我使用了 ./mcl | tee -a log.log 将输出同时定向到文件中查看，如果你也存在这个问题，可以参考这个做法

4. 第四步：退出容器但不终止机器人

   键入快捷键 ctrl p q 退出容器但不终止容器。当然你也可以使用 nohup 或 screen 等相关工具来完成此目的。

虽然 Docker 镜像版本与插件版本对应，但在升级插件时建议你在直接在容器内更换插件版本，并重新启动机器人，而不是重新拉取最新版本镜像运行，因为重新运行容器需要重新登录、重新配置机器人，浪费精力。

表格展示为最新版插件功能，默认情况下，与机器人聊天需要@机器人，而其他关键字都无须 @，详情请查看下表中的“示例”，你可以在 历史版本关键字及命令 中找到历史版本对应关键字，在配置文件中你可以选择关闭 @。

在 2.0 版本后，你可以通过命令的形式远程配置机器人，随时随地进行配置，你只要在群聊中发布相关命令即可。

但是你必须要有对应的权限，在最开始，你需要在配置文件中配置你自己成为超级管理员，随后你便可以通过命令的形式授予或移除他人权限，配置文件相关信息可参考：配置手册。

超级管理员 > 管理员 > 群管理员 > 坎公管理员

下表展示最新版插件插件功能，你可以在 历史版本关键字及命令 中找到历史版本对应信息。

注意，所有命令都必须以 # 开头，如果不执行 保存配置 文件，那么所有命令配置将在机器人关机时丢失。

项目秉持着开箱即用的原则，正常使用本插件不需要任何配置，但是如果你需要一些高级功能，或者涉及到某些需要配置的功能，例如砍公会战管理、订阅推送，此时你必须前往配置文件中进行配置。

HRobot 支持配置文件，配置文件在 mcl/config/com.happysnaker.HRobot/config.yaml 中，您可以手动创建配置文件，不过建议您运行一次 mcl.cmd，这会自动生产配置文件，配置文件相关信息可参考：配置手册。

在 mcl/data/com.happysnaker.HRobot 目录下存在一个 error.log，这里会记录机器人运行时发生的错误。

在 2.0 版本后，你还可以通过命令的形式配置机器人。

提出你的创意，或者再此源代码上进行二次开发，开发相关手册可参考：开发手册

我不是生产者，我只是 API 的搬运工，由于 API 随时可能停用，故此插件可能随时出问题，请您 star 此项目，一般情况下 API 失效都会第一时间解决（☞ 指重新找一个 API）。

所有使用 API 均为网络上免费 API，如下为主要使用的 API 列表：

• 智能聊天：青云客智能聊天机器人API (qingyunke.com)
• Bing 壁纸：必应每日高清壁纸 - 精彩，从这里开始 (ioliu.cn)
• 咪咕音乐：咪咕音乐链接歌词封面接口API - 刘明野的博客 (liumingye.cn)
• 聚合音乐：铜钟 - 在一处聆听所有音乐 (tonzhon.com)
• Pivix 涩图：Lolicon API
• 坎公骑冠剑：坎公百宝袋-bigfun社区
• 鸡汤：沙雕 APP 开放接口
• 疫情：实时更新|新冠肺炎疫情动态地图 (163.com)