【开源应用】一键下载中小学电子课本 tchMaterial-parser

开源工具推荐

一个免费、开源、跨平台的电子课本下载工具，帮你从国家中小学智慧教育平台快速获取 PDF 课本。

这个工具是做什么的？

tchMaterial-parser 是一款开源的桌面工具，专门用于从国家中小学智慧教育平台（basic.smartedu.cn）下载电子课本的 PDF 文件。无论是老师备课、家长辅导，还是学生自学，都可以用它方便地把课本存到本地，随时离线查看。

项目基于 Python 开发，采用 MIT 开源协议，由 GitHub 用户 happycola233 主导维护，目前已迭代至 v3.3.4 版本，支持 Windows、macOS 和 Linux 三大平台。

核心亮点

下载与安装

工具提供了多种安装方式，你可以根据自己的操作系统选择最合适的一种：

⚠️ macOS 用户注意

由于应用未经 Apple 签名，首次打开时系统可能提示”已损坏”。请先在终端执行以下命令移除隔离属性：

xattr -cr /path/to/tchMaterial-parser.app


建议将应用拖入 /Applications 目录后再运行，以确保 Token 可以持久保存。

下载完成后无需额外安装，Windows 和 Linux 可直接双击运行。

使用教程

第一步：获取课本链接

首先，打开国家中小学智慧教育平台的电子课本页面，找到你需要的课本。浏览器地址栏中的 URL 就是我们要的链接，格式如下：

https://basic.smartedu.cn/tchMaterial/detail?contentType=assets_document
&contentId=XXXXXX&catalogType=tchMaterial&subCatalog=tchMaterial


每个课本都有唯一的 contentId，找到你需要的课本后，把链接复制下来。如果需要下载多本，每行粘贴一个链接即可。
第二步：粘贴链接到工具
启动 tchMaterial-parser，将课本链接粘贴到主界面的文本框中。工具支持多行输入，你可以一次性粘贴多个链接进行批量下载。
第三步：设置 Access Token（建议）

💡 小贴士
自 v3.1 版本起，即使不设置 Token 也可以下载，但该方法不保证长期有效，强烈建议配置 Token 以获得稳定的下载体验。

获取 Access Token 的步骤如下：
1. 打开浏览器开发者工具
在浏览器中访问 国家中小学智慧教育平台 并登录账号，然后按 F12 或 Ctrl+Shift+I 打开开发者工具，切换到「控制台（Console）」标签页。
2. 粘贴提取脚本
在控制台中粘贴以下 JavaScript 代码并按回车：
(function () {
  const authKey = Object.keys(localStorage).find((key) =>
    key.startsWith("ND_UC_AUTH"),
  );
  if (!authKey) {
    console.error("未找到 Access Token，请确保已登录！");
    return;
  }
  const tokenData = JSON.parse(localStorage.getItem(authKey));
  const accessToken = JSON.parse(tokenData.value).access_token;
  console.log(
    "%cAccess Token:",
    "color: green; font-weight: bold",
    accessToken,
  );
})();


3. 复制 Token 并保存
控制台会以绿色文字输出你的 Access Token，将其复制。然后回到 tchMaterial-parser 工具，点击「设置 Token」按钮，粘贴并保存。

⚠️ 友情提示


先登录账号，再粘贴代码！


粘贴代码时，请直接粘贴到控制台提示符 > 后面，不要粘贴到”过滤”或”筛选器”中。


如遇到粘贴警告，先输入”允许粘贴”四个字，再重新粘贴代码。


Access Token 有效期约 7 天，过期后需重新获取。



第四步：选择目录并下载
设置好保存目录后，点击「下载」按钮即可。工具会自动解析链接、下载 PDF，并按课本名称自动命名文件。

💡 书签功能
勾选「设置书签」选项后，工具会在下载完成后为 PDF 自动添加章节书签。打开 PDF 阅读器时，可通过书签快速跳转到目录对应的章节，非常方便。

常见问题
下载失败怎么办？


检查 Access Token 是否已过期（一般 7 天有效），过期则重新获取。


确认网络连接正常，网络不稳定可能导致下载中断。


确保输入的课本链接有效，部分旧版资源可能已被平台移除。


Token 安全吗？
完全安全。Token 仅存储在本地（Windows 存于注册表，Linux/macOS 存于本地配置文件），工具不会上传或发送 Token 到任何服务器。但请勿在公开场合分享你的 Token，以免账号被他人冒用。
支持哪些年级和学科？
只要是上线于国家中小学智慧教育平台的电子课本，均可通过本工具下载，涵盖小学一年级到高中三年级各学科教材。
写在最后
tchMaterial-parser 是一款小而实用的开源工具，解决了电子课本无法直接下载 PDF 的痛点。界面简洁直观，操作流程清晰，即使是技术小白也能快速上手。对于需要经常使用电子课本的老师、家长和学生来说，值得收藏。
项目在 GitHub 完全开源，欢迎去 Star 支持一下开发者。如果遇到问题，也可以在项目的 Issues 页面反馈。


项目地址：github.com/happycola233/tchMaterial-parser


开源协议：MIT License


当前版本：v3.3.4


本文仅为工具介绍与教程，与国家中小学智慧教育平台官方无关。
感谢您的阅读！
关注公众号～
获取更多精彩！