企业官网建设流程全解析

如何 3 分钟把智慧教育平台的电子课本 PDF 存到本地？tchMaterial-parser 实操指南

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

备课时经常遇到这种情况：在国家中小学智慧教育平台上找到一本想参考的教材，预览页只能在线翻页，找不到下载按钮。开源工具 tchMaterial-parser 解决的就是这个电子课本下载问题——把预览页网址粘贴进去，它能取回 PDF 直链并保存到本地电脑，全程三步。下面从安装、下载流程到批量技巧，把用法讲一遍，并附几个容易踩的坑。

这是什么工具：预览页网址进，PDF 链接出

整个项目就是一个 Python 文件 src/tchMaterial-parser.pyw，用带 tkinter 的 Python 环境运行后弹出程序窗口。它的核心逻辑一句话可以说清：从你粘贴的预览页网址中提取 contentId，请求平台的资源信息接口，再取出其中格式为 pdf 的直链地址。

一本普通电子课本的预览网址长这样：

https://basic.smartedu.cn/tchMaterial/detail?contentType=assets_document&contentId=b8e9a3fe-dae7-49c0-86cb-d146f883fd8e&catalogType=tchMaterial&subCatalog=tchMaterial

用之前有两点需要心里有数：

• 工具支持 Windows、Linux、macOS，但必须有图形桌面环境；
• 源码使用了较新的类型标注语法，建议 Python 3.10 及以上版本。

界面分四块：上方是网址输入框，中间是"下载""解析并复制"两个按钮和进度条，下方一排级联下拉菜单用于选教材，最底下是日志区。

安装与首次运行：依赖装好，一行启动

拿到代码后（获取方式见文末），先装源码里用到的第三方库：

pip install requests psutil pyperclip

Windows 用户需要再补一个 pywin32，然后直接运行主程序：

python src/tchMaterial-parser.pyw

首次启动时，程序会在后台拉取平台的教材列表，用来构建下方的下拉菜单。如果弹出"获取资源列表失败"的提示，不用管，手动粘贴网址下载完全不受影响，关掉提示继续用即可。

最常用的三步流程：从网址到 PDF

第一次用，按这个顺序走一遍就熟了：

1. 在平台打开目标电子课本的预览页，复制浏览器地址栏的完整网址；
2. 粘贴进文本框。要下多本教材就一起处理，每个网址占一行；
3. 点"下载"，在弹出的对话框里选保存目录，等进度条走完。

保存规则是固定的：文件名取教材名称加 .pdf，比如《普通高中教科书 语文必修 上册》就会落成"普通高中教科书 语文必修 上册.pdf"。如果这本教材还关联了音频资源，工具会在旁边自动建一个"教材名_音频"子文件夹，把 mp3 一并下下来，备课时可以直接引用。

功能拆解：三个值得知道的细节

"解析并复制"：只取链接，交给 IDM

文件太大、网络不稳的时候，可以让它只干一半的活：点"解析并复制"，工具把每个网址都解析成 PDF 直链并复制到剪贴板，之后交给 IDM 这类支持断点续传的下载管理器，让专业工具干剩下的事。

级联下拉菜单：帮你把网址填好

界面下方有一排级联下拉菜单，覆盖教材类型、学段、学科、版本直到具体书目几个层级。逐级选中目标教材后，工具会拼好对应的预览页网址直接写入文本框，不用记网址格式，也不用回平台翻找。

进度条和日志：下载全程看得见

进度条显示总大小和百分比，旁边文字标注"已下载 X / 共 Y"。每解析一个网址、每完成一个文件都会写进底部日志，全部结束后失败的链接会单独列出来，重试即可。下载任务跑在后台线程里，窗口全程可正常操作；Windows 下还做了高 DPI 适配，高分辨率屏幕不会出现界面发糊。

注意事项：常见问题与对应处理

• 粘贴的必须是预览页网址，即带 contentType 和 contentId 参数的那条；格式不对时日志会提示"解析失败，请检查URL是否正确"，核对地址重新粘贴即可；
• 单个文件下载失败多半是网络波动，收尾日志里会列出失败链接，重新跑一遍就好；
• 下拉菜单数据每次启动时从平台拉取，拉取失败属于偶发，改用手动输入网址功能一样完整；
• Windows 高 DPI 用户若仍觉得显示异常，可调整代码里的缩放因子，或在系统显示设置中改缩放级别。

另外，下载的课本 PDF 建议仅用于个人学习和备课。

获取方式与两条实用建议

git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser

克隆下来后用 Python 3.10+ 按上文步骤运行即可。最后给两条实操建议：批量下载前先建好"学期/学科"命名的目录再选保存位置，事后好找；单本大文件优先走"解析并复制"，交给下载管理器更稳。

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