已弃用

该文档现已弃用,新的文档正在编写中,敬请期待
https://wiki.mrxiaom.top/mirai

旧文档 Github: MrXiaoM/mirai-docs
旧文档地址: https://mirai-docs.doomteam.fun/
一切内容以 Github 为准
希望论坛字数限制够放得下文档
如果你想实时收到更新通知,请点击右边第二个 铃铛按钮 来关注本贴

mirai-docs

面向初学者 的 mirai 非官方帮助文档

在本文档中,我将会按照顺序一步一步地教学,就像打怪升级一样

目前正在编写和整理中,敬请期待

注: 初学者 指 new miraier,刚接触 mirai 的人

观前须知

请先阅读《提问的智慧 (How To Ask Questions The Smart Way)》以确保你在遇到简单的问题时能够 STFW (到网上搜索) 以及 RTFM (读软件给出的帮助手册) 来解决问题而不是去问别人占用别人的时间,如果你的问题能搜索得到,那你得到的回复很可能是别人搜索了然后发你的

鲁迅曾经说过:“无端空耗别人的时间其实是无异于谋财害命的。”

所以在没到网上搜索之前不要提问!不要提问!不要提问!

在遇到网上搜索/读手册解决不了 (前提是要读过,要实践过确实不行) 再去以正确的方式提问,比如提供尽可能完整的信息,包括但不限于系统版本/所使用的软件或组件版本/进行的详细操作/输出日志或者弹出信息等等,而不是你问在吗,别人回答在,你问问题,别人找你要信息,你发信息,别人觉得信息不够推断不出来你的问题然后再进一步找你要信息…… 直接一步到位把信息提供全面难道不好吗?

如果你有问题,可以在本仓库 发布 issue (没有 Github 账号?点这里注册)。

也可以向我的邮箱 coolxiaom95@gmail.com 发送邮件求助,

或者加我的QQ 2431208142 (我没设加好友验证,申请添加好友之后请直接说明来意和详细描述问题)。

不管是在哪个渠道联系我,我看到你的消息之后将会在我空闲时尽快回复。

确认你的水平

在查阅这份文档之前,请确保你已掌握 kotlin 或者 java 两门语言中的其中一门

如果你已掌握一门语言并能使用这门语言进行网络操作,很抱歉目前我没有对这方面的研究,你可以去查看官方文档

如果你是完全不会编程的人类,你只需要查阅用户文档

如果你不是人类…… 能看得懂简体中文并能理解句子的意思的话大概也可以看得懂吧

开始吧

适合不会编程的新手: 用户文档

如果你还不会如何安装和登录机器人,也请查阅用户文档

使用 kotlin 或 java 来编写 mirai 衍生软件: 开发文档

使用其他语言来编写 mirai 衍生软件: 暂无文档,建议查阅官方文档

在这个文档发布之前,已经有很多前辈编写了 mirai-api-http 或者 onebot-kotlin 的其他语言实现,你可以在 mirai 官方开发文档 找到相应语言的社区SDK以便快速开始开发

如果你对更新 BlocklyMirai 有兴趣,可以查看 BlocklyMirai 帮助文档

更新

不定期更新,如果你有意愿更新文档,PRs welcome

赞助

本文档不接受赞助。

如果你喜欢这个文档并有意资助,开发组比我更需要赞助,请重定向到 【官方公告】关于论坛赞助/资金流向公示/可持续发展等

计划 开发文档以循循渐进的形式写,从部署到登录到事件到消息等等 不使用社区 SDK 的非 jvm 语言与 mirai-api-http 交互教程。因为社区 SDK 太多了很难讲明白 XD 考虑到 GitBook 日常前端崩溃,所以在本文档基本上完成之后,会在 MiraiForum 技术交流板块发一贴来备份以方便难以访问 Github 的用户查阅