lijian-ui/dsh-im-gateway

README 摘要

@lijian-ui/dsh-im-gateway English 简体中文 为 DeepSeek Harness (dsh) 提供多 IM 通道接入的网关插件：钉钉 / QQ / 个人微信，支持扫码绑定与流式回复。 功能特性 - 统一网关服务 — 一个插件、三个通道。所有通道都汇聚到单一的 ctx.imGateway 核心：会话管理、斜杠命令、流式回复、状态广播。 - 钉钉 — 出站 WebSocket 长连接，群聊 + 单聊，@ 提及过滤， AI 卡片流式输出 （实时增量回复），斜杠命令。 - QQ — WebSocket 网关（官方 qqbot-nodejs SDK），私聊（c2c）+ 群聊， 扫码绑定机器人 （免去开放平台手动创建）， 流式消息 （c2c）。 - 个人微信（iLink） — 官方 iLink 长轮询协议， 扫码登录 + 配对码 ，仅单聊，媒体（AES-128-ECB CDN）收发。 - 多机器人实例 — 同一通道类型可配置多个实例（例如两个钉钉机器人），各自独立凭据。 - 内置斜杠命令 — /help 、 /model 、 /status 、 /new 、 /reset 、 /stop 等（见下文）。 - 设置页 UI — 在官方 dsh web UI 内渲染完整的设置页（「IM 通道」），扫码绑定就在这里完成。 - 流式回复 — 钉钉 AI 卡片、QQ stream messages；渠道不支持流式时自动回退纯文本。 安装 需要 DeepSeek Harness (dsh)——本插件是标准 dsh bundle ，通过官方插件通道安装。 从 npm 安装（推荐） npm 包自带预构建的 lib/ — 无需构建授权 （不需要 allowBuilds ）。 从 tarball 安装 从 GitHub 安装 Git 安装拉取的是 源码 ，首次安装需要批准包的 prepare 构建脚本（pnpm ≥ 10）。按提示把包键加进 profile 的 pnpm-workspace.yaml → allowBuilds 即可。优先用 npm / tarball 方式可跳过此步。 验证安装 快速上手 1. 打开 dsh web UI → 设置 → IM 通道 。 2. 点击 添加通道 。 3. 选择通道类型： - QQ ：点击 扫码登录 → 手机 QQ 扫码 → 凭据自动填入 → 保存。 - 个人微信 ：点击 扫码登录 → 手机微信扫码 →（如要求则输入配对码）→ 凭据自动填入 → 保存。 - 钉钉 ：手动填写 AppKey / AppSecret（或直接编辑配置文件）→ 保存。 4. 在 IM 客户端给机器人发消息 — 回复实时流式返回。 配置存储在 /.dsh/settings.yaml （ im-gateway.channels ）。在 UI …

分类