DSH plugin 怎么接入 IM 工具？DeepSeek Harness 即时通讯集成配置

DeepSeek Harness 接入 IM 工具，靠的是即时通讯集成类 DSH plugin——把对话与通知接到飞书、微信、钉钉等渠道，例如 dsh-im 支持九种渠道的机器人并统一管理多机器人连接（来源）。 这篇讲清这类插件能干什么、凭证与 profile 怎么配、收发不通怎么查、以及如何关闭卸载。

DSH plugin 概览：IM 集成的三层结构

IM 集成类插件干的事，是在 DeepSeek Harness 与 IM 平台之间架一条通道。 三层结构先摆清：

一句话：IM 平台放行、插件连通、框架加载，三者缺一都不通。

IM 集成这类 DSH plugin 能干什么：把对话与通知搬进即时通讯

它的价值是把 DeepSeek Harness 的能力接到你已经在用的 IM 里，而不是让你多开一个系统。 主要能力：

1. 多渠道路由 — 一个插件管理多种 IM 渠道的多个机器人（来源）。预期：不必为每个渠道装一套。
2. 扫码或凭据接入 — 支持两种配置方式，降低填参数的门槛。预期：按手边条件选更省事的那种。
3. 统一连接管理 — 多个机器人的连接状态集中查看。预期：哪条断了能一眼看到。

和「特定外部工具对接」要分清：像《WorkBuddy 对接》讲的是接某一个具体外部工具，本篇的 IM 集成是「即时通讯这一类」的通用配置，两者主题不同。

DSH plugin 配置路径：装插件、填凭证、定 profile 与权限

配置分四步：选渠道 → 装插件 → 填凭证 / webhook → 定 profile 并重启。 步骤：

1. 在 IM 平台侧准备机器人 — 到对应平台创建机器人或应用，拿到 Bot Token、应用密钥或 webhook。预期：拿到可用的接入凭据，并开通收发消息权限。

2. 装集成插件 — 到 DSH Plugin Hub 按 IM、即时通讯、机器人等关键词找实现，或执行：

   bash

   dsh plugin --profile web add @xmanrui/dsh-im
   

   预期：插件进入 web profile，安装无报错。

3. 填凭证 / webhook — 打开插件配置，按渠道填入上一步拿到的凭据；能扫码的渠道可直接扫码。预期：配置能保存，且被写入凭据文件而非散落在明文里。

4. 确认 profile 与权限 — 确保装在正在使用的那个 profile，并核对机器人所需权限已授权。预期：插件与宿主版本兼容、权限足够。

5. 重启生效并自测 — 重启 dsh web，在 IM 里给机器人发一条消息。预期：能收到回复，说明链路打通。

--profile web 的语义很直接：装进哪个 profile，就只影响那个环境（来源）。多 profile 时务必确认装对了地方。

DSH plugin 常见问题与关闭 / 卸载

收发不通按顺序查，关闭则先断连接再卸载。 排查与清理步骤：

1. 插件是否加载 — 去已安装列表确认插件在列，并已重启服务。预期：插件出现在列表、启动日志无解析错误。
2. 凭证是否有效 — 核对 Token / 密钥是否过期、写错，webhook 是否被平台重置。预期：换成有效凭证后能收发。
3. 网络是否可达 — 确认本机能访问对应 IM 的开放接口，代理没有拦掉请求。预期：连通性正常。
4. 权限是否授权 — 检查机器人在 IM 侧是否被授予收发消息的权限。预期：权限补齐后消息能送达。
5. 要关闭 / 卸载时 — 先在插件配置里关掉连接，再到已安装列表卸载，随后重启。预期：插件移除、界面入口消失；再到 IM 侧停用机器人或 webhook，避免残留推送。

IM 集成本质也是装插件、管插件——与其在多个仓库之间手动找包和记命令，不如用插件市场统一下载与管理：DeepSeek Harness 的 DSH Plugin Hub 把浏览、一键安装、卸载、更新检测与系统日志放在一处，每次安装前都有确认弹窗，装完能在已安装列表里集中管理。

使用 DSH plugin 的注意事项

以下几点是把这枚 DSH插件（DeepSeek插件）接进 IM 前要记住的。 逐条如下：

1. 凭证当密码看：Bot Token、webhook 只填给可信插件，别贴进聊天或公开仓库。
2. profile 要对齐：装错 profile 是「装了却不生效」的高频原因。
3. 权限最小化：只授予收发消息所需的权限，别一股脑全开。
4. 重启才生效：配置与插件更改在重启后加载。
5. 卸载要收尾：插件卸载后到 IM 侧删机器人、停 webhook、吊销旧 Token。

来源：dsh-im（dsh-plugin.org）、dsh CLI README、dshplugin/dsh-plugin-hub