mailinapp
Documentation menu

原生收件箱渲染与 IMAP 同步

实时预览是通用的回退方案——一个收件人一次点击就能打开的托管网页。原生收件箱渲染则更进一步:通过连接外部 IMAP 邮箱账户,MailInApp 发出的邮件会直接在你的域名邮箱内实时渲染,无需任何点击跳转。

你可以连接多个 IMAP 账户(Gmail、Outlook / Hotmail、Yahoo Mail,或自定义 IMAP 邮件服务器),并在同一个位于 /dashboard/mailbox 的域名邮箱中,与自定义域名接收到的邮件一起查看同步过来的消息。已连接的账户是一个功能完整的邮件客户端,而不是只读查看器:文件夹、搜索、撰写/回复/转发、附件、签名和过滤器,全都和在 Gmail 或 Outlook 本身中使用时一样。

连接一个 IMAP 账户

  1. 在仪表盘中打开域名邮箱(/dashboard/mailbox)。
  2. 在左侧边栏的已连接收件箱下,点击**+ 添加**(或**+ 连接 IMAP 收件箱**)。
  3. 选择你的服务商预设(Gmail、Outlook、Yahoo,或自定义):
    • Gmail:如果已启用两步验证,需要一个 16 位的 Google 应用专用密码(在你的 Google 账户安全设置中生成)。
    • Outlook / Yahoo / 自定义:输入你的 IMAP 服务器地址(例如 outlook.office365.com)、端口(993)、邮箱地址和密码。
  4. MailInApp 会在填写 IMAP 信息的同时,自动填入每个服务商已知的 SMTP 主机和端口——同一套凭据可以同时通过两边的身份验证,因此无需额外输入任何内容即可启用发送。
  5. 点击连接。MailInApp 会先用一次测试连接验证凭据,再保存。
  6. 连接成功后,你的账户会出现在侧边栏中,消息也会被拉取进统一列表。任何通过 MailInApp 发送的邮件都会带有一个互动徽章。

在支持发送功能上线之前连接的账户,还没有保存 SMTP 凭据——请从侧边栏重新连接一次该账户,以启用从它撰写和回复邮件的功能。

文件夹

每个已连接账户会同步其收件箱,以及 IMAP 标记为特殊用途的每一个文件夹——已发送、草稿、回收站、垃圾邮件和归档——在侧边栏中以真实的按账户分栏文件夹列表呈现,而不是一个扁平化的列表。选择全部邮件可查看所有已连接账户收件箱汇总而成的统一时间线,或点击进入某个账户的某个文件夹,只浏览那一个。

查看与互动

  • 打开带有互动徽章的消息,会使用与托管实时预览相同的渲染引擎,实时渲染其中的模块(投票、测验、轮播图、表单等)——投票和提交会直接回传到互动端点,你无需离开域名邮箱。
  • 如果发件人开启了发件人资料,并且在发送该消息时该资料是公开的,一张小的已验证卡片——头像、姓名和一个已验证域名徽章——会出现在渲染出的消息上方,并链接到其公开资料页。这张卡片只会由该消息自身经过加密签名的清单构建出来,绝不会来自消息自称的任何内容,因此无法被仿冒者伪造。
  • 没有 MailInApp 清单的消息会在一个安全的沙盒化 HTML 框架中渲染,并且永远不会显示发件人资料卡片。
  • 消息正文和附件始终是按需从你的 IMAP 服务器实时获取的,从不会存储在 MailInApp 的数据库中——打开一条消息也不意味着下载它的附件;附件只有在你点击时才会被拉取。
  • 打开一条未读消息会自动将其标记为已读,与任何主流邮件客户端的行为一致。

消息操作

将鼠标悬停在列表中的任意消息上,或使用阅读窗格中的工具栏,即可:

  • 为一条消息加星标或取消星标(\Flagged)。
  • 标记为已读 / 未读(\Seen)。
  • 归档或删除 — 将消息移动到该账户的归档或回收站特殊用途文件夹(是一次真正的 IMAP 移动操作,绝不会是破坏性的永久清除)。已经归档或已在回收站中的消息,则会改为显示移到收件箱。

撰写、回复与转发

