用途:通过 outlook-mail 配套命令行工具管理 Outlook 邮件,支持个人微软账户及 Microsoft 365 工作或学校账户。
主要能力:核心子命令包括 disconnect、accounts、list、get、search、send、reply、delete、mark-read、mark-unread。list 支持 --page-size、--unread、--page-token、--folder;search 支持 --folder 与 --page-size;send 支持 --to、--cc、--subject、--body、--attachment;reply 支持 --body 与 --reply-all;delete 将邮件移入“已删除邮件”,可恢复,并非永久删除。
使用方式:用 exec 运行 outlook-mail <subcommand> [options]。命令默认使用已链接邮箱,可用 --account <account_id> 指定;账户选择需先运行 outlook-mail accounts 匹配 display_name,歧义时应询问而非猜测。选定账户后,后续分页、get、reply、delete 等操作需重复同一 --account。--account 仅作用于邮箱操作,--status、accounts、disconnect 为连接器级。
认证:用 outlook-mail --status 查看连接状态与链接管理。返回 connect_url 时以 Markdown 链接 Connect Outlook Mail 分享;需要新增邮箱时分享 add_account_url;断开时运行 outlook-mail disconnect 并分享 disconnect_url。切勿打印令牌、Cookie 或密钥。
限制与规则:消息 ID 为不透明 Graph 值,须原样复用;发送前确认收件人、主题与正文;回复前确认正文及是否 --reply-all。delete、mark-read、mark-unread 可在明确请求下直接执行。认证失败时停止并运行 --status,必要时按 needs_reauth 重新授权。不得向用户展示原始 Graph 标识符或内部字段。兼容字段 date 为邮件接收时间,展示时优先用 message_received_at.user_local。被权限隐藏的字段并非为空,需说明权限限制。