# QiHangVideo_Download

**Repository Path**: mysheep0/QiHangVideo_Download

## Basic Information

- **Project Name**: QiHangVideo_Download
- **Description**: 一个用于下载启航教育平台视频的工具。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-08-27
- **Last Updated**: 2025-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python

## README

# 启航视频下载器 v3.1.2

一个用于下载启航教育平台视频的工具，支持MP4和M3U8格式视频的下载。

## 功能特性

- ✅ 支持启航教育平台登录
- ✅ 自动获取用户课程列表
- ✅ 支持MP4和M3U8格式视频下载
- ✅ 断点续传功能
- ✅ 多线程下载支持
- ✅ 命令行参数支持
- ✅ 详细的日志记录
- ✅ 模块化代码结构

## 项目结构

```
QiHangVideo_Download/
├── config/
│   └── settings.py          # 配置文件
├── core/
│   ├── app.py              # 主应用类
│   ├── auth.py             # 认证管理
│   └── client.py           # API客户端
├── lib/                    # 核心库文件
│   ├── course_service.py   # 课程服务
│   ├── video_service.py    # 视频服务
│   ├── download_service.py # 下载服务
│   ├── logger.py           # 日志工具
│   ├── path_utils.py       # 路径工具
│   └── input_handler.py    # 输入处理
├── tools/                  # 工具文件目录（存放exe文件）
│   ├── N_m3u8DL-CLI_v3.0.2.exe  # M3U8下载器（必需）
│   └── ffmpeg.exe               # 视频处理工具（必需）
├── logs/                   # 日志文件目录
├── videos/                 # 下载视频保存目录
├── main.py                 # 程序入口
├── path_check.py           # 路径检查脚本
├── QiHang.py               # 旧版本(已废弃)
├── requirements.txt        # 依赖列表
└── README.md              # 项目说明
```

### 自动迁移
运行迁移脚本自动完成目录结构调整：
```bash
python migrate_structure.py
```

## 安装使用

### 1. 环境要求

- Python 3.7+
- Windows系统

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 使用方法

#### 方式1：交互式使用

```bash
python main.py
```

#### 方式2：命令行参数

```bash
# 使用账号密码
python main.py --account 你的账号 --password 你的密码

# 自定义保存路径
python main.py --work-dir ./my_videos

# 自定义M3U8下载器路径
python main.py --m3u8-path ./N_m3u8DL-CLI_v3.0.2.exe

# 保存课程信息
python main.py --save-course-info

# 组合使用
python main.py -a 账号 -p 密码 -w ./videos -m ./m3u8dl.exe -s
```

### 4. 配置说明

可以在 `config/settings.py` 中修改以下配置：

- **DEFAULT_WORK_DIR**: 默认视频保存目录
- **DEFAULT_M3U8_PATH**: 默认M3U8下载器路径
- **DOWNLOAD_CONFIG**: 下载配置（线程数、重试次数等）
- **SAVE_CONFIG**: 保存配置（是否保存课程信息）
- **API_ENDPOINTS**: API端点配置

## 使用流程

1. 运行程序
2. 输入账号密码登录
3. 选择要下载的课程
4. 等待程序自动下载所有视频
5. 视频保存在指定目录下

## 注意事项

1. 确保网络连接正常
2. 确保账号有对应课程的访问权限
3. 下载的视频仅供个人学习使用，请勿传播
4. 视频链接有时效性，建议及时下载

## 路径问题解决方案

### 路径问题解决方案

### Windows系统路径问题
1. **自动路径转换**: 所有相对路径都会自动转换为绝对路径
2. **路径查找**: 自动在tools目录查找M3U8下载器

### 手动检查路径

运行路径检查脚本：
```bash
python path_check.py
```

### 必需工具文件

本项目需要以下两个工具文件，请确保它们存在于正确位置：

#### M3U8下载器
将 `N_m3u8DL-CLI_v3.0.2.exe` 放在 **tools/` 目录**：
- `tools/` 目录（**必需**）

#### FFmpeg工具
将 `ffmpeg.exe` 放在 **tools/` 目录**：
- `tools/` 目录（**必需**，与M3U8下载器同级）

#### 推荐目录结构
```
QiHangVideo_Download/
├── tools/
│   ├── N_m3u8DL-CLI_v3.0.2.exe  # M3U8下载器
│   └── ffmpeg.exe               # 视频处理工具
└── ...其他文件
```

### 验证工具文件
运行路径检查脚本验证所有工具文件是否正确放置：
```bash
python path_check.py
```

## 更新日志

### v3.1.2 (2025-08-29)
- 🔧 重构代码结构，模块化设计
- 🔧 优化工具文件管理：exe文件统一放置在tools目录（**强制**）
- 🔧 移除对旧目录结构的兼容性支持
- 🔧 更新所有导入路径以适配新目录结构
- 🔧 优化Windows系统路径兼容性
- 🔧 优化用户体验
- 🆕 新增保存课程信息可选项，默认不保存
- 🆕 新增自动清理功能：下载完成后自动清理`./tools/Logs`临时目录
- 🆕 新增路径工具类
- 🆕 新增路径检查脚本
- 🆕 新增命令行参数支持
- 🆕 新增日志系统
- 🆕 新增配置文件管理


## 技术支持

- 项目地址：https://gitee.com/mysheep0/QiHangVideo_Download
- 技术文档：https://blog.csdn.net/m0_60082046/article/details/144569851

## 免责声明

本工具仅供学习研究使用，请勿用于商业用途。使用本工具下载的视频内容版权归原作者所有，请遵守相关法律法规。