Bot API 桥接插件

项目简介

缺少 token 时加载即报错（fail loud）。未配置白名单时 bot 拒绝所有用户（fail closed）。TelegramConfig 还接受仅运行时使用的 client 与 sleep 接缝供测试使用；生产环境使用全局 fetch 与真实定时器。所有错误经 ctx.logger 记录且 bot token 被脱敏。 投递语义 assistant 文本按保守的 Markdown 子集转换（围栏代码 → 、行内代码 → 、粗体 → ，其余 HTML 转义），并按 maxMessageLength 分片，优先在换行、中文句号、句点+空格处断行。 Telegram 拒绝 HTML 正文（分片后实体不完整）时，该片回退为纯文本发送。 turn/start 发送 typing 聊天动作；投递为 fire-and-forget，逐片记录日志。 单条长轮询循环服务所有聊天；空批次休眠 50ms 节奏下限，避免即时空传输让事件循环空转。 模型体验 Telegram 用户消息 模型看到什么

每条入站聊天消息，模型在该聊天会话中收到逐字的一条用户消息。本包不添加系统提示词或工具 schema；它们来自外围 cordis.yml 的插件。命令（/start、/new、/clear、/help）不会到达模型。 Token 影响

数据相关的用户消息 token 进入保留的会话历史，后续回合会重发，直到其它包压缩它们。轮询帧、聊天簿记与投递调用不增加模型上下文 token。 KV Cache 影响