dsh-im 是什么？把飞书微信等九种 IM 机器人接入 DeepSeek Harness

dsh-im 是 DeepSeek Harness（DSH）的 IM 机器人接入插件：一个「设置 → IM机器人」入口，统一管理飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp 九种 IM 渠道和 AI Office Connector，每个渠道还支持接入多个机器人。 本文介绍 dsh-im 是什么、核心功能、完整的安装更新卸载命令、典型用法与常见排错，帮你用日常 IM 工具直接驱动 Harness。

dsh-im 是什么？

dsh-im 解决「IM 机器人接入分散、本机 Harness 无法被公网访问」的问题：通过扫码、App Manifest 或已有机器人凭据把 IM 机器人接入 DeepSeek Harness，并让本机 Harness 主动连接公网 AI Office。 以下定位与事实均来自官方 README（来源）：

dsh-im（GitHub 仓库 xmanrui/dsh-im）由 xmanrui 维护，MIT 协议开源。它不修改 DeepSeek Harness 的核心行为，而是在一级设置菜单中注册一个「IM机器人」页面：飞书、微信、钉钉、企业微信、QQ 支持扫码或凭据绑定，Slack 用预置 App Manifest，Telegram、Discord 用 Bot Token，WhatsApp 扫码关联设备。每个渠道可接入多个机器人，连接状态、工作区和会话绑定彼此独立；AI Office Connector 让本机无需公网 IP、端口转发或 WebSocket 服务就能被公网 Office 调用。它是 DSH Plugin 生态里开箱即用的 IM 接入插件，界面支持中英文。

dsh-im 的核心功能有哪些？

核心能力围绕「九渠道接入、多机器人管理、流式回复、图片与文件回传、AI Office Connector、机器人命令集」六件事展开，一个设置页全部覆盖。 以下能力均来自官方 README（来源）：

• 九种 IM 渠道：飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp，接入方式覆盖扫码、App Manifest、Bot Token 与凭据绑定。
• 多机器人独立管理：每个渠道可接入多个机器人，凭据、连接状态、工作区、Agent Preset 与会话映射彼此独立，互不影响。
• 流式回复与进度提示：飞书流式卡片、钉钉 AI Card、企业微信原生「正在思考中」、Telegram 富消息预览，按平台能力增量显示回答。
• 图片与文件回传：九个渠道均支持 JPEG/PNG/WebP 图片与以图片文件发送的 GIF，单张 5 MB、单条 20 MB；文件以渠道原生附件回传。
• AI Office Connector：本机 Harness 主动连公网，无需公网 IP、端口转发或 WebSocket；心跳鉴权 + SSE 下行流，支持任务拉取、90 秒租约、人工审批与断线重连。
• 机器人命令集：/models、/model、/reasoning、/preset、/stop、/steer、/workspace、/session、/history、/repair 等 20+ 命令。

怎么安装与启用 dsh-im？

安装用一条 npm 命令装进 DeepSeek Harness Web profile，重启 dsh web 后打开「设置 → IM机器人」，按内置引导扫码或填凭据即可接入。 安装、更新与卸载命令均来自官方 README（来源）：

1. 安装：推荐从 npm 安装稳定版：

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

2. 启用：重启 dsh web 并刷新浏览器，打开「设置 → IM机器人」，在对应渠道页面扫码或填写凭据。Secret 与 Token 只提交给本机 Host，写入受保护的凭据存储。

3. 更新：在「IM机器人」页右上角点「检查更新」，或手工执行以下命令（update 到最新版）：

# update to latest
dsh plugin --profile web add -w @xmanrui/dsh-im@latest

安装完成后手动重启 Host 生效，页面显示「已安装，待手动重启」。

4. 卸载：从 Web profile 移除：

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

dsh-im 典型用法

装上后，在 IM 应用里直接和机器人对话就能驱动 Harness：日常问答、切换模型与推理等级、绑定已有会话、切换工作区，都通过聊天命令完成。 以下命令示例均来自官方 README（来源）：

1. 直接对话拿流式回复：在飞书、微信等私聊中发送普通消息，机器人按平台能力流式显示思考、工具进度和最终回答。

2. 查看并切换模型：发送 /models 列出全部可用模型，再发送 /model 2 切到列表第 2 个：

/models
/model 2

也可以直接指定精确 ID：/model deepseek-official/deepseek-v4-pro max。

3. 切换推理等级：/reasoninglist 查看，/reasoning 2 切换，/reasoning --default 恢复默认：

/reasoninglist
/reasoning 2
/reasoning --default

4. 切换 Agent Preset 与工作区：/presetlist 后 /preset 2 为机器人选第 2 个 Preset；/workspace 切到指定目录：

/presetlist
/preset 2
/workspace /Users/alice/projects/my-app

5. 绑定已有 Harness 会话续聊：/sessionlist 列出工作区会话，/session <Session ID> 绑定，/history 查看最近历史：

/sessionlist
/session session-id
/history 5

6. 停止任务与补充指令：/stop 立即停止当前任务并保留排队消息；/steer 把补充指令加入运行中的任务：

/stop
/steer 只检查配置文件

dsh-im 常见问题与排错

最常见的 dsh-im 问题集中在四个地方：设置页找不到 IM机器人、飞书权限不足、Telegram 连不上 Bot API、更新后显示待重启。 以下排错要点均来自官方 README（来源）：

1. 设置页没有「IM机器人」入口：症状 = 安装后找不到入口；原因 = 未重启或未刷新浏览器，插件页面已不再保留旧入口；解决 = 重启 dsh web 并刷新浏览器，打开「设置 → IM机器人」。

2. 飞书下载图片或文件权限不足：症状 = 无法下载用户消息中的图片或文件；原因 = 应用缺少 im:message:readonly、im:resource 或卡片回调权限；解决 = 私聊发送 /repair 或在设置页点「补全权限」，扫码增量补全。

3. Telegram 提示无法访问 Bot API：症状 = 绑定 Token 时提示连不上；原因 = 本机无法直连 Telegram Bot API，或代理配置不对；解决 = 使用 Node 22.21+，启动 dsh web 前设置 NODE_USE_ENV_PROXY=1、HTTPS_PROXY=http://proxy:8080、NO_PROXY=localhost,127.0.0.1，改完重启 Host。

4. 更新后仍显示「已安装，待手动重启」：症状 = 更新完页面提示待重启；原因 = 更新器不会自动重启；解决 = 手动重启 Host/Desktop，再点「刷新状态」重新读取 Host 状态，运行版本以 Host 报告为准。

适用场景与注意

dsh-im 适合所有想用日常 IM 工具驱动 DeepSeek Harness 的人：手机上随时问答、团队群里协作、从公网远程让本机 Harness 干活。 以下场景与限制均来自官方 README（来源）：

• 适用场景：在手机上用飞书、微信随时与 Harness 对话；团队在群里 @ 机器人获取任务结果；用 AI Office Connector 从公网发起远程任务并人工审批；把 Telegram、WhatsApp 白名单限定给可信联系人。
• 注意事项：机器人聊天消息跟随 Host 的 language 配置，默认中文，设为 en 即为英文；Telegram 群聊默认仅在提及或回复时响应，安全模式需配置数字 User ID 白名单；WhatsApp 默认仅响应自聊；Slack 桌面端若原生 Slash Command 拦截 / 命令，加前导空格发送；飞书文件 30 MB、QQ 每日配额等平台限制；Secret 与 Token 只提交本机 Host 并写入受保护凭据存储。

项目链接

dsh-im 是 xmanrui 维护的 MIT 开源项目。

插件详情：dsh-im 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：xmanrui/dsh-im。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。