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 开源，欢迎自由使用和修改。