smartedu-textbook

---
name: smartedu-textbook
description: 从国家中小学智慧教育平台下载中小学电子课本并合成 PDF，按年级/科目/版本自动归档到桌面。当用户想要下载、获取、查找中小学教材、电子课本、课本 PDF（如"下载苏教版三年级数学上册""帮我把八年级物理教材下下来""有没有人教版语文电子课本"）时使用。支持小学、初中、高中各版本教材。
---

# 中小学电子教材下载

从教育部主办的国家中小学智慧教育平台（basic.smartedu.cn）下载电子课本，
自动合成 PDF 并按「年级册次 / 科目 / 版本（出版社）」归档到桌面。

只使用平台**公开提供**的资源，不绕过任何鉴权，不需要用户账号。

## 何时使用

用户提到下载/获取/查找**中小学教材、课本、电子课本**时。例如：

- "下载苏教版三年级数学上册"
- "把八年级上册的物理教材下下来"
- "有哪些版本的三年级数学？"
- "我需要人教版初中英语课本"

## 使用方法

脚本位于本 skill 的 `scripts/` 目录。首次运行会下载约 33 MB 的教材目录并缓存
（存于 `~/.cache/smartedu/`），之后除非平台更新否则不再重复下载。

### 1. 直接下载（最常用）

```bash
python scripts/download.py --search "苏教版 三年级 数学 上册"
```

也可以用结构化参数，条件更明确：

```bash
python scripts/download.py --grade 八年级 --subject 物理 --version 苏科版 --volume 上册
```

### 2. 先查有哪些可选

用户说不清版本时，**先列出来给用户选，不要替用户猜**：

```bash
python scripts/download.py --list --grade 三年级 --subject 数学
```

### 3. 批量下载

```bash
# books.txt 每行一个搜索词
python scripts/download.py --batch books.txt
```

### 4. 回退方式（目录里查不到的教材）

约 15% 的教材在目录里没有预览坐标。这时让用户去平台上
**右键教材封面图 → 复制图片地址**，然后：

```bash
python scripts/download.py --url "<复制的图片地址>"
```

### 常用选项

| 选项 | 说明 |
|---|---|
| `--out <目录>` | 改变输出位置（默认：桌面/教材下载） |
| `--jobs N` | 并发数，默认 8，上限 16 |
| `--slow` | 弱网模式，降低请求频率 |
| `--compress` | 压缩 PDF，体积约为默认的 1/3（默认无损，一册约 60 MB） |
| `--keep-pages` | 保留单页图片（默认合成 PDF 后删除） |
| `--force` | 已存在时重新下载 |
| `--refresh` | 强制刷新教材目录缓存 |

## 输出结构

```
桌面/教材下载/
  三年级上册/
    数学/
      苏教版（江苏凤凰教育出版社）/
        （根据2022年版课程标准修订）义务教育教科书•数学三年级上册.pdf
        info.json          ← 坐标、页数、下载时间等存档
```

## 重要：提醒用户核对版次

2024–2025 年正是义务教育教材按 2022 年版新课标换版的窗口期，**新旧版单元结构差异很大**。

下载完成后**务必提醒用户**：翻到 PDF 的版权页（通常在第 3–5 页）核对「版次」，
确认与孩子在用的课本一致。新版教材书名带有「（根据2022年版课程标准修订）」前缀。

## 交互原则

- **条件不唯一时不要替用户猜**。脚本会列出所有匹配项，把选项呈现给用户来定
- 用户说不出版本时，先用 `--list` 列出该年级该科目的所有可选版本
- 下载失败时如实转达脚本的错误信息，不要臆测原因

## 依赖

```bash
pip install requests Pillow img2pdf
```

`img2pdf` 可选但推荐（无损嵌入、内存占用低）；缺失时自动回退到 Pillow。

## 使用边界

- 教材版权归各出版社所有，**仅供个人教学/学习使用**
- 不得用于商业用途，不得二次分发教材文件
- 本工具只下载电子课本，不下载教师用书、课件、音视频
- 平台接口可能变更，失效时以 `--url` 回退方式为准