https://github.com/hantang/smartedu-dl-py
国家中小学智慧教育平台资源下载工具
https://github.com/hantang/smartedu-dl-py
downloader smartedu textbook
Last synced: 12 months ago
JSON representation
国家中小学智慧教育平台资源下载工具
- Host: GitHub
- URL: https://github.com/hantang/smartedu-dl-py
- Owner: hantang
- License: mit
- Created: 2024-12-05T13:00:37.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-16T04:32:27.000Z (over 1 year ago)
- Last Synced: 2025-03-25T12:19:54.047Z (over 1 year ago)
- Topics: downloader, smartedu, textbook
- Language: Python
- Homepage:
- Size: 7.04 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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 |
| -------------------------------- | -------------------------------- |
|  |  |
## 🖥️ 图形界面模式/GUI
```shell
# 更新依赖
pip install -r requirements.txt
pip install -r requirements-gui.txt
# 支持解析下载PDF、音频等格式。
cd src
python app-tk.pyw
```
| 界面 | macos | windows |
| -------- | ---------------------------------- | ---------------------------------- |
| 教材列表 |  |  |
| 手动输入 |  |  |
## 🌐 依赖
参见: `requirements.txt`、`requirements-gui.txt`文件。
## 🚨 备注：配置登录信息
如果下载教材不是最新版，需要配置登录信息，找到 **X-ND-AUTH** 字段。
大致步骤：
1. 浏览器打开：
2. 点击其中一本教材
3. 弹出新的页面中选择登录
4. 登录后重新打开教材页面，鼠标右键菜单中选择 **检查**（Inspect）/或者 `F12` 打开开发者工具 （DevTools）.
5. 之后步骤如下图，找到 **X-ND-AUTH** 字段
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)
- 图标来自或修改自：