学习通课件解析助手

在学习通课程章节页中，一键整理当前章节内自己有权访问的课件资源，并按需下载到浏览器默认下载目录。

学习通课件解析助手 是一个运行在 Tampermonkey（油猴）、ScriptCat（脚本猫） 或兼容用户脚本管理器中的轻量脚本。它不会要求输入账号密码，也不会保存 Cookie；只在用户已经登录学习通的浏览器页面中工作。

✨ 主要功能

功能	说明
左侧悬浮书签	页面左侧垂直居中显示“课件解析”书签，收起时不遮挡课程内容。
位置拖拽与磁吸	无论面板展开或收起，按住书签即可上下拖动；松手后自动吸附到左侧位置网格。
可折叠面板	点击书签展开操作面板；再次点击书签或点击面板外任意位置即可收起。
一键解析	自动读取当前章节的附件，并提取可访问资源的实际地址。
多格式识别	自动标记 PDF、PPT、Word、视频、表格、压缩包及其他文件。
勾选下载	每个资源均可独立勾选，避免下载不需要的资料。
批量下载	点击“下载选中”后，文件依次下载到浏览器默认下载目录。
可滚动结果栏	面板默认显示约四行文件，更多结果可在框内滚动查看。
单一面板	仅在顶层页面创建一个入口，避免学习通多层播放器造成重复悬浮按钮。

🖼️ 使用体验

正常登录学习通并打开某一课程的具体章节。
点击左侧的 课件解析 书签。
在展开面板中点击 一键解析本章课件。
在结果列表中保留需要的文件勾选。
点击 下载选中，等待浏览器开始下载。

展开面板后，点击左侧书签、课程页面的其他区域或课件播放器区域，面板都会自动收起。

调整书签位置

按住左侧“课件解析”书签并上下拖动即可调整位置。松开鼠标或手指后，书签会保持在浏览器左侧并自动吸附到附近的垂直位置；脚本会记住该相对位置。短按不拖动时，仍按原逻辑展开或收起面板。

第一次发起多个文件下载时，Chrome 或 Edge 可能询问是否允许该站点下载多个文件；请选择“允许”。

🔍 支持的资源类型

脚本优先根据附件名称、资源地址后缀和学习通附件类型进行识别。

类型	常见扩展名	列表标签
PDF	`.pdf`	`PDF`
演示文稿	`.ppt`、`.pptx`、`.pps`、`.ppsx`	`PPT`
Word 文档	`.doc`、`.docx`、`.wps`	`WORD`
表格	`.xls`、`.xlsx`、`.csv`	`表格`
视频	`.mp4`、`.m3u8`、`.flv`、`.avi`、`.mov`、`.mkv`	`视频`
压缩包	`.zip`、`.rar`、`.7z`	`压缩包`
其他附件	无法从名称或地址判断的普通文件	`文件`

⚙️ 工作原理

脚本将手动打开开发者工具、刷新页面、在网络请求中寻找资源地址的流程自动化：

已登录的学习通章节页
        │
        ▼
读取页面附件信息 mArg.attachments
        │（页面未直接提供时，回退读取章节 cards 信息）
        ▼
取得每个附件的 objectId
        │
        ▼
请求 ananas/status/{objectId}
        │
        ▼
从 pdf / download / http 字段提取资源链接
        │
        ▼
在悬浮面板展示、勾选并批量下载

关键实现

用户脚本运行环境：适配油猴、脚本猫以及支持 Greasemonkey API 的脚本管理器。
登录态复用：请求在当前浏览器的已登录环境下进行，不需要脚本处理账号、密码或 Cookie。
资源解析：先尝试读取章节页脚本变量 mArg.attachments；若课程内容由异步页面或播放器加载，则使用章节 cards 信息作为回退来源。
资源状态查询：依据附件 objectId 查询学习通资源状态，依次检查 pdf、download、http 等可用地址字段。
跨域请求：使用 GM_xmlhttpRequest 请求学习通相关接口，避免普通网页请求受到同源策略限制。
浏览器下载：使用 GM_download 将用户勾选的文件交由浏览器下载管理器保存。
防重复注入：通过 @noframes 和顶层窗口检测，仅在当前标签页最外层页面创建一个悬浮面板；这解决了课件播放器内嵌多层 iframe 时出现多个按钮的问题。

🧩 界面说明

区域	用途
左侧书签	“课件解析”以两行、每行两个字显示；用于展开或收起面板。
拖拽交互	按住书签可上下移动；展开面板会随书签一起移动。
一键解析按钮	扫描当前章节的附件并刷新列表。
解析结果	每行显示复选框、文件类型标签和文件名；文件名过长时会省略显示，悬停可查看完整名称。
状态提示	显示读取附件、解析、下载进度及异常信息。
下载选中按钮	仅下载已勾选的资源，并显示已选文件数量。

🚀 安装与更新

安装

在浏览器安装油猴、脚本猫或 Violentmonkey。
新建用户脚本，或直接导入 chaoxing-courseware-helper.user.js。
保存脚本并确保脚本处于启用状态。
登录学习通后刷新课程章节页面。

更新

用新版本脚本完整覆盖旧脚本并保存，然后刷新学习通页面即可。

如果页面仍出现多个“课件解析”书签，请检查脚本管理器中是否同时启用了旧版本或重复安装的脚本。

🔐 权限与隐私

脚本申请的权限仅用于实现必要功能：

权限	用途
`GM_xmlhttpRequest`	读取当前帐号可访问的章节与资源状态信息。
`GM_download`	将用户主动勾选的文件下载到默认目录。
`GM_openInTab` / `GM_setClipboard`	预留给资源链接打开或复制功能。
`@connect *`	学习通文件可能由不同的资源域名或 CDN 提供，需要允许请求实际资源地址。

本脚本：

不收集、不上传账号密码；
不主动保存 Cookie、个人信息或课程数据；
不绕过平台登录、课程权限或访问控制；
仅对当前登录帐号原本有权访问的资源进行整理和下载。

⚠️ 注意事项

请仅用于个人学习、备份自己有权访问的课程资料，并遵守学校、平台与授课教师的相关规定。
学习通页面结构、接口字段或资源地址规则发生调整后，解析功能可能需要更新。
登录态过期、课程权限不足、网络异常或资源已被教师删除时，脚本无法获取对应文件。
部分资源可能是在线预览、加密媒体或平台特殊格式；是否能够下载取决于平台返回的实际资源地址与当前帐号权限。
批量下载由浏览器处理，最终保存位置以浏览器下载设置为准。

🛠️ 技术栈

类别	技术
脚本语言	JavaScript（ES2020+）
运行方式	UserScript / Greasemonkey API
兼容管理器	Tampermonkey、ScriptCat、Violentmonkey
请求机制	`GM_xmlhttpRequest`
下载机制	`GM_download`
界面实现	原生 DOM、CSS、固定定位悬浮面板
资源来源	当前章节附件信息与学习通资源状态接口

📄 许可协议

本用户脚本采用 MIT License。

你可以自由使用、复制、修改和分发本脚本，但应保留原有的版权和许可证声明。本软件按“原样”提供，不提供任何明示或暗示担保。

如果这个脚本对你有帮助，欢迎提出功能建议或提交兼容性反馈。