🛠️ 【tchMaterial-parser】国家中小学智慧教育平台课本下载工具

项目仓库：happycola233/tchMaterial-parser
定位：一键解析并批量下载国家中小学智慧教育平台的官方电子课本，自动重命名、自动内嵌 PDF 目录书签。

📖 项目简介

tchMaterial-parser 是由开发者 happycola233 开发的开源图形化解析下载工具。

针对国家中小学智慧教育平台（basic.smartedu.cn）中海量的各年级正版教科书，该工具能够一键提取高清 PDF 文件直链，解决在线阅读器加载缓慢、无法离线保存和批量下载繁琐等痛点。

✨ 核心特性

                     ┌── 批量解析：支持一次粘贴多个课本预览网址，队列下载
                     ├── 自动书签：生成完整 PDF 目录书签，方便跨章节跳转
tchMaterial-parser ──┼── 规范命名：自动提取教材官方全称，免去手动改名
                     ├── 断点跳过：自动识别已下载内容，避免重复占用带宽
                     └── 多端支持：原生支持 Windows、macOS 与 Linux GUI 界面

1. 批量与断点处理：支持一次性粘贴多个课本 URL，支持下载中断恢复与自动跳过已存在文件。

2. 自动化目录注入：下载完成后自动将教材目录结构注入为 PDF 书签（Bookmark/Outline），便于在阅读器中定位课文。

3. 认证持久化（Access Token）：提供凭证保存机制，Windows 写入注册表，Linux/macOS 写入用户配置目录，配置一次可稳定使用。

4. 开箱即用：提供各平台预编译的可执行文件，无需配置 Python 环境即可运行。

💻 下载与安装途径

⚠️ macOS 提示：首次打开若提示“应用已损坏”，需打开终端执行：

xattr -cr /Applications/tchMaterial-parser.app

🔑 核心操作流程：获取与配置 Access Token

虽然部分公共资源支持免登录直接获取，但为确保稳定解析和高速下载，强烈推荐先配置个人 Access Token。

1. 登录智慧教育平台

在浏览器中打开并登录 国家中小学智慧教育平台。

2. 提取身份凭据

按下键盘 F12（或右键审查元素）打开开发者工具，切换到 控制台 (Console)，粘贴并回车执行以下脚本：

(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("%c请复制下面整段JSON并粘贴到下载工具：", "color: green; font-weight: bold");
  console.log(credentials);
})();

3. 保存至工具

复制控制台输出的整段 JSON 字符，打开 tchMaterial-parser，点击界面中的 “设置 Token” 按钮，粘贴并保存。

🚀 电子课本下载步骤

[打开智慧教育平台] ──> [复制教材页面 URL] ──> [粘贴至 tchMaterial-parser] ──> [点击开始下载]

1. 寻找课本：在平台教材专区找到所需课本，进入在线浏览页面。

2. 复制链接：复制浏览器地址栏中的网址（支持多行粘贴多本课本）。

3. 开始任务：勾选“添加 PDF 书签”（推荐），选择保存路径，点击 开始下载。

❓ 常见问题排查 (FAQ)

• Q: 下载报错或提示鉴权失败？

  • A: Access Token 通常有效期为 7 天。若长期未更新，需按上述步骤重新在浏览器中生成并配置最新 Token。

• Q: 凭证保存在本地什么位置？

  • Windows: 注册表 HKEY_CURRENT_USER\Software\tchMaterial-parser -> AccessToken

  • Linux: ~/.config/tchMaterial-parser/data.json

  • macOS: ~/Library/Application Support/tchMaterial-parser/data.json

⚖️ 免责声明

• 本项目为开源辅助工具，不托管、不存储任何教材资源文件，所有内容均直连国家智慧教育平台接口。

• 下载资源版权均归原编写机构、人民教育出版社及教育部相关部门所有，仅供个人学习交流与备课参考，严禁二次倒卖与商业牟利。