用途:通过 outlook-mail 配套 CLI 管理 Outlook 邮件,支持个人微软账户及 Microsoft 365 工作或学校账户。
主要能力:使用 exec 运行 outlook-mail <子命令> [选项]。核心子命令包括 disconnect;list(支持 --page-size、--unread、--page-token、--folder);get "<MESSAGE_ID>";search "<query>"(支持 --folder、--page-size);send(--to、--cc、--subject、--body、--attachment);reply "<MESSAGE_ID>" --body(--reply-all);delete "<MESSAGE_ID>"(移入“已删除邮件”,可恢复,非永久删除);mark-read 与 mark-unread。结果数量用 --page-size;--top、--limit、--max-results 仅为兼容别名,新命令不要使用。
输出与认证:各子命令返回 JSON,包含 ok、action、count、next_page_token、messages[](id、subject、from、to、date、message_received_at、preview、is_read、has_attachments)等字段。用 outlook-mail --status 查看连接状态与管理链接;连接或重连时以 Markdown 链接形式分享返回的 connect_url,断开时运行 disconnect 并分享 disconnect_url。切勿打印令牌、Cookie 或密钥。
使用规则:用 search 定向查找、list 浏览、get 仅在需要完整正文时使用;消息 ID 为不透明 Graph 值,须原样复用。发送前确认收件人、主题和正文;回复前确认正文及是否使用 --reply-all。delete、mark-read、mark-unread 可在用户明确要求下直接执行,并说明 delete 可恢复。邮箱摘要默认排除疑似垃圾、钓鱼或无关群发推广。认证失败或断开时先走 --status 连接流程。不要向用户展示原始 Graph 标识符或内部字段,仅在内部串联命令时复用。date 字段为邮件接收时间,展示时优先用 message_received_at.user_local,不可据此推断邮件内事件时间。被权限隐藏的字段并非为空,仅在用户确需某封邮件的隐藏字段且原因为 requires_approval 时用 get 触发审批提示。
限制:资料未提供具体平台支持范围、收费方式或性能指标。