Surface Cli
通过统一JSON接口读写Gmail、Outlook等邮件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Surface Cli。 它的用途是：通过统一JSON接口读写Gmail、Outlook等邮件 完整的 Skill 内容见：https://321skill.com/skills/surface-cli-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用Surface Cli检查我的Outlook收件箱里过去一小时内标记为重要的未读邮件，并把摘要输出为JSON。'，它会调用配置好的命令，连接到你的Outlook账户，执行查询过滤，并返回结构化的邮件信息。或者，你可以说：'通过Surface Cli向support@example.com发送一封状态报告邮件，并附上今天的日志文件。'，它会根据你的指令和JSON参数，通过配置的SMTP服务或Gmail API发送邮件。
介绍
Surface Cli 解决了开发者需要为不同邮件服务（如Gmail、Outlook、通用IMAP/SMTP）编写和维护多套代码的痛点。它提供了一个统一的命令行界面和JSON优先的契约，让用户可以用一套标准化的方式读取邮件、发送邮件、管理收件箱等。
使用时，你只需通过命令行调用相应的指令，并传入符合其JSON契约的参数，即可完成对各类邮件服务的操作。例如，你可以通过一条命令获取Outlook收件箱列表，再通过另一条命令向Gmail联系人发送邮件，而无需关心底层API的差异。
这个Skill非常适合需要在自己的应用或自动化流程中集成邮件功能的开发人员，特别是那些需要同时处理多个邮件服务商邮件的场景。无论是全栈开发者构建带有邮件通知功能的应用，还是运维工程师编写邮件监控脚本，都能从中受益。
建议在使用前，先配置好对应邮件服务的访问凭证（如OAuth令牌或应用密码）。由于它专注于邮件操作的标准化，对于需要深度定制邮件客户端UI或处理极其复杂邮件协议边缘情况的场景，可能需要结合其他工具。
核心特点
核心区别在于提供了跨Gmail、Outlook及通用IMAP/SMTP的单一、JSON优先的统一接口，避免了为每个邮件服务单独集成SDK的繁琐工作。
注意事项
不适合需要高度定制化邮件客户端界面或处理非标准邮件协议扩展的场景。
常见问题
如何用它读取Gmail邮件？
配置好Gmail API凭证后，使用命令行工具并传入JSON格式的查询参数即可获取邮件列表或内容。
支持发送带附件的邮件吗？
支持，通过JSON契约指定附件路径和邮件内容，即可通过统一的命令发送到配置的邮件服务。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli-x-4/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli-x-4/raw/index.md（查看排版版本）