九个渠道九种失败:IM Connect 连不上时怎么逐项排查 九个渠道九种失败IM Connect 连不上时怎么逐项排查IM Connect 把钉钉、飞书、Lark、企业微信、微信、QQ、Telegram、Discord、Slack 九个平台接到本机 DSH。九个平台就是九套凭据、九种连接模型、九类权限开关「连不上」至少对应九种失败。这篇不教点按钮只给速查路径先判断停在哪一层再按症状找判据最后落到修法。它是社区维护项目不是 DeepSeek AI 官方产品。失败只可能落在三层插件没跑、消息没进来、进来了但准入没过。三层之外没有第四层。安装基线先确认插件在跑dsh plugin--profile web add michengai/dsh-im-connectlatest--registryhttps://registry.npmjs.org/装完跑dsh --profile web --dump-config输出里要有im-connect。当前 npm 版本1.0.1engines要求node ^22.19.0 || 24.0.023.x 不在范围内。想对照同类插件的中文清单可以先看 DeepSeek Harness Hub 插件清单。装完必须重启dsh web并硬刷新浏览器否则「设置 → IM Assistant」不出现。先做连接诊断别靠猜设置页每个账号里有一个Diagnose connection。它把「平台 API 通不通」和「消息能不能进来」拆成两件事并且只查前者。按渠道分别查询微信查配置企业微信在已有连接上发 ping钉钉查凭据飞书与 Lark 查凭据和机器人身份QQ 查凭据与网关Telegram 查机器人身份与 Webhook 冲突Discord 查身份与 Gateway URLSlack 在连接已存在时查auth.test与 Socket Mode。每项给出 passed、failed、unverified 之一附耗时与下一步建议。两个细节不发测试消息不新开轮询。passed 只说明这条 API 通不说明你有发消息权限。后端较老时会提示重启 DSH 并刷新页面这条提示本身就是版本不一致的信号。坑一 · 版本闸门挡住插件配置却还留着现象。装上了dump-config里有im-connect但设置页没有入口或入口点不动、账号列表空白日志没有平台连接记录。原因。闸门只认四个宿主版本0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2推荐0.2.1-rc.2。0.2.1-alpha.1到alpha.5、稳定版0.2.0、0.2.0 之前的宿主全被拒。被拒时插件不跑但 profile 里已存的 IM 设置不会被删——这解释了为什么换宿主或降级后配置还在只是不起作用。解决。把宿主升到四个 rc 之一。必须留在0.1.x的别装latest装插件0.1.78。闸门拒绝不是安装失败重装没有意义。坑二 · 扫码成功人却没被批准现象。钉钉或企微扫码绑定成功账号在机器人也在线但手机发消息永远已读不回待批准列表里还找不到自己。原因。这两家的扫码只返回机器人凭据不返回用户身份。插件拿不到 userId就写不进白名单。微信、飞书、Lark、QQ 的扫码者会自动进白名单扫完即可对话——同样是「扫码成功」语义完全不同。解决。扫完去设置页的待批准列表手动批准自己。手动填 Client ID 与 Secret、Bot ID 与 Secret 的钉钉、企微、QQ 同理私聊全要批。缺 userId 的私聊直接拒绝连待批准都进不去。坑三 · Telegram 的长连接被 Webhook 抢走现象。Bot Token 填对诊断能查到机器人身份但发消息毫无反应日志里没有入站记录。原因。同一个 bot 的更新只能有一个消费者。开了 WebhookgetUpdates就取不到消息长连接收不到任何东西而诊断查的是身份接口身份通着冲突还在。解决。在同一个 bot 上关掉 Webhook回到长连接。诊断里有 Webhook 冲突项看到冲突先去BotFather侧清理再重连。坑四 · Discord 少了 Intent或者多了 Endpoint现象。两种私聊正常但频道里 它没反应或文字回复正常卡片按钮点了没动静。原因。前者是没开Message Content Intent不开就收不到消息正文。后者是配了Interactions Endpoint URL按钮点击走 HTTP 回调不再经 Gateway 到达插件。解决。门户里打开 Message Content Intent把 Interactions Endpoint URL 留空。频道首次 之后可在该消息线程里续话不必再 豁免只限机器人自己开的线程。按症状对号入座症状先查大概率是设置页没有入口dump-config与宿主版本没重启或闸门拒绝账号在、消息不进诊断的凭据与连接项平台开关或凭据消息进了、人不理待批准列表准入没批按钮没反应平台交互配置Discord Endpoint、Slack scope全 passed 但发不出消息权限单点通过不等于全权限表里最后一行常被忽略诊断不查 bot 有没有进群、app 有没有chat:writepassed 之后仍发不出就回平台侧看成员资格与 scope。风险口径也交代一下站点标注为 含敏感能力可执行外部命令、读写删除本地文件、写剪贴板不计风险、发起外部网络请求尚无人工评估站点未做风险分级。排错时别为了省事把权限开到最大再回头收。总结九个渠道的失败模式确实不同但判据能收敛成三层插件跑没跑、消息进没进、准入过没过想对照同类插件的中文清单见 DeepSeek Harness Hub 插件清单。适合与不适合适合同时用三四个 IM 平台、要在本机统一收口的团队常离开电脑但要远程派活的个人已在 0.2.x rc 宿主上、愿意跟版本走的用户要把 IM 会话与网页任务分开管理的人。不适合停在 0.1.x 又不想装 0.1.78 的人不能接受明文密钥落盘的团队需要多人私聊的人Discord 与 Slack 的 mpim 都不支持想让机器人在群里主动播报的人它只按 触发。标签DSH IM Connect、DeepSeek Harness、排错速查本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。