插件目录 / Developer / DSH-telegram
DSH-telegram
已验证 · 实测可装 yuko0331
功能简介
通过Telegram私聊远程使用和查看DSH
可用 — 实测通过,早期项目
通过Telegram私聊远程使用和查看DSH 实测能干净安装、正常启动。早期项目,但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
DSH Telegram Bot
通过 Telegram 私聊远程使用和查看 DeepSeek Harness。
功能
- 与 DSH 对话并接收回复
- 查看工作区和实时会话
- 在指定工作区创建会话
- 查看正在运行的任务
- 取消当前任务
- 仅允许一个指定的 Telegram 用户操作
安全说明
- 只接受配置的 Telegram 数字 User ID。
- 只接受私聊,不支持群聊控制。
- Bot Token 通过 DSH 凭据系统读取,不写入插件配置。
- Telegram 不能代替你批准敏感工具操作。
- 插件只能切换和控制自己创建的会话。
安装
从 GitHub 安装到 DSH Web profile:
dsh plugin --profile web add git+ssh://[email protected]/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 会话,不读取浏览器任务看板。- 插件重启后需要重新选择会话。
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 DSH-telegram」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:yuko0331/DSH-telegram Headless(CLI)profile:
dsh plugin --profile headless add github:yuko0331/DSH-telegram 实测报告
验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。
使用场景
扩展 agent 的编码能力面——给它一个新工具、工作流或集成,让它接手以前做不了的开发任务。
适合谁
想让 dsh 在真实代码库上像队友一样干活的开发者——能改、能跑、能验证,而不只是回答问题。
二次开发建议
工具/命令面就是缝:暴露更多 SDK 能力、加更聪明的上下文接线,或收紧改代码与验证之间的循环。