shrekcg/dsh-im-channel:为 DSH 接入飞书等 IM 的统一桥接插件

前言

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 社区插件目录中检索。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye