日历与会议邀请
MailAgent 的日历做两件事：一是把邮件里收到的会议邀请（.ics 附件）自动识别成日程；二是（开启后）把你 Outlook / Exchange 上的全部日程同步进来，包括别人没邀请你、但你能看到的共享会议。这样你不用在邮箱和日历之间来回切。
自动识别会议邀请
Section titled “自动识别会议邀请”这件事默认就在做，无需任何配置：当一封邮件带着 iCalendar（.ics）会议邀请时，MailAgent 会解析它，自动在你的日历里创建对应的事件，并把它和原邮件关联起来。
之后你在日历里点开这个事件，就能：
- 看到会议时间、地点、组织者、与会者名单；
- 看到 Teams / Zoom 会议链接（点一下在浏览器里打开）；
- 点「关联邮件」直接跳回那封邀请邮件。
打开完整日历同步（可选）
Section titled “打开完整日历同步（可选）”光靠邮件邀请，看不到你在 Outlook 里直接创建的会议，也看不到共享日历。要让 MailAgent 显示你 Outlook 上的全部日程，需要打开 CalDAV 同步：
# 在 .env 里加这一行，然后重启后端CALENDAR_CALDAV_SYNC_ENABLED=truepm2 restart mail-sync打开后，后台会每隔约 60 秒检查一次日历变化，把日程拉进来。默认同步窗口是过去 30 天到未来 180 天，足够日常查看；想看更远的，可以调 CALENDAR_CALDAV_SYNC_WINDOW_FUTURE_DAYS。
打开 MailAgent 的 日历 路由，工具栏右侧可以切换视图：
| 视图 | 看什么 |
|---|---|
| 今日 | 单日 24 小时时间线，一眼看今天 |
| 周（默认） | 7 列 × 24 小时，看本周整体安排 |
| 月 | 整月网格，看密度、找空档 |
| Agenda（列表） | 按日分组的紧凑列表，适合快速浏览 |
| 定期邀请 | 列出所有重复性会议，决定哪些要退订 |
工具栏中间的 [上一段] [今天] [下一段] 用来翻日期；最右边有 [同步] 按钮和”上次同步：N 分钟前”的提示。
看懂事件的状态
Section titled “看懂事件的状态”日历里每个事件块的视觉会随你的响应状态变化：
- 已接受 / 已确认：正常显示；
- 暂定：半透明；
- 已拒绝：更淡 + 删除线；
- 待回复：带一道珊瑚色描边，提醒你还没答复；
- 已取消：很淡 + 删除线；
- 已过期：略微变淡（不加删除线）。
接受 / 拒绝 / 新建 / 编辑会议
Section titled “接受 / 拒绝 / 新建 / 编辑会议”点开任意事件，右侧会滑出详情抽屉。在抽屉里你可以：
- 回复邀请：点 [接受] / [暂定] / [拒绝]，MailAgent 会真正向组织者发出标准的会议回复；
- 编辑 或 删除：如果这个会议是你自己组织的；
- 点 会议链接 在浏览器外打开 Teams / Zoom；
- 点 关联邮件 跳回对应的邀请邮件。
工具栏的 [+ 新建] 可以从零创建一个会议（标题、起止时间、地点、描述、与会者）。
会进 Notion 吗
Section titled “会进 Notion 吗”会议事件除了存在 MailAgent 本地，也可以镜像到 Notion 日历数据库（如果你配置了 CALENDAR_DATABASE_ID）。Notion 日历库需要这几个字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| Title | 标题 | 事件标题 |
| Event ID | 文本 | 唯一标识（去重用） |
| Time | 日期 | 起止时间 |
| URL | URL | Teams / Zoom 链接 |
| Location | 文本 | 地点 |
| Organizer | 文本 | 组织者 |
- 改了 Outlook 的会议，MailAgent 没更新？ 同步最多有约 1 小时延迟，手动点 [同步] 立刻拉一次。
- 同步按钮变灰 / 显示报错？ 多半是 DavMail 连接出了问题，参见故障排查。
- 想看的会议不在窗口里？ 默认只同步 -30 天 ~ +180 天，调大
CALENDAR_CALDAV_SYNC_WINDOW_FUTURE_DAYS再重启。
深入了解：日历模块的运维与数据模型见
docs/reference/calendar/calendar-ops.md与docs/reference/calendar/calendar-module-prd.md。