Telemail

运行在 Cloudflare Workers + Pages 上的邮件转发系统，监控 Gmail / Outlook / IMAP 收件箱，把新邮件转发到 Telegram 聊天——支持多账号、附件、AI 摘要、Mini App 稍后提醒。

• Gmail：Google Cloud Pub/Sub 推送通知实时接收
• Outlook：Microsoft Graph webhook 订阅实时接收
• IMAP（可选）：独立 IMAP Bridge Docker 服务，通过 IMAP IDLE 实时推送
• MCP：用户可在 bot 里生成 API key，让 agent 通过 /api/mcp 搜索和读取自己的邮件

技术栈

• Runtime：Cloudflare Workers（后端）+ Cloudflare Pages（Mini App 前端 + web 工具页）+ VPS Docker（IMAP Bridge）
• 后端：Elysia（CloudflareAdapter）+ grammY + Cloudflare D1 / KV / Queue / Cron
• 前端：Vite + React 19 + TanStack Router + TanStack Query + HeroUI + Eden treaty（端到端类型安全 RPC）+ TypeBox
• 邮件解析：postal-mime；HTML → Markdown：turndown → Telegram MarkdownV2
• AI 摘要：兼容 OpenAI Responses API 的 LLM endpoint（可选）
• i18n：i18next（当前仅中文）

文档

• docs/DEPLOYMENT.md —— 从 0 部署到 Cloudflare（GCP / MS Entra / D1 / KV / Queue / Workers + Pages / Bot webhook）
• docs/DEVELOPMENT.md —— 本地开发命令、前端调试流程、i18n
• docs/ENVIRONMENT.md —— 所有 secrets、Bindings、Cron、D1 schema 的参考

多账号

• Gmail / Outlook / IMAP 三种混用
• 每个账号可以配不同的 Telegram Chat ID / Topic ID（不同邮箱转不同聊天 / 频道 / forum topic）
• Forum supergroup 可在 General 里 /start 自动创建 Inbox topic，用 General 做操作区、Inbox 放邮件
• 所有 Gmail 账号共享同一个 GCP 项目；所有 Outlook 账号共享同一个 Entra ID 应用；所有账号共享同一个 Telegram Bot
• 账号信息存 D1，通过 Mini App 管理（/start → 账号管理）
• 支持临时禁用：推送 / cron / 列表跳过该账号，IMAP 额外通知 bridge 断开连接；配置保留随时可恢复

Bot 命令

Bot 只保留主入口和帮助，其它常用功能通过 /start 面板进入。

命令	说明
/start	打开管理面板
/help	查看帮助信息

许可证

AGPL-3.0-or-later © 2026 Apocalypsor