EmailNative v0.1.0
首页 / 官方操作手册 (DOC) v0.1.0 官方规范
OFFICIAL PRODUCT OPERATION MANUAL

EmailNative 智能多域名邮件工作台 · 官方产品操作手册与功能指南

现代化多域名邮箱集中管理 · 按需 AI 智能研判与回复起草 · 零服务器中转隐私架构

01. 产品简介与核心价值

EmailNative 是一款专为独立开发者、跨境出海团队、SaaS 创业者及多域名站长量身打造的开源智能邮件客户端。

✕ 传统商业邮箱痛点

若拥有 5~20 个独立产品或域名(如 maiverse.cc、image-layered.app、cutready.app 等),在 Google Workspace 或商业企业邮按账号付费,每月开销高达 $60 ~ $200+,且网页端反复登录切换账号极其繁琐低效。

✓ EmailNative 创新解决方案
  • 0 成本多域名入站:依托 Cloudflare Email Routing 免费拦截全域名来信与 D1 边缘存储。
  • 稳定高质量出站:直连 Resend 工业级 API(月免 3,000 封),自带权威 SPF/DKIM 认证。
  • 按需 AI 智能分析:内置 DeepSeek-R1 深度推理,按需一键提炼诉求起草回复,零后台自动损耗。
  • 本地优先 (Local-First):密钥与邮件均安全存放于本地设备,零第三方服务器中转。

02. 产品核心功能全景图

┌──────────────────────────────────────────────────────────────────────────────────┐
│                        EmailNative 核心功能矩阵                                   │
├───────────────────┬───────────────────┬───────────────────┬──────────────────────┤
│  🏢 域名与别名管理 │  📬 邮件收件箱流转 │  🧠 按需 AI 智能体 │  🛠️ 工具与健康体检   │
├───────────────────┼───────────────────┼───────────────────┼──────────────────────┤
│ • 无限域名接入     │ • Cloudflare D1   │ • 按需手动触发研判 │ • 一键 DNS/DoH 体检  │
│ • 动态别名 (Alias) │   一键极速拉取    │ • 0 自动消耗 Token │ • SPF 防伪记录核验   │
│ • Catch-all 全收   │ • 智能多维归集    │ • 客户真实意图提炼 │ • DKIM 签名有效性    │
│   自动入册注册     │ • MIME 杂质深度清洗│ • 结合产品人设起草 │ • DMARC 合规检测     │
│ • 传统企业邮 IMAP  │ • Base64/QP 乱码自愈│ • 思维链流式展开   │ • 集中归集主邮箱     │
│ • 专属人设与签名   │ • 2FA 验证码高亮   │ • 一键填入回复框   │ • 单日预算熔断保护   │
└───────────────────┴───────────────────┴───────────────────┴──────────────────────┘

03. 快速开始与环境配置

点击客户端左侧底部的 「系统设置 (Settings)」 图标(或快捷键 Cmd + ,)即可打开配置面板。

3.1 基础设置 (Settings)

  • 界面语言:支持简体中文与英文无缝一键切换;
  • 深色/浅色模式:针对 macOS 与 iOS 精心适配的高端极客暗黑主题与白色明亮主题。

3.2 Cloudflare 邮件网关配置

