三步下载电子课本PDF：tchMaterial-parser v2.3 新功能指南

三步下载电子课本PDF：tchMaterial-parser v2.3 新功能指南

【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser

tchMaterial-parser 是一个开源工具，用于从国家中小学智慧教育平台下载电子课本 PDF，适合想把课本存到本地的教师和学生。v2.3 更新（2024-10-03）主要带来三点：级联菜单直接选课本、课本关联音频随课本一起下载、多线程下载并实时显示进度。

本版亮点

• 级联菜单选课本：启动时自动加载平台课本目录，下拉选择学段、学科、版本即可自动填入资源链接，不用再手动找页面、拷长链接。
• 音频资源一起下载：解析教材时同步抓取关联音频，mp3 自动存入独立文件夹，与 PDF 放在一起。
• 多线程下载 + 实时进度：下载在后台线程执行，大文件下载时窗口不卡死，进度条实时显示百分比和完成数量。
• 支持更多资源类型：普通电子课本之外，新增对专题课程和基础性作业预览页的解析。
• 高 DPI 适配：Windows 高分屏下字体和控件清晰不模糊，Linux、macOS 同样可运行。

图1：tchMaterial-parser 主界面——粘贴课本预览页网址或用级联下拉选择课本，底部区域实时显示下载进度与日志

核心功能深挖：级联菜单选课本，告别翻找链接

旧方式卡在哪。过去用这类工具，第一步永远是“拿链接”：你得先在平台上翻到目标课本的预览页，再复制它的网址。而预览页网址形如basic.smartedu.cn/tchMaterial/detail?contentType=…&contentId=…，一串参数里夹着很长的contentId，复制错一个字符解析就会失败。对新手来说，光是找到课本本身就有门槛，复制链接又是第二道坎。

v2.3 怎么解决。现在主界面下方有 8 个级联下拉框（两行四列），依次点“电子教材 → 高中 → 语文 → 统编版 → 普通高中教科书语文必修上册”，工具就会自动拼出完整的预览页网址并填入上方文本框，全程不用碰键盘。

原理说人话。工具启动时会从平台的公开数据接口（tch_material_tag.json分类树和data_version.json版本列表）拉取课本目录，在内存里整理成一棵分类树——就像商场的“楼层 → 品类 → 品牌 → 型号”导购目录，每个下拉框就是沿着这棵树往下走一层。选中最后一级课本时，工具取出该课本的contentId填进标准网址模板，链接就这么“自动打”出来了。由于课本目录跟随平台官方数据，新版教材上线后会自然出现在菜单里，无需升级工具。

另外，下拉框是联动的：选了学段才会刷新学科列表，选了学科才会刷新版本列表；回到上层重新选择时，下层内容会自动清空，避免拼出错误的组合。

💡 实用技巧：若启动时弹出“获取资源列表失败”的警告，一般是网络瞬时波动，关掉工具重新打开即可；也可以直接手动粘贴预览页网址，解析、下载功能不受影响。

其余优化一览

• 音频资源随课本下载→ 解析教材（assets_document）时同步拉取关联音频，过滤不可下载的链接后，把 mp3 存到“{教材名}_音频”文件夹，音频和 PDF 同地存放，不用再回页面翻找。
• 支持更多资源类型→ 除普通电子课本外，专题课程（thematic_course）和基础性作业页面的预览链接也能解析，一套工具通吃多种资源页。
• 多线程下载、进度可见→ 下载在工作线程中进行、按 128KB 分块传输，进度条与状态标签实时更新；大文件下载时窗口保持响应，结束后日志区还会列出失败链接方便重下。
• 高 DPI 适配→ Windows 下自动读取系统缩放比例并开启 DPI 感知，高分屏上界面清晰；Linux、macOS 按标准缩放运行，跨平台体验一致。

快速上手：三步完成首次下载

1. 获取代码：git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser，准备带图形界面的 Python 3.x，安装依赖requests、pyperclip、psutil（Windows 另需pywin32）。
2. 运行程序：在项目目录执行python src/tchMaterial-parser.pyw（核心逻辑都在这一个文件里），等待课本目录加载完成、主窗口弹出。
3. 验证是否成功：在级联菜单里选一本课本（或粘贴预览页网址），点击“下载”并选择保存位置，观察进度条与日志区；也可以点“解析并复制”，粘贴剪贴板确认得到 PDF 直链。

写在最后

v2.3 把“找链接”这一步变成了菜单选择，让 PDF 与音频一次到位，下载过程全程可见——从打开工具到拿到课本，现在只需三步：启动、选课本、点下载。如果你发现 Bug 或有任何改进想法，欢迎向仓库提交 Issue 或 Pull Request 参与共建（项目采用 MIT 许可），让电子课本解析工具变得更好用。

【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser