Mailbox 身份
Mailbox 是 Organization 拥有的稳定「服务商 + 地址」身份。可同时连接多个 Mailbox — 例如不同品牌或区域的 Gmail 账号。
Plan 上的 Entitlement 可能限制可连接 Mailbox 数量。每个 Mailbox 在 Settings 中显示 provider、地址与连接状态。
Connection Generation
每次 OAuth 授权创建一个 Connection Generation — Mailbox 的一个凭证生命周期。 Provider 工作、邮件、sync cursor 与持久命令都按 generation 隔离，已失效凭证的回调无法修改当前状态。
重新连接 Gmail 或飞书邮箱会创建新 generation，但不改变 Mailbox 身份。历史邮件仍关联 Mailbox，而非特定 token 行。
Gmail 同步
Karis 通过分页 delta sync 同步 Gmail。收发的邮件、thread anchor 与 UID validity 必须在因果上一致 — cursor 移动、消息数量与会话分组在各次 sync 间保持一致。
若 handoff 时 OAuth 状态与 Karis 登录 session 不匹配，会路由到 session-mismatch 安全页，而非绑定错误的 Mailbox。
飞书邮箱
飞书邮箱连接遵循与 Gmail 相同的 Mailbox 与 Connection Generation 模型。Provider adapter 保持中立， 活动路由与 Thread 绑定行为不受 provider 影响。
故障排查
- 同步延迟 — 确认 Connection Generation 活跃且邮箱未被 provider 暂停。
- 发件人错误 — 新 Thread 检查 Campaign Default Mailbox；已绑定 Thread 保留原 Mailbox。
- Handoff 错误 — 在与 Settings 发起连接相同的浏览器 session 中完成 OAuth。