📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：173+
Superlocal 是一个桌面优先的邮件客户端，底层是一套 Provider 无关的 Inbox SDK：把多个邮箱汇入统一收件箱，同时让每个账号的身份、凭据与 Provider 能力彼此隔离。首次运行即通过真实 Inbox SDK 启动两个虚构邮箱——不需要任何Provider凭据、OAuth配置或机器专属服务，先体验再接入。
它延续了本地优先工具的路线（同类的还有 Portless本地命名URL 与 OpenClaw本地AI助手）：数据在你自己的存储里，Provider只是可插拔的能力来源。
| 设计 | 说明 |
|---|---|
| 统一收件箱 | 多邮箱一个界面，账号身份互不混淆 |
| 凭据隔离 | 每个Provider独立保管身份与凭据，能力按Provider声明 |
| 零凭据启动 | 虚构邮箱演示真实SDK链路，降低上手门槛 |
| 持久化布局 | host.sqlite、邮件库、runtime-secrets.json 同处一处，升级不丢配置 |
# 需要 Bun 1.4+
bun --no-env-file install
bun --no-env-file run start # 打开 http://localhost:5178
# 热更新开发模式
bun --no-env-file run dev
# Ctrl-C 同时停止客户端与本地hostdocker compose up -d --build --wait
# 打开 http://localhost:5178
# 命名卷 superlocal-state 内：
# /persist/superlocal.local.json # 安装配置
# /persist/data/mock/ # 虚构邮件与生成的key
# /persist/data/real/ # 选择真实模式后创建镜像只含构建产物，配置与邮件都在卷里。接入真实Provider时在保留的配置中设置（Google OAuth client secret 走运行时环境变量，不进镜像）；升级时切勿替换实例ID或key。
Superlocal 是一个桌面优先的邮件客户端，底层是一套 Provider 无关的 Inbox SDK：把多个邮箱汇入统一收件箱，同时让每个账号的身份、凭据与 Provider 能力彼此隔离。首次运行即通过真实 Inbox SDK 启动两个虚构邮箱——不需要任何Provider凭据、OAuth配置或机器专属服务，先
先用虚构邮箱把界面和SDK链路跑通，再逐个接入真实Provider