smartedu-dl (py)

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

📝 功能说明

主要支持smartedu.cn 国家中小学智慧教育平台教材、课件（PDF 格式）下载存储。

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

⌨️ 命令行模式/CLI

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     下载文件保存目录

用例：

# 更新依赖
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

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

💡 相关

• hantang/smartedu-dl-go 新版本
• happycola233/tchMaterial-parser
• 52beijixing/smartedu-download
• 图标来自或修改自：https://www.smartedu.cn/