FateLightX/AriaFlow

# AriaFlow

[中文](#中文) | [英文](#english)

## 中文 AriaFlow 是 macOS 原生 SwiftUI 下载客户端，使用本地随包的 `aria2-next` 引擎处理 HTTP/HTTPS、磁力链接、ED2K 和 Torrent 下载。 ### 功能 - 下载队列、开始/暂停、删除、在 Finder 中显示和复制链接。 - 任务历史、搜索、状态筛选、菜单栏速度和 Dock 进度。 - 可配置保存位置、并发数、分片数、单服务器连接数和上下行限速。 - 可加载本地 BT Peer Blocklist，并在运行时重新加载或清除。 - 本地 JSON-RPC 引擎、Apple Silicon 与 Intel sidecar，以及离线本地设置。 ### 系统要求 - macOS 14 或更高版本；macOS 26 会启用 Liquid Glass 效果。 - 源码构建需要 Xcode 26 或兼容的 Swift 6.2 工具链。 ### 下载与安装 从 [Releases](https://github.com/FateLightX/AriaFlow/releases) 下载 ZIP 和对应 `.sha256` 校验文件。当前开发版本使用 ad-hoc 签名，未经过 Apple 公证。首次打开时，Gatekeeper 可能拦截应用：在 Finder 中按住 Control 点击 `AriaFlow.app`，选择“打开”，然后再次确认。 ### 构建与验证 ``` swift build --disable-sandbox scripts/package_app.sh scripts/verify_release.sh ``` 构建产物位于 `dist/AriaFlow.app`、`dist/AriaFlow-.zip` 和校验文件。更多 sidecar 安装和校验说明见 [docs/SIDECAR.md](docs/SIDECAR.md)。 ## 英文 AriaFlow 是 macOS 的原生 SwiftUI 下载客户端。它运行一个随包的本地 `aria2-next` 引擎，用于 HTTP/HTTPS、磁力链接、ED2K 和 Torrent 下载。 ### 功能 - 下载队列，支持开始、暂停、删除、在 Finder 中显示和复制链接操作。 - 任务历史、搜索、状态筛选、菜单栏速度和 Dock 进度。 - 可配置的保存位置、并发数、分片数、单服务器连接数和传输限制。 - 可加载本地 BT Peer Blocklist，支持运行时重新加载和清除。 - 带有 Apple Silicon 和 Intel sidecar 的本地 JSON-RPC 引擎；无需账户或云服务。 ### 要求 - macOS 14 或更高版本；在 macOS 26 上会启用 Liquid Glass 样式。 - 从源码构建需要 Xcode 26 或兼容的 Swift 6.2 工具链。 ### 下载与安装 从 [Releases](https://github.com/FateLightX/AriaFlow/releases) 下载 ZIP 及其对应的 `.sha256` 文件。当前的开发者构建使用 ad-hoc 签名，未经公证。Gatekeeper 可能会阻止首次启动；在 Finder 中按住 Control 点击 `AriaFlow.app`，选择“打开”，然后确认。 ### 构建与验证 ``` swift build --disable-sandbox scripts/package_app.sh scripts/verify_release.sh ``` 构建产物将写入 `dist/AriaFlow.app`、`dist/AriaFlow-.zip` 及其校验和。有关内置引擎的安装和验证，请参阅 [docs/SIDECAR.md](docs/SIDECAR.md)。 ## 开发文档 - [AI / agent recovery context](AGENTS.md) - [架构与模块边界](docs/ARCHITECTURE.md) - [Sidecar 替换与运行时契约](docs/SIDECAR.md) - [发布验证](docs/RELEASE_CHECKLIST.md) ## 致谢 感谢 [AnInsomniacy/aria2-next](https://github.com/AnInsomniacy/aria2-next) 和 [AnInsomniacy/motrix-next](https://github.com/AnInsomniacy/motrix-next)。 ## 许可协议 AriaFlow 源代码基于 [MIT License](LICENSE) 提供。内置的 `aria2-next` 引擎是独立的 GPL-2.0 组件；有关其源码、校验和和再分发细节，请参阅 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) 和 [docs/SIDECAR.md](docs/SIDECAR.md)。

标签：aria2, BT 下载, GUI 客户端, macOS 应用, SwiftUI, 下载工具