dsh-telegram-bridge
用于 DeepSeek Harness (dsh) 的 Telegram 机器人桥接：通过 Telegram 与您的 DSH 代理聊天，并支持访问控制、技能和工作区浏览。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:CLASSLU/dsh-telegram-bridge#5b967514396bcb9c30b9cd6c33691042fc8df6a9Telegram Bridge 以 dsh-telegram-bridge 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
通过 Telegram 遥控你的 DeepSeek Harness（dsh）Agent：在手机上直接和你的 Agent 对话、调用技能、浏览/切换工作目录、收发文件。
/cwd 用按钮逐级浏览目录、新建文件夹、一键切换（完全在 Telegram 内操作）/skills 查看、/skill <名称> 调用把本插件加入你的 dsh profile（以 web profile 为例）：
dsh-telegram-bridge 安装到 profile 的 node_modules：
cd ~/.dsh/profiles/web
pnpm add dsh-telegram-bridge # 或手动复制 dist/ + package.json + cordis.patch.yml
~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组中加入 "dsh-telegram-bridge"。在 Telegram 里找 @BotFather → /newbot 创建机器人 → 获得 token（格式 123456789:AA...）。
~/.dsh/.credentials.yaml 添加：
refs:
DSH_TELEGRAM_BOT_TOKEN: "你的token"
设置页 → 插件配置 → Telegram Bot 桥接：
your_username；多用户用逗号分隔国内访问 Telegram 需要代理，代理地址 填：
http://127.0.0.1:7897 # 本地代理（clash 等）
http://user:pass@host:port # 需要认证的代理
仅支持 http/https 代理（socks 暂不支持）。留空 = 直连。
重启 dsh 后，在 Telegram 里给机器人发 /status 或任意消息，应正常回复。
| 配置 | 默认 | 说明 |
|---|---|---|
bot_token_ref | DSH_TELEGRAM_BOT_TOKEN | credentials 引用名 |
bot_token | 空 | 直接填 token（设置页/配置均可） |
allow_all | false | 是否允许任何人访问（强烈建议保持 false） |
allowed_usernames | [] | 允许的 Telegram 用户名（不带 @） |
allowed_chat_ids | [] | 允许的聊天/群组 ID |
group_require_mention | true | 群里需 @ 机器人才响应 |
proxy | 空 | 代理地址 http://[user:pass@]host:port |
cwd | dsh 启动目录 | 默认工作目录 |
polling_interval | 2000 | getUpdates 轮询间隔（毫秒） |
| 命令 | 说明 |
|---|---|
/new | 重置当前会话 |
/topic <名称> | 切换命名子会话 |
/cwd | 目录树浏览 / 切换工作目录（支持新建文件夹） |
/skills | 列出可用技能 |
/skill <名称> [参数] | 调用技能 |
/model [provider model] | 查看 / 切换模型 |
/sessions | 列出会话 |
/status | 当前状态 |
/stop | 停止当前回合（agent 正在思考/执行时打断） |
/auth | 检查授权状态 |
/cleanup | 释放空闲会话 |
/help | 帮助 |
/stop，agent 会立即停止思考/执行。/new。/status 看运行状态；处理中 bot 会显示"typing..."。/stop 只停当前回合，队列里排队中的消息仍会继续处理；要全部取消用 /new 或 /cleanup。Q: 机器人完全不回复任何消息？
A: 大概率 token 未配置。看 dsh 终端日志，会提示 未配置 Bot Token 及配置方法；或在设置页检查 Bot Token 是否显示"未配置"，填好后用 测试连接 验证。
Q: 测试连接失败？
A: 1) token 是否复制完整（@BotFather 里可查看）；2) 代理是否可达、格式是否正确（http://[user:pass@]host:port）；3) 本机网络是否能访问 api.telegram.org。
Q: 提示"无权访问"？ A: 你的用户名不在白名单。设置页 → 允许的用户名 里加上（不带 @），保存后即生效（无需重启）。
Q: 想给朋友开放？
A: 在设置页的允许的用户名/聊天 ID 里追加即可；也可把 allow_all 设为 true（不推荐）。
/cwd 允许切换到任意目录（设计为"自己遥控自己的机器"）。Bot 会话的 agent 拥有该目录的读写能力，切勿把 Bot 白名单开放给不信任的人。allowed_chat_ids 填入群 ID 后，该群内所有成员都可与 Bot 对话（绕过用户名白名单）。只想让特定成员使用请用 allowed_usernames。POST /telegram-bridge/test-token 无鉴权。不要将 dsh Web 直接暴露到公网且不做访问控制（dsh 默认监听 127.0.0.1，反向代理暴露时请加认证）。<工作目录>/telegram-inbox/（上限 25MB/个）；Agent 发送文件仅限工作目录内（越界会被拒绝）。~/.dsh/dsh-telegram-bridge.log，均不记录 token 明文。dist/ 下的产物（无构建步骤），dist/client.js 为手写 __ModuleLoader__ bundle。dist/index.js；浏览器配置卡片：dist/client.js。系统临时目录/tg-bridge-log.txt，可用环境变量 DSH_TELEGRAM_BRIDGE_LOG 覆盖；诊断日志默认 ~/.dsh/dsh-telegram-bridge.log，可用 DSH_TELEGRAM_BRIDGE_DIAG 覆盖。dist/、package.json、cordis.patch.yml 复制到 profile 的 node_modules，重启 dsh。MIT