核心功能
Surface CLI 是一款开源的命令行邮件客户端，采用本地优先架构，为 Gmail 和 Outlook 提供统一的 JSON-first 接口。其核心优势在于绕过传统 IMAP 限制——特别适用于企业或学校 Outlook 账户（通常仅支持 Web 界面、需要管理员配置或完全关闭 IMAP）。
显著优点
双平台统一支持：通过单一 CLI 同时管理 Gmail 和 Outlook，输出标准化的 JSON 格式，便于脚本自动化和 AI 工具集成。thread_ref 和 message_ref 机制提供稳定的引用标识，支持跨会话的线程追踪。
零配置 Outlook 访问：无需 IMAP/SMTP 设置，也不需管理员审批，通过浏览器会话模拟实现企业邮箱访问。session start 创建的"温热会话"可显著加速连续查询。
完整的邮件操作链：覆盖从读取（fetch-unread、search、read）、处理（mark-read、archive、rsvp）到撰写（send、reply、forward、--draft）的全生命周期，支持附件独立下载。
智能摘要与身份识别：可选集成外部 LLM 进行邮件摘要，通过 account identity 配置提升 needs_action 判断准确性。
潜在局限
- 隐私权衡：启用 LLM 摘要功能时，邮件内容将发送至外部模型提供商
- Outlook 并发限制：温热会话依赖浏览器资源，高并发场景下性能受限
- 冷启动成本：首个 Outlook 查询仍需支付邮箱初始化开销
- 配置复杂度：
config.toml中的writes_enabled、send_mode等安全开关需要用户理解
适合人群
- 需要自动化处理 Gmail + Outlook 多邮箱的技术用户
- 企业/学校 Outlook 用户受限于 IMAP 封闭环境
- 构建邮件工作流（自动分类、提醒、批量处理）的开发者
- 偏好 CLI 界面且重视数据本地存储的用户
风险与注意事项
写入安全：默认只读，发送邮件需显式启用 writes_enabled。测试应使用 --draft 模式，仅向 test_recipients 配置的安全地址发送。
OAuth 会话管理：Outlook 依赖浏览器会话，长期运行需处理令牌刷新。auth status 检查应在关键操作前执行。
轮询策略：官方建议线程监视 5-10 分钟、主题监视 30-60 分钟、收件摘要 2-4 小时，避免过度 polling 触发服务商限制。
附件处理：read 命令不自动下载附件，需显式调用 attachment download，防止意外大文件传输。