tchMaterial-parser 评测：国家中小学智慧教育平台电子课本的批量下载与书签处理
PDF。国家中小学智慧教育平台电子教材下载工具帮助您从智慧教育平台获取电子教材的PDF文件网址并下载，让您更方便地获取教材内容。
秒懂
- 它是什么？
- tchMaterial-parser 是一个面向国家中小学智慧教育平台电子课本的下载工具，支持批量解析、自动命名与 PDF 书签添加。本文基于其 README 与仓库信息，分析其工作机制、使用门槛与适用边界。
- 适合谁用？
- tchMaterial-parser 适合需要频繁从国家中小学智慧教育平台获取电子课本的教师、教研人员或学生，尤其是需要批量下载并希望 PDF 自带书签以便跳转的用户。不适合对资源版权有严格合规要求、或所在网络环境无法稳定访问该平台的人群。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 7 天前。
- 用什么语言写的？
- 主要是 Python（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的是教材获取的重复劳动
国家中小学智慧教育平台的电子课本以网页预览形式呈现，直接保存 PDF 需要逐页操作或借助浏览器开发者工具手动找资源地址。tchMaterial-parser 把这一过程压缩成三步：粘贴预览页网址、可选设置 Access Token、点击下载。工具会自动解析页面背后的 PDF 文件 URL，并按课本名称命名文件。面向的对象很明确，是需要在本地保存教材副本的教师、教研员或学生，而不是普通网页浏览者。批量下载是它的核心价值，一次输入多个 URL 即可连续处理，省去逐本操作的重复步骤。
解析与下载的机制：从预览页到 PDF 文件
工具的输入是电子课本的预览页面网址，形如 basic.smartedu.cn/tchMaterial/detail?contentType=assets_document&contentId=XXXXXX 的链接。工具需要从这类页面中提取出真实 PDF 文件的地址，再发起下载请求。README 没有公开解析的具体算法，但透露了两种途径：设置 Access Token 后走授权请求，不设置时则使用另一套方法。后者在 v3.1 版本后成为默认选项，但 README 明确警告该方法并不长期有效。下载完成后，若开启书签选项，工具会为 PDF 添加书签，方便在阅读器中跳转到指定章节。这个功能对动辄数百页的课本来说很实用，省去了手动在 PDF 阅读器里逐章标记的麻烦。
Access Token 是最大的使用门槛
虽然自 v3.1 起 Access Token 不再是必需项，但 README 强烈建议用户设置它。获取方式需要打开浏览器登录平台账号，按 F12 进入开发者工具，在控制台粘贴一段 JavaScript 代码，从 localStorage 中提取登录凭据，再复制输出的 JSON 字符串粘贴到工具中。这个流程对不熟悉浏览器开发者工具的用户来说并不友好。更麻烦的是 Token 有时效性，README 写明一般为 7 天，过期后下载会失败，需要重新获取。Token 的存储位置因操作系统而异：Windows 存在注册表 HKEY_CURRENT_USER\Software\tchMaterial-parser 的 AccessToken 值中，Linux 存在 ~/.config/tchMaterial-parser/data.json，macOS 存在 ~/Library/Application Support/tchMaterial-parser/data.json。工具承诺 Token 不会上传云端，仅用于本地请求授权。
安装方式与平台适配的取舍
项目提供四种安装途径。Windows 用户可用 winget install happycola233.tchMaterial-parser，Arch Linux 用户可用 yay -S tchmaterial-parser，其余平台从 GitHub Releases 下载对应架构的预编译包，也可从源码运行，要求 Python 3.10 以上。预编译包覆盖 Windows、Linux、macOS 的 x86_64 与 Arm64 架构，无需额外安装步骤。macOS 有个特殊问题：由于应用未签名，系统会报告文件已损坏，需要先运行 xattr -cr /path/to/tchMaterial-parser.app 移除隔离属性。README 还建议将应用移到 /Applications 目录下运行，以保证 Token 持久化。这反映出项目在跨平台发布上的实际成本，未签名应用在 macOS 上总会遇到 Gatekeeper 的阻拦，用户需要额外执行一条命令才能使用。
依赖平台接口的脆弱性
这个工具的本质是解析国家中小学智慧教育平台的网页结构并请求其资源接口，因此它的可用性完全依赖于平台端的接口是否保持稳定。README 中多次出现对失效的警告：未设置 Token 时的备用方法不长期有效，平台可能调整页面结构或接口参数，旧资源也可能被移除。这种依赖外部接口的工具都有同样的宿命，平台一旦改版，工具就需要跟着更新。从发布记录看，项目维护者确实在持续跟进，v4.0 到 v4.2 的间隔只有两周左右。但用户需要意识到，这不是一个能一劳永逸的工具，下载失败时首先要怀疑的是平台端是否变了，而不是自己的操作有误。
与 ChinaTextbook 的路线差异
README 末尾提到了一个替代项目 ChinaTextbook，它提供的是已归档的电子课本 PDF 下载。两者的思路截然不同：tchMaterial-parser 是实时从官方平台抓取，拿到的是当前平台上存在的最新版本；ChinaTextbook 是预先归档的静态资源，不依赖平台接口的稳定性，但更新可能滞后，也未必覆盖所有课本。如果用户只需要特定几本常用教材，ChinaTextbook 可能更省事，不需要处理 Token 过期问题。但如果需要的是平台最新上架的课本，或者希望自行控制下载时机和文件命名，tchMaterial-parser 的实时解析方式更直接。两条路线的取舍本质上是稳定性和时效性的权衡。
维护状态与合规边界
项目采用 MIT 许可证，允许自由使用和二次开发，但 README 的免责声明划出了明确的合规边界：工具仅提供下载便利，不存储、不托管、不分发任何资源内容，所有资源直接来自平台；下载资源的版权归原平台及相关权利人所有，仅限个人学习与教学参考，禁止商业用途或二次分发。项目也声明与国家中小学智慧教育平台没有任何隶属或合作关系。从维护角度看，最近一次提交在 2026 年 8 月，v4.2 是当前最新版本，说明项目处于活跃维护状态。贡献者指南要求阅读合规边界说明，暗示项目对法律风险的重视。用户在使用前应自行确认所在地区对教材下载和使用的具体规定，以及平台服务条款是否禁止此类抓取行为。
编辑结论
tchMaterial-parser 适合需要频繁从国家中小学智慧教育平台获取电子课本的教师、教研人员或学生，尤其是需要批量下载并希望 PDF 自带书签以便跳转的用户。不适合对资源版权有严格合规要求、或所在网络环境无法稳定访问该平台的人群。在采用前，应先验证平台当前的接口是否仍与工具兼容，特别是未设置 Access Token 时的备用下载方法是否有效；同时确认自己能够接受 Access Token 每约 7 天过期并需重新获取的维护节奏。若只是偶尔下载单本课本，手动在浏览器中保存 PDF 可能更省事，不必为此引入额外工具。
社区笔记