@goodandready/dsh-messenger-gateway

中文文档
0.4.34发布于 2026/11/17MITES Module零依赖近 30 天下载 6634

Telegram messenger bridge for DeepSeek Harness: sessions, steer, homes, inline asks, notify bridge, and optional TTS voice notes.

原始使用文档
文档目录4 节
  1. DeepSeek Harness Telegram 专属网关(支持交互按钮调度、论坛话题隔离与语音条回复)
  2. ⚡ 插件概览
  3. 📦 安装指南
  4. 📄 开源协议

📦 @goodandready/dsh-messenger-gateway

DeepSeek Harness Telegram 专属网关(支持交互按钮调度、论坛话题隔离与语音条回复)

npm version license DSH Plugin Node version

作者全部项目

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明

⭐ 如果您喜欢这个插件,请在 GitHub 上为它点亮 Star — 这能让我知道插件对您有用,并鼓励我继续开发和维护它。

🐛 如果您发现 Bug 或希望增加功能,请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议,并在后续版本中实现有价值的改进。

⚡ 插件概览

dsh-messenger-gateway 为 DeepSeek Harness 智能体提供企业级 Telegram 接入桥梁。

除常规对话转发外,本插件全面打通了智能体深度交互能力:问答交互式内联按钮 (Inline Keyboard)、Telegram 论坛话题 (Forum Topics) 独立会话隔离、代理连接支持 (HTTP/HTTPS/SOCKS5 与自定义 apiRoot)、单用户工作区目录安全隔离、6 位配对码鉴权防护以及语音条朗读回复 (TTS)。

graph LR
    subgraph TelegramClient [Telegram 客户端 / 群组 / 话题]
        User[👤 用户 / 论坛话题] --> TG[Telegram Bot API 轮询 / Webhook]
    end

    subgraph GatewayCore [网关调度核心]
        TG --> Auth{配对码与权限校验}
        Auth -->|已配对用户| Router{话题与目录路由器}
        Router --> Home[独立工作目录: /homes/user_id]
        Home --> Thread[DSH 隔离会话上下文]
    end

    subgraph AgentLoop [DSH 智能体执行流]
        Thread --> Agent[智能体逻辑流]
        Agent -->|ask_question 工具调用| Ask[Telegram 原生内联交互按钮]
        Agent -->|语音回复合成| TTS[TTS 语音条消息下发]
    end

    subgraph Feedback [交互下发]
        Ask --> TG
        TTS --> TG
    end

    style TelegramClient fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
    style GatewayCore fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
    style AgentLoop fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
    style Feedback fill:#181825,stroke:#f38ba8,stroke-width:2px,color:#cdd6f4

📦 安装指南

dsh plugin --profile web add @goodandready/dsh-messenger-gateway

📄 开源协议

MIT © GooDAnDReaDY

版本与发布记录

@goodandready/dsh-messenger-gateway 共发布 52 个版本,首次发布于 2026/08/25;过去 12 个月发布了 52 个版本。

版本发布日期距今
0.4.34latest2026/11/17今天
0.4.332026/11/161 天前
0.4.322026/11/133 天前
0.4.312026/11/115 天前
0.4.302026/11/115 天前
0.4.292026/11/0313 天前

关于 @goodandready/dsh-messenger-gateway 的常见问题

@goodandready/dsh-messenger-gateway 是什么?

Telegram messenger bridge for DeepSeek Harness: sessions, steer, homes, inline asks, notify bridge, and optional TTS voice notes.

如何安装 @goodandready/dsh-messenger-gateway?

在项目目录运行 npm install @goodandready/dsh-messenger-gateway,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(^4.0.2)、@deepseek-ai/dsh-llm(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-agent(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-tools(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-session(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/schemastery(^3.18.2)、@deepseek-ai/dsh-settings(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-agent-loop(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-host-webserver(^0.1.7-rc.2 || ^0.2.0-rc.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@goodandready/dsh-messenger-gateway 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/goodandready__dsh-messenger-gateway 是否存在。

@goodandready/dsh-messenger-gateway 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@goodandready/dsh-messenger-gateway 可以商用吗?

@goodandready/dsh-messenger-gateway 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@goodandready/dsh-messenger-gateway 的下载量有多少?

根据 npm 官方下载统计,@goodandready/dsh-messenger-gateway 在 2026/10/17 – 2026/11/15 这 30 天内被下载 6,634 次,日均约 221 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@goodandready/dsh-messenger-gateway 还在维护吗?

最新版本 0.4.34 发布于 2026/11/17(今天);至今共发布 52 个版本,其中过去 12 个月发布了 52 个;首次发布于 2026/08/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。