蕴瑜课堂自动播放脚本使用说明

适用脚本：gdut.js当前版本：4.5适用站点：https://courses.gdut.edu.cn/mod/fsresource/view.php?id=*

1. 功能说明

gdut.js 是用于蕴瑜课堂视频页面的浏览器用户脚本，主要能力包括：

• 自动播放课程视频
• 自动静音播放
• 自动设置播放倍速
• 自动处理「按住通过」弹窗
• 自动点击常见确认按钮
• 自动跳转下一课
• Session 保活
• 视频卡死检测与页面恢复
• 防切屏 / 后台检测增强
• 多开检测弹窗自动关闭
• 多开检测页面告警自动隐藏

2. 安装前准备

2.1 安装浏览器

建议使用以下浏览器之一：

• Chrome
• Edge
• Chromium 内核浏览器

2.2 安装 Tampermonkey

1. 打开浏览器扩展商店。
2. 搜索 Tampermonkey。
3. 安装并启用扩展。
4. 确认浏览器右上角能看到 Tampermonkey 图标。

3. 安装脚本

3.1 新建脚本

1. 点击浏览器右上角 Tampermonkey 图标。
2. 点击 添加新脚本 或 Create a new script。
3. 删除编辑器中默认生成的全部内容。

3.2 复制脚本内容

1. 打开本目录下的脚本文件：
```
刷题脚本/gdut.js
```
2. 复制 gdut.js 的全部内容。
3. 粘贴到 Tampermonkey 新脚本编辑器中。
4. 使用快捷键保存：
```
Ctrl + S
```
macOS 使用：
```
Command + S
```

3.3 启用脚本

1. 打开 Tampermonkey 管理面板。

2. 找到脚本：

GDUT 蕴瑜课堂自动播放脚本 Ultimate Stable

3. 确认脚本开关处于启用状态。

4. 使用步骤

1. 登录蕴瑜课堂：
```
https://courses.gdut.edu.cn/
```
2. 进入需要学习的课程视频页面。

3. 确认页面地址类似：

https://courses.gdut.edu.cn/mod/fsresource/view.php?id=xxxx

4. 等待页面加载完成。
5. 脚本会自动执行以下操作：

• 自动播放视频；
• 自动静音；
• 自动处理确认按钮；
• 自动处理「按住通过」弹窗；
• 视频异常时自动恢复；
• 达到配置进度后自动切换下一课。

5. 控制台验证

打开浏览器开发者工具：

F12 -> Console

正常情况下可以看到类似日志：

GDUT Ultimate Stable 脚本启动多开检测弹窗自动处理已启用防切屏检测已启用Session 保活成功视频开始播放检测到长按按钮开始长按 9500ms长按完成

如果出现多开检测告警，可能看到：

检测到多开观看限制，已自动处理已隐藏多开观看页面告警

6. 配置说明

脚本配置位于 gdut.js 顶部的 CONFIG：

const CONFIG = {    TARGET_PROGRESS: 91,    CHECK_INTERVAL: 5000,    SESSION_KEEPALIVE_INTERVAL: 5 * 60 * 1000,    LONG_PRESS_DURATION: 9500,    EMPTY_PAGE_THRESHOLD: 3,    VIDEO_STUCK_THRESHOLD: 3,    AUTO_MUTE: true,    PLAYBACK_RATE: 1.0,    DEBUG: true};

配置项	默认值	说明
`TARGET_PROGRESS`	`91`	达到该学习进度后自动尝试进入下一课
`CHECK_INTERVAL`	`5000`	主循环检测间隔，单位毫秒
`SESSION_KEEPALIVE_INTERVAL`	`5 * 60 * 1000`	Session 保活间隔
`LONG_PRESS_DURATION`	`9500`	「按住通过」持续按住时间
`EMPTY_PAGE_THRESHOLD`	`3`	连续检测不到视频多少次后尝试跳转下一课
`VIDEO_STUCK_THRESHOLD`	`3`	视频卡死检测阈值
`AUTO_MUTE`	`true`	是否自动静音
`PLAYBACK_RATE`	`1.0`	视频播放倍速，`1.0` 表示原速
`DEBUG`	`true`	是否输出调试日志

