← 返回项目库

启元邮箱：Cloudflare 团队邮箱工作台

基于 Cloudflare Workers 的中文邮箱工作台，支持收件箱、文件夹、搜索、会话查看、草稿和 MCP 连接。

Agentic Inbox 是一个面向团队邮箱的全栈示例，使用 React Router、Hono、Durable Objects 和 R2 保存邮箱配置与邮件数据。当前收录版本补充了简体中文界面、中文演示邮箱数据和本地预览入口，适合学习 Cloudflare Workers 上的邮件工作台与 AI/MCP 集成。演示数据为虚构内容，正式部署前需配置 Cloudflare Access、邮件接收和发送能力。

真实界面

项目截图

共 8 张

收件箱
已发送
草稿箱
客户跟进
邮箱设置
搜索结果
季度客户回访安排
新邮件

Capabilities

核心功能

✓收件箱、已发送、草稿箱和归档文件夹
✓自定义文件夹与未读计数
✓按主题、发件人和正文搜索邮件
✓会话详情、回复、转发与草稿编辑
✓Cloudflare Access 生产鉴权入口
✓Durable Objects 持久化邮箱与邮件数据
✓R2 邮箱配置存储
✓MCP 工具连接面板与 AI 邮件助手入口

适用场景

学习 Cloudflare Workers 全栈应用、Durable Objects 和 R2 数据建模
搭建小团队内部邮箱工作台或邮件自动化原型
验证 AI 邮件助手与 MCP 工具调用交互

适合谁

需要团队邮箱工作台、Cloudflare 全栈开发示例、AI 邮件助手或 MCP 集成参考的开发者与技术团队。

商业化思路

用于社群学习、内部邮箱工作台原型、Cloudflare Workers 全栈二次开发和 AI 邮件自动化验证。

你会拿到什么

  • ✓固定上游提交版本的完整可构建源码包
  • ✓8 张 1440×900 中文真实运行功能状态截图
  • ✓Apache License 2.0 原始许可证文件
  • ✓依赖安装、构建、类型检查、API 和浏览器验收记录

部署流程

  1. 1准备 Node.js 18+、npm 和已登录的 Cloudflare Wrangler 环境。
  2. 2进入源码目录，执行 npm ci 安装锁定依赖。
  3. 3配置 wrangler.jsonc 中的 Durable Objects、R2、Access、域名和邮件绑定，并在生产环境设置 POLICY_AUD 与 TEAM_DOMAIN。
  4. 4执行 npm run typecheck 与 npm run build，确认生成 Worker 构建产物。
  5. 5执行 wrangler deploy 发布 Worker，再通过 Cloudflare Access 和真实邮件收发链路完成线上验收。

真实验证结果

固定上游提交已完成 npm ci、npm run build 和 npm run typecheck。Cloudflare Wrangler 本地 Worker 通过真实 Durable Object/R2 绑定运行，API 返回演示邮箱、8 个文件夹、收件箱/已发送/草稿/自定义文件夹和搜索数据；浏览器证据包含 8 个不同功能状态，1440×900，所有 HTTP、数据、标题、破图、横向溢出和控制台错误断言均通过。

部署前须知

本地预览使用 FACTORY_LOCAL_PREVIEW=1 和虚构 team@demo.local 数据，仅用于验收，不应带入生产。AI binding 在本地不支持，生产需配置对应 Cloudflare AI 能力；正式部署前必须完成 Cloudflare Access、R2、Durable Objects 与邮件通道配置。

部署难度

中等

最低配置

Node.js 18+、npm 及 Wrangler 4；正式部署需要 Cloudflare Workers、Durable Objects、R2、Access 和邮件发送/接收相关配置。

开源许可证

Apache License 2.0

最后验证

2026-09-01

技术栈

Cloudflare WorkersReact Router 7HonoDurable ObjectsR2TypeScriptMCP

授权说明

上游源码保留完整 LICENSE 文件，采用 Apache License 2.0。中文界面与本地预览适配属于本次收录的修改；部署或再分发时请保留许可证与版权声明，并按 Apache License 2.0 履行 NOTICE、修改说明和商标限制等义务。

Release notes

版本记录

1 个已发布版本

v1.0.0-cn.1 当前推荐

首个中文社群学习收录版本；补充简体中文邮箱界面、本地演示数据和真实 Worker 功能验收。

部署要求：Node.js 18+、npm、Wrangler 4；正式部署需要 Cloudflare Workers、Durable Objects、R2、Access 与邮件通道。

已知问题：本地 seed 入口和演示邮箱仅用于验收；生产部署必须先完成 Access、AI、R2、Durable Objects 与邮件收发配置。

登录后领取