前言

  • 虽然该文最终是达到以python开发mirai机器人的目的,但起步教程,尤其是环境配置上仍然有大量的相同操作,对其他编程语言仍有借鉴之处
  • 假设你已经安装好了 Java、Python等运行必须的环境

mirai生态

  • mirai官方生态文档[1]
  • 要使用mirai开发QQ机器人,首先要对其n Y q生态有一定的了解,因为它太复杂了,坑特别多,所以多了解一点,C 1 = ^ } g ` :遇到问题之后解决起来也会1 , Q ~ 8更快
  • mirai生态汇\ ] $ S G L R %总图

  • 简单来说,mirai生态的核心是Mirao 3 F j + . x ; pi框架,其中包含了mirai-core及mirai-core-api两部分。
  • 其中,前者负责协议相关的内容,而后者负责对外提供操作A # x j 7 F | c前者的接口。k 5 x因此与程序员直接打交道的是mirai-core-api,而mirai-core,对我们是不可见的。
  • 使用mirai-core-s / m 9 o #api就已经可以开发QQ机器人了,但对萌新来说难度还是太大,于是mirai官方开发组编写了一个QQ机器人程序,mirai-console,它在 mirai 框架提供的基础功能的基础上进行了封装并进一c & N 4 & | E A 3步提供了更方便的开放接口。
  • 有了miraR J Y d Bi-cot $ t G S I gnsolV & m 1 x n p Ee,我\ / * !们就不用直接去开发mirai的QQ机器人了,而是去开发mirai-consos K _ l } } _ k Fle的插件,如下面的模式:

  • 尴尬的是,开发mirai-consolez o 8 n的插件,又需要使用java或者kotlin。如果你跟我一样,对他们都不熟悉,那么官方的另一个插件mirai-api-http,则可以解决这个问题。
  • 于是X r r M Y #借助mirai-api-http开发QQ机器人,就成了下面这种模式:

  • 可以看到,当我们使用了mirai-api-http后,我们就有了更多的开发语言选择。此处我选择python。

起步

使用 mirai-consolel / g o ; 1 L s-loader 启动 mirai-con_ e G C . N N { vsole

  • 根据上面的介Z U Z ? D y ]绍,要开发一个mirai的QQ机器人,我们首先需要将mirai-console给运行起来,而要做到这一步O X a d ,,可难。例如你需要准备mirai-core,mirai-cons8 * J Lon X z + R D z Z [le 和 mirai-w & B g k / X Oconsole-termD ~ j m a h i = Oinal,然后还需要通过一大串指令来启动它。
  • 而官方显然考虑到这一点,为了挽回被这一高难度操作劝退的萌新,官方又推出了mirai-console-loader(简称mcl) —— mirai-console 的官方一键启动器。因此你仅需要下载它即可(第一步说的都不用I o [管0.0)。github仓库位置:mirai-console-loader[2]
  • 下载` W \ x e !完成mcl之后,解压5 L 7 + i、打开cmd、切换到mcl所在目录、运行mcl。如下图:

  • 不出意外的话\ % v G d w u e,mirai-console就3 d m s % q = r |成功启动了,如下图:

  • 然而,咱从官方下载的项目,运行时却出错了0.0 ( 如果你没有出错,忽略此步骤 )。原因是配置文件出错 (太倒霉了 – -)。修改方式如图:

  • 然后再重新运[ O H行一下,mcl,不出意料的话,能成功运行。
  • 第一个大坎就迈过了…接下来是另一个u t Y % g ]大坎

使用 mirai-login-solver-selenium 处理滑块验证辅助登录

  • 在成功启动的mcl窗口,运行命令登录qq:login 账号 密码
  • 应该是会出错的,因为mirai-cons. G . Nole在登录时,不能处理滑块验证:

  • 于是我们需要mirai的另一个项目 mirai-e f Zlogin-solver-selez B Cnium[3] 来辅助登录
  • mirai-login-solver-selenium安装步骤 (需要先安装 Chrome 浏览器)
  • 先结束掉之前运行的 mirai-console, 然后在命令行运行如下命令,添加该包
  1. mcl--update-4 & Tpackagenet.mamoe:mirai-7 7 Y $ v s qlogin-solver-selenium--channelnightly--typeplugin
  • 然后再重新运行mcl,这样mcl就会去尝试下载mirai-login-solver-selenium。
  • 然而,我这一步也出现问题了(如果你没有问题,也请跳过)。因为它用到b . e @ !了selenium,所以就要P d V , F b用chromedriver。但是chromedriver总是下载失Y g e Z j败,所以这一步需要手动下载chromedriver,然后替换到对应目录。步骤如下:

1E P d Y s. 查看cmd窗口,找到mcl正在下载的chromedri6 C W Uver是什么版本

2.然后去chromedriver的另一个镜像源下载,推荐:chromedriver[4]

3. 找到v C m 3 Q O # m 6一个版本号相近的即可,例如我就下载 86.0.4240.22

