# superdownload

**Repository Path**: xeri_chen/superdownload

## Basic Information

- **Project Name**: superdownload
- **Description**: 智能下载加速工具 — 覆盖 GitHub/HuggingFace/PyPI/npm/Docker/Go/Rust/Maven/APT 等 16 大类 31 子类的国内镜像源，并行测速选最快节点，支持 aria2c/curl 双后端。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Super Download（超级下载加速）

智能 URL 路由、镜像加速、多后端下载引擎。覆盖 **16 大类 30 子类** 国内镜像源，为 AI Agent 提供一键加速下载能力。

## 支持品类

| # | 品类 | 首选镜像 | 探测 |
|---|------|---------|------|
| 1 | GitHub Clone | ghfast.top | git |
| 2 | GitHub Raw | ghfast.top | http |
| 3 | GitHub Release | ghfast.top | http |
| 4 | GitHub Archive | ghfast.top | http |
| 5 | HuggingFace | hf-mirror.com | http |
| 6 | PyPI | mirrors.ustc.edu.cn | http |
| 7 | npm | registry.npmmirror.com | http |
| 8 | Docker Hub | docker.1ms.run | http |
| 9 | Go | goproxy.cn | http |
| 10 | Rust | mirrors.ustc.edu.cn | http |
| 11 | APT | mirrors.aliyun.com | http |
| 12 | Conda | mirrors.tuna.tsinghua.edu.cn | http |
| 13 | Maven | mirrors.cloud.tencent.com | http |
| 14 | RubyGems | gems.ruby-china.com | http |
| 15 | Flutter | flutter-io.cn | http |
| 16 | Homebrew | mirrors.ustc.edu.cn | git |

完整列表见 [SKILL.md](SKILL.md) 和 [references/mirror_sources.md](references/mirror_sources.md)。

## 安装

```bash
# 克隆仓库
git clone https://gitee.com/xeri_chen/superdownload.git
cd superdownload

# 安装依赖（需要 uv）
uv sync
```

## 快速开始

```bash
# 测速
uv run super-dl probe https://example.com/file.tar.gz

# 查看镜像路由
uv run super-dl route https://github.com/user/repo/archive/main.zip

# 加速下载
uv run super-dl fetch https://github.com/user/repo/releases/download/v1.0/app.tar.gz -o ./app.tar.gz

# GitHub 仓库全自动下载（archive fallback）
uv run super-dl fetch https://github.com/user/repo -o ./repo
```

## 工作流程

```
输入 URL → 品类识别 → 镜像路由 → 并行测速 → 最优下载
```

- **Phase 1**: URL 分类，匹配 30 子类的正则模式
- **Phase 2**: 模板替换生成候选镜像 URL，并行 HTTP Range GET 测速
- **Phase 3**: aria2c（16 并发）或 curl 执行下载
- **Phase 4**: Git clone 失败 → archive zip fallback

## 配置

编辑 `references/mirrors.yaml` 增删镜像源，无需修改代码：

```yaml
categories:
  pypi:
    detect_pattern: "(pypi\\.org|files\\.pythonhosted\\.org)"
    mirrors:
      - "https://your-mirror.example.com/simple"  # 新增
      - "https://mirrors.ustc.edu.cn/pypi/simple"
```

## 测试

```bash
uv run pytest -v
```

## 致谢

本项目参考了 [SkillHub - 通用镜像加速](https://www.skillhub.cn/skills/general-mirror-acceleration) 的设计思路。

## 许可证

本项目采用 [MIT](LICENSE) 许可证。