a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
2.8 KiB
2.8 KiB
read_when, summary, title, x-i18n
| read_when | summary | title | x-i18n | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
通过 grammY 集成 Telegram Bot API，附设置说明 | grammY |
|
grammY 集成（Telegram Bot API）
为什么选择 grammY
- 以 TS 为核心的 Bot API 客户端，内置长轮询 + webhook 辅助工具、中间件、错误处理和速率限制器。
- 媒体处理辅助工具比手动编写 fetch + FormData 更简洁；支持所有 Bot API 方法。
- 可扩展：通过自定义 fetch 支持代理，可选的会话中间件，类型安全的上下文。
我们发布的内容
- 单一客户端路径： 移除了基于 fetch 的实现；grammY 现在是唯一的 Telegram 客户端（发送 + Gateway 网关），默认启用 grammY throttler。
- Gateway 网关：
monitorTelegramProvider构建 grammYBot，接入 mention/allowlist 网关控制，通过getFile/download下载媒体，并使用sendMessage/sendPhoto/sendVideo/sendAudio/sendDocument发送回复。通过webhookCallback支持长轮询或 webhook。 - 代理： 可选的
channels.telegram.proxy通过 grammY 的client.baseFetch使用undici.ProxyAgent。 - Webhook 支持：
webhook-set.ts封装了setWebhook/deleteWebhook；webhook.ts托管回调，支持健康检查和优雅关闭。当设置了channels.telegram.webhookUrl+channels.telegram.webhookSecret时，Gateway 网关启用 webhook 模式（否则使用长轮询）。 - 会话： 私聊折叠到智能体主会话（
agent:<agentId>:<mainKey>）；群组使用agent:<agentId>:telegram:group:<chatId>；回复路由回同一渠道。 - 配置选项：
channels.telegram.botToken、channels.telegram.dmPolicy、channels.telegram.groups（allowlist + mention 默认值）、channels.telegram.allowFrom、channels.telegram.groupAllowFrom、channels.telegram.groupPolicy、channels.telegram.mediaMaxMb、channels.telegram.linkPreview、channels.telegram.proxy、channels.telegram.webhookSecret、channels.telegram.webhookUrl。 - 草稿流式传输： 可选的
channels.telegram.streamMode在私有话题聊天中使用sendMessageDraft（Bot API 9.3+）。这与渠道分块流式传输是分开的。 - 测试： grammY mock 覆盖了私信 + 群组 mention 网关控制和出站发送；欢迎添加更多媒体/webhook 测试用例。
待解决问题
- 如果遇到 Bot API 429 错误，考虑使用可选的 grammY 插件（throttler）。
- 添加更多结构化媒体测试（贴纸、语音消息）。
- 使 webhook 监听端口可配置（目前固定为 8787，除非通过 Gateway 网关配置）。