# zjzk_papers

**Repository Path**: woodplus/zjzk_papers

## Basic Information

- **Project Name**: zjzk_papers
- **Description**: No description available
- **Primary Language**: Go
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 浙江自考真题下载工具

用于从网络获取浙江自考真题的命令行工具，支持按年份、学科筛选并下载 PDF、Word、ZIP 等格式的考试试卷。

## 功能特性

- 按年份和学科批量获取真题列表
- 自动检测文件类型（PDF、Word、Excel 等）
- 支持断点续传，避免重复下载
- 本地 SQLite 数据库存储试卷元数据
- 智能文件命名与目录整理
- 支持重新下载和清理功能

## 环境要求

- Go 1.18+
- SQLite3

## 安装

```bash
# 克隆项目
git clone https://gitee.com/woodplus/zjzk_papers.git
cd zjzk_papers

# 编译
go build -o zjzk_papers
```

## 配置

编辑 `config.yaml` 文件：

```yaml
# API 配置
api:
  base_url: "https://api.xxx.com"  # API 地址
  timeout: 30                       # 请求超时（秒）

# 下载配置
download:
  output_dir: "./papers"           # 文件保存目录
  page_size: 20                     # 每页数量
  concurrency: 3                    # 并发数
  retry: 3                          # 重试次数
```

## 使用方法

### 查看帮助

```bash
./zjzk_papers --help
```

### 基本用法

```bash
# 下载 2023 年所有科目真题
./zjzk_papers --year 2023

# 下载 2022-2023 年数学真题
./zjzk_papers --year 2022,2023 --course 数学

# 下载所有年份的所有真题
./zjzk_papers --all

# 重新下载已存在的文件
./zjzk_papers --year 2023 --redownload
```

### 参数说明

| 参数 | 说明 |
|------|------|
| `--year` | 年份，支持逗号分隔或范围（如 2020-2023） |
| `--course` | 学科，支持中文名称 |
| `--all` | 下载所有年份 |
| `--redownload` | 重新下载已存在的文件 |
| `--clean` | 清理空目录 |

### 清理功能

```bash
# 清理空目录
./zjzk_papers --clean
```

## 数据统计

程序会自动统计已下载的试卷数量：

```bash
./zjzk_papers --year 2023
# 输出示例: 已下载 15 份试卷
```

## 目录结构

下载的文件会按以下结构保存：

```
papers/
├── 2023/
│   ├── 数学/
│   │   ├── 2023年杭州市自考试卷数学试卷.pdf
│   │   └── 2023年宁波市自考试卷数学试卷.docx
│   └── 科学/
│       └── 2023年绍兴市自考试卷科学试卷.pdf
└── 2022/
    └── ...
```

## 常见问题

**Q: 下载失败怎么办？**

A: 程序会自动重试 3 次，若仍失败可使用 `--redownload` 参数重新尝试。

**Q: 如何指定下载目录？**

A: 修改 `config.yaml` 中的 `download.output_dir` 配置项。

**Q: 支持哪些文件格式？**

A: 支持 PDF、Word（.doc/.docx）、Excel（.xls/.xls x）等常见办公文件格式。

## 许可证

MIT License