应用内首次配置
第一次打开桌面 App，会进入一个分步向导。多数步骤给了默认推荐项，跟着走一遍即可；每一步都可以先跳过、之后再回到设置里补。
第 1 步：环境与权限
Section titled “第 1 步：环境与权限”向导会检测系统版本、内嵌运行环境、数据目录是否可写，以及两项 macOS 权限：
- 完全磁盘访问：读取 Mail.app 自身的邮件数据；
- 自动化权限：让 MailAgent 能控制 Mail.app 完成标已读、标旗、起草回复等操作。
这两项权限只有选择AppleScript 后端（macOS 默认路径）时才用得上；如果你打算用 DavMail 或 Windows 上的本机 Outlook，可以先跳过继续，不会卡住流程。没有当场授权也没关系，向导会给出「稍后设置」或「仍要继续」的退出选项。
第 2 步：选择邮件后端
Section titled “第 2 步：选择邮件后端”- macOS：默认是 AppleScript——用你 Mail.app 里已登录的账户读写邮件，零配置，需要上一步的完全磁盘访问。企业 Exchange / Microsoft 365 邮箱可以改选 DavMail（标注 Beta），需要系统装有 Java，并勾选一条合规确认（DavMail 目前用 Outlook 桌面端的公开身份登录做概念验证，且依赖的 EWS 协议将于 2026-10-01 起被微软默认阻断）。
- Windows：默认是 Outlook（本机）——直接用本机已登录的经典版 Outlook 读写邮件，零外部依赖，但暂不提供日历同步；进阶选项同样是 DavMail。
选好 DavMail 之后，向导本身不会自动完成认证，需要按照 用 DavMail 接入企业邮箱 单独跑一遍。
第 3 步：邮件同步配置
Section titled “第 3 步：邮件同步配置”填写邮箱账户（DavMail 模式下还包括认证方式与网关地址等字段）后，这一步还提供一个可选项：
如果之前用过 Notion 的手动配置方式，这一步也保留了直接填 Token 和两个数据库 ID 的手填入口。
第 4 步：首次同步
Section titled “第 4 步：首次同步”向导会实时显示建表、拉取邮件、（如果连了 Notion）写入 Notion 三个阶段的进度。同步大邮箱可能需要一段时间，可以点 放到后台继续，先进入应用主界面，同步会在后台接着跑完。
按需开启功能
Section titled “按需开启功能”这一步列出几个可选功能，缺凭证不会阻断流程，标黄「未配置」的项可以先开着、之后在设置里补凭证：
- Notion 同步：如果上一步连了 Notion，这里默认开启。
- AI 智能：邮件自动分类、起草回复建议，需要下一步配置模型服务。
- 灵动岛通知（可选增强）：新邮件与 AI 结果推送到系统灵动岛，需要另外安装 Ping Island App。
- 每日巡检：定时汇总未读与待办，依赖灵动岛通知。
- 日历同步：仅 DavMail 模式可用。
接入模型服务（可选）
Section titled “接入模型服务（可选）”为 AI 分类与对话选一个模型服务商：从内置模板里选官方 API（如 Anthropic、OpenAI、DeepSeek 等）或自建的 OpenAI / Anthropic 兼容中转，填入对应的 API 地址与 Key。这一步可以整体跳过，之后随时在 设置 → AI → 模型服务 里添加、测试、切换——那里可以同时管理多个服务商与上百个模型，按需启停。
密钥只保存在本机（加密落盘），不会上传到除你所选模型服务商之外的任何地方。
配置完成后，还有两处值得看一眼
Section titled “配置完成后，还有两处值得看一眼”向导结束后就是主界面。以下两项不在向导里，但值得在设置里留意：
同步日期模式（设置 → 同步）：决定「多早以前的邮件只存本地、不额外镜像到 Notion」这条地板线怎么算——相对模式按「今天减去回溯天数」逐日滚动；固定模式钉在一个具体日期。这条地板线不影响本地同步，早于地板的邮件照常收进本机数据库，只是不建 Notion 页。
历史邮件（设置 → 同步 → 历史邮件）：选一个起止日期区间（最长 365 天），一次性把本地缺失的收件箱与已发送邮件补回来（仅 DavMail 与 Windows 本机 Outlook 支持）。本地已有的邮件会自动跳过，历史邮件照常参与 AI 分类，但不会补发飞书通知或灵动岛提醒。