dsh-qqbot 是 tencent-connect 组织维护的官方插件，作用是把 DeepSeek 助手接进 QQ 私聊与群聊。真正让人卡住的往往不是安装，而是装完之后「怎么不理我」。这篇按「症状 → 定位 → 处置」的顺序，把几个高频配置项过一遍。排错前先把三件事做了第一，确认插件装在了对的 profile 上，安装和启动两处命令的--profile名字必须一致，都用qqbot。第二，把debug打开。debug默认false，排查阶段改成true，能看到更细的运行日志；定位完记得关掉。第三，用内置命令自证链路。/bot-help列出所有指令，适合先确认机器人活着；/bot-ping做网络延迟检测，返回传输与处理耗时，能把「连不上」和「模型慢」分开；/bot-status查看当前会话状态，用来判断会话是否还在。这三条命令都无需额外配置。五个高频坑：症状、定位、处置坑一 · 终端里二维码是花的，扫不出来现象。首次启动进入扫码引导，终端打印的二维码错位、变形，手机怎么都扫不到。原因。部分终端的字符宽度与二维码渲染方式不一致，README 自己也提示过这个问题。解决。升级到 0.4.0 以上版本（当前 npm 上为 0.5.0），新版支持点击链接在浏览器打开二维码；或换用等宽字符渲染正常的终端。坑二 · 装了插件却没落到 qqbot profile现象。执行完 add 命令，启动后仍像没装插件一样。原因。安装与启动两处的--profile名字必须一致，一边写qqbot、
