????????筆者在22年二月份接觸到了Mirai這個開源的qq機器人項目，在研究了半年之久后，想要作為一個熟悉的使用者向大家介紹并分享一下這個機器人，于是在此寫了個簡單的教程。盡管網(wǎng)上的教程有很多，盡管我在文中使用的術(shù)語、技術(shù)也不是非常專業(yè)的，但是我還是希望自己親自寫一篇，盡可能詳細、通俗的搭建教程，讓大部分萌新看到后都能嘗試并成功搭建屬于自己的qq機器人。

? ? ? ? 本文中會引用比較多的GitHub頁面，而對于缺少網(wǎng)絡(luò)工具的網(wǎng)友來說可能打不開，所以對于文中提到的所有的GitHub下載頁面，文章中都提供了云盤下載鏈接，文中所有的網(wǎng)頁鏈接，都只是作為內(nèi)容原出處的標注，文章會對鏈接中頁面上的內(nèi)容進行簡略的復述和說明，不需要大家都打開查看。

????????筆者第一次寫網(wǎng)絡(luò)教程，也是第一次用B站的專欄功能，如果有需要改正或改進的地方請多多指正！

0.安裝前言

????????Mirai核心的項目地址是https://github.com/mamoe/mirai，注意此鏈接項目的release里沒有Mirai的直接安裝文件，不要去下載這個項目的release。下圖為項目頁面的介紹信息和值得關(guān)注的重要信息：

????????首先，這個庫以及整個平臺完全免費，所以只要自己肯認真研究，完全不花一分錢就能使用，官方“不鼓勵，不支持一切商用”。Mirai支持qq的絕大部分協(xié)議（功能），但是以下協(xié)議不會支持：

????????金錢相關(guān)，如點贊、收付款；敏感操作，如主動添加好友、主動加入群、主動邀請好友加群；安全相關(guān)，獲取賬號登錄憑證(token，cookie等)，所以自動搶紅包這種涉及金錢相關(guān)的是不會被允許的，自動加好友加群發(fā)廣告也是做不到的，安全相關(guān)操作將會使登錄更加安全，但是也造成了登錄時的繁瑣操作。

1.安裝

? ? ? 獲取安裝程序鏈接在Mirai這個項目的用戶手冊頁面，鏈接為https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md。這個文檔中提到了一下關(guān)鍵信息：

1. 使用 Mirai，一般人要啟動的是 Mirai 控制臺（即 Mirai Console），它可以加載插件。

2. Mirai 控制臺現(xiàn)在有兩個版本，插件在這兩個版本的 Mirai Console 上都可以運行:純控制臺和圖形界面。
   

? ? ? ?其中，第一條提到了Mirai的運行模式，就是在Mirai整個主體框架下，用戶選擇性的安裝功能性的插件來豐富功能，使用時啟動Mirai控制臺（Mirai Console）并令其加載插件。

????????第二條提到了Mirai具有兩個版本，分別是穩(wěn)定、也適合服務(wù)器的純控制臺版本和測試版，不穩(wěn)定的圖形頁面版本。下面的兩張圖分別展示了兩個版本不同的外觀：

????????????????1.純控制臺版

????????????????2.圖形界面

? ? ? ? 我個人認為，兩個版本的區(qū)別在于，純控制臺版本為命令行操作，適合服務(wù)器，優(yōu)勢在于更穩(wěn)定、占用資源更少；圖形界面版本為窗口操作，使用時更加直觀，優(yōu)勢是部分內(nèi)容和操作可視化。本教程只會介紹第一種，純控制臺版本，也推薦大家使用這個版本，這個版本相較于第二種確實會對一些不熟悉計算機操作的萌新造成一些困擾，畢竟大部分人，也包括我，對于軟件還是更加熟悉窗口操作，對于黑框白字的命令行往往感到陌生而復雜，從而對使用感到抵觸。但是希望大家能盡量克服這些心理阻礙，本教程會盡力為大家排解在使用控制臺時會遇到的困難與問題。

????????純控制臺版本的說明文檔：https://github.com/mamoe/mirai/blob/dev/docs/ConsoleTerminal.md。純控制臺使用的軟件為Mirai Console 啟動器（mirai-console-terminal），一般會采用MCL來代稱。本篇文章剩下的內(nèi)容主要就是圍繞著MCL的安裝與使用。本文默認讀者使用的是?Windows 操作系統(tǒng)，但 Mirai Console 并不僅限于 Windows 平臺使用，在其他操作系統(tǒng)上的安裝以及使用方法應(yīng)當是類似的。

????????Mirai-Console-terminal安裝程序的真正下載地址：

????????????Github的官方下載地址：https://github.com/iTXTech/mcl-installer/releases，這個下載穩(wěn)定的正式版最新更新時間還是22年5月，建議選擇穩(wěn)定版本。如果對于選擇下載哪個感到疑惑，請選擇帶有Latest標簽版本mcl-installer-1.0.7-windows-x86.exe

