AbcdefgXW/dsh-msg-hub

Plugin插件 Native原生 ⭐ 5 MIT Notifications & Remote通知与远程

dsh IM渠道桥:微信/QQ/飞书接入 + 主动推送

Project Overview项目介绍

This is a native DSH plugin that acts as an IM channel bridge, connecting WeChat, QQ, and Feishu to DSH agent sessions. It can be installed three different ways: via npm package, directly from the GitHub repository, or manually cloning and linking to your DSH profile. The dsh plugin add command automatically adds the plugin to your profile’s bundles and handles registration, so no manual configuration edits are required. After installation, you will need to set up credentials for each IM channel you want to use, then restart your DSH web instance for changes to take effect.

Once set up, you can receive real-time updates about your DSH tasks directly on your mobile IM client, including task start, completion, errors, and approval requests. You can reply to approval requests directly from IM to approve or reject requests, with a 5-minute timeout that defaults to rejection for safety. You can also manage your bound sessions via IM commands to list recent sessions, bind new sessions, or check binding status. Third-party developers can extend the plugin with new IM channels using the built-in adapter registry, no core code changes are required. This plugin is ideal for users who want to remotely monitor and manage DSH tasks when away from their computer.

The plugin requires Node.js version 22.13 or newer to run, and all credentials are stored locally in a gitignored state directory so they will never be accidentally committed to code repositories. There are a few important security and usage notes to keep in mind: WeChat uses a third-party simulated protocol that carries account risk, so you should only use it for low-frequency pushes, ideally with a dedicated WeChat account. QQ requires you to request active message permissions from the Tencent Open Platform for active pushes to work, otherwise pushes will fail silently. Feishu uses the official API with no extra risk, and the whole project is released under the open MIT license.

这是一款专为 DSH 开发的原生 IM 渠道桥插件,支持将微信(ilinkai 模拟协议)、QQ(腾讯开放平台)、飞书(飞书开放平台)的消息接入 DSH 代理会话。它还支持主动推送功能,可用于定时任务等场景唤醒机器人,并将 AI 生成的回复回传到移动端 IM。同时提供远程任务监控能力,让用户离开电脑也能掌握任务状态。

用户可以通过该插件在移动端 IM 接收任务状态推送、远程审批代理请求,还能直接下发新任务给 DSH 代理执行。它支持对绑定的会话进行管理,可通过 IM 命令列出最近会话、绑定/解绑指定会话、查看当前绑定状态。第三方开发者还可以通过适配器注册表扩展添加新的 IM 渠道,无需修改插件核心代码。适合需要远程管理 DSH 任务、随时随地获取任务更新并操作的用户使用。

该插件要求 Node.js ≥ 22.13 版本,需要提前准备各 IM 渠道的有效凭证。微信使用 ilinkai 模拟协议存在账号风控风险,建议仅用于低频推送;QQ 主动推送需要提前申请主动消息权限,飞书使用官方 API 无合规风险。插件采用 MIT 许可证开源,所有凭证都保存在插件本地 state 目录,不会被提交到代码仓库。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-msg-hub

把 AbcdefgXW/dsh-msg-hub 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-msg-hub

English | 简体中文

License: MIT Node

dsh(DeepSeek Harness)IM 渠道桥插件:把微信(ilinkai)/ QQ(开放平台)/ 飞书(开放平台)的消息接入 dsh agent 会话,并支持主动推送(供定时任务等场景唤醒 bot 并把 AI 回复回传手机)。

功能

  • 📱 微信:ilinkai 模拟协议(扫码登录),收发文本 / 图片 / 语音
  • 💬 QQ:腾讯开放平台官方 WebSocket 通道,收发文本 / 图片 / 语音(C2C 私聊 / 群聊)
  • 📡 飞书:飞书开放平台官方 API(应用凭证),收发文本 / 图片 / 语音(P2P 私聊 / 群聊)
  • 🖼️ 图片与语音(三渠道均已支持):
    • 图片:下载后存到工作区 .im-media/<渠道>/<日期>/,会话里只带路径,由 agent 用 read_image 自行查看——dsh 原生支持图片输入,纯文本模型会自动降级;默认保留 7 天(DSH_MSG_HUB_MEDIA_KEEP_DAYS 可调)
    • 语音:转成文字后注入会话(模型听不了音频)。QQ 直接用官方给的 asr_refer_text(免费、即时、比自建更准),为空才回退自建 ASR
    • 微信语音:官方 CDN 下载 → AES-128-ECB 解密 → silk→WAV 转码(silk-wasm)→ 自建 ASR
    • 自建 ASR 需配置:state/asr.env 写 DASHSCOPE_API_KEY;未配置时语音自动跳过,不影响文本与图片
    • 清理策略:媒体按日期分目录,写入时每天最多清理一次超期文件
  • 🩺 诊断日志:state/logs/bridge-debug.log,内置大小轮转(默认 5MB × 3 份)与每日日志清理(默认 14 天),可用 DSH_MSG_HUB_LOG_MAX_BYTES / DSH_MSG_HUB_LOG_KEEP / DSH_MSG_HUB_LOG_KEEP_DAYS 调整
  • 🧩 主动推送服务(dsh-channels-push cordis 服务):
    • push({channel, peerId, text}):直接向 IM 发文本
    • task({channel, peerId, prompt}):唤醒渠道 agent 执行任务,AI 回复自动回传 IM
    • 供 dsh-toolbox-web 定时心跳等插件调用(未安装本插件时渠道推送自动不可用,不影响其他功能)
  • 📡 远程监控(离开电脑也能盯任务):
    • 审批远程批准:绑定会话的 agent 请求批准时推送到 IM(含工具名/原因/命令详情),回复「批准」或「拒绝」应答;5 分钟超时按拒绝处理(安全默认)
    • turn 状态推送:绑定会话的任务开始 / 完成 / 出错 / 被阻塞时实时推送
    • 会话命令:/sessions 列出最近 5 个会话(名称+ID)、/bind <会话ID> 绑定、/status 查看绑定状态

环境要求

  • dsh 运行时(cordis 插件,需在 dsh web profile 注册)
  • Node.js ≥ 22.13
  • 各渠道凭证:微信扫码 / QQ 开放平台 AppID+Secret / 飞书 AppID+Secret

安装

# 方式一:npm 包(推荐)
dsh plugin --profile web add dsh-msg-hub

# 方式二:GitHub 仓库
dsh plugin --profile web add github:AbcdefgXW/dsh-msg-hub

# 方式三:手动(本地开发/内网)
git clone https://github.com/AbcdefgXW/dsh-msg-hub.git
cd dsh-msg-hub && npm install
# 软链进 profile 并加入 bundles:
cd $DSH_HOME/profiles/web && pnpm link /路径/dsh-msg-hub
# 然后确认 package.json 的 dsh.profile.bundles 包含 dsh-msg-hub

dsh plugin add 会自动将本插件加入 profile 的 dsh.profile.bundles 并挂载插件自带的注册行(cordis.patch.yml),无需也不应手动修改任何配置文件。

⚠️ 排查注册问题时请检查 package.json 的 dsh.profile.bundles 是否包含 dsh-msg-hub;切勿再在 profile 的 cordis.patch.yml 里手动 insert 本插件——bundles 已挂载时手动 insert 会导致 duplicate loader entry id 启动崩溃。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-trace-insight 下一个 Next dsh-reasoning-settings →