用途：m365-mail 是一个基于 Microsoft Graph API 的命令行工具，用于读取、搜索、发送和管理 Microsoft 365 邮件。适合在终端或脚本中处理收件箱、消息等邮件任务。
主要能力：列出收件箱（可限制条数、仅未读、带预览、JSON 输出）；按 ID 读取完整邮件；全文搜索，支持按发件人、未读、含附件等过滤条件组合；发送邮件，支持多收件人、抄送、从文件读取正文及 HTML 正文；管理邮件，包括列出文件夹、移动、永久删除、标记已读/未读。输出默认人类可读，--json 便于程序化处理。
使用方式：需一次性注册 Entra ID 应用，配置 Microsoft Graph 委托权限 Mail.ReadWrite、Mail.Send，启用公共客户端流并记录 Application (client) ID 与 Directory (tenant) ID。安装依赖 pip install msal requests，赋予脚本执行权限后配置 m365mail setup --client-id <YOUR_CLIENT_ID> --tenant-id <YOUR_TENANT_ID>，再执行 m365mail auth 通过设备代码认证。常用命令如 m365mail inbox、m365mail read <message_id>、m365mail search、m365mail send、m365mail folders、m365mail move 等。消息 ID 可用完整 ID 或前 8 位以上唯一前缀。令牌缓存在 ~/.m365mail/，自动刷新。
适用场景与限制：适合已具备 Entra ID 应用与相应权限的组织环境；权限可能需管理员同意。未提供收费、价格、平台兼容性等信息，暂未提供。