免费开源:用tchMaterial-parser下载国家中小学智慧教育平台电子课本PDF,新手完整指南
【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具,帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载,让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser
周一早上要打印本周三本电子课本上课,可国家中小学智慧教育平台只支持在线预览,没有下载按钮。tchMaterial-parser 是一个免费的电子课本下载工具:把课本详情页的链接粘贴进去,它自动解析出官方 PDF 地址并下载下来。下面用三步把整个过程走完,环境要求只有一个带图形界面的 Python 3.x。
能力速览:这个工具替你做了四件事
窗口布局不复杂:输入框、级联选择、两个按钮、进度与日志,如下图所示:
📥 多链接一次粘贴,批量下载
输入框按每行一条链接接收任务,点"下载"后工具用多线程依次取回所有文件,窗口底部有总大小、百分比和"已完成 N/M"三个实时计数。一次处理 5~10 本教材只需点一次按钮,失败的文件会单独列在日志里,重试时只针对失败项。
🏷️ 文件名自动取教材官方名称
每个 PDF 以下载时从平台返回的教材标题命名,保存文件夹里按书名整齐排列,不用逐个改名。这套"解析 + 命名 + 下载"的逻辑集中在 src/tchMaterial-parser.pyw 一个文件里,想看实现可以直接打开。
🔗 想用自己的下载器,复制链接即可
"解析并复制"按钮只做一件事:把输入框里所有链接解析成真实的 PDF 直链并放进剪贴板。贴进 IDM 或迅雷按自己的带宽下载,适合网络不稳、或想避开平台高峰的场景。
不想找链接?用级联下拉直接生成
窗口里还有一排级联下拉框,内容来自程序启动时从平台拉取的官方教材列表。逐级选到具体教材后,完整详情页链接会自动插入输入框,免去手动翻找复制的步骤。
三步上手:克隆、粘贴、下载
第一步:克隆仓库并准备环境
git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser pip install requests pyperclip psutil程序除标准库外只依赖上面三个库;Windows 上如果报win32print缺失,再补装一个 pywin32 即可。
第二步:粘贴教材链接
在浏览器打开电子课本详情页,复制地址栏 URL,形如:
https://basic.smartedu.cn/tchMaterial/detail?contentType=assets_document&contentId=b8e9a3fe-dae7-49c0-86cb-d146f883fd8e多条链接每行一条。注意链接必须带contentId参数,从地址栏整条复制最稳妥;页面里手动拼出来的短链接解析必然失败。
第三步:选择"下载"或"解析并复制"
Windows 直接双击 src/tchMaterial-parser.pyw 启动,其他系统用python运行同一路径文件。填入链接后点"下载",选择保存目录,进度条开始走动;只要链接就点"解析并复制"。可能遇到的情况:启动时弹出"获取资源列表失败",说明教材下拉列表没加载成功——不影响手动粘贴链接,或者关掉重开一次程序。
一个完整案例:一学期 5 本教材加配套音频
一位初中老师要在开学前备齐一学期的数学教材,其中两本还要下载配套朗读音频给学生听。他的流程是:先打开平台教材库,把 5 本教材的详情页链接逐个存进一个文本文件(嫌麻烦就直接用程序里的级联下拉生成);然后整段粘贴进工具,保存目录选"春季学期资料";点下载后 5 个以教材名命名的 PDF 依次落盘,带音频的教材会额外生成一个"教材名_音频"文件夹,里面的 mp3 按顺序编号,直接拷进平板就能跟课使用。期间有一本 PDF 偏大、下载中途断了一次,他用"解析并复制"把这条链接单独拿出来交给 IDM 补下。整个流程不含等待时间,操作本身不到 3 分钟。
常见问题 FAQ
下载失败或速度很慢怎么办
先确认浏览器能正常打开该教材页面——打开 404 或提示已下线,说明教材被平台下架,换其他版本;能打开就换有线网络、避开晚高峰重试;文件特别大的,改用"解析并复制"加 IDM/迅雷下载。批量任务结束后,窗口日志会汇总所有失败的链接,照着重试即可。
链接无法解析是怎么回事
按顺序排查三点:URL 里有没有contentId参数;链接是否来自 basic.smartedu.cn 的教材详情页;浏览器能否正常打开该页面。三点都没问题仍解析失败,多半是平台接口临时调整,更新到最新版工具再试(版本信息写在源码文件头部注释)。
批量下载时窗口没反应是 bug 吗
不是。下载在后台线程执行,"下载"按钮下载期间会被置灰防止重复点击,界面看起来"不动"但底部进度条和日志持续刷新。此时只需保证磁盘空间足够,等日志输出"文件已下载到"即完成。
仓库的 README.md 里有完整的使用说明与常见问题,克隆代码后双击主程序即可开始使用。
【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具,帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载,让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考