# Github-Downloader

**Repository Path**: ilovecode2018/Github-Downloader

## Basic Information

- **Project Name**: Github-Downloader
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[English](README.md) 

# Github-Downloader 介绍

Github-Downloader 是一个基于 PyQt5 开发的图形化 GitHub 加速下载工具，通过多个代理服务器加速 GitHub 文件的下载，支持多线程下载和实时速度显示。工具界面简洁美观，操作直观，支持多平台使用。

## ✨ 核心功能

- 🚀 **多代理支持**：集成 ghfast.top、gh-proxy.net 等加速代理，也可选择直连下载
- 🔄 **多线程下载**：支持 1-16 个下载线程，大幅提升下载速度
- 📊 **实时监控**：显示下载进度、速度和文件大小，进度条直观展示
- 📝 **详细日志**：带时间戳和颜色标记的操作日志，便于调试和追踪
- 💾 **历史记录**：自动保存下载历史，最多保留100条记录
- 🛠️ **智能解析**：自动从 GitHub 链接提取文件名，支持多种链接格式
- ⏸️ **下载控制**：可随时停止正在进行的下载任务

## 📋 环境要求

- Python 3.6 及以上版本
- Windows/macOS/Linux 操作系统
- 网络连接正常

## 🚀 安装步骤

### 1. 克隆项目

```bash
git clone https://github.com/YuxuanBai1/Github-Downloader.git
cd Github-Downloader
```

### 2. 安装依赖

```bash
pip install PyQt5 requests threading
```

## 📖 使用指南

### 1. 运行程序

直接运行主程序：

```bash
python github-downloader.py
```

### 2. 界面布局说明

| 区域           | 功能说明                                 |
| -------------- | ---------------------------------------- |
| **标题栏**     | 显示程序名称 "GitHub Downloader"         |
| **速度显示区** | 实时显示当前下载速度，下方显示进度百分比 |
| **下载链接区** | 选择代理类型，输入 GitHub 文件链接       |
| **进度显示区** | 显示下载进度条、已下载/总大小、状态信息  |
| **设置区**     | 设置下载线程数（1-16），选择保存路径     |
| **控制按钮区** | 开始下载、停止下载按钮                   |
| **日志区**     | 显示详细的操作日志，可清空日志           |

### 3. 操作步骤

1. **输入下载链接**
   - 在下载链接输入框中粘贴 GitHub 文件链接
   - 示例：`https://github.com/YuxuanBai1/Luogu-Plus/releases/download/v1.0.1/Luogu.Plus.crx`

2. **选择代理服务器**
   - `ghfast.top`：推荐的 GitHub 加速代理
   - `gh-proxy.net`：备选加速代理
   - `直连`：不使用代理直接下载（可能速度较慢）

3. **设置下载参数**
   - 拖动滑块设置线程数（1-16，默认为4）
   - 点击"浏览"按钮选择文件保存位置（默认为下载文件夹）

4. **开始下载**
   - 点击"开始下载"按钮启动下载任务
   - 实时查看下载进度和速度
   - 可随时点击"停止下载"按钮中止任务

5. **查看结果**
   - 下载成功会显示"下载完成"状态
   - 下载日志会记录所有操作信息
   - 文件保存在指定位置

## 🔧 支持的链接格式

- 发行版文件：`https://github.com/用户/仓库/releases/download/版本/文件名`
- 原始文件：`https://raw.githubusercontent.com/用户/仓库/分支/路径`
- 代码压缩包：`https://codeload.github.com/用户/仓库/格式/分支`
- 仓库主页：`https://github.com/用户/仓库`

## ⚠️ 注意事项

1. **网络连接**：确保网络可以正常访问选择的代理服务器
2. **文件权限**：确保有权限写入选择的保存文件夹
3. **链接格式**：输入完整的 GitHub 文件链接，程序会自动处理加速
4. **线程设置**：线程数过多可能被服务器限制，建议使用4-8线程
5. **临时文件**：下载过程中会在目标文件夹生成临时文件，下载完成后自动合并和删除

## 🔍 常见问题

### Q: 下载速度很慢怎么办？
A: 尝试切换不同的代理服务器，或调整下载线程数。某些网络环境下直连可能更快。

### Q: 下载中途出错怎么办？
A: 检查网络连接，确保代理服务器可用，然后重新开始下载。临时文件会被自动清理。

### Q: 程序启动后界面显示异常？
A: 确保安装了正确的依赖库：`pip install PyQt5 requests threading`

### Q: 无法获取文件大小或链接无效？
A: 检查输入的 GitHub 链接是否有效，确保文件存在且可访问。

### Q: 下载完成但找不到文件？
A: 检查设置的保存路径，确保有写入权限。文件会以原文件名保存。

## 📄 许可证

本项目采用 MIT 许可证开源，可自由修改、分发和商用，详见 LICENSE 文件。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。

**注意**：本项目仅用于学习和个人使用，请遵守 GitHub 的服务条款和相应代理服务的使用规定。