Telegram 远程终端 kangkanjyotigit/dsh-telegram-remote

🤖 dsh-telegram-remote

为 DeepSeek Harness 提供完整的远程控制 + 实时状态可见性 —— 通过 Telegram。

将任意 Telegram 聊天变成一个随身终端，用于操作你的 harness：与 AI 对话、实时观看回复流式输出（思考 → 工具 → 文本）、运行命令、管理聊天/子代理/目标/任务，并控制 harness 的每一项功能 —— 全部通过一个机器人完成，无需任何外部服务（直接使用 Bot API 长轮询）。

✨ 功能特性

- 💬 从 Telegram 聊天 —— 发送一条消息，即可获得实时流式输出的结构化回复（思考、工具、最终答案），并原地编辑更新
- 🎛 完整的 harness 控制 —— 49 条命令：聊天、模型、会话、子代理、目标、任务、文件、PowerShell、导出、预设、技能、设置、凭据、权限等
- 📡 实时状态 —— 状态、正在运行的回合、排队消息（引导 / 编辑 / 删除）、后台任务
- 🔐 权限感知 —— 每个聊天的沙箱读/写/完全控制，针对高风险工具的审批按钮
- 🔔 通知 —— 每个聊天可开启/关闭/全部，后台活动推送到你
- 🔄 热重载 —— 插件编辑后热重载，无需重启（HMR）
- 🔒 单实例 —— 锁文件保证每个机器人令牌只有一个轮询器（不会出现 Telegram 409 冲突）
- 🖥 随处可用 —— 长轮询意味着无需公网 IP / 无需 webhook / 可在 NAT 后运行

📦 环境要求

- Node.js >= 22（使用全局 fetch）
- 一个已安装 DeepSeek Harness 并带有配置文件的实例（例如 web）
- 一个来自 @BotFather 的 Telegram 机器人令牌

🚀 安装

1. 将插件安装到你的 harness 配置文件中：

from your harness profile dir (e.g. ~/.dsh/profiles/web)
npm install link:path/to/dsh-telegram-remote

或将其添加到配置文件的 package.json 中：

{
"dependencies": {
"dsh-telegram-remote": "link:C:/path/to/dsh-telegram-remote"
}
}

2. 将插件添加到配置文件补丁（cordis.patch.yml）中：

- insert:
- id: telegram-remote
name: 'dsh-telegram-remote'
config:
tokenFile: 'C:\path\to\telegram.token' # file containing the bot token
ownerChatId: 123456789 # YOUR telegram user id (get it from /whoami)
workspaceRoot: 'C:\path\to\workspace'
allowEval: true
notifyOnStartup: true

3. 创建令牌文件（或改为设置 tokenEnv）：

Set-Content -Path telegram.token -Value "123456:ABC-your-bot-token" -NoNewline

4. 启动 harness，打开与机器人的聊天，然后发送 /start。

⚙️ 配置

| 键 | 默认值 | 描述 |
| botToken | "" | 直接提供令牌（作为文件/环境变量的替代方案） |
| tokenEnv | "TELEGRAM_BOT_TOKEN" | 存放令牌的环境变量 |
| tokenFile | "" | 包含令牌的文件 |
| ownerChatId | undefined | 你的 Telegram 用户 id —— 拥有完全访问权限 |
| allowedUserIds | [] | 允许聊天的额外用户 |
| workspaceRoot | process.cwd() | /new 聊天开始的位置 |
| allowEval | true | 启用 /eval（在 harness 中运行 JS） |
| notifyOnStartup | true | 启动时发送“bot online”消息 |
| stateFile / logFile | ~/.dsh/... | 覆盖运行时状态 / 日志路径 |

💬 用法

只需输入一条消息——它会发送给你的 AI，回复会流式返回：

💭 Thinking

🔧 Tools
⋯ write ✅ read

🤖 Reply

─────── ⋆⋅☆⋅⋆ ───────
⏳ 34s

点击 /start 键盘或输入 /help 查看完整命令列表。关键命令：

- /chats · /new · /open — 管理聊天
- /model · /models — 切换 AI 模型（/model max 用于最深思考）
- /status — 当前正在发生什么
- /queue /steer /edit /remove — 控制排队消息
- /cmd /fs /mkdir — 运行命令和管理文件
- /agents /send /interrupt — 子代理
- /goal — 长期运行的目标
- /jobs /kill — 后台任务
- /export /search /archive — 对话历史
- /permission — 每个聊天的沙箱模式
- /eval /raw /api — 高级用户 harness 访问
- /reboot /shutdown — harness 生命周期（优雅）

🔒 安全注意事项

- 该机器人可以控制你的计算机——只添加你信任的用户（ownerChatId / allowedUserIds）。
- 每个请求都会根据每个聊天的 /permission 模式进行检查；有风险的工具会请求批准。
- /eval 和 /cmd 功能强大——除非你需要它们，否则考虑设置 allowEval: false。
- 无遥测，无外部服务：该机器人仅与 Telegram 和你的 harness 通信。

🔄 热重载（开发）

启用 harness HMR 后，编辑此插件的 lib/*.js 文件会在约 2 秒内重新加载：

- id: hmr
disabled: false
config:
root: ['C:\path\to\dsh-telegram-remote']
ignored: []

📄 许可证

MIT