Tools & Capabilities

dsh-telegram

yuko0331/dsh-telegram · ★ 4

yuko0331

Telegram interface for chatting with DSH, viewing workspaces and live sessions, creating sessions, monitoring or cancelling tasks, and restricting access to one designated user.

README body is shown in Chinese.

License
MIT
Added
2026-08-23
Maintenance
active
Install kind
github

No manifest check is available; listing does not imply compatibility or security review.

安装

dsh plugin --profile web add github:yuko0331/dsh-telegram

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. 功能
  2. 安全说明
  3. 安装
  4. 配置
  5. 1. 创建 Telegram Bot
  6. 2. 获取 Telegram User ID
  7. 3. 在设置中启用
  8. 使用
  9. 开发验证
  10. 当前限制

通过 Telegram 私聊远程使用和查看 DeepSeek Harness。

功能

  • 与 DSH 对话并接收回复
  • 查看工作区和实时会话
  • 在指定工作区创建会话
  • 查看正在运行的任务
  • 取消当前任务
  • 仅允许一个指定的 Telegram 用户操作

安全说明

  • 只接受配置的 Telegram 数字 User ID。
  • 只接受私聊,不支持群聊控制。
  • Bot Token 通过 DSH 凭据系统读取,不写入插件配置。
  • Telegram 不能代替你批准敏感工具操作。
  • 插件只能切换和控制自己创建的会话。

安装

从 GitHub 安装到 DSH Web profile:

dsh plugin --profile web add git+ssh://git@github.com/yuko0331/DSH-telegram.git

也可以安装本地仓库:

dsh plugin --profile web add /Users/yuko/xxcode/dsh-telegram-bot

确认插件已经加入配置:

dsh --profile web --dump-config

输出中应包含 telegram-bot。

配置

1. 创建 Telegram Bot

在 Telegram 中联系 @BotFather,执行 /newbot 并取得 Bot Token。

不要把 Token 发到聊天中,也不要提交到 Git。

2. 获取 Telegram User ID

通过 @userinfobot 等机器人查询自己的数字 User ID,例如:

123456789

3. 在设置中启用

安装插件后重启一次 DSH Web,然后打开:

设置 → Telegram

填写 Bot Token 和管理员数字 User ID,打开“启用 Telegram 机器人”,再点击“保存并应用”。页面提供连接状态和“测试连接”。

Bot Token 只写入 DSH 凭据系统,页面和接口不会读取或返回 Token 明文。启用状态和管理员 User ID 存入 DSH 设置。之后修改、停用或重新连接都会立即生效,不需要重启 DSH。

未配置或未启用 Telegram 时,DSH Web 会正常启动。

使用

向 Telegram Bot 私聊发送:

命令 用途
/help 查看帮助
/workspaces 查看工作区
/new <工作区ID> 创建并选择会话
/sessions 查看实时会话
/use <会话ID> 切换机器人创建的会话
/status 查看运行状态
/tasks 查看正在运行的任务
/stop 取消当前任务

发送其他普通文本,会进入当前 DSH 会话。

首次使用:

/workspaces
/new <工作区ID>
你好,请检查当前项目状态

开发验证

pnpm install
pnpm run check

pnpm run check 会执行类型检查、测试和构建。

当前限制

  • 只支持文字消息和长轮询。
  • 不支持群聊、语音、文件和按钮操作。
  • /tasks 显示正在运行的 DSH 会话,不读取浏览器任务看板。
  • 插件重启后需要重新选择会话。