dsh-wsl-im
让 飞书 / 企微 / 钉钉 / QQ / Slack / Discord / Telegram 直接和 dsh 对话。
链路：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 |
| 官方 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
