一键下载学习通（超星）课程中的 PPT 课件为 PDF 文件
Note
请在合理的范围内使用本脚本！！
脚本作者对于脚本使用者的任何行为不负任何责任，本仓库仅为仓库作者的学习目的而建立，如有任何侵犯您的合法权益的行为，请联系我进行修改，或者删除。
- 自动识别：自动检测页面中的所有 PPT 课件
- 画质压缩：将服务器传回的 PNG 格式转化为 JPEG 格式，节约 5% ~ 30% 的空间
- 智能布局：自动适配 PPT 原始尺寸
- 一键导出：所有页面合并为 PDF 文件，当页数太多（默认大于 500 页时）时会分卷合并
- 高效快速：使用 Web Worker 来进行任务的高效执行
- 确保已安装用户脚本管理器，例如 Tampermonkey
- 下载 tampermonkey 文件夹中的
xuexitong-ppt-downloader.user.js - 在 Tampermonkey 中
管理面板->实用工具->导入->选择文件导入脚本 - 启用脚本
- 下载 extension 中的
xuexitong-ppt-downloader.zip并解压 - 打开浏览器扩展管理页面
- Chrome:
chrome://extensions/ - Edge:
edge://extensions/
- Chrome:
- 开启右上角的 "开发者模式"
- 点击 "加载已解压的扩展程序"，选择解压后的文件夹
- 打开学习通课程页面
- 等待 PPT 加载完成
- 点击页面左下角自动出现的下载 PPT按钮
- 等待下载和生成完成
- PDF 文件将自动保存到浏览器默认下载目录
- 下载 PPT：初始状态，点击开始下载
- 正在获取信息...：正在分析 PPT 页数和 URL
- 下载中...：显示当前下载进度
- 下载完成！：PDF 生成完毕，已自动保存
- 下载失败：出现错误，请查看控制台日志
如果页面包含多个 PPT 课件，脚本会为每个课件添加独立的下载按钮。
xuexitong-ppt-downloader/
├── src/
│ ├── index.ts # 主入口，脚本初始化和协调
│ ├── types.ts # TypeScript 类型定义
│ ├── core/ # 核心业务逻辑
│ │ ├── ppt-worker.ts # Web Worker 逻辑主体
│ │ ├── ppt-extractor.ts # PPT 信息提取器
│ │ ├── download-controller.ts # 下载控制器
│ │ └── pdf-generator.ts # PDF 生成器
│ ├── ui/ # 用户界面组件
│ │ ├── button-group.ts # 两个按钮的进一步封装
│ │ ├── stop-button.ts # 停止按钮组件
│ │ └── download-button.ts # 下载按钮组件
│ ├── extension/ # Edge/Chrome 拓展相关的代码
│ │ ├── extension-entry.ts # 拓展入口
│ │ └── extension-polyfill.ts # 油猴代码拓展兼容层
│ └── utils/ # 工具函数
│ ├── iframe-helper.ts # iframe 查找和等待工具
│ └── image-downloader.ts # 图片下载工具
├── dist/ # 构建输出目录
├── package.json # 项目配置和依赖
├── tsconfig.json # TypeScript 配置
├── tsup.config.ts # 构建工具配置
└── README.md # 项目文档
1. 页面加载
↓
2. 脚本启动 (index.ts)
├── 监听 DOMContentLoaded
├── 启动 MutationObserver（监听动态加载）
└── 启动定时重试器（最多 10 次）
↓
3. 查找 PPT iframe (iframe-helper.ts)
├── 递归搜索所有 iframe（最深 5 层）
├── 查找包含 id="panView" 的 iframe
└── 使用 WeakMap 缓存已处理的 iframe
↓
4. 添加下载按钮 (download-button.ts)
└── 在每个 PPT iframe 内部创建按钮
↓
5. 用户点击按钮
↓
6. 提取 PPT 信息 (ppt-extractor.ts)
├── 解析 data 属性获取文件名
├── 等待 panView iframe 加载
├── 查找所有 li[id="anchor"] 元素
├── 提取第一张图片 URL
└── 计算总页数和 baseUrl
↓
7. 并发下载图片 (image-downloader.ts)
├── 批量下载（10 个并发，可自行修改源码调整）
├── 使用 GM_xmlhttpRequest 下载为 ArrayBuffer
└── 通过零拷贝将数据传递给 Worker
↓
8. 生成 PDF (pdf-generator.ts & pdf-worker.ts)
├── 主线程：负责任务调度和 UI 更新
├── Worker线程：负责 CPU 密集型计算
│ ├── 初始化本地注入的 jsPDF 库
│ ├── 接收 ArrayBuffer 并添加到 PDF
│ └── 生成最终 PDF Blob
└── 全程不阻塞主线程，保持 UI 流畅
↓
9. 保存文件
└── 使用 Blob URL 触发浏览器下载
- 仅支持学习通平台：脚本仅在
https://*.chaoxing.com/mycourse/studentstudy*域名下生效 - 需要完整加载：确保 PPT 在页面中已完全加载后再下载
- 浏览器要求：建议使用 Chrome/Edge/Firefox 最新版
由于浏览器的安全模型，脚本没有办法绕过 CORS 直接从内存中读取跨域图片的像素数据。这是浏览器故意设计的安全机制，防止恶意脚本窃取用户的敏感图片数据。
在生成最终文件的过程中，程序尝试将所有数据片段拼接成一个超长的字符串。浏览器的 JavaScript 引擎对单个字符串的长度有严格限制，通常在几百 MB 左右。当页数较多的 PPT 的数据总量超过这个限制时，就会 Javascript 引擎就会抛出 Invalid string length 错误，导致 Workers 崩溃。
所以我对生成的 PDF 文件的长度做了限制，最多只能在一个文件中放 500 张 PPT。您可以使用 qpdf 来在本地对多个 PDF 进行拼接。
- 本脚本不会收集任何个人信息
- 所有操作在本地浏览器完成
- 不会向第三方服务器发送数据
- 开源代码，可自行审查
请看 ChangeLog.md
# 当前项目环境
$ node --version
v22.21.1
$ npm --version
10.9.4
$ pnpm --version
10.27.0# 获取依赖
pnpm install
# 构建命令
pnpm build脚本的性能配置选项在 config.ts 文件中，如果你需要修改脚本的性能，请修改这个文件中的参数，然后重新构建脚本。
- TypeScript 5.9：类型安全的 JavaScript
- tsup：零配置 TypeScript 打包工具
- jsPDF：浏览器端 PDF 生成库
- Tampermonkey API：用户脚本环境
欢迎提交 Issue 和 Pull Request！
- jsPDF - PDF 生成库
- Tampermonkey - 用户脚本管理器