邮件客户端 — 用户手册 | YoBench

「邮件」模块的用途

模块是 YoBench 内置的邮件客户端,将 IMAP/SMTP 与 EWS(Exchange / Office 365)统一在一个界面中。多账户、文件夹、搜索、批量操作与后台同步 —— 无需常驻 Mail.app、Outlook 或浏览器标签页。

您将获得:

• IMAP/SMTP —— 适用于 Gmail、Yandex、自建服务器,通过 ImapFlow + nodemailer 提供完整 MIME。
• EWS —— 适用于 Exchange 与 Office 365,通过 ews-javascript-api 获取结构化数据,附件按需加载。
• 富文本撰写器 —— 支持格式、链接、列表、内嵌图片与签名,附件可拖拽添加。
• 草稿(Drafts) —— 撰写过程中自动保存。可在任意接入相同账户的设备上从中断处继续。
• 撤回发送(Undo send) —— 可配置的宽限窗口,在邮件离开 outbox 之前撤回。
• 联系人自动补全 —— to / cc / bcc 字段从已发送/已接收记录中给出建议。
• AI 摘要与智能回复 —— 一键生成长会话摘要,以及由 AI 草拟的回复建议,使用您配置的 AI 提供商。
• 未读 Dock 角标 —— 在应用图标(macOS dock / Windows 任务栏)显示未读总数。
• 多账户并行 —— 每个账户拥有独立的按文件夹同步状态。
• 文件夹 —— 含 special_use 元数据、未读计数与 uid_validity。
• 搜索 —— 按主题、发件人和预览(数据库 LIKE)。
• 批量操作 —— 标记已读/未读、切换标志、移动到文件夹、删除 —— 适用于任意邮件集合。
• 附件 —— 元数据保存在数据库,内容存放磁盘;EWS 模式下按需加载。
• 后台 Worker —— email-sync-worker 拥有自己的 WAL 数据库连接,30 分钟超时,崩溃后自动重启。
• 加密 —— 密码与 OAuth 令牌加密存储。

账户参数

创建账户时需要指定:

• 名称 与 邮箱 —— 在账户列表中显示。
• 用户名 与 密码 —— 凭据。
• 协议 —— imap(默认)或 ews。
• 颜色 —— UI 中的视觉标识。

IMAP 参数

• IMAP 主机 / 端口 —— 收件。
• SMTP 主机 / 端口 —— 发件。
• Use TLS —— 启用加密。

EWS 参数

• EWS URL —— Exchange 服务地址。
• Domain —— Active Directory 域(可选)。
• 认证类型 —— password 或 oauth2。
• OAuth 提供商 —— outlook 或 google。
• OAuth 令牌 —— access/refresh,自动刷新。

密码与令牌写入数据库前会被加密。

全局设置

在 设置 → 邮件:

• 启用邮件(emailEnabled)—— 模块主开关。
• 同步间隔(分钟)(emailPollMinutes)—— 默认 15。
• 并发(emailSyncConcurrency)—— 同时轮询多少个账户(默认 3)。

UI 功能

• 账户侧栏 —— 含彩色标签与未读计数。
• 文件夹列表 —— 含特殊标签(special_use:Inbox、Sent、Drafts、Trash、Junk、Archive)。
• 邮件列表 —— 主题、发件人、预览、日期、is_read、is_flagged、is_answered 标志。按 thread_id 聚合会话。
• 邮件视图 —— HTML 渲染、附件列表、Reply / Reply All / Forward / Delete 操作。
• 撰写 —— to / cc / bcc 字段、主题、附件、签名。

发送

• IMAP 账户 —— 通过 nodemailer SMTP 发送。
• EWS 账户 —— 内置 SendMail API。
• 两种情况下,发出的邮件都会自动存入 Sent 文件夹(provider_id 为空表示本地起源)。

富文本撰写器

撰写器支持标题、加粗 / 斜体、列表、链接、内嵌图片与签名。将文件拖入编辑器即可作为附件;粘贴剪贴板中的图片即可内嵌。富文本与纯文本之间通过一个开关切换。

草稿与撤回发送

每个撰写窗口都会随键入自动保存草稿。Drafts 文件夹列出所有未完成的邮件 —— 点击即可恢复编辑。点击发送后,邮件会先进入本地 outbox,在配置的 Undo send 窗口内(默认 5 秒)可撤回;此时点击 Undo 会恢复撰写器,所有附件与收件人保持完整。

联系人自动补全

在 to / cc / bcc 中开始输入时,下拉框会从您已发送或已接收的邮件中建议地址。最近使用的地址会被置顶。

AI 摘要与智能回复

邮件视图中,长会话会显示 AI summary 按钮:点击一次,AI 提供商即返回包含关键问题与决策的简洁摘要。Smart-reply 会生成两到三条回复草稿(确认 / 承诺 / 拒绝)供您选择 —— 选中的草稿会进入撰写器,可继续编辑后发送。

两项功能都使用 AI 聊天 中的提供商。如果未配置提供商,这两个按钮将不可用。

使用流程

1. 接入账户

1. 在左侧菜单打开 邮件 模块。
2. 点击 添加账户。
3. 选择协议(IMAP 或 EWS)。
4. 填写参数。
5. 对带 OAuth 的 EWS —— 完成 OAuth 流程(Outlook / Google)。
6. 保存。首次同步将自动开始。

2. 启用自动同步

在设置中开启 启用邮件,设置间隔与并发。Worker 将开始在后台轮询账户。

3. 使用邮件

• 阅读 —— 点击行打开视图。
• 回复 或 转发 —— 通过邮件工具栏。
• 加旗标 或 标记已读。
• 移动 到文件夹或删除。
• 搜索 —— 按主题、发件人或预览。

4. 批量操作

通过复选框选中多封邮件 → 在列表头部选择操作(mark read / unread / flag / move / delete)。本地数据库与服务器同时生效。

5. 管理账户

• 编辑 —— 修改凭据或 OAuth 令牌。
• 立即同步 —— 强制查询账户。
• 删除 —— 移除账户及其本地邮件副本。

下一步

• 接入 日历 以显示来自 Exchange 账户的会议。
• 借助 AI 聊天 与 RAG 上下文撰写模板回复。
• 通知使用 YoBench 的共享通道(Telegram、外发邮件)。

帮助与反馈

希望支持 PGP、S/MIME 或自定义自动过滤规则?通过反馈表单联系我们。