不用一页页截图了:电子课本下载工具的完整用法

免责声明

---

① 公众号内所提供的所有资源均为免费分享，其中大部分内容是来源于网络，版权归原作者本人所有，仅供学习和交流（禁止商用或其它牟利行为），所有下载的文件资源在24小时内必须删除，所有的文件版权归原版权方。如有侵权，您可以发送邮件至515695895@qq.com联系小编处理，感谢您的理解与合作。

② 资源全部经过小编亲自测试用，但也不保证兼容或适用于所有系统，有可能引起冲突和导致不可预测的问题出现，请自行承担使用本资源而导致的风险和后果，发布者本人不对使用此资源负任何责任！另外因为部分资源有时效性，所以如果您喜欢本公众号推送的资源，可以将本公众号设置星标，第一时间获得最新内容。

正文

EDU TECHNOLOGY实测 2026.09

网页上翻页看，想存一份 PDF 得手动截？

一键解析并批量下载电子课本文件，自动命名、自动添加书签，开箱即用。

国家中小学智慧教育平台 · 电子课本下载

happycola233/tchMaterial-parser · GitHub

v4.3MIT

3 Parts + Conclusion

PART 01

它是什么

三分钟说明白

PART 02

怎么装

三种装法任选

PART 03

怎么用

五步拿到 PDF

PART ///

问题与边界

踩坑与提醒

01

PART

它是什么

WHAT IT IS

一句话说明白

电子课本预览页链接丢进去，PDF 自动下

按课本名命名 · 自动加书签

国家中小学智慧教育平台上有电子课本，但网页版只能一页页翻着看。想把整册存下来，大多数人第一反应是——手动截图，或者找各种转存网站，结果不是缺页就是带水印。

开源项目 tchMaterial-parser 干的事就很直接：把电子课本的「预览页网址」填进去，工具自己去解析、下载，产出 自动命名、可选自带书签的 PDF。

批量下载

多个链接每行一个

自动命名

文件名=课本名

自动书签

按章节跳

顺带说个背景：它 2025 年 5 月登上过 GitHub Trending 总榜第 3 名，单日新增约 400 个 Star，当时在中文开发者圈里传了一阵。现在仓库版本号已经到 v4.3（2026-09-21 发布）。

支持批量下载

一次输入多个电子课本预览页网址，每行一个，批量处理。

自动命名文件

下载完直接用课本原名当文件名，不用手动改，folder 里一眼能认出来。

自动添加书签

勾上「添加 PDF 书签」后，下载完成会自动写入书签，翻 PDF 时可直接跳到对应位置。

支持 Access Token

手动填入 Token 并自动保存，下次启动直接沿用，省得每次重来。

资源快速搜索

可按资源名称，或「学段、学科、年级」组合筛选，结果自动展开，长名称可横向滚动、悬停看大图。

高 DPI + 深色模式

高分屏不模糊；启动跟随系统浅色/深色，右上角按钮可手动切换并记住选择。

跨平台

Windows、Linux、macOS 都有现成安装包，需要图形界面。

02

PART

怎么装

INSTALLATION

三种装法，按你的系统挑一种就行。Windows 用户最省事的是 WinGet，Arch 用户一条命令，其他情况去 Releases 下安装包。

STEP 01

Windows：WinGet 一键装

CMD

winget install happycola233.tchMaterial-parser

支持 Windows 10 / 11 / Server 2025。装完在开始菜单搜一下就能找到，或者直接在终端敲程序名启动。

STEP 02

Arch Linux：AUR 装

SHELL

yay -S tchmaterial-parser

包名是小写加连字符的 tchmaterial-parser，不是大小写混写的那个。装完直接在终端启动。

STEP 03

其他系统：Releases 下安装包

打开仓库的 Releases 页面，按系统和架构挑：

URL

https://github.com/happycola233/tchMaterial-parser/releases

覆盖 Windows / Linux / macOS，各自都有 x86_64 和 Arm64 两个版本。下载后不需要额外安装，Windows 和 Linux 直接双击运行。

STEP 04

macOS 用户先看这一条

macOS 因未签名，系统会提示「文件已损坏」。需要先执行 xattr -cr /path/to/tchMaterial-parser.app 移除隔离属性；另外为了让 Token 能持久化，建议先把应用移到 /Applications 目录再运行。

从源码跑：想体验最新改动或参与开发，仓库要求 Python 3.10+，具体见贡献者指南。

三条路任选一条，装完都能用；差别只在更新方式，功能完全一样。

03

PART

怎么用

HOW TO USE

核心就三步：复制预览页链接 → 设置 Token（可选但推荐）→ 点下载。下面拆细。

STEP 01

复制电子课本预览页网址

在平台里打开你想下载的电子课本，浏览器地址栏里那条 detail 开头的网址，整条复制下来。多条链接每行粘一个，即可批量。

...URL

https://basic.smartedu.cn/tchMaterial/detail

?contentType=assets_document

&contentId=XXXXXX&catalogType=tchMaterial

&subCatalog=tchMaterial

注意是 预览页网址，不是普通的课程页面；contentId 那一串是每册课本唯一的。

STEP 02

获取 Access Token（不必须，但强烈建议）

没 Token 也能下，但 README 明确说了那条备用通路 并不长期有效，所以想稳定用就花一分钟把 Token 配上。

2.1

浏览器登录平台

打开国家中小学智慧教育平台并登录账号——必须先登录，脚本靠登录态取凭据。

2.2

打开开发者工具的控制台

按 F12 或 Ctrl + Shift + I，右键菜单里选「检查」也一样；然后切到 控制台 / Console。

2.3

粘贴下面这段脚本，回车

...JS

(function () { const authKey = Object.keys(localStorage).find( key => /^ND_UC_AUTH-[^&]+&[^&]+&token$/.test(key), ); if (!authKey) { console.error("未找到登录凭据，请确保已登录！"); return; } const tokenData = JSON.parse(localStorage.getItem(authKey)); const { access_token, mac_key, diff } = JSON.parse(tokenData.value); const credentials = JSON.stringify({ access_token, mac_key, diff }); console.log(credentials);})();

脚本会自动在 localStorage 里找到登录凭据，把 access_token、mac_key、diff 打包成一段 JSON 打印出来。

2.4

复制整段 JSON，回工具里粘贴保存

点工具里的「设置 Token」，把控制台输出的那段 JSON 整段粘进去保存。

三个高频坑：① 必须先登录再粘代码；② 粘贴要落在「>」后面（控制台输入行），别粘到「过滤/筛选」框里；③ 浏览器弹 Paste 警告时，先输入「允许粘贴」四个字再重新粘一次。

另外 不要从开发者工具的 Application 面板里随手复制——登录后的 localStorage 里还躺着 ND_UC_AUTH-…&sdk_cache（账号资料缓存），那个里面没有 Token。

Token 一般 7 天 左右过期，过期后下载会失败，重新跑一遍上面四步即可。

STEP 03

填链接、开选项、点下载

把 STEP 01 复制的链接粘进文本框（支持多行批量），按需勾选：

· 添加 PDF 书签：下载完自动写书签，看 PDF 时按章节跳转；

· 保存目录：选一个你顺手的文件夹。

然后点「下载」。文件会以课本名称命名落到你选的目录里；勾选了书签功能的话，PDF 里会多出可跳转的书签栏。

STEP 04

想找书？用资源搜索

工具内置按资源名称，或「学段 + 学科 + 年级」组合搜索，结果自动展开；长名称可横向滚动，鼠标悬停能看完整信息和大尺寸封面。

STEP 05

批量与后续

多个链接每行一个，一次粘进去批量下；Token 会自动保存，下次启动直接沿用，不用重复设置。

最快路径：WinGet 装好 → 登录平台拿链接 → （可选）配 Token → 点下载。v4.3 起开箱即用。

///

LAST

问题与边界

FAQ & NOTES

卡住的时候先看这几条，80% 的问题都在list里。

下载失败

先确认有没有设 Token；设了还失败，多半是 Token 过期了（约 7 天），重取一个。另外检查网络，以及链接是否还有效——部分旧资源可能已被平台移除。

Token 存在哪

Windows 存在注册表 HKEY_CURRENT_USER\Software\tchMaterial-parser 的 AccessToken 值；Linux 在 ~/.config/tchMaterial-parser/data.json；macOS 在 ~/Library/Application Support/tchMaterial-parser/data.json。

Token 会不会泄露

工具不会上传、不存云端，只用于本地请求授权。但别在公开场合分享 Token，免得账号被拿去用。

版权提醒

工具只提供下载便利，不存储、不托管、不分发任何资源，内容全部直接来自平台。下载的资料版权归原平台及权利人，仅限个人学习与教学参考，请勿商用或二次分发。

项目归属

本项目与国家中小学智慧教育平台没有任何隶属或合作关系，MIT 许可，可自由使用和二次开发。

延伸阅读

想直接下载归档版本，可以看看 ChinaTextbook 项目——它提供另一条获取电子课本 PDF 的路线。

一句话收尾：把「翻网页」这件事交给工具，你只要留下想看的那本书。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

点赞

在看

转发

THANKS FOR READING

happycola233/tchMaterial-parser

---

拜托大家

如果您觉得我的分享有所助益，请给我的文章点个赞，转发给您的朋友。

   点赞，转发，在看，都是对我最大的支持。

---

往期精彩

---

1. 告别东拼西凑的 m3u：Docker 自建私人频道系统。
2. 你随手发的照片，AI 能查出在哪拍的，这个开源项目连推理过程都给你看。
3. 我用一个 AI 搭子，手搓了一个自己的小程序（附邀请链接）
4. 全网视频随心下！VidBee 不止能下载——本地转字幕、接 AI 总结翻译，覆盖 1000+ 网站
5. 拒绝 Adobe 付费！这个免费开源工具，改字、OCR、签名全都能。
6. 搞机十年，我给自己写了个"万能工具箱

获取方式

关注公众号【搞机大师】

---

### 防失踪关注小号：↓↓↓↓↓↓↓↓↓↓↓↓↓↓