luzhengyangtx/dsh-telegram-duty

把 DeepSeek Harness（DSH）变成随身值班室：手机 Telegram 发消息 → 值班智能体干活 → 结果回复到手机。空闲时零 token（长轮询 getUpdates，消息到达才唤醒智能体）。

English

功能

• 📱 任务闭环：Telegram 消息 → 专属"值班会话"（带标准工具集）→ 最终回复回传手机；长回复自动分段。
• 🔐 白名单：只服务你自己的 chat id，其他人仅记日志。
• ✅ 全局审批转发：值守模式下，所有会话的审批都发到手机，带 [✅ 同意] [⛔ 拒绝] 按钮（点按钮即答，打字 3 同意 / 3 拒绝 仍兼容）；超时（默认 10 分钟）按拒绝处理（保守安全）。
• ❓ telegram_ask 提问工具：智能体需要您选择方案、确认事项或补充信息时，把问题推送到手机（每个选项一个按钮，点选即答）；值班智能体已被提示优先使用它。
• 🔀 值守/本地切换：手机发任意消息或 /away 进入值守；网页任意会话发消息或 /back 回到本地（本地模式审批走网页弹窗）。
• 🚩 值守横幅：值守期间网页顶部显示"审批已转到手机"横幅，一键切回本地。
• 🗂 持久化：消息游标与值守状态跨重启保持；仅首次运行跳过历史积压。
• 🌐 中英双语：所有手机消息跟随 language 配置（zh | en，默认 en）。
• 🌍 直连友好：默认直连 Telegram，无需代理（国内网络环境才需配置 proxy，见下表提醒）。

安装要点

1. 把本包放入 DSH checkout 的 packages/interaction/telegram-duty，pnpm install 后构建：

   node_modules\.bin\tsc.cmd -b packages/interaction/telegram-duty/tsconfig.json
   

2. 在 profile 补丁（如 C:\Users\<你>\.dsh\profiles\web\cordis.patch.yml）挂载：

   - insert:
       - id: telegram-duty
         name: '@luzhengyangtx/dsh-telegram-duty'
         config:
           token: '123456:你的机器人token'   # 或用 credentialsFile 指向 {token, chat_id, proxy} 文件
           chatId: 123456789
           language: zh
   

3. 重启 pnpm dsh web。

配置（telegram-duty 命名空间）

手机命令

/help、/away、/back；审批点按钮或回复 3 同意 / 3 拒绝（仅一条待批时直接回"同意/拒绝"）；提问点选项按钮或直接回复选项文字。

开发

pnpm --filter "@luzhengyangtx/dsh-telegram-duty" run typecheck
node_modules\.bin\vitest.cmd run packages/interaction/telegram-duty/tests
# 通道自检：$env:TG_CREDS='配置文件路径'; node --import tsx/esm packages/interaction/telegram-duty/scripts/check-telegram.ts

许可证

MIT。会话驱动模式（resume/create + summarize）参考 @kriskwok/dsh-feishu-gateway（MIT），见 LICENSE。