Breeze 桌面端安装指南 Windows 安装器 macOS Homebrew 与 DMG Linux Flatpak DEB

Windows

最简单的方式：下载 windows-installer-v版本号.exe，双击运行即可完成安装。安装完成后可以从开始菜单或桌面快捷方式启动 Breeze。

安装器默认安装到 C:\Program Files\Breeze\（系统盘）。如果需要自定义路径，安装过程中选择「自定义安装」。

卸载

打开「设置 → 应用」，找到 Breeze，点击卸载。或在程序安装目录下运行 unins000.exe。

注意：v3.0.32 修复了 Windows 安装后无法删除的问题。如果你遇到卸载时报错，升级到最新版后重试。

macOS

macOS 提供两种安装方式：

方式一：Homebrew（推荐）

如果你已经安装了 Homebrew 包管理器，一条命令搞定：

brew tap deretame/breeze
brew install --cask breeze

升级也一条命令：

brew upgrade breeze

彻底卸载（同时清理应用数据）：

brew uninstall --zap breeze

方式二：DMG 手动安装

1. 下载 Breeze-macOS-v版本号.dmg
2. 双击 DMG 文件，将 Breeze.app 拖入「应用程序」文件夹
3. （可选）删除 DMG 文件释放空间

macOS Gatekeeper 放行

由于 Breeze 没有进行 Apple 开发者签名，首次打开时系统可能弹出「应用已损坏」或「无法验证开发者」警告。处理方法：

方法一（终端）：

xattr -cr /Applications/Breeze.app

方法二（Finder）：在「应用程序」文件夹中按住 Control 键点击 Breeze 图标，从弹出菜单选择「打开」，系统会提示确认，点击「打开」即可。

Linux

Linux 提供 Flatpak 和 DEB 两种格式，根据你的发行版选择：

DEB（Debian / Ubuntu 系推荐）

下载 breeze_版本号_amd64-v版本号.deb 后，在终端执行：

sudo apt install ./breeze_*.deb

apt 会自动处理系统依赖。安装完成后从应用菜单启动，或终端输入：

breeze

卸载：

sudo apt remove breeze

Flatpak（跨发行版推荐）

Flatpak 通过统一的运行时格式解决不同发行版的兼容性问题。需要先在系统上配置 Flatpak 环境，然后安装：

# 安装 GNOME 50 运行时（Breeze 依赖）
flatpak install flathub org.gnome.Platform//50

# 安装 Breeze
flatpak install --user breeze.flatpak

# 运行
flatpak run io.github.windy.breeze

中国大陆用户加速建议：Flatpak 运行时可以配置 CERNET 镜像源提升下载速度。

托盘图标

v3.0.30 起，macOS 和 Linux 版本新增托盘图标功能，支持在后台最小化到系统托盘而不是完全退出。Windows 托盘图标一直存在。

桌面端特有优势

桌面端比手机版多了几个方便的点：

• 更大屏幕可以展示更多书架条目
• 键盘快捷键翻页和切来源
• 多窗口并行阅读不同漫画
• 适合批量下载和整理书架

下一节：首次启动与权限。