owoandCursor
c2c0db7597
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>
145 lines
4.2 KiB
Markdown
145 lines
4.2 KiB
Markdown
# dsh-telegram-channel
|
||
|
||
[English](#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](https://t.me/BotFather) 建 Bot，拿 token；[@userinfobot](https://t.me/userinfobot) 拿自己的 user id。
|
||
3. 安装：
|
||
|
||
```powershell
|
||
dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel
|
||
```
|
||
|
||
或本地：
|
||
|
||
```powershell
|
||
dsh plugin --profile web add D:\gitData\dsh-telegram-channel
|
||
```
|
||
|
||
4. Token（推荐环境变量）：
|
||
|
||
```powershell
|
||
$env:DSH_TELEGRAM_TOKEN = '123456:ABC...'
|
||
```
|
||
|
||
5. 白名单（换成你的 id）：
|
||
|
||
```yaml
|
||
- 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。
|
||
|
||
### 贡献者
|
||
|
||
```powershell
|
||
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](LICENSE)
|
||
|
||
---
|
||
|
||
## 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:
|
||
|
||
```powershell
|
||
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
|