m1guelpf/Exo
效率工具用 Rust 编写的 macOS 原生 Gmail 客户端,通过你自己的 OAuth 客户端直连 Gmail。
项目介绍
Exo 是一个用 Rust 编写的 macOS Gmail 客户端。它直接连接 Gmail,不经过第三方服务器,走原生技术路线,避免 Electron 或 webview 带来的开销。它还会申请 Google Calendar 和 People API 权限,因此邮件、日历和联系人都在客户端内处理。
它面向希望在桌面本地收发 Gmail、并且愿意自己配置 Google OAuth 客户端的 macOS 用户。项目明确说明灵感来自 Superhuman,目前处于很早期的阶段。
快速使用
- 从最新 Release 下载
.dmg,打开后把 Exo 拖入 Applications。 - 在 Google Cloud 控制台 创建项目,并为项目启用 Gmail API、Google Calendar API 和 People API。
- 在 Google Auth Platform 配置应用:在 Branding 填写名称等信息,在 Audience 发布应用(保持在 Testing 状态会每 7 天被登出),在 Clients 创建 Desktop app 类型的客户端。
- 下载客户端 JSON 文件并放到指定位置:
mkdir -p ~/Library/Application\ Support/Exo
mv ~/Downloads/client_secret_*.json ~/Library/Application\ Support/Exo/google-oauth-client.json
- 打开 Exo,用 Google 登录,接受「未验证应用」提示,并允许所有请求的权限;在 Google 授权页取消任何一项权限都会导致登录失败。
从源码构建需要 Rust 1.98+、Xcode 27 和 Ruby 4.0(含 Bundler),执行 bundle install、bundle exec fastlane build,再打开 target/release/Exo.app,构建步骤见说明。测试用 cargo test --workspace 运行,走的是本地 mock Gmail 服务。
使用约束
- 只支持 macOS;分发形式是
.dmg,构建依赖 Xcode 和 Fastlane。 - 需要授予 Gmail、Calendar 和 People 的 OAuth 权限,包括收发和管理邮件、修改过滤器与签名、管理日历、读取联系人和组织目录。
- 你必须自己创建并维护 Google Cloud 项目和 OAuth 客户端,项目本身不提供共享凭据。
- 本地构建使用 ad hoc 签名,每次重新构建后 macOS 可能请求钥匙串访问权限;可通过
EXO_SIGN_IDENTITY指定签名身份。 - 作者说明代码几乎全部由自动化工具生成(主要是 Claude Opus 5.5),未经人工审查正确性和安全性,原文见说明。
- 采用 MIT 许可证;随包字体、图标、照片及移植代码的许可见 THIRD_PARTY_NOTICES.md。
HotRepo 点评
Exo 于 2026-11-22 出现在 HotRepo 新项目榜的 Rust 语言列表中,在约一小时的统计窗口内新增 12 星(114 至 114 为记录的窗口值),尚未进入全部语言日榜。观察窗口很短,只能说明项目刚出现时获得了初步关注,不足以判断趋势。README 坦诚说明代码由 AI 生成且未经审查,尝试把它用于真实邮箱之前,项目阶段和随之而来的信任问题是最需要权衡的部分。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。