Files

T

owoandCursor 8ef1622822 fix: ship prebuilt lib and drop prepare for one-click git install

Avoids pnpm allowBuilds block on dsh plugin add; README install steps expanded for first-time users.

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

2026-08-14 17:16:25 +08:00

8.4 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——本机会话是真相源，手机不另开平行对话。

中文

这是什么（30 秒看懂）

电脑上先用 dsh web 打开一个对话（保持开着）。
手机 Telegram 找你的 Bot，发 /sessions，点选那个对话。
之后手机发的话，会进同一个电脑会话；电脑上的回复，手机会同步看到。

	旧「平行桥」	本插件
会话	Telegram 另开一个 agent	附着电脑里正在跑的会话
Web	不通	手机与 Web 同一条轨迹

安装前请准备（缺一不可）

请用笔或备忘录记下三样东西：

#	准备什么	怎么拿
1	电脑已能打开 DeepSeek Harness 网页	终端运行 `dsh web`，浏览器能打开（常见 `http://127.0.0.1:3080`）
2	Telegram Bot Token	手机打开 Telegram → 搜 `@BotFather` → `/newbot` 按提示创建 → 复制一长串类似 `123456:AA...` 的 token
3	你的 Telegram 数字 User ID	搜 `@userinfobot` → 点 Start → 它会回复一串纯数字（不是 @用户名）

安全提醒：Token 相当于钥匙，不要发到公开群、不要提交到 GitHub。若已泄露，去 BotFather 用 /revoke 作废并换新。

安装步骤（照着做即可）

下面假设你用 Windows，命令在 PowerShell 或 CMD 里执行。

第 1 步：安装插件到 web 配置

打开终端，复制粘贴整行后回车：

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

成功时大致会看到安装完成、没有红色大段报错。

如果报错出现 allowBuilds / ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED：

用记事本打开这个文件（没有就新建）：
C:\Users\wenw\.dsh\profiles\web\pnpm-workspace.yaml
在文件里加入（或合并）下面内容（路径以报错里打印的为准；若报错给了更长一行，用报错那一行）：

packages:
  - .

nodeLinker: hoisted
autoInstallPeers: false

allowBuilds:
  dsh-telegram-channel: true

保存文件，再重新执行第 1 步那条 dsh plugin ... add ... 命令。

说明：从 v0.2.1 起，仓库已自带编译好的 lib/，一般不需要再改 allowBuilds。若你装到的仍是旧版缓存，可先执行下面「第 1b 步」再装。

第 1b 步（可选）：清掉旧失败缓存后再装

若刚才失败过，可先：

dsh plugin --profile web remove dsh-telegram-channel

然后再执行第 1 步。仍失败时，用本地目录安装（最稳）：

git clone https://github.com/hi-wenw/dsh-telegram-channel.git D:\gitData\dsh-telegram-channel
dsh plugin --profile web add D:\gitData\dsh-telegram-channel

第 2 步：设置 Bot Token（推荐环境变量）

当前 PowerShell 窗口临时生效（关窗口会丢，适合先试通）：

$env:DSH_TELEGRAM_TOKEN = "这里粘贴你的BotFather_Token"

想长期生效（用户级环境变量）：

Win 键搜索「编辑系统环境变量」→「环境变量」。
在「用户变量」点「新建」：
- 变量名：DSH_TELEGRAM_TOKEN
- 变量值：粘贴 BotFather 给你的 token
确定保存后，关掉所有旧终端，新开一个终端。

第 3 步：写入白名单（只允许你自己用）

打开（没有就新建）profile 补丁文件，常见路径：

C:\Users\wenw\.dsh\profiles\web\cordis.patch.yml

写入下面内容，把 123456789 换成你的 数字 User ID：

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

注意：

allowedUserIds 里必须是数字，两边是方括号。
token: "" 表示继续用环境变量里的 DSH_TELEGRAM_TOKEN（推荐）。
若插件安装时已经自动插入过同名行，不要重复两份；在已有行上改 allowedUserIds 即可。

也可用示例文件对照：仓库里的 examples/telegram-agent/cordis.patch.example.yml。

第 4 步：启动（或重启）DSH Web

重要：改完环境变量 / 补丁后，必须重新开一次 profile。

dsh web

等终端没有报错，浏览器能打开 Harness 页面。

第 5 步：电脑上先开一个对话

在 Web 页面里 新建或打开一个会话，随便让它处于可用状态（这就是手机要遥控的「本机会话」）。

如果 Web 里一个会话都没有，手机发 /sessions 会提示「当前没有正在运行的本机会话」。

第 6 步：手机连上 Bot

打开 Telegram，搜索你创建的 Bot（BotFather 给你的名字）。
点 Start / 发送 /start。
发送 /sessions。
点按钮，选择电脑上那个会话（「已附着…」）。
发一句普通话，例如：你好，请回复收到。
看手机是否收到回复，并回到电脑 Web：应是同一条对话轨迹。

常用命令：

命令	作用
`/sessions` 或 `/list`	列出本机 live 会话并选择附着
`/status`	看当前绑了谁
`/unbind` 或 `/disconnect`	断开手机绑定（不关闭电脑会话）
`/help`	帮助

配置项一览

键	默认	含义
`token`	空 → 读 `DSH_TELEGRAM_TOKEN`	Bot token
`allowedUserIds`	`[]`	白名单；空 = 谁都不能用
`allowAllUsers`	`false`	`true` 时谁都能聊（仅调试）
`maxMessageLength`	`4096`	单条消息分片长度
`pollingTimeoutSec`	`30`	长轮询超时（秒）

故障排查（对照表）

你看到的现象	怎么处理
`allowBuilds` / `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`	见上文「第 1 步」补 `pnpm-workspace.yaml`，或改用本地目录安装；并确认装的是 v0.2.1+
日志 `missing bot token`；Bot 完全不说话	检查 `DSH_TELEGRAM_TOKEN` 是否设置；新开终端再 `dsh web`
回复「无权限。」	`allowedUserIds` 是否写错；必须是 @userinfobot 给的数字 ID
`/sessions` 说没有会话	先在 Web 打开对话并保持 `dsh web` 运行
「尚未绑定」	先 `/sessions` 点选
「会话已不在本机运行」	Web 已关掉该会话；重新开再 `/sessions`
Telegram 401	Token 错了或被 revoke；去 BotFather 换新

安全

白名单默认 谁都不允许，必须填你的 ID。
Token 优先放环境变量，不要写进 Git。
/unbind 只断开手机，不会结束电脑上的 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

Telegram mobile remote for live DeepSeek Harness Web agents in the same dsh web process. Desktop/Web is the source of truth (Codex-style). Telegram attaches; it does not create a parallel hidden agent.

Install (Windows)

Prerequisites: working dsh web, BotFather token, numeric Telegram user id (@userinfobot).
Install:

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

If pnpm prints allowBuilds / ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED, add under C:\Users\<you>\.dsh\profiles\web\pnpm-workspace.yaml:

allowBuilds:
  dsh-telegram-channel: true

Then re-run the install command. v0.2.1+ ships prebuilt lib/ so this is usually unnecessary.

Fallback (most reliable):

git clone https://github.com/hi-wenw/dsh-telegram-channel.git
dsh plugin --profile web add <absolute-path-to-clone>

Set token: $env:DSH_TELEGRAM_TOKEN = "...".
Patch allowedUserIds in ~\.dsh\profiles\web\cordis.patch.yml (see example above).
Restart dsh web, open a Web conversation, then on phone: /sessions → bind → chat.

License

MIT

8.4 KiB Raw Blame History Unescape Escape