tchMaterial-parser 完整免费教程快速把智慧教育平台的电子课本下载为 PDF【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser周五晚上十一点一位备课的老师打开国家中小学智慧教育平台想把一册数学电子课本存到电脑里第二天课上照着讲。可页面翻了一圈找不到下载按钮——平台只提供逐页在线预览想留存资料只能一页页截图拼接或者去找来路不明的第三方扫描版。这是很典型的一个卡点课本就摆在那里却拿不走。tchMaterial-parser就是为这件事做的免费开源电子课本下载工具目标只有一个让你快速下载电子课本 PDF。贴入预览链接它返回可以直接保存的 PDF 文件不用注册、不收费、跨平台Windows / macOS / Linux代码完全公开。 原理拆解一条预览链接怎么变成可下载的 PDF很多人第一反应是平台都没给下载入口工具凭什么能做到其实这是个纯前端问题——课本的 PDF 文件一直存放在平台服务器上只是预览页不肯把地址交出来。工具做的事就是把地址从平台那里问回来整条链路四步从链接里提取标识。电子课本预览页的长这样https://basic.smartedu.cn/tchMaterial/detail?contentTypeassets_documentcontentIdb8e9a3fe-dae7-49c0-86cb-d146f883fd8e核心参数是contentId它是这册课本的唯一编号contentType表示资源类型缺省时按assets_document教材处理。查询平台资源接口。工具拿着 contentId 向平台后端的资源详情接口形如tch_material/details/{contentId}.json发请求取回这册课本的完整资源清单。在 JSON 里定位 PDF。返回数据里ti_items数组的每一项都是一份资源——PDF、图片、音频等。工具找到格式标记为pdf的条目取它ti_storages列表里第一个有效存储地址。改写成公网直链。原始地址带-private段内网域名外部访问不到。工具把-private替换为空拼出最终的 CDN 直链这个链接才能直接保存。顺带一提对教材类资源工具还会多查一个关联音频接口把配套的 mp3 地址一并抓出来后文进阶技巧里会说到。这段逻辑全部在src/tchMaterial-parser.pyw的parse()函数里想抠细节可以直接读源码。 实际操作链路从打开工具到 PDF 落地操作流程固定四步第一次使用两分钟能走完。第一步启动工具双击src/tchMaterial-parser.pyw或在终端执行python src/tchMaterial-parser.pyw。界面由四块组成大网址输入框一行一个链接、一排级联下拉菜单、下载与解析并复制两个按钮底部是进度条和日志区。第二步把课本喂给工具两种方式粘贴链接在浏览器里打开课本预览页从地址栏复制完整网址贴进输入框即可。下拉菜单挑记不住链接也没关系。用界面下方那排级联下拉菜单教材类型、学段、学科、版本、册次等从粗到细逐级选选完目标课本工具会自动生成对应链接并写进输入框。课本列表是工具启动时从平台实时拉取的如果列表为空重启一次再试。第三步二选一下载工具弹出文件夹选择窗口选定后逐册下载 PDF。文件名直接用平台返回的教材官方标题形如普通高中教科书·语文必修_上册.pdf落盘即可检索归档不用手动改名。解析并复制不想让工具动手下载点这个按钮只解析出 PDF 直链并复制到剪贴板粘进任意下载工具IDM、浏览器插件等自行保存。第四步看进度和日志下载过程中进度条实时显示已下载量 / 总量百分比、完成 x/y全部结束后日志区输出文件已下载到…失败的链接会单独列出——把这几条重新贴进去再跑一遍即可不用从头再来。安装与环境准备只有一个硬要求Python 3.10 及以上。代码里用了X | Y这类新的类型联合写法Python 3.8 这类旧版本会在文件加载时直接报错别在这上面卡住。# 1. 获取项目 git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser cd tchMaterial-parser # 2. 安装依赖 pip install requests pyperclip psutil # 3. Windows 用户额外装一个高 DPI 支持库 pip install pywin32 # 4. 运行 python src/tchMaterial-parser.pywmacOS 和 Linux 跳过第 3 步即可只要系统有图形界面就能跑。Windows 版自带高 DPI 适配4K 大屏上界面也不会糊。 进阶技巧与常见坑批量提效技巧多行链接即批量要整理一整套教材时把十几个链接换行排好一次贴入工具排队处理、进度统一汇总下载在后台线程跑界面全程不卡。大批量错峰下载单册课本 PDF 有几 MB一学期几册甚至十几册选网络空闲时段跑更稳。别开多窗口并发网络带宽是共享瓶颈开多个窗口反而更慢还容易触发平台限制。白拿的音频下载教材类资源时工具会自动收集关联的听读音频mp3 存进教材名_音频子文件夹英语、语文课本用得着。最容易踩的坑现象原因与处理启动直接报错Python 版本低于 3.10换新版解释器重跑提示解析失败链接不完整聊天工具转发常截断尾部参数回浏览器地址栏复制完整地址下拉列表为空、弹警告启动时拉取课本列表失败多为网络波动重启程序或手动粘贴链接个别链接下载失败日志会单独标出失败链接检查网络后重贴重试即可高分屏界面模糊工具已内置高 DPI 适配仍异常时调整系统显示缩放它适合谁用备课教师开学前把本学期各科课本批量下载按学科建文件夹归档按需打印或平板上课投屏对比新旧版本时两版教材并排下载逐章比对。离线学习的学生把当季课本装进平板或电子阅读器做标注、反复看网络条件有限的地方尤其用得上。家长按学科—年级—学期给孩子搭个人学习库一册册存本地不用每次在浏览器里翻找预览页。有自己下载习惯的人只用解析并复制拿直链交给自己顺手的下载工具同样省事。写在最后tchMaterial-parser 做的事其实就一件借助平台自己的数据把只能在线看变成PDF 直链 本地文件而且免费MIT 开源协议、源码公开逻辑随时可查。使用中发现问题或者想要一键勾选整年级之类的功能欢迎到项目里提交 Issue 反馈、贡献代码README.md里写了参与说明。如果你也被平台课本下不了卡住过照上面的安装步骤走一遍五分钟以内就能把第一本电子课本 PDF 存到桌面。【免费下载链接】tchMaterial-parser国家中小学智慧教育平台 电子课本下载工具帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考