todayer/todayer-dsh-telegram-bridge

DSH Telegram 桥接 (todayer)

用于 DeepSeek Harness (dsh) 的 Telegram 桥接（机器人）：直接在 Telegram 中管理本地会话、话题和媒体。基于 hi-wenw/dsh-telegram-channel，并扩展了来自 Hermes 智能体 Telegram 网关的机制。

快速开始： dsh plugin --profile web add github:todayer/todayer-dsh-telegram-bridge

功能特性

- 🧵 按聊天/话题独立会话 — 每个话题（论坛 / 私聊话题）都是独立会话；机器人的回复会落在同一话题中。
- 📌 话题 — message_thread_id，正确处理 General 话题（1），createForumTopic/editForumTopic/deleteForumTopic；自动将话题重命名为会话标题。
- 💬 私聊话题 (Bot API 9.4) — 在一对一聊天中直接创建话题，每个话题都是隔离的会话；根私聊大厅模式。（DSH_TELEGRAM_DM_TOPICS）
- 👥 群组门控 — require_mention、allowed_chats、allowed_topics、free_response_chats/topics、guest_mode、ignored_threads。
- 🖼 媒体收发 — 接收照片/视频/语音/文件/贴纸；通过 MEDIA:/path 标签原生发送文件。
- ⌨️ 命令 — /new /reset /stop /sessions /last /model /status /unbind /help。
- ✅ 状态指示器 在线/离线（setMyShortDescription）。
- 🛡 工具调用过滤器 —  绝不会泄漏到 Telegram。
- 🔥 轮询韧性（409 冲突 + 指数退避）。
- 🔘 选择/澄清 — ask_user_question → 内联按钮（当 userQuestions 可用时）。
- 🌐 双语 — 俄语和英语（设置 DSH_TELEGRAM_LANG=ru|en）。

安装

要求：Node ≥ 22、带模型的 dsh web，以及来自 @BotFather 的机器人。

本地安装（从本机）
dsh plugin --profile web add ./dsh-telegram-channel-local

从仓库安装
dsh plugin --profile web add github:todayer/todayer-dsh-telegram-bridge
或从 tarball 安装
dsh plugin --profile web add ./dsh-telegram-channel-0.3.5.tgz

配置（~/.dsh/telegram.env）

必填
DSH_TELEGRAM_TOKEN=123456789:AA...            # 来自 @BotFather
DSH_TELEGRAM_ALLOWED_USER_IDS=123456789        # 你的用户 ID（来自 @userinfobot）

可选 — 话题/群组
DSH_TELEGRAM_LANG=ru                           # ru | en
DSH_TELEGRAM_REQUIRE_MENTION=false
DSH_TELEGRAM_ALLOWED_CHATS=
DSH_TELEGRAM_ALLOWED_TOPICS=
DSH_TELEGRAM_FREE_RESPONSE_CHATS=
DSH_TELEGRAM_FREE_RESPONSE_TOPICS=
DSH_TELEGRAM_GUEST_MODE=false
DSH_TELEGRAM_IGNORED_THREADS=

私聊话题（JSON）
DSH_TELEGRAM_DM_TOPICS=[{"chatId":1212123,"topics":[{"name":"General"}]}]

状态指示器
DSH_TELEGRAM_STATUS_INDICATOR=1
DSH_TELEGRAM_STATUS_ONLINE=🟢 Online
DSH_TELEGRAM_STATUS_OFFLINE=🔴 Offline

将这些放入 dsh.service 的 EnvironmentFile 中并重启：
sudo systemctl restart dsh.service

机器人命令

| 命令 | 用途 |
|---|---|
| /start | 欢迎 / 帮助 |
| /sessions | 按工作区列出会话 + 附加 |
| /new | 创建新会话（强制新建） |
| /reset | /new 的别名 |
| /last | 绑定会话的最后一轮 |
| /model | 切换模型 |
| /status | 当前绑定 |
| /stop | 停止并解除绑定 |
| /unbind | 解除绑定（不删除） |
| /help | 完整命令列表 |

结构

lib/
bridge.js      — 核心逻辑（消息处理、主题、会话、命令）
client.js      — Telegram Bot API 客户端（轮询、文件、主题）
catalog.js     — 会话/工作区目录
commands.js    — 命令和消息（双语）
format.js      — 格式化/清理（含 stripToolCalls）
history.js     — “最后一轮”
index.js       — 插件注册（Config/inject）
...

许可证

MIT

起源

基于 hi-wenw/dsh-telegram-channel。机制参照 Hermes Agent 的 Telegram 网关进行了扩展。

Русский： README.ru.md