@loserfox/telegram
Telegram Bot API 桥接插件：将 Telegram 聊天转发到 harness agent 会话（长轮询、每个聊天会话、HTML 格式化）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:LoserFox/telegram#a0a9ca11e427b62217250e2e561f6ad3c49d13f2Telegram 以 @loserfox/telegram 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
# 从本仓库 checkout 安装到 profile（web / headless 等），bundle 声明自动加入组合层
dsh plugin --profile web add <dir|git-url>
# 验证
dsh --profile web --dump-config | grep telegram
telegram（cordis.patch.yml）；不声明模型面工具或技能——它是把 Telegram 聊天桥接到 agent 会话的后台服务插件。token 或环境变量 DSH_TELEGRAM_TOKEN）时 apply 直接报错；没有 token 不会惰性启动。agents 服务（@deepseek-ai/dsh-agent）；LLM 适配器、会话与工具来自外围 cordis.yml（见 telegram-agent 示例）。dsh plugin --profile web remove telegram。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 |
model | deepseek-v4-flash | 传给每个创建 agent 的模型 id |
maxMessageLength | 4096 | 每条 Telegram 消息的长度上限 |
pollingTimeoutSec | 30 | 长轮询超时（秒） |
缺少 token 时加载即报错（fail loud）。未配置白名单时 bot 拒绝所有用户（fail closed）。TelegramConfig 还接受仅运行时使用的 client 与 sleep 接缝供测试使用；生产环境使用全局 fetch 与真实定时器。所有错误经 ctx.logger 记录且 bot token 被脱敏。
<pre>、行内代码 → <code>、**粗体** → <b>，其余 HTML 转义），并按 maxMessageLength 分片，优先在换行、中文句号、句点+空格处断行。turn/start 发送 typing 聊天动作；投递为 fire-and-forget，逐片记录日志。每条入站聊天消息，模型在该聊天会话中收到逐字的一条用户消息。本包不添加系统提示词或工具 schema；它们来自外围 cordis.yml 的插件。命令（/start、/new、/clear、/help）不会到达模型。
数据相关的用户消息 token 进入保留的会话历史，后续回合会重发，直到其它包压缩它们。轮询帧、聊天簿记与投递调用不增加模型上下文 token。
仅追加；新可见内容跟在可复用请求前缀之后，不会使既有 KV-cache 条目失效。