dsh bot 接入 QQ 不回复：DeepSeek Harness qq bridge 配置、同名插件与消息链路排查

「dsh bot 接入 QQ 不回复」最常见的根因不是配置，而是装错了插件。 dsh-bot 桥接的是 Telegram 与微信；QQ 要用 dsh-qq、dsh-qqbot，或支持 QQ 渠道的 dsh-im。

先纠偏：dsh bot 不是 QQ 插件

dsh-bot 的官方说明写得很清楚：它把 Telegram 与微信变成工作区入口。 里面没有 QQ 渠道（来源）。

所以「装了 dsh bot，QQ 没反应」不是故障。 插件根本没接 QQ，配置再对也不会有消息；先换插件，再谈排查。

同名与近名插件很多。 dsh-bot、dsh-qqbot、dsh-qq、dsh-im 名字接近，渠道不同；只搜「QQ 机器人」很容易装错，认 owner 与说明比认名字可靠。

三个能接 QQ 的插件怎么选

能接 QQ 的实现至少有三类，交互形态不同。 选一个装，不要叠加。

dsh-qq 偏「群里接话」。 它在本机 QQ 上收发消息，附带网页管理面板，并有默认限流；配置项与报错都能在面板里看到（来源）。

dsh-qqbot 偏「对话入口」。 你在私聊或群里直接跟 agent 对话、执行工具、管理会话；凭据与访问控制是配置重点（来源）。

dsh-im 偏「多渠道统一」。 它支持九种渠道的扫码或凭据接入，QQ 只是其中之一；如果你还要接飞书、微信等，选它更省事（来源）。

不要同时装多个 QQ 插件。 两个插件同时监听同一账号，容易出现抢消息、重复回复或只回一次；先卸载再换装。

配置链路：凭据、端口、白名单

QQ 消息不回复，配置问题占多数。 三类配置按顺序检查。

1. 凭据： 账号登录态、token 或二维码授权是否有效；过期后消息能到平台但到不了插件。
2. 端口与回调： 本地服务端口是否被占用、回调地址是否可达；端口冲突会让插件启动但收不到消息。
3. 访问控制： 允许的账号、群号与触发方式；未命中的消息会被静默忽略，看起来像「不回复」。
4. 限流： 默认限流在短时间多条消息时会丢弃；先看日志有没有限流记录，再调间隔。

静默忽略是最难发现的配置问题。 它不报错、不提示，只是不回；排查时先确认白名单与触发条件，再看模型。

凭据过期通常有迹可循。 重新扫码或重新登录后恢复，说明问题在凭据；完全没反应，才继续查端口与插件加载。

不回复的四段排查

把消息链路拆成四段，逐段确认。 哪一段断了，问题就在哪一段。

1. 消息到达： 平台侧有没有收到消息？用另一个客户端或小号发一条，看插件面板有没有记录。
2. 插件加载： 当前 profile 是否装了对应插件？dsh plugin --profile web list 是否在列，系统日志有没有加载失败。
3. 权限与访问控制： 发送者、群、触发方式是否在允许范围？被排除的消息不会进入 agent。
4. 模型响应： 前三点都正常但不回，看会话里有没有请求、模型是否报错或超时。

四段的顺序不能反。 先查模型，会把「插件没装」误判成「模型坏了」；先查消息到达，能快速排除一半问题。

每段都要留证据。 面板记录、系统日志、会话记录各一份；只凭「我发了」无法判断断在哪。

三种典型现场

同样是「不回复」，三种现场的原因不同。 对照现象直接定位。

1. 私聊不回、群里也不回： 多半是插件没加载或凭据失效；先看列表与登录态，再看端口。
2. 私聊正常、群里不回： 多半是访问控制或 @ 触发条件；确认群号在允许列表、触发方式与预期一致。
3. 只回一次就沉默： 多半是限流或会话锁；看日志里的限流记录，调间隔或等待冷却。

「只回一次」最容易被误判为模型崩溃。 模型崩溃通常伴随报错或超时，限流则是静默丢弃；两者在日志里表现完全不同。

群聊还有一个额外变量：是否需要 @。 有的实现只在被 @ 时触发，有的对所有消息响应；配置前先确认预期，否则会把「没 @」当成「不回复」。

验证与回滚

修完配置，按三步验证；不行就回滚到上一版配置。

1. 单条验证： 用一个允许的账号发一条最简单消息，确认有回复。
2. 群聊验证： 在目标群按触发方式发一条，确认群内回复正常。
3. 连续验证： 连发三条，确认限流与冷却符合预期，不是只回第一条。

回滚比继续调更快。 改了三处配置仍不稳定时，回到上一版可用配置，再一次只改一处；多变量同时改，永远不知道是哪一处生效。

验证记录要留下。 哪个账号、哪个群、什么触发方式、结果如何；下次出问题可以直接对照。

下一步

先确认插件对不对，再按四段排查。 想了解 IM 桥接插件的整体分工，看《DeepSeek Harness 怎么接入微信、QQ 和飞书》；想配置通用 IM 接入，看《DSH plugin 怎么接入 IM 工具》；想了解 dsh bot 本身，看《dsh bot 是什么》。

来源：dsh-qq 插件页、dsh-qqbot 插件页、dsh-im 插件页、dsh-bot 插件页