前言¶
DeepSeek Harness（DSH）把代码编辑、工具调用和 Agent 编排都收敛在本机进程里，开发者坐在终端或 Web UI 前就能驱动一整套智能体工作流。但现实沟通往往发生在飞书群、微信私聊、Telegram 频道或 Slack 线程里——同事随手 @ 你问一句，客户在手机端抛来一张截图，如果 Harness 只能守在本地界面，协作链路就会断在「还要切回电脑」这一步。
社区插件 dsh-im（维护者 xmanrui，npm 包名 @xmanrui/dsh-im）正是为解决这类「本地 Harness、远端聊天」的错位而生：通过扫码、App Manifest 或机器人凭据，把九大 IM 渠道统一接到本机 DSH，并在 Harness 设置页里集中管理。插件在 SkillHub 插件库 归类为「客户端」，GitHub 开源仓库截至核实日约 789 star（MIT 许可证）。需要说明的是，SkillHub 是面向中国用户的 DSH 插件社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 本身秉持「一切皆插件」理念，具体能力以各插件仓库与目录页说明为准。
这是什么¶
dsh-im 的定位可以概括为：在本机 DeepSeek Harness 中注册一个「IM 机器人」设置入口，统一管理飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp 九个内置渠道，以及可选的 AI Office Connector（让本机 Harness 主动连接公网 Office，无需公网 IP 或端口转发）。
每个渠道都支持接入多个机器人，各机器人的凭据、连接状态、工作区、Agent Preset 与会话绑定彼此独立。用户发来的 Secret、Token 只提交给本机 Harness Host，写入受保护的凭据存储；设置页接口不会回传这些敏感字段。
核心功能与亮点¶
九渠道统一接入¶
| 渠道 | 典型接入方式 | 消息特点（摘要） |
|---|---|---|
| 飞书 | 扫码创建或 App ID + Secret | 长连接 + 流式卡片展示思考与回答 |
| 微信 | 微信扫码绑定 | iLink 长轮询，长回复按 1800 字符分段 |
| 钉钉 | 扫码或 Client ID + Secret | Stream 长连接 + AI Card 流式 |
| 企业微信 | 扫码或 Bot ID + Secret | WebSocket，原生「思考中」与流式回答 |
| 扫码或 AppID + AppSecret | WebSocket，群聊 @ 后回复 | |
| Slack | Manifest + Bot/App Token | Socket Mode，支持官方流式 API |
| Telegram | @BotFather 的 Bot Token | 长轮询，支持私聊白名单安全模式 |
| Discord | Developer Portal Bot Token | Gateway，@ 后创建 Thread 流式编辑 |
| 手机扫码关联设备 | Web 长连接，多种访问模式可选 |
除文字外，九个渠道均支持向 Harness 发送 JPEG、PNG、WebP 及以图片文件形式发送的 GIF（单张上限 5 MB，单条消息图片合计上限 20 MB），并可附带文字说明。Harness 生成的文件也可按各平台能力回传为原生附件。
机器人命令与会话管理¶
插件在聊天侧提供较完整的命令集，无需打开 Web UI 即可操控会话，例如：
/help：查看命令列表/new：解除当前聊天会话绑定，下一条消息开启新 Session/status：检查机器人与 Harness 的连接状态/models、/model：列出并切换模型与推理等级/presetlist、/preset：为当前机器人选择 Agent Preset/workspace、/sessionlist、/session：切换工作区或绑定已有会话/stop、/steer：停止任务或向运行中任务追加指令
Telegram 可为每个机器人切换「兼容模式」与「私聊白名单安全模式」；WhatsApp 支持「仅自己」「指定联系人」「开放响应」等访问策略，避免机器人被无关消息触发。
AI Office Connector¶
「AI Office」页让本机 Harness 通过 Device Token 主动连接公网 Office：心跳鉴权后建立 SSE 下行，接收 job.available 拉取任务、续租执行，并把工具审批等问题回传到 Office 人工面板。适合「办公室在云端、算力在本地」的混合部署，而不必把本机暴露到公网。
安装与启用¶
插件要求 Node.js >= 22.19。推荐从 npm 安装已发布稳定版：
dsh plugin --profile web add -w @xmanrui/dsh-im
安装完成后重启 dsh web，在 Harness 中打开 「设置 → 插件 → IM机器人」，按渠道引导扫码或填写凭据。
若要试用 GitHub 上尚未发布到 npm 的最新代码，可使用仓库提供的安装器：
npx -y github:xmanrui/dsh-im install
GitHub 源安装会直接拉取并构建 Git 依赖；pnpm 10 及以上可能需先在 profile 的 pnpm-workspace.yaml 中允许该依赖执行构建脚本。普通用户建议优先使用 npm 稳定版。
网络提示： 本机访问飞书需走代理时，可在启动 dsh web 前设置 HTTPS_PROXY（如 http://proxy:8080）并重启 Host。Telegram Bot API 若无法直连，需 Node.js 22.21+，并启用 NODE_USE_ENV_PROXY=1 配合 HTTPS_PROXY / HTTP_PROXY。
典型用法示例¶
以最常见的「扫码接入 + 私聊对话」为例，流程如下：
- 执行上述安装命令并重启
dsh web。 - 进入「IM机器人」设置页，在左侧选择目标渠道（如飞书或 Telegram）。
- 按页面提示扫码创建应用，或手动填入平台颁发的 App ID / Bot Token。
- 在机器人卡片上确认工作区路径与 Agent Preset（新机器人默认使用 Host 当时的工作目录）。
- 在手机或桌面客户端向机器人发送普通消息，即可触发 Harness 会话；需要换话题时发送
/new。
切换模型可先 /models 查看序号，再 /model 2；切换推理等级可用 /reasoninglist 与 /reasoning 2。飞书用户若权限不全，可在私聊中发送 /repair 增量补全卡片回调与图片读写权限。
在线时还可点击机器人卡片上的「检查连接」，向最近私聊发送一条连接测试消息（不创建 Session、不调用模型）。
适用场景与注意事项¶
适合谁用：
- 希望把本机 DSH Agent 接到团队日常 IM，减少「复制粘贴到终端」的摩擦；
- 需要在飞书、钉钉、企业微信等国内平台与 Telegram、Slack 等海外平台之间统一一套 Harness 能力；
- 本地算力 + 云端 Office 协同，希望通过 AI Office Connector 领取远程任务。
使用前务必知晓：
- 权限边界：插件以当前
dsh进程的权限运行，能访问的工作区、工具和文件与 Host 一致。安装前应阅读 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。 - 命令即能力：能向机器人发消息的用户，通常也能执行
/workspace、/session等命令，可能触及本机其他项目路径或会话。请只向可信用户开放机器人，并合理配置 Telegram / WhatsApp 访问模式。 - 平台差异：各 IM 对文件大小、流式展示、群聊 @ 规则要求不同，README 中有逐渠道说明；部分能力（如飞书图片下载）需额外租户权限。
- 局域网暴露：若在可信局域网对外提供 Web profile，可在
cordis.patch.yml中将rpcAuthority设为trusted-host；这复用 Harness 的 Origin 防护，不是用户认证，仅适用于可信网络。
小结¶
如果你已经用 DeepSeek Harness 搭好了本地智能体，却苦于它「只能坐在电脑里」，dsh-im 用一套设置页把九大 IM 和 AI Office 接到同一 Harness 上：扫码或凭据即可上线，多机器人、多工作区、流式回复与丰富命令让聊天软件变成 Agent 的前台。不妨从 npm 稳定版装起，在飞书或 Telegram 里发一条 /help 试试。
