Files

T

owoandCursor c2c0db7597 feat: remote-control live DSH Web sessions from Telegram

Attach via /sessions picker instead of creating parallel agents; mirror the same session trajectory to phone and Web (Codex-style remote).

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-08-14 17:11:13 +08:00

4.2 KiB

Raw Blame History

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 分钟）

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

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

或本地：

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

Token（推荐环境变量）：

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

白名单（换成你的 id）：

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

重启 / 重载 profile。
手机 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

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

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

$env:DSH_TELEGRAM_TOKEN = '...'
Set allowedUserIds in the plugin patch.
Reload the profile.
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

4.2 KiB Raw Blame History Unescape Escape