Surface Cli
统一JSON接口读写Gmail/Outlook/IMAP邮件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Surface Cli。 它的用途是：统一JSON接口读写Gmail/Outlook/IMAP邮件 完整的 Skill 内容见：https://321skill.com/skills/surface-cli-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用Surface CLI读取Gmail收件箱中最近24小时内来自support@example.com的未读邮件，并按主题分类输出为JSON文件。' 它会执行 `surface mail read --unread --from support@example.com --since 24h --format json` 并将结果保存为JSON，方便后续分析或归档。
介绍
Surface CLI 是一个邮件命令行工具，解决开发者和运维人员在多邮箱环境中无法统一管理、操作邮件的问题。它通过 JSON-first 的契约设计，让你可以用同一套命令和数据结构处理 Gmail、Outlook 以及任何标准 IMAP/SMTP 邮箱，避免了为每个邮件服务单独编写脚本或适配不同 API 的繁琐工作。
使用方式非常简洁：在终端中执行 surface mail 命令，配合 JSON 格式的输入参数即可完成读取、发送、分类、回复等操作。例如，你可以用一条命令批量读取未读邮件并输出为 JSON，再通过管道传递给其他工具做进一步处理。所有交互都基于结构化数据，易于集成到自动化工作流中。
这个工具特别适合后端开发、运维工程师和全栈开发，尤其是那些需要批量处理客服工单、自动回复客户邮件、或者将邮件数据导入分析系统的场景。如果你经常用脚本管理邮箱，Surface CLI 能帮你把多邮箱操作统一到一个工具里，大幅减少重复劳动。
建议在以下场景中使用：自动化邮件处理流水线、CI/CD 中触发邮件通知、数据清洗前的邮件提取。注意，它不适合做图形化的邮件客户端，也不擅长处理带复杂排版或大量附件的邮件。如果只需要阅读邮件，建议使用常规邮件客户端。
核心特点
相比其他邮件 CLI（如 mutt、mblaze），Surface CLI 最大的区别是统一用 JSON 契约操作 Gmail、Outlook 和通用 IMAP/SMTP，无需为每个服务学习不同的命令或配置，且输出可直接被程序消费。
注意事项
不适合处理富文本邮件（如 HTML 渲染）、大附件下载或需要图形界面交互的邮件阅读场景。
常见问题
Surface CLI 支持哪些邮箱服务？
支持 Gmail、Outlook 以及任何标准 IMAP/SMTP 协议的邮箱，通过 JSON 配置统一接入。
如何用 Surface CLI 批量读取未读邮件？
执行 `surface mail read --unread --format json` 即可将未读邮件以 JSON 输出，方便后续处理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli-x/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli-x/raw/index.md（查看排版版本）