前言¶
DeepSeek Harness (DSH) 是一个基于插件的智能体开发框架。传统的交互方式多依赖桌面端或 Web 界面。dsh-telegram-bridge 插件提供了一条通往 Telegram 的通路，允许你通过手机或通讯软件直接与 DSH Agent 进行对话、调用技能或管理文件。
核心功能¶
该插件主要提供以下能力：
* Telegram ↔ dsh Agent 对话：支持私聊或群组内 @ 机器人交互。
* 访问控制：默认仅白名单可用，防止陌生人滥用。
* 工作目录浏览器：在 Telegram 内通过 /cwd 命令浏览、切换目录。
* 技能调用：查看可用技能并执行。
* 图片与文件收发：支持多模态图片交互及文件传输。
安装与启用¶
在 DSH 的 Web Profile（或其他 Profile）中安装：
- 进入 Profile 目录（例如
~/.dsh/profiles/web）。 - 执行安装命令：
pnpm add dsh-telegram-bridge
- 修改
package.json文件，在dsh.profile.bundles数组中添加"dsh-telegram-bridge"。 - 重启 dsh 服务。
配置步骤¶
完成安装后，需要完成以下配置才能使用。
1. 获取 Bot Token¶
在 Telegram 中找到 @BotFather，发送 /newbot 创建机器人，获得 Token（格式为 123456789:AA...）。
2. 配置 Token¶
有两种配置方式：
* 可视化配置：在 dsh 设置页的插件配置中，找到 Telegram Bot 桥接，在 Bot Token 输入框粘贴 Token，点击测试连接并保存。
* Credentials 配置：在 ~/.dsh/.credentials.yaml 中添加：
refs:
DSH_TELEGRAM_BOT_TOKEN: "你的token"
3. 配置访问白名单¶
为安全起见，必须配置访问白名单。
* 允许的用户名：填入你的 Telegram 用户名（不带 @），多用户用逗号分隔。
* 允许的聊天 ID：可选，填入群组 ID 或私聊 ID。
4. 代理设置（可选）¶
如果需要通过代理访问 Telegram，在配置页填入代理地址，格式如：
http://127.0.0.1:7897
留空则直连。
常用命令¶
Bot 支持以下命令进行控制：
/new- 重置当前会话/topic <名称>- 切换命名子会话/cwd- 浏览/切换工作目录/skills- 列出可用技能/skill <名称> [参数]- 调用技能/model [provider model]- 查看/切换模型/status- 当前状态/stop- 停止当前回合
安全注意事项¶
该插件以当前 dsh 进程的权限运行，涉及文件系统操作，请务必注意以下安全边界：
- 工作目录边界：Bot 会话的 Agent 拥有工作目录的读写能力。切勿将 Bot 白名单开放给不信任的人，以免造成文件系统风险。
- 群组白名单：若在
allowed_chat_ids中填入群组 ID，该群内所有成员均可与 Bot 对话。 - 公网暴露：测试连接接口无鉴权。不要将 dsh Web 直接暴露到公网且不做访问控制。
- 文件安全：Bot 收到的文件保存在
<工作目录>/telegram-inbox/。
结语¶
dsh-telegram-bridge 通过 Telegram 实现了 DSH Agent 的远程控制与移动端接入。它通过白名单机制保障了基本的访问安全，适合需要在手机端快速调用 Agent 技能或查看工作目录的开发者。
