FAQ

Breeze 常见问题:
下载之前先看这几条

装不上、打不开、不知道选哪个文件——这几个问题占了绝大部分。 下面按「选文件 → 装机 → 插件 → 数据」的顺序排好了。

我该下载哪个文件?

手机选 Android APK(arm64-v8a);Windows 选 windows-installer.exe;Mac 用 Homebrew 或 DMG;iPhone / iPad 需要侧载 IPA;Linux 玩家优先用 Flatpak,能自动跟着 Release 更新,DEB 只是给不方便用 Flatpak 的发行版兜底。

文件名里的架构后缀别忽略:arm64-v8a 是近几年手机的主流,armeabi-v7a 给老 32 位设备,x86_64 给模拟器。装错架构会直接装不上。

安卓提示「无法安装 / 风险应用」怎么办?

大陆地区未经应用商店审核的 APK 可能被系统安装器拦截。可以用 GBox、出境易、GSpace 这类工具中转安装;鸿蒙设备也可以直接从应用商店搜索安装。

macOS 提示「应用已损坏,无法打开」?

因为应用没有做 Apple 公证签名,被 Gatekeeper 拦下了。终端执行一次即可解除隔离:

xattr -cr /Applications/Breeze.app

用 Homebrew 安装的话,brew install --cask breeze 之后同样可能需要这一步。

iOS 的 IPA 怎么装?

IPA 是未签名包,必须用侧载工具安装到自己的设备上:

  • AltStore:同一个 Wi-Fi 下自动续签,长期使用最省心
  • Sideloadly:手动签名,一次性安装用这个
  • TrollStore(巨魔商店):在支持的系统版本上可永久免签
插件是什么?必须装吗?

客户端本体不带任何漫画源,所有内容都由插件提供。装好客户端后,进「发现页 → 右上角设置 → 插件商店 → 浏览安装」即可浏览并安装;列表里没有的,可以用 bundle 地址网络安装。完整步骤见漫画源插件安装教程。

换句话说:不装插件,客户端能打开,但搜索和排行榜是空的。插件机制目前仍是 beta,接口可能调整。

换设备后收藏和阅读记录还在吗?

支持云端收藏,收藏夹可以跨设备漫游;同步也可以配置成你自己的 WebDAV,数据不进第三方服务器。设置里还能开启「本地收藏后自动云收藏」。

24 个插件里有 13 个声明了云端收藏能力,其余仅支持本地收藏。

图片加载不出来 / 某个源突然失效?

先确认是不是网络层的问题:设置里把 DoH 打开(四路并发),必要时再开 ECH 与域名前置。很多「图源挂了」其实是 DNS 被污染。

如果只有某一个源失效,多半是站点换了域名或改了页面结构——那属于插件该更新的事,去对应插件的仓库看有没有新版本。

这个网站和项目是什么关系?

本站是社区整理的下载与资料页,不是官方站点。所有内容来自以下公开来源:

  • 软件仓库 breeze-project-org/Breeze 的 README 与仓库元数据
  • GitHub Releases 中的安装包、体积与 SHA-256
  • 插件索引仓库的 plugins_data.json(名称、作者、版本、图标)
  • 插件开发文档站的目录与示例代码

所有安装包都直接指向官方 Release,本站不托管任何安装包与漫画内容。若与官方信息不一致,以官方为准。

关于本站

一个资料页,不是官方站

这里只做三件事:把安装包指对地方、把插件列全、把文档入口收在一处。

安装包直链官方

所有下载按钮都指向 GitHub Release 的原始资源地址,本站不缓存、不转存、不二次打包,版本号与文件体积也都取自 Release。

插件列表同步索引

插件名称、作者、版本、图标都来自索引仓库的 plugins_data.json。索引每小时刷新,本站随资料更新。

不托管任何内容

客户端与插件都不存储、不分发漫画本体,所有页面内容来自第三方站点本身。使用时请自行确认行为符合所在地法律法规。

问题解决了吗?

没解决的话,去 GitHub Issues 搜一下——大部分安装问题都已经有人问过并给了答案。