ThreeBody6666/dsh-im-hub 预览 preview

ThreeBody6666/dsh-im-hub

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

DeepSeek Harness的多平台IM网关:支持飞书(Lark)、企业微信(WeCom)和Telegram。每个聊天对应一个智能体,支持白名单访问,无需公网端点(飞书长连接/Telegram长轮询)。

Project Overview项目介绍

dsh-im-hub is a native DeepSeek Harness plugin that acts as a multi-platform IM gateway for DSH agents. It connects locally running DSH agents to three major messaging platforms: Feishu (Lark), WeCom (WeChat Work), and Telegram. To install the plugin from the npm registry, you run the command dsh plugin --profile im add dsh-im-hub, which automatically creates a dedicated headless im profile that loads the DSH base bundle and this plugin. After installation, you can boot the gateway with the command dsh --profile im to start accepting messages from your connected IM platforms.

Each chat session from an IM platform maps to a separate DSH agent session, which retains full conversation context and processes requests one at a time to avoid interleaved responses. Idle agent sessions are automatically disposed after a configurable timeout to save system resources. Every supported adapter supports an access whitelist that restricts which users can interact with the agent, and a mock adapter is included for testing without real IM platform credentials. It also includes built-in Slack-style commands like /help, /reset, /status and /model for users to manage their sessions directly from IM.

This plugin is released under the permissive MIT open source license. Before you can use it, you need to create custom applications in the developer portals of each IM platform you want to connect, then copy the generated credentials into the plugin's configuration. Configuration can be done either via a visual settings card in the DSH web GUI or manually editing the YAML config file. Only WeCom requires a public HTTPS endpoint for its callback, while Feishu’s default long connection mode and Telegram’s long polling do not need a public URL. Always set a user whitelist to prevent unauthorized access to your agent.

dsh-im-hub 是专为 DeepSeek Harness (DSH) 开发的原生多平台即时通讯网关插件,可将你的 DSH 智能代理连接到飞书(Lark)、企业微信和 Telegram 平台,让你直接在日常使用的 IM 应用中与 DSH 代理对话。安装可通过 npm 源执行 dsh plugin --profile im add dsh-im-hub 命令,完成后会自动创建一个名为 im 的无头配置文件,包含基础依赖 dsh-base 和该插件。

每个聊天会话对应独立的 DSH 代理会话,会保留完整对话上下文,单会话内请求按顺序处理不会交错,空闲超时后会自动清理闲置代理进程。支持对每个接入平台配置用户白名单控制访问,还提供了模拟适配器供开发者在没有真实平台凭证的情况下进行本地测试。适合需要在常用 IM 应用中随时调用本地部署 DSH 代理的用户使用。

该插件采用 MIT 开源许可证,使用前需要在各接入 IM 平台的开发者后台创建对应的自定义应用,获取凭证后填入插件配置即可。飞书支持官方长连接模式无需公网地址,Telegram 采用长轮询,仅企业微信需要配置公开的 HTTPS 回调地址。正式使用前务必配置用户白名单,防止未授权用户调用你的 DSH 代理执行工具。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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 im add dsh-im-hub

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

READMEREADME

dsh-im-hub

npm GitHub stars license npm downloads

English | 简体中文

A multi-platform IM gateway plugin for DeepSeek Harness (dsh): connect your dsh agent to Feishu (Lark), WeCom (WeChat Work), and Telegram, and chat with it from the messaging apps you already use.

One agent per chat. Multi-turn context. Whitelist access control. Idle reaping. No public endpoint required (Feishu long connection / Telegram long polling; WeCom uses an HTTP callback).

Highlights

  • Feishu (Lark) — official WebSocket long connection (/callback/ws/endpoint + protobuf frames, client-driven ping keepalive, 3s event ACK, message-id dedup), or webhook mode. No public URL needed for the default mode. The same adapter also serves the international Lark edition (open.larksuite.com) via adapters.lark.
  • WeCom (WeChat Work) — app message callback with full WXBizMsgCrypt AES-256-CBC decryption and SHA1 signature verification, plus active replies via the messaging API.
  • Telegram — Bot API long polling (getUpdates), automatic message splitting at the 4096-char limit.
  • Mock adapter — stdin + local HTTP endpoint for testing without any real platform credentials.
  • Per-chat agent sessions: conversation context is retained, each chat is serialized (no interleaved turns), and idle agents are disposed after a configurable timeout.
  • Whitelist enforcement (allowedUserIds) on every adapter; empty means everyone — set it in production.
  • Slack-style commands: /help, /reset, /status, /model.

Install

# From npm (recommended):
dsh plugin --profile im add dsh-im-hub

# From a Git repo or a local checkout (development):
dsh plugin --profile im add link:D:/projects/dsh-im-hub

This creates a headless profile im whose bundles are @deepseek-ai/dsh-base + dsh-im-hub. Boot it with:

dsh --profile im

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-browser-fs 下一个 Next dsh-cursor-codex →