Skip to content

feat: add outlook mail mode selection#12

Open
zhezzma wants to merge 1 commit into
huey1in:mainfrom
zhezzma:main
Open

feat: add outlook mail mode selection#12
zhezzma wants to merge 1 commit into
huey1in:mainfrom
zhezzma:main

Conversation

@zhezzma
Copy link
Copy Markdown

@zhezzma zhezzma commented Jun 3, 2026

本次修改为 Outlook 邮箱账号增加了显式的邮件拉取模式配置。

原先 Outlook 邮箱默认只通过 IMAP 拉取邮件。如果某些 Outlook / Microsoft 邮箱没有开启 IMAP,即使 OAuth Refresh Token 可以正常刷新,IMAP 认证或选择收件箱时仍然会失败。

本次改动允许每个 Outlook 账号单独指定使用 imap 还是 graph,从而避免无效的 IMAP 请求,也方便后续查看和维护账号配置。

主要改动

  • Outlook 账号导入格式新增第 5 个字段:

      邮箱----密码----ClientID----RefreshToken----imap
      邮箱----密码----ClientID----RefreshToken----graph
  • 保持兼容原有 4 段格式:

      邮箱----密码----ClientID----RefreshToken

    如果没有最后的 imap/graph 字段,则默认使用 imap。

  • accounts.json 中新增 mode 字段,用于保存该账号的邮件拉取方式:

      {
        "email": "...",
        "password": "...",
        "clientId": "...",
        "refreshToken": "...",
        "mode": "graph"
      }
  • 启动任务读取账号时,会读取并保留 mode 字段。

  • 新增 Microsoft Graph 邮件读取逻辑,支持:

    • 获取收件箱邮件数量
    • 轮询邮件并提取验证码
  • 邮件拉取逻辑调整为按账号模式直连:

    • mode = imap:只使用 IMAP
    • mode = graph:只使用 Microsoft Graph
  • 更新前端导入提示和占位文本,展示新的可选格式。

修改原因

部分 Outlook / Microsoft 邮箱即使授权 Token 正常,也可能因为 IMAP 未开启而无法通过 IMAP 读取邮件,常见错误类似:

  User is authenticated but not connected.

而这些账号通过 Microsoft Graph 仍然可以正常读取邮件。

通过给账号增加显式的 imap/graph 模式,可以:

  • 避免 IMAP 未开启时产生无效请求
  • 让账号配置更加清晰
  • 方便在 accounts.json 中直接查看账号使用哪种拉信方式
  • 保留原有 IMAP 行为,减少对现有逻辑的影响

兼容性

本次改动保持向后兼容:

  • 原有 4 段格式仍然可用
  • 已保存但没有 mode 字段的旧账号会默认按 imap 处理
  • 原有 IMAP 逻辑不会改变,只有明确配置为 graph 的账号才会走 Microsoft Graph

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant