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-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我检查Outlook收件箱里来自“support@company.com”的未读邮件，并把主题和发件时间列出来。’，它会调用Surface Cli Skill，连接到你的Outlook账户，过滤并返回符合条件的邮件列表。你还可以说：‘将Gmail中带有“Invoice”附件的邮件下载到指定文件夹’，Skill会执行相应的邮件搜索和附件下载操作。
介绍
Surface Cli Skill 解决了开发者在处理不同邮件服务（如Gmail、Outlook、通用IMAP/SMTP）时，需要对接多个API、编写重复代码的痛点。它提供了一个统一的JSON-first命令行接口，让开发者可以用一套标准化的方式读取邮件、发送邮件、管理收件箱等。
使用方式非常简单，开发者只需安装此Skill，即可在AI助手（如Claude Desktop）中通过自然语言指令操作邮件。例如，你可以直接说“查看我Gmail收件箱的最新邮件”，AI会调用此Skill将指令转换为对Surface CLI的调用，并返回结构化的邮件数据。整个过程无需手动处理OAuth认证或不同服务商的API差异。
这个Skill非常适合需要将邮件处理功能集成到自动化流程中的开发者，比如需要监控客服邮箱、自动回复确认邮件、或是从邮件中提取数据进行分析的场景。它尤其适合那些希望用代码（特别是通过JSON）来批量、自动化管理邮件的用户。
使用建议是，虽然它支持主流邮件服务，但在处理企业级Exchange或需要复杂邮件规则时，功能可能有限。注意事项包括：你需要提前在Surface CLI中配置好对应邮件账户的访问凭证；对于需要高度定制化邮件解析或涉及敏感数据的操作，建议结合其他工具进行二次开发和验证。
核心特点
核心区别在于提供了一个“JSON-first”的统一契约，将Gmail、Outlook、IMAP/SMTP等多种邮件服务的操作抽象成单一、标准化的JSON接口，避免了为每个服务单独适配代码。
注意事项
不适合需要处理复杂邮件客户端逻辑（如富文本编辑、高级规则过滤）或深度集成特定邮件服务商高级功能的场景。
常见问题
Surface Cli支持哪些邮件服务？
支持Gmail、Outlook以及任何标准的IMAP/SMTP邮件服务。
使用前需要做什么准备？
需要先在本地安装并配置好Surface mail CLI，并完成对应邮件账户的授权。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli-x-3/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli-x-3/raw/index.md（查看排版版本）