Skip to content
项目

QingJ01/Pebble has 608 GitHub stars and 56 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:44 UTC. Last push 2026-11-14.

这些数字如何统计

实测星标增长

24小时
0
7天
更新延迟
15天
更新延迟
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

A small yet beautiful email client.

开发工具

README.zh-CN.md

原文

Pebble logo

Pebble

一个本地优先的桌面邮件客户端,让收件箱更安静、更清晰,也更可控。

English · 发布版本 · 许可证

Release License Build Platform

项目简介

Pebble 是一个使用 Rust、Tauri 和 React 构建的桌面邮件客户端。它默认把邮件数据、搜索索引、附件、规则和应用设置保存在本机。

Pebble 的设计目标很直接:

  • 邮箱应该清晰、快速、安静。
  • 邮件工作流应该本地优先,而不是被云端仪表盘绑住。
  • 隐私控制应该明确可见,并且可以按单封邮件临时放宽。
  • 搜索、稍后提醒、规则和看板应该协同工作,而不是散落在不同工具里。

Pebble 目前支持 Gmail、IMAP、POP3,以及实验性的 Outlook 账户。

主要特性

本地优先与隐私

  • 使用本地 SQLite 数据库存储邮件、文件夹、标签、规则和设置。
  • 使用本地 Tantivy 全文索引提供快速搜索。
  • 附件保存在应用数据目录下。
  • OAuth token 和账号凭据会使用设备本地密钥加密。
  • 不包含遥测。
  • 网络请求只发生在你启用的功能中:邮件同步、翻译、可选的 WebDAV 设置备份。

邮件处理

  • 多账户聚合收件箱。
  • 支持 Gmail、IMAP、POP3 和实验性的 Outlook。
  • 支持线程视图和普通邮件列表视图。
  • 支持归档、删除、星标、标记已读、批量操作和恢复。
  • 支持邮件稍后提醒。
  • 支持全文搜索和高级过滤。
  • 支持规则引擎,自动整理邮件。
  • 邮件 CSS 渲染,支持内嵌样式。
  • 可选允许无效 TLS 证书,兼容自建邮件服务器。

效率工具

  • 本地通讯录,支持搜索、收藏、备注、多个带标签的邮箱地址,并可从邮件参与者一键创建或查看联系人。
  • 收件人自动补全会优先显示已保存联系人,并保留最近联系过的地址。
  • 支持导入和导出 vCard(.vcf),方便与其他通讯录迁移联系人。重新导入时按规范化邮箱合并;若本地姓名或备注非空,则优先保留本地内容。
  • 看板视图,包含 Todo、Waiting、Done 三列。
  • 命令面板和键盘优先导航。
  • 内置翻译能力,支持双语阅读和自定义快捷键(T 翻译选中文字,Ctrl+Shift+T 切换双语对照)。
  • 深色和浅色主题,支持壁纸背景。
  • 内置英文和中文界面。
  • 可选的本地文件导入/导出和 WebDAV 备份,用于同步联系人、设置、规则、看板卡片和看板备注。
  • 支持自动定时 WebDAV 备份,间隔可配置。

平台集成

  • macOS 原生红绿灯窗口控制按钮。
  • Windows 端可注册为默认邮件客户端(设置 > 通用)。
  • 托盘模式:窗口隐藏时仍会保持邮件同步运行。
  • 支持启动时隐藏到系统托盘。
  • 支持 mailto: 协议,可从外部应用唤起写信。

截图

收件箱
收件箱
看板
看板
深色模式
深色模式
设置
设置

技术栈

层级 技术
桌面框架 Tauri 2
后端 Rust
前端 React 19、TypeScript
状态管理 Zustand、TanStack Query
数据库 SQLite / rusqlite
搜索 Tantivy
样式 Tailwind CSS 和应用 CSS
国际化 i18next

开始使用

安装

你可以从 发布版本 页面下载预构建的桌面安装包。

Arch Linux 用户可以通过 AUR 安装 pebble-bin:

yay -S pebble-bin
# 或者
paru -S pebble-bin

环境要求

  • Rust stable
  • Node.js 18 或更新版本
  • pnpm 8 或更新版本
  • 当前平台所需的 Tauri 系统依赖

配置文件存储

默认情况下,Pebble 会把数据库、搜索索引、附件、日志、导入的背景图以及本地界面偏好存放在系统应用数据目录下。

你可以在 Pebble 启动前选择自定义或便携配置目录:

  • 设置 PEBBLE_PROFILE_DIR 为一个绝对路径。
  • 在 pebble.exe 旁边放置 pebble-profile.txt;第一行可以是绝对路径,也可以是相对于可执行文件目录的路径。
  • 在 pebble.exe 旁边创建 pebble-profile 目录,让 Pebble 数据保存在应用旁边。