文章提供的此安裝文件的其他下載途徑：

百度云：https://pan.baidu.com/s/1iI0zYGUGl9-K90Zyfp9uzA?pwd=9297 提取碼：9297

阿里云：https://www.aliyundrive.com/s/G46LmBWAUqm

下載后，在電腦任意位置新建一個文件夾用于運行機器人，注意此文件夾的路徑將可能會影響到后續(xù)的操作，保證路徑不要有中文可以避免很多意料之外的問題（尤其注意如果你的操作系統(tǒng)電腦賬號名是中文的話不要將文件夾設(shè)在桌面）。將mcl-installer-1.0.7-windows-x86.exe放到你要安裝的文件夾內(nèi)，雙擊啟動，此時可能彈出Windows的防火墻，我們點更多信息下面會出現(xiàn)仍要運行。

????????之后我們會看到命令行頁面：

????????安裝時首先要處理的是第一條指令，即是否要同時安裝Java環(huán)境，如下圖

????????如果你對于你電腦上有沒有java不熟悉，請選輸入y并回車，并在之后連續(xù)的幾個問題中摁回車確認，其中Java的安裝可能需要一段時間等待。

????????如果你很清楚此臺電腦上安裝過java環(huán)境，則在第一次輸入n跳過安裝以減少過多安裝java帶來的其他可能沖突。

????????之后處理的第二句話就是確認安裝MCL，直接輸入y回車即可。

????????出現(xiàn)以下這行字之后就說明我們初步安裝成功。此時可以按回車退出。

2.初次運行

????????在安裝后文件夾的內(nèi)容應(yīng)該如下（或者多了一個java文件夾）：

????????其中安裝程序文件mcl-installer-1.0.7-windows-x86.exe因為安裝已完成可以選擇刪除。之后我們每次主要運行的程序為mcl.cmd文件，如果你文件夾不顯示文件后綴，你會顯示兩個名為mcl的文件，建議百度查詢“如何顯示文件后綴名”，這不是必要的，但是會讓你減少麻煩。

????????然后要做的就是第一次啟動mcl.cmd，啟動后會開始MCL內(nèi)核文件的補充下載：

????????等待所有下載完成之后，出現(xiàn)下圖與綠字提示I/main: mirai-console started successfully.，則恭喜你，成功完成了MCL主體框架安裝的步驟，注意，只要你完成了這一步，說明MCL的主體框架沒有問題，如果之后的操作導致窗口閃退，則可以排除此處的原因。

????????如果安裝過程中卡住了并出現(xiàn)了如下圖提示，則說明你的網(wǎng)絡(luò)出現(xiàn)了問題，可以更換網(wǎng)絡(luò)多嘗試幾次（比如將電腦網(wǎng)絡(luò)連接改成連接至手機熱點而不是家里的WIFI或者校園網(wǎng)），直至能出現(xiàn)上圖的結(jié)果。

? ? ? ? 其中，圖中的“SLF4J：……”等紅色字體部分可以直接忽略，這不影響我們正常使用。當你的窗口最下行是" >_? "的字符時，即說明你現(xiàn)在處于MCL的運行處理中，此時即可輸入要執(zhí)行的指令并回車來操作，也就是說，現(xiàn)在開始，我們要通過在命令行里輸入功能指令來使用這個程序。

????????在此穿插一些關(guān)于命令行相關(guān)的操作值得注意的事項，可以跳過此部分，但是這些看似簡單細節(jié)，可能會避免使用時造成一些的小問題和以后運行過程中的困擾：

????????1.命令行窗口中選中文本右鍵不會出現(xiàn)選擇的選項，而是直接復制和粘貼，大體規(guī)則為：鼠標選中命令行中的一段文本后右鍵為直接復制這段文本，不選擇文本直接右鍵窗口為在提示符下劃線?_?的后面粘貼之前復制的文本。Ctrl+C和Ctrl+V等快捷鍵不再適用，千萬不要因為習慣而使用快捷鍵操作。

????????2.選擇命令行窗口中的文本會阻塞程序的運行。如下圖我拉選了一部分文本。

?或者我只是點到了窗口中的某一位置，如下圖紅圈位置

????????這些都會導致命令行窗口的標題出現(xiàn)選擇的字樣，此時命令行中原本運行的程序會被阻塞，表現(xiàn)為程序卡住了，機器人不回復了，此時右鍵一次命令行的窗口內(nèi)（黑框里）任意位置即可取消這種狀態(tài)。

????????除此之外，命令行有一套專用的操作規(guī)則，但是對于使用MCL，我們不需要掌握其他復雜的內(nèi)容。

