超星学习通课件下载归类脚本说明
一、脚本用途
本脚本用于在已获得课程授课老师许可的前提下，辅助下载超星学习通 / 学银在线课程页面中的课件资源，并按照课程名称和文件类型自动归类保存。
脚本主要面向以下资源类型：
PPT / DOC / PDF / 音视频 / 表格 / 压缩包 / 图片等
脚本不会自动下载文件，必须由用户手动点击面板按钮后才会开始扫描或下载。原始脚本的设计也是“点击开始后才下载”，并基于页面中的 fileinfo.download 信息获取课件下载地址。
二、核心功能
- 手动触发下载
脚本加载后会在课程页面右侧显示一个悬浮面板。
用户可以选择：
扫描本页
开始下载本页
整课下载
停止
清空记录
其中：
按钮 作用
扫描本页 只扫描当前页面可识别到的课件资源，不下载
开始下载本页 下载当前页面识别到的课件
整课下载 自动遍历课程章节，逐章扫描并加入下载队列
停止 停止后续扫描和队列提交
清空记录 清空本地去重记录，允许重复下载之前下载过的资源
2. 下载前确认课程名称
为避免不同课程的文件混在一起，脚本在点击：
开始下载本页
整课下载
时，会要求用户确认或填写本次课程名称。
例如填写：
高等数学
那么下载目录会使用：
高等数学/
作为根目录。
这样可以避免课程名被错误识别成：
学生学习页面
从而导致不同课程的课件全部混到同一个目录下。
- 自动按文件类型分类
脚本会根据文件扩展名判断类型，并保存到对应目录。
例如：
高等数学/PDF/第一章_函数极限.pdf
高等数学/PPT/第二章_导数与微分.pptx
高等数学/DOC/课程说明.docx
脚本原本的类型识别配置包括 PPT、DOC、PDF、MP4、AUDIO、SHEET、ARCHIVE、IMAGE、OTHER 等类别。
- 章节名并入文件名
修改后的保存结构为：
课程名/文件类型/章节名_原文件名.扩展名
例如：
高等数学/PDF/第一章 函数与极限_课件.pdf
高等数学/PPT/第二章 导数与微分_课堂PPT.pptx
不再使用旧结构：
课程名/PDF/章节名/文件名.pdf
这样可以减少目录层级，同时仍然保留章节信息。
- 支持去重
脚本会记录已经提交下载过的文件，避免重复下载。
默认开启：
去重
如果需要重新下载所有文件，可以点击：
清空记录
然后再重新下载。
三、支持的文件类型
脚本支持的资源类型如下：
类型 扩展名 默认是否勾选
PPT ppt, pptx, pps, ppsx 是
DOC doc, docx, wps, rtf, txt 是
PDF pdf 是
MP4 mp4, m4v, mov, flv, avi, wmv, webm 否
AUDIO mp3, m4a, wav, aac, ogg, flac 否
SHEET xls, xlsx, csv 否
ARCHIVE zip, rar, 7z 否
IMAGE jpg, jpeg, png, gif, bmp, webp 否
OTHER 其他未知类型 否
其中，MP4 默认不勾选，是因为学习通视频资源经常不是普通 .mp4 文件，而是播放页、预览页或流媒体地址。如果强行下载，可能得到的不是可播放视频文件。
四、使用方法
第一步：安装脚本管理器
推荐使用以下任一脚本管理器：
ScriptCat
Tampermonkey
Violentmonkey
安装完成后，将 .user.js 脚本导入脚本管理器。
第二步：进入课程页面
打开超星学习通或学银在线课程页面，例如：
课程章节页
课件预览页
任务点页面
脚本会在页面右侧显示一个悬浮下载面板。
如果没有显示，可以尝试：
- 刷新页面
- 确认脚本已启用
- 确认当前网址匹配学习通或学银在线页面
- 从脚本管理器菜单中点击“显示/隐藏课件下载面板”
第三步：选择需要下载的文件类型
默认建议保留：
PPT
DOC
PDF
如果需要下载表格，可以勾选：
SHEET
如果需要下载压缩包，可以勾选：
ARCHIVE
如果需要下载图片，可以勾选：
IMAGE
不建议默认勾选：
MP4
OTHER
因为它们更容易出现误识别或下载失败。
第四步：点击“扫描本页”
可以先点击：
扫描本页
确认脚本是否能识别到课件资源。
扫描后，面板中会显示预览列表，包括：
文件类型
文件名
预计保存路径
如果没有扫描到资源，可以尝试：
- 先打开课件预览页
- 等页面加载完成后再扫描
- 切换到具体章节或任务点后再扫描
第五步：下载当前页面资源
点击：
开始下载本页
脚本会弹出课程名称确认框。
填写或确认课程名后，脚本开始下载当前页面识别到的资源。
例如填写：
高等数学
则文件会保存为类似：
高等数学/PDF/第一章_课件.pdf
高等数学/PPT/第一章_课堂PPT.pptx
第六步：整课下载
如果要下载整门课的课件，可以在课程章节页点击：
整课下载
脚本会尝试依次进入每个章节，等待课件加载，然后扫描资源并加入下载队列。
整课下载时建议：
- 保持当前页面不要关闭
- 不要频繁手动切换章节
- 如果发现漏下载，可以适当调大 waitMs
注意事项
- 本脚本只适合下载已授权的课程资源
请确保下载行为已经获得授课老师、课程平台或相关权利人的许可。
- 视频文件不一定能正确下载
学习通的视频经常不是直接 .mp4 文件，而是使用播放页、预览页、加密地址或流媒体切片。
因此脚本默认不勾选 MP4。
如果手动勾选 MP4，脚本也只会尽量处理直接视频文件链接。对于 m3u8、分片视频或加密视频，本脚本不会自动合并成真正的 MP4 文件。
3. 下载目录受浏览器限制
脚本通过浏览器下载能力保存文件，实际保存位置通常受浏览器下载设置影响。
浏览器可能会把文件保存到：
默认下载目录
并在默认下载目录下创建类似：
高等数学/PDF/xxx.pdf
的相对目录结构。
如果浏览器或脚本管理器不允许自动创建子目录，可能需要调整浏览器下载设置或脚本管理器权限。
推荐使用流程
最稳妥的使用方式是：
- 进入课程章节页
- 勾选需要的类型，例如 PPT、DOC、PDF
- 点击“扫描本页”确认能识别资源
- 点击“开始下载本页”
- 填写本次课程名称
- 确认保存路径是否正确
- 如果没问题，再使用“整课下载”
如果是第一次使用某门课，建议先只下载一个章节测试，确认目录和文件名都正确后，再进行整课下载。