点击侧边栏中的撰写来写一条新消息,或者在打开的消息的阅读窗格中使用回复 / 转发:

  • 一个发件身份选择器涵盖每一个已连接的 IMAP 账户,以及你已验证域名邮箱上的每一个地址,因此一个撰写按钮就能覆盖两套后端。
  • 回复会正确串联(In-Reply-To/References),因此在收件人自己的邮件客户端中会显示为一条回复,而不是一条无关联的新消息。
  • 每次撰写、回复和转发都可以使用抄送和密件抄送字段。
  • 回复一条消息时,使用的是与域名邮箱相同的完整富文本编辑器(粗体/斜体/下划线、标题、列表、引用块、链接、一个固定的调色板和表格),而不是一个纯文本框——回复会在你的签名上方预填一段引用块 On <date>, <sender> wrote: ...,发送前完全可编辑或删除。每条回复在 HTML 之外仍会附带一个纯文本部分,供纯文本客户端使用。
  • 对于在 SMTP 提交过程中不会在服务器端自动保存已发送副本的服务商(Outlook、Yahoo、大多数自定义服务器——Gmail 自己就会这样做),MailInApp 会代你把已发送的消息追加进该账户的已发送文件夹。

目前从已连接的 IMAP 账户撰写一条全新消息仍然只支持纯文本——选中某个 IMAP 账户时,撰写窗口会说明这一点。不过,在回复中添加附件,方式与从域名邮箱地址发送时完全相同(见下方附件)。

用互动邮件回复

带格式的文字还不够?在来自已连接账户的一条打开的消息上,点击**✨ 用互动邮件回复**,即可打开完整的工作室编辑器,并附带该消息作为上下文——与域名邮箱自己的这一功能是同一套流程。选择一个现有项目或新建一个,做最后的编辑,然后把它作为这条特定的回复发送出去。

它的行为方式相同:以事务性邮件发出(没有取消订阅页脚,没有"打开互动版本"这一行,也没有打开跟踪像素),其上的互动会以匿名/限速的方式记录,而不会归因到某一行联系人列表数据。与域名邮箱回复的一个区别是:这里没有持久化的使用以下项目发送:<project name> 标签,也没有会话历史,因为已连接账户的消息从不会存储在 MailInApp 自己的数据库中——只会按需从你的 IMAP 服务器实时获取。无论哪种方式,已发送文件夹中的副本(或收件人自己的收件箱)都仍会保留完整渲染出的邮件。

附件

你正在查看的消息上的附件从不会被预先下载——MailInApp 只会获取你点击的那个文件,直接从你的 IMAP 服务器按需流式传输。没有任何内容会被缓存或存储在服务器端。

在回复中添加你自己的文件,方式与域名邮箱相同:发送前选择文件,数量和大小上限也相同。从已连接账户撰写一条全新消息目前还不支持附件。

搜索

域名邮箱的搜索框能够感知当前所在的账户和文件夹:在查看某个账户的某个文件夹时搜索,会在 IMAP 服务器上实时搜索该文件夹(主题、发件人、收件人和正文);搜索全部邮件则会搜索每个已连接账户的收件箱。搜索结果会替换当前可见的列表,直到你清除搜索——搜索范围不会局限于你已经在本地同步过的消息。

签名

为每个已连接账户设置各自的签名(域名邮箱自己侧边栏中账户旁的 ✎ 图标)——从该账户发出的每一次回复、转发和新撰写,签名都会自动插入到引用文字上方。

过滤器

每个已连接账户都可以拥有自己的一小组规则列表(账户旁的 ⚙ 图标):匹配发件人或主题包含某些文字,然后标为已读、加星标,或移到归档/回收站。规则只会按顺序对新同步到收件箱的邮件进行评估——第一条匹配的规则生效。目前还不支持拖拽调整顺序;要更改优先级,请删除规则后重新添加。

管理多个账户

  • 你可以连接任意数量的 IMAP 账户。
  • 在侧边栏中选择全部邮件可查看所有账户汇总而成的统一时间线,或点击某个具体的已连接收件箱,按该账户筛选并浏览其文件夹。
  • 点击侧边栏头部的同步,可立即触发一次对所有已连接账户的按需同步。
  • 将鼠标悬停在侧边栏中的某个账户上并点击**✕**,可随时断开连接——该账户所有已同步的元数据会立即被移除。

批量操作、键盘快捷键与通知

以下功能在已连接的 IMAP 账户和你的域名邮箱之间行为一致:

  • 勾选任意消息行的复选框以多选,选中内容期间,搜索框会被替换为一个工具栏,可以一次性对所有选中的消息执行归档、删除、标为已读或标为未读。
  • 键盘快捷键(在文本框中输入时会被忽略):j/k 移动到下一条/上一条消息并将其打开,e 归档当前打开的消息,# 删除它——两者都会自动前进到接替其位置的下一条消息,与 Gmail 的"归档并继续"流程相同。
  • 切换侧边栏头部的铃铛图标,可选择开启新邮件的桌面通知——这是一项按浏览器授予的权限,开启后大约每 30 秒检查一次,当前打开的标签页中已经可见的内容会被跳过。