? ? ? ? 首先，我們可以輸入?/help?來查詢目前支持的指令和作用，輸入時在指令前端不需要一定輸入斜杠 /?，也就是說輸入 /help 和直接輸入 help 都可以執(zhí)行這個指令，依據(jù)你的習慣即可。指令 /help 的作用列出的就是當前使用的MCL及插件中的所有指令及說明。

????????在此簡單說明一下上圖中，我們使用過程中主要會用到的指令以及作用：

????????????所有以/autoLogin 開頭的為自動登錄相關(guān)配置，接下來會細說。

????????????/login <qq> [password] 為登錄一次此qq號

????????????所有以/permission 開頭的為權(quán)限配置，簡寫為 /perm ，在之后配置插件時會細說。

?????????????/stop 退出程序，建議使用此方法退出MCL而不是直接點窗口的叉號，直接點叉號關(guān)閉會導致一些關(guān)閉時的存儲數(shù)據(jù)功能不被運行，會影響使用。

????????????另外/exit具有和/stop相同功能。

????????請注意: ????

????????1.所有指令單詞之間的空格不能缺少，請仔細檢查自己輸入是否有缺少。????

????????2.所有的指令輸入時不需要用“< >”或"[ ]"括起來，此處的括號表示這里是一個參數(shù)，被"< >"括起來的為必填參數(shù)，是指令的一部分，缺少則不能執(zhí)行；被"[?]"括起來的為選填參數(shù)，缺少這部分參數(shù)不影響指令。

????????例如我在輸入指令“/autoLogin add <account> <password> [passwordKind]”時，我要輸入的實際指令是“/autoLogin add 114514 awsl9961”，我必須輸入賬號<account>和密碼<password>，而[passwordKind]我不需要可以不填。

????????3.大小寫對于指令沒有影響，例如 /autoLogin 和 /autologin 是一樣可以執(zhí)行的。????

????????4.本文中涉及到命令行指令，在讀者親自執(zhí)行時，建議不要直接從文中復制，因為這樣雖然方便但是可能會造成意外的字符串輸入，認真手動輸入會避免一些的問題。

3.登錄賬號

????????到目前為止MCL雖然已經(jīng)啟動，但是沒有在運行任何賬號，接下來將介紹賬號登錄相關(guān)內(nèi)容。所有比較長的指令會用引號括起來表示以方便閱讀。

????????每次打開MCL等待其啟動成功后都可以用 “/login? qq號? 密碼” 這一指令執(zhí)行一次登錄，也就是說我每次打開之后可以通過輸入這個指令登錄，但是通常情況下我們會固定某一個賬號作為使用賬號，所以我們需要建立一個自動登錄以在運行MCL同時自動登錄免除輸入指令登錄。因此我們需要使用指令"/autoLogin add qq號 密碼?"來建立一個自動登錄，你可以在完成登錄之前或之后都能執(zhí)行此命令，但是請注意添加之后不會立即執(zhí)行登錄，而是在下次運行MCL時，而且不會檢查你的賬號密碼是否正確，所以填寫時請注意不要出錯，如果出錯了，使用指令"/autoLogin clear"清除之前的自動登錄并重新輸入一次。

????????例如要設(shè)置自動登錄qq號1145141919，使用密碼abc123則要輸“?/autologin 1145141919 abc123 ”，輸入完成之后即給MCL添加了自動登錄的設(shè)置，此時如果還沒有登錄，可以直接輸入?/stop 退出再重開MCL進行自動登錄。

? ? ? ? 登錄時會遇到一個難關(guān)，就是騰訊會讓你進行滑動驗證，即以下彈窗（如果沒有請忽略此部分步驟）：

? ? ? ? 首先，我要說明這個問題其實是一件非常令人頭疼而且難解的問題，而且這個問題很有可能不只會在首次登錄時出現(xiàn)，而是在以后的使用過程中反復出現(xiàn)。這個問題的官方解決辦法介紹文檔為https://github.com/project-mirai/mirai-login-solver-selenium，其中提到了3個辦法，而本著教會大部分人和減少篇幅的目的，我省略了適用于少數(shù)情況的非常復雜但是更通用的辦法。因為如果我要把上述方法介紹詳盡，會極大程度的增加篇幅，因此我默認所有的讀者：有一臺能上網(wǎng)能裝軟件的安卓手機。如果你沒有或者你是IPhone，那么非常抱歉，你需要自行閱讀上面的文檔并解決問題。另外，不要嘗試在 Android 模擬器上通過任何方式解決驗證碼。

? ? ? ?下面我來介紹最簡單的驗證辦法，使用這個辦法需要再額外在手機上安裝一個APP叫滑動驗證助手：TxCaptchaHelper，以減少我們的操作。

????????首先，下載滑動驗證助手TxCaptchaHelper，此處依舊列舉了多種下載方式：

