dsh-telegram-channel

English · 中文

Keywords / 关键词： Telegram · Bot · Mobile · Remote · Channel · Sessions · Bind · Unbind · Remove · Clear · DeepSeek Harness · DSH · Cordis · dsh-plugin · Agent · Live session · 手机 · 远程 · 遥控器 · 会话列表 · 附着 · 解绑 · 白名单

DeepSeek Harness 手机遥控器：用 Telegram Bot 附着本机正在运行的 Web 会话（与 Web 同轨迹、双向可见）。对标 Codex phone remote——本机会话是真相源，手机不另开平行对话。

---

中文

这是什么

	旧「平行桥」	本插件（当前）
会话	Telegram 专用新建 agent	附着 dsh web 里 live agent
Web	不通	手机与 Web 同一条轨迹

流程：电脑上先开对话 → 手机 /sessions 选择 → 发消息进入该会话 → Web 也能看到。

连接实操（约 10 分钟）

1. 本机 dsh web 能跑，并 先打开至少一个对话（保持运行）。
2. @BotFather 建 Bot，拿 token；@userinfobot 拿自己的 user id。
3. 安装：

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

或本地：

dsh plugin --profile web add D:\gitData\dsh-telegram-channel

4. Token（推荐环境变量）：

$env:DSH_TELEGRAM_TOKEN = '123456:ABC...'

5. 白名单（换成你的 id）：

- insert:
    - id: dsh-telegram-channel
      name: dsh-telegram-channel
      config:
        token: ''
        allowedUserIds: [123456789]

6. 重启 / 重载 profile。
7. 手机 Telegram：
   • /start
   • /sessions → 点选本机会话
   • 发一句话 → Web 与手机构应出现同一轮问答
   • /unbind 仅断开手机绑定，不关本机会话

命令

命令	行为
/sessions /list	列出 live 会话，内联键盘选择附着
/status	当前绑定
/unbind /disconnect	解绑（不 dispose 本机 agent）
/help /start	帮助 / 欢迎
普通文字	进入已绑定会话的 followup

配置

键	默认	含义
token	空 → DSH_TELEGRAM_TOKEN	Bot token
allowedUserIds	[]	白名单；空 = 全拒
allowAllUsers	false	调试用，生产勿开
maxMessageLength	4096	分片长度
pollingTimeoutSec	30	长轮询超时

故障排查

现象	处理
/sessions 提示没有会话	先在 Web 打开对话并保持 profile 运行
「尚未绑定」	先 /sessions 点选
「会话已不在本机运行」	Web 已关该会话；重新开再绑定
「无权限」	检查 allowedUserIds
missing bot token	设 DSH_TELEGRAM_TOKEN 后重载

安全

Fail-closed 白名单；token 走环境变量；日志脱敏；解绑不关闭本机 agent。

贡献者

git clone https://github.com/hi-wenw/dsh-telegram-channel.git
cd dsh-telegram-channel
npm install --legacy-peer-deps
npm test
npm run build

许可证

MIT

---

English

What this is

A DeepSeek Harness Cordis plugin that turns Telegram into a mobile remote for live agents in the same dsh web process. The desktop/Web session is the source of truth (Codex-style remote). Telegram attaches; it does not spawn a parallel hidden agent.

Connect walkthrough

1. Run dsh web and open at least one conversation.
2. Create a Bot (BotFather) + note your user id.
3. Install:

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

4. $env:DSH_TELEGRAM_TOKEN = '...'
5. Set allowedUserIds in the plugin patch.
6. Reload the profile.
7. On your phone: /sessions → tap a live session → send text → same turn appears on Web and Telegram. /unbind detaches only.

Commands

Command	Action
/sessions /list	List live agents; inline keyboard to bind
/status	Show binding
/unbind /disconnect	Unbind (does not dispose host agent)
Plain text	followup into the bound live agent

License

MIT