145 lines
5.8 KiB
Markdown
145 lines
5.8 KiB
Markdown
Air2 - 高性能多线程下载引擎
|
||
Air2 是一个用 Python 编写的高性能命令行下载工具，支持多线程分块下载、断点续传、速度限制和美观的实时进度显示。它提供交互式命令行界面和单命令快速执行两种模式，兼顾易用性与强大性能。
|
||
|
||
✨ 主要优点 (中文)
|
||
1. 🚀 极致下载速度
|
||
智能多线程分块：根据文件大小动态调整分块数量与大小（最大支持 16 MB 块），充分利用带宽资源。
|
||
|
||
大缓冲区优化：单次写入使用 1 MB 缓冲区，减少磁盘 I/O 开销。
|
||
|
||
高并发连接池：每个任务支持多达 16 个并发连接，线程池可容纳 200 个工作线程，大幅提升大文件下载效率。
|
||
|
||
2. 🛠️ 完善的断点续传与错误恢复
|
||
支持从已下载的部分继续下载，避免重复传输。
|
||
|
||
内置智能重试机制（指数退避），对网络波动、临时服务器错误自动恢复。
|
||
|
||
下载前预分配文件空间，减少磁盘碎片并提高写入稳定性。
|
||
|
||
3. 📊 美观且实时的进度反馈
|
||
基于 Rich 库构建的终端界面，提供彩色进度条、实时速度、预计剩余时间等关键信息。
|
||
|
||
支持多任务并行下载时独立显示每个任务的进度，一目了然。
|
||
|
||
速度计算采用平滑算法，避免数据剧烈跳动。
|
||
|
||
4. 💻 两种使用模式，灵活高效
|
||
交互式命令行 (CLI)：输入 air2 进入专属 Shell，支持命令补全（需 prompt_toolkit）、历史记录、快捷键操作。
|
||
|
||
单命令直接执行：如 air2 add <URL> 可直接添加并开始下载，适合脚本调用或一次性任务。
|
||
|
||
5. 🔧 丰富的功能选项
|
||
可自定义线程数、输出目录、分块大小、速度限制、超时时间等。
|
||
|
||
内置 ZIP 解压功能，下载完成后可一键解压。
|
||
|
||
任务管理完善：暂停、恢复、取消、移除（可选删除文件）均支持。
|
||
|
||
6. 📦 轻量依赖，易于部署
|
||
仅依赖 requests、urllib3、rich 等少量第三方库，安装简单。
|
||
|
||
支持 Python 3.7+，跨平台运行（Windows / macOS / Linux）。
|
||
|
||
✨ Key Advantages (English)
|
||
1. 🚀 Blazing Fast Downloads
|
||
Intelligent Multi-threaded Chunking: Dynamically adjusts chunk count and size (up to 16 MB per chunk) based on file size to fully saturate network bandwidth.
|
||
|
||
Large Buffer Optimization: Uses a 1 MB write buffer to minimize disk I/O overhead.
|
||
|
||
High-Concurrency Connection Pool: Up to 16 connections per task and a 200-worker thread pool dramatically accelerate large file downloads.
|
||
|
||
2. 🛠️ Robust Resume & Error Recovery
|
||
Seamless resume from interrupted downloads, avoiding redundant data transfer.
|
||
|
||
Built-in exponential backoff retry mechanism handles transient network issues and server errors gracefully.
|
||
|
||
File space pre-allocation reduces disk fragmentation and improves write stability.
|
||
|
||
3. 📊 Beautiful, Real-Time Progress Feedback
|
||
A Rich-powered terminal interface featuring colored progress bars, live speed, ETA, and more.
|
||
|
||
Multiple concurrent tasks are displayed independently with clear, organized status updates.
|
||
|
||
Smoothed speed calculation prevents erratic display fluctuations.
|
||
|
||
4. 💻 Dual-Mode Operation for Maximum Flexibility
|
||
Interactive CLI: Run air2 to enter a dedicated shell with command completion (via prompt_toolkit), history navigation, and keyboard shortcuts.
|
||
|
||
Single-Command Execution: Use commands like air2 add <URL> directly for scripting or one-off tasks.
|
||
|
||
5. 🔧 Extensive Feature Set
|
||
Fine-grained control over thread count, output directory, chunk size, speed limit, timeout, etc.
|
||
|
||
Built-in ZIP extraction for immediate unpacking of downloaded archives.
|
||
|
||
Full task lifecycle management: pause, resume, cancel, and remove (with optional file deletion).
|
||
|
||
6. 📦 Lightweight & Cross-Platform
|
||
Minimal dependencies (requests, urllib3, rich), easy to install via pip.
|
||
|
||
Compatible with Python 3.7+ and runs on Windows, macOS, and Linux.
|
||
|
||
📦 安装 / Installation
|
||
基础安装 (Basic)
|
||
bash
|
||
pip install requests rich urllib3
|
||
推荐安装 (增强体验 / Enhanced Experience)
|
||
bash
|
||
pip install prompt_toolkit # 启用命令补全与历史记录 / Enables command completion & history
|
||
将 air2.py 放置于 PATH 目录下，或直接运行 python air2.py。
|
||
|
||
🕹️ 使用方法 / Usage
|
||
交互模式 (Interactive Mode)
|
||
直接运行程序进入交互式 Shell：
|
||
|
||
bash
|
||
python air2.py
|
||
然后输入命令进行操作：
|
||
|
||
text
|
||
add https://example.com/file.zip --threads=16
|
||
start a1b2c3d4
|
||
pause a1b2c3d4
|
||
resume a1b2c3d4
|
||
cancel a1b2c3d4
|
||
remove a1b2c3d4 --delete
|
||
unzip a1b2c3d4 /path/to/extract
|
||
list
|
||
status
|
||
help
|
||
exit
|
||
命令行模式 (Command-Line Mode)
|
||
支持单条命令直接执行，无需进入交互界面：
|
||
|
||
bash
|
||
# 添加并开始下载
|
||
python air2.py add https://example.com/file.zip --threads=16 --output=./downloads
|
||
|
||
# 开始已有任务
|
||
python air2.py start a1b2c3d4
|
||
|
||
# 暂停任务
|
||
python air2.py pause a1b2c3d4
|
||
|
||
# 列出所有任务
|
||
python air2.py list
|
||
|
||
# 解压已完成的 ZIP 任务
|
||
python air2.py unzip a1b2c3d4 ./extracted
|
||
⚙️ 添加任务选项 / Task Options
|
||
选项 说明 (中文) Description (English)
|
||
--threads=N 下载线程数 (默认 8) Number of download threads (default 8)
|
||
--output=DIR 保存目录 (默认当前目录) Output directory (default current dir)
|
||
--chunk-size=SIZE 分块大小，支持 K/M/G 后缀 (如 10M) Chunk size with optional K/M/G suffix (e.g., 10M)
|
||
--speed-limit=KB 速度限制 (KB/s)，0 表示不限速 Speed limit in KB/s, 0 for unlimited
|
||
🗂️ 项目结构 / Project Structure
|
||
text
|
||
air2.py # 主程序文件
|
||
air2.log # 运行日志 (自动生成)
|
||
~/.air2_history # 命令历史记录 (需 prompt_toolkit)
|
||
🤝 贡献与反馈 / Contributing
|
||
欢迎提交 Issue 和 Pull Request 来改进 Air2。遇到问题或有功能建议，请在 GitHub 仓库中留言。
|
||
|
||
📄 许可证 / License
|
||
本项目采用 MIT License 开源，欢迎自由使用和修改。
|