????????????1.官方原地址：https://github.com/mzdluo123/TxCaptchaHelper/releases

????????????2.百度云：https://pan.baidu.com/s/1Oj_YYx-GQfiftDQOGMDcGQ?pwd=9297 提取碼：9297

????????????3.阿里云：啊這，阿里云說它不支持apk的文件分享。

????????下載完成并安裝這個app之后，我們就可以在這個app的幫助下完成登錄，具體操作為點擊登錄時彈窗出來的下圖這個按鈕（如果太久沒有處理可能使此次驗證會失效，點叉號關(guān)閉此窗口可以刷新新驗證）

然后在幾秒到幾分鐘內(nèi)就會出現(xiàn)4位的請求碼，此時我們打開手機app并輸入這四位數(shù)字

如果你在這里遲遲沒有顯示此提示，而是一直顯示”HTTP Response 429“，請過幾小時后重試

????????然后在app輸入請求碼并點擊下一步，然后進行滑動。

????????成功后之前的請求碼窗口會自動消失，至此我們順利完成了設(shè)備的滑動驗證，還要解決可能出現(xiàn)安全驗證的問題（如果沒有可以跳過）：

????????解決方法正如提示框中所說，我們需要打開安全驗證框中URL一行出現(xiàn)的連接，或者直接點擊提示框里的藍字設(shè)備驗證鎖，打開后為qq安全驗證界面，可能如下圖所示：

? ? ? ? 從上面的方式中選擇適合你的方式即可，其中qq掃描驗證需要用手機qq登錄當前賬號并掃描，賬號信息驗證需要填選一些賬號信息，選對了就可以。

????????顯示驗證成功后，關(guān)閉此網(wǎng)頁和Mirai之前那個登錄窗口，即可完成登錄！

????????如果在使用過程中，進行了滑動驗證但是仍然無法登錄登錄，出現(xiàn)了?code=237, title=安全提醒, message=當前網(wǎng)絡(luò)不穩(wěn)定 或者?code=235, title=溫馨提示, message=當前QQ版本 過低?紅字報錯，請前往教程的（下）篇，我會專門用一部分篇幅統(tǒng)一講解。

????????此時我們向機器人賬號發(fā)消息或者在機器人所在的群里發(fā)消息，機器人可以正常接收

????????那么至此，我們已經(jīng)完成了MCL的安裝教程。是的，盡管沒有任何功能，但是這個框架已經(jīng)能完美的運行在了我們的設(shè)備上，能正常收發(fā)消息，這就是一個qq機器人的內(nèi)核框架，如果比作一臺真正的機器人，他現(xiàn)在已經(jīng)可以運作了，只不過沒有任何功能，啥也不會做。為了實現(xiàn)我們想要的功能，我們需要給這個加裝更多的插件。

????????如果你看這篇文章的目的是明確知道自己接下來要安裝哪些功能插件，而且知道哪里能尋找并安裝更多插件，只是不解于MCL的安裝流程，那么對于你來說本篇教程到此為止已經(jīng)結(jié)束了。

????????而如果你還對于怎么用現(xiàn)在這個沒用功能的空白qq機器人沒有頭緒，或者想裝更多功能而不知道怎么做，那么接下來繼續(xù)看本教程的（中）篇或者以后的更新，我會繼續(xù)介紹插件安裝方法，繼續(xù)采用這種手把手的通俗教程，向大家介紹Mirai中的優(yōu)秀插件。讓你的qq機器人變得有趣、多功能。其中我已親自實現(xiàn)和使用過的功能有：每日知乎新聞速報、B站番劇速報；訂閱B站up動態(tài)、視頻發(fā)布、直播開播提醒；自定義回復消息；pixiv站相關(guān)：訂閱畫師/tag，查排行榜，以圖搜圖，根據(jù)tag搜澀圖；模擬手游（原神、方舟）抽卡；跑團骰子相關(guān)指令；機器學習群聊：學群友說話的電子鸚鵡（帶文字轉(zhuǎn)語音）；一大堆的表情包、梗圖生成器；自動批處好友申請加群申請，群發(fā)消息；天氣、日歷查詢；群聊天詞云生成；Minecraft服務(wù)器和群聊互通；反撤回閃照；定時隨機推送消息（瘋狂星期四）等；給群配置經(jīng)濟系統(tǒng)并加入小游戲、簽到等功能；甚至能接入NovelAI和OpenAI，讓你在qq群里就能AI畫圖跟使用AI聊天。當然這些僅僅是我用過的，并不能涵蓋插件平臺上所有作者的成果，只是如果有人對于其中的某些功能感興趣可以直接私信我了解。同時，在此向所有參與開發(fā)了Mirai的作者以及平臺上所有插件作者表示感謝?。?！

????????總之，教程的上篇到這里就結(jié)束了，非常感謝你堅持看到這里，初次投稿請多指教！