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-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘使用Surface Cli检查我的Gmail收件箱，找出过去一小时内来自“alert@system.com”且标题包含“ERROR”的邮件，并将摘要输出为JSON。’，它会调用配置好的命令行工具，连接到你的Gmail账户，执行查询，并返回结构化的邮件信息列表。或者，
对AI说：‘帮我把这份系统报告通过Outlook发送给项目组所有成员。’，它会构造包含收件人、主题、正文和附件的JSON指令，调用Surface Cli完成邮件的发送。
介绍
Surface Cli 是一款专注于邮件处理的命令行工具，它解决了开发者在集成邮件功能时需要为不同邮件服务（如Gmail、Outlook、通用IMAP/SMTP）编写和维护多套接口代码的痛点。它通过提供一个统一的、JSON优先的契约，让开发者可以用一套标准化的方式读取邮件、发送邮件以及执行其他邮件相关操作，极大简化了邮件功能的开发流程。
使用方式非常直接，开发者通过命令行调用该工具，并传入符合其契约的JSON配置或指令，即可完成对指定邮箱账户的邮件操作。无论是获取收件箱列表、发送带附件的邮件，还是管理邮件标签，都可以通过结构化的JSON数据来驱动，使得邮件处理逻辑可以轻松地集成到自动化脚本或后端服务中。
这个Skill特别适合需要在其应用中集成邮件功能的开发者，尤其是那些需要同时支持多个邮件服务提供商，或者希望将邮件处理逻辑抽象为标准化、可配置流程的团队。它省去了为每个邮件服务单独适配API的繁琐工作。
在使用时，建议开发者先仔细阅读其JSON契约文档，确保请求格式正确。由于涉及邮箱账户的敏感权限，务必妥善保管访问令牌等认证信息，避免在日志或代码中明文暴露。对于需要极高实时性或复杂邮件客户端交互的场景，可能需要考虑更专门的解决方案。
核心特点
其核心优势在于提供了跨Gmail、Outlook及通用IMAP/SMTP协议的单一、标准化的JSON接口，避免了为不同邮件服务编写和维护多套适配代码。
注意事项
不适合需要复杂邮件客户端交互（如富文本编辑器、实时聊天）或处理非标准、私有邮件协议的场景。
常见问题
Surface Cli支持哪些邮箱服务？
支持Gmail、Outlook以及任何标准的IMAP/SMTP邮件服务。
使用前需要如何配置邮箱访问权限？
需要为对应的邮箱服务（如Gmail）创建应用并获取OAuth凭证或应用专用密码（对于IMAP）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli-x-5/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli-x-5/raw/index.md（查看排版版本）