tchMaterial-parser

tchMaterial-parser是由开发者happycola233在GitHub上开源的一款实用工具，专门解决从国家中小学智慧教育平台下载电子课本的需求。随着平台安全策略的更新，自2025年2月起，下载教材必须登录账号，本工具也随之适配了Access Token登录认证机制。

这款工具的核心价值在于把原本需要手动逐页保存或使用复杂脚本的操作，简化为复制链接、点击下载两步。它会自动解析教材页面，提取出高质量的PDF文件链接，并按课本名称自动命名保存。对于需要下载多本教材的老师、学生或家长来说，这能节省大量时间和精力。

官网入口地址

开源项目地址：https://github.com/happycola233/tchMaterial-parser

下载地址

官方下载页面：https://github.com/happycola233/tchMaterial-parser/releases
（进入页面后，找到版本，根据你的操作系统选择对应的安装包下载即可。Windows用户下载.exe文件，macOS用户下载.dmg文件。）

功能介绍

tchMaterial-parser的功能设计围绕着高效下载电子课本展开，主要包含以下方面：

批量解析与下载
支持在文本框中一次性粘贴多个电子课本的网页链接（每行一个），点击按钮后工具会自动解析出所有有效链接。你可以选择“解析并复制”来获取链接地址自行处理，或直接点击“下载”一次性保存所有课本PDF，大幅提升下载效率。

智能文件命名与管理
下载的PDF文件会根据智慧教育平台上的教材官方名称自动命名，无需手动重命名。同时支持自定义保存路径，你可以指定一个专门的文件夹来存放所有课本，方便后续整理和查找。

Access Token 登录集成
针对平台必须登录才能下载的要求，工具内置了Token设置功能。你只需按指引从浏览器中复制一段认证代码粘贴进来，程序会自动保存。Token仅存储在本地电脑上，不会上传到任何服务器，保障账号安全。当Token过期时，程序会自动检测并弹出设置窗口引导更新。

跨平台兼容性
提供Windows、Linux（包括Arch Linux的AUR包）和macOS的专用版本，不同操作系统的用户都能获得原生的使用体验。，Linux版会将Token保存在~/.config/tchMaterial-parser/data.json文件中，macOS版则保存在~/Library/Application Support/tchMaterial-parser/目录下。

PDF书签（目录）注入
从v3.3版本开始，工具新增了为下载的PDF文件自动注入书签的功能。这意味着下载的课本会带有与平台网页端一致的章节目录，在PDF阅读器中可以方便地跳转到具体章节，阅读体验更好。

资源访问优化
从v3.1版本起，即使未设置Access Token，工具也能尝试下载部分不受限制的教学资源。同时修复了多个影响跨平台一致性的界面问题，Windows系统图标显示异常、Linux下右键菜单交互等，让整体操作更流畅。

应用场景

tchMaterial-parser适合以下人群和场合：

教师备课与教学
教师可以快速下载所教学科的全套电子课本，用于制作课件、打印练习题或在没有网络的环境中查阅教材内容。

学生自主学习
学生可以将下学期的课本提前下载到电脑或平板里，在假期预习或平时复习时使用，不受网络限制，也不用每次都登录网页。

家长辅导孩子
家长可以用它下载孩子的教材，同步了解学习内容，更有效地进行课后辅导。

离线环境使用
对于网络不稳定或需要在无网络设备上使用教材的情况（如某些电子墨水屏阅读器），提前下载好PDF文件是解决方案。

必要补充信息

关于定价
tchMaterial-parser是一款免费的开源软件，不收取任何费用，也没有任何隐藏收费项目。任何人都可以从GitHub免费下载使用。

使用示例：获取Access Token
这是使用工具前最关键的一步，具体操作如下：

1. 在电脑浏览器中打开国家中小学智慧教育平台并登录你的账号。

2. 按键盘上的F12键（或同时按Ctrl+Shift+I）打开“开发者工具”面板。

3. 点击顶部的“控制台”（Console）选项卡。

4. 将下面这段代码完整复制，粘贴到控制台的输入框中，然后按回车键执行。

   (function() {
       let authKey = Object.keys(localStorage).find(key => key.includes("ND_UC_AUTH"));
       if (!authKey) {
           console.error("未找到 access_token，请确保已登录！");
           return;
       }
       let tokenData = JSON.parse(localStorage.getItem(authKey));
       let accessToken = JSON.parse(tokenData.value).access_token;
       console.log("%cAccess Token: ", "color: green; font-weight: bold", accessToken);
   })();

5. 执行后，控制台会输出一行绿色的文字，中长长的一串字符就是Access Token，把它复制下来。

6. 打开tchMaterial-parser工具，点击“设置Token”按钮，将复制的Token粘贴进去并保存即可。

注意事项
Access Token是平台识别你登录身份的凭证，请务必妥善保管，不要在网络上公开分享。它会在一段时间后失效，届时工具会提示你重新获取。