7. 常见场景处理

7.1 「按住通过」弹窗

脚本会自动识别按钮文本：

按住通过

并模拟：

• pointerdown
• mousedown
• touchstart
• 等待 LONG_PRESS_DURATION
• pointerup
• mouseup
• touchend
• click

如果浏览器不支持 PointerEvent 或 TouchEvent，脚本会自动降级使用鼠标事件。

7.2 多开检测弹窗

如果接口返回或页面弹窗中包含：

禁止同时观看多个视频当前视频已暂停

脚本会自动处理：

• 自动吞掉 alert 弹窗；
• 自动识别 /lib/ajax/service.php 接口返回；
• 自动隐藏页面追加的 warning 告警；
• 对命中的页面告警设置：

display: none !important;

7.3 页面一直追加黄色告警

脚本已内置 MutationObserver，会监听页面新增告警元素。

只要告警文本包含：

禁止同时观看多个视频当前视频已暂停

就会自动隐藏，不影响其它普通 warning。

7.4 视频卡住不动

脚本会检测视频播放时间是否连续不变化。

达到阈值后会刷新页面恢复：

视频卡死，刷新页面

8. 使用注意事项

1. 不建议同时启用多个同类脚本。

• 如果 Tampermonkey 中存在旧版脚本或其它蕴瑜课堂脚本，建议只保留一个启用。

2. 不建议频繁修改倍速。

• 当前默认 PLAYBACK_RATE: 1.0，更稳定。

3. 不建议长时间最小化浏览器。

• 脚本已做防切屏增强，但平台仍可能存在服务端检测。

4. 如果自动切课异常，优先检查课程页面是否存在特殊目录结构。
5. 如果脚本不生效，优先确认当前页面地址是否匹配：
```
https://courses.gdut.edu.cn/mod/fsresource/view.php?id=*
```

9. 故障排查

9.1 脚本没有启动

检查：

1. Tampermonkey 是否启用。
2. 脚本开关是否启用。
3. 页面地址是否匹配 @match。
4. 控制台是否出现：
```
GDUT Ultimate Stable 脚本启动
```

9.2 视频不能自动播放

检查：

1. 浏览器是否拦截自动播放。
2. 是否已经登录过期。
3. 控制台是否出现 自动播放失败。
4. 手动点击一次页面后再观察脚本是否恢复。

9.3 「按住通过」没有自动处理

检查：

1. 按钮文本是否包含 按住 或 按住通过。

2. 控制台是否出现：

检测到长按按钮开始长按 9500ms长按完成

3. 如果按钮样式变化，需要重新适配选择器。

9.4 黄色多开告警没有隐藏

检查告警 DOM 文本是否包含：

禁止同时观看多个视频当前视频已暂停

如果文案变化，需要补充 isMultiWatchWarningText() 的匹配规则。

10. 更新脚本

如果后续修改了 gdut.js：

1. 打开 Tampermonkey 管理面板。
2. 找到当前脚本并进入编辑。
3. 删除旧代码。
4. 粘贴最新 gdut.js 内容。
5. 保存。
6. 刷新蕴瑜课堂页面。

11. 回滚方式

如果新版本异常，可以使用 Git 回滚本地脚本：

git restore '刷题脚本/gdut.js'

如果只是 Tampermonkey 中异常：

1. 打开 Tampermonkey 编辑器。
2. 粘贴旧版本脚本内容。
3. 保存。
4. 刷新页面。

12. 风险提示

该脚本会自动操作课程页面，使用前请自行确认是否符合课程平台和学校相关规定。

可能风险包括：

• 学习记录被平台判定异常；
• 多开页面触发服务端检测；
• 浏览器最小化、静音、切屏等行为被检测；
• 第三方脚本或代刷服务存在账号安全风险。

建议仅在充分了解风险后使用，并避免在同一账号下同时开启多个同类脚本。