MailDesk v0.4.1

MailDesk v0.4.1

这是 v0.4 系列的稳定性收尾正式版，重点修复取件数量和 Windows 文件夹版更新流程，
并重新验证 Windows/macOS 双平台构建。

取件逻辑

• “立即取件”只限定当前账号，不再把邮件数量强制改成 1。
• 设置中的“每账号每次最多新增”统一用于立即取件、批量取件和定时取件。
• 设置为 0 表示不限制；增量取件仍会跳过本地已保存邮件，避免重复下载。
• IMAP 每批最多获取 25 封，Graph 每页最多 50 封并按需翻页，POP3 同样遵循设置上限。

Windows 更新修复

• 安装助手不再继承待替换的 MailDesk 工作目录，修复 onedir 目录被自身占用而回滚。
• 目录切换支持短时重试，失败后清理不再需要的暂存副本。
• 安装后继续等待新版健康回执；启动失败仍会自动恢复旧版并保留用户数据。
• 便携数据迁移会先释放旧目录锁再清理副本，避免 Windows 被自身锁文件阻塞。
• 启动探针和开发测试指定的独立数据目录不再导入用户的真实旧版数据。

发布签名轮换

• 原 v0.4.0 离线私钥不可用，v0.4.1 启用新的 Ed25519 发布公钥。
• v0.4.1 同时信任旧公钥和新公钥；新私钥仅以 Windows DPAPI 加密形式离线保存。
• v0.4.0 及更早版本需要人工安装 v0.4.1 一次；从 v0.4.1 开始恢复正常在线升级。

验证范围

• 全套单元、服务、集成和 GUI 自动化测试。
• Windows onefile/onedir WebEngine 邮件阅读器启动探针。
• Windows 更新助手的成功替换、健康检查、失败回滚和用户数据库保留测试。
• macOS Intel/Apple Silicon 原生构建、架构检查、WebEngine 启动和更新 ZIP 校验。

真实邮箱登录仍取决于用户提供的有效授权码/OAuth 授权、服务商协议开关和网络环境。

MailDesk v0.4.0

MailDesk v0.4.0

这是一次以界面清晰度、响应式布局和双平台包体精简为重点的正式更新。

界面与字体

• 关闭窗口选择改为紧凑的双卡片布局，移除固定大高度和无效空白。
• 选项标题、说明、图标和焦点状态分层呈现，支持键盘操作与托盘不可用提示。
• 字号调整由成比例放大改为层级偏移，18pt 下标题不再被放大到 45px。
• 工具栏、菜单和按钮使用 Qt 稳定字重，移除 650、720、750、800 等跨平台映射不一致的值。
• 用户可继续设置 9–18pt 字号与标准、清晰、半粗三档正文字重。

简化与包体

• 工作台账号健康度与收件趋势改用原生 QPainter 绘制，移除 QtCharts 及其 OpenGLWidgets 运行库。
• Windows 只保留实际使用的平台、图片、TLS、图标和网络状态 Qt 插件。
• WebEngine 语言包只保留简体中文与英文；完整 HTML 邮件、内嵌/远程图片和附件阅读能力不变。
• 移除 HTTPX 未使用的 HTTP/2、Trio、WebSocket、Brotli 和 Zstandard 可选运行库；Graph、OAuth、Webhook 与更新继续使用标准 HTTP/1.1 gzip/deflate。
• SOCKS5/HTTP 代理仍由小型路由与 socket 适配层实现，没有内置代理服务器。

验证

• 344 项自动化测试通过，3 项仅在对应原生平台执行。
• Windows onedir 打包后的 WebEngine、HTTPX 与 SOCKS 运行时启动探针通过。
• 以 v0.3.9 onedir 为基线，解包目录由约 333.9 MB 降至约 324.0 MB，测试 ZIP 由约 139.8 MB 降至约 134.3 MB。正式发行包还会包含许可证和说明文件，最终大小以 Release 资产为准。

Windows v0.3.9 文件夹版升级回滚热修复

部分 v0.3.9 文件夹版从 MailDesk\MailDesk.exe 启动后，旧安装助手会继承待替换目录作为工作目录，Windows 因此拒绝移动该目录并自动回滚。下载、签名和 SHA-256 校验本身没有失败。

已经安装 v0.3.9 文件夹版的用户请执行一次人工热修复：

1. 从托盘彻底退出 MailDesk，并在任务管理器确认没有 MailDesk.exe。
2. 下载 MailDesk-v0.4.0-hotfix-windows-x64-onedir.zip 并解压。
3. 保留旧安装位置同级的 MailDesk Data，只用压缩包里的新版 MailDesk 程序文件夹替换旧程序文件夹。
4. 启动新版 MailDesk\MailDesk.exe。账号、邮件、密钥和日志仍从原来的 MailDesk Data 读取。

