tchMaterial-parser 使用教程：3 步把电子课本 PDF 存到本地
【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser
备课要打印电子课本，打开国家中小学智慧教育平台翻到教材预览页，只有逐页图片，找不到下载按钮。tchMaterial-parser 干的事很直接：把预览页链接贴进去，它找到真正的 PDF 地址，直接存成本地文件，文件名就是教材全称。
没有下载按钮的预览页，中间差了什么
浏览器里的逐页图片只是展示层，整本教材的 PDF 本体放在后台接口后面。手工拿，得开开发者工具翻网络请求，再从一串 JSON 里挑出文件地址。tchMaterial-parser 把这套流程包进一个图形窗口：贴链接进去，文件出来。程序用 Python 写，Windows、macOS、Linux 都能跑；高分屏做了 DPI 适配，批量下载时窗口底部实时刷进度。存下来的 PDF 可以整本打印，也可以投到教室里当板书用。
链接怎么才算有效：认准 contentId
工具认的是教材预览页的完整地址，关键在 contentId 这个参数——平台靠它区分每一册教材。判断方法很简单：地址里 contentId= 后面跟的是一长串编号，目录页、章节列表页没有这个字段。整条 URL 复制下来才算有效，缺参数的地址会被判解析失败。contentType 参数可缺省，工具默认按教材处理。贴多条时一行一条，别用逗号隔开。
三步跑通第一次下载
第一步：拉代码装依赖
git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser cd tchMaterial-parser pip install requests pyperclip psutil第二步：启动窗口
Windows 直接双击 src/tchMaterial-parser.pyw；macOS 和 Linux 在终端执行python3 src/tchMaterial-parser.pyw。标题栏显示"国家中小学智慧教育平台 资源下载工具"就算就绪。Windows 下若报缺少模块，再补一条pip install pywin32。
第三步：贴链接，下载第一本
在平台找到目标教材，点进预览页，把地址栏网址粘进文本框，点「下载」。弹出选文件夹对话框，挑个平时放资料的位置。进度条走满后，日志区打印"文件已下载到："加具体路径；打开文件夹，能看到一本按教材全称命名的 PDF。批量下载时所有文件落在同一个文件夹，文件名自动取教材名称。
下载、解析并复制、级联下拉框：三个入口怎么选
启动成功后，窗口从上到下依次是：说明文字、URL 输入框、「下载」与「解析并复制」按钮、进度条、日志区，最底部一排 8 个级联下拉框。按目的选：
| 窗口里的元素 | 它会做什么 | 什么时机用 |
|---|---|---|
| ⬇️「下载」按钮 | 逐个解析链接，PDF 按教材名称命名存进所选文件夹 | 想存本地、离线翻阅 |
| 「解析并复制」按钮 | 只解析出 PDF 直链写进剪贴板，不产生文件 | 丢给 IDM 之类下载工具，或转发直链 |
| 顶部 8 个级联下拉框 | 按教材类别、学段、年级、版本逐级选，选完自动生成完整链接填入文本框 | 懒得在网页上翻找页面 |
下拉框像一位图书管理员，从教材大类一路点到具体书册，不用记网址格式。选到最后一级，完整链接自动追加到文本框末尾，接着点「下载」即可。
批量贴链接时，进度条和日志在说什么
贴多少都行，整学期十几本教材一次性贴完，中途不用守着窗口。下载期间「下载」按钮自动置灰，防重复点击；进度标签滚动显示"已下载几本 / 共几本"和字节进度，全部跑完后进度条清零、按钮恢复可点。日志区列出保存目录，某条链接失败会单独标出，只补跑失败项。
部分教材带配套音频 🔊：解析到 mp3 时会跟 PDF 一起下载，装进"教材名_音频"文件夹，文件带三位序号，按课序播放不打乱。
解析失败或下载中断，先查这几处
- 日志打印"解析失败，请检查URL是否正确" → 多半 URL 复制不完整，回平台确认地址带 contentId 参数，重贴再试。
- 启动时弹出"获取资源列表失败"、下拉框全是 "---" → 平台列表接口没取到数据，重启程序；手动贴链接下载不受影响。
- 某条链接"下载失败"被列出 → 日志已写明具体哪条出错，确认网络后补跑失败项，成功的不用重来。
- 高分屏下界面发糊 → 工具已做高 DPI 适配，仍不理想时调整系统显示缩放，细节见 README。
从打开平台到 PDF 落盘，中间只剩一次粘贴。现在翻出本学期要用的那本教材预览页，把地址贴进窗口。
【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
