DSH Hub / 插件 / dsh-telegram-channel 安装 $ npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel复制
dsh-telegram-channel
English · 中文
Telegram 手机遥控器 for DeepSeek Harness:附着本机正在跑的 Web 会话,与电脑 同轨迹、双向可见 (Codex-style)。
发现: dsh-plugin topic · 安装:dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
Keywords: Telegram · Bot · Mobile · Remote · DSH · Cordis · dsh-plugin · sessions · bind
中文
使用前需要什么
需要 说明 DeepSeek Harness(dsh) 本机已能跑通 dsh web Node.js 跟 Harness 走,建议 ≥22 Telegram Bot Token @BotFather → /newbot数字 User ID @userinfobot代理(可选) 若直连不上 api.telegram.org,需本机 HTTP(S)_PROXY
不需要 Python。
30 秒理解
电脑 dsh web 开着(会话列表与 Web 对齐,已归档除外)
手机 Bot:/sessions → 工作区 → 会话 → 附着
之后手机 ↔ Web 走同一条 轨迹;可用 /model 切换模型(下一回合生效)
效果截图
手机选择会话并发问:
电脑 Web 同步收到同一条消息与回复:
一键管理菜单(推荐)
先准备两样东西:
dsh-telegram-channel · DSH Hub
Bot Token Telegram 搜 @BotFather → /newbot → 复制 token 数字 User ID 搜 @userinfobot → Start → 复制纯数字
Token 不要发到公开群;泄露了去 BotFather /revoke。
Windows
请在 PowerShell 执行。若当前是 CMD ,用下面「CMD 一键」那行。
irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex
脚本已兼容 irm | iex(菜单逻辑包在 scriptblock 里)。CMD 请用下面整行。
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex"
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -UseBasicParsing https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 -OutFile $env:TEMP\dsh-tg.ps1; & $env:TEMP\dsh-tg.ps1"
1) 安装 / 重装插件(写入 Token + 白名单)
2) 启动 dsh web(新窗口)
3) 停止 dsh web
4) 查看状态
5) 打开浏览器
0) 退出
.\scripts\install.ps1 -Action install -Token '...' -UserId '123456789'
.\scripts\install.ps1 -Action start
.\scripts\install.ps1 -Action stop
.\scripts\install.ps1 -Action status
安装时脚本会:写环境变量、补 allowBuilds、执行 dsh plugin add(不会 再 insert 同名 id)。
macOS / Linux curl -fsSL https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.sh | bash
# 同样出现数字菜单;或:
# ./scripts/install.sh install --token '...' --user-id '...'
# ./scripts/install.sh start|stop|status
手机怎么用
菜单选 2 启动 dsh web(或自己运行 dsh web)
浏览器里可看到工作区与会话(归档会话不会出现在手机列表)
手机对 Bot:/start → /sessions → 选工作区 → 选会话 → 聊天
需要换模型时:/model → 点选(与 Web 同 API,下一回合生效)
续接上下文:附着后点 查看上次对话 ,或发 /last
输入框旁的 / 菜单应有:start sessions last model status unbind help。
命令 作用 /sessions先列工作区,再列该工作区会话(与 Web 对齐,排除归档/空白/子代理);冷会话附着时会自动 resume /last查看绑定会话的上次问答 (附着后也会出现「查看上次对话」按钮) /model切换当前绑定会话的模型 /status当前绑定 /unbind只断开手机,不关 电脑会话 /help帮助
手工安装(可选) # 用户环境变量(或当前会话 $env:...)
# DSH_TELEGRAM_TOKEN = BotFather token
# DSH_TELEGRAM_ALLOWED_USER_IDS = 数字ID
dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
dsh web
dsh plugin --profile web add D:\path\to\dsh-telegram-channel
需要改 YAML 白名单时,只能按 id 覆盖 ,不要再 insert 同名 id:
- id: dsh-telegram-channel
config:
token: ""
allowedUserIds: [123456789]
示例:examples/telegram-agent/cordis.patch.example.yml。
配置 键 / 环境变量 含义 token / DSH_TELEGRAM_TOKENBot token allowedUserIds / DSH_TELEGRAM_ALLOWED_USER_IDS白名单;都空 = 谁都不能用 allowAllUserstrue 仅调试maxMessageLength默认 4096 pollingTimeoutSec默认 30
若本机用了 HTTP(S)_PROXY 访问 Telegram,插件会自动走代理(无需再设 NODE_USE_ENV_PROXY)。
故障排查 现象 处理 ERR_PNPM_IGNORED_BUILDS / allowBuildspnpm 11 起:仅 dsh-telegram-channel: true 不够(git 包无效)。在 ~\.dsh\profiles\web\pnpm-workspace.yaml 写入仓库级授权后重装: 'dsh-telegram-channel@git+https://github.com/hi-wenw/dsh-telegram-channel.git': true再跑菜单 1 (新版安装脚本会自动写) duplicate loader entry id: dsh-telegram-channel用户 patch 不要 insert 同名 id;用上面的 - id: 覆盖,或只用环境变量白名单 手机完全没回复 / ConnectTimeout 打开本地代理(如 7890),重启 dsh web missing bot token检查环境变量;新开终端 再 dsh web 「无权限」 User ID 必须是 @userinfobot 的数字 /sessions 无会话确认 Web 有未归档会话;空白会话会被隐藏 /sessions 比电脑少很多升级到 ≥0.3.0:应按工作区列出;仍少则检查是否归档 /model 不可用需 dsh web(apiProxy);先 /sessions 绑定。≥0.3.2 已修复「未 inject 读不到 apiProxy」 Telegram 401 Token 错了或被 revoke
开发 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
发布与发现(社区插件) 社区发现入口主要是 GitHub topic,不是封闭应用商店审核:
仓库 公开 ,package.json 声明 dsh.bundle.patch(本仓库已有)
About → Topics 加上 dsh-plugin (已加;可浏览 topic 列表 )
用户安装:
dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
许可证
English
Prerequisites
Working DeepSeek Harness (dsh web)
Node.js (typically ≥22 with Harness)
Telegram bot token + numeric user id
Optional HTTP(S)_PROXY if Telegram API is blocked
No Python required
What this is Telegram mobile remote for DeepSeek Harness Web sessions. Desktop/Web is the source of truth; the phone attaches (no parallel hidden agent). /sessions is workspace → session (Web-aligned, archived excluded). /model switches the bound session’s model for the next turn.
Screenshots Phone: pick a session and chat:
Desktop Web shows the same trajectory:
One-click manager (Windows) Run in PowerShell (not CMD). Opens a number menu: install / start / stop / status / open browser.
irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex"
.\scripts\install.ps1 -Action start
.\scripts\install.ps1 -Action stop
.\scripts\install.ps1 -Action install -Token '...' -UserId '123456789'
The script sets user env vars, ensures allowBuilds, and runs dsh plugin add. After start , phone: /sessions → workspace → session → bind; optional /model.
Unix export DSH_TELEGRAM_TOKEN='...'
export DSH_TELEGRAM_ALLOWED_USER_IDS='123456789'
curl -fsSL https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.sh | bash
Manual dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
Allowlist via DSH_TELEGRAM_ALLOWED_USER_IDS (preferred) or id-targeted YAML override — never re-insert the same plugin id.
Discoverability Listed under the public GitHub topic dsh-plugin . Install:
dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
License