feat: WmailHub v1.0.0 —— Cloudflare Email Workers 邮件接收与转发平台(本地可用版本)

- Console:React 19 + antd 6.6.5 前端(登录 admin/admin)+ Hono 管理 API
  (Nodes/Domains/Mailboxes/Emails/Webhooks/Keys/OAuth/Admin)
- Node:Bun 转发节点(HMAC 签名、有限重试、心跳、结构化日志、优雅退出)
- Email Worker:Cloudflare email handler + 本地联调入口
- shared:HMAC 协议(docs/04)、wmh_ Key(32 位)、AES-GCM 加密、SSRF 防护
- 邮件管线:postal-mime 解析、附件、catch-all、限额、malformed 降级、TTL 1 天
- Webhook:签名投递、指数退避重试、SSRF 校验、投递日志
- API v1 + MCP(JSON-RPC,六工具,凭据 kind 隔离)
- Cloudflare OAuth:真实 + 本地 sim 模式,自动安装管线(幂等,无需手工命令)
- 测试:bun test 41 例(协议安全/管线/TTL/Webhook/SSRF/MCP/OAuth/鉴权)+ Playwright UI 冒烟
- LOGO/favicon 由 codex CLI 生成

docs/10_IMPLEMENTATION_PLAN.md

@@ -0,0 +1,61 @@
+# ZCODE 实施计划
+
+## Phase 1 项目骨架
+
+```text
+WmailHub/
+  console/
+  node/
+  worker/
+  docs/
+```
+
+Console、Node、Worker 必须边界清晰，共享协议独立。
+
+## Phase 2 Console
+
+实现 Console Web、Management API、数据库、认证、Node CRUD、Domain CRUD、Mailbox CRUD、Email CRUD。
+
+## Phase 3 Cloudflare OAuth
+
+实现 OAuth start、callback、state、token exchange、Account/Zone discovery、加密 token storage。
+
+## Phase 4 自动 Node 安装
+
+Add Node 后完成：OAuth、Node identity、Node credential、Email Worker、Worker -> Node、Email Routing、Domain、Mailbox、Node heartbeat。正常流程禁止要求用户复制安装命令。
+
+## Phase 5 Node
+
+实现 bootstrap、secure config、Email Worker ingress、Console egress、HMAC signing、heartbeat、有限 retry、graceful shutdown、structured logging。
+
+Node 不实现业务路由。
+
+## Phase 6 Email Pipeline
+
+```text
+Cloudflare -> Worker -> Node -> Console -> D1/R2
+```
+
+测试 plain text、HTML、MIME、attachment、多收件人、大正文和 malformed mail。
+
+## Phase 7 Webhook
+
+实现 CRUD、secret、signing、delivery、retry、timeout、失败状态和日志。
+
+## Phase 8 TTL
+
+实现 retention configuration、expires_at、Cron cleanup、R2 cleanup 和 orphan cleanup。默认 1 day。
+
+## Phase 9 API / MCP
+
+实现 Console API，并提供 list_mailboxes、list_emails、get_email、create_mailbox、delete_mailbox、list_webhooks 等 MCP 工具。权限必须基于 Console credential。
+
+## Phase 10 安全测试
+
+测试 OAuth CSRF、credential revoke、replay attack、伪造 Node 请求、body 篡改、过期 timestamp、Webhook SSRF、未授权 mailbox、未授权 Cloudflare Account、超大邮件和超大附件。
+
+## Phase 11 验收
+
+必须完成：Cloudflare OAuth -> 自动 Node 安装 -> Domain 配置 -> Mailbox 创建 -> 真实 Email -> Email Worker -> Node -> Console -> Database/Webhook/API/MCP -> TTL 自动删除。
+
+如果正常流程要求用户手工登录服务器执行安装命令，则不符合设计目标。