DeepSeek Harness Messenger: Telegram 通讯桥接插件

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。开发者若要在 DSH 的智能体流程中加入即时通讯能力，通常需要自行编写适配器或维护独立的 Bot 系统。DeepSeek Harness Messenger 是一个连接 DeepSeek Harness 与 Telegram 的桥接插件，由 syncended 维护。它将 Telegram 的消息流接入 DSH 的会话与工具体系，让用户可以直接通过 Telegram Bot 与 DSH 的智能体交互，实现会话管理、任务下发与状态通知。

核心功能¶

插件通过 DSH Web Settings 中的 Messengers 页面进行配置，使用 DSH 的凭据存储来管理 Telegram bot-token，支持无需重启 Host 即可实时重新配置。

会话管理与仪表板
插件提供 Telegram 原生命令菜单和内联按钮控制面板，用于管理当前会话。它支持列出并恢复持久化的顶层 DSH 会话，在创建新会话时允许选择已注册的 DSH workspace。会话绑定是持久的，支持跨 Host 重启和实时重新配置。仪表板使用 DSH workspace 显示名称，避免使用晦涩的会话哈希。
交互与控制
插件支持模型选择、推理控制、权限预设、上下文监控、转向和取消等操作。ask_user_question 工具支持交互式选择、多选和自由文本回答。界面提供 Claude 风格的动画进度、打字活动、流式消息编辑和工具状态显示。
多媒体处理
支持将 Telegram 照片或文档作为 DSH 图像提示，保留字面标题。支持本地 Whisper 按需转录 Telegram 语音消息。提供 messenger_send_image 工具，允许智能体通过显式工具调用发送生成的图像文件。
传输适配
插件实现了共享的 MessengerAdapter 接口，目前以 Telegram Bot API 为初始传输，为 Yandex Messenger、Discord 等未来传输预留了扩展能力。

安装与依赖¶

插件依赖 DSH 的核心运行时环境。在安装前，需确保本地环境包含以下 peerDependencies：

{
  "@deepseek-ai/cordis": "^4.0.2",
  "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-attachment": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-api-session-control": "^0.1.2-rc.1"
}

典型用法¶

命令操作¶

在 Telegram 中发送以下命令来控制会话和仪表板：

/start 或 /menu：打开仪表板。
/sessions：列出最近持久化的顶层 DSH 会话。
/resume [session-id]：恢复会话（可使用按钮选择，或直接指定 ID）。
/new：创建并绑定新会话（需选择 workspace）。
/status：刷新仪表板。
/model：选择模型。
/reasoning：选择推理努力程度。
/permission：选择权限预设。
/context：查看上下文压力、构成和累计使用量。
/steer <text>：向当前回合发送引导。
/cancel：请求取消当前回合。
/unbind：移除当前绑定（保留通知）。
/notifications [on|off]：订阅或取消 Host 级别的自动化通知。
/help：显示命令帮助。

图像处理¶

发送图像：在 /resume 或 /new 后，直接发送 Telegram 照片或 PNG/JPEG/WebP/GIF 文档（可带标题）。系统会下载最大尺寸版本，作为 DSH 附件存储。图像限制为 20 MiB。
- JPEG/PNG 文件小于 10 MiB 使用 sendPhoto，更大文件或 GIF/WebP 使用 sendDocument。
接收图像：图像进入 DSH 会话历史，可用于后续模型处理。
发送生成图像：智能体在响应中使用 messenger_send_image 工具发送文件。例如：

{
  "file_path": "output/chart.png"
}

该工具会将文件发送到当前授权的聊天中。

适用场景与注意¶

适用场景：需要通过 Telegram 远程管理 DSH 会话、接收 Host 级别的自动化通知、进行多轮对话交互，或利用 Telegram 的多媒体能力进行图像提示的智能体开发。
注意：
- 下载仅在授权的聊天或操作员且已选择会话时开始。
- 图像传输有 20 MiB 限制和有界下载超时。
- 发送操作在出错或取消后不会自动重试。
- /notifications 订阅独立于会话绑定，无需 /resume 或 /new 即可启用。
- 通知交付不会切换当前选定的会话；仅用于订阅。

该插件通过统一的适配器接口降低了多平台集成的复杂度，为 DSH 插件生态提供了标准的通讯能力。