选中的目录会在下次启动时生效。

开发环境

git clone https://github.com/QingJ01/Pebble.git
cd Pebble

pnpm install
cp .env.example .env

pnpm dev

pnpm dev 会启动 Vite 前端开发服务,并运行 Tauri 桌面应用。

构建

pnpm build
pnpm build:windows
pnpm build:macos
pnpm build:linux

桌面端构建产物会输出到 target/release/ 和 target/release/bundle/。 macOS 构建产物默认不签名,除非你自行配置签名流程。 将未签名的 macOS 构建复制到 /Applications 后,请先执行下面的命令再打开应用:

sudo xattr -cr /Applications/Pebble.app

OAuth 配置

Pebble 可以通过 OAuth 连接 Gmail 和 Outlook。IMAP 账户使用应用内配置的 IMAP/SMTP 凭据。

复制 .env.example 为 .env,然后填写你需要的提供商配置。

变量 说明
GOOGLE_CLIENT_ID Google OAuth 客户端 ID,推荐使用 Desktop app 类型。
GOOGLE_CLIENT_SECRET 可选。若 Google 登录时报 client_secret is missing,再填写该项。
MICROSOFT_CLIENT_ID Microsoft public/native app 客户端 ID。
MICROSOFT_CLIENT_SECRET 可选。public/native Microsoft 应用通常应留空。

常用命令

命令 用途
pnpm dev 以开发模式运行 Tauri 桌面应用。
pnpm dev:frontend 只启动 Vite 前端开发服务。
pnpm test 使用 Vitest 运行前端测试。
pnpm build:frontend 类型检查并构建前端。
pnpm build 为当前平台构建桌面应用。
pnpm build:windows 构建 Windows NSIS 安装包。
pnpm build:macos 构建未签名的 macOS .app 和 .dmg 包。
pnpm build:linux 构建 Linux .AppImage、.deb 和 .rpm 包。
cargo test -p pebble-mail 运行邮件模块测试。
cargo check 检查 Rust 工作区。

项目结构

Pebble/
|-- src/                    React 前端
|   |-- components/         通用 UI 组件
|   |-- features/           收件箱、写信、搜索、看板、设置等功能
|   |-- hooks/              React hooks 和查询工具
|   |-- lib/                IPC API、i18n、通用工具
|   `-- stores/             Zustand 状态管理
|-- src-tauri/              Tauri 应用和 IPC 命令
|-- crates/                 Rust 工作区
|   |-- pebble-core/        共享类型和错误定义
|   |-- pebble-store/       SQLite 持久化
|   |-- pebble-mail/        邮件提供商和同步逻辑
|   |-- pebble-search/      Tantivy 搜索索引
|   |-- pebble-crypto/      凭据加密
|   |-- pebble-oauth/       OAuth 2.0 和 PKCE
|   |-- pebble-rules/       规则引擎
|   |-- pebble-translate/   翻译提供商
|   `-- pebble-privacy/     HTML 清理和追踪保护
|-- tests/                  前端测试
`-- site/                   静态项目站点和截图

快捷键

快捷键 操作
J / K 在邮件列表中上下移动
Enter 打开选中的邮件
E 归档
S 切换星标
R 回复
A 回复全部
F 转发
C 写新邮件
/ 聚焦搜索
T 翻译选中文字
Ctrl+Shift+T 切换双语对照
Esc 关闭、取消或返回

快捷键可以在设置中查看和自定义。

Pebble Web

想要自托管的网页版?Pebble Web 提供与桌面版相同的功能,通过 Docker 部署,任何浏览器即可访问。

curl -fsSL https://raw.githubusercontent.com/QingJ01/Pebble-Web/main/docker-compose.yml -o docker-compose.yml && docker compose up -d

Pebble Web 共享相同的 Rust 核心代码和 React 前端。部署到你自己的服务器,随时随地访问邮件。

当前状态

Pebble 正在持续开发中。它可以用于日常测试,但邮件客户端会处理敏感数据,不同邮件服务商的行为也存在差异。测试新版本时,请为重要邮件保留备份,并在服务商网页端核对关键操作。

参与贡献

欢迎提交 issue 和 pull request。

代码改动请尽量保持聚焦;涉及行为变化时,请补充相应测试。提交前建议运行相关检查:

pnpm test
pnpm build:frontend
cargo check

许可证

Pebble 使用 GNU Affero General Public License v3.0 许可证。


由 QingJ 构建。
友情链接:LINUX DO