Telegram 遥控器 zhang0098/dsh-telegram-channel

dsh-telegram-channel（martty 兼容 fork）

项目由来：本仓库 fork 自 hi-wenw/dsh-telegram-channel（MIT，版权归上游 contributors，见 LICENSE）。

fork 原因：原版在 Martty Host（dsh --profile martty）上无法启动——它硬声明 inject: ['agents', 'apiProxy']，而 apiProxy 只有 web profile（dsh-host-apiproxy）提供；Cordis 的 inject 全为必选，fiber 永久 pending，启动报 1 entry did not activate（openma-ai/Martty#46）。

差异：不再 inject apiProxy（改运行时探测）；/model 无 apiProxy 时回退到 ctx.llm + installModelSelection 本地路径。web profile 行为与上游一致。上游修复后本 fork 可同步或退役。

dsh 版本对齐：peerDependencies 声明 @deepseek-ai/dsh-: ^0.2.0-rc.2，与 dsh 0.2.x（含 0.2.0-rc.2／后续 0.2 补丁）兼容。dsh 启动时会用该声明做版本闸门（peer 不匹配的 bundle 会被跳过并打印 skipping profile bundle），所以升级 dsh 到 0.3 之前需要先更新这里。

Telegram 手机遥控器 for DeepSeek Harness：附着本机会话，手机 ↔ 电脑同轨迹、双向可见。

环境要求

| 组件 | 版本 |
| dsh | 0.2.x（本仓库按 0.2.0-rc.2 构建与验证） |
| Node | ≥ 22 |

安装

web profile（列运行中的本机会话，/model 走本地）
dsh plugin --profile web add github:zhang0098/dsh-telegram-channel

martty profile（同上）
dsh plugin --profile martty add github:zhang0098/dsh-telegram-channel

dsh 0.2 起没有 apiProxy：web 宿主的 RPC 面改成 typert 远程服务，apiProxy（dsh-host-apiproxy）已不再提供。插件改为直接读取宿主服务，探测不到 apiProxy 时走本地路径：

| 能力 | dsh 0.1（apiProxy） | dsh 0.2（本仓库） |
| 会话目录 | apiProxy.workspace.list + sessions.list | ctx.sessionQuery.listSessions()（含冷会话）+ ctx.workspaceRegistry（web 层，提供标题/顺序/归档集） |
| /last | apiProxy.sessions.history | ctx.sessionQuery.readSession() |
| /model | apiProxy.sessions.models/selectModel | ctx.llm + installModelSelection |
| 附着冷会话 | agents.resume | agents.resume（不变） |

两代路径都保留：有 apiProxy 的宿主仍走 apiProxy，没有的走上面这套。

环境变量（或 config）：DSH_TELEGRAM_TOKEN、DSH_TELEGRAM_ALLOWED_USER_IDS（数字白名单，可逗号分隔）。

使用

- /sessions → 选工作区 → 选会话 → 附着；之后手机发文字即进入该会话（与电脑同轨迹）
- 会话列表来自宿主会话索引：冷会话也会列出，附着时自动 resume（不关闭电脑上的会话）；归档、空白、subagent 会话按 Web 规则排除。宿主既没有 apiProxy 也没有 sessionQuery 时才降级为“只列运行中的会话”
- 附着冷会话后沿用该会话上次使用的模型（dsh 0.2 的 resume 不带 AgentOptions，不这么做第一条消息会因 {{model}} 无值而失败）；之后可用 /model 切换
- 宿主询问（ask_user_question / plan review）双渠道镜像：绑定后问题同时出现在 Telegram 与电脑 TUI/Web，任一渠道回答即生效（先答者胜）
- /last 查看上次问答（含未附着的冷会话）；/model 切换模型（下一回合生效）；/status 查看绑定；/unbind 断开（不关电脑会话）；/help 帮助
- 一键管理脚本：scripts/install.ps1（Windows）/ scripts/install.sh（Unix），-ProfileName martty 指定 profile

配置

| 键 / 环境变量 | 含义 |
| token / DSH_TELEGRAM_TOKEN | Bot token |
| allowedUserIds / DSH_TELEGRAM_ALLOWED_USER_IDS | 白名单；都空 = 谁都不能用 |
| allowAllUsers | true 仅调试 |
| maxMessageLength | 默认 4096 |
| pollingTimeoutSec | 默认 30 |
| rendering | rich（默认）或 html |

开发

pnpm install
pnpm test
pnpm run build

License

MIT（上游 hi-wenw 及 fork 贡献者）

English (summary)

hi-wenw/dsh-telegram-channel（MIT）的 fork，用来在 Martty / ACP 主机上运行（dsh --profile martty）：上游硬注入 apiProxy，而这是 web 配置档专属服务，会让 Cordis fiber 永久挂起（1 entry did not activate，见 openma-ai/Martty#46）。这个 fork 在运行时探测 apiProxy，基于 ctx.llm 加了本地 /model 兜底，并保持 web 配置档行为不变。

对齐 dsh 0.2.x（@deepseek-ai/dsh- peer 为 ^0.2.0-rc.2）。dsh 0.2 会用这些 peer 范围卡住每个插件 bundle，所以声明版本偏旧会让启动器跳过 bundle（skipping profile bundle dsh-telegram-channel）。dsh 0.2 还去掉了 apiProxy（Web 主机的 RPC 接口现在是 typert remote），于是插件直接读取 harness 服务：会话目录来自 ctx.sessionQuery（web 上标题/顺序/归档来自 ctx.workspaceRegistry），/last 来自 sessionQuery.readSession()，/model 来自 ctx.llm + installModelSelection。冷会话会被列出，并在 attach 时恢复；在 0.1 主机上仍然走旧的 apiProxy 路径。

dsh plugin --profile web add github:zhang0098/dsh-telegram-channel
dsh plugin --profile martty add github:zhang0098/dsh-telegram-channel

机器人命令：/sessions（workspace → session → bind）、纯文本 = followup、/last、/model、/status、/unbind、/help。环境变量：DSH_TELEGRAM_TOKEN、DSH_TELEGRAM_ALLOWED_USER_IDS。