基于Mirai框架的QQ机器人使用文档----郑大科协2021招新群

目录

1. 引言

        1.1 编写目的

        1.2 项目背景

        1.3 参考链接

2. 使用说明

        2.1 关于插件

        2.2 自动功能

        2.3 交互功能

        2.4 插件链接

3. 出错与恢复

        3.1 自动功能出错

        3.2 交互功能出错

4. 技术文档

       

---

---

1. 引言

        1.1 编写目的

                本文是向想使(tiáo)用(xì) “科协机器人菲菲” 的学弟学妹们提供的使用文档，同时也可为初接触Mirai框架，想快速部署基于Mirai的QQ机器人的人提供参考。        # 虽然我也才学了两天 [DOGE]

        1.2 项目背景

                在SmartQQ、WebQQ与酷Q关闭后，传统的基于这些框架与协议的QQ机器人已无法使用，因而选择了支持QQ Android协议的GitHub开源项目Mirai机器人库搭建QQ招新机器人。为郑大学生科协招新群提高趣味性与吸引力，科协yyds!

        1.3 参考链接

                Mirai GitHub:https://github.com/mamoe/mirai

                Mirai用户手册：https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md

                Mirai社区：https://mirai-bot.com/

                Mirai论坛：https://mirai.mamoe.net/

2. 使用说明

        2.1 关于插件

                刚刚装好的Mirai运行环境是没有任何功能的，功能将由插件提供。除了少数官方插件，Mirai插件主要由社区爱好者、开发者们提供。

                以下功能介绍将只介绍面向使用者的功能，全部功能请见技术文档。

        2.2 自动功能

功能	所属插件	参数	描述	备注
上线提醒	Debug-Helper	群号 # 由所有者设置	在机器人开始运行时向加入的QQ群中发送启动提示	采用黑名单模式，所有者可设置不发送提示的群聊
报早晚安	梅花娘	无	在每日5点时发送早安与每日一句，可同时发送自定义倒计时事件; 在每日12点时发送每日诗句。	凌晨5点时机器人常不在运行
随机定时提醒	Randomsay	时间与群号 # 由所有者设置	所有者可设置机器人在指定时间在指定群内发送文本，可设置多条文本，随机发送	无
内容审核	Mirai-Antiporn-Plugin	百度AI内容审核	基于百度AI内容审核的自动禁言助手，对设定的文本及图片进行审核，超出阈值后自动禁言一分钟	由于该功能与我科协"正经群"理念不符，同时百度AI免费审核次数用完了，固已关闭该功能
更多功能敬请期待	无	无	无	无

        2.3 交互功能

        

功能	所属插件	输入	参数	输出	备注
随机一言	梅花娘	头像双击动作，即戳一戳	无	随机一言，附ACG一张	无
点歌	梅花娘	点歌 <歌名> 唱歌 <歌名>	<歌名> 如: 雨一直下	以卡片形式点歌  以语音条形式点歌	提示: <尖括号>中的参数必填，(圆括号)中的参数选填。同时注意指令中的空格。 下同。
聊天人工智障	梅花娘	@科协机器人菲菲 <问题>	<问题> 如:你聪明吗?	@<提问者> <傻得可爱宛如智障的回复>	基于青云客API实现
舔狗日记	MiraiReplier	舔狗日记	无	<随机的舔狗日记一篇>	去年迎新机器人最受欢迎的功能，所有者花大精力把它复现了出来
笑话	MiraiReplier	笑话	无	<随机的笑话一则>	无
网抑云	MiraiReplier	网抑云	无	<随机的网抑云一句>	同样是去年很受欢迎的功能
鬼故事	MiraiReplier	鬼故事	无	<随机的鬼故事一个>	无
诗一首	MiraiReplier	诗一首	无	<随机的诗一首>	无
毒鸡汤	MiraiReplier	毒鸡汤	无	<随机的毒鸡汤一句>	无
帮助	MiraiReplier	帮助	无	<本使用文档的链接>	无
关键词	MiraiReplier	<你猜>	无	<随机的回复>	所有者无聊设置的一些关键词，猜猜会触发些什么呢? [DOGE]
随机美图	mirai-console-lolicon	/lolicon get (keyword) 成年人了 来一张 (keyword)	(keyword) 如:东方	<美图介绍> <美图>	每位用户指令冷却时间3分钟，输出会在20秒后撤回。 由于需要代理，<美图>发出需要等待时间。 虽然我们群是"正经群"，但该功能太过正经，请尽量少用或不用。
群内问答系统	MiraiWiki	见备注	见备注	见备注	使用起来略繁琐，在几百人的中小QQ群里优势体现不出来，感兴趣者可访问 https://github.com/Under-estimate/Mirai-wiki/blob/master/README.md 了解详细用法
基金助手	Fund-Helper	.基金 <基金编号> .添加自选 <基金编号1>(,<基金编号2>,<基金编号3>,,,,<基金编号n>) .我的自选	<基金编号> 懂得都懂，如:162703	<该基金相关数据> 添加成功 <自选基金基本数据>	无
更多功能 敬请期待	无	无	无	无	无

        2.4 插件链接

                梅花娘:https://gitee.com/K85/plum

                MiraiReplier:https://mirai-bot.com/d/37-miraireplier-mirai-qq

                Debug-Helper:https://github.com/gnuf0rce/debug-helper

                Randomsay:https://mirai.mamoe.net/topic/172/randomsay-%E9%9A%8F%E6%9C%BA%E5%AE%9A%E6%97%B6%E7%BE%A4%E5%86%85%E6%8F%90%E9%86%92

                Mirai-Antiporn-Plugin:https://github.com/gnuf0rce/Mirai-AntiPorn-Plugin

                mirai-console-lolicon:https://github.com/Samarium150/mirai-console-lolicon

                MiraiWiki:https://github.com/Under-estimate/Mirai-wiki

                Fund-Helper:https://github.com/NoErla/fund-helper

3. 出错与恢复

        3.1 自动功能出错

                别等了，机器人没开。

        3.2 交互功能出错

                3.2.1 无输出

                        请等待一会儿，机器人可能出现了卡顿。

                        请尝试"戳一戳""聊天"等简单功能，若有输出，则只是个别插件出错。

                        若只是对话功能出错，即只会回复“Sorry,I am busy now!”，则是由于目前连接的WiFi网络IP由于请求过于频繁被青云客服务器ban了，不用重复尝试了；或者可向学长学姐们要求暂时更换WiFi网络以恢复该功能。

                        若还无输出，很可能是机器人没开，可向学长学姐们询问开启时间。

                3.2.2 输出报错信息或乱码

                        恭喜你，发现bug了，请立即@饥不择bug的学长学姐们。

4. 技术文档

        基于本萌新这两天的工作的心得，引导初学者如何配置Mirai运行环境后搬运GitHub上开源插件后快速实现QQ机器人部署的技术文档。欢迎大佬们留言指正。

        URL：（有空再来填坑）

       

---