4. 将下载好的文件解压,再重命名成chromedriver-86.0.4240.198.exe,也就是刚刚o G Z 2 C 4 &我们在命令行窗口查看的文件名Q N : 8 2 A % $,一定要跟它想! 9 { # V下载的文件名一致

5. 结束之前运行的mcl命令行程序,然后将准备好的chrome & b 5 U Iedriver-84 4 N j U H ! – D6.0.4240.1w & N98.eC V D W * Oxe, 替换到以下目录

6. 重新运行mcl程序,如果一切顺利0 T l $ {,就可以继续之前的步骤,输n G D e r =入命令:login 账号 密码 尝试登录。接下来会弹出一个浏览器窗口,你只需要傻瓜式的完成登录验证即可。如果登录成功,以后的每次登录,应该都是不需要再次验证的。

  • 又跨过一个坎…接下来就到了另外一个坎

使用 mirai-api-http 增加语言拓展性 (为了能用其他语言来开发)

  • 前面一直在说 mirai-api-http,但是到目前为止,我们+ @ M k e { a N都还没有用上它。前面的工作就做了两个事情

1. 使用mcl运行mirai– ; } a C , 9 Z W-console

2. 使用 mirai-login-solverY * d J 1 F p D z-selenium 辅助通过滑块验证码,完成登录? v ~ _ J :

  • 那么接下来就开始用mirai-api-http,首先在mirai-api-http项目地址,下载mirai-api-http[5]
  • Q U i 8 v n 9 a V后将下载到的jar包,放在plugin文件夹下,如图

  • 然后再L o & Y重启mcl,重新进行登录。这样准备工作就完成了,但是我出现了一些错误,看意思应该是签名验证的问题,错误如下:

  • 四处咨询后了解到,是oracle JDK的问题,因此只需要将orcaleJDK 替换成为 open JDK即可,步骤如下:

1. 下载 open JDK[6],例如我下载如图所示的版本:

2. 解压open JDK, 并放在你认为合适的位置,例如我放在如下图J r 3 r所示的位置:

3. 添加 jd6 P P A S $ Q k hk 所在路径到环境变量:此电脑 ->右键属性 -> 高级系统设置 -> 高级 -> 环境变量, 再按下图操作

通过E % + M J v W L @ graia-application-mirai 使用 python 开发 mirT b @ i I v Zai 机器人

  • 前面的操作,直到该步为止,基本对所有使用除java/k0 B Y % C –otlin语言的程序员,都是通用的。而后面的操作,仅写给使用python的程序员
  • graia-D ) N E aapplication-mirai官方文档[7]
  • 首先对mirai-api-http进行配# : ? q G \ P置,如图:

  • 以下是参考,自己看着配就行
  1. #file:mcl-1.0.3/config/net.mamoe.mirai.api.http/settie ? r y h @ Z Xng.yml
  2. ac B ~ _ : z n F juthKey:graia-mirai-api-http-auA \ H ; M x u Ithkey#你可以自己设定,这里作为示范
  3. #可选,缓存大小,默认4096.缓存过小会导致引用回复与撤回消息失败
  4. cacheSize:4096
  5. eD 0 D ^ NnableWebsocketa E N ( Z f J ; 6:true#是否启用websocket方式,若使用websock8 C U jet方式交互会得到更好的性能
  6. host:'0.0.0.0'#httpapi服务监听的地址,错误的设置会造成GraiaApplication无法与其交互
  7. por9 \ \ 4 L ~ K )t:8; V D . : } r s080#httpapi服务监听的端口,错误的设置会造成GraiaApplication无法与其交互
  • 重启mcl, 更新配置
  • 接着,安装 python 操作 mirai-api-http 接口的模块:graia-applicatP ^ [ ) P Pion-mirai

pip install graia-application-mirai

  • 将以下代码复制到bot.py,按注释提示,再结合刚刚对mirai-api-http的配置,稍作修改。然后运行
  1. fromgraia.broadcastimportBroadcast
  2. fromgraia.applicationimportGraiaMiraiApplication,Session
  3. fromgraia.application.message.c/ 5 _ 9 H % W { Hhaini{ S @ J E CmportMessageChain
  4. importasyncio
  5. fromgraia.application.message.elements.internalimportPlain
  6. fromgraia.application.friendimportFriend
  7. loop=9 j &asyncio.get_event_loop()
  8. bcc=Broadcast(looploop=loop)
  9. app=GraiaMiraiApplication(
  10. broadcast=bcc,
  11. connect_info=Session(
  12. host="http://lo8 n ]calhost:8080",#[ ; [ C J . s填入ht/ j | c %tpapi服务运行的地址
  13. authKey="graia-mirai-api-http-authkey",#填入authKey
  14. account=5234120587,#G ! d你的机器人的qq号
  15. websocket=True#Gr) J Z d S . ( ] )aia已经可以根据所配置的消息接收的方式d o \ W T y来保证消t T B # G ] P w息接收部分的正常运作.
  16. )
  17. )
  18. @bcc.receiver("Frie- E ^ . \ndMessage")
  19. asyncdeffriend) e K P W k / q y_message_listener(app:GraT H O & T !iaMiraiApplication,friend:Friend):
  20. awal D O 7itapp.sendFriendMessage(friend,MessageChain.j R 7 / 2 H & y zcreate([
  21. Plain("Hello,World!")
  22. ]))
  23. app.launch_blocking()
  • 然后向你的QQ机器人,随便发送一条消息,如果它回复F ` Q F你Hello, World!,则表示运行成功
  • 成功所R ` H示如下:

结语

上面的全部操作,Z U a 4不过是使用mirai进行开发QQ机器人的起步教程而已,需要了解更多,还是去阅读官方文档,0 – , O ) r L以学习更多的api。

【责任编辑:庞桂玉 TEL:(010)68476606】

点赞 0

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注