简体中文 | 英文

[!NOTE] 由于学业原因，本项目近期开发进度有所放缓。

[!TIP] 如果您想在 Windows 7 上使用 Ghost-Downloader-3，请下载 v3.8.0-Windows7 版本。

[!IMPORTANT] 欢迎加入 Ghost Downloader 用户群：756042420

[!TIP] 如果您愿意帮助翻译 Ghost Downloader，欢迎加入 Crowdin 项目：ghost-downloader

关于项目

• 一个出于热爱而打造的下载工具，也是我的第一个 Python 项目 😣
• 最初是为了帮助一位 Bilibili 创作者整合资源而开发的 😵‍💫
• 具备 IDM 风格的智能分块功能，无需文件合并，同时支持 AI 智能加速 🚀
• 得益于 Python 的🐍 易用性，未来将开放插件🧩 支持（插件 API 目前仍在完善中...）

平台	必需版本	架构	兼容
🐧 Linux	glibc 2.35+	x86_64/arm64	✅
🪟 Windows	7 SP1+	x86_64/arm64	✅
🍎 macOS	13.0+	x86_64/arm64	✅

[!WARNING] Qt 6.6+ 不再支持不包含 AVX 指令集的 CPU。

[!TIP] Arch Linux AUR 支持：社区维护的软件包 ghost-downloader-bin 和 ghost-downloader-git 现已可用（维护者：@zxp19821005）

路线图

• ✅ 全局设置
• ✅ 更详细的下载信息
• ✅ 计划任务支持
• ✅ 浏览器扩展优化
• ✅ 全局限速
• ✅ 内存使用优化
• ✅ 磁力链接 / BT 下载
• ✅ 强大的浏览器扩展功能
• ✅ 强大的插件支持（API 仍需稳定化...）
• ✅ 智能加速
• ✅ 使用 AsyncIO 减少样板代码
• ❌ 事件驱动架构重构（Actor Model）
• ❌ 增强任务编辑功能（如将多个会话绑定到一个任务等强大功能）
• ❌ eD2k 协议支持

访问 Open issues 查看所有已请求的功能（以及已知问题）。

赞助商

	由 SignPath.io 提供免费代码签名服务，证书由 SignPath Foundation 颁发

参与贡献

贡献让开源社区成为一个学习、启发和创造的绝佳场所。您的任何贡献都备受赞赏。

如果您有建议，可以 fork 该仓库并创建 pull request。您也可以直接开一个带有“Enhancement”标签的问题。别忘了给这个项目点个 star⭐！再次感谢！

1. Fork 项目
2. 创建您的功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开 pull request

感谢所有参与本项目的贡献者！

翻译贡献者

XiaoYouChR 13713 字

ReM2812 1010 字

i0ntempest 947 字

Dima88888 115 字

截图

许可证

本项目采用 GPL v3.0 许可证进行发布。更多详情请参阅 LICENSE 文件。

版权所有 © 2025 XiaoYouChR。

联系方式

• 电子邮件 - XiaoYouChR@qq.com
• QQ 群 - 756042420

参考资料

• aioftp 基于 asyncio 的 FTP 客户端/服务器
• desktop-notifier 用于跨平台桌面通知的 Python 库
• libtorrent 高效且功能完善的 C++ BitTorrent 实现
• loguru 旨在为 Python 带来愉悦日志记录体验的库
• niquests 自动支持 HTTP/1.1、HTTP/2 和 HTTP/3，同时包含 WebSocket 和 SSE。
• Nuitka Python 编译器
• PyQt-Fluent-Widgets 功能强大、可扩展且优雅的 Fluent Design 风格组件库
• PySide6 官方 Python 模块

致谢

• @zhiyiYo 非常出色，为本项目提供了大量帮助。
• @空糖_SuGar 制作了项目的横幅。

Ghost-Downloader-3 快速上手指南

Ghost-Downloader-3 是一款基于 AI 智能加速的下一代跨平台多线程下载器，支持 HTTP、磁力链接及 BT 下载，具备类似 IDM 的智能分片技术且无需手动合并文件。

环境准备

系统要求

请确保您的操作系统满足以下最低版本及架构要求：

平台	最低版本要求	支持架构	备注
Linux	glibc 2.35+	x86_64 / arm64	✅ 兼容
Windows	Windows 7 SP1+	x86_64 / arm64	Win7 用户请下载 v3.8.0-Windows7 版本
macOS	macOS 13.0+	x86_64 / arm64	✅ 兼容

⚠️ 硬件警告：由于依赖 Qt 6.6+，本软件不支持缺少 AVX 指令集的旧款 CPU。

前置依赖

• 普通用户：直接下载预编译包即可使用，无需安装 Python 环境。
• 开发者/源码运行：
  • Python (推荐最新稳定版)
  • PyQt6 / PySide6
  • 其他依赖库将在首次运行或构建时自动处理（参考项目 requirements 文件）。

💡 Arch Linux 用户：可直接通过 AUR 安装社区维护包： ghost-downloader-bin (二进制版) 或 ghost-downloader-git (开发版)。

安装步骤

方式一：下载预编译包（推荐）

1. 访问 Releases 页面。
2. 根据您的操作系统和架构下载对应的安装包：
   • Windows: 下载 .exe 安装程序或便携版压缩包。
   • Linux: 下载 .AppImage, .deb, .rpm 或源码压缩包。
   • macOS: 下载 .dmg 或 .zip 文件。
3. 运行安装程序或解压后即可启动。

方式二：从源码运行（开发者）

如果您希望体验最新功能或参与开发，可克隆仓库运行：

# 1. 克隆项目
git clone https://github.com/XiaoYouChR/Ghost-Downloader-3.git
cd Ghost-Downloader-3

# 2. 创建虚拟环境 (可选但推荐)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. 安装依赖
pip install -r requirements.txt

# 4. 启动应用
python main.py

基本使用

Ghost-Downloader-3 提供图形化界面（GUI），操作直观简单。

1. 启动软件

双击应用程序图标或在终端运行启动命令。

2. 新建下载任务

• 复制链接：在浏览器中复制文件链接（HTTP/HTTPS）、磁力链接（Magnet）或种子文件。
• 自动捕获：若已安装并启用浏览器扩展，点击网页下载链接时会自动弹出下载窗口。
• 手动添加：
  1. 点击主界面左上角的 "+" 号或 "新建任务" 按钮。
  2. 粘贴链接到输入框。
  3. 点击 "开始下载"。

3. 管理任务

• 暂停/继续：在下载列表中点击对应任务的暂停/播放图标。
• 限速设置：进入 全局设置 -> 速度限制，可设置全局最大下载/上传速度。
• 计划任务：支持设置特定时间自动开始或暂停下载任务。

4. 高级功能

• AI 智能加速：默认开启，软件会自动优化连接策略以提升下载速度。
• 插件扩展：未来版本将支持更多插件（目前 API 仍在稳定中），可通过设置菜单管理。

提示：如需反馈问题或获取技术支持，可加入官方 QQ 群：756042420。