DSH Telegram Channel (todayer)

Мобильный Telegram-канал (бот) для DeepSeek Harness (dsh): управляйте локальными сессиями, топиками и медиа прямо из Telegram. Основан на hi-wenw/dsh-telegram-channel и расширен механизмами Telegram-гейта агента Hermes.

Быстрый старт: dsh plugin --profile web add github:todayer/todayer-dsh-telegram-channel

---

Возможности

• 🧵 Сессии per chat/topic — каждый топик (форум / DM-topic) = отдельная сессия; ответы бота уходят в ту же ветку.
• 📌 Топики — message_thread_id, корректная отправка в General (1), createForumTopic/editForumTopic/deleteForumTopic; авто-переименование топика по заголовку сессии.
• 💬 DM Topics (Bot API 9.4) — топики прямо в личке, каждый = изолированная сессия; лобби-режим корня. (DSH_TELEGRAM_DM_TOPICS)
• 👥 Гейтинг групп — require_mention, allowed_chats, allowed_topics, free_response_chats/topics, guest_mode, ignored_threads.
• 🖼 Медиа-вход/выход — приём фото/видео/голосовых/файлов/стикеров; нативная отправка файлов по тегам MEDIA:/путь.
• ⌨️ Команды — /new /reset /stop /sessions /last /model /status /unbind /help.
• ✅ Статус-индикатор Online/Offline (setMyShortDescription).
• 🛡 Фильтр тулов — <tool_calls> не утекают в Telegram.
• 🔥 Поллинг-устойчивость (конфликт 409 + экспоненциальный backoff).
• 🔘 Choice/clarify — ask_user_question → инлайн-кнопки (при доступном userQuestions).
• 🌐 Русский текст всех сообщений бота.

Установка/подключение

Требуются: Node ≥ 22, dsh web с моделью, бот от @BotFather.

# с этой машины (локально)
dsh plugin --profile web add ./dsh-telegram-channel-local

# из репозитория
dsh plugin --profile web add github:todayer/todayer-dsh-telegram-channel
# или 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        # ваш user id (от @userinfobot)

# опционально — топики/группы
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":"Общее"}]}]

# статус-индикатор
DSH_TELEGRAM_STATUS_INDICATOR=1
DSH_TELEGRAM_STATUS_ONLINE=🟢 Online
DSH_TELEGRAM_STATUS_OFFLINE=🔴 Offline

Пропишите в EnvironmentFile сервиса dsh.service и перезапустите:

sudo systemctl restart dsh.service

Команды бота

Команда	Назначение
/start	Справка
/sessions	Список сессий по рабочим областям + прикрепление
/new	Создать новую сессию (force-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. Механика расширена по мотивам Telegram-гейта Hermes Agent.