前言¶
DSH 生态里，插件可以扩展 DSH 的入口和能力。对智能体开发者来说，常见需求之一是：DSH 会话已经在运行，但人不一定在电脑前，想用手机快速查看工作区、创建会话、看任务状态，或者直接取消当前任务。
dsh-telegram-bot 是 yuko0331 维护的 DSH 插件，MIT 许可证。它通过 Telegram 私聊提供一组受限的远程入口，用于和 DSH 对话、查看会话与任务状态，并在配置允许的范围内控制当前 DSH 会话。
这是什么¶
dsh-telegram-bot 的定位是：通过 Telegram 私聊远程使用和查看 DeepSeek Harness。
它不是群聊机器人，也不是完整替代 DSH Web 界面的移动端。它更像是一个受白名单限制的远程终端入口：只接受配置的 Telegram 数字 User ID，只支持私聊，只处理文字消息，并通过长轮询与 DSH 交互。
核心功能¶
已核实的能力包括：
- 与 DSH 对话并接收回复
- 查看工作区和实时会话
- 在指定工作区创建会话
- 查看正在运行的任务
- 取消当前任务
- 仅允许一个指定的 Telegram 用户操作
其中几个使用边界比较关键：
- 只接受私聊，不支持群聊控制
- 只支持文字消息和长轮询
- 不支持群聊、语音、文件和按钮操作
- 插件只能切换和控制自己创建的会话
/tasks显示正在运行的 DSH 会话，不读取浏览器任务看板- Telegram 不能代替用户批准敏感工具操作
- 插件重启后需要重新选择会话
安装¶
把插件安装到 DSH Web profile：
dsh plugin --profile web add git+ssh://git@github.com/yuko0331/DSH-telegram.git
安装前建议先检查 GitHub 仓库中的源码、行为说明和 MIT 许可证。它会以当前 dsh 进程具备的权限工作，因此命令能力、会话控制和任务取消都应放在你信任的环境中使用。
配置¶
启用前需要准备两样东西：Bot Token 和管理员数字 User ID。
- 在 Telegram 中联系
@BotFather，执行/newbot创建 Bot，并取得 Bot Token。 - 通过
@userinfobot等机器人查询自己的 Telegram 数字 User ID，例如123456789。 - 打开 DSH 的设置页面：
设置 → Telegram
- 填写 Bot Token 和管理员数字 User ID。
- 打开“启用 Telegram 机器人”。
- 保存并应用。
Bot Token 通过 DSH 凭据系统读取，不写入插件配置。Bot Token 只写入 DSH 凭据系统，页面和接口不会读取或返回 Token 明文。
不要把 Token 发到聊天中，也不要提交到 Git。
典型用法¶
启用后，向这个 Telegram Bot 的私聊发送命令：
| 命令 | 用途 |
|---|---|
/help |
查看帮助 |
/workspaces |
查看工作区 |
/new <工作区ID> |
创建并选择会话 |
/sessions |
查看实时会话 |
/use <会话ID> |
切换机器人创建的会话 |
/status |
查看运行状态 |
/tasks |
查看正在运行的任务 |
/stop |
取消当前任务 |
发送其他普通文本，会进入当前 DSH 会话。
首次使用时，可以按这个顺序：
/workspaces
/new <工作区ID>
你好，请检查当前项目状态
先查看工作区，再创建并选择一个会话，最后发送普通文本进入当前 DSH 会话。
适用场景与注意¶
这个插件适合需要移动端远程查看和操作 DSH 单用户会话的场景，例如：
- 查看当前有哪些工作区
- 创建一个新会话
- 查看正在运行的 DSH 会话
- 取消当前任务
- 在手机上继续当前 DSH 对话
它不适合当作群聊协作入口、文件传输通道、语音交互入口，也不适合把 Telegram 当作敏感工具操作的最终批准层。敏感操作仍应按照 DSH 自身的安全机制处理。
另外，插件重启后需要重新选择会话；如果之前已经通过 /new 创建并选择了会话，重启后不要假设当前会话还保留着上下文选择状态。
结尾¶
dsh-telegram-bot 的价值在于给 DSH 增加一个受控的 Telegram 私聊入口：只允许一个指定用户、只支持文字消息、只处理私聊场景，并能覆盖对话、工作区、会话、任务状态和取消任务这几个常用操作。
如果你需要在手机上远程查看和操作 DSH 会话，可以从这个插件开始验证；使用时请确认自己接受它的单用户、私聊、文字消息和会话切换边界。
GitHub：
https://github.com/yuko0331/DSH-telegram