热修复版让外部安装助手固定从安全父目录运行，目录切换增加 30 秒短时重试，失败后会删除无用暂存副本。后续从该热修复版执行在线升级时，不再继承这个 v0.3.9 错误。

MailDesk-v0.3.9-onedir-update-launcher.exe 是 5.5 KB 的临时安全启动工具：它不下载、不替换、不读取账号数据，只从正确的外层目录打开旧版；如只想复测旧版内置升级按钮可使用它。要安装包含根治代码的版本，仍推荐按上面的步骤使用 hotfix ZIP。

人工校验文件为 SHA256SUMS-hotfix.txt。以上热修复资产不会覆盖原有签名自动更新资产。

MailDesk v0.3.9｜稳定更新、便携数据与增量取件

MailDesk v0.3.9｜稳定更新、便携数据与增量取件

本版本重点解决 Windows/macOS 在线更新不生效、用户数据写入系统盘、重复取件速度慢，以及 macOS 安装包体积过大的问题。

主要更新

• Windows 与 macOS 发行版现在会把用户数据保存在软件同级的 MailDesk Data，更新事务保存在同级 .maildesk-update。下载、预复制和程序替换始终位于用户选择的同一磁盘。
• 首次启动会安全迁移旧系统目录中的数据库、密钥标记、日志和可选 EML 文件；迁移前执行 SQLite 完整性校验，不会复制旧更新缓存。
• 更新检查、下载和安装接管使用独立线程池，慢速 IMAP 任务不会再阻塞“重启并安装”。
• Windows onefile、onedir 与 macOS .app 更新时只替换程序文件，同级 MailDesk Data 不会被删除，更新失败回滚也不会影响用户数据。
• 持久化保存 IMAP UID、POP3 UIDL 和 Microsoft Graph Message ID，后续刷新只下载未收取的新邮件，Graph 不再重复请求旧邮件附件。
• “立即取件”只检查当前账号最新的一封新邮件，不必刷新全部账号。
• 网络图片改为并发自动加载，并校验真实 PNG/JPEG/GIF/WebP 文件签名；使用有容量限制的内存缓存，重复打开邮件更快。
• 阅读完整 MIME/Graph 邮件不要求额外保存 EML 文件；“保存 EML 原件”改为可选设置，减少长期磁盘占用。
• macOS 构建移除未使用的 Qt 3D、Multimedia、PDF、Virtual Keyboard 等 Framework，同时保留 WebEngine 邮件阅读器所需运行时。

更新说明

旧版本仍可能把 v0.3.9 暂存到原系统数据目录。v0.3.9 首次启动时会先向旧安装助手写入健康回执，再迁移数据，避免安装助手误判启动失败并回滚；旧缓存会在下一次启动时安全清理。

如果当前旧版点击“重启并安装”仍完全没有反应，请从本页面手动下载并安装 v0.3.9 一次。安装 v0.3.9 后，后续版本将使用新的同盘更新链路。

下载选择

• Windows 日常使用推荐 windows-x64-onedir.zip，启动速度更快。
• Windows 便携使用可选择 windows-x64-onefile.zip。
• Apple Silicon（M1/M2/M3/M4/M5）请选择 macos-arm64.dmg。
• Intel Mac 请选择 macos-x64.dmg。
• macOS ZIP 主要用于应用内自动更新，也可以手动解压使用。

验证与兼容性

• Windows 本地完整测试：337 项通过，3 项跳过。
• macOS Intel 与 Apple Silicon 均在 GitHub 原生 Runner 完成测试、构建和 WebEngine 实际启动验证。
• 所有正式包均写入 SHA256SUMS.txt，并由统一 Ed25519 签名清单绑定版本、文件名、体积和 SHA-256。
• 本版本为 Windows/macOS 同步正式版，不是预发行版本。
• macOS 包暂未使用 Apple Developer ID 签名和公证，首次打开可能需要在 Finder 中按住 Control 点击应用并选择“打开”。

MailDesk v0.3.8

macOS 闪退修复

• 修复 Intel 与 Apple Silicon 安装包中 QtWebEngine Helper/Resources 目录错误。
• 修复在 macOS 13+ 选择邮件、初始化邮件阅读器时发生的 SIGABRT 闪退。
• macOS 发布流程现在会在真实 .app 内初始化邮件阅读器，验证通过后才生成 DMG/ZIP。

下载说明

