# smartedu-dl-py

**Repository Path**: sunboer/smartedu-dl-py

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# smartedu-dl (`py`)

![build](https://github.com/hantang/smartedu-dl-py/actions/workflows/release.yml/badge.svg)
![GitHub Tag](https://img.shields.io/github/v/tag/hantang/smartedu-dl-py)

> 智慧教育平台资源下载工具

## 📝 功能说明

主要支持[`smartedu.cn` 国家中小学智慧教育平台](https://basic.smartedu.cn/tchMaterial)教材、课件（PDF 格式）下载存储。

🚨 **注意**：
如果下载中出现“检测到病毒”，请尝试暂时关闭相关病毒检测再下载使用
（macos 系统在【设置/隐私】中设置允许打开）。
由于软件没有认证措施，`Pyinstaller`打包可能存在误报。
提供的下载包都是通过 Github Actions 自动编译提交的。
有条件的，也可按照下面说明下载仓库代码后在本地执行（需要预先配置 Python 环境）。

## ⌨️ 命令行模式/CLI

```shell
Usage: app-cli.py [OPTIONS]

  智慧教育平台资源下载工具

Options:
  -h, --help            帮助信息
  -d, --debug           启用调试模式
  -i, --interactive     交互模式

  -t, --formats 资源类型  配置需要下载类型，如PDF、MP3（默认仅PDF）
  -a, --auth 'MAC id="..."' 登录信息，
  -b, --backup           尝试用备用解析方式（不一定是最新版）

  -u, --urls TEXT       URL路径列表，用逗号分隔
  -f, --list_file PATH  包含URL的文件
  -o, --output PATH     下载文件保存目录
```

用例：

```shell
# 更新依赖
pip install -r requirements.txt

# 切换目录 或者 python src/app-cli.py
cd src/

# 交互模式，进入后选择：
# 1. 查询科目列表：展示电子教材（学业阶段）->学科、版本等；支持输入0回退，输入exit退出。
# 2. 手动输入URL：教材或课件详情页的链接，可逗号分隔。
python app-cli.py
python app-cli.py -i # 交互模式（同上），-i 参数可选。不要和-u/-f连用

# 其他参数：-o 修改默认目录，--formats 提供更多资源类型下载【暂不支持PDF】
python app-cli.py -o $SAVEDIR
python app-cli.py --formats pdf,mp3

# 命令模式:
# URL: 链接字符串，逗号分隔多个链接
# FILE: 单个文件名，文件内链接每行一个
python app-cli.py -u $URL
python app-cli.py -u $URL -f $FILE
```

| macos                            | windows                          |
| -------------------------------- | -------------------------------- |
| ![](snapshots/cli-snapshot-mac.png) | ![](snapshots/cli-snapshot-win.png) |

## 🖥️ 图形界面模式/GUI

```shell
# 更新依赖
pip install -r requirements.txt
pip install -r requirements-gui.txt

# 支持解析下载PDF、音频等格式。
cd src
python app-tk.pyw
```

| 界面     | macos                              | windows                            |
| -------- | ---------------------------------- | ---------------------------------- |
| 教材列表 | ![](snapshots/gui-snapshot-mac1a.png) | ![](snapshots/gui-snapshot-win1b.png) |
| 手动输入 | ![](snapshots/gui-snapshot-mac2a.png) | ![](snapshots/gui-snapshot-win2b.png) |

## 🌐 依赖

参见: `requirements.txt`、`requirements-gui.txt`文件。

## 🚨 备注：配置登录信息

如果下载教材不是最新版，需要配置登录信息，找到 **X-ND-AUTH** 字段。

大致步骤：
1. 浏览器打开：<https://basic.smartedu.cn/tchMaterial> 
2. 点击其中一本教材
3. 弹出新的页面中选择登录
4. 登录后重新打开教材页面，鼠标右键菜单中选择 **检查**（Inspect）/或者 `F12` 打开开发者工具 （DevTools）.
5. 之后步骤如下图，找到 **X-ND-AUTH** 字段
    ![](./snapshots/steps.png)
6. 命令行版本需要使用 `-a` 参数；图形界面版本在 **登录信息** 框中填入。

## 💡 相关

- [hantang/smartedu-dl-go](https://github.com/hantang/smartedu-dl-go) 新版本
- [happycola233/tchMaterial-parser](https://github.com/happycola233/tchMaterial-parser)
- [52beijixing/smartedu-download](https://github.com/52beijixing/smartedu-download)
- 图标来自或修改自：<https://www.smartedu.cn/>