若使用 Cloudflare 免费接信方案,请在客户端「Cloudflare 网关设置」中配置:

  1. Worker 生产域名:填入部署的 Cloudflare Worker 完整地址(例如:https://emailnative-mail-gateway.yourname.workers.dev)。
  2. 管理密钥 (ADMIN_TOKEN):填入您在 wrangler.toml 中自设的鉴权通信令牌(如 emailnative_sec_token_xxx)。
  3. 状态诊断:配置完成后点击【测试连通性】,系统自动核验 D1 数据库与云端暂存邮件。

3.3 出站发信服务 (Resend) 配置

  • 出站通道选择:默认推荐 Resend API(亦支持传统自建 SMTP);
  • Resend API Key:在 Resend 控制台创建并复制填入 re_xxxxxxxxx
  • 默认发信人名称:例如 Support TeamAlex from Startup

3.4 大模型 AI (DeepSeek) 配置

  • 服务商:原生支持 DeepSeek(兼容各大 OpenAI 兼容接口);
  • API Key:填入您的 DeepSeek API Key(sk-xxxx);
  • 推理模型:默认选用 deepseek-reasoner(DeepSeek-R1 深度思考推理模型)或 deepseek-chat
  • 单日预算上限 ($USD):设置每日 AI 消耗的最大额度(如 $1.00),超额自动熔断保护资金安全。

04. 日常操作指南

4.1 多域名与邮箱别名管理 (Domains)

  • 添加域名:输入域名(如 maiverse.cc),选择 Cloudflare 路由传统 IMAP
  • 配置邮箱别名:点击【添加邮箱/别名】,如输入 hellomaiverse 生成 hellomaiverse@maiverse.cc
  • 产品人设与专属签名 (AI Persona):为该域名设定背景设定(如业务简介、退款政策等),AI 起草时将自动结合该人设。

4.2 邮件同步与自动归集 (Sync & Inbox)

  • 手动同步:点击顶栏【同步 Cloudflare 生产邮件】(或下拉刷新),毫秒级同步云端 D1 数据库至本地;
  • Catch-all 自动入册:收到任何发往已托管域名的来信,系统自动在侧栏对应域名下创建该邮箱别名并标记未读徽标;
  • 独立分流:点击域名仅看该域名邮件;点击专属邮箱仅看该邮箱邮件;点击【全部收件箱】查看全局汇总。

4.3 纯净邮件阅读体验 (MIME 深度清洗)

自动剥离 Received:, ARC-Seal:, DKIM-Signature: 等冗余网络头,自动解码 163、QQ 邮箱、iPhone 发出的 Base64 / Quoted-Printable 字符集,杜绝正文乱码。

4.4 按需【AI 分析与建议回复】(节省 Token)

本系统遵循 “用户决策第一、0 盲目消耗” 的原则:

  1. 新邮件到达时,系统 绝不自动调用 AI,0 Token 损耗;
  2. 收到客户咨询需要回复时,在邮件详情页右上角点击 【AI 分析与建议回复】
  3. AI 结合域名专属人设启动深度思考,输出 【核心意图提炼】【建议回复草案】
  4. 点击 【填入下方回复框】 自动注入编辑器,微调后即可发送。

4.5 锁定发信身份与出站写信 (Composer)

回复时发件人地址被 严格锁定为该邮件的收信域名邮箱,绝不发生跨域名串号穿帮;新撰写邮件支持快捷键 Cmd + N 并在下拉菜单中随时切换名下发信身份。

4.6 域名发信健康度一键体检 (DNS / SPF / DKIM)

基于权威 DNS-over-HTTPS (DoH) 本地实时查询全局解析,一键核验 MX、SPF(include:resend.com)、DKIM 数字签名与 DMARC 合规记录,异常时直接给出修复指引。

05. 跨端支持说明 (macOS & iOS)

🖥️ macOS 原生桌面端

独立 App 运行,无需 Node 依赖;安装包 emailnative-0.1.0-arm64.dmg 双击拖入即可;完美集成原生交通灯、毛玻璃特效与无级缩放。

📱 iOS 移动端

针对小屏优化安全区(避让灵动岛与 Home 指示条);左侧手势滑出域名抽屉,底部配备标准 iOS 4 标签栏导航。

06. 成本保护与安全机制

1. Token 零浪费保护 彻底关闭接收时后台全量研判,将 Token 消耗控制权 100% 交由人工按需手动触发。
2. 单日预算熔断机制 累积 AI 消费达到单日限额(默认 $1.00)时,系统自动拦截后续调用并弹窗告警。
3. 紧急随时打断 (Abort) 分析过程中按钮变为红色的【终止分析】,点击后毫秒级切断网络请求,停止计费。
4. 完全本地存储 (Local-First) 数据库、账户 Token、邮件全量保存在本机持久化存储中,零数据爬取与第三方泄漏隐患。

07. 常见问题与故障排查 (FAQ)

Q1: 点击独立域名邮箱后,中间栏邮件为何不显示?

请确认已更新至最新版(0.1.0+),最新版内置了高容错地址匹配引擎,自动消除了邮箱前后的大小写和 < > 符号;点击独立域名时,系统已自动重置分类过滤器(默认切回“全部邮件”),避免因标签条件过滤掉新来信。

Q2: 发送邮件到域名后,客户端同步提示“云端 D1 数据库记录为 0 封”?

请打开 Cloudflare 控制台 → Workers & Pages → 找到您的邮件 Worker → SettingsBindings;确认绑定的 D1 数据库变量名必须大写为 DB;并确认 Email Routing 路由动作设为 Catch-all (全收) 并指向 Send to a Worker

Q3: AI 研判分析出的建议回复如何使用?

在邮件详情右侧点击【AI 分析与建议回复】,生成完毕后点击卡片右下角的 【填入下方回复框】。回复内容会自动载入到底部的发信文本框中,您可以微调后直接点击“发送”。