• Windows 日常使用推荐 windows-x64-onedir.zip，单文件便携使用选择 onefile.zip。
• Apple Silicon 选择 macos-arm64.dmg，Intel Mac 选择 macos-x64.dmg。
• macOS ZIP 用于应用内在线升级；DMG 用于手动安装。
• 当前 macOS 包未使用 Apple Developer ID 公证，首次打开请按仓库 docs/MACOS.md 操作。

验证

• 325 tests passed, 3 skipped
• Windows onedir/onefile WebEngine 冒烟测试通过，退出码 0
• macOS arm64/x64 原生构建与真实邮件阅读器启动测试通过
• 6 个更新资产均受 Ed25519 签名清单与 SHA-256 保护

MailDesk v0.3.7

MailDesk v0.3.7

本版本改进邮件发件人展示、全局字体可读性、深色模式一致性，并增强 IMAP 瞬时超时恢复能力。

主要变化

• 邮件数据库新增发件人名称字段；IMAP 与 Microsoft Graph 会同时保存发件人名称和邮箱地址。
• 主邮件列表、工作台最近邮件和独立阅读器明确展示发件人名称与邮箱；旧邮件缺少名称时仍会显示邮箱。
• 系统设置新增“外观与字体”，支持系统推荐字体、9–18pt 字号，以及标准、清晰、半粗、粗体四档字重。
• 字号设置会同步缩放主题中原先固定的小号文字，并即时应用到主窗口、设置、菜单和工具区域。
• 深色模式增加统一 Qt 调色板，并完善菜单、工具提示、消息框、文件选择器、进度条和横向滚动条的颜色与对比度。
• IMAP 连接超时保持 20 秒，登录、目录和正文命令超时调整为 90 秒，避免把较大邮件下载误判为连接失败。
• 无副作用的 IMAP 取件遇到瞬时超时时会关闭已损坏连接并安全重连一次；日志和界面会指出连接、登录、文件夹、搜索或正文下载阶段。
• 数据库平滑迁移到 schema v7，不会清空已有账号、邮件、附件或设置。

发布平台

• Windows x64：onefile 与 onedir ZIP。
• macOS 13+：Apple Silicon arm64 与 Intel x64 的 DMG，以及应用内更新 ZIP。
• 四种安装模式使用同一 v0.3.7 正式 Release 和同一 Ed25519 签名更新清单。

MailDesk v0.3.6

MailDesk v0.3.6

本版本修复确认“重启并安装”后长时间没有反应的问题。

主要变化

• 移除确认安装后的重复 GitHub Release 联网复核，避免网络慢、GitHub API 限流或连接异常阻止安装助手启动。
• 下载阶段仍完整执行 Ed25519 发布签名、GitHub SHA-256、文件大小和安全解压校验，安全等级不降低。
• 确认后立即切换为“正在准备安装”，在后台复核本地暂存文件并启动外部安装助手。
• 更新窗口实时显示“校验暂存文件”和“启动外部安装助手”两个阶段。
• 更新接管、失败原因和阶段状态写入 logs/app.log，便于排查。
• 保留安装助手握手、原子替换、启动健康检查和失败回滚。

旧版本说明

如果 v0.3.5 及更早版本点击“重启并安装”仍停在原界面，请从 Release 页面手动下载并覆盖安装 v0.3.6 一次。安装 v0.3.6 后，后续版本可以使用修复后的在线升级流程。

MailDesk v0.3.5

MailDesk v0.3.5

本版本增加可记忆的关闭窗口选择，并缩减 Windows 安装包体积，同时保留完整的 HTML 邮件、内嵌图片和远程图片阅读能力。

主要变化

• 首次点击主窗口关闭按钮时，可以选择“最小化到托盘”或“退出应用”。
• 支持“记住我的选择，不再询问”；也可以在设置 → 工作台中随时改回“每次询问”。
• 没有可用系统托盘时直接正常退出，不显示无法执行的托盘选项。
• Windows 构建移除未使用的 Qt 3D、PDF、Multimedia、虚拟键盘、QML 调试器和多余翻译资源。
• 保留 QtWebEngine 及其真实依赖，邮件 HTML、附件、内嵌图片和远程图片功能不降级。
• 裁剪后的 Windows onedir 解压体积较 v0.3.4 降低约 19.6%。

下载选择

• Windows 日常使用：MailDesk-v0.3.5-windows-x64-onedir.zip
• Windows 单文件：MailDesk-v0.3.5-windows-x64-onefile.zip
• Apple Silicon Mac：MailDesk-v0.3.5-macos-arm64.dmg
• Intel Mac：MailDesk-v0.3.5-macos-x64.dmg

所有自动更新包继续使用 Ed25519 签名清单和 SHA-256 双重校验。

MailDesk v0.3.4

