tchMaterial-parser

项目概述

tchMaterial-parser 是国家中小学智慧教育平台的电子课本下载工具。粘贴一个或多个电子课本预览页面网址，即可解析并批量下载 PDF 文件，自动以课本名称命名，并可自动添加书签，开箱即用。

主要功能

• 智能批量下载：一次输入多个电子课本预览页面网址批量下载，自动跳过已完成的文件，可随时停止下载
• 自动命名与书签：以电子课本名称作为默认文件名，可选在下载完成后为 PDF 添加书签
• Access Token 支持：可手动输入并自动保存，下次启动自动加载
• 资源快速搜索：按资源名称或学段、学科、年级等分类组合搜索，结果自动展开
• 界面体验：高 DPI 适配，深色与浅色模式自动跟随并可手动切换
• 跨平台：支持 Windows、Linux、macOS 等操作系统（需要图形界面）

适用人群

• 需要下载国家中小学智慧教育平台电子课本的教师、学生与家长
• 需要批量整理 PDF 教材并进行书签标注的用户

快速上手

1. 前往 Releases 下载对应平台的程序（Windows 10/Server 2019 及以上、Linux、macOS 10.15 及以上），或使用 winget install happycola233.tchMaterial-parser、yay -S tchmaterial-parser 安装
2. 将电子课本的预览页面网址粘贴到文本框中，支持多个网址（每行一个）
3. 可选：登录平台后按说明在控制台运行脚本获取整段 JSON，点击设置 Token 粘贴并保存
4. 点击下载，程序自动解析并下载电子课本，若开启添加 PDF 书签则会在完成后写入书签

核心优势

• 批量下载并自动跳过已完成文件，重新下载整套课本时只补齐缺失与失败部分
• 自动命名与可选的 PDF 书签，方便管理与查阅
• 支持 WinGet 与 AUR 一键安装，也可从源码运行
• 开源免费，基于 MIT 协议，且不存储、不托管、不分发任何资源内容

系统要求

• 操作系统：Windows 10（Server 2019）及以上、Linux、macOS 10.15 及以上
• 支持架构：x86_64、Arm64
• 额外依赖：从源码运行需 Python 3.10 及以上，使用打包版本无需额外依赖

注意事项

• Access Token 具有时效性（一般约 7 天），下载失败时请重新获取并设置
• macOS 上因未签名会被报告文件已损坏，需先运行 xattr -cr 移除隔离属性，建议将应用移动到 /Applications 目录
• Windows 7 或 8.1 用户可使用非官方分支 tchMaterial-parser-for-Windows7
• Token 仅用于本地请求授权，不会上传或存储到云端，请勿在公开场合分享
• 资源版权归原平台及相关权利人所有，请仅用于个人学习与教学参考，勿用于商业用途或二次分发