前言¶
DSH 的插件生态强调「一切皆插件」。社区目录是独立站点,并非官方应用商店。对 DSH / 智能体开发者来说,智能体能力常常需要在 IM 中直接使用,而不是只停留在命令行或 API 调试里。
shrekcg/dsh-im-channel 是一个 DSH 插件,把 DeepSeek Harness(DSH)接入飞书、钉钉、Telegram、Slack、Discord 等 IM 渠道,提供持久会话、真流式输出、斜杠命令和飞书对象工具。当前稳定可用的是飞书与 Telegram,钉钉/Slack/Discord 为实验性/半可用,QQ/微信/WhatsApp 未提供适配器。
这是什么¶
一句话定位:Multi-channel IM bridge for DeepSeek Harness: Feishu, Telegram, DingTalk, Slack, Discord — persistent sessions, true streaming, slash commands。
仓库 owner 为 shrekcg,许可证为 MIT。它以可插拔插件形态接入 DSH,支持一键安装/卸载,不侵入 DSH 核心。运行依赖 DSH、lark-cli 和 Node.js >=18。
核心功能¶
会话与渠道¶
- 持久会话:跨消息上下文记忆,使用 DSH
agents.resume。 - 话题隔离:每个话题拥有独立上下文。
- 群聊支持:支持群聊场景下的消息响应。
- 多账号多机器人:支持多机器人接入,session 自动隔离。
- 真流式输出:边生成边显示。
飞书对象工具¶
该插件通过 MCP 暴露 40 个飞书对象工具,工具名以 mcp__feishu__* 形式调用。
在飞书对话中,可以用自然语言调用这些工具,例如:
- 「帮我查一下今天的日程」
- 「创建一个文档,内容是……」
- 「给 XX 发一条消息」
- 「列一下我的待办任务」
消息能力¶
- 多媒体收发:图片/文件/音频/视频下载与发送。
- 合并转发识别与展开。
- 表情反馈。
- 文档评论中 @ 机器人触发对话。
斜杠命令¶
在飞书对话内可直接使用以下命令:
/help
/new
/clear
/compact
/model
/status
/state
/tools
/features
/doctor
资料中还提到可以使用 /channels 查看全部渠道及接入步骤,或使用 /channels add <渠道> 获取引导。
管理与诊断¶
- 初始化向导:
npm run setup。 - 诊断自修复:
npm run doctor,可用--fix自动修复。 - 功能清单:
npm run features。 - 权限管理:自动检测缺失权限,并生成一键申请链接。
- 内置 HTTP 状态页:
http://127.0.0.1:8899。 - DSH 设置页「插件」内新增 IM 机器人 tab。
渠道状态¶
- 飞书:完整支持,完整收发。
- Telegram:完整支持。
- Slack:半可用,接收需
@slack/socket-mode依赖。 - Discord:半可用,接收需
discord.js依赖。 - 钉钉:实验性,Stream 接入未完整实现,需
@alicloud/dingtalk-stream。 - QQ/微信/WhatsApp:未提供适配器。
安装与启用¶
前置依赖:
- DSH
lark-cli- Node.js >=18
资料中的安装说明使用 git clone 与 npm scripts:
git clone https://github.com/shrekcg/dsh-im-channel.git
cd dsh-im-channel
npm install
npm run setup
npm run install-bridge
npm run setup 用于初始化向导,npm run install-bridge 用于安装为插件并常驻运行。
安装完成后,可以启动并查看状态:
npm start
npm run doctor
npm run features
如需卸载:
npm run uninstall-bridge
npm run uninstall-bridge 是可逆操作,不影响 DSH 核心。
典型用法¶
1、私聊:直接在飞书单聊机器人。
2、群聊:拉机器人进群,直接发消息(或 @,取决于配置)。
3、话题:在群消息上创建话题,获得独立上下文。
4、自然语言调用飞书工具:例如「帮我查一下今天的日程」「列一下我的待办任务」。
5、斜杠命令管理:在飞书对话中使用 /help、/new、/compact、/model、/status、/tools、/features、/doctor。
6、查看渠道:在飞书里发 /channels 查看全部渠道及接入步骤,或 /channels add <渠道> 获取引导。
适用场景与注意¶
适合需要把 DSH 智能体带入飞书/Telegram 等 IM 场景的开发者或团队,尤其是希望使用持久会话、真流式输出、飞书对象工具和群聊/话题隔离的使用者。
使用前需要注意:
- 该插件以当前 DSH / 运行进程权限运行,安装前应检查源码、依赖与许可证。
- 渠道状态差异明显,正式使用建议优先选择飞书或 Telegram。
- 配置通过环境变量或
config.json,具体配置项需以仓库配置说明为准。 - 插件可调用飞书对象工具,可能涉及消息、文档、日程、任务等对象操作,应在可信账号和受控权限下运行。
结尾¶
shrekcg/dsh-im-channel 的价值,是把 DSH 的会话、工具调用和渠道接入放在同一个可维护的插件里,让智能体能力可以直接落在常用 IM 中。
已确认 GitHub 仓库:
- https://github.com/shrekcg/dsh-im-channel
目录页未在本次资料中确认,可按仓库名称在 DSH 社区插件目录中检索。