dsh-qqbot 是 tencent-connect 組織維護(hù)的官方插件，作用是把 DeepSeek 助手接進(jìn) QQ 私聊與群聊。真正讓人卡住的往往不是安裝，而是裝完之后「怎么不理我」。這篇按「癥狀 → 定位 → 處置」的順序，把幾個(gè)高頻配置項(xiàng)過(guò)一遍。排錯(cuò)前先把三件事做了第一，確認(rèn)插件裝在了對(duì)的 profile 上，安裝和啟動(dòng)兩處命令的--profile名字必須一致，都用qqbot。第二，把debug打開(kāi)。debug默認(rèn)false，排查階段改成true，能看到更細(xì)的運(yùn)行日志；定位完記得關(guān)掉。第三，用內(nèi)置命令自證鏈路。/bot-help列出所有指令，適合先確認(rèn)機(jī)器人活著；/bot-ping做網(wǎng)絡(luò)延遲檢測(cè)，返回傳輸與處理耗時(shí)，能把「連不上」和「模型慢」分開(kāi)；/bot-status查看當(dāng)前會(huì)話狀態(tài)，用來(lái)判斷會(huì)話是否還在。這三條命令都無(wú)需額外配置。五個(gè)高頻坑：癥狀、定位、處置坑一 · 終端里二維碼是花的，掃不出來(lái)現(xiàn)象。首次啟動(dòng)進(jìn)入掃碼引導(dǎo)，終端打印的二維碼錯(cuò)位、變形，手機(jī)怎么都掃不到。原因。部分終端的字符寬度與二維碼渲染方式不一致，README 自己也提示過(guò)這個(gè)問(wèn)題。解決。升級(jí)到 0.4.0 以上版本（當(dāng)前 npm 上為 0.5.0），新版支持點(diǎn)擊鏈接在瀏覽器打開(kāi)二維碼；或換用等寬字符渲染正常的終端。坑二 · 裝了插件卻沒(méi)落到 qqbot profile現(xiàn)象。執(zhí)行完 add 命令，啟動(dòng)后仍像沒(méi)裝插件一樣。原因。安裝與啟動(dòng)兩處的--profile名字必須一致，一邊寫qqbot、