173787247/dsh-wsl-im

让 飞书 / 企微 / 钉钉 / QQ / Slack / Discord / Telegram 直接和 dsh 对话。

English → README.md

链路：IM → 本插件 → ctx.agents → 回 IM。

在套件里的位置

不在 install.sh 里。行为以厂商协议文档为准。

flowchart TB
  chats["飞书 / 企微 / 钉钉 / QQ / Slack / Discord / Telegram"] --> im["dsh-wsl-im"]
  im --> ws["每个 IM 一个工作区"]
  im --> agents["ctx.agents"]
  agents --> reply["回复回到该聊天"]

工作区是 ~/.dsh/im-workspace/{feishu,wecom,dingtalk,qq,slack,discord,telegram,mattermost}，插件启动时登记。一个聊天一条会话，不是整个平台共用一条。总图见 dsh-wsl-kit 中文说明。本插件是 0.3.7（可选，不在 install.sh）。

首批测试

适配器	模式	凭证
飞书	长连接	FEISHU_APP_ID / FEISHU_APP_SECRET + DSH_IM_FEISHU=1
企微	智能机器人 WSS	WECOM_BOT_ID / WECOM_BOT_SECRET + DSH_IM_WECOM=1
钉钉	Stream	DINGTALK_CLIENT_ID / DINGTALK_CLIENT_SECRET + DSH_IM_DINGTALK=1
QQ	官方 Gateway	QQ_APP_ID / QQ_APP_SECRET + DSH_IM_QQ=1
Slack	Socket Mode	SLACK_BOT_TOKEN / SLACK_APP_TOKEN + DSH_IM_SLACK=1
Discord	Gateway WSS	DISCORD_BOT_TOKEN + DSH_IM_DISCORD=1（可选 DISCORD_APPLICATION_ID）
Telegram	getUpdates 长轮询	TELEGRAM_BOT_TOKEN + DSH_IM_TELEGRAM=1（群 @ 建议设 TELEGRAM_BOT_USERNAME）
Mattermost	Outgoing Webhook + Bot REST	MATTERMOST_URL / MATTERMOST_TOKEN + DSH_IM_MATTERMOST=1
mock	本机 HTTP	DSH_IM_MOCK=1

飞书还需在 profile 里安装 @larksuiteoapi/node-sdk。

企微 WSS（openws.work.weixin.qq.com）在本机常需走 HTTPS_PROXY/HTTP_PROXY（ws 不吃 NODE_USE_ENV_PROXY）。同一 Bot 同时只能一条长连接——测 dsh 时请关掉挂着同一个 Bot 的其它客户端。Slack Socket Mode 同理（App 级 xapp- 开连接，Bot xoxb- 回信）。

Discord 需开 Message Content Intent；频道消息要 @ 机器人。Telegram 只用出站长轮询（无 webhook）；群聊在设置了 bot username 时需 @。

入站图片 / 文件（含 PDF）/ 语音 / 视频已与企微对齐：图片进视觉，PDF 用 pdftotext，语音只用平台转写（QQ asr_refer_text；多数渠道没有转写就落盘并请改发文字），视频只落盘、不抽帧。群消息需 @ 机器人（Slack 为 app_mention）。本机 WSL 直连这几家会超时，长连接和下载在设置了 HTTPS_PROXY 时走同一条代理。

每个 IM 单独一个工作区：~/.dsh/im-workspace/feishu、wecom、dingtalk、qq、slack、discord、telegram、mattermost。插件启动时会登记进 dsh 工作区列表，侧边栏显示为飞书、企微、钉钉、QQ、Slack、Discord、Telegram、Mattermost，不用手动添加。同一工作区里仍是一条聊天一个会话。旧会话留在上一级 im-workspace。

安装

# 跟踪默认分支，不要钉死 0.2.0
dsh plugin --profile web add github:173787247/dsh-wsl-im

Awesome： 条目草稿见 docs/awesome-entry.yml；仓库满 ≥1 天后再向 awesome-dsh-plugin 提 PR（CI 会卡年龄）。

source 环境变量后 restart-dsh-web.sh，新开会话。可用工具 im_status。

兼容性

字段	值
插件	dsh-wsl-im 0.3.8
最低 dsh	≥ 0.1.2（Web UI 一次性 ?token=，Windows 中继 :3081）
最新验证	以 dsh-wsl-kit 兼容性 为准（当前 0.2.0-rc.2）— 套件唯一真源
套件档位	可选（默认不在 install.sh / KIT_SET=daily）

License

MIT