国家中小学智慧教育平台教材下载器

问题

国家中小学智慧教育平台（basic.smartedu.cn）可以浏览教材目录和详情页，但实际文件并不在公开地址里直接下载。听力音频与教材 PDF 通常托管在 私有 CDN（例如 r1-ndr-private.ykt.cbern.com.cn）上，请求时需要携带 X-Nd-Auth 头。该头依赖登录会话中的 access_token 与 mac_key，通过 HMAC-SHA256 对请求信息签名生成；而登录流程又包含腾讯滑块验证码，不能由脚本直接绕过。平台的教材清单接口通常可匿名访问，但文件下载接口有签名要求。对教师、教研人员或需要整理多套教材的人来说，逐页点击、等待跳转、复制 token 再手动下载，既不现实也容易中断。

技能如何工作

该技能把“登录、取 token、识别资源、下载、校验”拆成一条可重复的流程。它使用 Playwright 打开可见浏览器，自动填写手机号和密码，然后提示用户手动拖动滑块并等待登录完成。登录成功后，脚本从页面 localStorage 的嵌套 token 结构中取出真实凭据，再按教材 contentId 查询资源清单，判断某套教材是否提供听力音频，或只有 PDF 本体。token 在有效期内可复用于多个资源，因此适合一次登录后批量处理多份教材。

核心能力包括：

• 从多个教材链接中提取 contentId，一次登录后可连续下载多份资源
• 先探测教材类型，避免对没有听力音频的语文、数学、历史等学科误请求 MP3
• 支持 audio、pdf、auto 三种模式，auto 会在有听力时下载 MP3，否则下载 PDF
• 对下载结果做基础校验，例如 MP3 的 ID3 或帧头、PDF 的 %PDF- 与 %%EOF

使用边界

该过程依赖真实浏览器窗口和用户手动完成验证码，脚本不能以完全后台方式替代登录。验证码等待有上限，若超时或页面被刷新，需要重新登录。账号密码只用于当次会话，不应写入文件、日志或后续任务配置。下载资源应限于个人学习或教学整理，不要用于再分发。