60 lines
5.1 KiB
Markdown
60 lines
5.1 KiB
Markdown
# 学员中心 · 2倍速学习助手
|
|
|
|
适用于 `https://icampus.yunyinsh.com/course/` 的篡改猴脚本。当前版本 **1.3.1**。
|
|
|
|
## 安装
|
|
|
|
下载 `icampus-study-helper.user.js`，在篡改猴管理面板的“实用工具 → 从文件导入”中安装或更新原脚本。刷新课程页，确认面板版本为1.3.1。已启动的标签页会自动接续；首次使用点击“开始”。不要同时启用旧诊断脚本。
|
|
|
|
默认按课程列表顺序处理，支持仅当前课程，以及只做本门测验。首次安装等待点击开始；开始后保持启用，刷新同一标签页也会接续，只有“人工取消”才清除运行状态。
|
|
|
|
## 1.3.1 完成条件、自动交卷与持续运行
|
|
|
|
电脑端的“交卷”在侧栏，手机端的底部交卷按钮在电脑上隐藏。旧版只查找底部按钮，导致已答完却无法提交。新版选择当前实际可见的交卷按钮，并自动确认交卷。
|
|
|
|
继续下一课程的条件是 **学习进度100%＋平台判定测验合格**，不要求测验得分100%。例如学习进度100%、测验75%、合格线60%，应继续下一门；学习进度75%而测验已合格，则继续学习视频。测验是否合格以平台的明确判定为准，不硬编码合格线。
|
|
|
|
未合格时根据逐题反馈保存正确答案、排除错误答案并重新测验，不设置脚本自己的重考次数上限。已合格不再重考；得分不足100%的整卷不会误记为全部答案正确。
|
|
|
|
“运行中”和“等待恢复”都属于已启动。网络异常、等待评分、当前范围完成或需要人工处理时保持启用；自动定期检查或在页面变化后接续。需要停止时点“人工取消”。手动暂停视频后会等待用户恢复视频，不主动抢占暂停操作。
|
|
|
|
## 功能
|
|
|
|
- 2倍速正常播放，平台确认完成后切换视频。
|
|
- 单选、判断、多选自动作答、交卷，根据平台逐题反馈保存答案并重试。
|
|
- 保留正确答案，排除错误选项或组合；按题干和选项文字匹配，避免选项字母换序导致误答。
|
|
- 持续启用、等待恢复、异常提示、单标签页运行锁和本机答案记忆。
|
|
- 默认开启“切标签页继续播放”，助手运行时保留网站原有的后台进度保存定时器。
|
|
|
|
## 1.2.0 后台播放
|
|
|
|
安装后刷新课程页，点击“开始”，保持“切标签页继续播放”勾选，然后切换其他标签页或把浏览器放到后台。开关偏好会保存在本机。
|
|
|
|
已加载的课程组件在页面隐藏时主动停止心跳。后台模式在课程页的助手运行期间拦截这个隐藏事件，保留正常播放和网页原本的心跳；不会改写 `document.visibilityState`、播放位置或服务器请求。回到前台仍执行网站原来的恢复逻辑。暂停助手、关闭后台模式或离开页面时恢复正常处理。
|
|
|
|
考虑到 Chrome 可能降低后台定时器频率，后台等待窗口及标签页运行锁延长至至少180秒，返回前台后给保存请求20秒恢复时间。连续180秒没有保存确认仍会暂停，后台切换视频和答题可能比前台慢。
|
|
|
|
电脑休眠、浏览器关闭、标签页冻结/丢弃、断网或媒体自动播放被浏览器拒绝，无法靠网页脚本保证运行。若 Chrome 经常回收该页，可在性能设置中将该站点加入“始终保持活跃的网站”；脚本不会自动修改浏览器设置。
|
|
|
|
## 1.1.1 修复
|
|
|
|
修复视频切换后不继续播放的问题：为每段视频单独计时，等待新媒体数据就绪和网站恢复播放位置；播放器重建时重新绑定；临时 `AbortError` 最多重试三次。加载卡住时尝试网页播放按钮，90秒仍未就绪则最多刷新恢复一次。播放停滞或启动超时也共享这一次恢复额度。
|
|
|
|
自动恢复会临时保存当前课程与恢复额度，刷新后接续。1.3.0起，运行开关另外保存在标签页会话中，因此普通刷新也接续；人工取消后刷新不会启动。
|
|
|
|
浏览器明确拒绝自动播放时提示手动点击播放，不会无限刷新。正常播放后的手动暂停仍会停止助手。
|
|
|
|
## 验证
|
|
|
|
运行 `npm test`，无需安装依赖。当前64项本地行为测试覆盖播放、进度保存、测验循环、媒体加载恢复、后台模式、学习进度与测验合格的独立判断、刷新接续。包含“学习100%＋测验75%合格→返回列表→打开下一课程”的完整模拟回归。
|
|
|
|
现场已确认原问题出现时第二段视频处于 `readyState=0` 且旧版已超时停止；修复通过模拟播放器与页面回归。尚未安装修复版验证真实课程完整连播。
|
|
|
|
后台模式测试模拟了网页真实的可见性处理和心跳响应，验证拦截、恢复、暂停、后台超时和延迟跳转等情况。尚未在用户浏览器中完成新版的长时间真实后台运行验证。
|
|
|
|
## 限制
|
|
|
|
计入进度、课程完成和重试能力均以平台返回结果为准。未合格且重考入口暂不可用时会等待；已合格则继续核对学习进度。图片、材料、填空和问答题需要人工处理。请保持电脑唤醒。
|
|
|
|
更多说明见 [使用说明](2倍速脚本使用说明.md)。
|