@goodandready/dsh-messenger-gateway
DeepSeek Harness 的 Telegram messenger bridge：会话、引导、homes、内联提问、通知桥接，以及可选的 TTS 语音消息。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @goodandready/dsh-messenger-gateway@0.4.2Messenger Gateway 以 @goodandready/dsh-messenger-gateway 发布，当前版本为 0.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明
|
⭐ If you like this plugin, please star it on GitHub — it shows me that the plugin is useful to you and motivates me to keep developing it.
🐛 If you find a bug or would like to request a feature, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version. |
dsh-messenger-gateway provides an enterprise-grade, multi-transport messaging gateway for DeepSeek Harness agents.
Talk to your Harness agent directly from Telegram: interactive keyboard buttons, forum topic sessions, private user workspaces, pairing codes, and optional spoken voice replies.
Talk to your Harness agent from Telegram: text, voice, photos, documents, inline buttons, named homes, and optional spoken replies.
sessionScope)/keyboard on|off)messenger_ask)/role coder, /role architect, @role tags in group chats)/skills, /tools)/export), turn rewind (/rewind), session branching (/fork)/files [dir]) and file download (/get <path>) with directory traversal protection/setalert, /alert)/remind <time> <text>, /remind list, /remind cancel)POST /dsh-messenger-gateway/events) for CI/CD and external alerts/stop, /new, /model, /status, /voice, /sethome, /homemessenger_ask (inline keyboard answers return to the agent)messenger.senddsh-voice), photos → vision (dsh-vision-bridge)dsh-tts); mp3 is converted to OGG/Opus via ffmpeg for Telegram voice notesDiscord and Slack adapters are available as outbound transports (Webhooks or Bot REST APIs).
dsh plugin --profile web add @goodandready/dsh-messenger-gateway
Then open Settings → Plugins → Messenger gateway:
| Plugin | Role |
|---|---|
@goodandready/dsh-voice | Transcribe inbound voice messages |
@goodandready/dsh-tts | Speak agent replies |
@goodandready/dsh-vision-bridge | Describe inbound photos |
They are not npm dependencies of this package — install them separately if you want those features.
Spoken replies use Telegram sendVoice. If TTS returns MP3 (or other non-Opus audio), the gateway runs ffmpeg (libopus) to produce OGG. If ffmpeg is missing or conversion fails, the audio is sent as a regular audio file instead of a voice note.
| Command | Description |
|---|---|
/start /help | Help |
/whoami | Your Telegram user id |
/new | New agent session |
/stop | Abort the current turn |
/model | Interactive 2-step model picker (providers → models) or /model <prov> <mod> |
/status | Gateway status and session counters |
/top | Live server resources: RSS/Heap memory, uptime, active chats, reminders |
/topic <name> | Create a new Telegram forum topic in supergroups and start an isolated session |
/role [name] | Switch agent persona (coder, architect, reviewer, writer, translator, concise) |
/skills /tools | List active agent tools and capabilities |
/fork | Fork current session into a new independent session |
/export | Export session dialogue history to Markdown |
/rewind [N] | Rewind last N conversation turns |
/files [dir] | Workspace file manager |
/get <path> | Download file from workspace |
/remind <time> <text> | Set a reminder (e.g. /remind 15m Call client) |
/setalert /alert | Configure admin alert channel and send test alert |
/keyboard on|off | Toggle quick actions reply keyboard |
/voice on|off | Per-user spoken replies |
/tts on|off|status | Per-chat spoken replies |
/sethome [name] | Bind current chat/topic as a named home |
In addition to Telegram, outbound messages can be dispatched to Discord and Slack via Webhooks or Bot APIs:
discord.enabled: true, provide either webhookUrl or botToken. Target channels via chatId: "<channel_id>".slack.enabled: true, provide either webhookUrl or botToken. Target channels via chatId: "<channel_id>" or threads via threadId: "<thread_ts>".messenger_ask — ask the user with inline buttons; choice is fed back into the turn/messenger/send, /messenger/ask, /messenger/progressctx.messenger for other pluginssessionScope: user (default) or chat — how group chats isolate sessionsvoiceMode: mirror / always / off — when to speak replies (also /voice)tts.enabled / tts.maxChars — TTS gate and length capnotifyBridge — forward non-messenger web session events to a homesettings.plugin.item on the Plugins tab (key: dsh-messenger-gateway).settingsScope.bind({ namespace: 'dsh-messenger-gateway' }) with snapshot status checking (loading, unavailable, ready).ffmpeg on the host PATHMIT
/home| List homes |