折騰了一晚上總算把QQ大肥魚部署好了,記錄下踩坑點

作者:rym1020 發布時間:2026年10月24日 14:04

跟著“異世回憶”大佬的傻瓜版教程一步一步做,結果發現對不上,裝DSH和node.js都沒問題

首先是裝snowLuma,教程說裝完會彈出來掃碼登入QQ,我這沒有彈出,於是我手動啟動snowLuma,手動登入QQ,再手動開啟snowLuma的管理頁面http://127.0.0.1:5099/ 找到程序注入,載入我要控制的QQ

其次是安裝qq-bridge後的配置,教程說“找到 "allow" 下面的 "private",裡面有兩個數字,把不屬於你的那個換成她的號”,實際我這邊private裡面是空的,然後我自己寫了兩個QQ號進去,一個我的,一個她的,用半形逗號間隔開(後來發現這一步是多餘的,反而讓她只能跟我聊)

第3個坑是第6步拿SnowLuma的access_token,教程寫的:

· 回到 SnowLuma 那個介面

· 找到設定 / 配置相關的地方

· 裡面有一串很長的字母數字,叫"訪問令牌"或者

"access token"

· 複製它

· 貼上到 config.json 裡 "snowluma" 下面的 "accessToken"

實際完全對不上,它在“節點配置->HTTP API->編輯配置->鑑權”下面

《AI》實機截圖 1

《AI》實機截圖 2

《AI》實機截圖 3

這裡我搞了很久才明白,因為後面還有一個ws服務端,裡面也有token,我碰到其他問題後,以為是這裡取錯了,然後換ws服務端的token,結果越走越偏

第4個坑是啟動qq-bridge,教程說“裝完之後,qq-bridge 資料夾裡會有一個 啟動.bat。”

實際情況是安裝指令碼不會自動把原始碼資料夾裡的 啟動.bat 複製過去,我一直在原始碼資料夾“安裝.bat”那邊去點“啟動.bat”,結果一直說我沒安裝qq-bridge

《AI》實機截圖 4

第5個坑是DSH WEB沒有啟動起來

我確認我配置都沒問題,SnowLuma也能顯示我給監聽QQ發的訊息,但就是無法回應我,然後我看到config.json配置最前面有一個"baseUrl": "http://127.0.0.1:3080"

我把http://127.0.0.1:3080 複製到瀏覽器開啟,結果埠都不通,我也不知道咋回事,最後讓DSH給我修復

第6個坑是DSH WEB的authToken,由於第5個坑裡我DSH WEB壓根沒啟起來,我一開始不知道,以為是authToken沒配置,因為另一篇手動教程裡說到要配置好DSH 的API KEY,於是我去建立了API KEY,複製後填到authToken,結果更加不對了,DSH WEB啟動起來後還是無法通訊,最後找DSH,告訴我是錯的,根本不用填authToken,直接留空就好了

第7個坑是Watt ToolKit,之前我為了能正常開啟github和steam頁面,裝了這個加速器,結果我讓DSH給我去github上拉原始碼自己解決問題時,它總是連線失敗,這個坑作者自己也碰到過了,在手動教程裡有說到,但是傻瓜教程裡沒有寫

第8個坑是回覆訊息錯誤,要執行一次“node scripts/setup-dsh.mjs”,教程沒說怎麼執行,在哪裡執行,後面我自己搜檔名,才發現scripts/setup-dsh.mjs在qq-bridge安裝目錄下,我需要在這個目錄內執行cmd,再在cmd內執行“node scripts/setup-dsh.mjs”命令,到這一步大肥魚才終於能正常回應我的訊息了

第9個坑是配置allow.private裡面的QQ和群號後,反而給大肥魚限制了白名單,只能跟我指定的QQ交流,後來讓DSH給我改成放開,允許所有QQ和群裡回訊息

第10個坑是大肥魚無法跨對話記憶,你在群裡和她說的話,在私聊對話方塊裡她完全不知道,像是分身一樣,最後也是讓DSH給我改好了

現在基本能正常聊天了,接下來準備加聽發語音和寫日記功能