Releases: PFLcoolme/lingkong-mail
Release list
v0.2.3 — 全部收件箱 + 草稿同步
本版重点
全部收件箱
侧边栏顶部新增「全部收件箱」入口,把所有已添加账户的收件箱聚合成一个列表:
- 一个列表里同时看到所有账户的新邮件,按时间统一倒序
- 每封邮件头像右下角有彩色圆点标出所属账户,鼠标悬停显示账户名
- 未读筛选、附件筛选、列表内过滤、关键字搜索全部照常可用
- 只有添加了 2 个以上账户时入口才会启用(单账户没有聚合的必要)
- 该视图下的「同步」按钮会依次同步所有账户的收件箱
草稿同步到服务器
以前草稿只存在本机数据库里,换台设备打开邮箱就看不到自己写了一半的信。现在:
- 保存草稿时自动写入服务器草稿箱(IMAP
APPEND,带\Draft标记) - 同一份草稿反复保存不会堆重复件——会先删掉服务器上的旧副本再写新的
- 删除草稿或发送成功后,服务器上的副本一并清理,不会留下幽灵草稿
- 侧边栏草稿列表用图标显示同步状态:✓ 已同步 / 云朵待同步 / 感叹号失败(重新保存即可重试)
- 设置 → 常规可以关闭此功能(默认开启)
目前只做「本地 → 服务器」单向同步:在其他客户端新建的草稿不会自动出现在本地。
数据库升级
drafts 表新增了 4 个字段用于记录同步状态。老版本数据库会在启动时自动补齐,无需手动迁移,已有邮件与草稿不受影响。
测试
单元测试增至 94 个用例,本版新增:
- 聚合查询的 SQL 拼装(含「空集合必须返回空而不是查全部」这类边界)
- 草稿同步状态机:上传成功/失败、重复保存先删旧副本、草稿箱变更时不误删他处邮件
append返回false的失败语义(imapflow 不抛错,容易被误判成成功)
安装
chmod +x kongling-mail-0.2.3-x86_64.AppImage
./kongling-mail-0.2.3-x86_64.AppImageDebian / Ubuntu:
sudo dpkg -i kongling-mail-0.2.3-amd64.deb0.2.2 及之后版本可在应用内自动更新:设置 → 关于 → 检查更新。
v0.2.2 — 应用内自动更新
本版重点:应用内自动更新
从 v0.2.2 起,空灵邮箱可以自己升级自己——不用再去 GitHub 手动换包。
- 启动后静默检查新版本(仅打包环境生效)
- 设置 → 关于 里新增「检查更新」,可手动触发
- 发现新版本后可直接在应用内下载(带进度条)并重启安装
- 更新来源为本仓库的 Releases,校验
latest-linux.yml中的 sha512 后才安装
⚠️ v0.2.1 及更早版本不含更新模块,需要手动下载本版一次;此后即可自动升级。
自动发版流水线
仓库接入了 GitHub Actions:推送 v* 标签后自动完成「装依赖 → 重编译 better-sqlite3 → 类型检查 → 构建 → 打包 → 发布」,产物包括 AppImage、deb 和更新清单,无需本地手动打包。
其他调整
- 打包目标收敛为 x86_64(原配置里的 arm64 从未产出过成功产物,属静默失败)
- 安装包文件名固定为英文
kongling-mail-<版本>-<架构>.AppImage,避免中文名在下载链接里变成百分号编码,也保证自动更新能按名匹配 - README 补充自动更新与发版说明,修正此前「IDLE 未启用」等过时描述
安装
chmod +x kongling-mail-0.2.2-x86_64.AppImage
./kongling-mail-0.2.2-x86_64.AppImageDebian / Ubuntu 用户也可以直接安装 deb 包:
sudo dpkg -i kongling-mail-0.2.2-amd64.deb若系统未启用 FUSE,AppImage 可加
--appimage-extract-and-run运行。
环境要求
- Linux x86_64
- 建议安装
libsecret(加密存储邮箱密码;缺失时退化为混淆存储并提示) - 自动更新需要能访问 GitHub(受限网络下可在设置里手动下载安装包)
v0.2.1 — 应用锁 + 无边框毛玻璃 UI
版本亮点
应用锁
- 锁屏界面:启动时校验密码,密码以 scrypt 加盐哈希存储,不落明文
- 窗口从托盘重新唤出时自动重新锁定(修复了「关闭窗口到托盘后再打开可跳过验证」的漏洞)
- 托盘菜单新增「锁定应用」,可随时手动锁屏
- 锁定状态检查完成前不渲染主界面,避免解锁前界面一闪而过
- 支持修改密码 / 关闭应用锁,凭据走系统密钥环(libsecret)
无边框毛玻璃 UI
- 界面全面改用 MUI v9 重构
- 白色主调 + 黑白灰配色 +
backdrop-filter高斯模糊毛玻璃质感 frame: false彻底无边框,自绘可拖拽标题栏与最小化/最大化/关闭按钮
同期纳入的功能
标签、备份与恢复、EML 导入导出、发件箱、保存搜索、稍后提醒、模板、翻译与多语言、附件管理器、统计面板、列表密度与栏宽拖拽、mailto 协议关联
安装
下载下方 AppImage,赋权后直接运行:
chmod +x kongling-mail-0.2.1-x86_64.AppImage
./kongling-mail-0.2.1-x86_64.AppImage若系统未启用 FUSE,可改用
./kongling-mail-0.2.1-x86_64.AppImage --appimage-extract-and-run
环境要求
- Linux x86_64
- 建议安装
libsecret(用于加密存储邮箱密码;缺失时退化为混淆存储并给出提示)
邮箱配置提示
QQ / 163 / 126 等邮箱需要在网页端开启 IMAP/SMTP 并生成授权码,密码栏请填授权码而非登录密码。Gmail / Outlook 支持 OAuth2 授权登录。
v0.2.0 — 标签、备份、EML、统计面板
空灵邮箱 v0.2.0 — 功能扩展版
在 v0.1.0 基础上补齐了大量日常使用功能。
新增功能
- 标签:自定义标签与颜色,可给邮件打标并筛选
- 备份与恢复:一键导出/导入账户、设置与本地数据
- EML 导入导出:单封邮件导出为
.eml,也可从.eml导入 - 发件箱:发信队列与发送状态跟踪
- 保存搜索:把常用搜索条件存为虚拟文件夹
- 稍后提醒:邮件延后重新提醒
- 模板:可复用的邮件正文模板
- 撤销发送 / 定时发送:发送前延迟窗口,支持预约发送时间
- 附件管理器:设置内集中查看所有附件,按类型筛选、跳回原邮件
- 统计面板:邮件总量、近 30 天收发趋势、Top 发件人、各账户邮件量
- 列表密度与栏宽拖拽:紧凑/舒适两档,栏宽可拖拽并记忆
- mailto 协议关联:注册为系统默认邮件客户端,点击邮件链接直接打开撰写器
- 托盘常驻与开机自启,同步间隔可自定义
应用锁(初版)
- 支持设置解锁密码(scrypt 加盐哈希),启动时显示锁屏
⚠️ 此版本的锁只在应用启动时校验一次。若开启「关闭窗口最小化到托盘」,关闭窗口后再打开不会重新要求密码。该问题已在 v0.2.1 修复,介意的话请下载 v0.2.1。
安装
chmod +x kongling-mail-0.2.0-x86_64.AppImage
./kongling-mail-0.2.0-x86_64.AppImage若系统未启用 FUSE,可改用
--appimage-extract-and-run
v0.1.0 — 首个版本
空灵邮箱 v0.1.0 — 首个版本
面向 Linux 的本地桌面邮件客户端,Electron + React + TypeScript + SQLite,打包为单文件 AppImage。
协议支持
- IMAP + SMTP(imapflow / nodemailer)
- POP3(自研客户端,仅收件箱)
- Exchange EWS(SOAP,支持 Basic / Bearer 认证,暂不支持 NTLM)
- OAuth2:Gmail / Outlook,PKCE + 回环回调,走系统浏览器授权
- 自动配置发现:内置 15+ 服务商预设 → Mozilla autoconfig → DNS SRV → 端口探测
主要功能
- 多账户管理、文件夹树、邮件列表分页拉取
- 三栏布局:账户/文件夹 + 邮件列表 + 阅读窗格
- 撰写 / 回复 / 全部回复 / 转发,附件收发,草稿箱
- HTML 正文在 sandbox iframe + DOMPurify 消毒后渲染,默认拦截远程图片
- 批量标记已读 / 星标 / 移动 / 删除,并回写服务器
- 离线全文搜索:SQLite FTS5,中文按字切分
- 过滤规则引擎(发件人/收件人/主题/正文 × 包含/等于/正则 → 标记已读/星标/移动/删除/免打扰)
- 联系人自动收集与撰写时补全
- 新邮件桌面通知、定时轮询同步
- 凭据用系统密钥环(libsecret)加密,不可用时退化混淆存储
安装
chmod +x kongling-mail-0.1.0-x86_64.AppImage
./kongling-mail-0.1.0-x86_64.AppImage若系统未启用 FUSE,可改用
--appimage-extract-and-run
已知限制
- POP3 仅同步收件箱,不回写服务器状态
- EWS 未实现 NTLM
- 新邮件依赖定时轮询,未启用 IMAP IDLE