telegram

安装（DSH profile bundle）

# 从本仓库 checkout 安装到 profile（web / headless 等），bundle 声明自动加入组合层
dsh plugin --profile web add 
# 验证
dsh --profile web --dump-config | grep telegram

• 插入行 id：telegram（cordis.patch.yml）；不声明模型面工具或技能——它是把 Telegram 聊天桥接到 agent 会话的后台服务插件。
• 加载即需要 token：缺少 bot token（配置 token 或环境变量 DSH_TELEGRAM_TOKEN）时 apply 直接报错；没有 token 不会惰性启动。
• 宿主前置条件：dsh 组合必须挂载 agents 服务（@deepseek-ai/dsh-agent）；LLM 适配器、会话与工具来自外围 cordis.yml（见 telegram-agent 示例）。
• 卸载：dsh plugin --profile web remove telegram。
• 安装后需重启目标 profile 的 DSH 进程（组合层变更不参与 HMR 热更新）。

概述

telegram 插件通过 Bot API 长轮询把 Telegram 聊天桥接到 harness agent 会话，每个聊天一个 agent 会话。设计参照 Hermes 的 telegram 平台适配器——每聊天会话、用户白名单、HTML 格式化、4096 字符分片、typing 指示——裁剪为 harness 的纯文本接缝。telegram-agent 是可运行的 cordis.yml 应用。

接线

inject: ['agents']。每条已授权文本消息为每个聊天创建或复用 agent（ctx.agents.create），经 followup 以用户消息转发文本，并把每条 assistant/message 文本作为分片的 HTML 格式 Telegram 消息送回聊天。命令：/start（欢迎）、/new 与 /clear（新会话，旧 agent 释放）、/help。LLM 适配器、会话与工具来自外围 cordis.yml。

配置

键	默认	含义
token	''	@BotFather 创建的 bot token；为空时回退到 DSH_TELEGRAM_TOKEN
allowedUserIds	[]	允许与 bot 对话的 Telegram 用户 id；空列表拒绝所有人
allowAllUsers	false	允许任意用户（仅开发用）
provider	deepseek-official	传给每个创建 agent 的 LLM provider id