技能介绍

要解决什么问题

很多企业仍在使用 本地部署的 Microsoft Exchange，运维上常见两种尴尬：IMAP/SMTP 端口被防火墙封掉，脚本和自动化只能绕道；而 EWS（Exchange Web Services） 走 HTTPS 443，配合 NTLM 认证，往往仍能在内网或 VPN 内连通。本技能面向这类场景：在不依赖传统邮件客户端协议的前提下，用命令行 读信、搜索、发信，并支持多邮箱账号切换。

如何工作

配置写在 ~/.config/ews-exchange/.env。连接成功后，可用子命令完成日常操作：

test：验证 EWS 地址与认证是否正常
check：拉取最新邮件，支持 --limit、--folder、--recent（如 30m、7d）、--unread
fetch：按 check 输出的序号或 UID 取完整正文
search：按发件人、主题、未读、时间窗口等过滤
send：指定 --to、--subject，可选 HTML、附件、抄送等
folders / list-accounts：列文件夹与已配置账号；多账号用环境变量前缀，命令前加 --account

本地 Exchange 里 EWS_DOMAIN 填 Active Directory 域（例如 UCH），不是邮件域名；自签证书常见，需设 EWS_VERIFY_SSL=false。EWS URL 可通过 Autodiscover（https://autodiscover.your-company.com/Autodiscover/Autodiscover.xml）确认。

适用边界与注意点

技能针对 Exchange On-Premise + EWS，不是通用的 Graph API 或纯 SaaS 方案。认证失败（401）时优先核对 AD 域与用户名格式；500 或 Invalid Request 多与错误 EWS 端点或 RequestServerVersion 有关；超时则检查 443 与 VPN。常用文件夹 ID 如 inbox、sentitems、junkemail 等，与 Exchange 约定一致，便于脚本指定 --folder。