Surface Cli
通过JSON统一接口管理邮件的命令行工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Surface Cli。 它的用途是：通过JSON统一接口管理邮件的命令行工具 完整的 Skill 内容见：https://321skill.com/skills/surface-cli-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用Surface CLI读取Gmail收件箱中最近10封未读邮件，并将每封邮件的发件人、主题和正文摘要保存为JSON文件'，它会自动调用surface read命令，先获取邮件列表，再逐封提取内容，最终输出结构化数据，无需手动登录网页。
介绍
Surface Mail CLI 解决的是多邮箱（Gmail、Outlook、通用IMAP/SMTP）管理碎片化的问题。传统邮件客户端需要切换界面、配置不同协议，而它通过一个 JSON-first 契约将邮件读写、发送、搜索等操作统一为命令行指令，大幅减少重复劳动。
使用方式极简：安装后直接调用 surface 命令，传入 JSON 格式的请求体即可。例如读取收件箱只需指定邮箱和查询条件，返回结果也是结构化 JSON，方便与其他脚本或 AI 代理集成。支持批量操作、自动回复、邮件过滤等常见场景。
适合运维工程师、后端开发、客服人员以及需要自动化处理邮件的用户。如果你管理多个邮箱、需要定时处理邮件工单、或者希望将邮件功能集成到自动化工作流中，这款工具能显著提升效率。
建议先在小范围测试 JSON 模板，熟悉字段含义后再大规模使用。注意敏感信息（如密码、API Key）不要明文写在命令中，推荐使用环境变量或密钥管理服务。
核心特点
与同类邮件 CLI 工具相比，Surface Mail CLI 的核心区别在于其 JSON-first 契约设计，所有操作（读、写、搜索、过滤）都通过统一的结构化数据格式完成，无需记忆多个参数或子命令，特别适合需要与 AI 代理、脚本或 CI/CD 流水线集成的高级用户。
注意事项
不适合需要富文本编辑、图形界面交互或复杂邮件排版（如 HTML 自定义模板）的场景，且不支持 OAuth 之外的第三方应用授权方式。
常见问题
支持哪些邮箱服务？
支持 Gmail、Outlook 以及任意标准的 IMAP/SMTP 邮箱。
如何安装 Surface CLI？
通过 npm 全局安装：npm install -g surface-cli。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surface-cli-x-2/raw/index.md 读取 Surface Cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surface-cli-x-2/raw/index.md（查看排版版本）