Breeze

# Breeze

## 💖 鸣谢与赞助

感谢以下组织对开源社区的支持：

| [![Sentry Logo](asset/sentry-wordmark-dark-400x119.png)](https://sentry.io/) | 本项目由 **[Sentry](https://sentry.io/)** 提供全方位的错误监控赞助，其 Sponsored Business 计划帮助我们更快速地捕获并修复崩溃，提升用户体验。 |
| :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |

同时感谢 **[Aidoku](https://github.com/Aidoku/Aidoku)** 项目，本项目在 iOS / macOS 图片超分实现上参考了 Aidoku 的思路与模型处理方式。

### ☕ 个人赞助（爱发电）

☕ 感谢每一位愿意赞助的朋友，你们的支持是持续维护下去的重要动力。

👉 **[前往爱发电赞助作者：afdian.com/a/deretame](https://afdian.com/a/deretame)**

<img src="asset/aifadian.jpg" alt="爱发电赞助二维码" width="260" />

> - 赞助不能兑换具体权益，比如指定开发某个功能、要求优先修复问题，所有的需求和反馈都会按正常流程处理，不会因为赞助而区别对待。
> - 项目的发展方向、功能规划和更新节奏由作者综合决定，赞助不附带决策权，还请理解。
> - 赞助是出于自愿的赠与，请根据自身情况量力而行，赞助后无法退还。
> - 最后，作者会尽力保持维护，但无法承诺永远不断更。如果某天更新放缓，还请多包涵；你的支持一定会让更新更有动力。

## 项目开发指南

插件开发相关文档请参阅：<https://deretame.github.io/plugin-dev-docs/>

插件列表：<https://github.com/deretame/Breeze-plugin-list>

<details>
<summary>当前已收录插件（点击展开）</summary>

<!-- PLUGIN-LIST-START -->
包子漫画 Plus e-hentai 禁漫天堂 漫画柜 NoyAcg 如漫画 蛙漫3 包子漫画 哔咔漫画 拷贝漫画 hitomi JJ漫画 Komiic nhentai 绅士漫画 WEBTOON 再漫画 拷贝漫画 Copy4000 코사이트 MangaDex WeebCentral zero搬运网 禁漫天堂(mumushu0501-boop) Toomics
<!-- PLUGIN-LIST-END -->

</details>

> **注：** 插件功能仍在beta阶段，可能会有较大改动，不建议基于此开发插件，仅适合学习用途。

### 1. 核心工具链安装

在开始之前，请确保基础工具已正确安装并处于最新稳定版：

- **Flutter SDK**: 需通过 `flutter doctor` 验证。
- **Rust Toolchain**: 通过 `rustup` 安装，并添加相应的交叉编译 Target（如 `aarch64-linux-android`）。
- **LLVM / Clang**: 由于涉及 `rustqjs` 等需要解析 C 头的库，必须安装 LLVM 环境（Windows 下推荐使用 `choco install llvm` 或从官网下载），并确保 `LIBCLANG_PATH` 环境变量已配置。

### 2. 环境变量配置

针对不同的编译需求，必须在系统中配置以下环境变量：

| 变量名               | 说明                                  | 示例路径 (参考)                                   |
| :------------------- | :------------------------------------ | :------------------------------------------------ |
| **JAVA_HOME**        | 编译 Android windows 和 Linux必需     | `C:\Program Files\Android\Android Studio\jbr`     |
| **ANDROID_NDK_HOME** | Rust 交叉编译 Android 库必需          | `...\AppData\Local\Android\Sdk\ndk\29.0.14206865` |
| **LIBCLANG_PATH**    | 供 `bindgen` (Rust) 生成 FFI 绑定使用 | `C:\Program Files\LLVM\bin`                       |

> **注意**：请确保 `PATH` 变量中包含 `javac` 和 `clang` 的二进制文件路径。

### 3. 依赖初始化流程

1.  **根项目依赖**:
    在项目根目录下执行，下载 Flutter 相关依赖：
    ```bash
    flutter pub get
    ```

### 4. 各平台特定说明

- **Android**: 确保 `local.properties` 中已指向正确的 SDK 路径。
- **Windows/Linux**: 确保安装了 Visual Studio (C++) 或相应的 GCC 工具链，以支持 Rust 的本地编译。

# 🚀 如何安装

### 📱 Android/鸿蒙

- 前往 [Releases 页面](https://github.com/deretame/Breeze/releases) 下载 `app-arm64-v8a-release.apk`。

  > **注意**：中国大陆内因未经审核应用可能无法安装，可以使用[GBox](https://gboxlab.com/i18n/zh-Hant/)、[出境易](https://www.chujingapp.com/)或[GSpace](https://gspaceteam.com/)（鸿蒙系统可通过应用商店下载）的方式绕过系统安装器，以安装应用。

### 🪟 Windows

- 下载 `windows-installer.exe` 后直接运行即可完成安装。

### 🐧 Linux

Linux 版本同时提供