luzhengyangtx/dsh-telegram-duty

dsh-telegram-duty

Turn DeepSeek Harness (DSH) into your always-on pocket duty office: message a Telegram bot from your phone, the duty agent gets to work, and the result comes back to your phone. Idle cost is zero tokens — the plugin long-polls getUpdates and only wakes an agent when a message arrives.

中文说明

Requirements

DeepSeek Harness ≥ 0.1.2-rc.1 is required. Since v0.5.0 the plugin reads session history through the session.snapshotEvents() API, which does not exist in 0.1.1-rc.2 and older (it was introduced in dsh-v0.1.2-rc.1). If you are on 0.1.1-rc.2 or older, stay on npm 0.4.0 — the latest version will fail to load there.

Quick Start (≈10 minutes)

1. Create a bot — chat with @BotFather, send /newbot, and copy the token (looks like 123456:ABC...).

2. Find your chat id — send any message to @userinfobot (or to your new bot) and read the numeric id.

3. Install the plugin — from inside a DeepSeek Harness checkout:

   dsh plugin --profile web add @luzhengyangtx/dsh-telegram-duty
   

4. Configure — add to C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml:

   - id: telegram-duty
     config:
       token: '123456:YOUR-BOT-TOKEN'   # step 1
       chatId: 123456789                # step 2 (whitelist)
       language: zh                     # or en
   

5. Restart dsh web and send any message to your bot from the phone. Done — the duty agent answers.

While on duty, the web UI shows a banner telling you approvals are forwarded to your phone, with a one-click switch back.

Features

• 📱 Task loop — Telegram message → dedicated "duty" DSH session (its agent has the standard tool set) → final reply back to Telegram; long replies are split under Telegram's message limit.
• ⏳ Instant feedback — every task message is acknowledged immediately ("📨 Received, generating…") and the phone keeps showing the "typing…" animation until the result arrives; errors report a clear "⚠️ Processing error".
• 🎯 Targeted sessions — /sessions lists your workspace sessions (live and offline, matching the web sidebar; blank drafts are hidden) with numbered buttons: tap one to route following messages there. Prefix one message with #N to send just that one to session N. /duty returns to the default duty route. Offline sessions are woken automatically on the first targeted message.
• 🔐 Whitelist — only your own chat id is served; other senders are logged and ignored.
• ✅ Global approval forwarding — in duty mode, approval requests from all sessions go to your phone with [✅ Approve] [⛔ Reject] buttons (tap to answer; typing 3 approve / 3 reject still works). Unanswered approvals time out to rejected (fail-closed, 10 minutes by default). /away warns when the web UI still holds unanswered approvals, and /unblock cancels turns stuck on them.
• ❓ telegram_ask tool — when an agent needs you to choose between options, confirm something, or supply missing information, it pushes the question to your phone with one button per option; the duty agent is prompted to prefer it.
• 📣 telegram_notify tool — any session's agent can proactively push a message to your phone (reports, reminders, notifications), no waiting required.
• 🔀 Duty / local toggle
  • Enter duty: send any phone message, send /away, or flip watchMode in the web settings.
  • Back to local: send any message in the web UI, or send /back.
  • In local mode approvals stay in the web popup; in duty mode the popup is paused.
• 🚩 Duty banner — while on duty, a frame-wide web banner shows "approvals are on your phone" with a one-click switch back.
• 📱 Sidebar duty button — a "Duty" action beside Settings opens the duty session in one click (creating/waking it when needed), with a live status dot (amber on duty, gray locally).
• 🗂 Durable — the getUpdates cursor and the watch mode persist across restarts; backlog is fast-forwarded on the very first run only.
• 🌐 English & Chinese — every Telegram message respects the language setting (zh | en, default en).
• 🌍 Direct-connection friendly — connects directly by default; configure proxy only when Telegram is blocked in your network (see the table below).