前言¶
DeepSeek Harness（DSH）把 Agent、工作区和会话都收在本机进程里，日常多在 Web UI 或终端里操作。若你已经在用 Telegram，却希望在路上也能选同一工作区、续同一会话、把图片和文件丢给 Agent，单独搭一套转发服务往往要和 DSH 的会话模型对齐，维护成本不低。社区插件 dsh-telegram（维护者 IgnatAi401）做的是 Telegram Bot 与 DSH 之间的桥：私聊机器人即可对话，并与 Web UI 共享工作区和会话，而不是另起一套孤立上下文。
这是什么¶
dsh-telegram 是 DSH 的 Telegram 机器人插件，分类为「客户端」。它支持命令行版（Linux / WSL2 / macOS）和桌面版，基于 DeepSeek Harness v0.2.1-rc.3 开发，通过 DSH 自带的插件机制安装（当前 package 版本 0.3.1，许可证 BSD-3-Clause）。插件用 long polling 等方式把 Telegram 私聊 relay 到 DSH 会话，并支持富消息与 inline 菜单。
核心功能¶
以下能力均来自项目 README 与 package 描述，可按需选用：
- 与 Web UI 共享：在 Telegram 里选工作区、新建/打开/归档会话，与桌面或浏览器里的 DSH 使用同一套工作区与会话数据。
- 多模态输入：私聊中可直接发送文字、图片或文件，进入 Agent 对话流程。
- 交互式操作：通过
/menu选择工作区、管理会话、切换模型与推理强度；/help查看可用命令。 - 访问控制：仅支持私聊；在插件设置中配置允许的用户 ID（多个用逗号分隔），未授权用户无法使用。
- 设置页优先：Bot Token 与允许用户 ID 可在 Web UI「插件 → dsh-telegram」中填写并保存后立即生效；旧版写在
~/.dsh/.env的TELEGRAM_BOT_TOKEN、TELEGRAM_ALLOWED_USER_IDS仍有效，但设置页中的值优先。
安装与启用¶
安装前，命令行版请先停止正在运行的 DSH。命令行环境需要 Node.js 22.19+ 或 24+（与 package.json 中 engines 一致）。
Linux / macOS / WSL2 命令行或桌面版（脚本会分别探测本机安装位置）：
curl -fsSL https://raw.githubusercontent.com/IgnatAi401/dsh-telegram/main/install.sh | bash
macOS 上若桌面版正在运行，脚本会自动退出 App，安装完成后再重新打开。命令行版若提示找不到 dsh，桌面版用户可先在 App 菜单「管理 dsh 命令…」中安装 CLI。
Windows 桌面版：在 App 的「插件」页点「添加插件」，填入 github:IgnatAi401/dsh-telegram 安装。Windows 上的命令行版请在 WSL2 中按上文 curl 方式安装。
若只需针对某一运行配置安装或卸载，可在命令末尾指定配置名，例如：
curl -fsSL https://raw.githubusercontent.com/IgnatAi401/dsh-telegram/main/install.sh | bash -s -- install desktop
配置与典型用法¶
- 在 Telegram 私聊 @BotFather 创建机器人，复制 Bot Token；私聊 @userinfobot 查看你的数字用户 ID。
- 启动 DSH（桌面版打开 App，命令行版运行
npx @deepseek-ai/dsh web），打开「插件」→ dsh-telegram，在页面上方填写 Bot Token 和允许的用户 ID，点「保存」。保存后立即生效，无需重启。 - 在 Web UI 配置模型凭据并创建工作区后，私聊你的机器人：
- 发送
/menu：选择工作区，新建、打开或归档会话，切换模型和推理强度。 - 发送
/help：查看可用命令。 - 直接发送文字、图片或文件开始对话。
更新：重新运行上述安装命令即可，设置会保留。若使用本地仓库，先 git pull 再运行 bash install.sh。
卸载（命令行 / 脚本方式）：
curl -fsSL https://raw.githubusercontent.com/IgnatAi401/dsh-telegram/main/install.sh | bash -s -- uninstall
Windows 桌面版在「插件」页卸载。卸载会删除插件页中保存的 Telegram 设置，但保留 DSH、模型配置、工作区和历史记录。
适用场景与注意¶
适合已经在本机跑 DSH、又希望用 Telegram 私聊做「第二入口」的开发者：同一 token 对应同一 Bot，便于在移动端续写会话或丢附件，而不必重复在 Web UI 里找会话。
使用时请注意：
- 插件随 当前 DSH 进程 运行，具备该进程能访问的工作区与系统权限；安装前建议阅读 GitHub 仓库 源码与 BSD-3-Clause 许可证，确认符合你的安全策略。
- 同一个 Bot Token 不要同时运行多个机器人进程，避免 Telegram 侧冲突。
- 仅私聊、白名单用户 ID，适合个人或小团队；不适合需要群聊或多租户公开 Bot 的场景。
- DSH 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系，版本与星标以各页面实时信息为准（目录线索：GitHub 1 stars、1 forks）。
结尾¶
dsh-telegram 把 Telegram 私聊接进 DSH 的会话与工作区模型，安装以官方 install.sh 或 Windows 插件页的 github:IgnatAi401/dsh-telegram 为准，配置集中在 Web UI 插件页。需要细节与更新说明时，可查阅 SkillHub 目录页 与 GitHub README。
