tchMaterial-parser v3.1：电子教材下载工具

tchMaterial-parser v3.1 是针对国家中小学智慧教育平台的开源电子教材下载工具，支持小初高（含 63/54 学制）及特殊教育阶段 PDF 教材批量下载，跨平台兼容，v3.1 版本优化了下载稳定性与资源获取精准度。

一、软件核心定位

作为专注解决官方平台资源获取不便问题的实用工具，tchMaterial-parser v3.1 以 “高效批量、精准适配、安全开源” 为核心优势，适配教师备课、学生自学、家长辅导等多场景，无需复杂操作即可快速获取合规电子教材资源。

二、核心功能特点

1. 多学段资源全覆盖

全面支持小学（63/54 学制）、初中、高中全学科教材，同时纳入特殊教育阶段相关资源，覆盖主流学制与学科分类，满足不同学段的教材获取需求。

2. 智能化批量下载

支持输入多个教材预览页网址批量解析下载，自动以 “教材名称.pdf” 规范命名，省去手动重命名的繁琐操作，大幅提升资源收集效率。

3. 可视化下载管理

下载过程中实时显示进度条，支持暂停 / 恢复操作，让用户直观掌握每本教材的下载状态，避免因操作不透明导致的重复下载或漏下问题。

4. 跨平台系统兼容

完美适配 Windows、Linux 系统，同时支持带图形界面的 macOS 设备，无论日常办公设备是何种系统，都能顺畅使用，打破设备限制。

三、使用指南与操作流程

1. 基础下载步骤

1. 打开工具后，在输入框粘贴国家中小学智慧教育平台的教材预览页网址（示例：https://basicsmartedu.cn/tchMaterial/detail?contentType=assets_document&contentId=...），可多行输入多个网址；
2. 点击 “下载” 按钮，程序将自动解析网址并开始批量下载 PDF 格式教材。

2. Token 设置优化（v3.1 可选操作）

为何设置 Token？

未设置 Token 时可能下载到老版本教材，完成设置后可精准获取平台最新电子教材资源，提升资源时效性。

具体操作步骤：

1. 登录国家中小学智慧教育平台官网（https://auth.smartedu.cn/uias/login）；
2. 按 F12 打开浏览器开发者工具，在 “控制台” 面板粘贴以下代码：

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("Access Token:", accessToken); })();

3. 复制控制台输出的 “Access Token”，回到工具点击 “设置 Token” 按钮，粘贴后保存即可。

3. 备用下载方案（手机 App 辅助）

若电脑端操作遇到问题，可通过手机 App 辅助获取：

1. 用国家中小学智慧教育平台手机 App 下载目标教材；
2. 找到手机存储路径：/data_mirror/data_ce/null/0/com.eduyun.app.factory.ykt/app_flutter/download_manager/default/；
3. 找到下载文件后，手动添加.pdf后缀，即可在其他设备打开使用。

四、v3.1 版本更新亮点

1. 稳定性优化：修复了部分教材解析失败、下载中断的问题，整体下载成功率提升；
2. 资源适配升级：新增 Token 设置功能，可精准获取平台最新教材资源，避免下载旧版内容；
3. 跨平台兼容性提升：优化了 macOS 图形界面适配效果，Linux 系统下的运行流畅度显著改善。