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