【进阶】玩转 AiMail
更新日志
| 版本 | 日期 | 变更描述 |
|---|---|---|
| 0.9.2 | 2026-08-18 | 用户页面UI/UX升级,同步机制稳定性提升。 |
| 0.9.3 | 2026-10-03 | 新增AI功能,用户可以使用AI进行邮件功能增强。 |
1. 项目简介
本文是 AiMail 的进阶使用 Playbook,面向已经完成安装和邮箱配置的用户,帮助您深入掌握邮箱账户配置、邮件同步、邮件收发、智能阅读、AI 辅助写作、邮件规则与批量整理、日历协作和个性化设置等工作场景。
AiMail 简介: AiMail 是一款基于 Electron、React 和 FastAPI 的智能邮件客户端,支持 IMAP、POP3、EWS 和 SMTP,提供邮件收发、搜索、联系人、日历及 AI 摘要、翻译、智能回复和内容润色等功能,帮助您更高效地处理日常邮件。
本文聚焦进阶工作场景;应用各功能模块的基础说明请参阅 AiMail 邮件工作台 用户手册。
难度:初级,适合新手入门体验
2. 前置条件
在开始本教程之前,请确保您已满足以下所有条件:
- 硬件要求:
- AI 算力本 MTT AIBOOK,型号 A141,或其他兼容 Linux ARM64 的设备
- 操作系统:
- MTT AIBOOK 操作系统 AIOS
- 支持 Wayland 或 X11 窗口系统
- 网络要求:
- 网络连接通畅,可访问软件包来源
- 使用云端 AI 时,可访问对应 AI 服务
- 存储要求:
- 为应用程序、本地邮件缓存、正文和附件预留足够的存储空间
- 账户要求:
- 已准备可供第三方客户端使用的邮箱账号
- 根据邮箱服务商要求,准备邮箱密码、 应用专用密码
- 技能要求:
- 具备基本的应用安装、文件操作和账户配置能力
邮箱密码和 AI API Key 都属于敏感凭据。请优先通过应用界面输入,并使用系统 keyring 保存。不要将真实密码、API Key、邮箱地址或邮件正文写入文档、命令历史、截图、工单或公共聊天中。
安装与卸载说明
AiMail 已预装在 MTT AIBOOK 的 AIOS 系统中,可直接从应用列表启动。如需单独安装、重新安装或卸载,请参阅用户手册的安装与启动和卸载说明。
卸载或迁移前,还请注意以下凭据与本地数据处理事项:
- 记录重新配置所需的邮箱服务器和 AI 服务商信息,但不要记录明文密码或 API Key。
- 只有在确认不再需要本机缓存、草稿、偏好和 keyring 凭据后,才清理用户数据。
- 卸载 程序是否保留本机缓存和应用配置,以 PES 的实际提示为准。
3. 首次启动:先完成邮箱配置
3.1 添加邮箱账号
- 打开 AiMail。没有账号时,首页会引导你添加第一个邮箱。
- 点击 添加邮箱账户。
- 选择协议:
- IMAP:日常使用的首选,通常支持服务器文件夹、已读状态、移动和多设备同步。
- POP3:适合只收取邮件的简单场景;文件夹、移动、稳定标识和服务器状态能力可能有限。
- Exchange / EWS:适用于组织内部 Exchange 服务;服务器地址和认证方式以管理员提供的信息为准。
- 输入邮箱地址和授权码。输入域名后,应用会尝试自动填充常见服务器;自动填充只是建议,提交前请核对。
- 检查服务器设置:
- IMAP:收件服务器地址和端口(常见安全端口为 993)。
- POP3:收件服务器地址和端口(常见安全端口为 995)。
- SMTP:发件服务器地址和端口(常见为 465 或 587,具体以供应商为准)。
- EWS:Exchange 服务器地址及组织要求的认证信息。
- 点击 测试连接。测试成功后点击 保存。
QQ、阿里企业邮箱、163/126 等常见域名可能会自动填入服务器。自动填充不会绕过邮箱的安全策略;163、QQ、阿里企业邮箱等经常需要开启 IMAP/SMTP 并使用应用专用授权码。
3.2 获取授权码: 企业阿里邮箱案例
- 登录网页版的企业阿里邮箱,点击 设置 -> 查看更多设置 进入设置页面。

- 在 邮箱设置 -> POP和IMAP 中可以设置收取邮件的范围(30天-全部)。

- 在 账户与安全 -> 账户安全 -> 生成新密码 可以生成三方客户端安全密码,使用该密码来登录AiMail客户端。
注意:该密码一旦生成无法回头查看,无需记住,如需登录新设备,可以重新生成密码。
4. 配置 AI:默认服务或自定义服务
进入 设置 → AI 设置。AiMail 将 AI 服务分为两个模式:
4.1 默认 AI 服务
选择 默认服务 后,应用使用产品提供的默认 OpenAI 兼容接口和默认模型。
4.2 自定义 AI 服务
选择 自定义服务,填写:
- API 类型:OpenAI 兼容接口或 Anthropic。
- API URL / Base URL:严格使用服务商文档给出的地址,不要擅自重复添加
/v1或/messages。 - 模型:填写服务商实际授权的模 型 ID。第三方 OpenAI 兼容服务可按提示留空,让服务端从
/models选择;如果服务商不支持该接口,请手动填写。 - API Key:粘贴对应服务、对应 Base URL 的 Key,点击保存。
- 点击 测试连接,确认返回成功后再使用摘要或生成邮件。
常见选择示例(地址和模型必须以服务商当前文档为准):
| 场景 | API 类型 | 配置建议 |
|---|---|---|
| OpenAI 或兼容网关 | OpenAI | 填写该服务商的 Base URL、授权模型和 Key |
| Anthropic | Anthropic | 使用 Anthropic 消息接口地址和 Claude 模型 ID |
| 本地 Ollama | OpenAI 兼容 | 常见地址为 http://localhost:11434/v1,填写本机已下载的模型 |
| 企业内部模型网关 | 由网关决定 | 先向管理员确认协议、地址、模型名、证书和网络要求 |
使用云端 AI 时,应用可能把当前邮件的主题、正文或必要的上下文发送到所选服务商。发送前请确认服务商的隐私政策、组织合规要求和邮件敏感级别。涉及密码、密钥、身份证件、合同或客户隐私时,优先使用合规的企业/本地模型,或不要调用 AI。
5. 最值得掌握的工作场景
场景 1:高效处理收件箱
展开查看
- 先点选目标文件夹,再观察列表是否已经有本地内容。
- 对重要邮件使用 星标;对暂时不处理的邮件移动到明确的文件夹。
- 使用未读/星标/特别关注联系人等筛选缩小范围。
- 点击邮件后先阅读主题、发件人和附件信息,再决定是否调用 AI。
- 处理完一批邮件后,等待列表和侧边栏未读数刷新;如果网络不稳,不要通过反复切换文件夹制造大量请求。