在 DeepSeek Harness（DSH）的使用场景中，除了命令行或 Web UI，直接通过即时通讯软件与 Agent 交互能带来更灵活的远程运维体验。dsh-messenger-gateway 正是为解决这一问题而生的插件，它充当了 DSH 与 Telegram 等平台之间的桥梁。
插件定位¶
由 GooDAnDReaREADY 维护的客户端插件，提供企业级多传输协议消息网关。它将 DSH Agent 接入 Telegram，支持交互式按钮、论坛主题和语音笔记等操作。
核心功能¶
- 传输协议支持：支持长轮询或 webhook 模式的 Telegram 机器人，同时提供 Discord 和 Slack 适配器。
- 会话隔离与管理：支持按用户或按聊天进行会话隔离，支持将论坛主题作为独立会话；提供会话导出、回溯和分支功能。
- 交互能力：提供快捷操作回复键盘、多选交互式表单（Checkbox）、Artifact 与 Mermaid 图表渲染。
- Agent 辅助：支持 Agent 角色与人设切换、工具与技能检查，并提供 Agent 工具
messenger_ask用于获取用户反馈。 - 文件与通知：提供工作区文件管理器、管理员警报通道、定时提醒以及入站 webhook 事件调度器。
- 语音功能：支持语音转文字和文本转语音（TTS），支持发送语音笔记（需依赖 ffmpeg）。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add @goodandready/dsh-messenger-gateway
安装后，在 DeepSeek Harness 的 Web 界面中进入“设置 → 插件 → Messenger gateway”进行配置：
- 启用 Telegram 适配器。
- 输入 BotFather 获取的 Bot Token（该字段为写/只读，用于保持当前 Token）。
- 设置允许列表或使用配对码进行授权。
如需使用 Discord 或 Slack 功能，需安装对应的辅助插件。
典型用法¶
在 Telegram 中通过以下指令进行操作：
/new- 新建会话/role coder- 切换 Agent 人设为 coder/files- 进入工作区文件管理/remind 15m Call client- 设置 15 分钟后的提醒- 配置 Discord/Slack 适配器 - 在设置面板中开启对应服务并填入 Webhook 或 Bot Token
适用场景与注意¶
该插件适合需要在 Telegram、Discord 或 Slack 上远程管理与 DeepSeek Harness Agent 交互的开发者或运维人员。
注意事项：
- 语音笔记依赖：语音笔记功能依赖
ffmpeg，否则系统会将其作为普通音频文件发送。 - 安全规范：Bot Token 属于 DeepSeek Harness 的秘密字段，切勿提交到版本控制。
- 辅助插件：Discord 和 Slack 适配器需要安装辅助插件才能正常工作。
- 运行环境：必须依赖 DeepSeek Harness 的 Web 配置环境。
该插件通过网关模式连接了主流即时通讯工具与 DeepSeek Harness，适合需要远程控制或多端协作的开发场景。