MailDesk v0.3.4

本版本改善代理配置、更新入口和通用 IMAP 收件性能。Windows 与 macOS 继续使用同一正式版本；macOS 安装包需要由 GitHub Actions 的原生 macOS Runner 构建。

主要变化

• 设置 → 网络代理新增“添加单个代理”，支持命名、HTTP/SOCKS5、主机、端口、认证信息和默认代理。
• 代理密码继续使用设备本地密钥加密保存；默认代理在全局代理池中优先使用。
• 设置新增“系统更新”页面，可手动检查最新正式版，无需登录 GitHub。
• 通用 IMAP 从每封邮件一次 UID FETCH 改为每批最多 25 封，60 封邮件通常由约 60 次下载往返降为 3 次。
• 对不返回标准 UID 元数据或不支持批量 FETCH 的邮箱服务端保留逐封回退。
• 数据库架构升级到版本 6，旧数据库会自动增加代理名称和默认代理字段。

下载选择

• Windows 日常使用：MailDesk-v0.3.4-windows-x64-onedir.zip
• Windows 单文件：MailDesk-v0.3.4-windows-x64-onefile.zip
• Apple Silicon Mac：MailDesk-v0.3.4-macos-arm64.dmg
• Intel Mac：MailDesk-v0.3.4-macos-x64.dmg

自动更新仅接受带有效 Ed25519 签名且 SHA-256、版本、平台、架构和文件大小都与清单一致的正式 Release 资产。

MailDesk v0.3.3

MailDesk v0.3.3

这是 Windows 与 macOS 首次完全同步的正式版本。两个平台使用同一个版本号、同一个正式 GitHub Release，以及同一份离线 Ed25519 签名更新清单。

本次更新

• macOS Apple Silicon (arm64) 与 Intel (x64) 不再单独标记为预发行版。
• macOS 支持应用内后台下载、安装前再次确认、自动退出并重启。
• macOS 更新助手会在同一磁盘预复制新版 MailDesk.app，原子切换后等待启动健康回执；新版无法正常启动时自动恢复旧版。
• macOS 自动更新会校验发布者签名、SHA-256、文件体积、应用版本、Bundle ID、最低系统版本、Mach-O 架构、可执行权限及 Framework 相对符号链接。
• Windows 继续提供 onefile 与推荐的 onedir 两种 x64 包，并保留 v0.3.2 的后台安装握手、单实例保护与失败回滚修复。
• SHA256SUMS.txt 和签名清单统一覆盖 Windows/macOS 的全部正式发行资产。

下载选择

• Windows 日常使用：MailDesk-v0.3.3-windows-x64-onedir.zip
• Windows 单文件：MailDesk-v0.3.3-windows-x64-onefile.zip
• Apple Silicon Mac：MailDesk-v0.3.3-macos-arm64.dmg
• Intel Mac：MailDesk-v0.3.3-macos-x64.dmg

macOS ZIP 主要供应用内自动升级，也可以手动解压。macOS 包当前没有 Apple Developer ID 签名和公证，首次打开可能需要在 Finder 中 Control-点击应用并选择“打开”。

在线升级不需要登录 GitHub，但必须能够访问 GitHub，且应用所在目录需要当前用户具备写入权限。

MailDesk v0.3.2

MailDesk v0.3.2

这是在线升级可靠性修复版本。

本版修复

• 修复点击“重启并安装”后，界面在校验数千个 onedir 文件期间看似没有反应的问题。
• 最终发布状态复核、暂存文件完整性校验和安装助手接管均在后台执行，主界面保持响应。
• 更新窗口现在明确显示“复核发布状态”“校验安装文件”和“安装助手已接管”等阶段。
• 确认弹窗显示期间不再提前把按钮改成“正在启动安装”，取消后可正常再次操作。
• 增加单实例锁，阻止多个 MailDesk 进程同时访问本地数据库或占用同一安装目录。
• 移除程序未使用的 Qt Quick/QML 资源，避免更新暂存路径超过 Windows MAX_PATH 后被误判为文件缺失。
• 保留 Ed25519 发布签名、SHA-256、事务锁、启动健康回执和失败回滚机制。

下载建议

• 推荐日常使用 MailDesk-v0.3.2-windows-x64-onedir.zip，启动速度更快。
• 需要单个可执行文件时使用 MailDesk-v0.3.2-windows-x64-onefile.zip。
• 下载后可使用 Release 中的 SHA256SUMS.txt 核对文件。

升级提示

如果电脑上已经运行了多个旧版 MailDesk，请先通过各窗口托盘菜单完全退出，只保留一个实例后再执行在线升级。v0.3.2 开始会自动阻止重复实例。