AbcdefgXW/dsh-msg-hub
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 目录,不会被提交到代码仓库。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-msg-hub(AbcdefgXW/dsh-msg-hub)
仓库:https://github.com/AbcdefgXW/dsh-msg-hub
本站详情页:https://www.yhbd.top/plugins/abcdefgxw-dsh-msg-hub/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-09-18 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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
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-pushcordis 服务):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 →
xmanrui/dsh-im
tencent-connect/dsh-qqbot
flymysql/dsh-remote
whiteguo233/dsh-openbiliclaw
omdsh-dev/dsh-lark
hanshanyike/dsh-yolo
THEWOLFWALKER/dsh-notifier