Surface Cli
统一JSON接口的多邮箱CLI管理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Surface Cli。 它的用途是：统一JSON接口的多邮箱CLI管理工具 完整的 Skill 内容见：https://321skill.com/skills/surface-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用Surface CLI读取Gmail收件箱中最近10封含“发票”关键词的邮件，提取发件人、主题和正文，并以JSON格式输出。' 它会执行 `surface mail list --query 'subject:发票' --limit 10 --format json` 并返回结构化结果。或者：'将Outlook中来自support@example.com的所有未读邮件自动回复“感谢您的来信，我们会在24小时内回复”并标记为已读。' 它会调用 `surface mail reply` 和 `surface mail mark` 组合命令完成。
介绍
Surface CLI 解决的是多邮箱、多协议（Gmail、Outlook、通用IMAP/SMTP）邮件操作碎片化问题。传统邮件客户端或脚本需要针对不同服务商编写不同代码，而 Surface CLI 将所有邮件操作抽象为一个 JSON 优先的统一契约，让开发者只需一个命令即可完成收发、搜索、标记、归档等操作，大幅降低邮件自动化门槛。
使用方式极其简单：安装后，通过 surface mail 子命令配合 JSON 格式的参数即可。例如 surface mail list --query 'from:alice@example.com' --format json 会返回结构化的邮件列表。支持管道和脚本集成，方便嵌入 CI/CD 或自动化工作流。
适合需要频繁与邮件交互的后端开发者、运维工程师、全栈开发者，以及搭建自动化客服、工单系统的智能体开发者。尤其适合那些希望将邮件处理标准化为 JSON 接口，以便于 AI Agent 或微服务调用的场景。
建议先配置好 IMAP/SMTP 凭据或 OAuth 令牌，并注意保护敏感信息。由于是 CLI 工具，非技术用户可能需要学习基本命令行操作。对于简单的一次性邮件读取，使用传统邮箱网页版可能更快捷。
核心特点
与 openpyxl、mailgun 等邮件工具不同，Surface CLI 坚持 JSON-first 契约，所有操作（读、写、搜索、标记）都通过统一 JSON 结构完成，无需学习不同服务商的 API；同时原生支持 Gmail、Outlook、IMAP/SMTP 三种协议，真正做到一个命令管所有邮箱。
注意事项
不适合需要图形界面或拖拽操作的邮件管理场景，也不支持高级邮件规则（如自动转发、过滤规则）的配置。
常见问题
如何配置Gmail OAuth？
在 Gmail 开发者控制台创建 OAuth 客户端后，运行 `surface mail auth --provider gmail` 按提示完成授权即可。
支持哪些邮箱服务商？
支持 Gmail、Outlook/Office365，以及任何支持 IMAP/SMTP 协议的邮箱（如 QQ邮箱、163邮箱等）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli/raw/index.md（查看排版版本）