dsh-telegram-bridge

🚀 首次配置（用户全流程）

第 1 步：获取 Bot Token

在 Telegram 里找 @BotFather → /newbot 创建机器人 → 获得 token（格式 123456789:AA...）。

第 2 步：配置 Token（二选一）

• 方式 A（推荐，可视化）：dsh 设置页 → 插件配置 → Telegram Bot 桥接 → 在 Bot Token 输入框粘贴 token → 点 测试连接 立即验证是否有效 → 点 保存。
• 方式 B（credentials）：在 ~/.dsh/.credentials.yaml 添加：

  refs:
    DSH_TELEGRAM_BOT_TOKEN: "你的token"
  

第 3 步：配置访问白名单（安全必需）

设置页 → 插件配置 → Telegram Bot 桥接：

• 允许所有人访问：选 否（false）（默认）
• 允许的用户名：填你的 Telegram 用户名（不带 @），如 your_username；多用户用逗号分隔
• （可选）允许的聊天 ID：私聊数字 ID 或群组 ID，多 ID 用逗号分隔

第 4 步：配置代理（如需）

国内访问 Telegram 需要代理，代理地址 填：

http://127.0.0.1:7897                          # 本地代理（clash 等）
http://user:pass@host:port                      # 需要认证的代理

仅支持 http/https 代理（socks 暂不支持）。留空 = 直连。

第 5 步：重启并验证

重启 dsh 后，在 Telegram 里给机器人发 /status 或任意消息，应正常回复。

第 2 步：配置 Token（二选一）

• 方式 A（推荐，可视化）：dsh 设置页 → 插件配置 → Telegram Bot 桥接 → 在 Bot Token 输入框粘贴 token → 点 测试连接 立即验证是否有效 → 点 保存。
• 方式 B（credentials）：在 ~/.dsh/.credentials.yaml 添加：

  refs:
    DSH_TELEGRAM_BOT_TOKEN: "你的token"
  

第 3 步：配置访问白名单（安全必需）

设置页 → 插件配置 → Telegram Bot 桥接：

• 允许所有人访问：选 否（false）（默认）
• 允许的用户名：填你的 Telegram 用户名（不带 @），如 your_username；多用户用逗号分隔
• （可选）允许的聊天 ID：私聊数字 ID 或群组 ID，多 ID 用逗号分隔

第 4 步：配置代理（如需）

国内访问 Telegram 需要代理，代理地址 填：

http://127.0.0.1:7897                          # 本地代理（clash 等）
http://user:pass@host:port                      # 需要认证的代理

仅支持 http/https 代理（socks 暂不支持）。留空 = 直连。

🎛️ 配置项

配置	默认	说明
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 轮询间隔（毫秒）